sonance-brand-mcp 1.1.3 → 1.1.7

package/dist/index.js

@@ -181,6 +181,89 @@ if (process.argv.includes("--init-code") || process.argv.includes("init-code"))
     runClaudeCodeInstaller();
     process.exit(0);
 }
+/**
+ * Run the installer for Cursor IDE (creates .cursor/mcp.json in current directory)
+ */
+function runCursorInstaller() {
+    console.log("");
+    console.log("  ┌─────────────────────────────────────────────────┐");
+    console.log("  │                                                 │");
+    console.log("  │   🎨  Sonance Brand MCP - Cursor IDE Setup      │");
+    console.log("  │                                                 │");
+    console.log("  └─────────────────────────────────────────────────┘");
+    console.log("");
+    const cursorDir = path.join(process.cwd(), ".cursor");
+    const configPath = path.join(cursorDir, "mcp.json");
+    console.log(`  📍 Config file: ${configPath}`);
+    console.log("");
+    // Create .cursor directory if it doesn't exist
+    if (!fs.existsSync(cursorDir)) {
+        console.log("  📁 Creating .cursor directory...");
+        fs.mkdirSync(cursorDir, { recursive: true });
+    }
+    // Read existing config or create new one
+    let config = {};
+    if (fs.existsSync(configPath)) {
+        try {
+            const content = fs.readFileSync(configPath, "utf-8");
+            config = JSON.parse(content);
+            console.log("  📄 Found existing .cursor/mcp.json");
+        }
+        catch {
+            console.log("  ⚠️  Could not parse existing mcp.json, creating new one");
+        }
+    }
+    else {
+        console.log("  📄 Creating new .cursor/mcp.json");
+    }
+    // Initialize mcpServers if not present
+    if (!config.mcpServers) {
+        config.mcpServers = {};
+    }
+    // Check if already installed
+    if (config.mcpServers["sonance-brand"]) {
+        console.log("  ✅ sonance-brand is already configured!");
+        console.log("");
+        console.log("  To use it:");
+        console.log("    1. Restart Cursor (Cmd+Q / Alt+F4, then reopen)");
+        console.log("    2. Open this project in Cursor");
+        console.log("    3. The MCP tools will be available in Agent mode");
+        console.log("");
+        return;
+    }
+    // Add Sonance server config (using npx for auto-updates)
+    config.mcpServers["sonance-brand"] = {
+        command: "npx",
+        args: ["-y", "sonance-brand-mcp"],
+    };
+    // Write updated config
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+    console.log("");
+    console.log("  ✅ Sonance Brand MCP installed successfully!");
+    console.log("");
+    console.log("  ┌─────────────────────────────────────────────────┐");
+    console.log("  │  Next steps:                                    │");
+    console.log("  │                                                 │");
+    console.log("  │  1. Restart Cursor                              │");
+    console.log("  │     • Mac: Press Cmd+Q, then reopen             │");
+    console.log("  │     • Windows: Press Alt+F4, then reopen        │");
+    console.log("  │                                                 │");
+    console.log("  │  2. Open this project in Cursor                 │");
+    console.log("  │                                                 │");
+    console.log("  │  3. Use Agent mode (not Ask mode) to access     │");
+    console.log("  │     MCP tools                                   │");
+    console.log("  │                                                 │");
+    console.log("  └─────────────────────────────────────────────────┘");
+    console.log("");
+    console.log("  Try asking Cursor:");
+    console.log("    \"What are the official Sonance brand colors?\"");
+    console.log("");
+}
+// Check for --init-cursor flag BEFORE starting MCP server
+if (process.argv.includes("--init-cursor") || process.argv.includes("init-cursor")) {
+    runCursorInstaller();
+    process.exit(0);
+}
 // ============================================
 // PATH RESOLUTION
 // ============================================
@@ -223,6 +306,189 @@ function getAssetPath(assetType) {
         }
     }
 }
