<omh-o-fluxo />
Research → plan → implement → verify. Todos seguem. Ninguém decora.
É o ritmo de quem pareia bem: olha antes de escrever, propõe uma forma, escreve, confere. O CLAUDE.md conduz — anuncia o tempo em uma linha e segue, sem pedir licença.
// Onde você está no harness
Esta página explica as setas
Ler, escrever, conferir, devolver o veredito: o fluxo é o caminho que liga todas as peças.
o prompt do operador
como se trabalha aqui
arc42 · C4 · BDD · ADR
PRD · design · specs · tasks
o código que já está lá
lint e formatação
tipos e contratos
os *.test.js do tester
o pre-commit
a mensagem do commit
os workflows do GitHub
o modelo — prevê o próximo token a partir da janela
tudo em volta decide o que entra na janela e o que sai dela
11 ofícios, cada um na sua janela
52 procedimentos
47 defeitos proibidos
khaby-lame.sh, antes do Write
/craft /ship /audit /sync /extend
ferramentas externas
o código — onde a saída vira arquivo, com o teste ao lado
Fontes
o que ela lê antes de escrever
Claude Code
o modelo — prevê o próximo token a partir da janela
Recursos · .claude/
configuram o modelo
src/[contexto]/[container]/[componente]/
onde a saída vira arquivo, com o teste ao lado
Validadores
o veredito volta para o modelo
Research
lê specs/ · src/ — escreve evidência
Plan
lê specs/ — escreve changes/
Implement
lê tasks.md — escreve src/
Verify
lê src/ — escreve specs/
// O workflow completo
Do pedido ao merge, em quatro raias
Quem faz o quê, em que ordem, e o que cada passo lê e escreve. Pedido pequeno sai pela rota Direto; o resto percorre os quatro tempos até o push com confirmação.
Research
O que já é verdade aqui?
Quem responde
investigator · surveyor
Lê
specs/ e src/
Escreve
Evidência com arquivo:linha — nada de código ainda
Por que este tempo existe
Em repositórios maduros, com mais de 1 milhão de linhas, devs experientes com IA foram 19% mais lentos. Entender antes de escrever é o que evita a volta.
Fonte: METR, 2025
Plan
Que forma isto toma?
Quem responde
architect · designer
Lê
specs/
Escreve
changes/NNN/ — PRD, design, specs, tasks
Por que este tempo existe
A pesquisa mais recente propõe governança por especificação: contratos antes da geração reduzem o “imposto de verificação”.
Fonte: Farrag, arXiv 2026
Implement
Escrever o que o plano diz.
Quem responde
developer · tester · writer
Lê
changes/NNN/tasks.md
Escreve
src/, com o teste ao lado
Por que este tempo existe
Com a tarefa bem definida, a IA acelera de verdade: −21% de tempo no Google, 55,8% mais rápido no experimento do Copilot.
Fonte: Google RCT, 2024
Fonte: Peng et al., 2023
Verify
Isto prova o que diz?
Quem responde
reviewer · tester · releaser
Lê
src/ e changes/NNN/
Escreve
Veredito, nota de MR e specs/ atualizado
Por que este tempo existe
Com alta adoção, o tempo de revisão sobe 91% e os bugs por dev, 9%. Verificar com ofícios dedicados é onde o ganho individual vira ganho do time.
Fonte: Faros AI, 2025
Escopo definido acelera. Escopo aberto freia.
Variação de velocidade com IA em três estudos controlados.
Copilot · tarefa fechada
+55,8%
Google · tarefas corporativas
+21%
METR · repositórios maduros
−19%
Fonte: Peng et al., 2023
Fonte: Google RCT, 2024
Fonte: METR, 2025
// Transparente
Visível, e sem atrito
Visível porque o tempo é anunciado em uma linha. Sem atrito porque ninguém precisa pedir, aprovar ou nomear nenhum dos quatro.
- Anuncia o tempo: “vou ler a fatia antes”
- Não pede licença para avançar — para em ambiguidade ou bloqueio
- Diz quando pula um tempo, e por quê
- Você entra em qualquer tempo: “já investiguei, implementa”
- Volta atrás em voz alta quando o implement desmente o research
// O ritmo encolhe
A maioria dos pedidos usa dois tempos
Typo, renome, pergunta · Direto
Bug
Alterar comportamento
Feature nova
A disciplina de especificação humana — não a capacidade do modelo — é a restrição que decide se o desenvolvimento com IA é confiável.
Farrag, The Productivity-Reliability Paradox, arXiv 2026 (tradução livre)
Todos os números, com as fontes
Os estudos por trás de cada afirmação — e o que eles não provam.