/plan-spec

الدور: المِصْهَر الموضع في خط المعالجة: الرأس

يصقل النثر الحرّ أو الملاحظات الخام إلى مواصفة _spec/spec.md بدرجة spec جاهزة لـ /plan-generate.

الاستدعاء المعياري

/plan-spec

مع الوسائط:

/plan-spec [path/to/prose-source] [--suite-name NAME] [--refine-existing] [--standalone] [--quick SLUG [--tag TAG]]

المدخلات

نثر حرّ، أو ملاحظات خام، أو متطلبات مُخصَّصة (يقدّمها المشغّل مضمَّنة أو بوصفها مسارًا).

المخرجات

_spec/spec.md (المواصفة المُرقّاة) + _inputs/handoff-manifest.yml. ويكتب --quick بدلًا من ذلك ملفّ خطة خفيفًا واحدًا محليًّا للمشروع في <project-root>/.apothem/plans/<YYYY-MM-DD>--<kebab-slug>.md.

المراحل اللاحقة

/plan-generate (المستهلِك اللاحق)

مراحل سير العمل

يُجري المِصْهَر ست مراحل تحويل (تُرقّى المواصفة من _inputs/forge.md إلى _spec/spec.md عند G4):

1. الاكتشاف والاستخراج — قراءة النثر / الملاحظات واستخراج كل متطلَّب وقرار وقيد.
2. التدبُّر الدقيق — التفكير عبر كل سطح؛ وعرض كل تناقض عبر قناة الاستفسار المُهيكَل.
3. رسم خريطة الفاعلية — ربط كل متطلَّب بأثره اللاحق.
4. التحقّق من الحفظ — تشغيل بوّابة ما قبل الإصدار ذات الخمسة عشر شريطًا (G4) مقابل المواصفة المُرشَّحة قبل الترقية.
5. تطبيق الخبرة — تطبيق خبرة المجال؛ وتسجيل اكتشافات فجوات الخبرة.
6. مسح حسم الأسئلة — حسم كل استفسار مفتوح عبر البوّابات G0–G5، ثم إصدار _spec/spec.md إضافةً إلى بيان التسليم.

أنماط الفشل

أمثلة

# صهر الملاحظات الخام إلى مواصفة بدرجة spec
/plan-spec ~/notes/feature.md --suite-name my-feature

# ملفّ خطة خفيف محليّ للمشروع (يتجاوز استنباط المِصْهَر)
/plan-spec --quick my-feature

الإحالات المرجعية

• نظرة عامة على خط المعالجة
• مرجع الأوامر