AMAZING AGENTS

Produz diagramas C4, esqueletos estruturais no formato arc42-lite e ADRs (Architecture Decision Records), mantendo tudo sincronizado com o código através de rastreamento de commits. Todos os diagramas são renderizados em Mermaid, compatível com versionamento.

1. Invocação manual— você dispara; ele nunca roda sozinho nem comita alterações.
2. Comparação de estado — o script arch-doc-sync.sh compara o commit documentado com o HEAD para decidir entre bootstrap, atualização seletiva ou skip.
3. Geração direcionada— análise completa na primeira execução ou atualização cirúrgica apenas das seções afetadas.

Evita loops infinitos de atualização armazenando o commit fonte que a documentação descreve, não apenas o HEAD. Exclui explicitamente o diretório docs/architecture/ da detecção de mudanças, para que commits de docs não disparem nova geração.

Copie os arquivos para a raiz do repositório (.claude/agents/, .claude/commands/, scripts/ e templates em docs/architecture/), torne o script executável e reinicie o Claude Code.

Invoque via /document-architecture ou peça diretamente para o Claude usar o agent.

• ARCH_DOCS_DIR controla a localização da documentação.
• O parâmetro model: no frontmatter escolhe entre opus (melhor inferência, mais caro) e sonnet (econômico).
• A inferência C4 da primeira execução pode exigir revisão manual em codebases complexos. Nada é comitado automaticamente — tudo passa por PR.

Um hook de UserPromptSubmitque analisa cada prompt antes do envio e avalia se ele continua o trabalho atual ou inicia um tópico novo — sugerindo /clear para tarefas não relacionadas ou /compact para sessões grandes demais.

Usa "zero-cost gates" para barrar a maioria dos prompts imediatamente (slash commands e mensagens curtas). Apenas sessões maiores acionam o modelo. Ele monta um resumo a partir da mensagem inicial e das três últimas trocas, condensado em ~400 tokens, e envia esse digest junto com seu novo prompt ao Claude Haiku, que responde RELATED ou NEW.

Como hooks do Claude Code não conseguem disparar comandos sozinhos, a ferramenta funciona como um gate: ela segura o prompt e sugere a ação, devolvendo o controle para você — basta apertar a seta para cima e reenviar, ou rodar o comando recomendado.

Coloque o script em .claude/hooks/, torne-o executável e registre-o em .claude/settings.json sob a configuração do hook UserPromptSubmit. Requer jq e, opcionalmente, uma ANTHROPIC_API_KEY para chamadas diretas à API.

Seis variáveis de ambiente controlam o comportamento: seleção de modelo, limiares de tamanho (MIN_BYTES em 150.000 e COMPACT_BYTES em 600.000 por padrão), duração do timeout e diretório de estado.

Cada verificação custa ~400–600 tokens de input no Haiku — frações de centavo. A economia real vem de evitar a poluição de contexto ao longo de vários turnos, que consome muito mais tokens no modelo principal e degrada a qualidade da saída.