تبدأ كل جلسة جديدة في Claude Code دون أن تعرف أين يقع كل شيء، ولا ما تقرّر في الجلسة السابقة ولماذا، ما لم تكتبه لها بنفسك. تبني إضافة chamnan فهرسًا للمستودع وسجلات بجوار الكود، وتسلّم خلاصتها لكل جلسة عند بدايتها، ولا تتصل بالشبكة بحسب توثيقها.
ما الذي تكتبه في مستودعك
كل ما تنتجه ملفات Markdown وJSON في مجلد .chamnan تحفظه في Git مع الكود: MAP.md سطر لكل ملف مأخوذ من تعليقه الافتتاحي، وSTATE.md لما تعمل عليه الآن، ومجلدا sessions وmemory لأين توقفت كل جلسة وأسباب القرارات والقواعد الثابتة. تصل نصوص القواعد إلى كل جلسة، أما القرارات فعناوينها فقط.
ثماني مهارات ووكيلان
/chamnan:bootstrap: الإعداد الأول؛ يبني الفهرس ويقيس نسبة الملفات الموصوفة ويعرض إكمال الناقص./chamnan:remap: يعيد بناء الفهرس بعد تغيّر بنية المشروع./chamnan:remember: يسجّل قرارًا وسببه، أو درسًا كلّف وقتًا، أو قاعدة ثابتة./chamnan:resume: يكتب أين توقفت الجلسة وما يعترض إكمالها./chamnan:capture: يحفظ إجراءً متعدد الخطوات يتكرر في عملك./chamnan:promote: يحوّل سكربتًا مؤقتًا أثبت فائدته إلى أداة دائمة./chamnan:milestone: يوثّق تغييرًا أعاد تشكيل المستودع وسببه./chamnan:report: يقارن حجم السياق في كل طلب قبل إعدادها في المستودع وبعده.- الوكيل commenter: يضيف بموافقتك سطر تعليق أعلى الملفات الخالية منه ولا يمس الكود، ويكتب بالإنجليزية ما لم تغيّر مفتاح language.
- الوكيل librarian: يكشف الفهرس المتقادم والإجراءات التي تشير إلى ملفات محذوفة، ويكتفي بالتقرير.
ومعها سبعة hooks و13 أمرًا للطرفية، منها chamnan-map --preview لعرض ما ستتسلمه الجلسة بالضبط، وchamnan-peek لعرض بنية ملف كبير دون قراءته كاملًا، وchamnan-guard للتنبيه إلى ما يشبه مفتاحًا سريًا قبل الـ commit.
مثال: ترحيل توقف في منتصفه
تنقل وحدة الدفع إلى PostgreSQL ولم تنتهِ. يكتب /chamnan:remember القرار في ملف مثل .chamnan/memory/decisions/postgres-over-sqlite.md، مع سطر Rejected يذكر SQLite وسبب استبعادها. ثم يكتب /chamnan:resume سجلًا مثل .chamnan/sessions/2026-09-19-payment-migration.md بأقسام Done وRemaining وBlockers. وفي الجلسة التالية يصل عنوان القرار، ومن السجل قسما Remaining وBlockers دون بقية أقسامه.
التشغيل والمتطلبات
- فك الضغط، ومن مجلد مستودعك شغّل
claude --plugin-dir "PATH/TO/EXTRACTED/plugin"للجلسة الحالية. وللتثبيت الدائم من مستودع المطوّر بإصداره الحالي:claude plugin marketplace add ArcticFox2029/chamnanثمclaude plugin install chamnan@chamnan. بعدها اكتب/chamnan:bootstrapمرة في كل مستودع. - تحتاج Claude Code بدعم الإضافات وPython 3.8 أو أحدث دون حزم إضافية، ولا ينشئ الإعداد التلقائي المجلد إلا في مشروع تحت Git أو Mercurial أو SVN.
- على Windows يجاور كل أمر ملف cmd يشغّله، وعلى Linux وmacOS أرفقتُ EXECUTABLE-MODES.json لإعادة صلاحيات التنفيذ إن أسقطها برنامج فك الضغط.
- لا تعمل في محادثات claude.ai. أما Codex وCursor فيكتب لهما
chamnan-context --writeالخلاصة في AGENTS.md أو ملف قواعد الأداة.
متى لا تناسبك
- في مشروع تفتحه مرة واحدة؛ يقول مطوّرها إنها تكلّف فيه أكثر مما توفّر.
- إن كنت تنتظر إجابات أصح؛ يذكر المطوّر أن ملفات السياق لا تحسّنها تحسنًا مقيسًا، بل تقلّل إعادة قراءة الملفات.
- إن خلت ملفاتك من التعليقات الافتتاحية، إذ يصير الفهرس قائمة أسماء. ويتقادم الفهرس مع تغيّر البنية ما لم تعد بناءه أو تفعّل
chamnan-map --install-git-hook.
أرفقتُ دليلًا عربيًا للتثبيت، وللمطوّر ترجمة عربية لصفحته في plugin/docs/i18n/README.ar.md. الترخيص MIT، والإضافة من تطوير ArcticFox2029 في مستودع chamnan على GitHub، وملفاتها في الحزمة من الإصدار 1.27.0 دون تعديل.
