Conas is féidir le gníomhaire cóid fabht a shocrú, tástálacha a rith, agus a dhlíofa, agus tusa i rialú?

Question

Accepted Answer

Is féidir le **gníomhaire** cóid corrughadh fabhtanna a thiomáint ó dheireadh go deireadh — atáirgeadh, aimsiú, corrughadh, fíorú, dhlíofa — ach fanann tú i rialú trí bheith ag geal an lúb le **ceadanna scópáilte, ceadú daonna, agus céimeanna beaga inchúlaithe**. An gníomhaire a dhéanann an clóscríobh; is tú a bheidh ag cinneadh cad atá ag fás i bhfírinne.

## An lúb

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

Is é an príomh-smaoineamh **fíorú tiomáinte ar thástálacha**: ní éilíonn an gníomhaire "deisithe" — cruthófhaidh sé é trí thástáil theipthe a fhágáil a imirt. Tástáil theipthe ó chéim 1 an comhartha oibiachtúil gur oibrígh an t-athrú.

## Meicníochtaí Rialúcháin

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

An rith i **brainse nó git worktree** ciallaíonn sé gur is ea an cás is measa `git checkout main` — níor bhain an turgnaimh do staid oibre riamh. Déanann gealltanais bheaga inchúlaithe gach céim éasca a bhreithniú agus a chur ar ceal.

## Cén fáth a bhíonn sé tábhachtach

Bogann cóid ghníomhaireach tú ó ghach líne a bheith ag clóscríobh go **bhreithniú agus stiúradh**. Tá an leabhar fíor ann, ach is amhlaidh an baol go ndlíofaidh gníomhaire go muiníneach athrú bocht nó scrios. Is féidir leat a choimeád ag doras ceadúcháin daonna roimh dhlíofa, a fhíorú le tástálacha seachas bheith ag muinín próis, agus obair a dhíolatóirigh i mbrainse a bhaint leat chun luas an uathoibrithe a ghabháil ar an taobh eile, go fóill tú an té a rianafaidh cad a bheidh ag teacht ar `main`.