Construindo software com Claude Code

Parei de escrever a maior parte do código à mão há cerca de um ano. Não parei de fazer engenharia. O trabalho passou de digitar para especificar, revisar e construir o sistema que faz a digitação.

Esta é a configuração que uso hoje em trabalhos para clientes.

O pipeline

requisito
   ↓
planejamento    agente lê o repo, propõe um plano
   ↓
implementação   agente escreve código em um worktree
   ↓
testes          agente escreve e roda testes
   ↓
QA              um segundo agente exercita a mudança
   ↓
entrega         pull request com um resumo escrito

Cada etapa é uma rodada separada, com seu próprio contexto e sua própria definição de pronto. Essa separação importa. Uma única sessão longa deriva. Rodadas curtas, com escopo fechado e handoffs explícitos, continuam afiadas.

O que o humano faz

Eu escrevo o requisito. Reviso o plano antes de a implementação começar. Reviso o pull request no final.

Tudo entre esses pontos roda sem mim. Se o agente trava, ele para e avisa, em vez de chutar.

O que faz funcionar

Um bom repositório. Estrutura clara, testes de verdade, um CLAUDE.md que diz como as coisas são feitas. O agente só é tão bom quanto a base de código permite.
Verificação que o agente consegue rodar. Testes, checagem de tipos, linters, um servidor de desenvolvimento que ele consegue operar. Se o agente não consegue checar o próprio trabalho, vai errar com confiança.
Escopo pequeno por rodada. Uma feature, um bug, um refactor. Tarefas grandes são divididas antes de começar.
Handoffs escritos. Cada etapa escreve uma nota curta para a próxima. Essas notas viram a descrição do pull request.

O que eu meço

Tempo do requisito até o pull request revisado. Porcentagem de pull requests mergeados sem alterações. Número de vezes que precisei intervir no meio de uma rodada.

O último número é o que eu mais me esforço para baixar.