enterprise-ui-architect-cli 1.0.0

package/assets/scripts/search.py

@@ -0,0 +1,241 @@
+#!/usr/bin/env python3
+"""
+Search utility for Enterprise UI Architect skill data.
+No external dependencies. Pure Python 3.
+
+Usage:
+  python search.py --query "table loading" --domain component-standards -n 5
+  python search.py --query "form modal" --domain anti-patterns -n 3
+  python search.py --query "spacing token" --domain tokens
+  python search.py --query "fintech" --domain industries
+  python search.py --query "bento grid" --domain styles
+  python search.py --query "fintech" --design-system -p "MyBank"
+  python search.py --query "saas" --design-system -f markdown --persist -p "MyApp"
+"""
+
+import argparse
+import csv
+import os
+import sys
+from pathlib import Path
+
+DOMAINS = {
+    "page-patterns": "page-patterns.csv",
+    "component-standards": "component-standards.csv",
+    "review-rubric": "review-rubric.csv",
+    "anti-patterns": "anti-patterns.csv",
+    "tokens": "tokens.csv",
+    "accessibility": "accessibility-checks.csv",
+    "industries": "industries.csv",
+    "styles": "styles.csv",
+    "color-palettes": "color-palettes.csv",
+    "typography": "typography.csv",
+    "charts": "charts.csv",
+    "pre-delivery-checklist": "pre-delivery-checklist.csv",
+    "api-integration": "api-integration-patterns.csv",
+    "data-strategies": "data-source-strategies.csv",
+}
+
+
+def find_data_dir() -> Path:
+    """Locate the data directory relative to this script."""
+    script_dir = Path(__file__).resolve().parent
+    candidates = [
+        script_dir.parent / "data",
+        script_dir.parent / "assets" / "data",
+        Path.cwd() / "src" / "enterprise-ui-architect" / "data",
+        Path.cwd() / "data",
+    ]
+    for c in candidates:
+        if c.exists():
+            return c
+    return candidates[0]
+
+
+def bm25_score(row: dict, query_terms: list[str], avgdl: float, k1: float = 1.5, b: float = 0.75) -> float:
+    """Simple BM25-inspired scoring across all row values."""
+    text = " ".join(str(v).lower() for v in row.values() if v is not None)
+    doc_len = len(text.split())
+    score = 0.0
+    for term in query_terms:
+        tf = text.count(term.lower())
+        if tf == 0:
+            continue
+        # IDF approximation: log(1 + N/n) where N=total docs, n=docs with term
+        # For simplicity, use a fixed reasonable IDF
+        idf = 1.0
+        tf_component = (tf * (k1 + 1)) / (tf + k1 * (1 - b + b * (doc_len / max(avgdl, 1))))
+        score += idf * tf_component
+    return score
+
+
+def search_csv(data_dir: Path, domain: str, query: str, max_results: int = 10) -> str:
+    filename = DOMAINS.get(domain)
+    if not filename:
+        available = ", ".join(DOMAINS.keys())
+        return f"Error: Unknown domain '{domain}'. Available: {available}"
+
+    filepath = data_dir / filename
+    if not filepath.exists():
+        return f"Error: File not found: {filepath}"
+
+    query_terms = query.split()
+    results = []
+    total_docs = 0
+
+    # First pass: count total docs and average doc length
+    with open(filepath, newline="", encoding="utf-8") as f:
+        reader = csv.DictReader(f)
+        docs = list(reader)
+        total_docs = len(docs)
+        total_len = sum(len(" ".join(str(v) for v in r.values() if v is not None).split()) for r in docs)
+        avgdl = total_len / max(total_docs, 1)
+
+    # Second pass: score
+    for row in docs:
+        s = bm25_score(row, query_terms, avgdl)
+        if s > 0:
+            results.append((s, row))
+
+    results.sort(key=lambda x: x[0], reverse=True)
+    results = results[:max_results]
+
+    if not results:
+        return f"No results for query '{query}' in {domain}."
+
+    lines = [f"# Results: {domain}", f"Query: `{query}` | Matches: {len(results)}\n"]
+    for idx, (score, row) in enumerate(results, 1):
+        lines.append(f"## {idx}. Score: {score:.2f}")
+        for key, value in row.items():
+            lines.append(f"- **{key}**: {value}")
+        lines.append("")
+
+    return "\n".join(lines)
+
+
+def generate_design_system(data_dir: Path, query: str, product_name: str = "Your Product", output_format: str = "ascii") -> str:
+    """Generate a complete design system based on industry query."""
+    industries_result = search_csv(data_dir, "industries", query, max_results=3)
+    styles_result = search_csv(data_dir, "styles", query, max_results=3)
+    palettes_result = search_csv(data_dir, "color-palettes", query, max_results=3)
+    typography_result = search_csv(data_dir, "typography", query, max_results=3)
+
+    if output_format == "markdown":
+        lines = [
+            f"# Design System: {product_name}",
+            "",
+            f"Generated for query: `{query}`",
+            "",
+            "---",
+            "",
+            "## Industry Match",
+            industries_result,
+            "",
+            "## Recommended Styles",
+            styles_result,
+            "",
+            "## Color Palette",
+            palettes_result,
+            "",
+            "## Typography",
+            typography_result,
+            "",
+            "---",
+            "",
+            "## Pre-Delivery Checklist",
+            "Apply the checks from `pre-delivery-checklist.csv` for each page type you build.",
+            "",
+        ]
+        return "\n".join(lines)
+
+    # ASCII format
+    lines = [
+        "+----------------------------------------------------------------------------------------+",
+        f"|  TARGET: {product_name:<78} |",
+        "|  DESIGN SYSTEM (Enterprise UI Architect)                                              |",
+        "+----------------------------------------------------------------------------------------+",
+        "",
+        f"  Industry Query: {query}",
+        "",
+        "  INDUSTRY MATCH:",
+        industries_result,
+        "",
+        "  STYLES:",
+        styles_result,
+        "",
+        "  COLORS:",
+        palettes_result,
+        "",
+        "  TYPOGRAPHY:",
+        typography_result,
+        "",
+        "  PRE-DELIVERY: Apply checks from pre-delivery-checklist.csv",
+        "",
+        "+----------------------------------------------------------------------------------------+",
+    ]
+    return "\n".join(lines)
+
+
+def persist_design_system(output: str, product_name: str) -> None:
+    """Save design system to design-system/MASTER.md for hierarchical retrieval."""
+    ds_dir = Path.cwd() / "design-system"
+    ds_dir.mkdir(exist_ok=True)
+    master_path = ds_dir / "MASTER.md"
+    with open(master_path, "w", encoding="utf-8") as f:
+        f.write(output)
+    print(f"Design system persisted to: {master_path}")
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Search Enterprise UI Architect skill data CSVs."
+    )
+    parser.add_argument("--query", "-q", required=True, help="Search query (space-separated keywords).")
+    parser.add_argument(
+        "--domain", "-d", default="page-patterns",
+        help="Domain to search. Use 'all' to search across all domains."
+    )
+    parser.add_argument(
+        "-n", type=int, default=10, help="Max results to return (default: 10)."
+    )
+    parser.add_argument(
+        "--design-system", action="store_true",
+        help="Generate a complete design system for the query."
+    )
+    parser.add_argument(
+        "--product", "-p", default="Your Product",
+        help="Product name for design system output."
+    )
+    parser.add_argument(
+        "--format", "-f", default="ascii", choices=["ascii", "markdown"],
+        help="Design system output format."
+    )
+    parser.add_argument(
+        "--persist", action="store_true",
+        help="Save design system to design-system/MASTER.md."
+    )
+    args = parser.parse_args()
+
+    data_dir = find_data_dir()
+
+    if args.design_system:
+        output = generate_design_system(data_dir, args.query, args.product, args.format)
+        print(output)
+        if args.persist:
+            persist_design_system(output, args.product)
+        return
+
+    if args.domain == "all":
+        for domain in DOMAINS:
+            print(f"\n{'='*60}")
+            print(f"Domain: {domain}")
+            print(f"{'='*60}")
+            print(search_csv(data_dir, domain, args.query, args.n))
+        return
+
+    output = search_csv(data_dir, args.domain, args.query, args.n)
+    print(output)
+
+
+if __name__ == "__main__":
+    main()

