Como um agente de codificação pode corrigir um bug, executar testes e fazer commit enquanto você mantém o controle?

Question

Accepted Answer

Um **agente** de codificação pode conduzir uma correção de bug do início ao fim — reproduzir, localizar, corrigir, verificar, fazer commit — mas você mantém o controle restringindo o loop com **permissões limitadas, aprovação humana e pequenos passos reversíveis**. O agente faz a digitação; você decide o que realmente chega ao `main`.

## O loop

```text
1. REPRODUCE  → write/run a failing test that demonstrates the bug (red)
2. LOCATE     → search the codebase, read the relevant files, form a hypothesis
3. PROPOSE    → draft a minimal fix (you can review the plan before any edit)
4. VERIFY     → run tests + lint/typecheck → fix is proven by the test going green
5. REVIEW     → show the DIFF for your approval (nothing committed yet)
6. COMMIT     → only after approval, on a branch, with a clear message
```

A ideia chave é **verificação orientada por testes**: o agente não afirma "corrigido" — prova isso fazendo um teste que falha passar. O teste que falha da etapa 1 é o sinal objetivo de que a mudança funcionou.

## Mecanismos de controle

```text
- SCOPED PERMISSIONS → allowlist safe commands (test, lint); prompt for the rest
- APPROVAL GATES     → human confirms destructive/irreversible actions + the final commit
- SMALL STEPS        → one focused change at a time → easy to review and revert
- BRANCH / WORKTREE   → work isolated from main; throw it away if it goes wrong
- DIFF REVIEW        → read the actual diff before commit, not just the agent's summary
```

```bash
# The agent runs the suite itself and reports the result before proposing a commit
npm test -- --runInBand   # red before the fix, green after → objective verification
git diff                  # you review every line that will be committed
```

Executar em uma **ramificação ou git worktree** significa que o pior caso é `git checkout main` — o experimento nunca tocou seu estado de trabalho. Pequenos commits reversíveis tornam fácil inspecionar e desfazer qualquer etapa individual.

## Por que isso importa

A codificação por agente o afasta de digitar cada linha para **revisar e orientar**. A alavancagem é real, mas o risco de um agente enviar com confiança uma mudança errada ou destrutiva também é real. Manter uma porta de aprovação humana antes de commits, verificar com testes em vez de confiar em prosa e isolar o trabalho em uma ramificação permite que você aproveite a velocidade da automação enquanto permanece como o responsável pelo que chega ao `main`.