التخطيط والمهمة في نافين: /blueprint و/forge و/cruise ودفتر أصلي

خطّط دون تنفيذ، ونفّذ دون فقدان الخيط، واستأنف مهمة بعد توقف: هذا ثالوث /blueprint → /forge → /cruise / /mission. نافين لا يخترع todo في الدردشة: يحتفظ بـ Task Ledger وProgress Ledger أصليين على اللوحة.

مستوحى من حلقات Magentic-One / Deep Agents، ومُنفَّذ بلا LangGraph أو حزمة خارجية - على لوحة نافين وAgentLoop.

المستويات الأربعة

أوضاع الواجهة plan / agent. الأدوات: board وspawn وverify وtest_run وملفات وshell وMCP…

البروتوكول في كل خطوة

على /forge و/cruise و/mission:

1. اقرأ الدفتر (ledger_get) + board next.
2. اختر خطوة ready (أو spawn لخطوات مستقلة).
3. اعمل بالأدوات.
4. تحقق حسب validation (test / lint / verify / manual / none).
5. اكتب ledger_progress مع دليل.
6. قرّر: next | retry | ledger_replan | ledger_pause.
7. لا done بلا دليل عندما يطلب التحقق ذلك.

إن حجب missing_info التقدم → توقف واسأل الإنسان. لا تختلق حقائق.

ما يُحفظ

.navin/board/mission.json بجانب اللوحة:

• Task Ledger: goal وstatus وversion وconstraints وfacts وmissing_info وacceptance_criteria وsteps[] وhistory[]
• Progress Ledger: current_step_id وevidence وstall_count وloop_detected وreplan_needed والميزانيات وnext_actor

مهام اللوحة تحمل acceptance وvalidation وretry_count وagent وevidence. يُرفض done مع validation في test|lint|verify بلا evidence.

توقف واستئناف وتعديل بشري

• ledger_pause / ledger_resume
• تعديل بشري عبر ledger_update يرفع الإصدار ويضيف history (actor=human)
• لوحة الخطة: الهدف وvN وشارة التعثر وسبب آخر تغيير وزر Build بعد /blueprint

وكلاء فرعيون

تكليفات spawn تنسخ acceptance + validation. الدمج عند الأصل قبل done / ledger_progress.

أمثلة

/blueprint أضف GitHub OAuth دون كسر Google Auth
# راجع لوحة الخطة → Build

/forge نفّذ الخطة المعتمدة

/cruise سلّم الوضع الداكن مع اختبارات

/mission انقل المصادقة إلى Supabase عبر الـ monorepo

Plan/Mission + استقلالية اللوحة

بعد اعتماد الخطة، استقلالية اللوحة تسلسل الجاهز: فرع معزول وPR ومزامنة قضايا. الدفتر يقرر ماذا؛ الاستقلالية تقرر كيف يُسلَّم في git.

انظر أيضا: لوحة خبيرة.

الأسئلة الشائعة

هل يلمس /blueprint الكود؟

لا. تصميم فقط. الكود يبدأ مع Build / /forge.

الفرق بين /cruise و/mission؟

/cruise: طيار تسليم. /mission: هدف طويل ونقاط تحقق واستئناف متعدد الجلسات وتقرير نهائي.

من يعيد التخطيط؟

إعادة تخطيط محلية أولا (ledger_replan). توقف عند الميزانية / الإنسان / معلومة ناقصة.

حمّل نافين · الميزات · وثائق Plan Mode

قراءات

• مهام خبيرة → لوحة خبيرة
• استقلالية git → لوحة مستقلة
• أوضاع الملحن → وحدة الكود
• ذاكرة المشروع → Project Brain

الخلاصة

Plan/Mission هو الفرق بين وكيل «يبرمج قليلا» ومنسّق يخطّط ويثبت ويعيد التخطيط ويستأنف - كفريق جاد.