بحث · هندسة البرمجيات والذكاء الاصطناعي

من المحادثة إلى النظام: بيئة برمجة قابلة للمراجعة بالذكاء الاصطناعي

لا تبحث عن مطالبة سحرية. ابنِ عقد عمل يعرف ما المطلوب، وما المسموح، وما الدليل الكافي للقبول.

١٦ دقيقة قراءة

منظومة هندسية مجردة تمرر مهمة برمجية عبر السياق والبناء ثم بوابة تحقق مستقلة.
تصور طرف للاستقلالية المحدودة: التنفيذ يمر عبر بوابة تحقق لا يملك البنّاء تغييرها.

من المصدر

الفكرة التي تستحق البناء عليها — وحدودها

مصدر

يعرض كول ميدن في الفيديو تصورًا لـ«مصنع برمجيات مظلم»: تبدأ المنظومة من مقصد أعلى، ثم تمرر العمل عبر المستودع ومسارات التشغيل والبناء والتحقق والنشر. قوة الاستعارة أنها تنقل النقاش من جودة المحادثة إلى جودة خط العمل.

لكن صاحب الفكرة نفسه يقدمها كنظام تجريبي ونقطة بداية، لا كنظام موثوق لكل الأعمال. ويشير إلى أن الإبقاء على الإنسان في التخطيط والتحقق قد يكون أنسب حين تكون الموثوقية أولوية. لذلك نتعامل مع الفيديو كمصدر لأفكار تصميم، لا كبرهان أداء.

السؤال الذي تبني عليه طرف هذا الدليل ليس: كيف نزيل الإنسان؟ بل: ما أقل نظام يجعل مهمة واحدة أوضح، وأسهل في الفحص، وأقل ضررًا عند الخطأ؟

المراجع [1]

قرار طرف

قاعدة الاستقلالية المحدودة

قرار

تقترح طرف

أربعة أوضاع للمهمة، لا شارة نضج للمؤسسة

تحليل
اختر الوضع بحسب غموض المهمة، وحساسية القرار، وقابلية التراجع. قد يستخدم الفريق أكثر من وضع في المنتج نفسه.
المعيارمساعدبنّاء مراقبموصى بهمنفذ محدودتشغيل مشروط
دور الوكيليقترح ولا يغيّر الملفاتينفذ خطة يراجعها الإنسانينفذ مهمة صغيرة ضمن ميزانية وحدوديخطط ويبني ويتحقق ضمن شروط مسبقة
موضع الإنسانيقرر ويكتبيعتمد الخطة والنتيجةيحدد الحدود ويراجع الاستثناءيمتلك بوابة النشر والقرارات الحساسة
الاستخدام الأنسبقرار غامض أو عالي الحساسيةالاختيار الافتراضي عند بدء المسارعمل متكرر منخفض المخاطرعمل ثبتت بواباته وأدلة قبوله

تقترح طرف

دورة العمل التي تقترحها طرف

تطبيق
  1. النية

    ما النتيجة التي يحتاجها المستخدم أو العمل؟

    المخرج: نتيجة محددة

  2. السياق

    ما الحقائق والقيود والقرارات التي يحتاجها المنفذ لهذه المهمة؟

    المخرج: سياق موجّه

  3. المواصفة

    ما السلوك المقبول، وحالات الفشل، وما الذي يبقى خارج النطاق؟

    المخرج: عقد قبول

  4. الخطة

    ما الملفات والعقود وترتيب التنفيذ وأدلة التحقق؟

    المخرج: خطوات قابلة للمراجعة

  5. التنفيذ

    أصغر تغيير يحقق المواصفة من دون توسيع الصلاحيات.

    المخرج: أثر معزول

  6. التحقق

    اختبارات وبناء وفحص واجهة وسلوك لا تعتمد على تقرير البنّاء وحده.

    المخرج: أدلة مستقلة

  7. التعلم

    احتفظ فقط بقرار أو درس ثبت أنه سيغير مهمة لاحقة.

    المخرج: ذاكرة تشغيل

إعادة بناء طرف

خريطة النظام: المعرفة والصلاحيات والأدلة

تحليل
خريطة النظام: المعرفة والصلاحيات والأدلةتتحول النية إلى تنفيذ داخل حدود، ثم تمر النتيجة إلى متحقق مستقل قبل الاعتماد؛ وتعود الدروس المثبتة فقط إلى سياق المشروع.نية واضحةسياق وحدودالبنّاءنسخة معزولةذاكرة مثبتةبوابة مستقلةالمتحققاعتماد أو رفض
تتحول النية إلى تنفيذ داخل حدود، ثم تمر النتيجة إلى متحقق مستقل قبل الاعتماد؛ وتعود الدروس المثبتة فقط إلى سياق المشروع.
العلاقات في الخريطة نصيًا
  • نية واضحة تحدد المطلوب سياق وحدود
  • سياق وحدود تقيد التنفيذ البنّاء
  • البنّاء ينشئ نسخة معزولة
  • نسخة معزولة يُفحص لدى المتحقق
  • بوابة مستقلة تملك معيار المتحقق
  • المتحقق ينتج اعتماد أو رفض
  • اعتماد أو رفض يثبت الدرس في ذاكرة مثبتة
  • ذاكرة مثبتة تغذي لاحقًا سياق وحدود