package/assets/templates/base/quick-reference.md

@@ -0,0 +1,123 @@
+# Enterprise UI Architect — Quick Reference
+
+## Verdict
+Premium Admin = visual feel. MUI v7 = implementation. Ant Design = architecture discipline.
+
+## Component Stack
+- UI: `@mui/material` v7
+- Forms: `react-hook-form` + `Controller`
+- Tables: `@tanstack/react-table`
+- Validation: `valibot` / `zod` via `@hookform/resolvers`
+
+## Design System Generator
+```bash
+python scripts/search.py --query "fintech" --design-system --product "MyBank"
+python scripts/search.py --query "saas" --design-system --persist --product "MyApp"
+```
+
+## Drawer vs Dialog vs Page
+- **Dialog**: delete confirm, yes/no, small focused form
+- **Drawer**: quick create/edit, advanced filters, record preview (width 300-400px)
+- **Page**: complex forms, multi-section edit, wizard, heavy validation
+
+## Layout Modes
+- **Skin**: default (shadow) | bordered (outline, no shadow)
+- **Navbar**: fixed | floating | detached | attached | blur
+- **Content**: compact (1440px) | wide (full-bleed)
+- **Sidebar**: 260px / 71px collapsed, semi-dark supported
+
+## Table Checklist
+- [ ] typed columns via `createColumnHelper`
+- [ ] stable rowKey
+- [ ] sorting + filtering + search (debounced 500ms)
+- [ ] pagination via MUI Pagination (rounded tonal)
+- [ ] loading / empty / error states
+- [ ] row actions + optional bulk actions
+- [ ] status chips + formatted dates/numbers
+- [ ] responsive behavior
+- [ ] accessible headers
+- [ ] controlled filter/sort/page state
+- [ ] header height 56px, body 50px
+- [ ] horizontal borders only
+- [ ] first/last column padding 24px, internal 16px
+- [ ] NEVER use MUI TablePagination for logic
+- [ ] ALWAYS use TanStack react-table for logic
+
+## Form Checklist
+- [ ] typed values via RHF generic
+- [ ] validation rules (inline or schema resolver)
+- [ ] field-level errors + helper text
+- [ ] required indicators
+- [ ] submit loading + disabled state
+- [ ] cancel / reset via `reset()`
+- [ ] dirty state protection
+- [ ] responsive field grid (MUI Grid spacing 6)
+- [ ] logical sections with Divider + Typography headers
+- [ ] accessible labels
+- [ ] success / error feedback
+- [ ] label above input (slotProps inputLabel shrink true transform none)
+- [ ] focus: 2px border + primary-sm shadow
+- [ ] start adornments via slotProps input
+
+## Styling Checklist
+- [ ] MUI theme tokens used (palette, spacing, shape)
+- [ ] CSS variables via MUI cssVariables
+- [ ] shared spacing scale (theme.spacing factor)
+- [ ] shared typography scale (theme.typography)
+- [ ] semantic color roles
+- [ ] reusable variants (contained, tonal, outlined)
+- [ ] Tailwind utilities for layout/flex/grid only
+- [ ] slotProps over deprecated inner prop APIs
+- [ ] no random hex colors
+- [ ] no random margins / font sizes
+- [ ] no heavy inline sx props on generic primitives
+- [ ] header height 54px, content padding 24px, max-width 1440px
+
+## Keyboard Navigation
+- Autocomplete: Arrow keys, Enter, Escape, Home/End
+- Select: Space open, arrows navigate, Enter select, typeahead
+- Tabs: Left/Right arrows change tabs; Tab enters panel
+- Accordion: Enter/Space toggle; arrows between headers
+- Slider: Arrow keys step; Home/End min/max; PageUp/PageDown
+- Switch: Space toggles
+- Dialog: Escape closes; Tab traps focus
+
+## Backend Data Detection
+- [ ] Check for backend presence (API docs proxy repo)
+- [ ] Check for real-time endpoints (WebSocket STOMP SSE)
+- [ ] Check for existing API layer (api/ services/ hooks/)
+- [ ] Use TanStack Query for all server state
+- [ ] Use MSW for mock data (never hardcode in components)
+- [ ] Create chart adapter function (API response → chart data)
+- [ ] Use Skeleton for chart loading states
+- [ ] Implement retry + error fallback for unstable APIs
+- [ ] Use refetchInterval or WebSocket for real-time dashboards
+
+## Pre-Delivery Checklist
+- [ ] All interactive elements have hover states and cursor-pointer
+- [ ] Focus states are visible and consistent
+- [ ] No emojis as icons — only SVG or icon font
+- [ ] Text contrast meets 4.5:1 minimum
+- [ ] prefers-reduced-motion respected
+- [ ] Responsive at 375px, 768px, 1024px, 1440px
+- [ ] Loading states for all async operations
+- [ ] Empty states for every list/table/grid
+- [ ] Error states with helpful messages
+- [ ] Browser back button works for filter/sort/page state
+
+## Accessibility Checklist
+- [ ] labels on all inputs
+- [ ] errors linked via aria-describedby
+- [ ] required fields indicated
+- [ ] focus trapped in Dialog/Drawer
+- [ ] focus returns to trigger on close
+- [ ] status uses icon + text (not color alone)
+- [ ] table headers semantic
+- [ ] row actions keyboard accessible
+- [ ] touch targets >= 44x44px
+- [ ] contrast >= 4.5:1
+- [ ] skip links present
+- [ ] focus visible indicators
+- [ ] aria-live for dynamic updates
+- [ ] aria-label on icon-only buttons
+- [ ] prefers-reduced-motion respected

