CLAUDE.md Starter Template قالب أولي لملف CLAUDE.md

# Project / المشروع

Purpose / الغرض:
Describe the smallest useful outcome for this training repository.
صِف أصغر نتيجة مفيدة لهذا المستودع التدريبي.

## Setup / الإعداد

- Install command / أمر التثبيت:
- Run command / أمر التشغيل:
- Test command / أمر الاختبار:
- Format command / أمر تنسيق الشيفرة:

## Structure / البنية

- Source files / ملفات المصدر:
- Tests / الاختبارات:
- Documentation / التوثيق:

## Working rules / قواعد العمل

- Explore the repository before editing.
- استكشف المستودع قبل إجراء أي تعديل.
- Use Plan Mode before implementing a feature.
- استخدم وضع التخطيط قبل تنفيذ أي ميزة.
- Keep changes inside the approved scope.
- أبقِ التغييرات ضمن النطاق المعتمد.
- Do not read or expose .env files, API keys, passwords, or private data.
- لا تقرأ ملفات .env أو مفاتيح API أو كلمات المرور أو البيانات الخاصة، ولا تكشف عنها.
- Ask before adding dependencies or changing project architecture.
- اطلب الموافقة قبل إضافة أي تبعيات أو تغيير بنية المشروع.
- Run the relevant tests before reporting completion.
- شغّل الاختبارات ذات الصلة قبل الإبلاغ عن اكتمال العمل.
- Show and explain the final diff.
- اعرض الفروقات النهائية واشرحها.
- Prefer the simplest implementation that meets the acceptance criteria.
- فضّل أبسط تنفيذ يلبّي معايير القبول.

## Acceptance criteria / معايير القبول

1.
2.
3.

## Human review / المراجعة البشرية

The student must be able to explain every changed file before recording the commit.
يجب أن يستطيع الطالب شرح كل ملف تغيّر قبل تسجيل التغييرات في Git.