جولةٌ إرشادية في الخطّة

يَعبُر هذا المثال خط أنابيب /plan الكامل لمهمّةٍ بسيطة: إضافة أمرٍ فرعي جديد لواجهة سطر الأوامر إلى Apothem.

الخطوة 1: اكتب متطلّبات النثر

أنشِئ prose.md:

Add a `apothem status` subcommand that prints the current apothem
version, installed harnesses, and the result of `apothem verify`.
The output should be machine-parseable (JSON with --json flag) and
human-readable by default.

الخطوة 2: نقِّح إلى مواصفة

/plan-spec prose.md --suite-name apothem-status-command

يُشغِّل هذا Forge ذا الأطوار الستّة، ويطرح أسئلة استيضاح، ويُنتِج plans/apothem-status-command/_spec/spec.md.

الخطوة 3: ولِّد الخطّة

/plan-generate

يُنتِج PREAMBLE.md وMASTER-PLAN.md وPROGRESS.md وPLAN-NOTES.md وملفّات PHASE.md لكلّ طور تحت plans/apothem-status-command/phases/.

الخطوة 4: راجِع الخطّة

/plan-review

تدقيقٌ جنائي بدرجات الوفاء للنثر والاتّساق والجودة. أصلِح أيّ نتيجة FAIL قبل المتابعة.

الخطوة 5: نفِّذ الأطوار

/plan-execute    # executes the first phase, then pauses
/plan-execute    # executes the next phase, then pauses
...

الخطوة 6: تحقّق من التقدُّم

/plan-status

يُبلِّغ عن الطور الحالي، والمُخرَجات المُتحقَّق منها، والإجراء التالي.