نسخة Markdown

AI-translated from English; not yet reviewed by a fluent editor.

# أنشئ ملف DESIGN.md معتمدًا من المالك لاستخدامه مع Claude Code

> اكتب مواصفات بصرية من قرارات العلامة المعتمدة، ثم استخدمها في تعديلين صغيرين مع Claude Code وافحص الفروق والنتائج المعروضة.

By BIG CHANGE Editorial

Published: 2026-10-20T01:05:55.739Z
Updated: 2026-10-20T01:05:55.739Z
Canonical: https://bigchange.ai/blog/claude-code-owner-approved-design-md-guide

![Conceptual charcoal illustration of a small visual reference clipped to a wall rail above two separate framed layout proofs.](https://bigchange.ai/api/media/file/owner-approved-design-reference-two-proofs-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE.

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

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

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

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

## قبل البدء

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

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

أعِدّ [Claude Code](https://code.claude.com/docs/en/quickstart) بحساب أو مزوّد مؤهل، وراجع [شروط استخدام البيانات](https://code.claude.com/docs/en/data-usage) و [أذونات الأدوات](https://code.claude.com/docs/en/permissions) للحساب قبل كشف شيفرة أو نصوص أو مواد خاصة. قد يرسل مشروع مخزن محليًا محتوى إلى خدمة نماذج. تحقق ممن يمكنه رؤية المواد، وأي أدوات تستطيع قراءة الملفات أو تغييرها، وهل يجوز لك إرسال كل عنصر. تعتمد [إرشادات التكلفة](https://code.claude.com/docs/en/costs) على الحساب والمزوّد؛ ولا يستطيع هذا الدليل تحديد سعر ثابت لجلستك.

هذه [المجموعة المثبتة من Awesome DESIGN.md](https://github.com/VoltAgent/awesome-design-md/blob/3b605329240ce735b510037cca322f1831fdd7f8/README.md) مصدر إلهام اختياري لأقسام الملف. فهي تحلل مواقع عامة، وليست دليل علامة اعتمده المالك. يمكنك كتابة الملف مباشرة من قراراتك المعتمدة. إذا نسخت نصًا من المستودع، فاحتفظ بـ [إشعار حقوق النشر والإذن MIT](https://github.com/VoltAgent/awesome-design-md/blob/3b605329240ce735b510037cca322f1831fdd7f8/LICENSE). لا يمنح هذا الإشعار حقوقًا في علامات موقع آخر أو ملفات خطوطه أو صوره.

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

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]
```

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

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

3. في مشروعك، ابدأ جلسة Claude Code بالحساب والأذونات اللذين تحققت منهما. أعطِ المسارين الدقيقين إلى `brand-reference/DESIGN.md` والعمل الأول. اطلب أولًا من Claude قراءة المرجع **كاملًا** والعمل، ثم التوقف قبل التحرير. افحص نتيجة القراءة الفعلية للملف أو الأداة للتأكد من صحة المسار واكتمال المحتوى. لا تكفي قراءة مرفوضة أو نتيجة مبتورة أو مجرد ذكر مسار أو ملخص شفهي. توثّق Anthropic [ملفات تعليمات المشروع](https://code.claude.com/docs/en/memory) بوصفها خيار إعداد منفصلًا؛ فلا تفترض اكتشاف أي ملف `DESIGN.md` تلقائيًا أو تعتمد على أن مرجع `@` يتصرف بالطريقة نفسها بين الإصدارات.
4. بعد ظهور القراءة الكاملة، اطلب التغيير البصري الواحد المختار للعمل الأول باستخدام القواعد المعتمدة فقط. احصر الملفات المتأثرة، وحافظ على النصوص والروابط وعناصر التحكم والشيفرة غير المرتبطة. اطلب رؤية الفروق المقترحة وطريقة المشروع القائمة لعرض العمل. افحص كل ملف متغير قبل قبوله. ارفض الألوان أو الخطوط أو المواد أو الاعتماديات أو التعديلات الإضافية غير المعتمدة.
5. اعرض العمل الأول باستخدام **إجراء المشروع الفعلي**. قارن الناتج بالملف المعتمد والعمل الأصلي بأحجام حاسوب وهاتف تناسب المشروع. تحقق من قيم الرموز التصميمية في الملفات المتغيرة، والتباين المقروء، وتسلسل العناوين والخطوط، والقص أو التجاوز الأفقي، والتركيز المرئي، ولوحة المفاتيح والتفاعلات المتأثرة، وبقاء النصوص والروابط دون تغيير. سجّل إصدار المرجع ومراجعة العمل والفحوص وأي تصحيح. وصف العرض ليس النتيجة المعروضة.
6. للعمل الثاني، حدّد مرة أخرى مساره الدقيق و `brand-reference/DESIGN.md`. اطلب قراءة كاملة جديدة **قبل** تعديله وافحص نتيجة أداة القراءة. ثم اطلب تغييرًا محدودًا واحدًا، وراجع الفروق، واعرضه بطريقة العمل الثاني الخاصة، وكرّر الفحوص نفسها. قارن المراجعتين بـ **إصدار الملف المعتمد نفسه**. سجّل كل قاعدة على أنها متبعة أو فائتة أو تتطلب مراجعة يعتمدها المالك؛ وأصلح الانحراف وأعد فحص العملين إذا تغير المرجع.

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

لمهمة مختلفة تستخدم ملف مجتمع مرجعًا لصفحة واحدة، راجع [دليلنا لملف DESIGN.md المثبت على مراجعة](https://bigchange.ai/blog/claude-code-pinned-design-reference-page-guide). مهمة هذا الدليل هي إنشاء مواصفاتك الخاصة واعتمادها أولًا.

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

- هذا [README المثبت لمجموعة Awesome DESIGN.md](https://github.com/VoltAgent/awesome-design-md/blob/3b605329240ce735b510037cca322f1831fdd7f8/README.md) يوفر أقسامًا نموذجية ويصف ملفاته بأنها تحليلات لمواقع عامة تُقدم كما هي. عباراته عن جودة المخرجات ليست نتيجة اختبرناها هنا. تنظم [رخصة MIT](https://github.com/VoltAgent/awesome-design-md/blob/3b605329240ce735b510037cca322f1831fdd7f8/LICENSE) مواد المستودع المنسوخة، لا هوية الأطراف الأخرى أو موادها.
- يغطي [دليل البدء السريع من Anthropic](https://code.claude.com/docs/en/quickstart) إعداد الحساب والمشروع. وتشرح [إجراءات العمل الشائعة](https://code.claude.com/docs/en/common-workflows) و [دليل ذاكرة المشروع](https://code.claude.com/docs/en/memory) إجراءات الملفات والتعليمات؛ ولا يثبت أي منهما قراءة هذا الملف المستقل كاملًا في جلسة القارئ.
- تشرح أدلة Anthropic حول [الأذونات](https://code.claude.com/docs/en/permissions) و [استخدام البيانات](https://code.claude.com/docs/en/data-usage) و [التكلفة](https://code.claude.com/docs/en/costs) وسائل التحكم والشروط المرتبطة بالحساب. لا تثبت تعديلًا مرصودًا أو معالجة محلية فقط أو فاتورة ثابتة أو تحسنًا في الجودة لهذا الدليل.

## Sources

- [README المثبت لمجموعة Awesome DESIGN.md](https://github.com/VoltAgent/awesome-design-md/blob/3b605329240ce735b510037cca322f1831fdd7f8/README.md) — مجموعة مجتمع مثبتة على مراجعة وأقسام نموذجية لمرجع تصميم. تحلل مواقع عامة وتقدم ملفات كما هي؛ ولا تثبت عباراتها الترويجية عن جودة النتائج والاستخدام الفوري نتائج هذا المالك أو اعتماد العلامات المعروضة. نسخة المصدر الخاصة الكاملة والتحقق المستقل موجودان في حزمة قبول الموضوع المعتمدة.
- [رخصة MIT لمجموعة Awesome DESIGN.md](https://github.com/VoltAgent/awesome-design-md/blob/3b605329240ce735b510037cca322f1831fdd7f8/LICENSE) — يجب إبقاء إشعار حقوق النشر والإذن للمراجعة المثبتة من المستودع مع النص المنسوخ أو أجزائه الجوهرية. لا يمنح وحده حقوقًا في اسم الموقع المعروض أو علامته التجارية أو شعاره أو خطوطه المملوكة أو صوره.
- [البدء السريع مع Claude Code](https://code.claude.com/docs/en/quickstart) — متطلبات الحساب أو المزوّد وتسجيل الدخول والمشروع الرسمية. لم تختبر BIG CHANGE تثبيتًا أو وصولًا أو جلسة Claude لهذا الدليل.
- [إجراءات العمل الشائعة في Claude Code](https://code.claude.com/docs/en/common-workflows) — إجراءات ملفات المشروع ومراجعة التغييرات الرسمية. يتطلب الدليل قراءة كاملة مرصودة وفروقًا فعلية لكل عمل بدل الاعتماد على اختصارات مراجع الملفات المتأثرة بالإصدار.
- [ذاكرة مشروع Claude Code](https://code.claude.com/docs/en/memory) — يوثّق تعليمات المشروع والاستيرادات الاختيارية بوصفها إعدادًا. لا يثبت تحميل brand-reference/DESIGN.md المستقل تلقائيًا أو اتباع أي من تعديلي القارئ له.
- [أذونات Claude Code](https://code.claude.com/docs/en/permissions) — وسائل التحكم الرسمية بأذونات الأدوات. موافقة المالك على محتوى العلامة وتعليمات الطلب إلى Claude منفصلتان عن صلاحية الملفات أو الأدوات الفعلية وعن الإذن بإرسال مواد خاصة.
- [استخدام البيانات في Claude Code](https://code.claude.com/docs/en/data-usage) — تعتمد المعالجة والاحتفاظ على الحساب والمزوّد. المشروع المحلي لا يثبت جلسة نموذج محلية فقط؛ وعلى القارئ التحقق من الحقوق قبل تقديم محتوى خاص.
- [تكاليف Claude Code](https://code.claude.com/docs/en/costs) — إرشادات الاستخدام والفوترة الرسمية حسب الحساب والمزوّد. لم يُقَس سعر ثابت أو حصة مجانية أو توفير وقت أو تكلفة مهمة لهذا الإجراء.
- [BIG CHANGE: استخدم مرجع DESIGN.md مثبتًا على مراجعة في Claude Code لصفحة واحدة](https://bigchange.ai/blog/claude-code-pinned-design-reference-page-guide) — تغطية مرتبطة للسياق عن تطبيق مرجع مجتمع مثبت على مراجعة على صفحة قائمة. لا تكتب مواصفات معتمدة خاصة بالمالك، وليست مصدر خطوات هذا الدليل الجديدة أو متابعة في «In this story».