طویل عرصے سے چلنے والا ایجنٹ ورک فلو

اس پلے بک کا استعمال کریں جب کسی کام کے متعدد سیشنز، ہینڈ آف، یا اسپاون ایجنٹس پر محیط ہونے کا امکان ہو۔

اہداف

• ہر تازہ سیشن کو سیاق و سباق کو دوبارہ حاصل کرنے کا ایک تیز طریقہ دیں
• کام کو ایک بڑی تبدیلی کے بجائے بڑھتے ہوئے رکھیں۔
• مزید کوڈ شامل کرنے سے پہلے ٹوٹی ہوئی مقامی بیس لائن کو پکڑیں۔
• پائیدار نمونے چھوڑیں جن پر اگلا سیشن بھروسہ کر سکے۔

ریاست کو کہاں رکھنا ہے۔

• docs/agent-runs/<slug>/ استعمال کریں جب انسانوں، ریویو بوٹس، یا متعدد ٹول چینز کو ایک ہی کام کی حالت کی ضرورت ہو۔
• ٹول لوکل ڈائرکٹری کا استعمال کریں جیسے .codex/runs/<slug>/ صرف اس صورت میں جب ٹاسک اسٹیٹ ایک ورک سٹیشن یا ایک ٹول چین کے لیے جان بوجھ کر مقامی ہو۔
• ایک نجی سکریچ فائل میں ملٹی سیشن کی مشترکہ حالت کو نہ چھپائیں اگر بعد میں کسی دوسرے معاون یا ایجنٹ کو اس کی ضرورت پڑے۔

مطلوبہ فائلیں۔

طویل عرصے سے چلنے والے کام کے آغاز پر یہ فائلیں بنائیں:

• feature-list.json
• progress.md

ٹیمپلیٹس کو docs/agent-playbooks/templates/feature-list.template.json اور docs/agent-playbooks/templates/progress.template.md میں استعمال کریں۔

فیچر لسٹ کے لیے JSON کو ترجیح دیں تاکہ ایجنٹ پوری دستاویز کو دوبارہ لکھے بغیر تھوڑی تعداد میں فیلڈز کو اپ ڈیٹ کر سکیں۔

سیشن شروع چیک لسٹ

1. pwd چلائیں۔
2. progress.md پڑھیں۔
3. feature-list.json پڑھیں۔
4. git log --oneline -20 چلائیں۔
5. ./scripts/agent-init.sh --smoke چلائیں۔
6. بالکل ایک اعلی ترین ترجیحی آئٹم منتخب کریں جو ابھی بھی pending، in_progress، یا blocked ہے۔

اگر دھواں والا مرحلہ ناکام ہو جاتا ہے تو، نئی فیچر سلائس کو لاگو کرنے سے پہلے ٹوٹی ہوئی بیس لائن کو ٹھیک کریں۔

سیشن رولز

• ایک وقت میں ایک فیچر یا ٹاسک سلائس پر کام کریں۔
• فیچر لسٹ کو مشین کے پڑھنے کے قابل اور مستحکم رکھیں۔ غیر متعلقہ آئٹمز کو دوبارہ لکھنے کے بجائے اسٹیٹس، نوٹس، فائلز، اور تصدیقی فیلڈز کو اپ ڈیٹ کریں۔
• صرف اس آئٹم میں درج کمانڈ یا صارف کے بہاؤ کو چلانے کے بعد تصدیق شدہ آئٹم کو نشان زد کریں۔
• باؤنڈڈ سلائسز کے لیے پیدا کیے گئے ایجنٹس کا استعمال کریں، نہ کہ مجموعی ٹاسک اسٹیٹ کی ملکیت کے لیے۔
• جب چائلڈ ایجنٹ ایک آئٹم کا مالک ہوتا ہے، تو اسے صحیح آئٹم کی شناخت، قبولیت کے معیار، اور فائلیں دیں جو اسے چھو سکتی ہیں۔

سیشن اینڈ چیک لسٹ

1. مختصر پیش رفت کو شامل کریں progress.md۔
2. feature-list.json میں چھوئے گئے آئٹم کو اپ ڈیٹ کریں۔
3. تصدیق کے لیے چلائے گئے عین مطابق کمانڈز کو ریکارڈ کریں۔
4. کیپچر بلاکرز، فالو اپس، اور دوبارہ شروع کرنے کے لیے اگلی بہترین آئٹم۔

تجویز کردہ پیشرفت اندراج کی شکل

ایک مختصر ڈھانچہ استعمال کریں جیسے:

## 2026-03-17 14:30

- Item: F003
- Summary: Updated the browser-check flow to use the shared init/bootstrap path.
- Files: `.cursor/agents/browser-check.md`, `.codex/agents/browser-check.toml`
- Verification: `corepack yarn build`, `corepack yarn lint`, `corepack yarn typecheck`
- Next: Run the smoke flow and update the task-board status.