عملت Dashboard لـ Spec-Kit

ما هي Spec-Kit في الأساس؟

SpecKit هي أداة موجهة لتنظيم عملية البرمجة باستخدام نماذج الذكاء الاصطناعي، فبدلاً من عشوائية الـ Vibe Coding تصبح الـ Spec هي العنصر المحوري في تطوير المشروع.

لو جرّبت تدير مشروعاً كبيراً باستخدام SpecKit، فغالباً هتمر بالمرحلة دي:

في البداية يكون لديك spec.md وplan.md وtasks.md، وكل شيء منظم وجميل ويبعث على التفاؤل.

بعد فترة، يصبح عندك عشرات الـ Features والـ Checklists والـ Contracts والقرارات والأدلة وتقارير المراجعة… وكل معلومة تحتاجها موجودة فعلاً، لكنك قد تحتاج إلى فتح خمسة عشر ملفاً حتى تعرف إجابة سؤال بسيط:

إحنا واقفين فين بالضبط؟

من هنا بدأت فكرة SpecKit Governance Dashboard.

المشروع عبارة عن Dashboard تقرأ ملفات SpecKit والـ Markdown الموجودة داخل مشروعك، ثم تحولها إلى صورة أوضح لحالة العمل: الـ Features، مراحل التنفيذ، الـ Phase Gates، القرارات المعلقة، والمشكلات التي تستحق الانتباه.

الأداة Read-only؛ لا تعدّل ملفات مشروعك، ولا تحاول استبدال الـ Markdown بقاعدة بيانات أو نظام إدارة جديد. يظل الـ Markdown هو Source of Truth، وتكتفي الـ Dashboard بقراءة المعلومات وتنظيمها وعرضها.

بمعنى آخر: مش هنحل مشكلة بمشكلة أكبر، أو على الأقل لحد دلوقتي 😅.

المشكلة

أثناء عملي على تطوير مشروع كبير باستخدام Spec Kit لاحظت أن الـ AI بيفهم ويستوعب إحنا واقفين فين وباقي إيه لكن أنا اللي مش عارف 😅

وثائق المشروع كبرت جداً جداً جداً... والمشكلة اللي كانت بتحلها Spec-Kit عملت مشكلة أكبر إني قدام خيار من اثنين؛ يا أحرق توكنز يا أحرق وقتي وذهني وأراجع الـ Specs بنفسي وأشوف إيه اللي اتقفل وإيه اللي ناقص ومين بيعتمد على مين ومين رايح فين ولفة كبيرة.

لم تكن المشكلة في نقص المعلومات، بل في أن المعلومات أصبحت موزعة أكثر من اللازم. كنت أريد متابعة التنفيذ والقرارات والـ Evidence ومراحل التسليم من غير أن أبني نظام إدارة منفصل بجانب الملفات التي نعتمد عليها بالفعل.

المشروع ما زال في بدايته، وهناك بالتأكيد مساحة كبيرة للتطوير، لكنه يقوم الآن بالمهمة الأساسية التي بُني من أجلها:

تحويل ملفات المشروع المتفرقة إلى داشبورد واحدة تساعدك على معرفة ما تم، وما تبقي، وما يبدو أخضر فقط لأن أحداً لم يفحصه جيداً بعد.

يمكنكم الاطلاع على المشروع وتجربته من هنا:

SpecKit Governance Dashboard على GitHub

ولو لقيت Bug سامحني أولاً، ثانياً اعتبره أول فرصة Contribution لك في المشروع 😅