🧠 بنك المسارات · ReasoningBank

ذاكرة *كيف* حُلّت المهام — استرجاع أقرب مسار حلّ ناجح لمهمة جديدة

الفكرة

.learnings/ تخزّن الدروس · graph-memory يخزّن العلاقات · ReasoningBank يخزّن المسار (خطوات + أدوات + نتيجة) ويسترجع أقرب مسار ناجح بالتشابه — فنعيد استخدام تفكير مُثبت بدل البدء من الصفر.

TF-IDF Cosine عربي + إنجليزي On-demand فقط صفر مفتاح/تبعية 15 اختبار E2E ✓

الاستخدام

cd skills/reasoning-bank/scripts

# استرجاع أقرب مسار لمهمة جديدة
python3 rb_cli.py search "كيف أبني أداة جديدة بأمان" -k 3

# تخزين مسار ناجح بعد إنجاز مهمة
python3 rb_cli.py add --task "..." --domain coding \
  --steps "اعزل|اكتب|اختبر|ثبّت|احقن|اربط" \
  --tools "python|exec" --outcome "..." --tags "skill"

python3 rb_cli.py stats       # إحصاء + الأكثر إعادة استخدام
python3 rb_cli.py selftest    # 15 اختبار

القاعدة الذهبية للاستخدام

✅ قبل مهمة جوهرية متكرّرة النمط → search لأعيد استخدام مسار مُثبت.
✅ بعد إنجاز مهمة بنجاح → add لأحفظ المسار.
❌ ليس في heartbeat/hot-path — on-demand فقط، صفر تكلفة دورية.
❌ لا أسرار KCPC حسّاسة إلا بإذن (نفس قاعدة graph-memory).

الأصل والضمانات

محرّك أصيل نظيف عندنا — مستلهَم من فكرة ReasoningBank (Ruflo) دون كود أو سلبية.
إضافي بحت: لا يمسّ .learnings ولا graph-memory ولا config.
حتمي + آمن (سطر فاسد يُتخطّى) + أداء 9ms لـ500 مسار.

🦾 نموذج «الاستخلاص الآمن»: نأخذ الفكرة، نبنيها أصيلة، صفر سلبية، لا نتوقف أبداً.