Claude Code: نظام الذاكرة

ذاكرة المشروع > الذاكرة الشخصية > ذاكرة الجلسة
عند تعارض CLAUDE.md الخاص بالمشروع مع العام، يتفوق المشروع.

# الذاكرة العامة (~/.claude/CLAUDE.md)
"أفضّل الوضع الصارم لـ TypeScript، الدوال أقل من 20 سطراً"

# ذاكرة المشروع (project/CLAUDE.md)
"هذا المشروع يستخدم JavaScript (وليس TypeScript)، الدوال حتى 50 سطراً"

# النتيجة: Claude Code يُولّد كود JavaScript، دوال أقل من 50 سطراً
# ذاكرة المشروع تتجاوز الذاكرة الشخصية

# Claude Code يتذكر المحادثة السابقة خلال الجلسة

> أنشئ UserService
[تم الإنشاء]

> أضف وظيفة إعادة تعيين كلمة المرور إليه
[Claude Code يتذكر أين UserService، يعدّل مباشرة]

> أضف التحقق من البريد الإلكتروني أيضاً
[لا يزال يتذكر سياق UserService]

# بعد انتهاء الجلسة، لا يُحفظ سجل المحادثات

# الجلسة 1: "أفضّل أسلوب البرمجة الوظيفية"
# الجلسة 2: قد يُولّد كوداً غير وظيفي — لا يتذكر التفضيل

# الحل: اكتب التفضيلات في CLAUDE.md

# CLAUDE.md

## اتفاقيات المشروع (ذاكرة مستمرة)
- استخدام الوضع الصارم لـ TypeScript
- تنسيق استجابة API: { code, data, message }
- الأخطاء تستخدم صنف AppError
- إطار الاختبار: Vitest

## العمل المنجز (ذاكرة التقدم)
- ✅ وحدة مصادقة المستخدم (JWT)
- ✅ نظام صلاحيات الأدوار (RBAC)
- 🔄 وحدة إدارة الطلبات (قيد التنفيذ)
- ❌ تكامل الدفع (لم يبدأ)

## سجلات القرارات التقنية (ذاكرة القرارات)
- 2026-08-15: اختيار ذاكرة التخزين المؤقت Redis بدلاً من الذاكرة المدمجة (حاجة لدعم العناقيد)
- 2026-08-20: استخدام Prisma بدلاً من TypeORM (أمان أنواع أفضل)
- 2026-08-25: المبالغ تستخدم أعداداً صحيحة بالسنت (تجنب أخطاء الفاصلة العائمة)

> تذكر: وحدة الدفع تستخدم Stripe SDK، وليس استدعاءات REST API المباشرة

Claude Code:
  → تحديث CLAUDE.md...
  → أُضيف: "تكامل الدفع يستخدم Stripe SDK (وليس استدعاءات REST المباشرة)"

# في الجلسات اللاحقة:
> نفّذ وظيفة استرداد الدفع

Claude Code:
  → [القراءة من CLAUDE.md] استخدام Stripe SDK
  → إنشاء payment.service.ts باستخدام Stripe SDK ✅

<!-- ~/.claude/CLAUDE.md -->

## تفضيلات البرمجة
- الوضع الصارم لـ TypeScript
- تفضيل const، تجنب let و var
- الدوال لا تتجاوز 30 سطراً
- إضافة تعليقات JSDoc
- استخدام ES Module

## تفضيلات الاختبار
- أسلوب describe/it (وليس test())
- تسمية الاختبار: should + فعل + شرط
- محاكاة التبعيات الخارجية، وليس الوحدات الداخلية

## تفضيلات Git
- تنسيق الالتزام: conventional commits
- كل نقطة ميزة التزام منفصل

## ما لا يعجبني
- ❌ لا تستخدم any كنوع
- ❌ لا تستخدم console.log للتنقيح
- ❌ لا تتجاهل أخطاء TypeScript