Forge إضافة لـ Claude Code تقسّم عمل المشروع إلى اثنتي عشرة مرحلة، من كتابة المتطلبات إلى الإصدار، ولا تنقلك إلى مرحلة قبل أن تجتاز شروط التي قبلها. يأخذ كل متطلب رقمًا مثل REQ-001 يُتتبَّع حتى الكود والاختبار، وتُحفظ حالة المشروع في pipeline/state.md فتبدأ كل جلسة جديدة من حيث توقفت. وفي الحزمة نسخة منقولة إلى OpenCode.
اثنتا عشرة مرحلة، لكل منها أمر ومخرجات
تبدأ بـ /forge:forge-srs لوثيقة المتطلبات، ثم /forge:forge-product لوثيقة المنتج ومسارات المستخدم، و/forge:forge-arch للمعمارية وسجل القرارات. تليها المواصفات والتخطيط والتنفيذ والتقييم والنشر والمراقبة والملاحظات والإصلاح، وتنتهي بـ /forge:forge-release لسجل التغييرات وملاحظات الإصدار. كتبتُ الأوامر بأسماء المهارات في ملفاتها، ويختصرها README الأصلي إلى صيغة مثل /forge:srs. وحين تقول إن المرحلة انتهت يفحص خطاف Stop شروطها، فإن بقي شرط مانع عرضه عليك وأبقى المشروع مكانه.
ما في الحزمة (الإصدار 0.8.0)
قرأتُ ملفات الحزمة عند تغليفها، وفيها 27 تعريف وكيل و45 مهارة تُستدعى أوامرَ تبدأ بـ /forge:، وملف إعداد يربط ثمانية أحداث في Claude Code بسكربتات Python. أبرز المهارات:
- forge-adopt: يستنتج مسودة متطلبات ومعمارية من مشروع فيه كود قائم.
- forge-status وforge-resume: يعرضان المرحلة والعوائق والخطوة التالية.
- forge-why: يشرح سبب فشل شرط بعينه، فقد يكون إصلاحه أسرع من تجاوزه.
- forge-force-advance: يتجاوز الشرط بطلبك الصريح، ويحفظ سببك درسًا يظهر في المراجعة الختامية.
- forge-review: يراجع التعديل في الصحة والأمان والأداء والأعراف، ويجمع ذلك في تقرير مرتب بالخطورة.
- forge-trace-matrix: يكشف المتطلبات التي لم تذكرها أي مرحلة لاحقة، والأرقام المكررة.
- forge-autopilot: يشغّل المراحل تباعًا ولا يتقدم إلا عند اجتياز الشرط.
- forge-uninstall: يعرض ما سيحذفه من ملفات Forge قبل حذفه.
والوكلاء شخصيات تتولى المراحل، مثل requirements-analyst وsystem-architect وrelease-manager. وتُحفظ الدروس في .forge/lessons.yaml ويُرفع المتكرر منها إلى ~/.forge ليظهر في مشاريعك الأخرى، وإذا تكرر سير عمل ناجح اقترحت الإضافة تحويله إلى مهارة تقبلها أو ترفضها.
مثال: مشروع جديد من أول أمر
كما تصفه ملفات المهارات، تكتب /forge:forge-init --dry-run فتظهر قائمة الملفات التي ستُنشأ دون كتابة شيء، ثم /forge:forge-init فيكتشف نوع المشروع، مثل api أو cli، وينشئ المجلدات من 01-srs إلى 12-release وملف state.md، ويسألك قبل إضافة .forge/ إلى .gitignore. بعدها يطرح /forge:forge-srs أسئلة التوضيح دفعة واحدة، ويكتب pipeline/01-srs/srs.md بمتطلبات مرقّمة ومعايير قبول.
التشغيل على جهازك
- يلزمك Claude Code 2.1.0 أو أحدث، وPython 3.11 أو أحدث يعمل بالأمر python3، ومكتبتا PyYAML وPydantic 2، وبدون PyYAML تتوقف الخطافات وتطبع طريقة الإصلاح.
- فك الضغط في مجلد ثابت، ومن مجلد مشروعك شغّل
claude --plugin-dir "PATH/TO/EXTRACTED/plugin"بمسارك الفعلي. هذا تحميل للجلسة الحالية، والتثبيت الدائم في README الأصلي. - ابدأ بـ
/forge:forge-init، وإن لم تعمل الخطافات فشغّل/forge:forge-doctor. - أرفقتُ دليلًا عربيًا بهذه الخطوات، وفهرسًا بمسار كل وكيل ومهارة.
قبل أن تعتمد عليها
- لا تعمل في Claude على الويب، فخطافاتها تُشغَّل على جهازك.
- بعض المهام تفتح جلسات
claude -pإضافية تُحسب من استهلاكك: المراجعة بـ/forge:forge-review، ووضع الخلفية في الطيار الآلي، والمراقبة بـ/forge:watch، واقتراح المهارات بعد الجلسات. وتخضع كلها لسقف إنفاق يومي افتراضيه نصف دولار تغيّره من.forge/config.yaml. - مرحلة النشر تنفّذ خطواته فعلًا بعد تأكيدك للخطوات الخطرة، وقد تحتاج Docker وgh.
- تعليمات الوكلاء والمهارات بالإنجليزية.
الترخيص: MIT. ألّفها Saddam ونشرها في forge-plugins، وأرفقتُ ملفاتها دون تعديل.
