BrandCraft Squad

डिज़ाइन सिस्टम निष्कर्षण, ब्रांड-संगत दस्तावेज़ निर्माण और मौजूदा PDF सुधार के लिए AIOS Squad।

संस्करण: 1.0.0 | उपसर्ग: brandcraft | एजेंट: 8 | कार्य: 31 | वर्कफ़्लो: 4

अवलोकन

BrandCraft 8 विशेषज्ञ एजेंटों का एक squad है जो एक पूर्ण पाइपलाइन का संचालन करता है:

1. किसी भी URL से डिज़ाइन सिस्टम निकालें (रंग, टाइपोग्राफी, स्पेसिंग, लोगो)
2. पुन: प्रयोज्य टेम्पलेट के रूप में सहेजें (YAML frontmatter के साथ .md)
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 (QA)

कमांड: *create-document, *create-pdf, *create-carousel, *create-social-card अवधि: 30-60 मिनट

3. प्रस्तुति बनाएं

Maestro (चयन) → Vault (टोकन) → Canvas (लेआउट + PPTX) → Brush (छवियाँ) → Gauge (QA)

कमांड: *create-pptx, *create-presentation अवधि: 30-45 मिनट

4. मौजूदा PDF सुधारें

Scribe (PDF पढ़ता है → markdown) → Maestro (चयन) → Vault (टेम्पलेट) → Forge (पुन: रेंडर) → Gauge (QA)

कमांड: *improve-pdf, *redesign-document अवधि: 30-45 मिनट

समर्थित प्रारूप

टेम्पलेट प्रारूप

टेम्पलेट डिज़ाइन टोकन वाले YAML frontmatter के साथ .md फ़ाइलें हैं:

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

यह Squad के package.json में सूचीबद्ध सभी पैकेजों को स्वचालित रूप से इंस्टॉल करता है:

MCP सर्वर कॉन्फ़िगरेशन

BrandCraft को इमेज जनरेशन के लिए nano-banana-pro MCP (Google Gemini) की आवश्यकता है। कॉन्फ़िगरेशन IDE के अनुसार भिन्न होता है।

चरण 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 (अनुशंसित)

विकल्प A — 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

यह स्वचालित रूप से प्रोजेक्ट रूट में project स्कोप के साथ .mcp.json फ़ाइल बनाता है (git के माध्यम से टीम के साथ साझा)।

विकल्प B — .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} सिंटैक्स स्वचालित रूप से एनवायरनमेंट वैरिएबल को विस्तारित करता है — secrets कमिट करने से बचने के लिए कुंजी सीधे फ़ाइल में न रखें।

Antigravity (Google)

Antigravity में बिल्ट-इन MCP Store है:

1. Antigravity में MCP Store पैनल खोलें
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 / अन्य IDEs

MCP सपोर्ट वाले अधिकांश IDEs प्रोजेक्ट रूट में मानक .mcp.json प्रारूप का उपयोग करते हैं। कॉन्फ़िगरेशन फ़ाइल की सटीक स्थिति के लिए अपने IDE की डॉक्यूमेंटेशन देखें।

वैकल्पिक MCP

कॉन्फ़िगरेशन समान पैटर्न का अनुसरण करता है — प्रोजेक्ट के .mcp.json में जोड़ें या claude mcp add --scope project का उपयोग करें।

सत्यापन

कॉन्फ़िगर करने के बाद, IDE पुनः आरंभ करें और सत्यापित करें:

# 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