Kuinka koodausagentit voivat korjata virheen, suorittaa testit ja tehdä commititin samalla kun pysyt hallinnassa?

Question

Accepted Answer

Koodaus-**agentti** voi ohjata virheenkorjausta alusta loppuun — uudelleen tuottaminen, paikallistaminen, korjaaminen, tarkistaminen, commit — mutta pysyt hallinnassa rajoittamalla silmukkaa **rajallisilla oikeuksilla, ihmisen hyväksynnällä ja pienillä palautettavilla vaiheilla**. Agentti kirjoittaa; sinä päätät, mitä todella pääsee koodiin.

## Silmukka

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

Päätapaus on **testinohjaama varmistaminen**: agentti ei väitä "korjattu" — se todistaa sen tekemällä epäonnistuvasta testistä onnistuvan. Epäonnistunut testi vaiheesta 1 on objektiivinen signaali, joka todistaa, että muutos toimi.

## Hallintamekanismit

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

Ajaminen **haarassa tai git worktreessa** tarkoittaa, että pahin tapaus on `git checkout main` — kokeilu ei koskaan koskettanut työtilaa. Pienet, palautettavat commitit tekevät jokaisesta vaiheesta helposti tarkasteltavan ja peruutettavan.

## Miksi sillä on merkitystä

Agenttipohjaiset koodaukset siirtävät sinut jokaisen rivin kirjoittamisesta **tarkasteluun ja ohjaukseen**. Vipuvaikutus on todellinen, mutta niin on myös riski siitä, että agentti lähettää itsevarmuuden kanssa väärän tai tuhoavan muutoksen. Ihmisen hyväksyntäportin säilyttäminen ennen committeja, varmentaminen testien avulla tekstin sijaan ja työn eristäminen haarassa antaa sinulle mahdollisuuden saada automaation nopeus samalla kun pysyt henkilönä, joka päättää, mitä `main` saavuttaa.