+/**
+ * Detect output type from user's request/prompt
+ */
+function detectFromRequest(prompt) {
+    const lowerPrompt = prompt.toLowerCase();
+    // Document indicators
+    if (/word|docx|pdf|proposal|spec sheet|report|spreadsheet|excel|xlsx/.test(lowerPrompt))
+        return "doc";
+    // Marketing indicators
+    if (/email|newsletter|banner|landing page|campaign|advertisement|promo/.test(lowerPrompt))
+        return "marketing";
+    // Technical doc indicators
+    if (/readme|documentation|api doc|guide|changelog|\.md\b/.test(lowerPrompt))
+        return "tech";
+    // UI indicators
+    if (/component|button|card|form|modal|dashboard|app|page|ui|react|next\.?js/.test(lowerPrompt))
+        return "ui";
+    return null;
+}
+/**
+ * Detect output type from code patterns
+ */
+function detectFromCode(code) {
+    // Document generation libraries
+    if (/from docx|python-docx|Document\(|reportlab|openpyxl|Workbook\(|docx\.|\.docx|PDFDocument/.test(code))
+        return "doc";
+    // Marketing patterns (email-safe HTML)
+    if (/email-safe|mso-|outlook|table.*cellpadding|inline.*style.*color|<!--\[if mso\]/i.test(code))
+        return "marketing";
+    // Technical documentation (Markdown)
+    if (/^#{1,3}\s|```[\w]*\n|README|\.md"|frontmatter|---\n.*title:/m.test(code))
+        return "tech";
+    // UI/React patterns (default)
+    return "ui";
+}
+/**
+ * Smart detection: tries request first, then code
+ */
+function smartDetectOutputType(prompt, code) {
+    const fromPrompt = detectFromRequest(prompt);
+    if (fromPrompt)
+        return fromPrompt;
+    return detectFromCode(code);
+}
+/**
+ * Extract brand colors from live CSS file
+ */
+function extractBrandColors() {
+    try {
+        const cssContent = fs.readFileSync(getAssetPath("css"), "utf-8");
+        const extractColor = (varName) => {
+            const match = cssContent.match(new RegExp(`${varName}:\\s*([#\\w]+)`));
+            return match ? match[1] : "";
+        };
+        return {
+            charcoal: extractColor("--sonance-charcoal") || "#343d46",
+            silver: extractColor("--sonance-silver") || "#e2e2e2",
+            white: extractColor("--sonance-white") || "#FFFFFF",
+            black: extractColor("--sonance-black") || "#000000",
+            teal: "#00D3C8", // Sonance accent
+            gray50: extractColor("--sonance-gray-50") || "#f8f9f9",
+            gray100: extractColor("--sonance-gray-100") || "#f0f1f2",
+            gray500: extractColor("--sonance-gray-500") || "#7a8389",
+            gray900: extractColor("--sonance-gray-900") || "#343d46",
+        };
+    }
+    catch {
+        // Return defaults if CSS can't be read
+        return {
+            charcoal: "#343d46",
+            silver: "#e2e2e2",
+            white: "#FFFFFF",
+            black: "#000000",
+            teal: "#00D3C8",
+            gray50: "#f8f9f9",
+            gray100: "#f0f1f2",
+            gray500: "#7a8389",
+            gray900: "#343d46",
+        };
+    }
+}
+/**
+ * Convert hex color to different formats for various document libraries
+ */
+function hexToFormats(hex) {
+    const cleanHex = hex.replace("#", "");
+    const r = parseInt(cleanHex.substring(0, 2), 16);
+    const g = parseInt(cleanHex.substring(2, 4), 16);
+    const b = parseInt(cleanHex.substring(4, 6), 16);
+    return {
+        hex: `#${cleanHex}`,
+        hexNoHash: cleanHex.toUpperCase(),
+        rgb: { r, g, b },
+        rgbColor: `RGBColor(0x${cleanHex.substring(0, 2).toUpperCase()}, 0x${cleanHex.substring(2, 4).toUpperCase()}, 0x${cleanHex.substring(4, 6).toUpperCase()})`,
+        reportlab: `HexColor('#${cleanHex}')`,
+    };
+}
+/**
+ * Get brand colors in document-ready formats
+ */
+function getBrandColorsForDocs() {
+    const colors = extractBrandColors();
+    return {
+        charcoal: hexToFormats(colors.charcoal),
+        silver: hexToFormats(colors.silver),
+        white: hexToFormats(colors.white),
+        black: hexToFormats(colors.black),
+        teal: hexToFormats(colors.teal),
+        gray50: hexToFormats(colors.gray50),
+        gray100: hexToFormats(colors.gray100),
+        gray500: hexToFormats(colors.gray500),
+        gray900: hexToFormats(colors.gray900),
+    };
+}
+const BRAND_PALETTES = {
+    sonance: {
+        primary: "#343d46", // Sonance Charcoal
+        secondary: "#e2e2e2", // Sonance Silver
+        accent: "#00D3C8", // Sonance Teal
+        background: "#FFFFFF",
+        foreground: "#343d46",
+        name: "Sonance",
+        preferredTheme: "light",
+    },
+    iport: {
+        primary: "#0F161D", // IPORT Dark
+        secondary: "#FC4C02", // IPORT Orange
+        accent: "#FC4C02", // IPORT Orange (accent)
+        background: "#0F161D",
+        foreground: "#FFFFFF",
+        name: "IPORT",
+        preferredTheme: "dark",
+    },
+    blaze: {
+        primary: "#28282B", // Blaze Dark
+        secondary: "#00A3E1", // Blaze Blue
+        accent: "#00A3E1", // Blaze Blue (primary accent)
+        accentSecondary: "#C02B0A", // Blaze Red (secondary accent)
+        background: "#28282B",
+        foreground: "#FFFFFF",
+        name: "Blaze Audio",
+        preferredTheme: "dark",
+    },
+};
+/**
+ * Get brand colors in document-ready formats for a specific brand
+ */
+function getBrandColorsForDocsMulti(brand = "sonance") {
+    const palette = BRAND_PALETTES[brand];
+    return {
+        primary: hexToFormats(palette.primary),
+        secondary: hexToFormats(palette.secondary),
+        accent: hexToFormats(palette.accent),
+        accentSecondary: palette.accentSecondary ? hexToFormats(palette.accentSecondary) : hexToFormats(palette.accent),
+        background: hexToFormats(palette.background),
+        foreground: hexToFormats(palette.foreground),
+        white: hexToFormats("#FFFFFF"),
+        black: hexToFormats("#000000"),
+    };
+}
+/**
+ * Get regex patterns to detect brand colors in code
+ */
+function getBrandColorPatterns(brand) {
+    const patterns = {
+        sonance: {
+            primaryPattern: /343d46|343D46|#343d46|0x34.*0x3D.*0x46|rgb\(52.*61.*70\)|charcoal|CHARCOAL|sonance-charcoal/i,
+            secondaryPattern: /e2e2e2|E2E2E2|#e2e2e2|0xE2.*0xE2.*0xE2|rgb\(226.*226.*226\)|silver|SILVER|sonance-silver/i,
+            accentPattern: /00D3C8|00d3c8|#00D3C8|0x00.*0xD3.*0xC8|rgb\(0.*211.*200\)|teal|TEAL/i,
+        },
+        iport: {
+            primaryPattern: /0F161D|0f161d|#0F161D|0x0F.*0x16.*0x1D|rgb\(15.*22.*29\)|iport.*dark/i,
+            secondaryPattern: /FC4C02|fc4c02|#FC4C02|0xFC.*0x4C.*0x02|rgb\(252.*76.*2\)|iport.*orange/i,
+            accentPattern: /FC4C02|fc4c02|#FC4C02|0xFC.*0x4C.*0x02|rgb\(252.*76.*2\)|iport.*orange/i,
+        },
+        blaze: {
+            primaryPattern: /28282B|28282b|#28282B|0x28.*0x28.*0x2B|rgb\(40.*40.*43\)|blaze.*dark/i,
+            secondaryPattern: /00A3E1|00a3e1|#00A3E1|0x00.*0xA3.*0xE1|rgb\(0.*163.*225\)|blaze.*blue/i,
+            accentPattern: /00A3E1|00a3e1|#00A3E1|C02B0A|c02b0a|#C02B0A|blaze.*(blue|red)/i,
+        },
+    };
+    return patterns[brand];
+}
 /**
  * Sonance MCP Server
  *
@@ -384,7 +650,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
             },
             {
                 name: "design_component",
-                description: "Returns brand-specific design tokens, colors, implementation rules, and logo assets for designing a component. Smart defaults: Sonance/Light/Default logo lockup if not specified.",
+                description: "Returns brand-specific design tokens, colors, implementation rules, and logo assets for designing a component. Smart defaults: Sonance/Light/Default logo lockup if not specified. Auto-detects output type (ui/doc/marketing/tech) if not specified.",
                 inputSchema: {
                     type: "object",
                     properties: {
@@ -403,14 +669,114 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             enum: ["default", "sonance", "iport", "blaze"],
                             description: "Which logo to use. 'default' = Sonance+James+IPORT lockup. Or specify 'sonance', 'iport', or 'blaze' for individual brand logos. Defaults to 'default' if not specified.",
                         },
+                        output_type: {
+                            type: "string",
+                            enum: ["ui", "doc", "marketing", "tech"],
+                            description: "Type of output being designed. 'ui' = React/Next.js components, 'doc' = Word/PDF documents, 'marketing' = email/landing pages, 'tech' = documentation. Auto-detected if not specified.",
+                        },
                         component_description: {
                             type: "string",
-                            description: "What the user wants to design (e.g., 'hero section', 'pricing card', 'navigation bar')",
+                            description: "What the user wants to design (e.g., 'hero section', 'pricing card', 'navigation bar', 'proposal PDF', 'email template')",
                         },
                     },
                     required: ["component_description"],
                 },
             },
+            {
+                name: "evaluate_design",
+                description: "Evaluates a design or component against the Design Excellence Framework for Sonance, IPORT, or Blaze. Returns a score (0-100), tier (1-5), and specific feedback for improvement. Auto-detects output type and applies appropriate rubrics.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        code: {
+                            type: "string",
+                            description: "The code/component to evaluate against brand guidelines",
+                        },
+                        description: {
+                            type: "string",
+                            description: "Brief description of what the component does",
+                        },
+                        brand: {
+                            type: "string",
+                            enum: ["sonance", "iport", "blaze"],
+                            description: "Target brand for evaluation. Defaults to 'sonance' if not specified.",
+                        },
+                        output_type: {
+                            type: "string",
+                            enum: ["ui", "doc", "marketing", "tech"],
+                            description: "Type of output being evaluated. 'ui' = React/Next.js, 'doc' = Word/PDF, 'marketing' = email/landing, 'tech' = documentation. Auto-detected from code if not specified.",
+                        },
+                    },
+                    required: ["code"],
+                },
+            },
+            {
+                name: "get_document_template",
+                description: "Returns code templates for generating branded documents (Word, PDF, Excel) for Sonance, IPORT, or Blaze. Includes proper brand colors, fonts, and layout patterns for python-docx, ReportLab, openpyxl.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        format: {
+                            type: "string",
+                            enum: ["word-python", "pdf-python", "excel-python"],
+                            description: "The document format and language. word-python = python-docx, pdf-python = ReportLab, excel-python = openpyxl",
+                        },
+                        brand: {
+                            type: "string",
+                            enum: ["sonance", "iport", "blaze"],
+                            description: "Target brand for the document. Defaults to 'sonance' if not specified.",
+                        },
+                        template_type: {
+                            type: "string",
+                            enum: ["proposal", "spec-sheet", "report", "invoice", "presentation"],
+                            description: "Type of document being created",
+                        },
+                    },
+                    required: ["format"],
+                },
+            },
+            {
+                name: "get_excellence_checklist",
+                description: "Returns the pre-delivery excellence checklist for Sonance UI work. Use this before delivering any component to ensure it meets Tier 4+ standards.",
+                inputSchema: {
+                    type: "object",
+                    properties: {},
+                    required: [],
+                },
+            },
+            {
+                name: "get_anti_patterns",
+                description: "Returns common anti-patterns and mistakes to avoid when building Sonance-branded UI. Includes critical failures that result in Tier 1 scores.",
+                inputSchema: {
+                    type: "object",
+                    properties: {},
+                    required: [],
+                },
+            },
+            {
+                name: "rebrand_document",
+                description: "Returns universal rebranding instructions for converting ANY existing document to a specific brand (Sonance, IPORT, or Blaze). Works with any document format - provides color replacements, font substitutions, and logo placement rules that apply regardless of document structure.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        source_format: {
+                            type: "string",
+                            enum: ["word", "pdf", "excel", "powerpoint", "html", "generic"],
+                            description: "What type of document you're rebranding. Use 'generic' if unsure or for other formats.",
+                        },
+                        brand: {
+                            type: "string",
+                            enum: ["sonance", "iport", "blaze"],
+                            description: "Target brand for rebranding. Defaults to 'sonance' if not specified.",
+                        },
+                        current_colors: {
+                            type: "string",
+                            description: "Optional: describe or list colors currently in the document that need replacing (e.g., 'blue headers, gray backgrounds')",
+                        },
+                    },
+                    required: ["source_format"],
+                },
+            },
         ],
     };
 });
@@ -646,6 +1012,11 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             const theme = rawArgs.theme || (() => { defaultsUsed.push("theme → Light"); return "light"; })();
             const logoPreference = rawArgs.logo_preference || (() => { defaultsUsed.push("logo → Default lockup"); return "default"; })();
             const component_description = rawArgs.component_description;
+            // Smart output type detection
+            const detectedOutputType = rawArgs.output_type || detectFromRequest(component_description) || "ui";
+            if (!rawArgs.output_type) {
+                defaultsUsed.push(`output type → ${detectedOutputType} (auto-detected)`);
+            }
             // Logo path mapping based on preference and theme
             // Light theme = dark logo (for light backgrounds), Dark theme = light logo (for dark backgrounds)
             const logoMap = {
@@ -843,31 +1214,176 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             }
             // Build defaults notice if any were applied
             const defaultsNotice = defaultsUsed.length > 0
-                ? `\n> **Note**: Defaults applied: ${defaultsUsed.join(", ")}. Specify \`brand\`, \`theme\`, or \`logo_preference\` explicitly for different styling.\n`
+                ? `\n> **Note**: Defaults applied: ${defaultsUsed.join(", ")}. Specify \`brand\`, \`theme\`, \`logo_preference\`, or \`output_type\` explicitly for different styling.\n`
                 : "";
-            const response = `# Design Context for: ${component_description}
+            // Get live brand colors for document formats
+            const docColors = getBrandColorsForDocs();
+            // Output-type-specific implementation guidance
+            const outputTypeGuidance = {
+                ui: `## Implementation: React/Next.js UI Component
 
-**Brand**: ${brand.toUpperCase()}
-**Theme**: ${theme.charAt(0).toUpperCase() + theme.slice(1)}
-**Logo**: ${logoPreferenceLabel}
-${defaultsNotice}
-${tokens}
+### Tailwind CSS Classes
+\`\`\`jsx
+// Primary Button
+<button className="bg-primary text-primary-foreground px-6 py-3 text-sm font-medium uppercase tracking-wide hover:bg-primary-hover transition-colors">
+
+// Card
+<div className="bg-card border border-border rounded-sm p-6 shadow-sm">
 
-## Logo Asset
+// Section
+<section className="py-20 px-6 lg:py-24 lg:px-8 bg-background text-foreground">
+\`\`\`
+
+### Logo Asset
 - **Selected**: ${logoPreferenceLabel}
 - **Path**: \`${logoPath}\`
-- **Usage**: 
+- **Usage**:
 \`\`\`jsx
 <img src="${logoPath}" alt="${logoPreferenceLabel}" className="h-8 w-auto" />
 // or with Next.js Image:
 <Image src="${logoPath}" alt="${logoPreferenceLabel}" width={200} height={40} />
 \`\`\`
 
-> **Tip**: To use a different logo, specify \`logo_preference\`: "default" (Sonance+James+IPORT), "sonance", "iport", or "blaze"
+### Key Requirements
+- Use semantic Tailwind classes (bg-primary, not bg-[#343d46])
+- Support light/dark mode with \`dark:\` variants
+- Add hover states (hover:) and focus states (focus-visible:)
+- Use sharp corners (rounded-sm or rounded-none)
+- Generous spacing (py-20/py-24 for sections)`,
+                doc: `## Implementation: Document Generation (Word/PDF/Excel)
+
+### Sonance Brand Constants for Documents
+\`\`\`python
+# python-docx / openpyxl colors
+CHARCOAL = '${docColors.charcoal.hexNoHash}'      # For headers, text
+SILVER = '${docColors.silver.hexNoHash}'          # For backgrounds, borders
+WHITE = '${docColors.white.hexNoHash}'
+BLACK = '${docColors.black.hexNoHash}'
+TEAL = '${docColors.teal.hexNoHash}'              # Accent color
+
+# As RGBColor (python-docx)
+from docx.shared import RGBColor
+CHARCOAL_RGB = ${docColors.charcoal.rgbColor}
+SILVER_RGB = ${docColors.silver.rgbColor}
+TEAL_RGB = ${docColors.teal.rgbColor}
+\`\`\`
+
+### Typography for Documents
+- **Font**: Montserrat (embed) or Arial (fallback)
+- **Title**: 28pt, Charcoal, Light weight
+- **Heading 1**: 18pt, Charcoal, Medium weight
+- **Heading 2**: 14pt, Charcoal, Medium weight
+- **Body**: 11pt, Charcoal, Regular weight
+- **Line spacing**: 1.15
+
+### Page Layout
+- **Margins**: 1.25" top, 1" sides, 1" bottom
+- **Header**: Logo + document title
+- **Footer**: Page numbers, confidentiality notice
+
+### Logo for Documents
+- **Path**: \`${logoPath}\`
+- **Size**: 2" wide in header
+- **Position**: Top-left or centered
+
+> **Tip**: Use \`get_document_template\` tool for complete code templates.`,
+                marketing: `## Implementation: Marketing Asset (Email/Landing Page)
+
+### Email-Safe CSS
+\`\`\`html
+<!-- Inline styles required for email clients -->
+<table style="background-color: ${docColors.charcoal.hex}; font-family: 'Montserrat', Arial, sans-serif;">
+  <tr>
+    <td style="color: ${docColors.white.hex}; font-size: 14px; line-height: 1.6;">
+      Your content here
+    </td>
+  </tr>
+</table>
+
+<!-- CTA Button (Outlook-safe) -->
+<table border="0" cellpadding="0" cellspacing="0" style="border-collapse: collapse;">
+  <tr>
+    <td style="background-color: ${docColors.teal.hex}; border-radius: 2px; padding: 12px 24px;">
+      <a href="#" style="color: ${docColors.white.hex}; text-decoration: none; font-weight: 500; text-transform: uppercase; letter-spacing: 0.08em;">
+        Learn More
+      </a>
+    </td>
+  </tr>
+</table>
+\`\`\`
+
+### Brand Colors (Inline)
+- Charcoal: \`${docColors.charcoal.hex}\`
+- Silver: \`${docColors.silver.hex}\`
+- Teal (CTA): \`${docColors.teal.hex}\`
+- White: \`${docColors.white.hex}\`
+
+### Logo for Email
+- **Path**: Use absolute URL to hosted logo
+- **Size**: 150-200px wide
+- **Alt text**: "Sonance" (required)
+
+### Key Requirements
+- All styles must be inline (no external CSS)
+- Use tables for layout (email compatibility)
+- Max width: 600px for email, 1200px for landing
+- Include fallback fonts: Arial, sans-serif`,
+                tech: `## Implementation: Technical Documentation
+
+### Markdown Structure
+\`\`\`markdown
+# Document Title
+
+Brief introduction paragraph.
+
+## Section Heading
+
+Content with proper formatting.
+
+### Subsection
+
+- Bullet points for lists
+- Keep items concise
+
+\\\`\\\`\\\`typescript
+// Code blocks with syntax highlighting
+const example = "Sonance";
+\\\`\\\`\\\`
+
+> **Note**: Use blockquotes for callouts
+\`\`\`
+
+### Documentation Style
+- **Headings**: Title case, no periods
+- **Code**: Syntax-highlighted blocks
+- **Lists**: Use bullets for unordered, numbers for steps
+- **Links**: Descriptive text, not "click here"
+
+### Brand Application
+- Use "Sonance" not "sonance" or "SONANCE" in prose
+- Maintain professional, premium tone
+- Generous spacing between sections
+- Clear hierarchy with heading levels
+
+### Logo for Documentation
+- Include logo in README header
+- Use dark variant for GitHub (light mode default)
+- Path: \`${logoPath}\``,
+            };
+            const response = `# Design Context for: ${component_description}
+
+**Brand**: ${brand.toUpperCase()}
+**Theme**: ${theme.charAt(0).toUpperCase() + theme.slice(1)}
+**Output Type**: ${detectedOutputType.toUpperCase()}
+**Logo**: ${logoPreferenceLabel}
+${defaultsNotice}
+${tokens}
+
+${outputTypeGuidance[detectedOutputType]}
 
 ## Typography (All Brands)
 - **Font Family**: Montserrat
-- **Headlines**: font-weight 300 (Light) or 500 (Medium), letter-spacing -0.02em
+- **Headlines**: font-weight 300 (Light) or 500 (Medium)
 - **Body**: font-weight 400 (Regular), line-height 1.6
 - **Buttons/CTAs**: font-weight 500, uppercase, letter-spacing 0.08em
 
@@ -884,6 +1400,1150 @@ Now design the **${component_description}** following these tokens and principle
                 content: [{ type: "text", text: response }],
             };
         }
+        case "evaluate_design": {
+            const evalArgs = args;
+            if (!evalArgs.code) {
+                return {
+                    content: [{ type: "text", text: "Error: code is required for evaluation" }],
+                    isError: true,
+                };
+            }
+            const code = evalArgs.code;
+            const description = evalArgs.description || "Component";
+            const evalBrand = evalArgs.brand || "sonance";
+            const evalPalette = BRAND_PALETTES[evalBrand];
+            // Smart output type detection
+            const outputType = evalArgs.output_type || smartDetectOutputType(description, code);
+            // Get brand-specific patterns for evaluation
+            const brandPatterns = getBrandColorPatterns(evalBrand);
+            // Output-type-specific checks
+            let checks;
+            let checkDescriptions;
+            if (outputType === "doc") {
+                // Document-specific checks (Word/PDF/Excel) - FORMAT-AGNOSTIC
+                // These patterns work across python-docx, ReportLab, openpyxl, and manual edits
+                // Brand-specific color patterns
+                const primaryPattern = brandPatterns.primaryPattern;
+                const secondaryPattern = brandPatterns.secondaryPattern;
+                const accentPattern = brandPatterns.accentPattern;
+                // Common non-brand colors that indicate incomplete rebranding (exclude target brand colors)
+                const nonBrandColors = evalBrand === "sonance"
+                    ? /0066CC|0078D4|1E90FF|007BFF|2196F3|FF5722|FF9800|4CAF50|8BC34A|E91E63|9C27B0|673AB7|3F51B5|FC4C02|0F161D|28282B|00A3E1|C02B0A/i
+                    : evalBrand === "iport"
+                        ? /0066CC|0078D4|1E90FF|007BFF|2196F3|FF5722|FF9800|4CAF50|8BC34A|E91E63|9C27B0|673AB7|3F51B5|343d46|00D3C8|28282B|00A3E1|C02B0A/i
+                        : /0066CC|0078D4|1E90FF|007BFF|2196F3|FF5722|FF9800|4CAF50|8BC34A|E91E63|9C27B0|673AB7|3F51B5|343d46|00D3C8|FC4C02|0F161D/i;
+                // Brand-specific logo patterns
+                const logoPatterns = {
+                    sonance: /logo|sonance.*\.(png|jpg|svg)|Sonance_logo|add_picture|drawImage|Image\(/i,
+                    iport: /logo|iport.*\.(png|jpg|svg)|IPORT_Lockup|add_picture|drawImage|Image\(/i,
+                    blaze: /logo|blaze.*\.(png|jpg|svg)|Blaze_Lockup|add_picture|drawImage|Image\(/i,
+                };
+                checks = {
+                    // Brand Compliance (25%) - REBRANDING FOCUSED
+                    usesPrimaryColor: primaryPattern.test(code),
+                    usesSecondaryColor: secondaryPattern.test(code) || primaryPattern.test(code), // Secondary optional if primary present
+                    noOldBrandColors: !nonBrandColors.test(code),
+                    hasFontConfig: /Montserrat|Arial|font.*name|font_name|fontName|font-family/i.test(code),
+                    hasLogoReference: logoPatterns[evalBrand].test(code),
+                    // Typography (15%)
+                    hasFontSizes: /pt|Pt\(|font.*size|fontSize|font-size/i.test(code),
+                    hasHeadingStyles: /heading|title|Heading|style.*=.*'Heading|h1|h2|H1|H2/i.test(code),
+                    hasLineSpacing: /line.*spacing|lineSpacing|space_after|space_before|leading|line-height/i.test(code),
+                    // Layout (15%)
+                    hasMargins: /margin|Inches|Cm|Pt.*margin|padding/i.test(code),
+                    hasPageSetup: /page.*setup|section|orientation|paper.*size|pagesize/i.test(code),
+                    hasStructure: /add_paragraph|add_heading|add_table|Paragraph|Table|<table|<div|<section/i.test(code),
+                    // Visual Hierarchy (15%)
+                    hasMultipleStyles: /Heading 1|Heading 2|Title|Subtitle|style\[|h1.*h2|H1.*H2/i.test(code),
+                    usesProperWeights: !/font-weight.*700|fontWeight.*700|bold.*True|\.bold.*=.*True/i.test(code) || /font-weight.*(300|400|500)|fontWeight.*(300|400|500)|Medium|Light/i.test(code),
+                    // Medium Excellence (15%)
+                    hasErrorHandling: /try|except|catch|error|Error/i.test(code),
+                    hasComments: /^#|\/\/|\/\*|\"\"\"|<!--/m.test(code),
+                    isModular: /def |function |class |const.*=.*\(|export/i.test(code),
+                    // Polish (15%)
+                    hasHeaderFooter: /header|footer|page.*number|Header|Footer/i.test(code),
+                    hasWhitespace: /space_after|space_before|margin|padding|gap/i.test(code),
+                };
+                checkDescriptions = {
+                    usesPrimaryColor: { category: "Brand Compliance", description: `Uses ${evalPalette.name} primary color (${evalPalette.primary})`, weight: 8 },
+                    usesSecondaryColor: { category: "Brand Compliance", description: `Uses ${evalPalette.name} secondary color (${evalPalette.secondary}) or neutral colors`, weight: 4 },
+                    noOldBrandColors: { category: "Brand Compliance", description: `No old/non-${evalPalette.name} brand colors present`, weight: 6 },
+                    hasFontConfig: { category: "Brand Compliance", description: "Configures Montserrat or Arial font", weight: 5 },
+                    hasLogoReference: { category: "Brand Compliance", description: `References ${evalPalette.name} logo`, weight: 2 },
+                    hasFontSizes: { category: "Typography", description: "Defines font sizes", weight: 5 },
+                    hasHeadingStyles: { category: "Typography", description: "Uses heading styles", weight: 5 },
+                    hasLineSpacing: { category: "Typography", description: "Sets line spacing", weight: 5 },
+                    hasMargins: { category: "Layout", description: "Configures margins/padding", weight: 5 },
+                    hasPageSetup: { category: "Layout", description: "Has page setup", weight: 5 },
+                    hasStructure: { category: "Layout", description: "Uses structured document elements", weight: 5 },
+                    hasMultipleStyles: { category: "Visual Hierarchy", description: "Multiple heading levels", weight: 8 },
+                    usesProperWeights: { category: "Visual Hierarchy", description: "Uses proper font weights (not bold 700)", weight: 7 },
+                    hasErrorHandling: { category: "Medium Excellence", description: "Has error handling", weight: 5 },
+                    hasComments: { category: "Medium Excellence", description: "Has code comments", weight: 5 },
+                    isModular: { category: "Medium Excellence", description: "Uses modular code structure", weight: 5 },
+                    hasHeaderFooter: { category: "Polish", description: "Has header/footer", weight: 7 },
+                    hasWhitespace: { category: "Polish", description: "Has whitespace/spacing configuration", weight: 8 },
+                };
+            }
+            else if (outputType === "marketing") {
+                // Marketing-specific checks (Email/Landing)
+                const primaryHex = evalPalette.primary.replace('#', '');
+                checks = {
+                    // Brand Compliance (20%)
+                    usesInlineColors: new RegExp(`color.*:.*#?${primaryHex}|background.*:.*#?${primaryHex}`, 'i').test(code) || brandPatterns.primaryPattern.test(code),
+                    hasInlineStyles: /style\s*=/i.test(code),
+                    hasFallbackFonts: /Arial|sans-serif|font-family.*,/i.test(code),
+                    // Typography (15%)
+                    hasFontSizes: /font-size|fontSize/i.test(code),
+                    hasLineHeight: /line-height|lineHeight/i.test(code),
+                    hasTextFormatting: /text-transform|letter-spacing|font-weight/i.test(code),
+                    // Layout (15%)
+                    usesTableLayout: /<table|table.*border/i.test(code),
+                    hasMaxWidth: /max-width|maxWidth|width.*600|width.*100%/i.test(code),
+                    hasCellPadding: /cellpadding|padding/i.test(code),
+                    // Visual Hierarchy (15%)
+                    hasCTA: /button|btn|cta|call.*to.*action|href/i.test(code),
+                    hasHeadings: /<h[1-6]|font-size.*[2-4][0-9]px/i.test(code),
+                    // Medium Excellence (15%)
+                    isOutlookSafe: /mso-|<!--\[if|VML/i.test(code),
+                    hasAltText: /alt\s*=/i.test(code),
+                    hasResponsive: /media.*query|@media|max-width.*100%/i.test(code),
+                    // Polish (10%)
+                    hasPreheader: /preheader|preview.*text/i.test(code),
+                    hasUnsubscribe: /unsubscribe|opt.*out/i.test(code),
+                };
+                checkDescriptions = {
+                    usesInlineColors: { category: "Brand Compliance", description: `Uses ${evalPalette.name} colors inline`, weight: 7 },
+                    hasInlineStyles: { category: "Brand Compliance", description: "Uses inline styles (required)", weight: 7 },
+                    hasFallbackFonts: { category: "Brand Compliance", description: "Has font fallbacks", weight: 6 },
+                    hasFontSizes: { category: "Typography", description: "Defines font sizes", weight: 5 },
+                    hasLineHeight: { category: "Typography", description: "Sets line height", weight: 5 },
+                    hasTextFormatting: { category: "Typography", description: "Has text formatting", weight: 5 },
+                    usesTableLayout: { category: "Layout", description: "Uses table layout", weight: 5 },
+                    hasMaxWidth: { category: "Layout", description: "Has max-width constraint", weight: 5 },
+                    hasCellPadding: { category: "Layout", description: "Has proper spacing", weight: 5 },
+                    hasCTA: { category: "Visual Hierarchy", description: "Has call-to-action", weight: 8 },
+                    hasHeadings: { category: "Visual Hierarchy", description: "Has heading hierarchy", weight: 7 },
+                    isOutlookSafe: { category: "Medium Excellence", description: "Outlook compatible", weight: 5 },
+                    hasAltText: { category: "Medium Excellence", description: "Images have alt text", weight: 5 },
+                    hasResponsive: { category: "Medium Excellence", description: "Has responsive design", weight: 5 },
+                    hasPreheader: { category: "Polish", description: "Has preheader text", weight: 5 },
+                    hasUnsubscribe: { category: "Polish", description: "Has unsubscribe link", weight: 5 },
+                };
+            }
+            else if (outputType === "tech") {
+                // Technical documentation checks
+                const brandNamePattern = new RegExp(evalPalette.name, 'i');
+                checks = {
+                    // Brand Compliance (20%)
+                    usesBrandName: brandNamePattern.test(code),
+                    hasConsistentFormatting: /^#{1,3}\s/m.test(code),
+                    hasProfessionalTone: !/lol|haha|!!!|\?\?/i.test(code),
+                    // Typography (15%)
+                    hasHeadingHierarchy: /^#\s[\s\S]*^##\s/m.test(code),
+                    hasCodeBlocks: /```[\w]*\n/m.test(code),
+                    hasLists: /^[\-\*]\s|^\d+\.\s/m.test(code),
+                    // Layout (15%)
+                    hasTableOfContents: /table.*contents|\[.*\]\(#/i.test(code),
+                    hasSections: /^##\s/m.test(code),
+                    hasSpacing: /\n\n/.test(code),
+                    // Visual Hierarchy (15%)
+                    hasMultipleHeadingLevels: /^#\s[\s\S]*^##\s[\s\S]*^###\s/m.test(code),
+                    hasEmphasis: /\*\*.*\*\*|__.*__/m.test(code),
+                    // Medium Excellence (15%)
+                    hasLinks: /\[.*\]\(http/m.test(code),
+                    hasImageAlt: /!\[.+\]/m.test(code),
+                    hasCallouts: />\s\*\*|>\s\[!|:::/.test(code),
+                    // Polish (10%)
+                    hasIntro: /^#\s.*\n\n\w/m.test(code),
+                    hasConclusion: /conclusion|summary|next.*steps/i.test(code),
+                };
+                checkDescriptions = {
+                    usesBrandName: { category: "Brand Compliance", description: `Uses '${evalPalette.name}' correctly`, weight: 7 },
+                    hasConsistentFormatting: { category: "Brand Compliance", description: "Consistent markdown formatting", weight: 7 },
+                    hasProfessionalTone: { category: "Brand Compliance", description: "Professional tone", weight: 6 },
+                    hasHeadingHierarchy: { category: "Typography", description: "Proper heading hierarchy", weight: 5 },
+                    hasCodeBlocks: { category: "Typography", description: "Uses code blocks", weight: 5 },
+                    hasLists: { category: "Typography", description: "Uses lists appropriately", weight: 5 },
+                    hasTableOfContents: { category: "Layout", description: "Has navigation/TOC", weight: 5 },
+                    hasSections: { category: "Layout", description: "Has clear sections", weight: 5 },
+                    hasSpacing: { category: "Layout", description: "Has proper spacing", weight: 5 },
+                    hasMultipleHeadingLevels: { category: "Visual Hierarchy", description: "Multiple heading levels", weight: 8 },
+                    hasEmphasis: { category: "Visual Hierarchy", description: "Uses emphasis (bold)", weight: 7 },
+                    hasLinks: { category: "Medium Excellence", description: "Has external links", weight: 5 },
+                    hasImageAlt: { category: "Medium Excellence", description: "Images have alt text", weight: 5 },
+                    hasCallouts: { category: "Medium Excellence", description: "Has callouts/notes", weight: 5 },
+                    hasIntro: { category: "Polish", description: "Has introduction", weight: 5 },
+                    hasConclusion: { category: "Polish", description: "Has conclusion/next steps", weight: 5 },
+                };
+            }
+            else {
+                // UI Component checks (React/Next.js) - default
+                checks = {
+                    // Brand Compliance (20%)
+                    usesSemantic: /bg-(primary|secondary|background|foreground|card|input)|text-(primary|secondary|foreground|muted)/.test(code),
+                    noHardcodedColors: !/#[0-9a-fA-F]{6}/.test(code) || /--sonance-|var\(--/.test(code),
+                    usesCorrectRadius: !/rounded-(xl|lg|2xl|3xl|full)/.test(code) || /rounded-(sm|none|md)/.test(code),
+                    // Typography (15%)
+                    usesMontserrat: /font-sans|Montserrat|--font-primary/.test(code),
+                    noFontBold: !/font-bold/.test(code) || /font-(light|medium|normal)/.test(code),
+                    hasTypographyHierarchy: /text-(xs|sm|base|lg|xl|2xl|3xl|4xl)/.test(code),
+                    // Color Application (10%)
+                    hasDarkMode: /dark:|data-theme|resolvedTheme/.test(code),
+                    usesVariables: /var\(--|--[a-z]/.test(code),
+                    // Layout & Spacing (15%)
+                    hasGenerousSpacing: /p[xy]?-(12|16|20|24|32)|space-(12|16|20|24)/.test(code),
+                    noTightSpacing: !/p[xy]?-[12](?!\d)/.test(code),
+                    // Visual Hierarchy (15%)
+                    hasMultipleSizes: (/text-sm/.test(code) && /text-(lg|xl|2xl)/.test(code)),
+                    hasWeightVariation: /font-(light|medium|normal)/.test(code),
+                    // Medium Excellence (15%)
+                    isTypeScript: /interface |type |: string|: number|: boolean|React\./.test(code),
+                    hasAccessibility: /aria-|role=|alt=/.test(code),
+                    hasTransitions: /transition|duration-/.test(code),
+                    // Polish (10%)
+                    hasHoverStates: /hover:/.test(code),
+                    hasFocusStates: /focus:|focus-visible:/.test(code),
+                };
+                checkDescriptions = {
+                    usesSemantic: { category: "Brand Compliance", description: "Uses semantic color classes", weight: 4 },
+                    noHardcodedColors: { category: "Brand Compliance", description: "No hardcoded hex colors", weight: 3 },
+                    usesCorrectRadius: { category: "Brand Compliance", description: "Uses sharp corners (rounded-sm)", weight: 3 },
+                    usesMontserrat: { category: "Typography", description: "Uses Montserrat font", weight: 4 },
+                    noFontBold: { category: "Typography", description: "No font-bold on headlines", weight: 4 },
+                    hasTypographyHierarchy: { category: "Typography", description: "Has typography hierarchy", weight: 2 },
+                    hasDarkMode: { category: "Color Application", description: "Supports dark mode", weight: 5 },
+                    usesVariables: { category: "Color Application", description: "Uses CSS variables", weight: 5 },
+                    hasGenerousSpacing: { category: "Layout", description: "Has generous spacing", weight: 5 },
+                    noTightSpacing: { category: "Layout", description: "No cramped layouts", weight: 5 },
+                    hasMultipleSizes: { category: "Visual Hierarchy", description: "Multiple font sizes", weight: 5 },
+                    hasWeightVariation: { category: "Visual Hierarchy", description: "Font weight variation", weight: 5 },
+                    isTypeScript: { category: "Medium Excellence", description: "Uses TypeScript", weight: 4 },
+                    hasAccessibility: { category: "Medium Excellence", description: "Has accessibility attrs", weight: 3 },
+                    hasTransitions: { category: "Medium Excellence", description: "Has transitions", weight: 3 },
+                    hasHoverStates: { category: "Polish", description: "Has hover states", weight: 5 },
+                    hasFocusStates: { category: "Polish", description: "Has focus states", weight: 5 },
+                };
+            }
+            // Calculate score based on weights
+            let totalScore = 0;
+            const checkResults = [];
+            for (const [key, passed] of Object.entries(checks)) {
+                const desc = checkDescriptions[key];
+                if (desc) {
+                    checkResults.push({
+                        check: key,
+                        passed,
+                        category: desc.category,
+                        description: desc.description,
+                        weight: desc.weight,
+                    });
+                    if (passed) {
+                        totalScore += desc.weight;
+                    }
+                }
+            }
+            // Determine tier
+            let tier;
+            let tierLabel;
+            let deliverable;
+            if (totalScore >= 95) {
+                tier = 5;
+                tierLabel = "Portfolio-Worthy";
+                deliverable = true;
+            }
+            else if (totalScore >= 85) {
+                tier = 4;
+                tierLabel = "Professional";
+                deliverable = true;
+            }
+            else if (totalScore >= 70) {
+                tier = 3;
+                tierLabel = "Needs Iteration";
+                deliverable = false;
+            }
+            else if (totalScore >= 50) {
+                tier = 2;
+                tierLabel = "Major Iteration Required";
+                deliverable = false;
+            }
+            else {
+                tier = 1;
+                tierLabel = "Rebuild Required";
+                deliverable = false;
+            }
+            // Build gaps list from failed checks
+            const gaps = checkResults
+                .filter(c => !c.passed)
+                .map(c => c.description);
+            // Group results by category
+            const byCategory = {};
+            for (const result of checkResults) {
+                if (!byCategory[result.category]) {
+                    byCategory[result.category] = [];
+                }
+                byCategory[result.category].push(result);
+            }
+            // Build category scores table
+            const categoryScores = Object.entries(byCategory).map(([category, results]) => {
+                const earned = results.filter(r => r.passed).reduce((sum, r) => sum + r.weight, 0);
+                const max = results.reduce((sum, r) => sum + r.weight, 0);
+                const checkMarks = results.map(r => `${r.passed ? "✓" : "✗"} ${r.description}`).join(", ");
+                return { category, earned, max, checkMarks };
+            });
+            // Output type labels
+            const outputTypeLabels = {
+                ui: "React/Next.js UI Component",
+                doc: "Document (Word/PDF/Excel)",
+                marketing: "Marketing Asset (Email/Landing)",
+                tech: "Technical Documentation",
+            };
+            const evalResponse = `# Design Excellence Evaluation: ${description}
+
+**Output Type**: ${outputTypeLabels[outputType]} (${outputType === evalArgs.output_type ? "specified" : "auto-detected"})
+
+## Score: ${totalScore}/100 — Tier ${tier} (${tierLabel})
+
+${deliverable ? "✅ **Ready for delivery**" : "⚠️ **Iterate before delivery** — minimum threshold is 85 (Tier 4)"}
+
+---
+
+## Dimension Scores
+
+| Category | Score | Max | Details |
+|----------|-------|-----|---------|
+${categoryScores.map(c => `| ${c.category} | ${c.earned} | ${c.max} | ${c.checkMarks} |`).join('\n')}
+
+---
+
+${gaps.length > 0 ? `## Gaps to Address
+
+${gaps.map((gap, i) => `${i + 1}. ${gap}`).join('\n')}
+
+---` : "## No major gaps identified — excellent work!"}
+
+## Next Steps
+
+${deliverable
+                ? "This output meets Sonance brand standards. Consider polish improvements for Tier 5."
+                : `Iterate on the gaps above to reach Tier 4 (85+). Current gap: ${85 - totalScore} points.`}
+`;
+            return {
+                content: [{ type: "text", text: evalResponse }],
+            };
+        }
+        case "get_excellence_checklist": {
+            const checklist = `# Sonance Pre-Delivery Excellence Checklist
+
+Before delivering any Sonance-branded UI work, verify each item:
+
+## Typography
+- [ ] Montserrat font is loaded and applied
+- [ ] Headlines use weight 300 (light) or 500 (medium) — **never 700 (bold)**
+- [ ] Clear 4-level typography hierarchy
+- [ ] Appropriate line-height (1.5-1.75 for body)
+
+## Colors
+- [ ] All colors use semantic CSS variables (--background, --foreground, etc.)
+- [ ] No hardcoded hex colors in classes
+- [ ] Light mode works correctly
+- [ ] Dark mode works correctly
+- [ ] Contrast ratio ≥4.5:1 for text
+
+## Layout & Spacing
+- [ ] Generous section padding (80-120px vertical on desktop)
+- [ ] "Designed to Disappear" aesthetic — breathing room
+- [ ] Sharp corners (0-4px radius max)
+- [ ] No cramped layouts
+
+## Interactivity
+- [ ] Hover states on all clickable elements
+- [ ] Focus-visible states for keyboard navigation
+- [ ] Smooth transitions (200-400ms, ease-out)
+- [ ] No bouncy or dramatic animations
+
+## Accessibility
+- [ ] Semantic HTML elements
+- [ ] ARIA labels where needed
+- [ ] Alt text on images
+- [ ] Keyboard navigable
+
+## Code Quality
+- [ ] TypeScript types/interfaces
+- [ ] Responsive design (mobile-first)
+- [ ] No console errors
+- [ ] Clean, readable code
+
+---
+
+## Quality Gate
+
+**Minimum for delivery:** Score 85+ on self-evaluation (Tier 4)
+**Target:** Score 95+ (Tier 5 — Portfolio-Worthy)
+
+Use \`evaluate_design\` tool to score your work before delivery.
+`;
+            return {
+                content: [{ type: "text", text: checklist }],
+            };
+        }
+        case "get_anti_patterns": {
+            const antiPatterns = `# Sonance Anti-Patterns: What NOT to Do
+
+## Critical Failures (Immediate Tier 1)
+
+These mistakes immediately drop your score to Tier 1 and require a rebuild:
+
+### 1. Bold Headlines
+\`\`\`jsx
+// ❌ WRONG — never use font-bold for headlines
+<h1 className="font-bold text-4xl">Welcome to Sonance</h1>
+
+// ✅ CORRECT — use light (300) or medium (500)
+<h1 className="font-light text-4xl">Welcome to Sonance</h1>
+<h1 className="font-medium text-4xl">Welcome to Sonance</h1>
+\`\`\`
+
+### 2. Hardcoded Colors
+\`\`\`jsx
+// ❌ WRONG — hardcoded hex values
+<div className="bg-[#343d46] text-[#ffffff]">
+
+// ✅ CORRECT — semantic tokens
+<div className="bg-primary text-primary-foreground">
+<div className="bg-sonance-charcoal text-white">
+\`\`\`
+
+### 3. Rounded Corners
+\`\`\`jsx
+// ❌ WRONG — too playful for Sonance
+<div className="rounded-xl">
+<div className="rounded-lg">
+<div className="rounded-2xl">
+
+// ✅ CORRECT — sharp, premium aesthetic
+<div className="rounded-sm">   // 2px
+<div className="rounded-none"> // 0px
+<div className="rounded-md">   // 4px max
+\`\`\`
+
+### 4. Cramped Layouts
+\`\`\`jsx
+// ❌ WRONG — no breathing room
+<section className="py-4 px-2">
+<section className="py-8 px-4">
+
+// ✅ CORRECT — "Designed to Disappear" generous spacing
+<section className="py-20 px-6 lg:py-24 lg:px-8">
+<section className="py-16 px-6 md:py-24">
+\`\`\`
+
+---
+
+## Common Mistakes (Tier 3 Traps)
+
+These keep you stuck at Tier 3 (70-84), below the delivery threshold:
+
+### Wrong Font Family
+\`\`\`jsx
+// ❌ WRONG — generic fonts
+font-family: 'Inter', sans-serif;
+font-family: 'Roboto', sans-serif;
+className="font-inter"
+
+// ✅ CORRECT — Montserrat only
+font-family: 'Montserrat', sans-serif;
+className="font-sans" // with proper Tailwind config
+\`\`\`
+
+### Light Mode Only
+\`\`\`jsx
+// ❌ WRONG — no dark mode support
+<div className="bg-white text-gray-900">
+
+// ✅ CORRECT — theme-aware
+<div className="bg-background text-foreground">
+<div className="bg-white dark:bg-gray-900 text-gray-900 dark:text-white">
+\`\`\`
+
+### Missing Hover States
+\`\`\`jsx
+// ❌ WRONG — static button
+<button className="bg-primary text-white px-6 py-3">
+
+// ✅ CORRECT — interactive feedback
+<button className="bg-primary text-white px-6 py-3 hover:bg-primary-hover transition-colors">
+\`\`\`
+
+### Missing Focus States
+\`\`\`jsx
+// ❌ WRONG — accessibility issue
+<button className="bg-primary">Click</button>
+
+// ✅ CORRECT — keyboard accessible
+<button className="bg-primary focus-visible:ring-2 focus-visible:ring-offset-2 focus-visible:ring-primary">
+\`\`\`
+
+### First-Draft Delivery
+\`\`\`
+// ❌ WRONG workflow
+Create → Deliver
+
+// ✅ CORRECT workflow
+Create → Evaluate → Iterate → Evaluate → Deliver (when score ≥85)
+\`\`\`
+
+---
+
+## Quick Reference
+
+| Anti-Pattern | Fix |
+|--------------|-----|
+| \`font-bold\` on headlines | \`font-light\` or \`font-medium\` |
+| \`#343d46\` hardcoded | \`bg-primary\` or \`var(--primary)\` |
+| \`rounded-lg\` | \`rounded-sm\` or \`rounded-none\` |
+| \`py-4\` sections | \`py-20\` or \`py-24\` |
+| Inter/Roboto font | Montserrat |
+| Light mode only | Add \`dark:\` variants |
+| No hover states | Add \`hover:\` classes |
+| No focus states | Add \`focus-visible:\` classes |
+
+---
+
+**Remember:** The minimum delivery threshold is **85 points (Tier 4)**. Use \`evaluate_design\` to check your score.
+`;
+            return {
+                content: [{ type: "text", text: antiPatterns }],
+            };
+        }
+        case "get_document_template": {
+            const templateArgs = args;
+            if (!templateArgs.format) {
+                return {
+                    content: [{ type: "text", text: "Error: format is required (word-python, pdf-python, or excel-python)" }],
+                    isError: true,
+                };
+            }
+            // Get brand-specific colors
+            const targetBrand = templateArgs.brand || "sonance";
+            const colors = getBrandColorsForDocsMulti(targetBrand);
+            const palette = BRAND_PALETTES[targetBrand];
+            const templateType = templateArgs.template_type || "report";
+            // Brand-specific color names for comments
+            const colorNames = {
+                sonance: { primary: "CHARCOAL", secondary: "SILVER", accent: "TEAL" },
+                iport: { primary: "IPORT_DARK", secondary: "IPORT_ORANGE", accent: "IPORT_ORANGE" },
+                blaze: { primary: "BLAZE_DARK", secondary: "BLAZE_BLUE", accent: "BLAZE_BLUE" },
+            };
+            const brandNames = colorNames[targetBrand];
+            const templates = {
+                "word-python": `# ${palette.name} Word Document Template (python-docx)
+
+\`\`\`python
+from docx import Document
+from docx.shared import Inches, Pt, RGBColor
+from docx.enum.text import WD_ALIGN_PARAGRAPH
+from docx.enum.style import WD_STYLE_TYPE
+
+# ============================================
+# ${palette.name.toUpperCase()} BRAND CONSTANTS (Live from Component Library)
+# ============================================
+${brandNames.primary} = RGBColor(0x${colors.primary.hexNoHash.slice(0, 2)}, 0x${colors.primary.hexNoHash.slice(2, 4)}, 0x${colors.primary.hexNoHash.slice(4, 6)})
+${brandNames.secondary} = RGBColor(0x${colors.secondary.hexNoHash.slice(0, 2)}, 0x${colors.secondary.hexNoHash.slice(2, 4)}, 0x${colors.secondary.hexNoHash.slice(4, 6)})
+WHITE = RGBColor(0xFF, 0xFF, 0xFF)
+${brandNames.accent} = RGBColor(0x${colors.accent.hexNoHash.slice(0, 2)}, 0x${colors.accent.hexNoHash.slice(2, 4)}, 0x${colors.accent.hexNoHash.slice(4, 6)})
+
+FONT_PRIMARY = 'Montserrat'
+FONT_FALLBACK = 'Arial'
+
+# ============================================
+# CREATE DOCUMENT
+# ============================================
+doc = Document()
+
+# Set default font (will use fallback if Montserrat not installed)
+style = doc.styles['Normal']
+font = style.font
+font.name = FONT_FALLBACK  # Use fallback; Montserrat if embedded
+font.size = Pt(11)
+font.color.rgb = ${brandNames.primary}
+
+# Configure margins (1.25" top, 1" sides)
+sections = doc.sections
+for section in sections:
+    section.top_margin = Inches(1.25)
+    section.bottom_margin = Inches(1)
+    section.left_margin = Inches(1)
+    section.right_margin = Inches(1)
+
+# ============================================
+# TITLE STYLE
+# ============================================
+title_style = doc.styles.add_style('${palette.name}Title', WD_STYLE_TYPE.PARAGRAPH)
+title_style.font.size = Pt(28)
+title_style.font.color.rgb = ${brandNames.primary}
+title_style.font.name = FONT_FALLBACK
+title_style.paragraph_format.space_after = Pt(24)
+title_style.paragraph_format.alignment = WD_ALIGN_PARAGRAPH.LEFT
+
+# ============================================
+# HEADING STYLES
+# ============================================
+h1_style = doc.styles.add_style('${palette.name}H1', WD_STYLE_TYPE.PARAGRAPH)
+h1_style.font.size = Pt(18)
+h1_style.font.color.rgb = ${brandNames.primary}
+h1_style.font.name = FONT_FALLBACK
+h1_style.paragraph_format.space_before = Pt(18)
+h1_style.paragraph_format.space_after = Pt(12)
+
+h2_style = doc.styles.add_style('${palette.name}H2', WD_STYLE_TYPE.PARAGRAPH)
+h2_style.font.size = Pt(14)
+h2_style.font.color.rgb = ${brandNames.primary}
+h2_style.font.name = FONT_FALLBACK
+h2_style.paragraph_format.space_before = Pt(14)
+h2_style.paragraph_format.space_after = Pt(8)
+
+# ============================================
+# ADD CONTENT
+# ============================================
+# Add logo (if available)
+# doc.add_picture('path/to/logo.png', width=Inches(2))
+
+# Title
+doc.add_paragraph('${templateType === 'proposal' ? 'Project Proposal' : templateType === 'spec-sheet' ? 'Product Specification' : templateType === 'invoice' ? 'Invoice' : 'Report Title'}', style='${palette.name}Title')
+
+# Introduction
+doc.add_paragraph('Section Heading', style='${palette.name}H1')
+doc.add_paragraph('Your content here. Use the ${palette.name} brand voice: professional, premium, pioneering.')
+
+# Subsection
+doc.add_paragraph('Subsection', style='${palette.name}H2')
+doc.add_paragraph('Additional details with proper formatting.')
+
+# ============================================
+# HEADER/FOOTER
+# ============================================
+header = doc.sections[0].header
+header_para = header.paragraphs[0]
+header_para.text = "${palette.name.toUpperCase()}"
+header_para.style.font.size = Pt(9)
+header_para.style.font.color.rgb = ${brandNames.primary}
+
+footer = doc.sections[0].footer
+footer_para = footer.paragraphs[0]
+footer_para.text = "Confidential | Page "
+footer_para.alignment = WD_ALIGN_PARAGRAPH.CENTER
+
+# ============================================
+# SAVE
+# ============================================
+doc.save('${targetBrand}_${templateType}.docx')
+\`\`\`
+
+## Key Points
+- **Colors**: Use ${brandNames.primary} for text, ${brandNames.secondary} for backgrounds/borders
+- **Fonts**: Montserrat preferred, Arial as fallback
+- **Margins**: 1.25" top, 1" sides and bottom
+- **Hierarchy**: Title (28pt) > H1 (18pt) > H2 (14pt) > Body (11pt)
+${palette.preferredTheme === "dark" ? `- **Note**: ${palette.name} prefers dark backgrounds - consider inverting` : ""}
+`,
+                "pdf-python": `# ${palette.name} PDF Template (ReportLab)
+
+\`\`\`python
+from reportlab.lib.pagesizes import letter
+from reportlab.lib.units import inch
+from reportlab.lib.colors import HexColor
+from reportlab.pdfgen import canvas
+from reportlab.lib.styles import getSampleStyleSheet, ParagraphStyle
+from reportlab.platypus import SimpleDocTemplate, Paragraph, Spacer, Image
+
+# ============================================
+# ${palette.name.toUpperCase()} BRAND CONSTANTS (Live from Component Library)
+# ============================================
+${brandNames.primary} = HexColor('${colors.primary.hex}')
+${brandNames.secondary} = HexColor('${colors.secondary.hex}')
+WHITE = HexColor('${colors.white.hex}')
+${brandNames.accent} = HexColor('${colors.accent.hex}')
+
+FONT_PRIMARY = 'Helvetica'  # Use Helvetica (built-in), or register Montserrat
+
+# ============================================
+# STYLES
+# ============================================
+styles = getSampleStyleSheet()
+
+title_style = ParagraphStyle(
+    '${palette.name}Title',
+    parent=styles['Heading1'],
+    fontName=FONT_PRIMARY,
+    fontSize=28,
+    textColor=${brandNames.primary},
+    spaceAfter=24,
+)
+
+h1_style = ParagraphStyle(
+    '${palette.name}H1',
+    parent=styles['Heading2'],
+    fontName=FONT_PRIMARY,
+    fontSize=18,
+    textColor=${brandNames.primary},
+    spaceBefore=18,
+    spaceAfter=12,
+)
+
+h2_style = ParagraphStyle(
+    '${palette.name}H2',
+    parent=styles['Heading3'],
+    fontName=FONT_PRIMARY,
+    fontSize=14,
+    textColor=${brandNames.primary},
+    spaceBefore=14,
+    spaceAfter=8,
+)
+
+body_style = ParagraphStyle(
+    '${palette.name}Body',
+    parent=styles['Normal'],
+    fontName=FONT_PRIMARY,
+    fontSize=11,
+    textColor=${brandNames.primary},
+    leading=15,  # Line height
+)
+
+# ============================================
+# CREATE PDF
+# ============================================
+doc = SimpleDocTemplate(
+    '${targetBrand}_${templateType}.pdf',
+    pagesize=letter,
+    topMargin=1.25*inch,
+    bottomMargin=1*inch,
+    leftMargin=1*inch,
+    rightMargin=1*inch,
+)
+
+# Content
+content = []
+
+# Logo (optional)
+# content.append(Image('logo.png', width=2*inch, height=0.5*inch))
+
+# Title
+content.append(Paragraph('${templateType === 'proposal' ? 'Project Proposal' : templateType === 'spec-sheet' ? 'Product Specification' : templateType === 'invoice' ? 'Invoice' : 'Report Title'}', title_style))
+
+# Section
+content.append(Paragraph('Section Heading', h1_style))
+content.append(Paragraph('Your content here. Use the ${palette.name} brand voice: professional, premium, pioneering.', body_style))
+
+# Subsection
+content.append(Spacer(1, 12))
+content.append(Paragraph('Subsection', h2_style))
+content.append(Paragraph('Additional details with proper formatting.', body_style))
+
+# Build PDF
+doc.build(content)
+\`\`\`
+
+## Key Points
+- **Colors**: Use HexColor('${colors.primary.hex}') for text
+- **Fonts**: Helvetica (built-in) or register Montserrat TTF
+- **Margins**: 1.25" top, 1" sides and bottom
+- **Leading**: 15pt for body text (1.4x line height)
+${palette.preferredTheme === "dark" ? `- **Note**: ${palette.name} prefers dark backgrounds - consider inverting` : ""}
+`,
+                "excel-python": `# ${palette.name} Excel Template (openpyxl)
+
+\`\`\`python
+from openpyxl import Workbook
+from openpyxl.styles import Font, Fill, PatternFill, Alignment, Border, Side
+from openpyxl.utils import get_column_letter
+
+# ============================================
+# ${palette.name.toUpperCase()} BRAND CONSTANTS (Live from Component Library)
+# ============================================
+${brandNames.primary} = '${colors.primary.hexNoHash}'
+${brandNames.secondary} = '${colors.secondary.hexNoHash}'
+WHITE = '${colors.white.hexNoHash}'
+${brandNames.accent} = '${colors.accent.hexNoHash}'
+
+FONT_PRIMARY = 'Arial'  # Excel-safe fallback for Montserrat
+
+# ============================================
+# STYLES
+# ============================================
+# Header style
+header_font = Font(name=FONT_PRIMARY, size=12, bold=True, color=WHITE)
+header_fill = PatternFill(start_color=${brandNames.primary}, end_color=${brandNames.primary}, fill_type='solid')
+header_alignment = Alignment(horizontal='center', vertical='center')
+
+# Body style
+body_font = Font(name=FONT_PRIMARY, size=11, color=${brandNames.primary})
+body_alignment = Alignment(horizontal='left', vertical='center')
+
+# Accent style (for totals, highlights)
+accent_font = Font(name=FONT_PRIMARY, size=11, bold=True, color=WHITE)
+accent_fill = PatternFill(start_color=${brandNames.accent}, end_color=${brandNames.accent}, fill_type='solid')
+
+# Border style
+thin_border = Border(
+    left=Side(style='thin', color=${brandNames.secondary}),
+    right=Side(style='thin', color=${brandNames.secondary}),
+    top=Side(style='thin', color=${brandNames.secondary}),
+    bottom=Side(style='thin', color=${brandNames.secondary}),
+)
+
+# ============================================
+# CREATE WORKBOOK
+# ============================================
+wb = Workbook()
+ws = wb.active
+ws.title = '${templateType === 'spec-sheet' ? 'Specifications' : templateType === 'invoice' ? 'Invoice' : 'Data'}'
+
+# ============================================
+# HEADER ROW
+# ============================================
+headers = ['Item', 'Description', 'Quantity', 'Price', 'Total']
+for col, header in enumerate(headers, 1):
+    cell = ws.cell(row=1, column=col, value=header)
+    cell.font = header_font
+    cell.fill = header_fill
+    cell.alignment = header_alignment
+    cell.border = thin_border
+
+# ============================================
+# DATA ROWS
+# ============================================
+data = [
+    ['Product A', 'High-quality audio solution', 2, 1500.00, 3000.00],
+    ['Product B', 'Premium installation kit', 1, 250.00, 250.00],
+]
+
+for row_num, row_data in enumerate(data, 2):
+    for col_num, value in enumerate(row_data, 1):
+        cell = ws.cell(row=row_num, column=col_num, value=value)
+        cell.font = body_font
+        cell.alignment = body_alignment
+        cell.border = thin_border
+
+        # Format currency columns
+        if col_num in [4, 5]:
+            cell.number_format = '$#,##0.00'
+
+# ============================================
+# TOTAL ROW
+# ============================================
+total_row = len(data) + 2
+ws.cell(row=total_row, column=4, value='Total:').font = accent_font
+total_cell = ws.cell(row=total_row, column=5, value='=SUM(E2:E{})'.format(total_row - 1))
+total_cell.font = accent_font
+total_cell.fill = accent_fill
+total_cell.number_format = '$#,##0.00'
+
+# ============================================
+# COLUMN WIDTHS
+# ============================================
+column_widths = [15, 35, 12, 12, 15]
+for i, width in enumerate(column_widths, 1):
+    ws.column_dimensions[get_column_letter(i)].width = width
+
+# ============================================
+# SAVE
+# ============================================
+wb.save('${targetBrand}_${templateType}.xlsx')
+\`\`\`
+
+## Key Points
+- **Colors**: Use '${colors.primary.hexNoHash}' (no #) for openpyxl
+- **Header**: ${brandNames.primary} background, white text
+- **Accent**: ${brandNames.accent} for totals and highlights
+- **Border**: ${brandNames.secondary} thin borders
+- **Font**: Arial (Excel-safe Montserrat alternative)
+${palette.preferredTheme === "dark" ? `- **Note**: ${palette.name} prefers dark backgrounds` : ""}
+`,
+            };
+            const template = templates[templateArgs.format];
+            if (!template) {
+                return {
+                    content: [{ type: "text", text: `Unknown format: ${templateArgs.format}` }],
+                    isError: true,
+                };
+            }
+            return {
+                content: [{ type: "text", text: template }],
+            };
+        }
+        case "rebrand_document": {
+            const rebrandArgs = args;
+            if (!rebrandArgs.source_format) {
+                return {
+                    content: [{ type: "text", text: "Error: source_format is required (word, pdf, excel, powerpoint, html, or generic)" }],
+                    isError: true,
+                };
+            }
+            // Get brand-specific colors
+            const targetBrand = rebrandArgs.brand || "sonance";
+            const brandColors = getBrandColorsForDocsMulti(targetBrand);
+            const palette = BRAND_PALETTES[targetBrand];
+            // Build format-specific color syntax dynamically based on brand
+            const buildColorSyntax = (brand) => {
+                const c = getBrandColorsForDocsMulti(brand);
+                return {
+                    word: {
+                        primary: `${c.primary.rgbColor} or '${c.primary.hexNoHash}'`,
+                        secondary: `${c.secondary.rgbColor} or '${c.secondary.hexNoHash}'`,
+                        accent: `${c.accent.rgbColor} or '${c.accent.hexNoHash}'`,
+                        white: `RGBColor(0xFF, 0xFF, 0xFF) or 'FFFFFF'`,
+                    },
+                    pdf: {
+                        primary: `HexColor('${c.primary.hex}')`,
+                        secondary: `HexColor('${c.secondary.hex}')`,
+                        accent: `HexColor('${c.accent.hex}')`,
+                        white: `HexColor('#FFFFFF')`,
+                    },
+                    excel: {
+                        primary: `'${c.primary.hexNoHash}' (no # prefix for openpyxl)`,
+                        secondary: `'${c.secondary.hexNoHash}'`,
+                        accent: `'${c.accent.hexNoHash}'`,
+                        white: `'FFFFFF'`,
+                    },
+                    powerpoint: {
+                        primary: `RGBColor(${c.primary.rgb.r}, ${c.primary.rgb.g}, ${c.primary.rgb.b}) or ${c.primary.hex}`,
+                        secondary: `RGBColor(${c.secondary.rgb.r}, ${c.secondary.rgb.g}, ${c.secondary.rgb.b}) or ${c.secondary.hex}`,
+                        accent: `RGBColor(${c.accent.rgb.r}, ${c.accent.rgb.g}, ${c.accent.rgb.b}) or ${c.accent.hex}`,
+                        white: `RGBColor(255, 255, 255) or #FFFFFF`,
+                    },
+                    html: {
+                        primary: `${c.primary.hex} or rgb(${c.primary.rgb.r}, ${c.primary.rgb.g}, ${c.primary.rgb.b})`,
+                        secondary: `${c.secondary.hex} or rgb(${c.secondary.rgb.r}, ${c.secondary.rgb.g}, ${c.secondary.rgb.b})`,
+                        accent: `${c.accent.hex} or rgb(${c.accent.rgb.r}, ${c.accent.rgb.g}, ${c.accent.rgb.b})`,
+                        white: `#FFFFFF or rgb(255, 255, 255)`,
+                    },
+                    generic: {
+                        primary: `${c.primary.hex} (${palette.name} Primary)`,
+                        secondary: `${c.secondary.hex} (${palette.name} Secondary)`,
+                        accent: `${c.accent.hex} (${palette.name} Accent)`,
+                        white: `#FFFFFF (White)`,
+                    },
+                };
+            };
+            const colorSyntax = buildColorSyntax(targetBrand);
+            const syntax = colorSyntax[rebrandArgs.source_format] || colorSyntax.generic;
+            // Brand-specific color names
+            const colorNames = {
+                sonance: { primary: "Charcoal", secondary: "Silver", accent: "Teal" },
+                iport: { primary: "IPORT Dark", secondary: "Orange", accent: "Orange" },
+                blaze: { primary: "Blaze Dark", secondary: "Blue", accent: "Blue/Red" },
+            };
+            const brandColorNames = colorNames[targetBrand];
+            // Brand-specific logo guidance
+            const logoGuidance = {
+                sonance: `- **Light backgrounds**: Use \`Sonance_logo_dark_mode.png\`
+- **Dark backgrounds**: Use \`Sonance_logo_light_mode.png\`
+- **Path**: \`assets/logos/Sonance_logo_[light/dark]_mode.png\``,
+                iport: `- **Light backgrounds**: Use \`IPORT_Lockup_2C_Dark.png\`
+- **Dark backgrounds**: Use \`IPORT_Lockup_2C_Light.png\`
+- **Note**: IPORT prefers dark backgrounds
+- **Path**: \`assets/logos/IPORT_Lockup_*.png\``,
+                blaze: `- **Light backgrounds**: Use \`Blaze_Lockup_2C_Light.png\`
+- **Dark backgrounds**: Use \`Blaze_Lockup_3C_Dark.png\`
+- **Note**: Blaze prefers dark backgrounds
+- **Path**: \`assets/logos/Blaze_Lockup_*.png\``,
+            };
+            // Build custom color replacement guidance if user provided current colors
+            let customColorSection = "";
+            if (rebrandArgs.current_colors) {
+                customColorSection = `
+### Your Specific Replacements
+
+Based on your description ("${rebrandArgs.current_colors}"):
+
+| What You Have | Replace With | ${palette.name} Color |
+|---------------|--------------|---------------|
+| Blue elements | ${syntax.primary} | ${brandColorNames.primary} (primary) |
+| Gray backgrounds | ${syntax.secondary} | ${brandColorNames.secondary} (secondary) |
+| Accent/highlight colors | ${syntax.accent} | ${brandColorNames.accent} (accent) |
+| Black text | ${syntax.primary} | ${brandColorNames.primary} (softer than pure black) |
+| White backgrounds | Keep as-is or use ${palette.preferredTheme === "dark" ? syntax.primary : "white"} | ${palette.preferredTheme === "dark" ? "Consider dark background" : "White is approved"} |
+
+`;
+            }
+            const rebrandGuide = `# Universal Rebranding Guide: ${rebrandArgs.source_format.toUpperCase()} → ${palette.name}
+
+This guide helps you rebrand **any ${rebrandArgs.source_format} document** to ${palette.name} standards, regardless of its current design or structure.
+
+${palette.preferredTheme === "dark" ? `> **Note:** ${palette.name} prefers **dark backgrounds**. Consider inverting light documents.` : ""}
+
+---
+
+## Core Principle
+
+**Don't redesign the layout—just replace the brand elements:**
+1. Colors → ${palette.name} palette
+2. Fonts → Montserrat (or Arial fallback)
+3. Logos → ${palette.name} logo
+
+The document's structure stays the same; only the brand identity changes.
+
+---
+
+## Color Replacements
+
+### ${palette.name} Brand Palette
+
+| Color | Hex | ${rebrandArgs.source_format.toUpperCase()} Format | Usage |
+|-------|-----|--------|-------|
+| **${brandColorNames.primary}** | ${brandColors.primary.hex} | ${syntax.primary} | Headers, body text, primary elements |
+| **${brandColorNames.secondary}** | ${brandColors.secondary.hex} | ${syntax.secondary} | ${palette.preferredTheme === "dark" ? "Accents, CTAs, highlights" : "Backgrounds, borders, dividers"} |
+| **${brandColorNames.accent}** | ${brandColors.accent.hex} | ${syntax.accent} | Accents, CTAs, highlights |
+| **White** | #FFFFFF | ${syntax.white} | ${palette.preferredTheme === "dark" ? "Text on dark backgrounds" : "Backgrounds, text on dark"} |
+| **Black** | #000000 | Use sparingly | Only for maximum contrast |
+
+### Universal Replacement Rules
+
+| Find (Any Of These) | Replace With |
+|---------------------|--------------|
+| Blues (#0066CC, #0078D4, #1E90FF, navy, etc.) | ${brandColorNames.primary} ${brandColors.primary.hex} |
+| Reds (#FF0000, #CC0000, crimson, etc.) | ${brandColorNames.primary} ${brandColors.primary.hex} or ${brandColorNames.accent} ${brandColors.accent.hex} for CTAs |
+| Greens (#00FF00, #228B22, etc.) | ${brandColorNames.accent} ${brandColors.accent.hex} |
+| Oranges/Yellows | ${brandColorNames.accent} ${brandColors.accent.hex} |
+| Light grays (#F0F0F0, #EEEEEE, #D3D3D3) | ${brandColorNames.secondary} ${brandColors.secondary.hex} |
+| Dark grays (#333333, #666666, #555555) | ${brandColorNames.primary} ${brandColors.primary.hex} |
+| Pure black text (#000000) | ${brandColorNames.primary} ${brandColors.primary.hex} (softer, more premium) |
+${customColorSection}
+---
+
+## Typography Replacements
+
+### Font Substitution Map
+
+| Current Font | Replace With | Notes |
+|--------------|--------------|-------|
+| Arial | Montserrat (or keep Arial as fallback) | Sans-serif ✓ |
+| Helvetica | Montserrat | Very similar feel |
+| Calibri | Montserrat | Microsoft default → ${palette.name} |
+| Times New Roman | Montserrat | Serif → Sans-serif |
+| Georgia | Montserrat | Serif → Sans-serif |
+| Verdana | Montserrat | |
+| Any other font | Montserrat | Default to brand font |
+
+### Weight Mapping
+
+| Current Weight | ${palette.name} Weight | Usage |
+|----------------|----------------|-------|
+| Bold (700) for headers | **Medium (500)** or **Light (300)** | Headlines should NOT be bold |
+| Bold (700) for emphasis | Medium (500) | In-line emphasis |
+| Regular (400) | Regular (400) | Body text |
+| Light (300) | Light (300) | Large display text |
+
+### Size Guidelines (Documents)
+
+| Element | Size |
+|---------|------|
+| Document Title | 28pt |
+| Heading 1 | 18pt |
+| Heading 2 | 14pt |
+| Body Text | 11pt |
+| Captions/Footnotes | 9pt |
+
+---
+
+## Logo Replacement
+
+### Logo Assets
+${logoGuidance[targetBrand]}
+
+### Placement Rules
+
+| Placement | Size | Position |
+|-----------|------|----------|
+| Document Header | 2" wide (150-200px) | Top-left or centered |
+| Cover Page | 3" wide (250-300px) | Centered, upper third |
+| Footer | 1" wide (75-100px) | Bottom-left or centered |
+| Email Signature | 150px wide | Left-aligned |
+
+### Clear Space
+Maintain clear space around the logo equal to the height of the first letter on all sides.
+
+---
+
+## Whitespace & Spacing
+
+### The "Designed to Disappear" Principle
+${palette.name} aesthetic requires **generous whitespace**. When rebranding:
+
+- **Don't compress** — if the original has tight spacing, expand it
+- **Section padding**: Minimum 40-60pt between major sections
+- **Paragraph spacing**: 1.15 line height, 6-12pt after paragraphs
+- **Margins**: 1.25" top, 1" sides (for print documents)
+
+---
+
+## Quick Checklist
+
+Before considering your rebrand complete:
+
+- [ ] All brand colors replaced with ${brandColorNames.primary}/${brandColorNames.secondary}/${brandColorNames.accent} palette
+- [ ] No original brand colors remain
+- [ ] Font changed to Montserrat (or Arial fallback)
+- [ ] Headlines use weight 300-500 (not bold 700)
+- [ ] Logo replaced with ${palette.name} logo
+- [ ] Logo has proper clear space
+- [ ] Adequate whitespace maintained
+- [ ] Document feels premium and "breathable"
+${palette.preferredTheme === "dark" ? `- [ ] Dark background applied (${palette.name} preference)` : ""}
+
+---
+
+## Format-Specific Tips: ${rebrandArgs.source_format.toUpperCase()}
+
+${rebrandArgs.source_format === "word" ? `
+### Word/DOCX
+- Use **Find & Replace** (Ctrl+H) for text colors
+- Update **Styles** (Heading 1, Heading 2, Normal) for global changes
+- Set default font in **Design > Fonts**
+- Header/Footer: Insert > Header > Edit, add logo
+` : ""}${rebrandArgs.source_format === "pdf" ? `
+### PDF
+- Use **Adobe Acrobat Pro** Edit PDF feature, or
+- Regenerate from source (Word, InDesign, etc.)
+- For ReportLab/python: Use \`HexColor('${brandColors.primary.hex}')\`
+- Embed Montserrat font or use Helvetica (built-in)
+` : ""}${rebrandArgs.source_format === "excel" ? `
+### Excel
+- Use **Cell Styles** for consistent formatting
+- Header row: Fill color \`${brandColors.primary.hexNoHash}\`, font color \`FFFFFF\`
+- Data rows: Font color \`${brandColors.primary.hexNoHash}\`
+- Borders: Color \`${brandColors.secondary.hexNoHash}\`
+- Accent cells: Fill \`${brandColors.accent.hexNoHash}\`
+` : ""}${rebrandArgs.source_format === "powerpoint" ? `
+### PowerPoint
+- Update **Slide Master** for global changes
+- Theme colors: Edit in Design > Variants > Colors
+- Replace logos on Slide Master for all slides
+- Title slides: Use Light (300) weight Montserrat
+` : ""}${rebrandArgs.source_format === "html" ? `
+### HTML/Web
+- Update CSS variables or inline styles
+- Use semantic classes if available (bg-primary, text-foreground)
+- For emails: All styles must be inline
+- Include font fallback: \`'Montserrat', Arial, sans-serif\`
+` : ""}${rebrandArgs.source_format === "generic" ? `
+### General Approach
+1. Identify all color values in the document
+2. Replace using the color mapping above
+3. Update font family and weights
+4. Replace any logos with ${palette.name} logo
+5. Review spacing and add whitespace where needed
+` : ""}
+
+---
+
+**Remember:** The goal is to make the document unmistakably ${palette.name} while preserving its original structure and content.
+`;
+            return {
+                content: [{ type: "text", text: rebrandGuide }],
+            };
+        }
         default:
             return {
                 content: [{ type: "text", text: `Unknown tool: ${name}` }],
@@ -928,6 +2588,22 @@ server.setRequestHandler(ListPromptsRequestSchema, async () => ({
                 },
             ],
         },
+        {
+            name: "quality-check",
+            description: "Evaluate UI work against the Sonance Design Excellence Framework and get an improvement plan",
+            arguments: [
+                {
+                    name: "code",
+                    description: "The code/component to evaluate",
+                    required: true,
+                },
+                {
+                    name: "description",
+                    description: "Brief description of what the component does",
+                    required: false,
+                },
+            ],
+        },
     ],
 }));
 server.setRequestHandler(GetPromptRequestSchema, async (request) => {
@@ -988,6 +2664,49 @@ Provide specific feedback on what matches and what needs to change.`,
             ],
         };
     }
+    if (name === "quality-check") {
+        const code = promptArgs?.code || "";
+        const description = promptArgs?.description || "Component";
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `Evaluate this ${description} against the Sonance Design Excellence Framework:
+
+\`\`\`
+${code}
+\`\`\`
+
+Follow these steps:
+1. Call evaluate_design with the code to get an automated score
+2. Call get_anti_patterns to check for critical failures
+3. If score < 85 (Tier 4), provide specific fixes for each gap
+4. If score >= 85, suggest polish improvements for Tier 5
+
+Framework reminder:
+- Tier 5 (95-100): Portfolio-worthy
+- Tier 4 (85-94): Professional - minimum for delivery
+- Tier 3 (70-84): Iterate before delivery
+- Tier 2 (50-69): Major iteration needed
+- Tier 1 (0-49): Rebuild from scratch
+
+Scoring dimensions:
+- Brand Compliance (20%): Semantic colors, no hardcoded hex, sharp corners
+- Typography (15%): Montserrat, light/medium weights only, hierarchy
+- Color Application (10%): Dark mode support, CSS variables
+- Layout & Spacing (15%): Generous whitespace, py-20/24 sections
+- Visual Hierarchy (15%): Size and weight variation
+- Medium Excellence (15%): TypeScript, accessibility, transitions
+- Polish & Finishing (10%): Hover states, focus states
+
+Provide the score, tier, and a clear improvement plan to reach Tier 4+ if needed.`,
+                    },
+                },
+            ],
+        };
+    }
     throw new Error(`Unknown prompt: ${name}`);
 });
 // ============================================