Cike a zai iya gyara kuhi, aiwatar da ajiyawa, da aiki yayin da kake dauke?

Question

Accepted Answer

A **agent** code zai iya tukmanji gyara kuhi daga gida zuwa gida — sake gida, nemo, gyara, tabbatar, aiki — amma kana jiya sakoni ta iyakacce izini, imedawa mutane, da karami changewa changewa. Agent ya baje; ka yanke abin da ya shiga genu.

## The lula

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

Muhimmin tunani shine **baje daidaita tabbatarwa**: agent ba ya ce "gyara" — ya tabbatar da shi ta hanyar sa ajiyawa na bugi waje. An ajiyawa bugi daga matakin 1 shine alamar gaskiya cewa canji ya aiki.

## Tsarin jiyya

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

Juyin a **reshe ko git worktree** yana nufin mafi muni na abni shine `git checkout main` — gwaji bai tamajer da jiya ta aiki ni. Karami, jujewar masu rikicin tafiya kowane matakin sai a baje kewaye.

## Me yasa ya dambe

Agent code ya sauya ka daga baje kowane lain zuwa **baje ta hali**. Leveraj ta genu ne, kuma hattara yadda agent mai fifiko ta aiki mara kyau ko kahe. Ajiye koli ta imedawa mutane kafin aiki, tabbatar da ajiyawa maimakon amince jita, da kauye aiki a reshe ka bar ka kamata sauri na jiya ba lokaci sama da kaita mai kare cewa abin da ya kamata zuwa `main`.