لا يستطيع وكيل برمجة بالذكاء الاصطناعي اتباع مرجع بصري إلا بقدر وضوح القرارات فيه. إذا كنت تملك المشروع ولديك قواعد معتمدة للعلامة، فاجمعها في ملف قابل للمراجعة باسم DESIGN.md ، ثم استخدم Claude Code في تعديلين صغيرين تفحصهما بنفسك. المخرج المطلوب هو مواصفاتك المعتمدة. يتحقق التعديلان من فائدتها في هذين العملين تحديدًا؛ ولا يثبتان كيف سيكون أي تعديل لاحق.

هذا إجراء مستند إلى الوثائق. راجعت BIG CHANGE مجموعة ملفات تصميم مثبتة على مراجعة محددة وأدلة Claude Code من Anthropic في 20 أكتوبر 2026. لم نشغّل Claude Code، ولم نعدّل العملين أو نعرضهما، ولم نقِس التكلفة أو جودة التصميم.

التغيير الرئيسي

  • ما الذي تغيّر: يستطيع المالك كتابة مواصفات بصرية ذات إصدار من قرارات معتمدة، وإعطاء Claude Code هذا الملف المحدد قبل تعديل محدود.
  • لماذا يهم: يتيح مصدر واحد متحقق منه مقارنة قواعد الألوان والخطوط والتخطيط بمراجعتين فعليتين، بينما يقرر المالك مدى قبول كل نتيجة.
  • ما ينبغي الانتباه إليه: يجب قراءة الملف كاملًا قبل كل تعديل. وجوده في المشروع أو ذكر مساره أو تأكيد Claude لا يثبت أنه حُمّل أو اتُّبع.

قبل البدء

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

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

أعِدّ Claude Code بحساب أو مزوّد مؤهل، وراجع شروط استخدام البيانات و أذونات الأدوات للحساب قبل كشف شيفرة أو نصوص أو مواد خاصة. قد يرسل مشروع مخزن محليًا محتوى إلى خدمة نماذج. تحقق ممن يمكنه رؤية المواد، وأي أدوات تستطيع قراءة الملفات أو تغييرها، وهل يجوز لك إرسال كل عنصر. تعتمد إرشادات التكلفة على الحساب والمزوّد؛ ولا يستطيع هذا الدليل تحديد سعر ثابت لجلستك.

هذه المجموعة المثبتة من Awesome DESIGN.md مصدر إلهام اختياري لأقسام الملف. فهي تحلل مواقع عامة، وليست دليل علامة اعتمده المالك. يمكنك كتابة الملف مباشرة من قراراتك المعتمدة. إذا نسخت نصًا من المستودع، فاحتفظ بـ إشعار حقوق النشر والإذن MIT. لا يمنح هذا الإشعار حقوقًا في علامات موقع آخر أو ملفات خطوطه أو صوره.

أنشئ المرجع المعتمد من المالك

  1. أنشئ brand-reference/DESIGN.md في مشروعك. املأ هذا الهيكل الأدنى من سجل الاعتماد. يحدد النص بين الأقواس المعلومات التي يجب أن يوفرها المالك؛ وليس علامة مقترحة. أبقِ العنصر موسومًا بـ UNRESOLVED حتى يقرره المالك. لا تطلب من Claude اختراع قيمة لسد نقص.
Markdown
# Visual specification

Owner: [owner or approving role]
Approved version/date: [version and approval date, or UNRESOLVED]
Audience and artifact purpose: [owner-approved description]
Approval evidence: [internal record or location, without private data in a shared copy]

## Color roles and values
- Background: [approved value and color format, or UNRESOLVED]
- Text: [approved value and color format, or UNRESOLVED]
- Primary action: [approved value and color format, or UNRESOLVED]
- Link, border and status roles: [each approved value, or UNRESOLVED]

## Typography and scale
- Heading family and permitted fallback: [approved names, or UNRESOLVED]
- Body family and permitted fallback: [approved names, or UNRESOLVED]
- Heading/body sizes, weights and line heights: [approved scale, or UNRESOLVED]
- Font license or use restriction: [approved terms, or UNRESOLVED]

## Spacing and layout
- Spacing scale, content width and grid: [approved values, or UNRESOLVED]
- Target artifact dimensions: [approved sizes, or UNRESOLVED]

