Brandrail مقابل Brandrails مقابل Modern Web Guidance: ضوابط شيفرة واجهات الذكاء الاصطناعي لنظام تصميمك
تحمي كل من Brandrail وBrandrails وModern Web Guidance مسارًا مختلفًا من واجهات المستخدم المولَّدة بالذكاء الاصطناعي: التوافق مع العلامة التجارية، ورموز التصميم وقواعد الوكلاء، وشيفرة منصة الويب الحديثة. يقدّم هذا الدليل نموذج المسارات الثلاثة، ويوضح أي أداة ترصد أي انحراف، ويشرح كيفية فرضها كبوابات في CI، ويبيّن ما تُظهره الأدلة وما لا تُظهره.
تنتهي الفرق التي تطلق واجهات المستخدم باستخدام Claude Code أو Cursor أو Copilot أو Codex بشاشات تعمل لكنها لا تبدو كأنها منتج واحد. كما أن الشيفرة الكامنة خلفها تميل إلى أسلوب أقدم مما قد يكتبه اليوم مهندس واجهات أمامية متمرس.
نموذج المسارات الثلاثة: ثلاث أدوات وثلاث طبقات من انحراف واجهات الذكاء الاصطناعي
يطرح مشروع Brandrail المشكلة الجوهرية بوضوح: أدوات البرمجة بالذكاء الاصطناعي لا تعرف نظام التصميم لديك، لذا تخرج كل شاشة بألوان وأزرار ومسافات مختلفة. نقسّم هذا الانحراف إلى ما نسميه نموذج المسارات الثلاثة: مسار العلامة التجارية، ومسار رموز التصميم، ومسار المنصة. وتركّز كل أداة هنا على مسار واحد.
مسار العلامة التجارية. Brandrail (brandrail-app/brandrail) هو خادم MCP. يزوّد الوكيل بحزمة العلامة التجارية (Brand Kit) ومكوناتك قبل أن يكتب الواجهة، ثم يفحص النتيجة ويعيد الإصلاحات كي يصحح الوكيل نفسه.
مسار رموز التصميم. Brandrails (matejholek/brandrails) أداة منفصلة تسرد ملفات الوكيل المحمّلة دائمًا الخاصة بها، مثل AGENTS.md وتعليمات Copilot، أسماء الرموز فقط وتشير إلى design/tokens.md، حتى لا يستهلك نظام تصميم كبير نافذة السياق.
مسار المنصة. Modern Web Guidance تتصدى لنوع آخر من الإخفاق. يشير القائمون عليها إلى أن وكلاء البرمجة كثيرًا ما يعودون إلى أنماط أقدم لأن بيانات تدريب النماذج اللغوية الكبيرة تحتوي على كميات هائلة من الشيفرة القديمة. فقد يطابق زرٌّ ما علامتك التجارية تمامًا ومع ذلك يستخدم نمطًا استبدلته منصة الويب منذ سنوات.
ملاحظة حول الأسماء: من السهل الخلط بين Brandrail وBrandrails، لذا نقترح تثبيت كل منهما من عنوان مستودعه الدقيق.
| الأداة | المسار | متى تعمل | أين تعمل | الترخيص أو الإشراف |
|---|---|---|---|---|
| Brandrail (brandrail-app/brandrail) | العلامة التجارية: حزمة العلامة التجارية والمكونات | قبل التوليد (السياق) وبعده (التحقق) | خادم MCP محلي عبر stdio وأداة فحص CLI، إضافة إلى خدمة حسابات مستضافة | MIT، وفقًا لتغطية من طرف ثالث في Tech Bytes |
| Brandrails (matejholek/brandrails) | رموز التصميم وملفات تعليمات الوكيل المختصرة | قبل التوليد (ملفات الوكيل) | في مستودعك | راجع المستودع قبل الاعتماد |
| Modern Web Guidance | شيفرة ويب حديثة قائمة على المعايير | قبل التوليد (إرشادات الوكيل) | في سياق عمل الوكيل | تشرف عليها فرق Chrome وEdge وFirefox وMDN بالتعاون مع المجتمع |
أي مسار يرصد أي انحراف
المصفوفة أدناه قراءتنا الخاصة للتركيز المعلن لكل مشروع، وليست مقارنة قائمة على القياس. لا يغطي أي عمود إمكانية الوصول أو السلوك عبر المتصفحات تغطية كاملة، لذا نقترح إبقاء هذه الفحوص بيد البشر.
| نوع الانحراف | مسار العلامة التجارية (Brandrail) | مسار رموز التصميم (Brandrails) | مسار المنصة (Modern Web Guidance) |
|---|---|---|---|
| ألوان أو خطوط أو مكونات خارجة عن العلامة التجارية | أساسي | جزئي | لا |
| قيم مثبّتة في الشيفرة بدلًا من الرموز | جزئي | جزئي (يُوجَّه الوكلاء إلى الرموز) | لا |
| الوكيل لا يرى قواعدك أبدًا | جزئي (سياق MCP) | أساسي (ملفات مختصرة محمّلة دائمًا) | لا |
| أنماط قديمة، مثل تلميحات الأدوات المخصصة بلغة JavaScript | لا | لا | أساسي |
| الدلالات والنماذج وإمكانية الوصول | لا | لا | جزئي |
| السلوك عبر المتصفحات | لا | لا | غير موثوق |
Brandrail: سياق العلامة التجارية يدخل ودرجة العلامة التجارية تخرج
يعمل Brandrail على شكل حلقة. قبل التوليد، يرسل خادم MCP الخاص به حزمة العلامة التجارية والمكونات إلى الوكيل بوصفها سياقًا، فتنطلق المسودة الأولى من قواعدك بدلًا من الإعدادات الافتراضية للنموذج. وبعد التوليد، يمر التحقق عبر أداة تُسمى validate_snippet. ويذكر وصفها المنشور أنها تعيد درجة للعلامة التجارية وتسرد كل مخالفة مع إصلاحها.
الاستخدام المقصود محدد: استدعِها مرة واحدة بعد كتابة الواجهة، ومرّر كل ملف تغيّر، وأصلح كل خطأ وتحذير قبل الإنهاء. أما الوكيل الذي يمرر آخر ملف عدّله فقط فسيحصل على درجة مجامِلة. نقترح التعامل مع درجة العلامة التجارية بوصفها إشارة واحدة من بين عدة إشارات، مع فحوص منفصلة لإمكانية الوصول والتخطيط وجودة الشيفرة.
أما عن التحزيم، فتفيد تغطية من طرف ثالث في Tech Bytes بأن Brandrail يأتي في حزمة مرخصة بموجب MIT تضم خادم MCP محليًا، وأداة فحص CLI مستقلة، ومحرك قواعد مكتوبًا بلغة TypeScript خالصة بلا اعتماديات في وقت التشغيل. وتكتسب أداة فحص CLI أهميتها لأن أداة MCP لا تعمل إلا حين يقرر الوكيل استدعاءها، بينما تعمل خطوة CLI في CI مع كل طلب سحب.
ما يبقيه Brandrail محليًا وما يمر عبر خدمته المستضافة
ستسأل فرق الأمن والشؤون القانونية والمشتريات جميعها عن وجهة الشيفرة. في مسار الفحص، مستودع Brandrail واضح: يعمل الخادم محليًا عبر stdio، وتُفحص الشيفرة على جهازك ولا تُرفع أبدًا.
يشغّل Brandrail أيضًا خدمة مستضافة بحسابات ومفاتيح API. وتصف صفحة الأمان الخاصة به هذا الجانب:
- مفاتيح API: لا يُخزَّن سوى تجزئة SHA-256. المفاتيح محددة النطاق، وتنتهي صلاحيتها بعد 90 يومًا، وتُظهر آخر وقت استُخدمت فيه، ويسري إلغاء أي مفتاح فورًا.
- التشفير: تستخدم البيانات أثناء النقل TLS 1.2 أو أعلى في كل مكان، مع تفعيل HSTS. ويشفّر مزوّد قاعدة البيانات لدى Brandrail البيانات المخزّنة باستخدام AES-256.
- الاعتماد: عند سؤاله عن الاعتماد الرسمي، يجيب Brandrail: «ليس بعد». ويعرض استكمال استبيانات الأمان ويمكنه توقيع اتفاقية معالجة بيانات.
استفد من عرض الاستبيان واتفاقية معالجة البيانات للحصول على تأكيد مكتوب حول كيفية التعامل مع بيانات الحساب المستضاف وحزمة العلامة التجارية. ثم تحقق بنفسك من ادعاء العمل المحلي فقط بمراقبة حركة الشبكة أثناء فحص محلي، وهي العناية الواجبة نفسها التي تطبقها على أي أداة مطورين.
Brandrails: ملفات وكيل مختصرة تشير إلى رموز التصميم لديك
يحافظ Brandrails على صغر الملفات المحمّلة دائمًا: إذ يسرد AGENTS.md وتعليمات Copilot أسماء الرموز فقط ويشيران إلى design/tokens.md. وبهذا لا يزاحم نظام تصميم كبير بقية سياق الوكيل.
أما ملف الرموز نفسه، فقد تجد الفرق فائدة في صيغة مشتركة. تصف مجموعة مجتمع W3C لرموز التصميم نفسها بأنها مجتمع من المصممين والمطورين ومورّدي الأدوات يعمل على توحيد طريقة تعريف رموز التصميم وتبادلها. نقترح التحقق من البنية التي يتوقعها Brandrails للرموز قبل أن تستقر على صيغة، وتفضيل صيغة قياسية حيثما سمحت أدواتك، كي يغذي الملف نفسه أدوات أخرى.
نقترح أيضًا إضافة فحص لانحراف رموز التصميم عند طلب السحب يرصد القيم المثبّتة في الشيفرة التي كان ينبغي أن تكون رموزًا. فملفات الوكيل المختصرة توجّه الوكيل قبل التوليد، وفحص CI يدعم هذا التوجيه بخطوة لا يستطيع الوكيل تخطيها.
يذكر DesignSystems.one أن Claude Code لا يقرأ AGENTS.md، ويصف ذلك بأنه الافتراض الخاطئ الأكثر شيوعًا في هذه الفئة. ويقول DesignSystems.one أيضًا إن الرواية القائلة بأن AGENTS.md قد حلّ محل CLAUDE.md لا تدعمها أعداد الملفات، وإن CLAUDE.md في المقدمة. ومع انتشار الاصطلاحين على نطاق واسع، نقترح دعم كليهما افتراضيًا.
Modern Web Guidance: منع الوكلاء من كتابة شيفرة ويب قديمة
تشرف على Modern Web Guidance فرق Google Chrome وMicrosoft Edge وMozilla Firefox وMDN، إلى جانب مجتمع تطوير الويب. وتأتي أرقام التقييم ونتائج المتبنّين أدناه من توثيق Chrome ومدونتها، لذا نتعامل معها بوصفها أرقامًا أبلغ عنها المورّد، مع اعتماد Search Engine Journal مصدرًا رئيسيًا للتحقق المستقل.
على لوحة تقييمات Chrome، يبلغ معدل نجاح الوكلاء الموجَّهين 91% مقابل نحو 51% للنماذج الرائدة غير الموجَّهة. وحين اطلع Search Engine Journal على اللوحة، سجّل 88% للموجَّهة مقابل 56% لغير الموجَّهة.
تعرض مدونة Chrome أيضًا ثلاثة متبنّين:
- note inc.: ارتفع معدل النجاح في فحوص الويب الحديث من 61% إلى 94% عبر 180 تشغيلًا. وجاءت المكاسب من توجيه الوكلاء نحو ميزات HTML وCSS الأصلية بدلًا من JavaScript المخصصة لرسوم التمرير المتحركة وتلميحات الأدوات والأكورديونات.
- WeTV: انخفض وقت تصحيح الأخطاء وحلها بنسبة 87%، من أربع ساعات إلى 30 دقيقة. ويُذكر أن الوكيل يشخّص 90% من فحوص الأداء الفاشلة ويصلحها تلقائيًا، ويشمل رقم الأربع ساعات إلى 30 دقيقة التقييم اليدوي.
- MetaMask: راجع روبوت مراجعة نحو 480 طلب سحب، وعلّق على 64 منها، وشهد إصلاح 43 ملاحظة. وكانت معظم الملاحظات مشكلات في إمكانية الوصول ودلالات HTML والنماذج لا ترصدها أدوات التدقيق (linters)، بوسيط 15 دقيقة من التعليق حتى الإصلاح.
وأفاد Search Engine Journal بشكل منفصل بأن روبوت MetaMask رصد 102 مشكلة عبر 57 طلب سحب للميزات والإصلاحات في أسابيعه الخمسة الأولى.
يُظهر اختبار LogRocket نوع الخطأ الذي تستهدفه الحزمة، باستخدام تفاعل تصفية في React يبدو فيه التخزين المؤقت للنتائج (memoisation) الحل البديهي. وكما يوضح LogRocket، يتجنب useMemo إعادة الحساب غير الضرورية عبر عمليات العرض، لكنه لا يجعل عملية التصفية غير حاجبة، وهذا ما يهم لمقياس Interaction to Next Paint (INP). نقترح قراءة مثال LogRocket توضيحًا للإخفاق لا دليلًا على الإصلاح.
كيفية الجمع بين الأدوات الثلاث: دليل عمليات التصميم
يعمل النموذج على أفضل وجه حين يكون لكل مسار مهمة واحدة ومالك واحد، وحين لا يعتمد الإنفاذ على تذكّر الوكيل لتعليماته.
الخطوة 1: اجعل ملف الرموز مصدر الحقيقة
عرّف الرموز أو صدّرها في ملف واحد، ويُفضَّل أن يكون بصيغة قياسية مثل DTCG، وأودعها في المستودع مع تحديد مالك بالاسم. وجّه ملفات الوكيل المختصرة إلى ذلك الملف، وهو النمط الذي يستخدمه Brandrails. وتأكد قبل المرحلة التجريبية مما إذا كان Brandrail قادرًا على استيراد ملف الرموز مباشرة. فإن لم يكن قادرًا، فحدّث حزمة العلامة التجارية في التغيير نفسه مع الرموز، واجعل مالك الرموز مسؤولًا عن كليهما.
الخطوة 2: أبقِ ملفات الوكيل مختصرة وغطِّ كل وكيل
ينبغي أن تحتوي الملفات المحمّلة دائمًا على أسماء الرموز مع إشارة إلى المرجع الكامل للرموز، وهو النمط الذي يستخدمه Brandrails. ولأن Claude Code لا يقرأ AGENTS.md، أقرن ملف AGENTS.md المختصر بملف CLAUDE.md يستورده. وهكذا يعمل كل وكيل وفق القواعد نفسها.
الخطوة 3: أضف إرشادات المنصة
ثبّت Modern Web Guidance لكل وكيل مستخدم، كي يفضّل الوكلاء HTML وCSS الأصليين على JavaScript المخصصة في الأنماط الشائعة مثل تلميحات الأدوات والأكورديونات ورسوم التمرير المتحركة.
الخطوة 4: أغلق حلقة التوليد
اربط خادم MCP المحلي الخاص بـ Brandrail كي يحصل الوكيل على حزمة العلامة التجارية أولًا، واجعل validate_snippet جزءًا من تعريف الإنجاز: استدعاء واحد، وكل ملف تغيّر، وإصلاح كل خطأ وتحذير.
الخطوة 5: ضع البوابة عند طلب السحب
شغّل أدوات الفحص في CI لإخراج الإنفاذ من يد الوكيل، لكن لا تجعل كل شيء حاجبًا منذ اليوم الأول.
- فحص انحراف رموز التصميم: حاجب. فالقيمة إما أن تطابق رمزًا أو لا تطابقه. نقترح فرضه على الأسطر المتغيرة منذ البداية، باستخدام أي أداة تدقيق للرموز تدعمها حزمة تقنياتك.
- أداة فحص Brandrail CLI: استشارية أولًا. خلال المرحلة التجريبية، سجّل درجات العلامة التجارية لكل طلب سحب دون حجب. وبمجرد أن يتوفر لديك خط أساس، احجب عند الأخطاء واترك التحذيرات استشارية. وحدّد أي حد أدنى لدرجة العلامة التجارية من بيانات مرحلتك التجريبية الخاصة.
- النتائج الإيجابية الكاذبة. لا تسمح بالاستثناءات إلا مع سبب مكتوب وموافِق محدد بالاسم. وإذا استمرت قاعدة ما في الإطلاق الخاطئ، فأصلح الرمز أو القاعدة بدلًا من كتمها مرة أخرى.
- روبوت المراجعة: استشاري. يمكن لروبوت مثل روبوت MetaMask أن يرصد مشكلات الدلالات والنماذج وإمكانية الوصول بينما يقرر البشر ما يجب إصلاحه.
الخطوة 6: أبقِ إمكانية الوصول بيد البشر
الخطوة 7: قِس التكلفة وزمن الاستجابة
كانت عمليات التشغيل مع تفعيل Modern Web Guidance عادةً أبطأ واستهلكت عددًا أكبر من رموز النموذج (tokens). قِس استهلاك رموز النموذج وزمن التشغيل قبل المرحلة التجريبية وبعدها.
أخطاء شائعة في ضوابط شيفرة واجهات الذكاء الاصطناعي
التعامل مع نظام تصميم جاهز للوكلاء على أنه ضمان. يفيد DesignSystems.one بأن نظام التصميم Astryx الخاص بـ Meta حصل على 87 إجمالًا في المقياس المرجعي الليلي لدى Meta، وهو أقل من خط أساس shadcn/ui عادي. اقرأ النتيجة بوصفها مؤشرًا على الاتجاه لا على الحجم، وأبقِ بوابات CI على الواجهات المولَّدة حتى عندما يوصف نظام تصميم بأنه جاهز للوكلاء.
الخلط بين التوافق مع العلامة التجارية وإمكانية الوصول. وجدت دراسة يُذكر أنها عُرضت في CHI 2026 عدد 541 مشكلة عبر 300 واجهة مولَّدة، أي نحو 1.8 لكل واجهة، تتصدرها تسميات الأزرار العامة ونصوص الروابط المبهمة والنص البديل الضعيف، تليها مشكلات ARIA وتسميات حقول النماذج. لم نتمكن من التحقق من عنوان الورقة أو مؤلفيها، ما يجعل الأرقام استرشادية لا قاطعة، ولا يندرج أي نوع من هذه المشكلات ضمن ما تفحصه درجة العلامة التجارية.
تحفظات: ما تُظهره الأدلة وما لا تُظهره
معظم أرقام Modern Web Guidance مصدرها Chrome. رقم 91% الرئيسي مصدره لوحة Chrome، ونتائج المتبنّين مصدرها شركات اختارت Chrome إبرازها. وأظهرت اللقطة المنفصلة لـ Search Engine Journal، المذكورة أعلاه، فجوة أضيق. يشير كلاهما في الاتجاه نفسه، لكن حجم الأثر يعتمد على توقيت القياس وطريقته، ولهذا تحتاج درجات المقاييس المرجعية إلى بروتوكول تقييم معلن قبل مقارنتها.
الإرشادات لا تغني عن الاختبار. في مراجعة منشورة، وجد مستشار إمكانية الوصول Adrian Roselli أن مخرجات النسخة التجريبية الأولية لم تكن متوافقة مع WCAG وأن الرسوم المتحركة فيها لم تعمل في Firefox.
تعامل مع ادعاءات Brandrail وBrandrails على أنها غير مختبرة حتى تختبرها بنفسك. ما يقوله هذا المقال عن المشروعين مصدره توثيق المشروعين ومقالات أطراف ثالثة، لذا نقترح التحقق من سلوكهما على قاعدة الشيفرة لديك خلال المرحلة التجريبية.
ملفات التعليمات والأسماء تختلف بين الوكلاء والمشاريع. وفقًا لـ DesignSystems.one، لا يقرأ Claude Code ملف AGENTS.md. قبل التوحيد، أعد التحقق من ملفات التعليمات التي يحمّلها كل وكيل لديك وتأكد من كل عنوان مستودع.
النقاط الرئيسية
- يقسّم نموذج المسارات الثلاثة انحراف واجهات الذكاء الاصطناعي إلى العلامة التجارية، ورموز التصميم والقواعد، والمنصة. وتركّز كل من Brandrail وBrandrails وModern Web Guidance على مسار واحد.
- اجعل ملف رموز واحدًا مصدر الحقيقة واشتقّ منه حزمة العلامة التجارية في Brandrail، فهذا يمنع الفحوص من الإبلاغ عن مخالفات متعارضة.
- اجعل فحص انحراف رموز التصميم حاجبًا مبكرًا، وشغّل أداة فحص Brandrail CLI بصفة استشارية حتى تمنحك بيانات المرحلة التجريبية خط أساس لدرجة العلامة التجارية.
- يقول Brandrail إن الشيفرة تُفحص محليًا ولا تُرفع أبدًا. وهو غير معتمد رسميًا بعد، لذا احصل على تأكيد مكتوب حول كيفية التعامل مع بيانات الحساب المستضاف وحزمة العلامة التجارية.
- لا يقرأ Claude Code ملف AGENTS.md أصلًا. أقرن ملف AGENTS.md مختصرًا بملف CLAUDE.md يستورده.
- تفيد Chrome بمعدل 91% للموجَّهة مقابل نحو 51% لغير الموجَّهة. وأظهرت اللقطة المنفصلة لـ Search Engine Journal نسبة 88% مقابل 56%، أي فجوة أضيق.
- لا يغطي أي مسار بمفرده إمكانية الوصول أو السلوك عبر المتصفحات، وعادةً ما تكلّف عمليات التشغيل الموجَّهة رموزًا ووقتًا أكثر.
الخلاصة
في أول مرحلة تجريبية، اختر مجالًا واحدًا من المنتج وعيّن لكل مسار مالكًا واحدًا. سجّل عناوين المستودعات الدقيقة لكل من Brandrail وBrandrails، واجعل ملف رموز واحدًا مصدر الحقيقة، وأبقِ ملفات الوكيل المحمّلة دائمًا مختصرة، مع ملف CLAUDE.md إلى جانب ملف AGENTS.md المختصر. اجعل فحص انحراف رموز التصميم حاجبًا على الأسطر المتغيرة، وشغّل أداة فحص Brandrail CLI بصفة استشارية حتى يتوفر لديك خط أساس، وتحقق من حدود البيانات في Brandrail بفحص للشبكة أثناء تشغيل محلي. قِس استهلاك رموز النموذج وزمن التشغيل قبل تفعيل Modern Web Guidance وبعده، وتعامل مع الأرقام التي يبلّغ عنها المورّدون بوصفها فرضية تختبرها على قاعدة الشيفرة لديك. وأبقِ مراجعة إمكانية الوصول والتوافق عبر المتصفحات بيد البشر طوال الوقت.
قراءات ذات صلة على Optijara: Playwright وaxe عبر حالات واجهة المستخدم الحقيقية وتتبّع OpenTelemetry GenAI لعمليات تشغيل الوكلاء.
الأسئلة الشائعة
ما المقصود بضوابط شيفرة واجهات الذكاء الاصطناعي؟
هي أدوات وفحوص تُبقي واجهات المستخدم التي يولّدها وكلاء البرمجة مثل Claude Code أو Cursor أو Copilot أو Codex متسقة مع نظام التصميم لديك ومع الممارسات الحالية للويب. وفي نموذج المسارات الثلاثة المستخدم هنا، يغطي Brandrail مسار العلامة التجارية، ويغطي Brandrails رموز التصميم وملفات تعليمات الوكيل المختصرة، وتغطي Modern Web Guidance مسار المنصة.
هل Brandrail وBrandrails مشروع واحد؟
لا. Brandrail (github.com/brandrail-app/brandrail) هو خادم MCP وأداة فحص يزوّد الوكلاء بحزمة العلامة التجارية ويعيد درجة للعلامة التجارية. أما Brandrails (github.com/matejholek/brandrails) فأداة منفصلة تسرد ملفات الوكيل المحمّلة دائمًا الخاصة بها أسماء الرموز فقط وتشير إلى مرجع أشمل للرموز. احرص دائمًا على الإشارة إلى عنوان المستودع الدقيق والتثبيت منه.
إذا تعارض Brandrail وBrandrails، فأيهما يُعتمد؟
احسم ذلك قبل المرحلة التجريبية. والقاعدة العملية هي أن ملف الرموز في مستودعك هو مصدر الحقيقة، وأن حزمة العلامة التجارية في Brandrail مشتقة منه. وإذا تعذّر توليد حزمة العلامة التجارية من الرموز، فحدّثها في التغيير نفسه وحمّل مالكًا واحدًا مسؤولية كليهما.
هل يرفع Brandrail الشيفرة المصدرية الخاصة بي؟
يذكر Brandrail أن خادم MCP الخاص به يعمل محليًا عبر stdio، وأن الشيفرة تُفحص على جهازك ولا تُرفع أبدًا. أما خدمة الحسابات المستضافة فمسألة منفصلة. راجع القسم الخاص بما يبقيه Brandrail محليًا لمعرفة ما ينبغي تأكيده كتابيًا وكيفية التحقق من هذه الحدود بفحص للشبكة.
هل يقرأ Claude Code ملف AGENTS.md، أم أحتاج إلى ملف CLAUDE.md أيضًا؟
لا يقرأ Claude Code ملف AGENTS.md أصلًا. تحتاج إلى ملف CLAUDE.md يستورد تلك القواعد أو يعكسها. ويفيد DesignSystems.one بأن أعداد الملفات لا تدعم فكرة أن AGENTS.md قد حلّ محل CLAUDE.md، لذا نقترح دعم كليهما افتراضيًا.
هل أحتاج إلى الأدوات الثلاث، أم بأيها ينبغي أن يبدأ الفريق؟
ابدأ بالمسار الذي ينشأ منه الانحراف لديك. فإذا كانت الشاشات المولَّدة تتجاهل ألوانك ومسافاتك، فابدأ بمسار رموز التصميم (Brandrails) أو مسار العلامة التجارية (Brandrail). وإذا كانت الشيفرة تعمل لكنها تعتمد على أنماط قديمة، فابدأ بـ Modern Web Guidance. سينتهي المطاف بكثير من الفرق إلى الجمع بينها، لكن تجربة مسار واحد أولًا تجعل قياس الأثر أسهل.
هل تجعل Modern Web Guidance واجهات الذكاء الاصطناعي متاحة ومتوافقة عبر المتصفحات بمفردها؟
لا. فهي ترفع المستوى الأساسي للشيفرة المولَّدة، لكن إمكانية الوصول والتوافق عبر المتصفحات ما زالا بحاجة إلى اختبار. وقد وجدت مراجعة مستقلة للنسخة التجريبية الأولية مشكلات في كلا المجالين. أبقِ اختبارات إمكانية الوصول الآلية والمراجعة البشرية للتوافق عبر المتصفحات ضمن مسار العمل.
المصادر
- https://github.com/brandrail-app/brandrail
- https://www.brandrail.com.au/security
- https://glama.ai/mcp/connectors/au.com.brandrail/brandrail/tools/validate_snippet
- https://techbytes.app/posts/brandrail-make-claude-code-and-cursor-follow-your-design-system/
- https://github.com/matejholek/brandrails
- https://www.designtokens.org/
- https://www.designsystems.one/ai-ready/agent-files
- https://developer.chrome.com/docs/modern-web-guidance
- https://developer.chrome.com/blog/modern-web-guidance-v1
- https://github.com/GoogleChrome/modern-web-guidance
- https://blog.logrocket.com/chromes-modern-web-guidance-prevent-ai-coding-agents/
- https://www.searchenginejournal.com/google-releases-modern-web-guidance-1-0-for-ai-coding-agents/596495/



