लंबे समय से चलने वाला एजेंट वर्कफ़्लो

इस प्लेबुक का उपयोग तब करें जब किसी कार्य में कई सत्र, हैंडऑफ़ या उत्पन्न एजेंट शामिल होने की संभावना हो।

लक्ष्य

• प्रत्येक नए सत्र को संदर्भ पुनः प्राप्त करने का एक तेज़ तरीका दें
• एक ही बार में बड़ा बदलाव करने के बजाय काम को धीरे-धीरे बढ़ाते रहें
• अधिक कोड जोड़ने से पहले टूटी हुई स्थानीय आधार रेखा को पकड़ें
• टिकाऊ कलाकृतियाँ छोड़ें जिन पर अगला सत्र भरोसा कर सके

राज्य कहां रखें

• 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.