الأدلة
المساهمة والحوكمة
كيف يمرّ تغيير في النظام من اقتراح إلى شحن مؤرشف. القاعدة الحاكمة: مصدر واحد للحقيقة، وترقية بالتحقّق لا بالرأي.
مصدر الحقيقة
للنظام إسقاطان: المهارة المحمولة (tokens.json + عقود المكوّنات YAML)، وهي المصدر للوكلاء؛ وهذا الموقع (Atlas)، وهو المرجع البشري الحيّ. البدائل تُوثّق مقابل فيغما. عند أي خلاف، وفّق بينها، ولا تدع الموقع أو الكود ينحرف بصمت عن الرموز.
مسار المكوّن
كل مكوّن جديد يمرّ بخمس خطوات، بالترتيب.
اقتراح
ابدأ من حاجة حقيقية على شاشة، لا من رغبة في مكوّن. اربطها بدليل سلوكي أو تصميم فيغما.
عقد
اكتب العقد أولا: رموز YAML وحالاته وخصائصه، مقابل عقدة فيغما محددة. هذا وسم "عقد".
بناء
ابنِ المكوّن في الكود من طبقات الأساس فقط، لا قيم خام. أضف معاينة تفاعلية.
تحقّق
طابقه بصريا مع فيغما، وتحقّق منه في العربية والإنجليزية والفاتح والداكن، وبلا فيض أفقي.
ترقية
عند اجتياز التحقّق، يُرقّى الوسم من عقد إلى جاهز، ويُوثّق على الموقع.
الإصدارات
النظام يتبع SemVer معرّفا في بيانات الرموز الوصفية: كسر (إزالة رمز أو تغيير معناه)، وميزة (إضافة رمز أو مكوّن)، وإصلاح (تصحيح قيمة دون تغيير العقد). كل تغيير يُسجّل في سجل التغييرات.
افعل ولا تفعل
- اكتب العقد قبل الكود، مقابل عقدة فيغما مذكورة.
- رقِّ المكوّن بالتحقّق (فيغما + الاتجاهان + الوضعان).
- لا تبنِ مكوّنا يكرّر مكوّنا مشتركا موجودا.
- لا تعدّل الموقع وتترك المهارة أو الرموز تنحرف.