عن المشروع

Better Design هو خادم MCP للتصميم وسجل shadcn/ui مفتوح المصدر يهدف إلى تزويد وكلاء البرمجة بالذكاء الاصطناعي بسياق تصميم مهيكل. تم وصفه بأنه يعمل مع الوكلاء والمحررات المتوافقة مع MCP، بما في ذلك Claude Code وCursor وVS Code/GitHub Copilot وClaude Desktop وclaude.ai. يجمع المشروع بين سجل أنظمة التصميم، ومبادئ واجهة المستخدم، وإرشادات الأيقونات، وفحوصات إمكانية الوصول، وقواعد مراجعة التصميم المرئي. يتكون النظام من طبقتين. طبقة ذكاء التصميم (Design Intelligence) تكون نشطة دائمًا أثناء العمل على واجهة المستخدم: فعندما يقوم الوكيل ببناء واجهة، يمكنه تحميل مبادئ تصميم المنتج وقواعد المراجعة ذات الصلة. أما طبقة السقالات (Scaffold) فهي تعمل عند الطلب وتطابق أعمال واجهة المستخدم الجديدة مع نظام تصميم؛ حيث يمكن للمستخدم قول "use better-design" ويقوم MCP بتحديد النظام المناسب. يسرد ملف README أدوات MCP: resolve-design-system وget-design-system-docs وget-ui-principle وget-review-rules وresolve-icon-library وsearch-icons. وتغطي هذه الأدوات مطابقة أنظمة التصميم الدلالية، وتحميل الرموز وأكواد المكونات، وإرشادات مركزة حول التسلسل الهرمي، والتباعد، والطباعة، والعمق، والحركة، والنماذج، وقوائم مراجعة WCAG والتصميم المرئي، ومطابقة عائلات الأيقونات، والبحث عن الأيقونات عبر Iconify. يحتوي السجل على 31 نظام تصميم مفتوح المصدر لـ shadcn/ui. وتشمل السمات المسماة: Linear وLinear Quality وSupabase وVercel وAirbnb وNotion وStripe وApple وFigma وLight Marketplace وPrecision Light وMinimal Light وDark Orange وVibrant Dark وNeutral Monochrome وCinematic Dark وEditorial Dark وCorporate Fintech وBeam Custom وBeam Lib وGlassmorphic Dark وInset Dark وLumen Dark وMetal FX Gold وMetal FX Silver وMetal FX Chromatic وMidnight Glass وMonochrome Industrial وPillow Light وTactile Minimal وTV Style. يتضمن كل نظام تصميم طبقة رموز globals.css وتجاوزات للمكونات. يمكن تثبيت المكونات في مشروع shadcn/ui من خلال shadcn CLI باستخدام رابط السجل، مثل زر Linear. يمكن أن يكون الإعداد محليًا أو عن بُعد. يوثق ملف README تثبيت مهارة الوكيل باستخدام npx skills add marvkr/better-design --skill better-design وتشغيل npx better-design؛ حيث يكتشف برنامج التثبيت أدوات البرمجة ويربط MCP دون استبدال التكوين الحالي. كما تم توثيق نقطة نهاية MCP عن بُعد مستضافة في better-design.com/api/mcp، باستخدام مفتاح API من إعدادات الموقع في ترويسة Authorization. يذكر ملف README أنه لا يلزم وجود حساب لمسار الإعداد المحلي ويوفر مثالاً لتكوين Claude Desktop لـ MCP عن بُعد. تتضمن بنية المستودع مكونات لتجاوزات shadcn/ui لكل سمة، وإدخالات JSON للسجل، ونصوص بناء وبذر (seed scripts)، ومهارات قابلة للتثبيت، ومهارات وكلاء أخرى. تشير إرشادات المساهمة إلى أن أنظمة التصميم الجديدة تتطلب تجاوزات TSX للمكونات، وإدخالات سجل مقابلة، وتشغيل عملية البذر. ومن المتوقع وجود تفاصيل التصميم الدقيقة مثل طبقات الظل، وحالات التركيز، وسماكة الحدود، وانتقالات التمرير، وتغيرات نصف القطر المحددة للسياق في كود المكونات، وليس فقط في متغيرات CSS. المشروع مرخص بموجب رخصة MIT.