package/assets/templates/base/skill-content.md

@@ -0,0 +1,184 @@
+# Enterprise UI Architect — Skill Content
+
+## What This Skill Does
+Guides AI coding assistants to build premium admin dashboards that use MUI v7 components, follow Ant Design engineering discipline, and leverage design system intelligence for consistent, industry-appropriate UIs.
+
+## Visual Direction (Enterprise Admin)
+- Card-based layouts with consistent padding and elevation
+- Sidebar + navbar composition (header 54px, sidebar 260px/71px collapsed)
+- Status chips with semantic colors and tonal variant
+- Dashboard widget rhythm with 24px gaps
+- Polished tables with action menus (header 56px, body 50px, horizontal borders only)
+- Clean form sections with footer actions
+- Label-above-input text fields with primary focus shadow
+- Stat cards: horizontal (stats left, avatar right) or vertical (avatar top, stats below)
+
+## Implementation Engine (MUI v7)
+- MUI Card, CardHeader, CardContent, CardActions, Divider
+- MUI Dialog, Drawer, Button, Chip, TextField, Pagination
+- MUI Grid for responsive layouts (no `item` prop in v7)
+- MUI Tabs, Descriptions, Badge, Switch
+- Theme tokens via theme.palette, theme.spacing, theme.shape
+
+## Architecture Principles (Ant Design-inspired)
+- TypeScript-first component APIs
+- Predictable Form patterns (react-hook-form + Controller)
+- Predictable Table patterns (TanStack Table + MUI Pagination)
+- Drawer/Dialog discipline
+- Design token usage
+- Reusable abstractions
+- Accessibility compliance
+- Production-ready state handling
+
+## Component Stack
+- UI: `@mui/material` v7
+- Forms: `react-hook-form` + `Controller`
+- Tables: `@tanstack/react-table`
+- Validation: `valibot` / `zod` via `@hookform/resolvers`
+- Icons: Tabler Icons
+- Data Fetching: TanStack Query (preferred) or SWR
+- Real-Time: WebSocket / STOMP / Socket.io / SSE
+- API Mocking: MSW (Mock Service Worker) for development
+
+## Design System Generation
+Generate a complete design system for any admin product:
+
+```bash
+python scripts/search.py --query "fintech" --design-system --product "MyBank"
+```
+
+Outputs: pattern + style + colors + typography + effects + anti-patterns + checklist
+
+Persist for cross-session use:
+```bash
+python scripts/search.py --query "saas" --design-system --persist --product "MyApp"
+```
+
+## Industry-Specific Reasoning
+15 admin industries with tailored rules:
+- SaaS / B2B Platform
+- Fintech / Banking
+- Healthcare / Medical
+- E-commerce Admin
+- Logistics / Supply Chain
+- HR / People Management
+- CRM / Sales
+- ERP / Manufacturing
+- Education / LMS
+- Government / Public Sector
+- Cybersecurity / SOC
+- Real Estate / Property
+- Energy / Utilities
+- Media / Content Management
+- Nonprofit / NGO
+
+## UI Styles for Admin Dashboards
+15 styles rated for admin suitability:
+- Minimalism & Swiss Style (10/10)
+- Bento Box Grid (10/10)
+- Dark Mode OLED (9/10)
+- Soft UI Evolution (9/10)
+- Data-Dense Dashboard (10/10)
+- Executive Dashboard (8/10)
+- Real-Time Monitoring (9/10)
+- Accessible & Inclusive (10/10)
+- Glassmorphism (7/10)
+- AI-Native UI (7/10)
+
+## Color Palettes
+20 admin-specific palettes matched to industries.
+
+## Typography Pairings
+15 curated font pairings with Google Fonts imports.
+
+## Charts for Dashboards
+25 chart types mapped to admin use cases:
+- Revenue/Growth: Line, Area, Sparkline
+- Comparisons: Bar, Grouped Bar, Horizontal Bar
+- Proportions: Donut, Pie, Treemap
+- Real-time: Gauge, Metric Cards
+- Project: Gantt, Timeline
+- Geographic: Map, Choropleth
+
+## Page Patterns Quick Map
+| Page Type | Visual Feel | MUI + RHF Architecture |
+|---|---|---|
+| CRUD List | Card + toolbar + table + pagination | TanStack Table + MUI Pagination + Drawer filters |
+| Complex Form | Card sections + footer actions | RHF + Controller + MUI TextField + dirty guard |
+| Dashboard | Widget grid + charts + activity | MUI Card + StatCard + Grid + Chip tonal |
+| Detail | Summary + tabs + related lists | MUI Tabs + Descriptions + Card per section |
+| Settings | Tab categories + toggles + save | MUI Tabs + Card per section + Switch + RHF |
+| Wizard | Stepper + step validation | RHF step schema + MUI Stepper + summary review |
+| Auth | Centered card + blank layout | BlankLayout + MUI Card + RHF + fullWidth buttons |
+| Blank | Full-width centered no sidebar | BlankLayout + centered content |
+
+## Component Standards Quick Map
+| Component | Key Rules |
+|---|---|
+| PageLayout | Consistent padding, max-width, background from theme, layout modes |
+| Card | MUI Card + CardHeader + CardContent + CardActions + Divider |
+| DataTable | TanStack Table, typed columns, rowKey, loading/empty/error, MUI Pagination rounded tonal |
+| FormSection | MUI Card + section title + Divider + Grid spacing 6 |
+| StatusChip | MUI Chip, variant tonal, size small, icon + text, semantic color |
+| Drawer | MUI Drawer, anchor right, width 300-400px, manual reset on close |
+| Dialog | MUI Dialog, maxWidth md for edit, scroll body, closeAfterTransition false for confirmations |
+| SubmitBar | MUI CardActions, Button contained primary + tonal secondary, loading, dirty guard |
+| CustomTextField | MUI TextField variant filled with styled overrides, label above input, slotProps inputLabel shrink true |
+| StatCard | MUI Card, horizontal or vertical, avatar + tonal Chip, border accent optional |
+| Button | MUI Button, variant contained/tonal/outlined, loading via CircularProgress, active scale 0.98 |
+| Pagination | MUI Pagination, shape rounded, variant tonal, connected to table state |
+| OptionMenu | MUI Menu + IconButton trigger, typed options array |
+| Skeleton | MUI Skeleton for known-shape content loading, not CircularProgress |
+| ErrorBoundary | React ErrorBoundary at page/layout level with fallback UI |
+
+## Backend Data Detection
+Before building charts tables or forms detect the data source:
+- Backend exists + API documented → Connect real API immediately
+- Backend exists + API not documented → Explore endpoints reverse engineer
+- Backend in development → MSW or json-server with agreed contract
+- No backend → json-server or localStorage mock
+- Backend unstable → Retry logic + circuit breaker + MSW fallback
+
+### Chart + Backend Integration
+- Use TanStack Query `useQuery` for chart data
+- Map API response to chart format in adapter function
+- Use `staleTime` and `refetchInterval` for real-time dashboards
+- Show Skeleton (not spinner) while chart data loads
+- Use `placeholderData` to show previous data while refetching
+
+### Real-Time Patterns
+| Backend | Frontend Pattern |
+|---|---|
+| Spring Boot + STOMP | SockJS + STOMP.js + Zustand |
+| Node.js + Socket.io | Socket.io-client + event store |
+| Any + SSE | EventSource with reconnect |
+| Any + polling | TanStack Query `refetchInterval` |
+
+## Anti-Patterns to Catch
+- Complex forms inside Dialogs
+- Inline table column definitions
+- Random hex colors or margins
+- Missing loading/empty/error states
+- Color-only status indicators
+- Missing dirty form guard
+- Inline sx props on generic primitives
+- Vertical table borders
+- Floating labels without shrink
+- Using MUI TablePagination for logic instead of TanStack state
+- Using native MUI Table without TanStack react-table
+- Missing CardHeader/CardContent/CardActions structure
+- Using `item` prop on MUI v7 Grid
+- Forgetting `declare module` for `tonal` variant
+- Using MUI v7 without AppRouterCacheProvider in Next.js
+- Using rules inline alongside schema resolver
+- No Error Boundaries
+- Using CircularProgress instead of Skeleton for content loading
+- Icon-only buttons without aria-label
+- Disabling focus outlines globally
+
+## Review Verdict Scale
+- Excellent
+- Good but needs refinement
+- Visually acceptable but structurally weak
+- Not production-ready
+- Needs redesign

