عن المشروع

دستور إريك الهندسي هو إطار عمل قابل لإعادة الاستخدام يعمل كمصدر حقيقة موحد لكيفية تعاون البشر ووكلاء الذكاء الاصطناعي في مشاريع البرمجيات. صُمم ليُدمج في أي مستودع Git كوحدة فرعية للقراءة فقط باسم `constitution/`، مع طبقة من ملفات المشروع المحلية الصغيرة، ويُفرض من قبل وكلاء برمجة الذكاء الاصطناعي وخطوط التكامل المستمر. يحتوي المستودع على وثائق حوكمة موثوقة (CONSTITUTION.md، AI_WORKFLOW.md، INTEGRATION.md، TESTING.md، DOCUMENTATION.md، SECURITY.md، OPERATIONS.md، ARCHITECTURE.md، RELEASES.md، TODO_GUIDELINES.md، KNOWLEDGE_SOURCES.md)، و25 مهارة وكيل مدمجة تفرض قواعد الدستور بشكل مستقل، ومجموعة شاملة من سكربتات الفحص المرجعية التي تتحقق من الامتثال في التكامل المستمر. تغطي هذه الفحوصات اتساق قوالب التعليمات عبر ملفات البائعين (AGENTS.md، CLAUDE.md، .cursorrules، وغيرها)، وصحة بيانات المهارات، وإمكانية تتبع المتطلبات إلى الاختبارات، والتحقق المتبادل من جرد برمجيات OTS، وقواعد تبعيات الهندسة المعمارية (ضمان أن تبعيات الكود المصدري تشير إلى الداخل وفقًا لقاعدة التبعية)، ومواءمة الإصدارات وعلامات الإصدار، وحداثة التوثيق والويكي، وسلامة روابط الويكي، وفحص الأسرار، وقياس وزن التعليمات. سكربت التهيئة (`scripts/bootstrap.sh`) يهيئ مستودعًا موجودًا عن طريق إضافة الوحدة الفرعية، وإنشاء ملفات الحوكمة المفقودة، وإنشاء تقرير اعتماد. يدعم ملفات تعليمات الوكلاء الاختيارية عبر أعلام `--agents` (claude، cursor، copilot، goose، openhands، antigravity، continue، aider، generic، all)، مع AGENTS.md كافتراضي. لا يستبدل السكربت الملفات الموجودة افتراضيًا، بل يضع نسخ القوالب في `.constitution-bootstrap/templates/` للدمج اليدوي. كما يضيف شارة اعتماد موحدة إلى README، تُدار بين علامات لتجنب التكرار. يتضمن الإطار قوالب لقوائم فحص إكمال طلبات السحب، وCODEOWNERS، وبوابات سير عمل التكامل المستمر (مثبتة بـ SHA)، ووكيل Solon مخصص لـ GitHub Copilot في Visual Studio، وقوالب توثيق لمتطلبات المنتج، وتراكمات المعالم، وخطط الجلسات، وجرد برمجيات OTS، وصفحات الويكي الرئيسية، وتقارير ما بعد الحوادث. كما يوفر خادم MCP يعرض وثائق الدستور ومصادره كموارد، وسير عمل مصادر المعرفة لتقطير الكتب والمقالات إلى ملخصات قابلة للاستهلاك من قبل الوكلاء تحت `sources/`. تكامل بيئة التطوير تلقائي: فتح مستودع مُهيأ في Visual Studio أو VS Code أو بيئات JetBrains يتيح لمساعدي الذكاء الاصطناعي (GitHub Copilot، Continue.dev، Cursor) قراءة ملفات التعليمات الملتزمة، التي تشير إلى وحدة الدستور الفرعية. خطاف SessionStart في Claude Code يشير إلى الوحدات الفرعية القديمة فورًا. التكامل المستمر الخاص بالإطار يشغل مجموعة الاختبارات الكاملة بالإضافة إلى فحوصات الحوكمة الذاتية على كل طلب سحب ودفع إلى main، وسير عمل مواءمة علامات الإصدار يحرس علامات الإصدار. يتضمن المشروع توثيقًا موسعًا حول التكامل والإصدارات (حاليًا 1.48.0) ومثالًا عمليًا لتخطيط المشروع. يُوضع كطبقة حوكمة وليس مكتبة كود، مع التركيز على ممارسات تطوير منضبطة وقابلة للقياس بمساعدة الذكاء الاصطناعي.