پلان موڈ استعمال کریں

یہ گائیڈ دکھاتی ہے کہ کوئی کوڈ لکھنے سے پہلے ایجنٹ سے ایک منظم پلان کیسے حاصل کیا جائے۔

پلان موڈ میں ایجنٹ صرف پڑھتے ہوئے تحقیق کرتا ہے اور اس کا واحد ڈیلیوریبل ایک ٹائپ شدہ پلان ہوتا ہے: مراحل کا ایک انحصار گراف جسے آپ منظور کرتے ہیں اور Control Center پھر اسے حقیقی کام میں کمپائل کرتا ہے۔ اسے اُس وقت استعمال کریں جب آپ کسی تبدیلی کا دائرہ دیکھنا، مراحل کی تقسیم حاصل کرنا، یا کچھ بھی چھونے سے پہلے خطرات اور انحصاروں کے نام جاننا چاہیں۔

اسپیس کو پلان موڈ میں بدلیں

اِن میں سے کوئی بھی اسپیس کا موڈ پلٹ دیتا ہے اور تبدیلی محفوظ ہو جاتی ہے:

کمپوزر ٹول بار کے بالکل بائیں جانب موڈ ڈراپ ڈاؤن سے پلان منتخب کریں
Shift+Tab دبائیں
/plan بھیجیں۔ اکیلا /plan صرف موڈ تیار کرتا ہے؛ /plan <request> اسے تیار کر کے باقی حصہ آپ کے پیغام کے طور پر بھیج دیتا ہے

/plan کبھی متن کے طور پر سفر نہیں کرتا — یہ محفوظ موڈ سیٹ کرتا ہے، اور وہی وہ اختیار ہے جسے ٹول سطح، گارڈ پریسیٹ اور پرامپٹ سب پڑھتے ہیں۔ چنانچہ موڈ اس باری اور اس کے بعد کی ہر باری کے لیے قائم رہتا ہے، جب تک آپ اسے واپس نہ بدلیں۔

موڈ اسپیس پر محفوظ ہوتا ہے، اس لیے ایک ہی ایجنٹ یہاں پلان موڈ میں اور کہیں اور ایجنٹ موڈ میں ہو سکتا ہے۔

ایجنٹ کیا تیار کرتا ہے

یہ صرف پڑھتے ہوئے تحقیق کرتا ہے — میموری، کوڈ انڈیکس، فائلیں
یہ submit_plan ایک بار کال کرتا ہے، ایک goal کے ساتھ nodes بھی، جن میں سے ہر ایک کے پاس ایک مستحکم key، ایک title، ایک description اور وہ نوڈ کلیدیں ہوتی ہیں جن پر وہ dependsOn کرتا ہے (اور یہی چیز آزاد کام کو متوازی چلنے دیتی ہے)
یہ رک جاتا ہے

ٹول گراف کی توثیق کرتا ہے — دہری کلیدیں، لٹکتی انحصاریں، سائیکل — اور ٹوٹا ہوا پلان قبول کرنے کے بجائے ایجنٹ کے ٹھیک کرنے کے لیے خلاف ورزیاں واپس کرتا ہے۔

پلان گفتگو میں ایک مختصر قطار کی صورت میں ظاہر ہوتا ہے جو ہدف، اس کی حالت اور مراحل کی تعداد دکھاتی ہے۔ Plan Studio — انحصار گراف، فی نوڈ انسپکٹر اور لاگت کا تخمینہ — گفتگو کے ساتھ ہی ایک ٹیب کے طور پر کھلتا ہے: قطار پر کھولیں دبائیں، یا بس انتظار کریں، کیونکہ جو پلان آپ کے گفتگو دیکھتے ہوئے 30 سیکنڈ کے اندر آ جائے وہ اپنا ٹیب خود کھول لیتا ہے۔

Control Center کا اپنا ہارنس ایجنٹ کی ٹول رجسٹری پلان موڈ کی سطح کی تفصیل سے بناتا ہے، چنانچہ سرے سے کوئی لکھنے، ترمیم کرنے یا کمانڈ چلانے والا ٹول موجود ہی نہیں جسے کال کیا جا سکے — یہ پابندی کوئی ایسی پرامپٹ ہدایت نہیں ہے جس سے ماڈل خود کو قائل کر کے نکل سکے۔

Claude Code اڈاپٹر کو ایسی کوئی چھانٹی نہیں ملتی: وہاں موڈ ایک درخواست کی صورت میں پہنچتا ہے جسے اس کا اپنا رنر مانے یا نہ مانے، اور Control Center کو صرف اس کی mcp__* کالز نظر آتی ہیں۔ موڈ ڈراپ ڈاؤن کے ساتھ والا نفاذ کا بیج ٹھیک اُسی صورت میں ظاہر ہوتا ہے۔

جب درخواست مبہم ہو تو ایک پلان والا ایجنٹ رک کر ask_user ٹول سے آپ سے تین بلاکنگ سوالات تک پوچھ سکتا ہے۔ یہ گفتگو میں ایک فارم رینڈر کرتا ہے — آپشنز، یا آزاد متن — اور رن آپ کے جواب تک بلاک رہتا ہے۔ یہ ٹول ریڈ ٹیئر کا ہے، چنانچہ پلان موڈ کی ریڈ اونلی سطح پر بھی باقی رہتا ہے، اور یہ منظوری ریپر سے مستثنیٰ ہے (ایک پرامپٹ کے سامنے دوسرا پرامپٹ، جب کوئی منظوری دینے والا منسلک نہ ہو، بند حالت میں ناکام ہو جائے گا، اور ایجنٹ پوچھنے کے عمل سے محروم رہ جائے گا)۔

