معايير الهندسة

مبدؤنا هنا “الـ linter هو المعيار”. القواعد تعيش كـ config مُلتزَم ومفروض في CI، لا كنصوص تتقادم. البشر ووكلاء الـ AI يقرؤون نفس القواعد المفروضة.

flowchart LR
  Config["Committed config<br/>EditorConfig · analyzers · ESLint · detekt · SwiftLint"] --> CI["Enforced in CI"]
  CI --> Human["Developers"]
  CI --> Agent["AI coding agents"]

الصفحة هنا تذكر المبدأ وتشير إلى الـ config الذي يفرضه. إن كان بالإمكان فرض قاعدة عبر linter أو اختبار أو branch policy، فمكانها هناك لا في فقرة.

على من تنطبق: الـ repo الجديد يلتزم من اليوم الأول، والقديم يلتزم عند ترقية الإصدار الرئيسي التالية. الفجوة تذكرة عمل لا استثناء.

المعايير

لكل معيار صفحة رفيعة وصفحة فرعية Examples تحمل الكود الذي كان سيُثقلها. صفحات الـ Examples بالإنجليزية فقط — هي كود في معظمها، وترجمتها لا تضيف شيئًا.

الصفحة	ماذا تغطّي	الكود
.NET backend	ملفات الـ config الأربعة، vertical slices، انضباط الـ migrations، xUnit v3	Examples
Angular + PrimeNG	signals، مكتبة مكوّنات واحدة لكل تطبيق، RTL أولاً، Vitest، budgets	Examples
Native mobile	Kotlin/Compose و Swift/SwiftUI، التوقيع، الإصدارات، تخطيط عربي أولاً	Examples
API design	شكل خطأ واحد، الإصدار، الصفحات، idempotency، OpenAPI كعقد	Examples
Testing strategy	مسارات الـ CI، بوّابة تغطية الـ diff، الحتمية، من يكتب أي اختبار	Examples
ADRs	متى يستحق القرار ADR والقالب؛ الـ ADRs تعيش في كل repo تحت /docs/adr	Examples
AI agent context	اتفاقية AGENTS.md لكل build unit، ميزانية الحجم، حدود قيادة الإنسان	Examples

صفحات ذات صلة في أقسام أخرى

الصفحة	ماذا تغطّي
Branching & PRs	GitHub Flow وتسمية الـ branches والـ commits وسياسة المراجعة
Pipelines & Environments	قائمة بوّابات الـ PR، سلّم البيئات، الأسرار
New Project Provisioning	قائمة ملفات اليوم الأول في الـ repo