شنو كيدير Forward Implementation First فالأول
Forward Implementation First هي مهارة ديال الوكلاء مصمّمة باش تمنع وكلاء البرمجة من التعلّق فتدبير معلومات الـ pipeline. كتحافظ على التركيز فبناء المنتج المطلوب، والتحقق من السلوك المتأثر، والتقدّم للقدّام بلا ما يبقاو يصلحو بشكل متكرر الهاشات، والوصولات، والأقفال، واللوحات، ولا مؤشرات التقدّم.
المشروع كيتكوّن بالأساس من ملف Markdown فيه تقريباً 150 سطر ومعاه YAML frontmatter. كيتبع اتفاقية Agent Skills، وما مرتبط لا بنموذج معيّن، لا بأداة معيّنة، لا بمجال معيّن.
هاد المهارة مفيدة خصوصاً فـ workflows اللي كيطولو، فين المنسّق كيسجّل metadata ديال المراحل المرتّبة. ملي كتولي هاد الـ metadata قديمة، يقدر الوكيل يفسّر الاختلاف على أنه دليل بأن المخرجات اللي كانت صحيحة من قبل ولات غالطة. Forward Implementation First كتقدّم قاعدة لاتخاذ القرار كتفرّق بين الخدمة الحقيقية ديال ضمان الصحة والصيانة الإدارية.
التصنيف الأساسي
قبل ما يدير شي إجراء، الوكيل كيصنّفو فواحد من ثلاثة ديال الفئات.
- التنفيذ الدلالي: الخدمة اللي كاتبني ولا كاتربط producer، consumer، adapter، مسار runtime، schema، fixture، ولا مخرج نهائي.
- التحقق المركّز: اختبارات كاتفحص مخروط الاعتماديات المتبدّل من خلال السلوك، والـ schema، والأعداد، وعينات مرتّبة، والحفاظ على الكمية، والاتساق، وعدم الاقتطاع، والوقت ولا الذاكرة المقاسة.
- التدبير الإداري: الخدمة اللي كاتولّد ولا كاتصلّح الهاشات، والأقفال، والوصولات، واللوحات، وعلامات الاعتماد، وmetadata ديال التقدّم، ولا سجلات كتثبت غير الحضور.
القاعدة التشغيلية بسيطة: دير التنفيذ الدلالي والتحقق المركّز. تخطّى التدبير الإداري إلا طلبو المستخدم بصراحة ولا كان داك الأثر جزء من المنتج. إلا كان dependency إداري بوحدو كايعرقل الخدمة المفيدة بلا ما كيحمي الصحة، حيد داك dependency.
علاش كيولي تدبير الـ Pipeline مشكل
تصوّر pipeline اللي فيه stage 40 كاينشئ ملف لـ stage 41. المنسّق كايكتب حتى هو record بصيغة JSON فيه علامة الإكمال وهاش ديال الإدخال. إلا تبدّل producer، يقدر الهاش مايبقاش مطابق حتى إلا بقات المخرجات الموجودة ديال المرحلة صحيحة.
بلا سياسة واضحة، يقدر الوكيل يبطل بزاف ديال المراحل السابقة، ويرفض يشغّل stage 41 يدوياً، ويعاود يولّد علامات ماعندهاش علاقة، ويقدّم metadata المصلحة على أنها تقدّم. كل اختيار محلي يقدر يبان حذر، ولكن النتيجة المجمّعة كاتستهلك الوقت بلا ما تحسّن المخرج المطلوب.
الـ metadata الإدارية ماشي بديل على الدليل بأن المخرج صحيح.
المهارة كاتمنع هاد الفشل بفرض التحقق من العواقب، عوض اعتبار وجود metadata ولا حداثتها دليلاً.
شنو ماكاترخّصش فيه المهارة
Forward Implementation First ماشي دعوة لتجاهل الصحة. كاتفرّق بين سجلات التنسيق اللي يمكن الاستغناء عليها، وبين آليات النزاهة والأدلة اللي كاتحمي المنتج فعلاً.
- نزاهة المنتج كتبقى ضرورية. الـ checksums اللي كايتحقق منها المستخدمون، والتوقيعات المفروضة، والهاشات المعرّفة فـ output contract، راه ميزات ديال المنتج وماشي غير ورقيات.
- هوية الإدخال والمراجعة كتبقى ضرورية. خاص الوكيل يعرف أشمن نسخة ولا هدف كايعدّل.
- الاختبارات الموجّهة بالنتائج كتبقى ضرورية. الـ benchmarks، وإعادات الإنتاج، والاختبارات، والتشغيلات من البداية للنهاية، مازال كايقدّمو أدلة أساسية.
- التغطية ماشي هي العاقبة. تشغيل مسار ماكايبرهنش بأن داك المسار عطى الجواب الصحيح.
سجل تنفيذ فيه الأمر، والإدخال، والنتيجة، والتوقّع اللي تدار عليه التحقق، يقدر يكون دليلاً حقيقياً. إلا ماكانش، مايمكنش للوكيل يدير الادعاء اللي كان غادي يدعمو داك السجل. ولكن الغياب ديالو ماكايبطلش أوتوماتيكياً المراحل الأخرى اللي ماعندهاش علاقة وسبق منها فـ pipeline.
التثبيت
التثبيت فمجلدات Agent Skill اللي تكتاشفات
دير clone للمستودع وشغّل script ديال التثبيت اللي داخل فيه:
git clone https://github.com/Vuk97/forward-implementation-first
cd forward-implementation-first
./install.shالـ script كاينسخ SKILL.md لكل مجلد مدعوم ديال agent skill كايتكتاشف. الوجهات الموثّقة هي:
- Claude Code:
~/.claude/skills/forward-implementation-first/ - Codex:
~/.codex/skills/forward-implementation-first/ - الاتفاقية المشتركة:
~/.agents/skills/forward-implementation-first/
التثبيت لمشروع واحد
إلى بغيتي السلوك يكون محدود فمشروع معيّن، نسخ مجلد المهارة داخل .claude/skills/ ولا .agents/skills/ فالمستودع. بهاد الطريقة كتبقى السياسة مرتبطة بداك المشروع عوض ما تتثبّت لكل workspace.
عاود شغّل الوكيل من بعد التثبيت. الجلسات اللي مفتوحة ماكاتعاودش تحميل المهارات أوتوماتيكياً.
المهارة غير اقتراح، والنموذج هو اللي كيقرّر واش يحمّلها. إلا كان الوكيل ديالك كايدعم قواعد ديما خدامة ولا hooks، حط قاعدة القرار الأساسية تما حتى هي.
الاستعمال الأساسي
الخطوة 1: حدّد الإجراء الجاي اللي عندو علاقة بالمنتج
بدا من cursor الحالي ديال الـ pipeline ولا من أول dependency ماكملاش. سول واش الإجراء المقترح غايبدّل التنفيذ، ولا غايتحقق من عاقبة تبدلات، ولا غير غايصلّح metadata ديال التنسيق.
الإجراء المقترح: ربط stage 41 بالمخرج اللي نتج من stage 40.
التصنيف: تنفيذ دلالي.
القرار: نفّذ الإجراء.الخطوة 2: تحقّق من مخروط الاعتماديات المتبدّل
من بعد التنفيذ، اختبر أصغر منطقة اللي ممكن تكون تأثّرات. الفحوصات المناسبة تقدر تشمل المخططات، وعدد الصفوف ولا العناصر، وعينات مرتّبة، وخصائص الحفاظ، والاتساق، وكشف الاقتطاع، والسلوك من البداية للنهاية، وقياس استعمال الموارد.
الإجراء المقترح: تحقّق من مخطط المرحلة 41، وعدد المخرجات، والعينات المرتّبة،
ومن عدم الاقتطاع من بعد تغيير المنتج ديالها.
التصنيف: تحقّق مركّز.
القرار: دير الفحوصات وسجّل الدليل.الخطوة 3: رفض مسك الدفاتر كهدف افتراضي
إلى كان الإجراء المقترح الوحيد هو إعادة توليد وصل قديم ولا علامة إكمال، تخطّاه إلا إلى طلب المستخدم داك الأثر ولا كان هو بحد ذاتو جزء من التسليم.
الإجراء المقترح: عاود بنِ وصولات الإكمال للمراحل 12 حتى 40 اللي ما تبدلاتش.
التصنيف: مسك دفاتر إداري.
القرار: تخطّاه إلا كان مطلوب بصراحة ولا ضروري فالمنتج.الخطوة 4: حيد الحواجز الإدارية فقط
إلى كانت علامة قديمة كاتمنع المرحلة الصحيحة الموالية من الخدمة، ولكن ما كاتحميش الصحة ديال النتائج، شغّل المرحلة يدويًا، وتحقّق من المخرج ديالها، ونشرو، وكمل من المؤشر. من بعد حيد الاعتماد الإداري فقط باش ما تعاودش نفس العرقلة.
طبّق قاعدة المؤشر المتقدّم
المرحلة اللي سالات خاصها تعاود تخدم ولا ترجع للور غير إلا كان سبب جوهري. المهارة كاتعترف بهاد الأسباب:
- المعنى ديال مدخلات المرحلة تبدّل.
- النسخة المستهدفة ولا المثبّتة تبدّلات.
- المخرج مشوّه، مقتطع، ما كيحافظش على المعطيات، غير متّسق، ولا ما متوافقش مع المستهلك ديالو.
- تنفيذ تمت ملاحظتو كايدحض نتيجة سابقة ثابتة.
- مخروط الاعتماد المصرّح به ديال المنتج اللي تبدّل كايشمل المرحلة.
الميتاداتا الناقصة ولا القديمة ما كافياش بوحدها. عاود خدم أصغر مخروط اعتماد متأثر، وما تعاودش التاريخ كامل من البداية.
مثال على قرار الاسترجاع
الملاحظة: هاش الوصل ديال المرحلة 40 قديم.
فحص المخرج: الأثر ديال المرحلة 40 سليم ومتوافق مع المرحلة 41.
فحص الاعتماد: المنتج اللي تبدّل ما كيأثرش على دلالات المرحلة 40.
الإجراء: ما تعاودش المرحلة 40. كمل للمرحلة 41 وتحقّق من النتيجة ديالها.إلى لقا التحقّق بدل ذلك مخرجًا مشوّهًا ولا غير متوافق، كتكون الإعادة مبرّرة حيث السبب دلالي وماشي إداري.
استعمل مجموعات العمّال بلا ما تخلق حقائق متنافسة
المهارة كاتحدّد حتى طريقة منضبطة للخدمة المتوازية.
- شغّل غير عملية ثقيلة وحدة فكل مرة، بحال المصرّف، أو مجموعة الاختبارات كاملة، أو مهمة معطيات كبيرة، أو اختبار أداء، أو فحص طويل.
- استعمل المسارات المتوازية للأعمال الخفيفة فالملفات اللي ما كتتداخلش.
- ملي كيكون مسموح بمجمّع فيه
Nعمّال، عمّر المسارات من جديد ملي كيساليو، وما تستناش حتى تسالي الموجة كاملة. - ما تخترعش مهام قليلة القيمة غير باش يبقى كل عامل خدام.
- خلي التنفيذ الثقيل، والنشر، وتحريك المؤشر، والاستنتاجات النهائية فالمسار الرئيسي.
- خلي العمّال المتوازيين يوجدو ويفحصو، ولكن تحقّق من المخرجات ديالهم قبل ما تستعملها.
- ما توقفش التقدّم للقدّام وانت كتستنى كل المسارات. استعمل نتيجة أي مسار ملي يوصل الدور للاعتماد ديالها.
هاد البنية كاتسمح بالتوازي المفيد بلا ما تخلي عدة عمّال يولو مصادر متنافسة للحقيقة.
نصائح متقدّمة
نقّل قاعدة القرار للإعدادات اللي خدامة ديما
حيت النموذج يقدر يختار ما يحمّلش مهارة، فالبيئات اللي فيها قواعد ولا خطافات دائمة خاصها تعاود السياسة المركزية تما: صنّف كل إجراء، دير التنفيذ والتحقّق المركّز، وتفادى الأعمال الإدارية إلا كانت مطلوبة ولا مرتبطة بالمنتج.
حدّد سلامة المنتج بوضوح
وثّق شنو هما الهاشات، والتوقيعات، والبيانات الوصفية، ولا سجلات التدقيق اللي داخلة فالعقد ديال المخرج. هاد الشي كيمنع العامل من أنه يحيد بالخطأ ميزات حقيقية، وكيخليه فالنفس الوقت يتجاهل علامات التنسيق اللي يمكن التخلص منها.
صرّح بمخاريط الاعتماد
ملي يكون ممكن، خلّي العلاقات بين المنتج والمستهلك واضحة. مخروط اعتماد واضح كايساعد العامل يعاود غير المراحل المتأثرة، وكايتفادى إبطال واسع مبني على عدم اليقين.
سجّل الدليل، ماشي غير الحضور
فضّل السجلات اللي كاتحدّد الأمر، والمدخل، والنتيجة، والشرط المتوقع. العلامة اللي كاتثبت الحضور فقط كاتقول بلي شي حاجة تخدمات؛ أما السجل اللي فيه الدليل كايساعد يبيّن واش خدمات مزيان.
فرّق بين التحضير والصلاحية
استعمل العمّال المتوازيين لفحص الملفات، أو تحضير الرقع، أو جمع المعلومات، ولكن خلّي صلاحية التنفيذ والاستنتاجات للمسار الرئيسي. تحقّق من مخرجات العمّال قبل الدمج ولا النشر.
إمتى تستعمل المهارة
التنفيذ إلى القدّام أولًا مناسب لـ:
- الخطوط اللي فيها مراحل مرتّبة ومؤشر محفوظ.
- الآثار المولّدة اللي كاتستعملها مراحل من بعد.
- سيرورات العمل اللي فيها بيانات وصفية، أو ملفات قفل، أو وصولات مولّدها المنسّق.
- التنفيذات اللي كاتكمل بلا مراقبة بشرية مستمرة.
- المستودعات اللي كايتعاملو معاها عدة عمّال ولا جلسات.
- خطوط ETL، ومعالجة المعطيات على مراحل، وترحيلات كبيرة للكود، وسيرورات البناء والإصدار، وتوليد التوثيق، والتحليل الدفعي، وخطط العمل اللي كاتمتد لعدة أيام.
تخطّاه فالمهام اللي كتدار مرة وحدة، والجلسات التفاعلية القصيرة، ولا سيرورات العمل اللي كيكون فيها مسار التدقيق هو راسو التسليم. إلا كان متوقّع من المستخدمين ولا المراجعين يستهلكو الوصولات، فهاد السجلات كتكون جزء من المنتج وماشي عبء إداري.
الخلاصة
Forward Implementation First كيعطي لوكلاء البرمجة واحد المنهج ضيّق ولكن عملي: بنّي المنتوج، تأكّد من السلوك اللي تّأثر، وما تخلّطش بين ورق البروسيس وصحّة الخدمة. قاعدة المؤشّر لقدّام كتحدّ من إعادة التشغيل اللي ما عندهاش لازمة، والتوجيهات ديال مجموعة العمّال كتعاون على التوازي الآمن. ركّب المهارة، عاود شغّل الوكيل، وقوّي قاعدة القرار ديالو بالإعدادات اللي ديما شاعلة ملي كتكون متاحة.