اسے رینڈر ہونے کے لیے ایک اسپیس درکار ہے، چنانچہ بغیر کسی گفتگو والے ون شاٹ ڈسپیچ کو یہ نہیں ملتا۔ پھر بھی دائرہ، ہدف ریپو اور قبولیت کے معیار پہلے ہی اپنے پہلے پیغام میں شامل کر دینا ایک چکر لگانے سے تیز ہے۔

یہاں نثر کوئی ڈیلیوریبل نہیں ہے۔ وہ رن جو submit_plan کال کیے بغیر ختم ہو، گفتگو میں ایک نظر آنے والی سطر “Ended without submitting a plan (no submit_plan call).” لکھتا ہے اور رن کو اپنے ڈیلیوریبل سے محروم کے طور پر نشان زد کرتا ہے۔ رن کی حالت دانستہ طور پر completed رہتی ہے — اس سے پائپ لائن اور ٹکٹ کی اسٹیٹ مشینیں اچھوتی رہتی ہیں — چنانچہ سطر پڑھیں، اسٹیٹس بیج نہیں۔

پلان منظور کریں

گفتگو میں پلان والی قطار سے منظور کریں اور چلائیں دبائیں۔ Plan Studio کی منظوری بار سے پلان منظور کریں دبائیں (یا اس کے ساتھ والا مسترد کریں؛ جب تک گراف میں کوئی توثیقی خرابی ہو منظوری غیر فعال رہتی ہے)۔

پھر:

Control Center پلان کو ایک آرکیسٹریشن میں کمپائل اور میٹیریلائز کرتا ہے — ٹکٹس اور رن۔ اِس مرحلے میں کوئی ماڈل شامل نہیں ہے؛ یہ ڈٹرمینسٹک ہے
پلان اُسی ایجنٹ کے طور پر چلتا ہے جس نے اسے لکھا۔ کسی اور کو شامل کرنا ہے یا نہیں، یہ رن کے وقت اُسی ایجنٹ کا فیصلہ ہے — وہ کسی مرحلے کو delegate_task کے ذریعے کسی زیادہ موزوں ساتھی کو تفویض کر سکتا ہے، ورک اسپیس کی تفویض کی گہرائی کی حد کے اندر
پلان کا ہدف گفتگو کا ہدف بن جاتا ہے اور کام اُسی گفتگو میں چلتا ہے: ہر مرحلہ لکھتا ہے کہ ایجنٹ سے کیا مانگا گیا اور اپنی باری واپس اسٹریم کرتا ہے، چنانچہ آپ وہیں رہ کر اس کا پیچھا کرتے ہیں (اور کوئی باری روک بھی سکتے ہیں) جہاں آپ پہلے سے ہیں
گفتگو کے عام سائیڈ پینل میں (Todos کے نیچے) ہدف والی قطار رن کی پیش رفت settled/total کی صورت میں اور اس کا اسٹاپ بٹن رکھتی ہے؛ Plan Studio گراف پر فی نوڈ حالت دکھاتا ہے اور وہیں سے منسوخ بھی کرتا ہے

منظوری کے بغیر کام جاری رکھیں

اگر آپ پلان منظور کرنے کے بجائے اِسی گفتگو میں رہنا پسند کریں تو ایجنٹ exit_plan_mode کال کر سکتا ہے۔ یہی واحد جائز راستہ ہے: یہ گفتگو سے منسلک منظوری کی ایک پائیدار درخواست کھولتا ہے اور pending واپس کرتا ہے — اسپیس پلان موڈ ہی میں رہتی ہے اور ایجنٹ کو کوئی اقدام نہیں کرنا چاہیے۔ درخواست منظور ہونے کے بعد ایجنٹ کی اگلی exit_plan_mode کال اسپیس کو پلان سے ایجنٹ موڈ میں منتقل کرتی ہے اور اس کے تبدیلی کرنے والے ٹولز کھول دیتی ہے۔ مسترد ہونے پر ایجنٹ ترمیم شدہ پلان کے خلاف ایک نئی درخواست کھول سکتا ہے۔

پلان موڈ سے نکلنے کے لیے کمپوزر کا ڈراپ ڈاؤن بدلیں (یا Shift+Tab)، یا جمع کرایا گیا پلان منظور کریں۔ exit_plan_mode ایک پائیدار منظوری کھولتا ہے جس کا فیصلہ decide_approval MCP ٹول سے ہوتا ہے۔ بلاک شدہ ٹول کالز کے لیے گارڈریل اوورلے ایک الگ، اِن-میموری قطار ہے اور پلان سے نکلنے کی درخواستیں نہیں لے جاتا۔

پائپ لائن قدم میں پلان موڈ

messaging.createSpace پائپ لائن نوڈ گفتگو کا موڈ نوڈ کنفیگ کے mode extra سے پڑھتا ہے — extras['mode']: 'plan'۔ یہ کلید عین مطابق ہونی چاہیے: کوئی بھی دوسری ہجے، بشمول conversationMode یا dispatchMode، خاموشی سے نظر انداز ہو جاتی ہے اور کمرے کو باڈی کا ڈیفالٹ ملتا ہے، جو ریویو موڈ ہے، چیٹ نہیں۔ promptAgent مرحلہ ایسے کمرے میں شامل ہوتا ہے جو اُس نے نہیں بنایا اور اُس کی اجازتیں دوبارہ مقرر نہیں کرتا۔ نوڈ کنفیگ ایڈیٹر کا ڈسپیچ موڈ سلیکٹ (allParallel / manager) ٹیم ڈسپیچ نوڈز کے لیے ہے۔ گفتگو کا موڈ extras['mode'] سے اُس ٹیمپلیٹ پر سیٹ کریں جو اسپیس کھولتا ہو، یا API کے ذریعے اُس نوڈ کی کنفیگ پر۔