package/assets/templates/platforms/claude.json

@@ -0,0 +1,19 @@
+{
+  "platform": "claude",
+  "outputPath": ".claude/skills/enterprise-ui-architect/SKILL.md",
+  "format": "claude-skill",
+  "description": "Claude Code skill file for Enterprise UI Architect",
+  "contentSource": "SKILL.md",
+  "dataPaths": {
+    "page-patterns": "data/page-patterns.csv",
+    "component-standards": "data/component-standards.csv",
+    "review-rubric": "data/review-rubric.csv",
+    "anti-patterns": "data/anti-patterns.csv",
+    "tokens": "data/tokens.csv",
+    "accessibility": "data/accessibility-checks.csv"
+  },
+  "scripts": {
+    "search": "scripts/search.py"
+  },
+  "quickReference": "templates/base/quick-reference.md"
+}

package/assets/templates/platforms/codex.json

@@ -0,0 +1,19 @@
+{
+  "platform": "codex",
+  "outputPath": ".codex/skills/enterprise-ui-architect/SKILL.md",
+  "format": "codex-skill",
+  "description": "OpenAI Codex skill file for Enterprise UI Architect",
+  "contentSource": "SKILL.md",
+  "quickReference": "templates/base/quick-reference.md",
+  "rules": [
+    "Premium enterprise admin panels define visual feel; Ant Design principles guide architecture.",
+    "Reuse existing PageLayout, Card, Table, Form abstractions.",
+    "Dialog = confirmations; Drawer = quick edit/filter; Page = complex forms.",
+    "Never put complex forms in Dialogs.",
+    "Use typed columns; avoid inline column definitions.",
+    "Tokens only; no random hex colors or inline styles.",
+    "Tables need loading/empty/error states.",
+    "Forms need dirty guard, validation, submit loading.",
+    "StatusChip = color + icon + text."
+  ]
+}

