Jak agent kodujący może naprawić błąd, uruchomić testy i zacommitować, podczas gdy ty pozostajesz w kontroli?

Question

Accepted Answer

**Agent** kodujący może przeprowadzić naprawę błędu od początku do końca — odtworzyć, zlokalizować, naprawić, zweryfikować, zacommitować — ale ty pozostajesz w kontroli, poprzez ograniczenie pętli **ograniczonymi uprawnieniami, zatwierdzeniem człowieka i małymi odwracalnymi krokami**. Agent pisze kod; ty decydujesz, co faktycznie trafia do produkcji.

## Pętla

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

Kluczowym pomysłem jest **weryfikacja oparta na testach**: agent nie twierdzi, że "naprawił" — dowodzi tego, powodując, że nieudany test przechodzi. Nieudany test z kroku 1 jest obiektywnym sygnałem, że zmiana zadziałała.

## Mechanizmy kontroli

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

Uruchomienie na **gałęzi lub git worktree** oznacza, że najgorszym przypadkiem jest `git checkout main` — eksperyment nigdy nie dotknął twojego stanu roboczego. Małe, odwracalne commity sprawdzą, że każdy pojedynczy krok można łatwo zbadać i cofnąć.

## Dlaczego to ważne

Kodowanie agentowe zmienia cię z pisania każdej linii na **przeglądanie i sterowanie**. Przychód jest rzeczywisty, ale tak samo rzeczywiste jest ryzyko, że agent z pewnością wyśle błędną lub destrukcyjną zmianę. Utrzymując bramę zatwierdzenia człowieka przed commitem, weryfikując testami zamiast polegać na tekście, i izolując pracę w gałęzi, możesz uchwycić szybkość automatyzacji, pozostając osobą, która decyduje, co trafia do `main`.