Inteligência precisa de direção

O mecanismo

O que precisa existir antes de chamar o código de entrega

1. 01

   Código pronto não é entrega pronta

   Um arquivo que compila ainda não é uma entrega. Falta o propósito do pedido, o limite do que pode mudar e a prova de que o resultado confere com o que foi pedido.

   Sem esses três, a inteligência acelera o arquivo errado. O CodeSteer existe para colocar propósito, limites e prova antes de tratar o código como concluído.

2. 02

   O harness tem três camadas

   O modelo gera texto. O runtime executa, com as ferramentas e as permissões da sessão. O CodeSteer dirige o ciclo: contrato, gate e evidência.

   Modelo, runtime e CodeSteer formam o harness. Nenhuma camada, sozinha, transforma um pedido em entrega.

3. 03

   Papéis e contratos

   A spec descreve o comportamento esperado. A revisão confere se esse contrato está claro. A arquitetura entra quando a mudança pede desenho — quando necessária, não em todo pedido.

   O plano trava arquivos e estratégia. O código segue esse escopo. A conferência compara o que foi pedido com o que apareceu.

4. 04

   A memória que permanece

   A conversa acaba. Permanecem a constitution, com os princípios que precedem o resto; o runbook, com as lições locais; as specs de cada iniciativa; e o state, que registra a fase da entrega.

   Essa memória mora no repositório da iniciativa. Ela não é a Base Cognitiva: não organiza o segundo cérebro do projeto em notas de Obsidian.

5. 05

   O rigor é proporcional

   O caminho muda com o track. HOTFIX trata regressão crítica. BUGFIX ataca uma causa confirmada. TASK fecha uma mudança pequena. FEATURE liga produto e execução. EPIC conduz frentes interdependentes.

   A autonomia também muda. O modo supervised para no humano em cada gate. O modo auto-safe pode avançar quando o critério objetivo está registrado. O modo auto-full permanece reservado e não está habilitado.

6. 06

   A evidência pode contrariar o agente

   A prova não confirma o agente por educação. Um filtro de status mostra o caso: a opção “Todas” deveria listar os registros, qualquer que fosse o status. A implementação comparou “Todas” como se fosse um status literal.

   Esperado 3. Observado 0.

   Nenhum registro correspondeu ao status “Todas”. A conclusão só aparece depois de corrigir e conferir de novo. O merge continua humano: a squad pode abrir a evidência, e a decisão de integrar permanece com quem responde pelo repositório.

7. 07

   Limites explícitos

   Instrução documentada não é isolamento técnico absoluto. Ela orienta o agente; a aplicação depende do runtime, dos contratos, das permissões e das evidências.

   O rigor muda com o track. O desenho de um HOTFIX não é o de um EPIC, e um modo de autonomia não apaga os limites que continuam humanos.

O Atlas coloca o repositório no contexto. A squad dirige.

O contexto do repositório vem do Atlas: ele encontra o código certo, mostra as relações entre arquivos, símbolos e documentos, e entrega ao agente a fonte para conferir. A squad dirige a entrega com propósito, limites e prova.