من المصدر ثم معالجة طرف

مكونات المصدر الخمسة — بترتيب بداية مختلف

تحليل

يعرض الفيديو خمسة مكونات: مستودعًا تحركه مسارات عمل، وطابور مهام، ونشرًا معزولًا، وطبقة توجيه، وحزام تحقق. وتقترح طرف لفريق صغير أن يبدأ بالتوجيه والتحقق، ثم يضيف العزل، وبعد ثبات المسار فقط يضيف الطابور.

١. التوجيه: اتفاقات المشروع، حدود العمل، ومقصد المنتج

في تقسيم المصدر، تغطي طبقة التوجيه اتفاقات المستودع العامة، وما يجوز للنظام فعله دون مراقبة، وغاية المنتج وما ليس من غاياته. تضيف طرف معيار الحكم بوصفه طبقة مستقلة عند المتحقق، كي لا يخلط البنّاء بين ما يريد تحقيقه ومن يقرر أنه نجح.

٢. مسار العمل: حالة معلومة وانتقال مشروط

المواصفة ليست مطالبة طويلة؛ هي مدخل إلى حالات مثل: مسودة، جاهزة، قيد البناء، قيد التحقق، ثم معتمدة أو مرفوضة. تسجيل الحالة يجعلها قابلة للملاحظة ويهيئ لفصل الأدوار، أما منع وكيل واحد من الجمع بينها فيحتاج هوية وصلاحيات وبوابة اعتماد مستقلة.

٣. حزام التحقق: دليل لا يكتبه طرف واحد

يمكن للبنّاء تشغيل فحص الأنواع والاختبارات المعلنة والبناء المحلي. ويملك مسار تحقق مستقل حالات إضافية، وفحصًا بصريًا، ومسارًا شاملًا يتصرف كمستخدم. الحالات المحجوبة تقلل احتمال التكيف مع الأمثلة المعلنة فقط؛ لكنها ليست ضمانًا منفردًا للصحة.

٤. العزل والتراجع قبل النشر

يستخدم الفيديو النشر الأزرق/الأخضر مثالًا. لا يلزم نسخ التقنية: قد تكفي بيئة معاينة لكل طلب دمج أو حاوية مؤقتة أو نسخة ثابتة. المطلوب أن يرى المراجع التغيير دون كسر النسخة الحالية، وأن يكون الرجوع إجراءً مجربًا.

٥. الطابور يأتي أخيرًا

الطابور يضاعف القدرة والخطأ معًا. لا تضفه قبل أن ينجح المسار يدويًا، وتتضح حالات إعادة المحاولة، وآثارها الجانبية، وسقف التوازي والميزانية. هذه أولوية تطبيق تقترحها طرف، لا ترتيبًا يفرضه الفيديو.

المراجع [1][2]

حد تقني

الحماية ليست سطرًا في ملف تعليمات

قرار

معالجة عربية من طرف

ما الذي يتغير عندما يكون المنتج عربيًا؟

تطبيق
  • عقد ثنائي اللغة عند الحاجة

    اكتب النية والقرار بالعربية ليشارك صاحب المنتج، وأبق أسماء الملفات والأوامر والعقود البرمجية بصيغتها الدقيقة. عرّف المصطلح مرة ثم التزم به.

  • حالات حكم عربية أصلية

    اختبر النص المشكول وغير المشكول، وأشكال الألف والهمزة وفق سياسة المنتج، والنص المختلط، والعناوين الطويلة، والنسخ والبحث وترتيب التركيز وقارئ الشاشة.

  • الخصوصية قبل اختيار الأداة

    حدد ما يغادر البيئة، ومكان السجلات، ومن يقرأ الأسرار، وما يحق للوكيل قراءته وكتابته ونشره وحذفه. الإجراءات الحساسة أو صعبة الرجوع تبقى تحت موافقة بشرية.

  • ابدأ ببنية صغيرة

    يمكن أن تبدأ بملفات Markdown واختبارات وGit. لا تحتاج إلى طابور سحابي أو مزود بعينه حتى تثبت أن دورة العمل مفيدة.

مثال افتراضي من طرف

مثال محلي: بوابة خدمة عربية داخلية

تطبيق

