docs: estrutura fluxo de três agentes (Interlocutor, Executor, Auditor)

[LuanTrindade95]

O que muda

Estrutura o fluxo de três agentes do repositório. Nenhum código de aplicação é alterado.

• CLAUDE.md (raiz, novo): faz da sessão principal o Interlocutor. Define:
  • a ordem de leitura do brain, com os caminhos reais: brain/CLAUDE.md, brain/canonico/*, brain/context/01_SYSTEM_OVERVIEW.md, brain/PENDING_UPDATES.md, brain/decisions/ e brain/handoffs/;
  • a observação de contexto que precede o Executor;
  • o Auditor recebendo o resultado sem o caminho da correção;
  • a reprovação voltando ao Executor;
  • o checklist de encerramento, as cinco leis (SEC, TEST, DATA, GIT, escopo) e a diretriz de comunicação.
• .claude/agents/executor.md (novo): subagente em sonnet com Read, Edit, Write, Bash, Grep e Glob. Segue a disciplina plano → execução → verificação, com evidência por passo e proibição de skip, desabilitar teste ou amputar pipeline.
• .claude/agents/auditor.md (novo): subagente adversarial em opus, só leitura (Read, Bash, Grep e Glob). Refaz as checagens, procura fraude e fecha com um veredito de uma linha: APROVADO ou REPROVADO.

Por quê

Rodar um projeto por vez com correção auditada, sem vazar escopo. A hierarquia de confiança e o checklist de encerramento continuam em brain/CLAUDE.md; o CLAUDE.md da raiz só referencia esse arquivo, sem duplicar o conteúdo.

Para o revisor

• O fluxo já foi usado na correção do CI (f78be75, f09f7c3 no main): o Auditor reprovou duas tentativas antes de aprovar a terceira.
• CLAUDE_CODE_SUBAGENT_MODEL não está definida no ambiente, então valem os modelos fixados em cada agente.
• O branch foi criado a partir de 11eb071; o diff contra o main atual contém só os três arquivos acima.

🤖 Generated with Claude Code