دليل القوالب

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

كيف تبدأ

انسخ هذه الملفات الأربعة إلى جذر مشروعك أولاً:

1. AGENTS.md أو CLAUDE.md
2. init.sh
3. claude-progress.md
4. feature_list.json

أضف الملفات المتبقية مع نمو مشروعك.

---

AGENTS.md

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

استخدم AGENTS.md لـ Codex أو وكلاء آخرين. استخدم CLAUDE.md إذا كنت تعمل مع Claude Code — البنية نفسها، بتنسيق نمط تعليمات Claude.

init.sh

سكربت التشغيل. يُشغّل تثبيت التبعيات والتحقق ويطبع أمر البدء — كل ذلك في خطوة واحدة.

claude-progress.md

سجل التقدم. كل جلسة تكتب في هذا الملف، وكل جلسة جديدة تقرأه أولاً.

feature_list.json

متتبع الميزات. قائمة مقروءة آلياً لكل ميزة يحتاجها الوكيل مع حالتها وخطوات التحقق والأدلة.

الملفات الأخرى

• session-handoff.md — ملاحظة تسليم مدمجة بين الجلسات
• clean-state-checklist.md — قائمة فحص قبل إنهاء كل جلسة
• evaluator-rubric.md — بطاقة تسجيل لمراجعة جودة مخرجات الوكيل
• quality-document.md — لقطة جودة تُقيّم كل مجال منتج وطبقة معمارية