لنفترض فريقًا سعوديًا يبني بوابة داخلية تتيح للموظف البحث بالعربية في السياسات المعتمدة. المهمة الأولى منخفضة المخاطر: تحسين مطابقة الكلمات عند اختلاف الهمزات، من دون تغيير صلاحيات الوصول أو مصدر الإجابة.

  1. يعرّف صاحب المنتج أمثلة بحث عربية مقبولة وحالات يجب ألا تتطابق.
  2. يكتب البنّاء تنفيذًا صغيرًا واختبارات معلنة داخل فرع معزول.
  3. يشغّل مسار مستقل حالات لم يرها البنّاء، ويتحقق من بقاء صلاحيات الوثائق كما هي.
  4. إذا تغيّر عقد الصلاحيات أو انخفضت دقة حالة حساسة، تتوقف المهمة للمراجعة البشرية.

هذا المثال لا يدعي امتثالًا لنظام بعينه؛ قيمته أنه يحول «دعم العربية» من نية عامة إلى سلوك وحدود ودليل قبول.

المادة المرجعية

شاهد المصدر مع خريطة التوقيتات

مصدر
منظومة هندسية مجردة تمرر مهمة برمجية عبر السياق والبناء ثم بوابة تحقق مستقلة.
الفيديو الأصلي متاح عند الطلب حفاظًا على الخصوصية؛ التوقيتات المفصلة موجودة في قسم المصادر. — Cole Medin
شاهد في المصدر

المراجع [1]

للتطبيق

ابدأ بمهمة واحدة خلال سبع خطوات

تطبيق
  1. اختر مهمة منخفضة المخاطر

    يفضل أن تكون متكررة وقابلة للتراجع، لا قرارًا حساسًا أو تغييرًا واسعًا.

    المخرج: نطاق صغير

  2. اكتب عقد القبول

    كحد بداية تقترحه طرف: نتيجة، ومعياران واضحان للقبول، وحالة فشل واحدة على الأقل؛ وعدّل العدد بحسب الخطر.

    المخرج: مواصفة قصيرة

  3. افصل الثابت عن المتغير

    ضع سياق المشروع الدائم في ملف، وحدود المهمة في مواصفتها.

    المخرج: سياق أنظف

  4. ابدأ بدليل فشل

    اكتب اختبارًا يفشل أو فحصًا سلوكيًا يمكن تكراره قبل التنفيذ.

    المخرج: خط أساس

  5. راجع الخطة والصلاحيات

    تحقق من الملفات المتأثرة، وما لا يحق للوكيل لمسه، وطريق التراجع.

    المخرج: حدود معتمدة

  6. نفّذ في مساحة معزولة

    استخدم فرعًا أو بيئة معاينة، ولا تنشر مباشرة إلى بيئة يعتمد عليها الناس.

    المخرج: نسخة قابلة للفحص

  7. تحقق ثم تعلّم

    شغّل دليلًا مستقلًا، وبعد القرار احتفظ فقط بدرس ثبت أنه سيفيد العمل التالي.

    المخرج: قرار وذاكرة

قالب قابل للتنزيل

قالب طرف لنظام العمل البرمجي بالذكاء الاصطناعي

تطبيق

قالب عربي مستقل من ٢٨ ملفًا ينظم السياق والمواصفة والخطة والمراجعة والتحقق والذاكرة التطورية. لا يتطلب مفتاح API أو حزمة خارجية، ويتضمن مثال بحث عربي يعمل محليًا.

taraf-ai-coding-system-ar-v1.zipZIPالإصدار 1.0.0٣١ كيلوبايت

حمّل القالب الأساسي
تفاصيل الملف ومتطلبات التشغيل

SHA-256: 7769f368d9e2368ef7d28d456f397e0ef33227c8cf0c94d13ad9ef1e83f4c65b

المتطلبات

  • Node.js >=20
  • Git (اختياري لإدارة النسخ)

يتضمن

  • README وAGENTS بالعربية
  • قوالب للمواصفة والخطة والقرار والمراجعة والتحقق
  • ذاكرة للقرارات والدروس
  • مثال بحث عربي واختبارات سلوكية
  • رخصة MIT

خلاصة طرف

القرار

قرار

دفتر النسبة

المصادر وحدود الاستفادة

مصدر
  1. How to Build the Most Powerful System for AI Coding (Full Breakdown)

    Cole Medin · تم الاطلاع في

    استُخدم لاستخراج أفكار التصميم ووصف عرض صاحبه؛ لم تُعامل الوعود الترويجية أو تجربة الراعي كأدلة أداء.

  2. coleam00/skills — Agent Skills and Workflows

    Cole Medin · GitHub · تم الاطلاع في

    مرجع مباشر لمسار العمل المنشور والمهارات النصية؛ لا يثبت وحده موثوقية النظام في الإنتاج.

  3. coleam00/Archon

    Cole Medin · GitHub · تم الاطلاع في

    مستودع أداة مرتبطة بسياق المصدر؛ أُدرج للتتبع ولم تُبنَ عليه ادعاءات أداء في هذا الدليل.