ఒక కోడింగ్ ఏజెంట్ ఒక బగ్‌ను ఎలా సరిచేయగలదు, పరీక్ష నడుపుతుంది, మరియు మీరు నియంత్రణలో ఉన్నప్పుడు ప్రతిশ్రుతి చేయగలదు?

Question

Accepted Answer

ఒక కోడింగ్ **ఏజెంట్** బగ్ ఫిక్స్‌ను చివరి వరకు నడిపించగలదు — పునరుత్పత్తి, స్థానికీకరణ, ఫిక్స్, ధృవీకరణ, ప్రతిశ్రుతి — కానీ మీరు **స్కోప్ చేసిన అనుమతుల, మానవ ఆమోదం, మరియు చిన్న రిటర్నబుల్ దశల ద్వారా** నియంత్రణలో ఉంటారు. ఏజెంట్ టైపింగ్ చేస్తుంది; మీరు ఏది నిజంగా ల్యాండ్ చేస్తుందో నిర్ణయిస్తారు.

## లూప్

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

కీ ఆలోచన **టెస్ట్-ఓరియంటెడ్ ధృవీకరణ**: ఏజెంట్ "సరిచేయబడిన" అని చెప్పదు — ఇది విఫల పరీక్ష నిండటం చేసి దానిని నిరూపిస్తుంది. స్టెప్ 1 నుండి విఫల పరీక్ష మార్పు పనిచేసిన లక్ష్య సంకేతం.

## నియంత్రణ యంత్రాంగాలు

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

**బ్రాంచ్ లేదా git worktree** లో నడిపించడం అంటే చెత్త సందర్భం `git checkout main` — ప్రయోగం మీ పనిచేసే స్థితిని ఎప్పుడూ తాకలేదు. చిన్న, రిటర్నబుల్ కమిట్‌లు ఏదైనా ఏకైక దశను చేపట్టడానికి మరియు అన్డూ చేయడానికి సులభం చేస్తాయి.

## ఇది ఎందుకు ముఖ్యమైనది

ఏజెంటిక్ కోడింగ్ మీరు ప్రతి లైన్ టైప్ చేయడం నుండి **సమీక్షించడానికి మరియు స్టీరింగ్ చేయడానికి** మారుస్తుంది. లીవరేజ్ నిజమైనది, కానీ ఏజెంట్ ఆత్మవిశ్వాసంగా తప్పుడా లేదా విధ్వంసక మార్పుకు కారణమయ్యే ప్రమాదం కూడా ఉంది. కమిట్‌లకు ముందు మానవ ఆమోదన గేట్ నిర్వహించడం, గద్య విశ్వాసం కంటే పరీక్షల ద్వారా ధృవీకరించడం, మరియు బ్రాంచ్‌లో పనిని వేరుచేయడం స్వయంచాలక నిపుణత నుండి వేగాన్ని సంగ్రహించేందుకు మిమ్మల్ని అనుమతిస్తుంది `main` కు ఆసక్తి చేసేది అనిపిస్తూ.