coding agent が bug を直し、test を実行し、commit する間、どうやって control を保ちますか？

Question

Accepted Answer

coding **agent** は bug fix を end-to-end に進められます。reproduce、locate、fix、verify、commit までです。ただし、**scoped permissions、human approval、小さく reversible な step** で loop を gate することで、あなたは control を保ちます。agent が typing し、あなたが何を land するかを決めます。

## loop

```text
1. REPRODUCE  → bug を示す failing test を書く/走らせる (red)
2. LOCATE     → codebase を search し、relevant files を読み、hypothesis を立てる
3. PROPOSE    → minimal fix を draft する (edit 前に plan を review 可能)
4. VERIFY     → tests + lint/typecheck を run → test が green になり fix が証明される
5. REVIEW     → approval のため DIFF を表示 (まだ commit しない)
6. COMMIT     → approval 後のみ、branch 上で clear message とともに commit
```

key idea は **test-driven verification** です。agent は「fixed」と主張するのではなく、failing test を green にして証明します。step 1 の failing test が、change が効いたことを示す objective signal です。

## control mechanisms

```text
- SCOPED PERMISSIONS → safe command (test, lint) を allowlist。その他は prompt
- APPROVAL GATES     → destructive/irreversible action + final commit を human が確認
- SMALL STEPS        → 1 回 1 focused change → review/revert が容易
- BRANCH / WORKTREE   → main から隔離。失敗したら捨てられる
- DIFF REVIEW        → agent summary ではなく actual diff を commit 前に読む
```

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

**branch or git worktree** で動かすと、worst case は `git checkout main` です。experiment は working state に触れません。小さく reversible な commit は、各 step を inspect/undo しやすくします。

## なぜ重要なのか

Agentic coding は、すべての line を自分で typing する状態から、**reviewing and steering** へあなたを移します。leverage は大きいですが、agent が自信満々に間違ったり destructive な change を ship する risk もあります。commit 前に human approval gate を置き、prose ではなく test で verify し、branch で作業を isolate することで、自動化の speed を得ながら、`main` に届くものを決める人でいられます。