package/assets/templates/platforms/copilot.json

@@ -0,0 +1,18 @@
+{
+  "platform": "copilot",
+  "outputPath": ".github/prompts/enterprise-ui-architect.prompt.md",
+  "format": "github-prompt",
+  "description": "GitHub Copilot prompt file for Enterprise UI Architect skill",
+  "contentSource": "templates/base/skill-content.md",
+  "systemPrefix": "You are an expert frontend architect specializing in premium enterprise admin dashboards. You combine enterprise-inspired visual composition with MUI v7 component implementation and Ant Design-level engineering discipline.",
+  "injectSections": [
+    "Core Philosophy",
+    "When to Apply",
+    "Drawer vs Dialog vs Page Rules",
+    "Table Standard",
+    "Form Standard",
+    "Theme and Styling Standard",
+    "Review Output Format"
+  ],
+  "promptSuffix": "Before writing or editing UI code, inspect the existing codebase for PageLayout, Card, Table, Form, Drawer, Dialog, and StatusChip abstractions. Reuse existing conventions. Do not introduce unnecessary abstractions."
+}

package/assets/templates/platforms/cursor.json

@@ -0,0 +1,36 @@
+{
+  "platform": "cursor",
+  "outputPath": ".cursor/rules/enterprise-ui-architect.mdc",
+  "format": "cursor-rule",
+  "description": "Cursor IDE rule file for Enterprise UI Architect skill",
+  "frontmatter": {
+    "description": "Enterprise UI Architect — build premium admin UIs with MUI v7 and Ant Design engineering discipline",
+    "globs": "**/*.{tsx,jsx,vue,ts,js}",
+    "alwaysApply": false
+  },
+  "contentSource": "templates/base/skill-content.md",
+  "injectSections": [
+    "Core Philosophy",
+    "When to Apply",
+    "Drawer vs Dialog vs Page Rules",
+    "Table Standard",
+    "Form Standard",
+    "Theme and Styling Standard",
+    "Review Output Format"
+  ],
+  "rules": [
+    "Always inspect existing PageLayout, Card, Table, Form abstractions before creating new ones.",
+    "Use Drawer for quick create/edit and advanced filters; use Dialog only for confirmations and small forms.",
+    "Never put complex multi-section forms inside a Dialog.",
+    "Use typed column configs for Tables via createColumnHelper; never define columns inline inside page components.",
+    "Use react-hook-form + Controller for all production forms; never use uncontrolled MUI inputs directly.",
+    "Use MUI theme tokens for colors, spacing, shadows, and typography; avoid random hex colors or inline sx props.",
+    "Add loading, empty, and error states to every production Table.",
+    "Add dirty state protection, submit loading, and validation to every production Form.",
+    "Status indicators must use MUI Chip with variant='tonal' and combine color + icon + text; never color alone.",
+    "Use TanStack react-table for all data table logic; never use raw MUI Table without TanStack.",
+    "Use custom Pagination wrapper around MUI Pagination with shape='rounded' variant='tonal'; never use MUI TablePagination for logic.",
+    "Always structure Cards with CardHeader + CardContent + optional CardActions separated by Divider.",
+    "Reuse existing conventions; do not introduce unnecessary abstractions."
+  ]
+}

