من المصدر
الفكرة التي تستحق البناء عليها — وحدودها
يعرض كول ميدن في الفيديو تصورًا لـ«مصنع برمجيات مظلم»: تبدأ المنظومة من مقصد أعلى، ثم تمرر العمل عبر المستودع ومسارات التشغيل والبناء والتحقق والنشر. قوة الاستعارة أنها تنقل النقاش من جودة المحادثة إلى جودة خط العمل.
لكن صاحب الفكرة نفسه يقدمها كنظام تجريبي ونقطة بداية، لا كنظام موثوق لكل الأعمال. ويشير إلى أن الإبقاء على الإنسان في التخطيط والتحقق قد يكون أنسب حين تكون الموثوقية أولوية. لذلك نتعامل مع الفيديو كمصدر لأفكار تصميم، لا كبرهان أداء.
السؤال الذي تبني عليه طرف هذا الدليل ليس: كيف نزيل الإنسان؟ بل: ما أقل نظام يجعل مهمة واحدة أوضح، وأسهل في الفحص، وأقل ضررًا عند الخطأ؟
المراجع [1]
قرار طرف
قاعدة الاستقلالية المحدودة
تقترح طرف
أربعة أوضاع للمهمة، لا شارة نضج للمؤسسة
| المعيار | مساعد | بنّاء مراقبموصى به | منفذ محدود | تشغيل مشروط |
|---|---|---|---|---|
| دور الوكيل | يقترح ولا يغيّر الملفات | ينفذ خطة يراجعها الإنسان | ينفذ مهمة صغيرة ضمن ميزانية وحدود | يخطط ويبني ويتحقق ضمن شروط مسبقة |
| موضع الإنسان | يقرر ويكتب | يعتمد الخطة والنتيجة | يحدد الحدود ويراجع الاستثناء | يمتلك بوابة النشر والقرارات الحساسة |
| الاستخدام الأنسب | قرار غامض أو عالي الحساسية | الاختيار الافتراضي عند بدء المسار | عمل متكرر منخفض المخاطر | عمل ثبتت بواباته وأدلة قبوله |
تقترح طرف
دورة العمل التي تقترحها طرف
النية
ما النتيجة التي يحتاجها المستخدم أو العمل؟
المخرج: نتيجة محددة
السياق
ما الحقائق والقيود والقرارات التي يحتاجها المنفذ لهذه المهمة؟
المخرج: سياق موجّه
المواصفة
ما السلوك المقبول، وحالات الفشل، وما الذي يبقى خارج النطاق؟
المخرج: عقد قبول
الخطة
ما الملفات والعقود وترتيب التنفيذ وأدلة التحقق؟
المخرج: خطوات قابلة للمراجعة
التنفيذ
أصغر تغيير يحقق المواصفة من دون توسيع الصلاحيات.
المخرج: أثر معزول
التحقق
اختبارات وبناء وفحص واجهة وسلوك لا تعتمد على تقرير البنّاء وحده.
المخرج: أدلة مستقلة
التعلم
احتفظ فقط بقرار أو درس ثبت أنه سيغير مهمة لاحقة.
المخرج: ذاكرة تشغيل
إعادة بناء طرف
خريطة النظام: المعرفة والصلاحيات والأدلة
العلاقات في الخريطة نصيًا
- نية واضحة تحدد المطلوب سياق وحدود
- سياق وحدود تقيد التنفيذ البنّاء
- البنّاء ينشئ نسخة معزولة
- نسخة معزولة يُفحص لدى المتحقق
- بوابة مستقلة تملك معيار المتحقق
- المتحقق ينتج اعتماد أو رفض
- اعتماد أو رفض يثبت الدرس في ذاكرة مثبتة
- ذاكرة مثبتة تغذي لاحقًا سياق وحدود
من المصدر ثم معالجة طرف
مكونات المصدر الخمسة — بترتيب بداية مختلف
يعرض الفيديو خمسة مكونات: مستودعًا تحركه مسارات عمل، وطابور مهام، ونشرًا معزولًا، وطبقة توجيه، وحزام تحقق. وتقترح طرف لفريق صغير أن يبدأ بالتوجيه والتحقق، ثم يضيف العزل، وبعد ثبات المسار فقط يضيف الطابور.
١. التوجيه: اتفاقات المشروع، حدود العمل، ومقصد المنتج
في تقسيم المصدر، تغطي طبقة التوجيه اتفاقات المستودع العامة، وما يجوز للنظام فعله دون مراقبة، وغاية المنتج وما ليس من غاياته. تضيف طرف معيار الحكم بوصفه طبقة مستقلة عند المتحقق، كي لا يخلط البنّاء بين ما يريد تحقيقه ومن يقرر أنه نجح.
٢. مسار العمل: حالة معلومة وانتقال مشروط
المواصفة ليست مطالبة طويلة؛ هي مدخل إلى حالات مثل: مسودة، جاهزة، قيد البناء، قيد التحقق، ثم معتمدة أو مرفوضة. تسجيل الحالة يجعلها قابلة للملاحظة ويهيئ لفصل الأدوار، أما منع وكيل واحد من الجمع بينها فيحتاج هوية وصلاحيات وبوابة اعتماد مستقلة.
٣. حزام التحقق: دليل لا يكتبه طرف واحد
يمكن للبنّاء تشغيل فحص الأنواع والاختبارات المعلنة والبناء المحلي. ويملك مسار تحقق مستقل حالات إضافية، وفحصًا بصريًا، ومسارًا شاملًا يتصرف كمستخدم. الحالات المحجوبة تقلل احتمال التكيف مع الأمثلة المعلنة فقط؛ لكنها ليست ضمانًا منفردًا للصحة.
٤. العزل والتراجع قبل النشر
يستخدم الفيديو النشر الأزرق/الأخضر مثالًا. لا يلزم نسخ التقنية: قد تكفي بيئة معاينة لكل طلب دمج أو حاوية مؤقتة أو نسخة ثابتة. المطلوب أن يرى المراجع التغيير دون كسر النسخة الحالية، وأن يكون الرجوع إجراءً مجربًا.
٥. الطابور يأتي أخيرًا
الطابور يضاعف القدرة والخطأ معًا. لا تضفه قبل أن ينجح المسار يدويًا، وتتضح حالات إعادة المحاولة، وآثارها الجانبية، وسقف التوازي والميزانية. هذه أولوية تطبيق تقترحها طرف، لا ترتيبًا يفرضه الفيديو.
حد تقني
الحماية ليست سطرًا في ملف تعليمات
معالجة عربية من طرف
ما الذي يتغير عندما يكون المنتج عربيًا؟
- عقد ثنائي اللغة عند الحاجة
اكتب النية والقرار بالعربية ليشارك صاحب المنتج، وأبق أسماء الملفات والأوامر والعقود البرمجية بصيغتها الدقيقة. عرّف المصطلح مرة ثم التزم به.
- حالات حكم عربية أصلية
اختبر النص المشكول وغير المشكول، وأشكال الألف والهمزة وفق سياسة المنتج، والنص المختلط، والعناوين الطويلة، والنسخ والبحث وترتيب التركيز وقارئ الشاشة.
- الخصوصية قبل اختيار الأداة
حدد ما يغادر البيئة، ومكان السجلات، ومن يقرأ الأسرار، وما يحق للوكيل قراءته وكتابته ونشره وحذفه. الإجراءات الحساسة أو صعبة الرجوع تبقى تحت موافقة بشرية.
- ابدأ ببنية صغيرة
يمكن أن تبدأ بملفات Markdown واختبارات وGit. لا تحتاج إلى طابور سحابي أو مزود بعينه حتى تثبت أن دورة العمل مفيدة.
مثال افتراضي من طرف
مثال محلي: بوابة خدمة عربية داخلية
لنفترض فريقًا سعوديًا يبني بوابة داخلية تتيح للموظف البحث بالعربية في السياسات المعتمدة. المهمة الأولى منخفضة المخاطر: تحسين مطابقة الكلمات عند اختلاف الهمزات، من دون تغيير صلاحيات الوصول أو مصدر الإجابة.
- يعرّف صاحب المنتج أمثلة بحث عربية مقبولة وحالات يجب ألا تتطابق.
- يكتب البنّاء تنفيذًا صغيرًا واختبارات معلنة داخل فرع معزول.
- يشغّل مسار مستقل حالات لم يرها البنّاء، ويتحقق من بقاء صلاحيات الوثائق كما هي.
- إذا تغيّر عقد الصلاحيات أو انخفضت دقة حالة حساسة، تتوقف المهمة للمراجعة البشرية.
هذا المثال لا يدعي امتثالًا لنظام بعينه؛ قيمته أنه يحول «دعم العربية» من نية عامة إلى سلوك وحدود ودليل قبول.
المادة المرجعية
شاهد المصدر مع خريطة التوقيتات

