Plan Mode और कार्य ट्रैकिंग

Triggerfish संरचित कार्य के लिए दो पूरक tools प्रदान करता है: जटिल कार्यान्वयन योजना के लिए plan mode, और sessions में कार्य प्रबंधन के लिए todo ट्रैकिंग।

Plan Mode

Plan mode agent को परिवर्तन करने से पहले केवल-पठन अन्वेषण और संरचित योजना तक सीमित करता है। यह agent को समस्या समझने से पहले कार्यान्वयन में कूदने से रोकता है।

Tools

plan_enter

Plan mode में प्रवेश करें। योजना स्वीकृत होने तक write operations (write_file, cron_create, cron_delete) को अवरुद्ध करता है।

Parameter	Type	आवश्यक	विवरण
goal	string	हाँ	Agent क्या बनाने/बदलने की योजना बना रहा है
scope	string	नहीं	अन्वेषण को विशिष्ट directories या modules तक सीमित करें

plan_exit

Plan mode से बाहर निकलें और उपयोगकर्ता अनुमोदन के लिए कार्यान्वयन योजना प्रस्तुत करें। स्वचालित रूप से निष्पादन शुरू नहीं करता।

Parameter	Type	आवश्यक	विवरण
plan	object	हाँ	कार्यान्वयन योजना (सारांश, दृष्टिकोण, चरण, जोखिम, फ़ाइलें, tests)

Plan object में शामिल है:

• summary -- योजना क्या पूरा करती है
• approach -- यह कैसे किया जाएगा
• alternatives_considered -- कौन से अन्य दृष्टिकोण मूल्यांकित किए गए
• steps -- कार्यान्वयन चरणों की क्रमबद्ध सूची, प्रत्येक में फ़ाइलें, dependencies, और सत्यापन
• risks -- ज्ञात जोखिम और शमन
• files_to_create, files_to_modify, tests_to_write
• estimated_complexity

plan_status

वर्तमान plan mode स्थिति लौटाता है: सक्रिय mode, लक्ष्य, और योजना प्रगति।

plan_approve

Pending योजना स्वीकृत करें और निष्पादन शुरू करें। उपयोगकर्ता द्वारा स्वीकृति देने पर कॉल किया जाता है।

plan_reject

Pending योजना अस्वीकार करें और सामान्य mode पर लौटें।

plan_step_complete

निष्पादन के दौरान एक योजना चरण को पूर्ण चिह्नित करें।

Parameter	Type	आवश्यक	विवरण
step_id	number	हाँ	पूर्ण चिह्नित करने के लिए चरण ID
verification_result	string	हाँ	सत्यापन कमांड का आउटपुट

plan_complete

संपूर्ण योजना को पूर्ण चिह्नित करें।

Parameter	Type	आवश्यक	विवरण
summary	string	हाँ	क्या पूरा किया गया
deviations	array	नहीं	मूल योजना से कोई परिवर्तन

plan_modify

स्वीकृत योजना चरण में संशोधन का अनुरोध करें। उपयोगकर्ता अनुमोदन आवश्यक है।

Parameter	Type	आवश्यक	विवरण
step_id	number	हाँ	कौन से चरण को बदलना है
reason	string	हाँ	परिवर्तन क्यों आवश्यक है
new_description	string	हाँ	अपडेट किया गया चरण विवरण
new_files	array	नहीं	अपडेट की गई फ़ाइल सूची
new_verification	string	नहीं	अपडेट किया गया सत्यापन कमांड

Workflow

1. उपयोगकर्ता कुछ जटिल माँगता है
2. Agent plan_enter({ goal: "..." }) कॉल करता है
3. Agent codebase का अन्वेषण करता है (केवल-पठन tools ही)
4. Agent plan_exit({ plan: { ... } }) कॉल करता है
5. उपयोगकर्ता योजना की समीक्षा करता है
6. उपयोगकर्ता स्वीकृत करता है → agent plan_approve कॉल करता है
   (या अस्वीकार करता है → agent plan_reject कॉल करता है)
7. Agent चरण-दर-चरण निष्पादित करता है, प्रत्येक के बाद plan_step_complete कॉल करता है
8. Agent पूर्ण होने पर plan_complete कॉल करता है

Plan Mode कब उपयोग करें

Agent जटिल कार्यों के लिए plan mode में प्रवेश करता है: features बनाना, systems को refactor करना, बहु-फ़ाइल परिवर्तन लागू करना। सरल कार्यों (typo ठीक करना, variable rename) के लिए, यह plan mode छोड़कर सीधे कार्य करता है।

Todo ट्रैकिंग

Agent के पास sessions में बहु-चरण कार्य ट्रैक करने के लिए एक स्थायी todo सूची है।

Tools

todo_read

वर्तमान todo सूची पढ़ें। सभी items उनकी ID, सामग्री, स्थिति, प्राथमिकता, और timestamps के साथ लौटाता है।

todo_write

संपूर्ण todo सूची बदलें। यह पूर्ण प्रतिस्थापन है, आंशिक अपडेट नहीं।

Parameter	Type	आवश्यक	विवरण
todos	array	हाँ	Todo items की पूर्ण सूची

प्रत्येक todo item में:

फ़ील्ड	Type	मान
id	string	अद्वितीय पहचानकर्ता
content	string	कार्य विवरण
status	string	pending, in_progress, completed
priority	string	high, medium, low
created_at	string	ISO timestamp
updated_at	string	ISO timestamp

व्यवहार

• Todos प्रति-agent (प्रति-session नहीं) scoped हैं -- ये sessions, trigger wakeups, और पुनरारंभों में persist करते हैं
• Agent केवल वास्तव में जटिल कार्यों (3+ विशिष्ट चरण) के लिए todos उपयोग करता है
• एक समय में एक कार्य in_progress होता है; पूर्ण items तुरंत चिह्नित होते हैं
• जब agent एक नई सूची लिखता है जो पहले संग्रहीत items को छोड़ देती है, वे items स्वचालित रूप से completed के रूप में संरक्षित होते हैं
• जब सभी items completed होते हैं, पुराने items संरक्षित नहीं होते (साफ़ शुरुआत)

प्रदर्शन

Todos CLI और Tidepool दोनों में render होते हैं:

• CLI -- स्थिति icons के साथ styled ANSI box: ✓ (पूर्ण, strikethrough), ▶ (प्रगति में, bold), ○ (pending)
• Tidepool -- प्रत्येक स्थिति के लिए CSS classes के साथ HTML सूची