Claude Code Methodology — عندما يصبح الذكاء الاصطناعي مهندساً حقيقياً

هناك سؤال يطرحه كل من جرّب العمل مع Claude Code على مشروع حقيقي:

“كيف أجعله يتذكر ما فعلناه في الجلسة الماضية؟”

هذا السؤال وحده يكشف المشكلة الجوهرية: Claude يبدأ من الصفر في كل جلسة. لا ذاكرة. لا سياق. لا معرفة بالقرارات السابقة.

Claude Code Methodology — أو CCM — هو الجواب. لكنه جواب أعمق بكثير مما تتوقع.

المشكلة التي يحلّها CCM

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

هذا ما يعانيه Claude Code افتراضياً.

CCM يحل هذا بطريقة مختلفة جذرياً: لا يُعلّم Claude، بل يُعطيه ذاكرة مكتوبة دائمة — ملفات تعيش في الـ repo، تُقرأ في كل جلسة، وتُحدَّث بعد كل تغيير. الذاكرة ليست في رأس النموذج، بل في الكود نفسه.

البنية الرباعية — الأساس الذي لا يتفاوض

كل شيء في CCM مبني على أربع طبقات واضحة التسلسل:

┌──────────────────────────────────────────────────┐
│  L4 — AGENTS                                     │
│  عملاء متخصصون مستقلون لكل مهمة محددة           │
├──────────────────────────────────────────────────┤
│  L3 — HOOKS                                      │
│  بوابات أمان تعمل دائماً — لا يمكن تجاوزها      │
├──────────────────────────────────────────────────┤
│  L2 — SKILLS                                     │
│  وظائف قابلة للاستدعاء لكل نوع من العمل         │
├──────────────────────────────────────────────────┤
│  L1 — CLAUDE.md                                  │
│  الدستور — يُقرأ في كل جلسة، يُطبَّق دائماً    │
└──────────────────────────────────────────────────┘

قاعدة الطبقات صارمة:

• L1 يتفوق على كل شيء — إذا تعارض skill مع CLAUDE.md، يكسب CLAUDE.md
• L3 الـ hooks إلزامية — إذا حجبت hook، العملية تتوقف تماماً
• L4 الـ agents يرثون L1 — كل agent يقرأ CLAUDE.md أولاً

القواعد الذهبية — لا تفاوض فيها

CCM يبني على سبع قواعد مطلقة. لا skill ولا agent ولا تعليمات مستخدم تتجاوزها:

القاعدة الأولى: إذا لم يُكتب، لم يحدث

كل قرار، كل قاعدة، كل سبب — مكتوب في ملف. “الاتفاق الضمني” لا وجود له في CCM.

القاعدة الثانية: بوابة الجاهزية المزدوجة

لا كود قبل توفر طبقتين:

• الطبقة المعمارية: CLAUDE.md + CONSTRAINTS.md + DECISIONS.md
• طبقة التنفيذ: API_ENDPOINTS.md + docker-compose.yml + MIGRATION_ORDER.md

إذا كانت الطبقة الثانية مفقودة — اطلبها. لا تستنتج.

القاعدة الثالثة: الذاكرة دائمة، لا اختيارية

