Kif agent ta' coding jista' jiggarantixxi bug, jidderja tests, u jilkometti filwaqt li inti tibqgħu fil-kontroll?

Question

Accepted Answer

Agent ta' coding **jista'** idderja fix ta' bug minn tmiem għal tmiem — reproduċi, sikilizza, iggarantixxi, verifica, ilkometti — iżda inti tibqgħu fil-kontroll billi tilota l-loop b'**permessi limitati, approvazzjoni mir-raġel, u passes żgħar li jistgħu jirritornaw**. L-agent jagħmel it-typing; inti tiddeċidi x'verament jissal.

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

L-idea ewlenija hi **verifikazzjoni drivven minn tests**: l-agent ma jgħidx "tiggarantixxi" — jippruvaha billi jagħmel test li jiflaħ jinħela. It-test li jiflaħ minn pass 1 huwa s-sinjal tal-objettiv li l-bidla htiegħet.

## Mekkaniżmi ta' kontroll

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

Jtħaddem f'**branch jew git worktree** ifisser il-każ agħar huwa `git checkout main` — l-esperiment qatt ma messa l-istat tax-xogħol tiegħek. Commits żgħar u li jistgħu jirritornaw jagħmlu kull pass waħdieni faċli biex tiċċekkja u tindulxX.

## Għaliex hija importanti

Agentic coding isostak minn typing kull linja għal **review u steering**. Il-leverage huwa reali, iżda l-riskju ta' agent li b'kunfidenza iċċedi bidla ħażina jew dstruttiva huwa reali wkoll. Iżda irridu tgħodd l-approvazzjoni mir-raġel qabel commits, verifica b'tests aktar milli ittellef f'prosa, u iżola xogħol f'branch ileħħak taqbad il-veloċità tal-awtomazzjoni filwaqt li inti tibqa' dik li tiddeċidi x'jissal `main`.