Universal code quality guidelines applicable to any language or framework.
Context: If .ai-factory/ARCHITECTURE.md exists, follow its folder structure, dependency rules, and module boundaries alongside these guidelines.
| Naming | Descriptive, consistent, reveals intent | | Functions | Small, single purpose, no side effects | | Errors | Specific types, never swallow, log context | | Tests | AAA pattern, test behavior, descriptive names | | Reviews | Be specific, suggest solutions, be kind |
إرشادات جودة التعليمات البرمجية وأفضل الممارسات لكتابة تعليمات برمجية نظيفة وقابلة للصيانة. يغطي معايير التسمية والبنية ومعالجة الأخطاء والاختبار ومراجعة التعليمات البرمجية. يُستخدم عند كتابة التعليمات البرمجية، أو المراجعة، أو إعادة البناء، أو طرح السؤال "كيف يجب أن أسمي هذا"، أو "أفضل الممارسات لـ"، أو "التعليمات البرمجية النظيفة". المصدر: lee-to/ai-factory.