BrandCraft Squad

فريق AIOS لاستخراج أنظمة التصميم وإنشاء مستندات متسقة مع العلامة التجارية وتحسين ملفات PDF الموجودة.

الإصدار: 1.0.0 | البادئة: brandcraft | الوكلاء: 8 | المهام: 31 | سير العمل: 4

نظرة عامة

BrandCraft هو فريق مكون من 8 وكلاء متخصصين ينسقون خط أنابيب كاملاً من أجل:

1. استخراج أنظمة التصميم من أي عنوان URL (الألوان، الطباعة، التباعد، الشعارات)
2. الحفظ كقوالب قابلة لإعادة الاستخدام (ملفات .md مع YAML frontmatter)
3. إنشاء مستندات متسقة مع العلامة التجارية: PDF، PNG، دوارات Instagram، بطاقات اجتماعية
4. إنشاء عروض PPTX مع رموز تصميم مطبقة
5. إنشاء صور متسقة مع العلامة التجارية عبر أدوات AI MCP (nano-banana-pro، dalle3، إلخ)
6. تحسين ملفات PDF الموجودة بإعادة عرضها بنظام تصميم مختار

الوكلاء

خطوط الأنابيب

1. استخراج وحفظ نظام التصميم

URL → Prober (تحليل + رموز + شعارات) → Vault (يحفظ القالب)

الأمر: *extract-design-system المدة: 15-25 دقيقة

2. إنشاء مستند

Maestro (اختيار) → Vault (قالب + CSS) → Brush (صور) → Forge (HTML→PDF/PNG) → Gauge (ضمان الجودة)

الأمر: *create-document، *create-pdf، *create-carousel، *create-social-card المدة: 30-60 دقيقة

3. إنشاء عرض تقديمي

Maestro (اختيار) → Vault (رموز) → Canvas (تخطيطات + PPTX) → Brush (صور) → Gauge (ضمان الجودة)

الأمر: *create-pptx، *create-presentation المدة: 30-45 دقيقة

4. تحسين PDF موجود

Scribe (يقرأ PDF → markdown) → Maestro (اختيار) → Vault (قالب) → Forge (إعادة العرض) → Gauge (ضمان الجودة)

الأمر: *improve-pdf، *redesign-document المدة: 30-45 دقيقة

التنسيقات المدعومة

تنسيق القالب

القوالب هي ملفات .md مع YAML frontmatter تحتوي على رموز التصميم:

---
name: "acme-corp"
description: "نظام تصميم مستخرج من acme.com"
source_url: "https://www.acme.com"
extracted_at: "2026-02-24T14:30:00Z"
version: "1.0.0"
tokens:
  colors:
    primary: "#1a73e8"
    secondary: "#34a853"
    background: "#ffffff"
    text_primary: "#202124"
  typography:
    font_heading: "'Inter', sans-serif"
    font_body: "'Source Sans Pro', sans-serif"
    size_h1: "2.5rem"
    size_body: "1rem"
  spacing:
    sm: "8px"
    md: "16px"
    lg: "24px"
logos:
  primary: "assets/acme-corp/logo.svg"
---
# Acme Corp — نظام التصميم
...توثيق مفصل...

التبعيات

Node.js

أدوات MCP

الهيكل

squads/brandcraft/
├── squad.yaml                    # البيان
├── README.md                     # التوثيق (PT-BR)
├── agents/                       # 8 وكلاء
├── tasks/                        # 31 مهمة
├── workflows/                    # 4 سير عمل
├── config/                       # 3 إعدادات
├── checklists/                   # 3 قوائم فحص
├── templates/                    # 2 قوالب + assets/
└── scripts/                      # 2 نصوص برمجية (render.js، create-pptx.js)

المتطلبات الأساسية

• Node.js 18+ مثبت
• Claude Code مع وصول لخوادم MCP

تثبيت تبعيات Node.js

يتم تثبيت تبعيات Node.js داخل دليل الفريق (Squad):

cd squads/brandcraft
npm install

يقوم هذا بتثبيت جميع الحزم المدرجة في package.json الخاص بالفريق تلقائياً:

تكوين خوادم MCP

يتطلب BrandCraft أداة nano-banana-pro MCP (Google Gemini) لإنشاء الصور. يختلف التكوين حسب بيئة التطوير المستخدمة.

الخطوة 1: الحصول على GEMINI_API_KEY

1. انتقل إلى Google AI Studio
2. أنشئ أو حدد مشروع Google Cloud
3. أنشئ مفتاح API
4. انسخ المفتاح (الصيغة: AIzaSy...)
5. صدّره في shell:

export GEMINI_API_KEY="مفتاحك_هنا"

لجعله دائماً، أضفه إلى

~/.zshrc

~/.bashrc

الخطوة 2: تكوين خادم MCP

Claude Code (موصى به)

الخيار أ — عبر CLI (موصى به):

claude mcp add --transport stdio --scope project \
  --env GEMINI_API_KEY=${GEMINI_API_KEY} \
  nano-banana-pro -- npx -y @rafarafarafa/nano-banana-pro-mcp

هذا ينشئ تلقائياً ملف .mcp.json في جذر المشروع بنطاق project (مشترك مع الفريق عبر git).

الخيار ب — تحرير .mcp.json يدوياً:

أنشئ أو حرر ملف .mcp.json في جذر المشروع:

{
  "mcpServers": {
    "nano-banana-pro": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@rafarafarafa/nano-banana-pro-mcp"],
      "env": {
        "GEMINI_API_KEY": "${GEMINI_API_KEY}"
      }
    }
  }
}

صيغة ${GEMINI_API_KEY} توسع تلقائياً متغير البيئة — لا تضع المفتاح مباشرة في الملف لتجنب ارتكاب الأسرار.

Antigravity (Google)

يحتوي Antigravity على متجر MCP مدمج:

1. افتح لوحة MCP Store في Antigravity
2. ابحث عن "nano-banana-pro"
3. انقر على Install
4. كوّن متغير GEMINI_API_KEY عند الطلب

Cursor

أنشئ أو حرر

.cursor/mcp.json

{
  "mcpServers": {
    "nano-banana-pro": {
      "command": "npx",
      "args": ["-y", "@rafarafarafa/nano-banana-pro-mcp"],
      "env": {
        "GEMINI_API_KEY": "${GEMINI_API_KEY}"
      }
    }
  }
}

Windsurf / Codex / بيئات تطوير أخرى

معظم بيئات التطوير التي تدعم MCP تستخدم تنسيق .mcp.json القياسي في جذر المشروع. راجع وثائق بيئة التطوير الخاصة بك للموقع الدقيق لملف التكوين.

أدوات MCP الاختيارية

يتبع التكوين نفس النمط — أضف إلى .mcp.json الخاص بالمشروع أو استخدم claude mcp add --scope project.

التحقق

بعد التكوين، أعد تشغيل بيئة التطوير وتحقق:

# في Claude Code — سرد MCPs المكونة
claude mcp list

# داخل Claude Code — التحقق من الحالة
/mcp

يجب أن تكون أدوات mcp__nano-banana-pro__* متاحة. اختبر بـ: "أنشئ صورة اختبارية باستخدام nano-banana-pro".

الجودة

يتحقق bc-inspector (Gauge) من كل مستند مُنشأ بتقييم مرجح:

الأحكام: PASS (>=80) | CONCERNS (60-79) | FAIL (<60)

Synkra AIOS — BrandCraft Squad v1.0.0