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

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

يحفظ Hunch «لماذا» وراء شيفرتك في مستودع Git لديك: ما قرّرتَه، وما انكسر من قبل، وأي القواعد يجب أن تبقى سارية. يحصل عليها مساعدك قبل أن يعدّل. ثم يفحص Hunch التغيير — بالشيفرة، لا بنموذج آخر.

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

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

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

يوم الاثنين

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

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

بعد أشهر

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

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

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

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

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

مع Hunch

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

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

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

مبنيّ ليُفحَص، لا ليُصدَّق.

ست خصائص يمكنك التحقق منها في المصدر العلني. شاهد مقارنة Hunch ←

حتمي

القواعد تفحصها الشيفرة

لا استدعاء لنموذج في مسار الحظر. التغيير نفسه، القواعد نفسها، الحكم نفسه.

مبني على Git

ذاكرتك تبقى في مستودعك

JSON عادي داخل .hunch/. راجعه في PR، وتراجع عنه، وأعد بناء الفهرس متى شئت. بلا حساب Hunch.

إيصالات

كل ادّعاء يُظهر مصدره

الحظر يذكر القاعدة التي يطبّقها. وتقرير المهمة يفصل بين ما سُلّم، وما قاله الوكيل، وما نُفّذ فعلًا.

أي مساعد

ذاكرة واحدة، لكل مساعد

Claude Code وCodex وCursor وVS Code/Copilot وWindsurf وAntigravity وغيرها من عملاء MCP. تغطية الخطافات تختلف من مساعد إلى آخر.

بلا عدّاد

بلا فاتورة على كل توكن

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

بموافقة بشرية

البشر يقرّرون ما هو صحيح

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

كيف يعمل Hunch

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

يزوّد Hunch الوكيل بإحاطة، ثم يتحقق من عمله. وتبقى كتابة الشيفرة على الوكيل.

01 / تذكّر

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

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

02 / استرجع

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

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

03 / تحقّق

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

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

شاهد قاعدة تصمد.

وكيل يمدّ يده إلى الشيء الوحيد الذي استبعده فريقك. يوقف الفحص الإيداع ويسمّي القاعدة.

  • لا نموذج في مسار الحظر
  • يذكر القاعدة والملف والسبب
  • يعمل قبل الإيداع وفي CI
  ~/acme-checkout
# قاعدة فريقك: never import lodash — use src/utils
# وكيل أضاف للتوّ إلى الإيداع:  + import _ from "lodash"
$ hunch check --staged --strict
Directly touches 1 invariant(s):

  ⛔ [blocking] never import lodash — use src/utils
      con_4f1c2a9be0 · in: src/cart.ts
      rationale: one shared utility layer, not two

✗ 1 high-confidence blocking invariant(s) directly in scope — review before committing.
$ echo $?
1

جلسة توضيحية؛ ومعرّف القاعدة للتمثيل فقط. شغّل النسخة الحقيقية: demo/hunch-blocks-it.sh

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

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

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

مقدّمما سلّمه Hunch للوكيل
مُبلّغ عنهما يقول الوكيل إنه استخدمه
مفحوصالقواعد والأوامر التي نُفّذت فعلًا

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

الجديد في 1.52

ما الجديد في Hunch.

أبرز ما جاء في الإصدارات الأخيرة. والبقية في سجل التغييرات.

hunch ui1.52

ذاكرة مستودعك، في متصفحك.

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

Deliberate · Grill me1.52

طابور مراجعة لما يحتاج إلى إنسان.

يرتّب Deliberate التعارضات والروابط القديمة والتكرارات والذاكرة الضعيفة. ويستجوب Grill me سجلًا، بخمسة أسئلة على الأكثر، مع حجب الملفات التي تبدو أسرارًا.

Elixir1.52

Elixir تنضم إلى المخطط البياني.

نطاق التأثير، وما يعتمد على الشيفرة، وفحوص القواعد تعمل الآن مع Elixir، إلى جانب TypeScript وJavaScript وPython وGo وPHP. تحليل ساكن، بلا LLM.

hunch derive-rules1.49

اكتب القاعدة في وثائقك. وHunch يطبّقها.

علّم جملة بـ<!-- hunch:rule scope=… --> فتصير قيدًا. و--check يُفشل CI عندما تختلف الوثيقة والمخطط البياني.

