Come può un agente di codifica correggere un bug, eseguire test e fare commit mentre rimani in controllo?

Question

Accepted Answer

Un agente di codifica può gestire una correzione di bug end-to-end — riprodurre, localizzare, correggere, verificare, fare commit — ma rimani in controllo gating il ciclo con **autorizzazioni limitate, approvazione umana e piccoli step reversibili**. L'agente fa la digitazione; tu decidi cosa effettivamente approda.

## Il ciclo

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

L'idea chiave è **verifica test-driven**: l'agente non afferma "corretto" — lo prova facendo passare un test fallace. Il test fallace dal step 1 è il segnale obiettivo che il cambiamento ha funzionato.

## Meccanismi di controllo

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

Eseguire in un **branch o git worktree** significa che il peggior caso è `git checkout main` — l'esperimento non ha mai toccato il tuo stato di lavoro. Piccoli commit reversibili rendono ogni singolo step facile da ispezionare e annullare.

## Perché è importante

Il coding agentico ti sposta dal digitare ogni riga al **revisione e steering**. La leva è reale, ma anche il rischio che un agente spedisca con fiducia un cambiamento sbagliato o distruttivo. Mantenere una porta di approvazione umana prima dei commit, verificare con test piuttosto che fidarsi della prosa, e isolare il lavoro in un branch ti consente di catturare la velocità dell'automazione rimanendo colui che decide cosa raggiunge `main`.