عن المشروع

smaQit هي مجموعة أدوات تطوير قائمة على المواصفات، ومُصممة لتنسيق سير عمل تطوير البرمجيات القائمة على العوامل. تمكّن الفرق من وصف المتطلبات، والتي يقوم بعدها عملاء المواصفات بتحويلها إلى مواصفات ذات حالة. ثم يقوم عملاء التنفيذ بتحويل هذه المواصفات إلى تطبيقات عاملة ومُختبرة ومُنشرة. تؤكد المجموعة على قابلية التدقيق، والحدود الواضحة، وسير العمل القابل للتكرار. تشمل الميزات الأساسية مثبتًا واحدًا يدمج الأدوات اللازمة مثل PlantUML MCP ومُحولات JavaScript/WASM، ويتطلب فقط Node.js 22+ كمتطلب أساسي. تفرض المجموعة بوابات تصميم مرئية باستخدام أزواج PlantUML/PNG على غرار UML المرتبطة بالمواصفات النشطة، مما يضمن مراجعتها قبل التنفيذ. يمكن تتبع المتطلبات من الإدخال إلى المواصفات إلى التنفيذ، وتُحسَّن المواصفات من خلال دورة حياتها عبر حالات المسودة، والمُنفذة، والمُنشرة، والمُتحقَّق منها. يتم تقييد العوامل بطبقات أو مراحل محددة لمنع الزحف على النطاق والتحقق الذاتي من مخرجاتها. يدعم smaQit حاليًا GitHub Copilot (VS Code)، وClaude Code، وOpenAI Codex. يتم إجراء التثبيت عبر نص curl، والذي يضع العوامل والمهارات في مجلدات المستخدم. بعد التهيئة باستخدام `smaqit init`، يمكن للمستخدمين استدعاء عامل `smaqit.development` لبناء التطبيقات من المواصفات. تتضمن المجموعة أوامر CLI للحوسبة، والتحقق من الحالة، والتحقق من الصحة، وعرض التصميم. كما تتكامل مع GitHub Actions لتثبيت smaqit تلقائيًا قبل جلسات عميل ترميز Copilot. تم تصميم النظام للحفاظ على بيانات المستخدم والإضافات المخصصة أثناء التحديثات أو إعادة التثبيت.