الحالة الحتميةما معنى الحالة الحتمية، بكلمات بسيطة.اقرأ الأطروحة ←

وكلاؤك ينسون.
Hunch يتذكّر.

كل جلسة ذكاء اصطناعي تبدأ من الصفر. يحفظ Hunch ما قرّره فريقك وما أُنجز وما لا يزال مستحقًا — مع المصادر، داخل Git — ليكمل الوكيل التالي من حيث توقّف السابق.

ابدأ الآن شاهد كيف يعمل

السياق المفقود

الذكاء الاصطناعي يقرأ شيفرتك. لكنه لم يكن حاضرًا حين اتُّخذ القرار.

يرى ما تفعله الشيفرة، لا لماذا، ولا ما انكسر في المرة السابقة، ولا ما سيكسره تغيير صغير لاحقًا.

يوم الاثنين

يصلح الفريق خطأً في تسجيل الخروج.

ينتقل تسجيل الدخول إلى الخادم، فيتوقف المفتاح المسروق عن العمل لحظة تسجيل الخروج.

بعد أشهر

تبقى الشيفرة. ويضيع السبب.

النقاش مدفون. والشيفرة الآمنة تبدو الآن معقّدة بلا داعٍ.

الجلسة التالية

ذكاء اصطناعي «ينظّف» الشيفرة.

التغيير يبدو رائعًا. وخطأ تسجيل الخروج يعود.

مع Hunch

السبب يصل أولًا.

متى سُجّل الدرس، يضع Hunch القرار — والخطأ الذي يمنعه — أمام الوكيل قبل أن يعدّل الملف.

**Hunch Memory في دقيقتين** (بالإنجليزية). ثم تعمّق في سلسلة من 7 حلقات: الإعداد، والخطافات، والتسجيل، والتسليم، والقواعد، والانحراف، والفرق.

متاح اليوم

سجل واحد. كل جلسة. كل وكيل.

ملفات عادية في Git. تصفّحها في المتصفح، أو صِل الوكلاء عبر MCP أو HTTP أو سطر الأوامر أو TypeScript أو Python.

الذاكرة

احتفظ بالأسباب

القرارات والأفكار المرفوضة والأخطاء والأسئلة المفتوحة تعيش إلى جانب الشيفرة التي تشرحها.

القرارات

لا تناقضات صامتة

يرفض Hunch قرارين حاليين متعارضين. استبدل أحدهما، ويُظهر السجل ما تغيّر.

الوصول

كل وكيل يرى نصيبه

اختر الوكلاء المسموح لهم بفتح كل قسم، وصولًا إلى سجلات بعينها. وأضف مفتاحًا لكل وكيل لتوقيع ما يكتبه.

الإجراءات

اعرف ما أُنجز وما هو مستحق

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

التحكم

أنت تقرّر ما يصير قاعدة

سجّل طريقة عملك أو عمل فريقك أو شركتك. يبقى إرشادًا إلى أن تثق بقاعدة وتفعّل الوضع الصارم.

git

سجلّك، ومستودعك

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

كيف يعمل Hunch

تذكّر. استرجع. تحقّق.

يمنح Hunch الوكيل ملخصًا قصيرًا وطريقة للتحقق من عمله. أما العمل نفسه فيبقى على الوكيل.

01 / تذكّر

احفظ ما تعلّمته.

سجّل القرارات والتصحيحات والملاحظات، مرتبطة بالشيفرة والمصدر الذي جاءت منه.

02 / استرجع

استعده في اللحظة المناسبة.

عند بدء المهمة، يختار Hunch الذاكرة المهمة ويسلّمها عبر MCP أو خطافات مساعدك. ما يصل يعتمد على المساعد.

03 / تحقّق

تحقّق، ثم اعرض الإيصال.

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

اطّلع على الأدلة

لا تثق بالوكيل. اقرأ الإيصال.

يفصل كل تقرير مهمة بين ثلاثة أمور تخلط بينها معظم الأدوات.

npm i -g @davesheffer/hunch

مقدّمما سلّمه Hunch للوكيل

مُبلّغ عنهما يقول الوكيل إنه استخدمه

مفحوصالقواعد والأوامر التي نُفّذت فعلًا

نجاح اختبار وحده لا يثبت أن Hunch أفاد. لا دليل، لا ادّعاء — ويبقى غير متحقق منه. اقرأ تقرير مهمة →

داخل أدوات البرمجة

اعرف ما سيكسره التغيير قبل أن تجريه.

في الشيفرة، يربط Hunch الأسباب بالاعتماديات وبالقواعد التي اختار فريقك حمايتها.

why

اعثر على السبب

القرارات والأفكار المرفوضة والإخفاقات السابقة وراء أي ملف أو دالة.

نطاق التأثير

اعرف ما يعتمد عليه

تتبّع الروابط الفعلية في الشيفرة لتعرف إلى أين يمكن أن يصل التغيير.

Project DNA

تعرّف على أسلوب المشروع

اطّلع على المصطلحات والعادات التي رصدها Hunch في هذا المستودع. إرشاد فقط.

compare

قارن الخيارات

ضع الفروع المرشحة أمام ما قرّرته سابقًا.

conform

تحقّق أن الشيفرة لا تزال تفي بوعودها

مثلًا: هل لا يزال مسار الدفع يتحقق من الصلاحيات؟

بوابة التغييرات

احمِ القواعد التي تثق بها

ينبّه إلى التغييرات التي تخالف قاعدة موثوقة. ولا يحظر الوضع الصارم إلا حيث تسمح القاعدة ومساعدك بذلك.

هل تريد التفاصيل التقنية؟ اقرأ كيف يعمل Hunch ←

ابدأ

ابدأ من مستودع واحد.

ثبّت Hunch

ثبّت أداة CLI، ثم شغّل hunch init داخل المشروع الذي تريد أن يتذكّره.

علّمه تاريخك

اختياري: املأ الذاكرة من آخر أشهر في Git، ثم راجع ما التقطه.

اسأل لماذا

أعد تحميل المساعد واسأله لماذا بُني ملف بهذه الطريقة. تستخدم Codex؟ أكّد الثقة بالخطافات أولًا عبر /hooks.

Claude CodeCursorVS CodeWindsurfCodexAntigravityAGENTS.md

~/your-repo

# التثبيت من npm — يتطلب Node 22.13+
$ npm install -g @davesheffer/hunch

# ربط Hunch بالمشروع والمساعدين
$ cd your-repo && hunch init

# تعلّم اختياري من آخر 90 يومًا
$ hunch backfill --since 90d

# افحص الحمض النووي القائم على أدلة المستودع
$ hunch dna inspect

# اسأل عن سبب وجود ملف
$ hunch why src/auth/session.ts

npm i -g @davesheffer/hunch && hunch init

يقدّم Hunch الإرشاد افتراضيًا — ولا يُحظر شيء حتى تقرّر. للتحديث، شغّل hunch update، وأعد ربط المساعد، وفي Codex راجع الأوامر التي تغيّرت في /hooks.

تستخدم Claude Code؟ ثبّته كإضافة بدلًا من ذلك:
/plugin marketplace add davesheffer/hunch → /plugin install hunch@hunch
Open VSX

سجل واحد، من شكوى العميل إلى إصلاح متحقق منه.

هذا هو الهدف: عميل يبلّغ عن مشكلة، ووكيل يصلح الشيفرة، وآخر يؤكد إنجاز العمل. الحالة المشتركة متاحة اليوم؛ ويختبر مشروع Sofia التجريبي انتقال العمل كاملًا.

ابدأ الآن اقرأ الوثائق