بداية الجلسة  ← اقرأ memory/*.md
أثناء العمل   ← حدّث memory/change_log.md بعد كل مهمة
نهاية الجلسة  ← حدّث كل ملفات الذاكرة، commit، push

القاعدة الرابعة: الأمان قبل كل تعديل

قبل تعديل كود موجود — أنشئ safety snapshot. قبل عمليات التدمير — أنشئ safety branch.

القاعدة الخامسة: الـ Constraints تُفحص أولاً

قبل كتابة أي سطر كود — تحقق من CONSTRAINTS.md. إذا كان القيد يمنعه، توقف واسأل.

القاعدة السادسة: مسؤولية واحدة

commit واحد = تغيير واحد. branch واحدة = feature واحدة.

القاعدة السابعة: I/O Channel للتواصل بين الـ Agents

كل تواصل بين الـ agents يمر عبر io/. الإشارات تتفوق على كل شيء. Dashboard دائماً محدّث.

نظام الذاكرة — كيف يتذكر Claude

الذاكرة في CCM ليست سحراً — هي ملفات مُنظَّمة في الـ repo:

memory/
├── change_log.md        ← ماذا تغيّر وكيف ولماذا
├── decisions.md         ← القرارات المعمارية المتخذة
├── error_patterns.md    ← الأخطاء التي وقعنا فيها
├── project_state.md     ← الحالة الحالية للمشروع
├── context.md           ← السياق العام للمشروع
└── handoff.md           ← ما يجب أن يعرفه من يكمل العمل

القوة الحقيقية: هذه الملفات ليست للبشر فقط. Claude يقرأها تلقائياً في بداية كل جلسة عبر /arib-session-start. لا تحتاج لشرح المشروع من الصفر كل مرة.

الـ 27 Skill — كل مهمة لها بروتوكول

CCM يأتي بـ 27 skill مُصمَّمة لأنواع العمل المختلفة:

Skills الجلسة

Skills التطوير

Skills الأمواج (Wave)

Skills الفحص والتحقق

نظام الأمواج — التسليم عبر جلسات متعددة

أكبر تحدٍّ في المشاريع الطويلة: كيف تُسلّم ميزة كبيرة تحتاج لأيام أو أسابيع؟

CCM يحل هذا بـ Wave Overlay:

Wave: اسم_الميزة/
├── PLAN.md      ← العقد الكامل: الأهداف، الخطوات، معيار الإغلاق
├── REPORT.md    ← ما أُنجز فعلاً
└── HISTORY.md   ← سجل كل الجلسات

الفرق بين Wave و Task العادية

التنفيذ التلقائي

/arib-wave-run يقرأ PLAN.md ويتقدم من خطوة لخطوة بدون إذن — commit واحد لكل خطوة.

يتوقف فقط عند:

• خطوة فاشلة
• checkpoint: true (عمليات لا عودة منها)
• غموض حقيقي يحتاج قرار إنساني
• انقطاع مقصود من المستخدم

هذا يعني أنك تستطيع إطلاق wave وتعود بعد ساعات لتجد العمل مكتملاً.

وضع الاستقلالية — العمل بدون تدخل بشري

لمن يريد الاستعداد الكامل، CCM يدعم Autonomy Mode: جلسات ساعات طويلة بدون موافقة على كل أداة.

الضمانات التي تُتيح ذلك بأمان

Guardrail                          →  إذا انتهك
─────────────────────────────────────────────────────
فشل الـ test suite                →  توقف فوري + إشعار
> 5 حجب في 10 دقائق               →  توقف + إشعار
> 50 tool call بلا commit          →  توقف + إشعار
تجاوز الحد الزمني (افتراضي 4h)    →  توقف + إشعار
Push لـ main من branch غير مرخّصة →  حجب دائم

شروط الدخول لوضع الاستقلالية

كلها مطلوبة. لا استثناء:

• Hooks مثبّتة وسليمة
• Working tree نظيفة
• Snapshot tag موجود للطوارئ
• Wave plan مكتوب ومراجع
• Dry run ناجح خلال آخر 7 أيام
• قناة إشعارات مُهيَّأة

الاسترداد عند الخطأ

# مراجعة التغييرات
git diff autonomy/start-<timestamp>..HEAD

# الرجوع للنقطة الآمنة
git reset --hard autonomy/start-<timestamp>

الـ snapshot tag هو شبكة الأمان. CCM يُبقيها لمدة 7 أيام على الأقل.

طبقة الإنفاذ — الأمان الذي يعمل فعلاً

الفرق بين أمان ورقي وأمان حقيقي: exit 2 بدلاً من exit 1.

Claude Code يعامل exit 1 كتحذير ويكمل. exit 2 يُوقفه تماماً.

البوابات التي تعمل الآن

🔴 كشف secrets (API keys، tokens، passwords)
🔴 أوامر bash الخطرة (rm -rf، DROP TABLE، force push)
🔴 انتهاكات OWASP (SQL injection، XSS، أوامر غير آمنة)
🔴 تصميم tokens بدون مصدر
🔴 دمج wave بدون اجتياز اختبار الإغلاق

CI يراقب نفسه

scripts/validate-coherence.sh يتحقق من:

• عدد الـ skills يتطابق مع الملفات الفعلية
• YAML frontmatter صحيح لكل agent
• الـ version متسق عبر الملفات
• لا توكنات قديمة
• كل المراجع تُحلّ لملفات موجودة

المنهجية تراقب نفسها.

الـ 15 Agent المتخصص

CCM يأتي بـ 15 agent متخصص، كل واحد له YAML frontmatter يجعله قابلاً للاستدعاء كـ subagent:

• code-reviewer — مراجعة كود بزوايا متعددة بالتوازي
• security-auditor — تدقيق أمني شامل
• perf-engineer — هندسة الأداء
• db-guardian — حارس قاعدة البيانات
• ci-pr-engineer — إدارة CI/PR
• compliance-auditor — مراجعة الامتثال (OWASP/GDPR/ISO/SOC2)
• وغيرهم…

كل agent يرث L1 — يعرف قواعد المشروع من اللحظة الأولى.

طبقة الامتثال — الجدية التي تميّز

CCM يأتي مع طبقة compliance جاهزة:

• OWASP Top 10 — بوابة إنفاذ، ليس مجرد قائمة
• GDPR — إرشادات معالجة البيانات الشخصية
• ISO 27001 — ممارسات أمن المعلومات
• SOC 2 — ضوابط التحكم والمراقبة
• PDPL — نظام حماية البيانات الشخصية (السعودي)

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

البداية — prompt واحدة تكفي

"Read claude-code-methodology/bootstrap/RUN.md
 and set up (or upgrade) CCM for this project."

الـ Situation Router يكتشف حالتك تلقائياً:

مشروع جديد؟          ──▶  Bootstrap (استبيان موجَّه)
مشروع قائم؟          ──▶  Reverse Bootstrap (مسح تلقائي)
CCM مثبَّت؟          ──▶  Upgrade (كشف drift، يحفظ بياناتك)
من Cursor/Windsurf؟  ──▶  Migration (من أي نظام)
Overlay على قديم؟    ──▶  Reengineering

لا تختار. الـ router يختار بناءً على الـ filesystem.

ما الذي يجعل CCM مختلفاً حقاً؟

كثير من الأدوات تُضيف ميزات فوق Claude Code. CCM يفعل شيئاً مختلفاً:

يُغيّر طريقة التفكير.

بدلاً من “أُعطي Claude تعليمات”، أنت الآن تُبني بنية تحتية تعيش في الكود:

• القرارات مُوثَّقة وليست ضمنية
• الأمان مُطبَّق وليس مُوصى به
• الذاكرة دائمة وليست جلسية
• العمل الطويل ممكن وليس مُرهقاً

“It is not a runtime, an orchestrator, or a kernel —
it is a set of conventions that make multi-session Claude Code work durable.”

المنهجية متاحة على: github.com/AribSudia/claude-code-methodology

نُشر يونيو 2026