Specsmaxxing: Combatendo a Psicose de IA com Especificações YAML e ACAI

O post mais recente do blog da Acai.sh, "Specsmaxxing – On overcoming AI psychosis, and why I write specs in YAML," aborda o problema de agentes de IA saindo dos trilhos quando as janelas de contexto ficam cheias ou as sessões morrem. O autor compartilha um fluxo de trabalho prático: escrever especificações estruturadas em YAML em vez de apenas markdown, e usar requisitos numerados (ex.: AUTH-1, AUTH-2) que os agentes podem referenciar diretamente no código. Este método, chamado Critérios de Aceitação para IA (ACAI), surgiu quando um subagente numerou automaticamente os requisitos e os referenciou na implementação, melhorando a rastreabilidade e reduzindo regressões.
O post descreve um processo de quatro etapas: Especificar (escrever requisitos em YAML), Entregar (deixar os agentes implementarem), Revisar (verificar o código em relação às especificações) e Iterar. O autor admite que antes exagerava nas especificações em markdown (PRDs, TRDs, documentos de arquitetura) e sofria de "psicose de IA" — gastando mais tempo construindo arneses de IA do que produtos. A abordagem baseada em YAML é mais leve e mais acionável por máquinas.
Insight chave: um simples README.md e AGENTS.md já melhoram significativamente a saída dos agentes. O post argumenta que o "Peak Slop" passou e que especificações estruturadas são a próxima evolução. Um trecho de código mostra o padrão:
# Requirements
AUTH-1: Accepts `Authorization: Bearer <token>` header
AUTH-2: Tokens are user-scoped, providing access to any of the user's resources
AUTH-3: Rejects with 401 Unauthorized
// AUTH-1
const authHeader = req.headers["authorization"];
// AUTH-2
const isAuthorized = verifyBearerToken(authHeader);
// AUTH-3
if (!isValid) return res.status(401).json({ error: "Unauthorized" });
O post também revisa alternativas: GitHub SpecKit, OpenSpec, Kiro, Traycer.ai — e lista razões pelas quais você pode não gostar do acai.sh (ex.: sobrecarga, formato opinativo). É uma visão pragmática para desenvolvedores que querem que seus agentes de IA entreguem código confiável sem loops constantes de ajuste e correção.
Para quem é: Desenvolvedores que usam agentes de codificação de IA (Claude, Copilot, etc.) que encontram limites de contexto e querem uma camada de especificação leve para manter os agentes no caminho certo.
📖 Leia a fonte completa: HN AI Agents
👀 See Also

Claude Watch: Ferramenta de Código Aberto Visualiza a Lógica de Código Gerada por IA
Claude Watch é uma ferramenta de código aberto que fornece visualização semântica gráfica para projetos construídos com agentes de codificação de IA como o Claude Code. Ele analisa o código de forma aninhada e inclui pesquisa com IA para responder perguntas sobre a lógica do projeto.

Tacit: Uma linguagem de programação LLM-First construída com Claude Code e Opus 4.7
Tacit é uma linguagem de programação experimental, pensada primeiro para LLMs, projetada e implementada usando Claude Code e Opus 4.7. Ela elimina conveniências humanas para minimizar o uso de tokens e vem com um primer que ensina LLMs de nível médio+ (Sonnet e superiores) a escrever código Tacit.

A ferramenta Depct coleta dados de tempo de execução para ajudar o Claude a depurar problemas de produção.
Depct é uma ferramenta que coleta instrumentação de tempo de execução de aplicativos Node.js, constrói gráficos a partir dos dados e os envia para o Claude via AWS Bedrock para ajudar a depurar falhas intermitentes em produção. Também gera diagramas de arquitetura e mapas de dependência a partir do comportamento em tempo de execução.

Utilizador do Reddit experimenta com agentes de programação que aprendem com falhas para quebrar ciclos de repetição
Um desenvolvedor no r/LocalLLaMA descreve experimentar com agentes de programação que aprendem com falhas armazenando causas raiz simplificadas e correspondendo correções, reduzindo loops de erro repetitivos.