Claude CLI: أفضل الممارسات

# ❌ سياق ضعيف
claude ask "أصلح هذا الكود"

# ✅ سياق جيد
claude ask "أصلح هذا الكود ليعمل مع React 18 وتحسين الأداء"

# ✅ محادثة مع ملفات محددة
claude chat --files src/api/*.ts src/lib/db.ts

# ✅ حوارات متعددة
> "أنشئ مكوناً جديداً"
> "أضف error handling"
> "حسّن الأداء"
> "أضف اختبارات"

# ✅ افهم ما تم إنشاؤه
claude explain src/new-component.tsx

# ✅ للمهام اليومية
claude config set model claude-3-5-sonnet-20241022

# ✅ للمهام المعقدة
claude config set model claude-3-opus-20240229

# ❌ نسخ أعمى
claude generate "كود معقد" && pbcopy

# ✅ افهم أولاً
claude generate "كود معقد" --explain

# ❌ مشاركة مفاتيح API
claude explain .env

# ✅ استخدام ملفات masked
claude explain src/ --exclude .env

# ✅ اكرر للتحسين
claude generate "login component"
> "أضف error handling"
> "جعل التصميم متجاوباً"
> "أضف loading states"

# ❌ استخدام مباشر
claude generate "api endpoint" > src/api/users.ts

# ✅ مع اختبارات
claude generate "api endpoint" --test > src/api/users.ts

# 1. السياق
"أعمل على مشروع React 18 مع TypeScript"

# 2. المهمة المحددة
"أريد إنشاء مكون تسجيل دخول"

# 3. المتطلبات
"- يجب أن يحتوي على حقول email و password
- يجب أن يتحقق من صحة البيانات
- يجب أن يعرض رسائل خطأ واضحة"

# 4. التفضيلات
"- استخدم Tailwind CSS
- اتبع نمط functional components
- أضف TypeScript types"

# للمحادثة
claude chat --files src/components/Button.tsx
> "شرح لي كيف يعمل هذا المكون"
> "ما هي المشاكل المحتملة؟"
> "كيف يمكنني تحسينه؟"

# لإنشاء الكود
claude generate "أنشئ مكون React Button مع:
- variants: primary, secondary, danger
- دعم TypeScript
- Tailwind CSS classes
- accessibility attributes"

# لإعادة الهيكلة
claude refactor src/utils/api.js --to typescript
> "حافظ على نفس API surface
- أضف types صارمة
- أضف error handling"

# ✅ فهرسة المجلدات المهمة فقط
claude scan src/
claude scan lib/

# ❌ تجنب فهرسة node_modules أو build
claude scan . --exclude node_modules --exclude .next

# .claude-rules
project:
  name: "تطبيق Next.js 14"
  type: "fullstack"

preferences:
  - "استخدم App Router"
  - "فضل مكونات السيرفر"
  - "استخدم Tailwind CSS"

typescript:
  strict_mode: true
  path_alias: "@/*"

testing:
  framework: "jest"
  coverage_target: 80

# ✅ استخدام محادثات منفصلة لكل مهمة
claude chat --directory ./src/components --session "ui-components"
claude chat --directory ./src/api --session "backend-api"

# ✅ استخدم ملف .claudeignore
# مشابه لـ .gitignore
.env
*.key
*.pem
secrets/

# ✅ راجع ما تشاركه
claude chat --files src/api/users.ts --dry-run

# ✅ استخدم exclude
claude explain src/ --exclude .env --exclude secrets/

# ✅ كن محدداً في الملفات
claude analyze src/api/users.ts

# ❌ تجنب تحليل مجلدات كبيرة
claude analyze src/  # قد يستهلك الكثير

# ✅ بدء محادثة والاستمرار فيها
claude chat --files src/components/

# هذه الطريقة تحافظ على السياق وتوفر tokens
# مقارنة بطلبات متعددة منفصلة

# ✅ اطلب الشرح مع الأمثلة
claude ask "اشرح لي React Hooks مع أمثلة عملية"

# ✅ اطلب موارد إضافية
claude ask "ما هي أفضل المصادر لتعلم Next.js 14؟"

# ✅ افهم لماذا تم كتابة الكود بهذا الشكل
claude explain src/new-component.tsx

# ✅ اسأل عن البدائل
claude ask "ما هي البدائل لهذا النمط؟"

# المشكلة: Claude لا يفهم سياق مشروعك
# الحل:
claude scan .  # فهرسة المشروع أولاً

# المشكلة: إجابات عامة جداً
# الحل:
claude chat --files src/  # توفير المزيد من السياق

# المشكلة: استهلاك عالي للـ tokens
# الحل:
claude config set model claude-3-haiku-20240307  # استخدام نموذج أسرع