المراجع [1]
للتطبيق
ابدأ بمهمة واحدة خلال سبع خطوات
اختر مهمة منخفضة المخاطر
يفضل أن تكون متكررة وقابلة للتراجع، لا قرارًا حساسًا أو تغييرًا واسعًا.
المخرج: نطاق صغير
اكتب عقد القبول
كحد بداية تقترحه طرف: نتيجة، ومعياران واضحان للقبول، وحالة فشل واحدة على الأقل؛ وعدّل العدد بحسب الخطر.
المخرج: مواصفة قصيرة
افصل الثابت عن المتغير
ضع سياق المشروع الدائم في ملف، وحدود المهمة في مواصفتها.
المخرج: سياق أنظف
ابدأ بدليل فشل
اكتب اختبارًا يفشل أو فحصًا سلوكيًا يمكن تكراره قبل التنفيذ.
المخرج: خط أساس
راجع الخطة والصلاحيات
تحقق من الملفات المتأثرة، وما لا يحق للوكيل لمسه، وطريق التراجع.
المخرج: حدود معتمدة
نفّذ في مساحة معزولة
استخدم فرعًا أو بيئة معاينة، ولا تنشر مباشرة إلى بيئة يعتمد عليها الناس.
المخرج: نسخة قابلة للفحص
تحقق ثم تعلّم
شغّل دليلًا مستقلًا، وبعد القرار احتفظ فقط بدرس ثبت أنه سيفيد العمل التالي.
المخرج: قرار وذاكرة
قالب قابل للتنزيل
قالب طرف لنظام العمل البرمجي بالذكاء الاصطناعي
قالب عربي مستقل من ٢٨ ملفًا ينظم السياق والمواصفة والخطة والمراجعة والتحقق والذاكرة التطورية. لا يتطلب مفتاح API أو حزمة خارجية، ويتضمن مثال بحث عربي يعمل محليًا.
taraf-ai-coding-system-ar-v1.zipZIPالإصدار 1.0.0٣١ كيلوبايت
حمّل القالب الأساسيتفاصيل الملف ومتطلبات التشغيل
SHA-256: 7769f368d9e2368ef7d28d456f397e0ef33227c8cf0c94d13ad9ef1e83f4c65b
المتطلبات
- Node.js >=20
- Git (اختياري لإدارة النسخ)
يتضمن
- README وAGENTS بالعربية
- قوالب للمواصفة والخطة والقرار والمراجعة والتحقق
- ذاكرة للقرارات والدروس
- مثال بحث عربي واختبارات سلوكية
- رخصة MIT
خلاصة طرف
القرار
دفتر النسبة
المصادر وحدود الاستفادة
- How to Build the Most Powerful System for AI Coding (Full Breakdown)
Cole Medin · تم الاطلاع في
استُخدم لاستخراج أفكار التصميم ووصف عرض صاحبه؛ لم تُعامل الوعود الترويجية أو تجربة الراعي كأدلة أداء.
- coleam00/skills — Agent Skills and Workflows
Cole Medin · GitHub · تم الاطلاع في
مرجع مباشر لمسار العمل المنشور والمهارات النصية؛ لا يثبت وحده موثوقية النظام في الإنتاج.
- coleam00/Archon
Cole Medin · GitHub · تم الاطلاع في
مستودع أداة مرتبطة بسياق المصدر؛ أُدرج للتتبع ولم تُبنَ عليه ادعاءات أداء في هذا الدليل.