<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.

researchplanimplementverify

// 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.

Validadores
o que confere a saída
Fontes
o que ela lê antes de escrever
Claude Code
o modelo e o que o configura
pedido
o prompt do operador
CLAUDE.md
como se trabalha aqui
specs/
arc42 · C4 · BDD · ADR
changes/
PRD · design · specs · tasks
src/ existente
o código que já está lá
Biome
lint e formatação
check
tipos e contratos
bun test
os *.test.js do tester
husky + lint-staged
o pre-commit
commitlint
a mensagem do commit
CI
os workflows do GitHub
Claude Code
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
Recursos do Claude Code · em .claude/
agents
11 ofícios, cada um na sua janela
skills
52 procedimentos
rules
47 defeitos proibidos
hooks
khaby-lame.sh, antes do Write
commands
/craft /ship /audit /sync /extend
MCPs
ferramentas externas
src/[contexto]/[container]/[componente]/
o código — onde a saída vira arquivo, com o teste ao lado
lê
veredito
escreve
configuram
confere

Fontes

o que ela lê antes de escrever

pedidoCLAUDE.mdspecs/changes/src/ existente
↓ lê

Claude Code

o modelo — prevê o próximo token a partir da janela

Recursos · .claude/

configuram o modelo

agents · 11skills · 52rules · 47hookscommands · 5MCPs
↓ escreve

src/[contexto]/[container]/[componente]/

onde a saída vira arquivo, com o teste ao lado

↓ confere

Validadores

o veredito volta para o modelo

Biomecheckbun testhusky + lint-stagedcommitlintCI
01
Research
lê specs/ · src/ — escreve evidência
02
Plan
lê specs/ — escreve changes/
03
Implement
lê tasks.md — escreve src/
04
Verify
lê src/ — escreve specs/
specs/ atualizado vira o ponto de partida do próximo research

// 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.

Workflow · do pedido ao merge
Quem faz o quê, em que ordem, e o que cada passo lê e escreve.
Operador
.claude/
Ofícios
Artefatos
Descreve o pedido
em linguagem natural
Rota Direto
resposta sem cerimônia
Aprova o push
sempre com confirmação
/craft
classifica pela forma
Pedido pequeno?
Anuncia o tempo
e segue a rota
khaby-lame.sh
escada no 1º Write
Research
investigator · surveyor
Plan
architect · designer
Implement
developer · tester
Verify
reviewer · releaser
specs/
o sistema como é
changes/
PRD · design · specs · tasks
src/
código e testes
sim
não
4 checks ✓
lê
escreve
lê tasks
escreve
verify atualiza specs/
pacote novo
Tempo 1

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

Tempo 2

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

Tempo 3

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

Tempo 4

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%

mais rápidomais lento

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

researchplanimplementverify

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.

Ver evidências