سلّم الاتجاه إلى وكيل البرمجة
حزمة التسليم المحصورة في نطاق الصفحة، DIRECTION.md وBUILD-PROMPT.md وREVIEW.md وDESIGN.md وقواعد Cursor وتعليمات Copilot وأقسام CLAUDE.md وAGENTS.md، وكيف تلتقطها كل أداة.
قل «سلّم هذا» (أو «قواعد Cursor لهذا»، «موجه لـ v0»). تصدر المهارة gobanana-handoff الاتجاه الذي أبقيته كملفات تقرؤها أدوات البرمجة لديك تلقائيا، وتكتبها في مستودعك.
النطاق: صفحة واحدة لا نظامك كله
Section titled “النطاق: صفحة واحدة لا نظامك كله”كل ملف محصور في نطاق الصفحة افتراضيا (scope: "page"). ينطبق على الصفحات التي تسميها فقط، ويرث نظام التصميم في مشروعك، ولا يغيره. يبدأ كل ملف بالكتلة نفسها:
Scope: one wild page, not the product design system. Applies only to: pricing page, /launch. Files:
**/pricing/**,**/pricing.*,**/launch/**,**/launch.*. This inherits the project’s own design system and its existing DESIGN.md, and does not change them. Tokens here are page level overrides: use them only inside these pages.
مرر pages كأسماء صفحات أو مسارات أو أنماط glob، حتى 5: "pricing page"، "/launch"، "app/pricing/**". تتحول الأسماء إلى أنماط مثل **/pricing/**، وتبقى المسارات والأنماط كما كتبتها.
يوجد scope: "system" لحالة تريد فيها فعلا أن يصبح الاتجاه نظام منتجك. لا تستخدمه المهارات إلا إذا قلت ذلك صراحة («اجعل هذا نظام التصميم لدينا»). عندها يذهب DESIGN.md إلى جذر المشروع وتصبح القواعد عامة.
الحزمة
Section titled “الحزمة”Directorydesign/explorations/frosted-sleeve/
- DIRECTION.md المواصفات البصرية الكاملة (المجانية)
- BUILD-PROMPT.md موجه واحد لأي أداة (المجانية)
- DESIGN.md رموز محصورة في النطاق كتجاوزات (المجانية)
- REVIEW.md قائمة فحص لـ ابنِ ثم قيّم (Pro)
- FRANKENSTEIN.md هياكل صفحات فرانكنشتاين (المجانية)
- frankenstein-wireframe.html مخطط هيكلي بصناديق رمادية (Pro)
Directorykit/
- tokens.json رموز التجاوز، بصيغة W3C DTCG (Pro)
- theme.css سمة Tailwind للصفحة (Pro)
- .cursor/rules/gobanana-frosted-sleeve.mdc قاعدة Cursor مع globs (Pro)
- .github/instructions/gobanana-frosted-sleeve.instructions.md لـ Copilot، مع applyTo (Pro)
- AGENTS.md قسم واحد معلم، يدمج (Pro)
- CLAUDE.md قسم واحد معلم، يدمج (Pro)
frosted-sleeve هو الاسم المختصر للاتجاه، مأخوذ من عنوانه.
| الملف | ما يحتويه |
|---|---|
| DIRECTION.md | النمط، والمكون المميز، والخطوط، والألوان، والتخطيط، والصور، والحركة، والملمس، والأيقونات، والكثافة، وما تأخذه، وما تتجنبه، ولماذا يناسب، وكل روابط المصادر |
| BUILD-PROMPT.md | موجه واحد تلصقه في أي مكان: الصفحات، والمنصة، والمواصفات، والقيود، ومعيار «الانتهاء». يسرد صفحات فرانكنشتاين إذا كانت على اللوحة |
| DESIGN.md | بصيغة DESIGN.md من Google Labs. الألوان في المقدمة من نوع ship فقط. يفحص بالأمر npx --yes @google/design.md@0.4.0 lint |
| REVIEW.md | قائمة فحص بنجاح أو إصلاح: بند لكل سطر في المواصفات، وكل سطر تجنب، إضافة إلى تباين WCAG 2.2 AA وحجم أهداف اللمس |
| قاعدة Cursor | القواعد، مع ضبط globs على صفحاتك، فترتبط القاعدة عندما تعدل تلك الملفات |
| تعليمات Copilot | القواعد، مع ضبط applyTo على صفحاتك |
| قسم AGENTS.md / CLAUDE.md | الصفحات المعنية، ومكان الملفات، والفرق بين ship وexplore، وعدم نسخ صور المراجع أبدا، والانتهاء عند اجتياز REVIEW.md |
كيف تلتقطها كل أداة
Section titled “كيف تلتقطها كل أداة”يقرأ Claude Code ملف CLAUDE.md في الجذر وفي المجلدات التي يعمل فيها. يشير قسم GoBanana إلى @design/explorations/<slug>/DIRECTION.md. إذا كان CLAUDE.md لديك يستورد @AGENTS.md بالفعل، فقسم AGENTS.md يكفي.
<!-- gobanana:frosted-sleeve -->## Wild page: Frosted sleeve (GoBanana)
Applies only to `app/checkout/**`. Inherits our design system. Does not change it.
When you work on these files:- Read @design/explorations/frosted-sleeve/DIRECTION.md first.- Use the token overrides in design/explorations/frosted-sleeve/DESIGN.md for these pages only.- Only `ship` colors carry text. `explore` colors are concept only.- Do not edit shared components, global CSS or tokens for this page. Make page-local variants.- Never copy reference images into the repo.- When done, grade the page against design/explorations/frosted-sleeve/REVIEW.md (gobanana-critique).<!-- /gobanana:frosted-sleeve -->لا شيء تفعله. يحتوي .cursor/rules/gobanana-<slug>.mdc على globs لصفحاتك، فعدّل ملفا مطابقا وتصبح القاعدة ضمن السياق.
لا شيء تفعله. يحتوي .github/instructions/gobanana-<slug>.instructions.md على أنماط applyTo. ولا يعدل GoBanana أبدا الملف .github/copilot-instructions.md.
يستخدم Codex وغيره من قراء AGENTS.md أقرب ملف AGENTS.md. يشير قسم GoBanana إلى DIRECTION.md.
<!-- gobanana:frosted-sleeve -->## Wild page: Frosted sleeve (GoBanana)
Applies only to: `app/checkout/**`. Inherits the project's design system. Does not change it.
- Read `design/explorations/frosted-sleeve/DIRECTION.md` before editing these files.- Token overrides for these pages: `design/explorations/frosted-sleeve/DESIGN.md`. Do not move them into the global tokens.- Colors tagged `ship` passed WCAG 2.2 contrast. Colors tagged `explore` are concept only: never put text on them.- Keep shared components unchanged. Make page-local variants inside `app/checkout/`.- Respect `prefers-reduced-motion`.- Reference images belong to their owners. Never copy them into the repo; link to the source.- Done when every item in `design/explorations/frosted-sleeve/REVIEW.md` passes.<!-- /gobanana:frosted-sleeve -->الصق BUILD-PROMPT.md في محادثة جديدة. وفي Lovable يمكنك أيضا لصقه في معرفة المشروع.
ما تفعله المهارة
Section titled “ما تفعله المهارة”- تختار الاتجاه والصفحات. من المحادثة أو من
get_canvas. وتربط أسماء الصفحات بمساراتك الحقيقية عندما ترى الكود (app/pricing/page.tsx). - تكتشف أدواتك من علامات المستودع وتذكر ما وجدته:
CLAUDE.mdأو.claude/(Claude Code)، و.cursor/(Cursor)، و.github/instructions/أوcopilot-instructions.md(Copilot)، وAGENTS.md(Codex)، وlovable-taggerفي package.json (Lovable). - تصدر باستخدام
export_kit: دائماdirection_mdوbuild_promptوreview، إضافة إلى الصيغة الخاصة بكل أداة وجدتها. - تكتب كل ملف في المسار الذي عاد به، وتنشئ المجلدات.
- تدمج في AGENTS.md وCLAUDE.md بين
<!-- gobanana:<slug> -->و<!-- /gobanana:<slug> -->. النص خارج العلامتين يبقى كما هو حرفا بحرف. وتعرض عليك الفروق. - تبلغ بقائمة الملفات وسطر واحد عن النطاق.
قواعد الدمج
Section titled “قواعد الدمج”AGENTS.mdوCLAUDE.mdلا يستبدلان أبدا. يضاف القسم المعلم أو يستبدل فقط..github/copilot-instructions.mdوملفDESIGN.mdفي الجذر والرموز والسمة وCSS العام لا تمس أبدا في نطاق الصفحة.- الملفات تحت
design/explorations/<slug>/وملفات Cursor وCopilot الخاصة بكل اسم مختصر تخص GoBanana. في التصدير الثاني يعرض الوكيل الفروق ويسأل قبل استبدالها. - لا صور مراجع في المستودع. الملفات ترتبط بالمصادر.
في الخطة المجانية
Section titled “في الخطة المجانية”review وcursor_rules وcopilot وagents_md وclaude_md وtokens وtailwind وwireframe_html ضمن Pro. في الخطة المجانية، يعيد استدعاء واحد لـ export_kit الملفات المجانية ورسالة عن الخطة بالنسبة للباقي. تكتب المهارة DIRECTION.md وBUILD-PROMPT.md (وDESIGN.md إذا طلبته)، وتعرض الرسالة مرة واحدة، وتذكرك بأن BUILD-PROMPT.md يعمل في أي أداة بلصقه. وإذا طلبت، تضيف يدويا إشارة من سطرين إلى AGENTS.md أو CLAUDE.md لديك، داخل العلامتين.
مهارات ذات صلة
Section titled “مهارات ذات صلة”| المهارة | قل | تكتب |
|---|---|---|
gobanana-design-md |
«DESIGN.md لهذه الصفحة» | DESIGN.md محصورا في النطاق، ثم تفحصه (3 جولات إصلاح على الأكثر) |
gobanana-agents-md |
«AGENTS.md»، «قواعد لوكلاء البرمجة» | قسم AGENTS.md، وCLAUDE.md إن وجد لديك |
gobanana-asset-kit |
«حزمة الأصول»، «رموز لهذه الصفحة» | من kit/00-readme.md إلى kit/06-sources.md: الرموز، وسمة Tailwind، وتدرجات آمنة، وزوج خطوط واحد بترخيص مفتوح، ومجموعة أيقونات واحدة (Lucide أو Phosphor) |
التالي: ابنِ ثم قيّم.