Skip to content

Harness Engineering v2.0 — عقد الوكلاء + بوابات التحقق + الذاكرة (مسودة) - #48

Draft
DrAbdulmalek wants to merge 4 commits into
mainfrom
feat/harness-engineering
Draft

DrAbdulmalek wants to merge 4 commits into
mainfrom
feat/harness-engineering

Conversation

@DrAbdulmalek

Copy link
Copy Markdown
Owner

Harness Engineering — عقد الوكلاء + بوابات التحقق + الذاكرة (v2.0)

PR مسودة — لا يُدمج إلا بقرار المالك. صفر دفع إلى main، صفر دمج، صفر حذف.

ما هذا؟

تبنّي منهجية Harness Engineering (مستوحاة من Learn Harness Engineering — MIT)
بحيث تُقرأ قواعد العمل نفسها عند كل جلسة تطوير من أي وكيل ذكاء اصطناعي
(Claude Code, Codex, Cursor, Gemini...): القواعد الصفرية، بوابة التحقق، النطاق،
دورة حياة الجلسة، والذاكرة طويلة المدى (Mem0 MCP).

الملفات المضافة

الملف الوظيفة
AGENTS.md العقد الملزم — يُقرأ في بداية كل جلسة (مخصص لهذا المستودع)
feature_list.json قائمة المهام وحالاتها ومعايير القبول
progress.md سجل تراكمي للجلسات
session-handoff.md لقطة تسليم الجلسة (تُستبدل كل جلسة)
init.sh بوابة الدخول: كشف تلقائي للمشروع + بيئة + git + بوابة الجودة
scripts/verify.sh بوابة ما قبل الالتزام: فحص أسرار + بوابة المشروع
scripts/session-handoff.py مولّد التسليم + حفظ اختياري في Mem0
scripts/test_mem0_memory.py اختبار الذاكرة عبر الجلسات
docs/HARNESS.md الدليل المفهومي الكامل

بوابة هذا المستودع

python3 -m pytest tests/unit -q → الاختبارات الوحدوية خضراء

التحقق المنفذ في هذه الجلسة

  • bash -n init.sh ✅ وbash -n scripts/verify.sh ✅
  • python3 -m py_compile scripts/session-handoff.py scripts/test_mem0_memory.py ✅
  • فحص أسرار عبر verify.sh: لا أسرار متتبعة ✅
  • لم تُشغَّل بوابات الاختبارات الكاملة هنا (بيئة الوكيل) — تعمل عبر init.sh وCI.

بعد الدمج (قرار المالك)

  1. شغّل ./init.sh في بيئة كاملة للتأكد من البوابة الخضراء.
  2. (اختياري) فعّل Mem0: export MEM0_API_KEY=... ثم python3 scripts/test_mem0_memory.py.
  3. (اختياري) اربط .git/hooks/pre-push بـ ./scripts/verify.sh --quick.

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

  • فرع جديد feat/harness-engineering من main — لم يُلمَس main.
  • ملفات جديدة فقط — صفر تعديل على ملفات قائمة.
  • لا توكن ولا سر في أي ملف (كل شيء عبر $ENV_VAR / GIT_ASKPASS).

Z User and others added 4 commits October 4, 2026 22:02
… verification gates + Mem0 protocol

- AGENTS.md: عقد ملزم يُقرأ في بداية كل جلسة (قواعد صفرية + بوابة + نطاق + ذاكرة)
- init.sh: بوابة دخول بكشف تلقائي للمشروع
- scripts/verify.sh: بوابة ما قبل الالتزام (فحص أسرار + بوابة المشروع)
- scripts/session-handoff.py + scripts/test_mem0_memory.py: التسليم والذاكرة عبر الجلسات
- feature_list.json + progress.md + session-handoff.md: الحالة
- docs/HARNESS.md: الدليل المفهومي
- marathon-suite فقط: templates/ المركزية + docs/migration-guide.md

PR مسودة — لا يُدمج إلا بقرار المالك.
…t unused) + drop bare f-string

ruff on manjaro-care caught F841 (env unused — PYTHONPATH gate would have been
silently ignored in session-handoff.py) and F541. Fix benefits all repos.
… قاعدة main صريحة في AGENTS.md

- verify.sh: فحص memory-layer إخباري + بوابة surya-engine أنيقة (ocr-core)
- memory/{decisions,lessons,constraints,context}.md — فكرة Talewell: Markdown + Git
- AGENTS.md: شظية قاعدة main (idempotent) — توثيق صريح يمنع سوء تفسير main المحلي
- التوزيع بايتي عبر scripts/sync-harness.sh (المركز: harness-kit/universal)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant