Passando das regras do CLAUDE.md para a aplicação de infraestrutura com Citadel

O problema com o acúmulo de regras

Quando Claude ignorava instruções, o instinto era adicionar mais regras ao CLAUDE.md. Começando com 45 linhas, ele cresceu para 190 linhas ao longo de três meses, mas a conformidade piorou. Instruções após a linha 100 começaram a ser tratadas como sugestões em vez de regras. Uma auditoria forense revelou 40% de redundância—regras dizendo a mesma coisa com palavras diferentes, regras contradizendo umas às outras e regras desatualizadas. Reduzir para 123 linhas melhorou a conformidade imediatamente.

A mudança para a infraestrutura

A solução real foi reconhecer o CLAUDE.md como um ponto de entrada para orientação (convenções do projeto, stack tecnológica, prioridades principais), não um lar permanente para todas as regras. Todo o resto deve ser carregado apenas quando necessário. A mudança crucial: transferir a aplicação das instruções para o ambiente.

Por exemplo, em vez de uma regra dizendo "sempre execute a verificação de tipos após editar um arquivo," que Claude seguia de forma inconsistente, um script de gancho de ciclo de vida é executado automaticamente em cada salvamento de arquivo. Isso garante que a verificação de tipos aconteça sem escolha do agente, mostrando erros imediatamente em vez de 20 edições depois. Isso reduziu drasticamente o tempo de revisão, permitindo focar na intenção e no design em vez de correr atrás de erros de tipo.

O sistema de progressão

O autor descreve uma progressão de cinco níveis:

• Nível 1: Prompting bruto (nada persiste, os mesmos erros se repetem)
• Nível 2: CLAUDE.md (as regras ajudam, mas atingem um limite por volta de 100 linhas)
• Nível 3: Habilidades (expertise modular que carrega sob demanda, zero tokens quando inativa)
• Nível 4: Ganchos (o ambiente aplica a qualidade, não as instruções)
• Nível 5: Orquestração (agentes paralelos, campanhas persistentes, ondas coordenadas)

A maioria dos projetos fica bem no Nível 2 ou 3. A percepção crítica: quando o CLAUDE.md para de funcionar, a resposta não é mais regras—é transferir a aplicação para a infraestrutura.

Implementações específicas

O autor implementou três sistemas principais:

• Habilidades: Arquivos Markdown codificando padrões, restrições e exemplos para domínios específicos. O agente carrega habilidades relevantes para a tarefa atual, evitando desperdício de tokens em contexto irrelevante.
• Arquivos de campanha: Documentos estruturados acompanhando o que foi construído, decisões tomadas e o que resta. Eles persistem entre sessões, eliminando reexplicações diárias.
• Ganchos automatizados: Verificação de tipos em cada edição, varredura de antipadrões no final da sessão, disjuntor que encerra o agente após 3 falhas repetidas no mesmo problema e proteção de compactação salvando o estado antes de Claude comprimir o contexto.

Citadel: O sistema de código aberto

O sistema completo, chamado Citadel, foi disponibilizado como código aberto em https://github.com/SethGammon/Citadel. Ele inclui o sistema de habilidades, ganchos, persistência de campanha e um comando /do que direciona tarefas para o nível de orquestração correto automaticamente. Construído a partir de 27 falhas documentadas em 198 agentes em uma base de código de 668K linhas, cada regra remonta a algo que quebrou.