لمستودعك حمض نووي.
ويمنح Hunch كل وكيل برمجي فهمًا له.

يصل كل وكيل برمجي متقنًا لبناء الجملة لكنه جديد على فريقك. يمنحه Hunch اللغة والقرارات والإصلاحات الصعبة والحدود الكامنة خلف الشيفرة قبل أن يغيّرها.

مشكلة الغريب اللامع

يفهم بناء الجملة. لكنه لا يفهم لماذا يقول فريقك لا.

تبقى الشيفرة. وتتلاشى الحكمة التي اكتسبها الفريق بشق الأنفس.

يوم الاثنين

يعالج الفريق خطأً مؤلمًا في تسجيل الخروج.

ينقل الفريق الجلسات إلى الخادم كي يتمكّن من إبطال الرمز المسرّب فورًا. يضيف القرار بعض التعقيد، لكنه يغلق الثغرة.

بعد أشهر

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

تُدفن الحادثة في pull request قديم، وينتقل شخصان إلى فريقين آخرين. ويبدو مسار الجلسة غير المعتاد الآن كأنه تعقيد بلا داعٍ.

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

يقترح غريب لامع «تبسيطها».

التغيير مرتب وصحيح محليًا، لكنه يعيد فتح العطل نفسه الذي دفع الفريق ثمن فهمه.

مع Hunch

يعلّم المستودع الوكيل قبل التعديل.

يعيد Hunch إلى الواجهة ما اختير وما رُفض والخطأ الذي يمنعه القرار. يعمل الوكيل بحكمة الفريق من دون أن يتظاهر بأنه الفريق.

كيف يعمل الحمض النووي للمشروع

يتعلم Hunch كيف يعمل هذا المستودع، ثم يمنح كل وكيل ما يهمه فقط.

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

01 / راقب

اقرأ إشارات المستودع نفسه.

يدرس Hunch مراجعة Git دقيقة وتاريخًا محدودًا وأعرافًا ملتزمًا بها وأدلة مراجعة يُسمح لأدواتك بتقديمها.

02 / افهم

ابنِ صورة قابلة للتتبّع.

تحتفظ اللغة وعادات المساهمة وتوقعات المراجعة والأعراف الهندسية بدرجة ثقتها وحداثتها وأدلتها.

03 / علّم

قدّم الحمض النووي المناسب للعمل.

يحصل الوكيل على السياق الملائم قبل التعديل. لا يتحول السلوك الشائع إلى قاعدة بصمت، وتبقى السلطة بشرية.

الحمض النووي للمشروع في v1.22

فهم قائم على الأدلة، لا على الانطباعات.

يبني Hunch ملفًا مرتبطًا بمراجعة محددة من تاريخ Git وملفات الأعراف وأدلة المراجعة المحدودة. لا يدخل نص التعاون الخام إلى الملف، ولا تتحول العادات المرصودة إلى سياسة.

npm i -g @davesheffer/hunch
مراجعة دقيقةيبقى الملف مرتبطًا بالشيفرة التي يصفها
الثقة + الحداثةتبيّن كل سمة مدى قوة وحداثة دليلها
أدلة مختومةيستطيع الوكيل إظهار أساس كل ملاحظة

يمكن للحمض النووي للمشروع توجيه الاستكشاف والمصطلحات والمراجعة. ولا يمكنه إنشاء قرار أو قيد أو سياسة أو إذن أو تجاوز أي منها. اقرأ كيف يعمل حد الأدلة ←

ما يجعله جديرًا بالثقة

ليس شخصية. وليس سياسة خفية. بل أدلة يمكنك فحصها.

يفصل Hunch بين الحمض النووي المرصود للمشروع والذاكرة الهندسية الدائمة والقواعد التي اعتمدها البشر. وتوضح كل إجابة مصدرها وحداثتها والسلطة التي تملكها فعلًا.

الحمض النووي للمشروع

يتعلم كيف يتحدث المستودع

تأتي المفردات وعادات المساهمة وتوقعات المراجعة والأعراف الهندسية من أدلة المستودع، لا من شخصية مولّدة.

ذاكرة هندسية

يتذكر لماذا توجد الشيفرة

تبقى القرارات والبدائل المرفوضة والتصحيحات والأخطاء التي أُصلحت متاحة بعد زوال المحادثة أو pull request أو زميل الفريق.

رسم الشيفرة

يعرف ما قد يتأثر بالتغيير

يتتبع Hunch الروابط بين الملفات والدوال ليظهر السبب المناسب في المكان المناسب.

سلطة بشرية

لا يحوّل الشيوع إلى سياسة

تبقى الأنماط المرصودة إرشادية. ولا تكتسب سلطة الإنفاذ إلا قاعدة دقيقة يختار البشر الوثوق بها.

الأدلة مرفقة

يعرض مصدر كل ادعاء

تنتقل درجة الثقة والحداثة والمصدر والمراجعة الداعمة مع السياق الذي يتلقاه الوكيل.

محلي أولًا

تبقى ذاكرتكم ملككم

لا يتطلب Hunch حسابًا مستضافًا. احتفظوا بالذاكرة في المشروع أو في مستودع Git خاص يتحكم به الفريق.

ابدأ

دع مستودعك يعرّف بنفسه.

ثبّت Hunch

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

أضف التاريخ الذي يشرح السبب

يجد hunch backfill --since 90d قرارات ودروسًا مفيدة في commits آخر 90 يومًا.

شاهد ما تعلّمه Hunch

افحص الحمض النووي لمشروعك، ثم اسأل: «لماذا بُنيت وحدة الجلسات بهذه الطريقة؟» تأتي كل إجابة مع دليل.

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

الحمض النووي للمشروع والذاكرة إرشاديان افتراضيًا. لا يُحظر شيء حتى تختار ذلك صراحة.

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

علّم كل وكيل برمجي كيف يعمل مستودعك.

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