A popularização dos LLMs acelerou a entrega de software, mas trouxe consigo um novo tipo de caos: a psicose de IA. No blog da acai.sh, o autor narra a trajetória de quem trocou a ilusão de produtividade infinita por uma disciplina antiga — a escrita metódica de especificações, agora adaptada ao universo dos agentes generativos.
O ciclo da desordem: contexto e limites
A narrativa começa com uma cena comum: agentes de IA que impressionam, mas esquecem detalhes críticos. O entusiasmo inicial logo esbarra em limites práticos — context window saturado, sessões perdidas, requisitos sumindo na troca de mãos. O resultado é previsível: agentes “fora dos trilhos” e funcionalidades quebradas, sintomas do que o texto chama de “Peak Slop”. A resposta? Voltar ao básico: documentar, listar requisitos, manter specs vivas e atualizadas. Nada novo, mas agora vital.
Da psicose à disciplina: specs como antídoto
O autor relata a experiência de cair na “psicose de IA”: criar specs cada vez mais detalhadas em markdown, templates para agentes, e até um exército de subagentes colaborando em tarefas ambiciosas. O ápice foi um agente rodando por 1,5 hora sem supervisão. Mas o resultado, embora funcional, ainda era “sloppy” — longe da robustez desejada. Surge então a percepção: usar IA só para gerar código não basta; é preciso estruturar e versionar requisitos desde o início.
Acceptance Criteria IDs e rastreabilidade
O turning point veio quando um agente começou a numerar e referenciar requisitos (“ACIDs”) diretamente no código, sem ser instruído. Inicialmente visto como acoplamento indesejado, o método revelou valor: rastreabilidade, navegação facilitada em PRs e possibilidade de mapear cobertura de requisitos, além de testes. Isso abriu espaço para acompanhar o progresso granular e compartilhar specs entre times e branches, aproximando engenharia tradicional e automação generativa.
Acai.sh: specs em YAML para IA
Para resolver os desafios emergentes, nasceu o acai.sh — toolkit open-source centrado em “feature.yaml” como template flexível para specs. O objetivo é mitigar a entropia dos agentes, garantir a persistência dos requisitos e criar um ciclo mais seguro de shipping, review e iteração. A abordagem sugere que, em vez de resistir à disciplina, equipes devem abraçar a escrita formal de requisitos, agora potencializada por ferramentas e práticas adaptadas ao contexto da IA.
O que ainda falta esclarecer
O post sugere ganhos de robustez e velocidade, mas não detalha métricas objetivas ou limitações do workflow. Resta saber até que ponto a especificação formal escala em times maiores, e como lida com requisitos fluidos em projetos exploratórios.
Para quem enfrenta o “slop” dos agentes generativos, a lição é clara: não há atalho para o rigor — specs bem escritas continuam sendo a âncora da engenharia, mesmo em tempos de IA.
Fonte: acai.sh/blog/specsmaxxing