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

Servidor MCP Conecta Claude ao Room EQ Wizard para Análise de Acústica de Estúdio
Um servidor MCP de código aberto dá ao Claude AI controle sobre o Room EQ Wizard, permitindo calibração automatizada de monitores de estúdio e análise de acústica da sala. A ferramenta inclui 27 ferramentas MCP para controle de medição, geração de sinal, medição de SPL e gerenciamento de EQ.

A Extensão Compass do Chrome Adiciona Ferramentas de Navegação ao Claude e ChatGPT
Um desenvolvedor criou uma extensão gratuita para Chrome chamada Compass que adiciona um minimapa de prompts, cabeçalhos de rolagem fixa, listas de verificação de sessão e modelos de construtor de prompts às interfaces do Claude e ChatGPT para resolver problemas de navegação em conversas longas.

Org Studio: Painel de código aberto para gerenciar equipes de IA multiagente
Org Studio é um painel de código aberto que aplica princípios de design organizacional para coordenar equipes de agentes de IA, com suporte nativo para os tempos de execução do OpenClaw e do Hermes Agent. Ele apresenta gerenciamento de topologia de equipe, quadros de tarefas orientados por eventos e comunicação entre tempos de execução, onde os agentes podem mencionar uns aos outros nos comentários das tarefas.

Cérebro da Equipe: Um Plugin de Memória Compartilhada para o Claude Code Que Armazena o Conhecimento da Equipe no Git
Team Brain é um plugin do Claude Code que armazena o conhecimento da equipe em uma pasta .team-brain/ dentro do seu repositório. Ele gera automaticamente um arquivo BRAIN.md limitado a 180 linhas para otimizar a precisão das instruções do Claude e funciona entre diferentes ferramentas criando arquivos .cursorrules e AGENTS.md.