## Components and states
- Buttons, links, inputs and navigation: [approved appearance and behavior]
- Hover, focus, disabled and error states: [approved rules, or UNRESOLVED]

## Responsive and accessibility rules
- Desktop/phone behavior and breakpoints: [approved rules, or UNRESOLVED]
- Contrast, readable type, focus order and touch use: [approved requirements]

## Assets and forbidden substitutions
- Permitted logo/image assets and usage: [approved paths and permissions]
- Do not substitute: [owner-approved prohibited colors, fonts, marks or patterns]

## Owner approval and changes
- Approved by: [person or role and date, or UNRESOLVED]
- Version: [version]
- Changelog: [date, change, approver]
- Unresolved decisions: [list, or "none" after owner review]
  1. قارن كل سطر مكتمل بقرارات المالك الأصلية، بما فيها حقوق استخدام الخطوط والصور. عالج مع المالك تعارض أنماط المشروع القديمة مع القواعد المعتمدة الحالية. اطلب اعتماد هذا الملف تحديدًا وسجّل إصداره. أوقف أي تعديل يعتمد على قيمة غير محسومة. احفظ الملف المعتمد والعملين الأصليين في نظام التحكم بالإصدارات أو نسخة أخرى قابلة للاستعادة.

استخدم الملف في تعديلين محدودين

  1. في مشروعك، ابدأ جلسة Claude Code بالحساب والأذونات اللذين تحققت منهما. أعطِ المسارين الدقيقين إلى brand-reference/DESIGN.md والعمل الأول. اطلب أولًا من Claude قراءة المرجع كاملًا والعمل، ثم التوقف قبل التحرير. افحص نتيجة القراءة الفعلية للملف أو الأداة للتأكد من صحة المسار واكتمال المحتوى. لا تكفي قراءة مرفوضة أو نتيجة مبتورة أو مجرد ذكر مسار أو ملخص شفهي. توثّق Anthropic ملفات تعليمات المشروع بوصفها خيار إعداد منفصلًا؛ فلا تفترض اكتشاف أي ملف DESIGN.md تلقائيًا أو تعتمد على أن مرجع @ يتصرف بالطريقة نفسها بين الإصدارات.
  2. بعد ظهور القراءة الكاملة، اطلب التغيير البصري الواحد المختار للعمل الأول باستخدام القواعد المعتمدة فقط. احصر الملفات المتأثرة، وحافظ على النصوص والروابط وعناصر التحكم والشيفرة غير المرتبطة. اطلب رؤية الفروق المقترحة وطريقة المشروع القائمة لعرض العمل. افحص كل ملف متغير قبل قبوله. ارفض الألوان أو الخطوط أو المواد أو الاعتماديات أو التعديلات الإضافية غير المعتمدة.
  3. اعرض العمل الأول باستخدام إجراء المشروع الفعلي. قارن الناتج بالملف المعتمد والعمل الأصلي بأحجام حاسوب وهاتف تناسب المشروع. تحقق من قيم الرموز التصميمية في الملفات المتغيرة، والتباين المقروء، وتسلسل العناوين والخطوط، والقص أو التجاوز الأفقي، والتركيز المرئي، ولوحة المفاتيح والتفاعلات المتأثرة، وبقاء النصوص والروابط دون تغيير. سجّل إصدار المرجع ومراجعة العمل والفحوص وأي تصحيح. وصف العرض ليس النتيجة المعروضة.
  4. للعمل الثاني، حدّد مرة أخرى مساره الدقيق و brand-reference/DESIGN.md. اطلب قراءة كاملة جديدة قبل تعديله وافحص نتيجة أداة القراءة. ثم اطلب تغييرًا محدودًا واحدًا، وراجع الفروق، واعرضه بطريقة العمل الثاني الخاصة، وكرّر الفحوص نفسها. قارن المراجعتين بـ إصدار الملف المعتمد نفسه. سجّل كل قاعدة على أنها متبعة أو فائتة أو تتطلب مراجعة يعتمدها المالك؛ وأصلح الانحراف وأعد فحص العملين إذا تغير المرجع.

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

لمهمة مختلفة تستخدم ملف مجتمع مرجعًا لصفحة واحدة، راجع دليلنا لملف DESIGN.md المثبت على مراجعة. مهمة هذا الدليل هي إنشاء مواصفاتك الخاصة واعتمادها أولًا.

المصادر وقراءات إضافية