کوڈنگ ایجنٹ کوئی بگ کیسے ٹھیک کر سکتا ہے، ٹیسٹ چلا سکتا ہے، اور کمٹ کر سکتا ہے جبکہ آپ کنٹرول میں رہتے ہیں؟

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` تک کیا پہنچتا ہے۔