package/assets/templates/platforms/windsurf.json

@@ -0,0 +1,26 @@
+{
+  "platform": "windsurf",
+  "outputPath": ".windsurf/rules/enterprise-ui-architect.md",
+  "format": "windsurf-rule",
+  "description": "Windsurf IDE rule file for Enterprise UI Architect skill",
+  "contentSource": "templates/base/skill-content.md",
+  "injectSections": [
+    "Core Philosophy",
+    "When to Apply",
+    "Drawer vs Dialog vs Page Rules",
+    "Table Standard",
+    "Form Standard",
+    "Theme and Styling Standard",
+    "Review Output Format"
+  ],
+  "rules": [
+    "Inspect existing abstractions before adding new UI primitives.",
+    "Drawer for quick create/edit/filters; Dialog for confirmations only.",
+    "Never place complex forms inside Dialogs.",
+    "Typed table columns in shared files; never inline in pages.",
+    "Tokens for all visual properties; no random hex or inline styles.",
+    "Loading/empty/error states required on Tables.",
+    "Dirty guard + submit loading + validation required on Forms.",
+    "StatusChip uses color + icon + text."
+  ]
+}

package/dist/commands/init.d.ts

@@ -0,0 +1,5 @@
+export declare function initCommand(options: {
+    ai?: string;
+    offline?: boolean;
+}): void;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAwMA,wBAAgB,WAAW,CAAC,OAAO,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAqB7E"}