اكتب قواعد المستودع مرة واحدة

ما هي الحركة

ضع أمر البناء وأمر الاختبار والملفات التي لا تُمسّ وتعريف التغيير المكتمل في ملف بجذر المستودع. الوكلاء يقرأونه، والوافدون الجدد من البشر كذلك.

لماذا تنجح

هذا ما فعله فعلًا القائمون على مشاريع استوعبت طلبات دمج مكتوبة بالوكلاء على نطاق واسع: ملفات تعليمات خاصة بالمستودع، وقوالب طلبات تُغلق تلقائيًا عند عدم الالتزام، وخطط اختبار إلزامية، وبوابات تغطية.

خطوة خطوة

1. أنشئ AGENTS.md (و/أو CLAUDE.md) في جذر المستودع.
2. اذكر أمر البناء وأمر الاختبار بدقة، أوامرَ لا نثرًا.
3. اذكر الملفات والمجلدات التي يجب ألّا تُعدَّل، ولماذا.
4. اذكر ما يجب أن يتضمّنه أي تغيير: اختبارات، ونطاق، وحدّ للحجم.
5. اجعل التكامل المستمر يفرض ما يمكن فرضه، فيصير الملف وصفًا للبوابة لا رجاءً.

الصق هذا

اقرأ هذا المستودع واكتب مسوّدة ملف AGENTS.md في جذره. أربعة أشياء لا غير: أمر البناء وأمر الاختبار بنصّهما، والملفات التي لا تُمسّ، وما يتضمّنه التغيير المكتمل، وفقرة واحدة عن تنظيم المشروع. وإن لم تجد أحد الأمرين مكتوبًا في أي مكان فقل ذلك بدل استنتاجه.

كيّفها لك

أضف قسمًا قصيرًا عن «كيف يُنظَّم هذا المشروع». هي أعلى فقرة قيمةً لوكيل ولمساهم جديد معًا.

تنويعات

• أضف ملفات قواعد لكل مجلد حيث لنظام فرعي أعرافه الخاصة.
• احتفظ بقائمة قصيرة لـ«أشياء تبدو خاطئة لكنها مقصودة» لإيقاف إعادة الهيكلة حسنة النية.

يعمل مع

• علّم النموذج إجراءً مرة واحدة وأعد استخدامه
• العمل على مستودع كامل لا على ملف ملصوق