hunch verify1.46

شغّل فقط الاختبارات التي يحتاجها التغيير.

يختار Hunch الاختبارات التي تستورد الشيفرة المتغيّرة أو شغّلتها. الشك يعني اختبارات أكثر: التغيير الذي يتعذّر تتبّعه يشغّل المجموعة كاملة.

الخطافات1.51

خطافات لا تعترض طريقك.

وسيط زمن الخطاف قبل 1.51.0 وبعده، بالمللي ثانية
عند توقّف المهمة2174 → 298 ms
قبل التعديل500 → 334 ms
لكل برومبت299 → 213 ms
بدء الجلسة251 → 148 ms

وسيط زمن الخطاف على VM اختبار الأداء، قبل 1.51.0 وبعده. مخرجات الخطافات متطابقة.

موطن الذاكرة1.51

ذاكرة واحدة لكل مستودع.

أشجار العمل (worktrees) والنسخ الإضافية من المستودع تتشارك موطن ذاكرة واحدًا، يُختار من هوية المستودع، لا من المجلد الذي أنت فيه.

جديد أيضًا منذ 1.44
  • 1.51
    hunch log --for <commit> يُظهر أي ذاكرة قادت إلى أي إيداع لميزة.
  • 1.51
    hunch mcp يردّ على المصافحة خلال 1.7–3.7 s. ومع overlay كبير على Windows كان يستغرق 28–76 s.
  • 1.50
    يمكن للتصحيح أن يُحيل إلى التقاعد القاعدة التي يعكسها. ولا يُحذف شيء.
  • 1.50
    عند فشل تشغيل الاختبارات، يسمّي الخطاف الخطأ السابق الذي يطابقه.
  • 1.48
    مرخّص بـFSL-1.1-ALv2. ويتحوّل كل إصدار إلى Apache-2.0 بعد عامين من صدوره.
  • 1.45
    hunch init يهيّئ فقط المساعدين الذين يجدهم.
  • 1.44
    hunch uninstall يزيل ما ثبّته Hunch ويُبقي ذاكرتك.
  • 1.44
    كتابات الوكلاء عبر MCP لا تستطيع تغيير سجل أكّده إنسان.
ما وراء الواجهة

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

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

hunch why

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

القرارات والأفكار المرفوضة والأخطاء السابقة وراء أي ملف أو رمز برمجي.

hunch impact

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

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

hunch check

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

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

hunch conform

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

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

hunch drift

التقط الوثائق التي تخلّفت

الوثيقة التي ما زالت مثبّتة على قرار مُستبدَل تُفشل hunch drift، فيلتقطها CI.

hunch dna inspect

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

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

ابدأ

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

يتطلب Node 22.13+ ومستودع Git. بلا حساب Hunch.

01

ثبّت واربط

ثبّت أداة CLI، ثم شغّل hunch init داخل مشروعك. يهيّئ فقط المساعدين الموجودين لديك.

02

علّمه تاريخك

اختياري: صُغ ذاكرة من آخر 90 يومًا في Git، ثم راجع ما التقطه.

03

اسأل لماذا

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

Claude CodeCodexCursorVS Code / CopilotWindsurfAntigravityأي عميل MCP
  ~/your-repo
# التثبيت من npm
$ npm install -g @davesheffer/hunch

# ربط Hunch بهذا المشروع
$ cd your-repo && hunch init

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

# اسأل عن الغرض من ملف
$ hunch why src/auth/session.ts

# تصفّح ذاكرتك في المتصفح
$ hunch ui
npm i -g @davesheffer/hunch && hunch init
  • إرشاد افتراضيًا. لا يُحظر شيء حتى تقرّر أنت.
  • حدّث عبر hunch update. وغادر عبر hunch uninstall: يزيل ما ثبّته Hunch ويُبقي ذاكرتك.
  • تستخدم Claude Code؟ ثبّته كإضافة: /plugin marketplace add davesheffer/hunch ← /plugin install hunch@hunch
  • VS Code؟ احصل على الإضافة من Open VSX

توقّف عن إعادة شرح شيفرتك.

امنح كل وكيل الذاكرة نفسها، وكل تغيير الفحص نفسه. يقدّم الإرشاد افتراضيًا، وأمر واحد يزيله.