كيف يعمل RADAR.

01 الحلقة

حلقة واحدة لكل مهمة.

تمرّ كل مهمة بالحلقة نفسها، ولا تُنفَّذ أي خطوة إلا إذا نجحت الخطوة التي قبلها.

الفتح

تُفتح المهمة بهدفها وبأمر قبول قابل لإعادة التشغيل. يُفحص الأمر عند فتح المهمة دون تشغيله: المعيار الذي لا يمكن تشغيله كما كُتب يُرفض حينها، ولا يُكتشف في النهاية.

الحجز

يحمل المهمة مالك واحد في كل مرة، عبر lease وfence token. وأي كتابة من مالك انتهت صلاحيته تُرفض.

العمل

يعمل الوكيل في git worktree خاص به، على فرعه الخاص.

الادعاء

يُسجَّل تقرير الوكيل بأنه انتهى على أنه ادعاء. والادعاء لا يُغلق المهمة.

التحقق

يشغّل RADAR أمر القبول بنفسه، على المراجعة الحالية من العمل. يُقرأ تقرير الوكيل نفسه، لكنه ليس برهانًا.

الإغلاق أو إعادة الفتح

النجاح يسمح بإغلاق المهمة، ويُحفظ سجل التحقق برهانًا عليها. والفشل يعيد فتح المهمة مع إرفاق الفشل بها.

الحدود

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

02 السجل

سجل واحد يكتب فيه كل وكيل.

يقرأ كل وكيل من سجل المهام نفسه ويكتب فيه: ملف SQLite محلي. إنه المرجع الوحيد لمن يحمل كل مهمة، وما الذي ادُّعي، وما الذي أظهره الاختبار.

المهام

الهدف وأمر القبول، مكتوبان قبل بدء العمل.

الملكية

المالك الحالي لكل مهمة، مع lease وfence token الخاصين بها.

المحاولات

تُحسب لكل مهمة، عبر الوكلاء والنماذج والأجهزة.

الادعاءات

تقرير الوكيل بأن العمل قد أُنجز، محفوظًا بمعزل عن النتائج.

سجلات التحقق

كل تشغيل لاختبار القبول، مربوطًا بالـ commit وشجرة العمل اللذين جرى عليهما.

التغييرات

يُسجَّل أي تغيير في أمر القبول بنسخته القديمة والجديدة؛ ويُسجَّل التجاوز (override) أيضًا.

03 العزل

كل محاولة في نسختها الخاصة.

• تعمل كل محاولة في git worktree خاص بها، على فرعها الخاص. لا يتشارك عاملان الشجرة نفسها أبدًا.
• لا يستطيع العامل إعادة كتابة أمر القبول الخاص به. وحده المدير يمكنه تغييره، وقبل إغلاق المهمة فقط؛ ويحتفظ كل تغيير بالنسخة القديمة والجديدة.
• لا يصل العمل إلى فرعك الرئيسي إلا بعد نجاح التحقق، ويُشغَّل أمر القبول مرة أخرى بعد الدمج.
• يُرفض الـ force-push لكل الأدوار.
• تُنفَّذ هذه القواعد كشيفرة، قبل استدعاء النموذج وبعده. إنها ليست prompt، فلا يستطيع الوكيل أن يتجاوزها بالكلام.

04 الوكلاء

الوكلاء الذين تستخدمهم بالفعل.

يشغّل RADAR كلًّا من Claude Code وCodex CLI وOMP وHermes Agent، على حاسوبك أو على خوادم Linux خاصة بك. وهو لا يحلّ محلّها: فهي ما زالت تؤدي العمل.

عقد واحد

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

المدير

الوكيل الذي تتحدث إليه هو المدير: يفتح المهام، ويسلّمها إلى العمّال، ولا يُغلق مهمةً إلا بسجل تحقق ناجح.

العمّال

يؤدي العمّال العمل في worktrees خاصة بهم. لا يمكنهم إغلاق المهام ولا تغيير أمر القبول الخاص بها.

05 محلي أولًا

محلي أولًا.

لا يحتاج RADAR إلى حساب ولا إلى سحابة.

على جهازك

السجل، وملاحظات الذاكرة، وworktrees، وكل تشغيل للتحقق، على حاسوبك أو على خوادم Linux خاصة بك.

يحتاج إلى شبكة

وكلاؤك، الذين يتواصلون مع مزوّديهم كما يفعلون اليوم. أما كل خدمة خارجية أخرى فاختيارية ومعطّلة حتى تفعّلها.

المتطلبات

Windows أو Linux (macOS غير مدعوم بعد)، وPython 3.12 أو أحدث، وGit. يستخدم RADAR مكتبة Python القياسية فقط.

التكلفة

لا فاتورة خاصة به. يواصل الوكلاء استخدام الحسابات التي سجّلت دخولهم بها. ولا تُستخدم واجهة API مدفوعة إلا إذا حدّدت المزوّد والميزانية.

التثبيت

أعطِ وكيل البرمجة لديك رابط المستودع وقل له: «ثبّت هذا». يفحص حاسوبك، ويسألك قبل تثبيت أي شيء ناقص، ويثبّت RADAR في بيئة افتراضية، ويبلغك بما يقوله radar init وradar doctor.

06 الأوامر

قائمة قصيرة من الأوامر.

الأوامر التي ستستخدمها أولًا. العناصر النائبة بين قوسين زاويين.

07 ما لا يفعله

ما لا يفعله RADAR.

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

08 الحالة