@joelbonito/mcp-server 5.1.4 → 5.1.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +4 -4
  2. package/dist/registry.js +2 -2
  3. package/dist/worker.js +1 -1
  4. package/package.json +2 -2
package/README.md CHANGED
@@ -10,7 +10,7 @@
10
10
  </p>
11
11
 
12
12
  <p align="center">
13
- MCP server for <strong>Inove AI Framework</strong> — 21 agents, 41 skills, and 22 workflows served via the Model Context Protocol.
13
+ MCP server for <strong>Inove AI Framework</strong> — 22 agents, 42 skills, and 25 workflows served via the Model Context Protocol.
14
14
  </p>
15
15
 
16
16
  Zero disk usage per project. Auto-updates on every run. Setup in 30 seconds.
@@ -48,9 +48,9 @@ Any MCP-compatible tool works — point it to `npx -y @joelbonito/mcp-server` as
48
48
 
49
49
  | Tool | Description |
50
50
  |------|-------------|
51
- | `list_agents` | List all 21 specialized agents |
51
+ | `list_agents` | List all 22 specialized agents |
52
52
  | `list_skills` | List all 41 modular skills |
53
- | `list_workflows` | List all 22 workflows |
53
+ | `list_workflows` | List all 25 workflows |
54
54
  | `get_agent` | Get full agent content by name |
55
55
  | `get_skill` | Get skill content (SKILL.md + sub-files) |
56
56
  | `get_workflow` | Get workflow content by name |
@@ -109,7 +109,7 @@ AI: [calls route_task] → recommends debugger + security-auditor
109
109
 
110
110
  ```
111
111
  User: "List available workflows"
112
- AI: [calls list_workflows] → 22 workflows with descriptions
112
+ AI: [calls list_workflows] → 25 workflows with descriptions
113
113
  → Shows /define, /debug, /create, /deploy, etc.
114
114
  ```
115
115
 
package/dist/registry.js CHANGED
@@ -339,6 +339,6 @@ export const EMBEDDED_WORKFLOWS = {
339
339
  "track": "---\ndescription: Analisa o backlog de tarefas e gera/atualiza a barra de progresso visual do projeto.\n---\n\n# Workflow: /track\n\n> **Propósito:** Atualizar a visualização de progresso do projeto com base nas tarefas concluídas no backlog.\n\n## Regras Críticas\n\n1. **LEITURA** — Este workflow apenas lê e gera relatórios.\n2. **AUTOMÁTICO** — Pode ser executado a qualquer momento.\n3. **IDEMPOTENTE** — Rodar múltiplas vezes sempre gera o mesmo resultado.\n\n## Fluxo de Execução\n\n### Passo 1: Localizar Backlog\n\nProcure pelo arquivo de tarefas em ordem de prioridade:\n\n1. `docs/BACKLOG.md`\n2. `docs/*/global-task-list.md`\n3. `docs/**/task-list.md`\n\nSe não encontrar, informe:\n```\n❌ Nenhum arquivo de backlog encontrado.\n Execute /define primeiro para criar a estrutura do projeto.\n```\n\n---\n\n### Passo 2: Executar Script\n\n```bash\npython3 .agents/scripts/progress_tracker.py\n```\n\nO script irá:\n1. Ler o arquivo de backlog\n2. Contar tarefas `[x]` (concluídas) vs `[ ]` (pendentes)\n3. Calcular % global e por Epic\n4. Gerar `docs/progress-bar.md`\n\n---\n\n### Passo 3: Exibir Resultado\n\nMostre um resumo no terminal:\n\n```markdown\n📊 **Progresso Atualizado!**\n\n██████████████░░░░░░ 70%\n\n| Métrica | Valor |\n|---------|-------|\n| Concluídas | 21 |\n| Total | 30 |\n\nArquivo gerado: `docs/progress-bar.md`\n```\n\n---\n\n## Integração com Sessões de Trabalho\n\nEste workflow pode ser invocado automaticamente ao final de sessões:\n\n```markdown\n# No seu log de sessão ou ao usar /log-end:\n> Executando /track para atualizar progresso...\n```\n\n---\n\n## Exemplo de Uso\n\n```\nUsuário: /track\n```\n\nOutput esperado:\n```\n📊 Progresso do Projeto\n\nGeral: ████████████████░░░░ 80% (24/30 tarefas)\n\nPor Epic:\n• Epic 1: Auth ████████████████████ 100%\n• Epic 2: API ████████████████░░░░ 80%\n• Epic 3: Dashboard ████████████░░░░░░░░ 60%\n\n✅ Arquivo atualizado: docs/progress-bar.md\n```\n\n---\n\n## Troubleshooting\n\n| Problema | Solução |\n|----------|---------|\n| Script não encontrado | Verifique se `.agents/scripts/progress_tracker.py` existe |\n| Backlog não encontrado | Execute `/define` primeiro |\n| Percentual incorreto | Verifique formato das tarefas (`- [x]` ou `- [ ]`) |\n",
340
340
  "ui-ux-pro-max": "---\ndescription: AI-powered design intelligence with 50+ styles, 95+ color palettes, and automated design system generation\n---\n\n# ui-ux-pro-max\n\nComprehensive design guide for web and mobile applications. Contains 50+ styles, 97 color palettes, 57 font pairings, 99 UX guidelines, and 25 chart types across 9 technology stacks. Searchable database with priority-based recommendations.\n\n## Prerequisites\n\nCheck if Python is installed:\n\n```bash\npython3 --version || python --version\n```\n\nIf Python is not installed, install it based on user's OS:\n\n**macOS:**\n```bash\nbrew install python3\n```\n\n**Ubuntu/Debian:**\n```bash\nsudo apt update && sudo apt install python3\n```\n\n**Windows:**\n```powershell\nwinget install Python.Python.3.12\n```\n\n---\n\n## Regras Críticas\n\n1. **SEM EMOJIS COMO ÍCONES** — Usar SVG icons (Heroicons, Lucide, Simple Icons), nunca emojis na UI.\n2. **DESIGN SYSTEM OBRIGATÓRIO** — Sempre gerar design system com `--design-system` antes de implementar.\n3. **CONTRASTE VERIFICADO** — Texto deve ter contraste mínimo de 4.5:1 em ambos os modos (light/dark).\n4. **CURSOR POINTER** — Todos os elementos clicáveis devem ter `cursor-pointer`.\n5. **RESPONSIVO TESTADO** — Verificar em 375px, 768px, 1024px e 1440px antes de entregar.\n\n## Fluxo de Execução\n\nWhen user requests UI/UX work (design, build, create, implement, review, fix, improve), follow this workflow:\n\n### Step 1: Analyze User Requirements\n\nExtract key information from user request:\n- **Product type**: SaaS, e-commerce, portfolio, dashboard, landing page, etc.\n- **Style keywords**: minimal, playful, professional, elegant, dark mode, etc.\n- **Industry**: healthcare, fintech, gaming, education, etc.\n- **Stack**: React, Vue, Next.js, or default to `html-tailwind`\n\n### Step 2: Generate Design System (REQUIRED)\n\n**Always start with `--design-system`** to get comprehensive recommendations with reasoning:\n\n```bash\npython3 .agents/.shared/ui-ux-pro-max/scripts/search.py \"<product_type> <industry> <keywords>\" --design-system [-p \"Project Name\"]\n```\n\nThis command:\n1. Searches 5 domains in parallel (product, style, color, landing, typography)\n2. Applies reasoning rules from `ui-reasoning.csv` to select best matches\n3. Returns complete design system: pattern, style, colors, typography, effects\n4. Includes anti-patterns to avoid\n\n**Example:**\n```bash\npython3 .agents/.shared/ui-ux-pro-max/scripts/search.py \"beauty spa wellness service\" --design-system -p \"Serenity Spa\"\n```\n\n### Step 2b: Persist Design System (Master + Overrides Pattern)\n\nTo save the design system for hierarchical retrieval across sessions, add `--persist`:\n\n```bash\npython3 .agents/.shared/ui-ux-pro-max/scripts/search.py \"<query>\" --design-system --persist -p \"Project Name\"\n```\n\nThis creates:\n- `design-system/MASTER.md` — Global Source of Truth with all design rules\n- `design-system/pages/` — Folder for page-specific overrides\n\n**With page-specific override:**\n```bash\npython3 .agents/.shared/ui-ux-pro-max/scripts/search.py \"<query>\" --design-system --persist -p \"Project Name\" --page \"dashboard\"\n```\n\nThis also creates:\n- `design-system/pages/dashboard.md` — Page-specific deviations from Master\n\n**How hierarchical retrieval works:**\n1. When building a specific page (e.g., \"Checkout\"), first check `design-system/pages/checkout.md`\n2. If the page file exists, its rules **override** the Master file\n3. If not, use `design-system/MASTER.md` exclusively\n\n### Step 2c: Visual Preview with Stitch [REQUIRED]\n\nAfter generating the design system, create visual mockups to validate design tokens:\n\n1. **Check Stitch MCP availability:** Call `mcp__stitch__list_projects` to confirm connectivity. If Stitch is not available, **STOP** and inform the user to configure Stitch MCP before continuing.\n2. **Create or find project:** Use `mcp__stitch__create_project` with the project name\n3. **Generate key screens:** Use design system tokens (colors, typography, geometry) in the Stitch prompt\n - Embed actual token values: `\"primary color #e8590c, heading font DM Sans, 2px border radius\"`\n - Generate 1-2 representative screens (e.g., main dashboard + landing hero)\n - Use `GEMINI_3_PRO` for best quality\n4. **Validate visual coherence:**\n - Do the generated screens look cohesive with the design tokens?\n - Does the color palette work in a real UI context?\n - Is the typography hierarchy visible?\n5. **Iterate if needed:**\n - If mockups reveal token issues, adjust the design system and regenerate\n - Load `stitch-ui-design` skill for detailed prompt engineering guidance\n\n> **Skill:** Load `stitch-ui-design` for prompt templates and anti-cliche rules.\n> **Note:** This step validates the design system visually and is REQUIRED for all UI projects.\n\n### Step 3: Supplement with Detailed Searches (as needed)\n\nAfter getting the design system, use domain searches to get additional details:\n\n```bash\npython3 .agents/.shared/ui-ux-pro-max/scripts/search.py \"<keyword>\" --domain <domain> [-n <max_results>]\n```\n\n**When to use detailed searches:**\n\n| Need | Domain | Example |\n|------|--------|---------|\n| More style options | `style` | `--domain style \"glassmorphism dark\"` |\n| Chart recommendations | `chart` | `--domain chart \"real-time dashboard\"` |\n| UX best practices | `ux` | `--domain ux \"animation accessibility\"` |\n| Alternative fonts | `typography` | `--domain typography \"elegant luxury\"` |\n| Landing structure | `landing` | `--domain landing \"hero social-proof\"` |\n\n### Step 4: Stack Guidelines (Default: html-tailwind)\n\nGet implementation-specific best practices. If user doesn't specify a stack, **default to `html-tailwind`**.\n\n```bash\npython3 .agents/.shared/ui-ux-pro-max/scripts/search.py \"<keyword>\" --stack html-tailwind\n```\n\nAvailable stacks: `html-tailwind`, `react`, `nextjs`, `vue`, `svelte`, `swiftui`, `react-native`, `flutter`, `shadcn`, `jetpack-compose`\n---\n\n## Search Reference\n\n### Available Domains\n\n| Domain | Use For | Example Keywords |\n|--------|---------|------------------|\n| `product` | Product type recommendations | SaaS, e-commerce, portfolio, healthcare, beauty, service |\n| `style` | UI styles, colors, effects | glassmorphism, minimalism, dark mode, brutalism |\n| `typography` | Font pairings, Google Fonts | elegant, playful, professional, modern |\n| `color` | Color palettes by product type | saas, ecommerce, healthcare, beauty, fintech, service |\n| `landing` | Page structure, CTA strategies | hero, hero-centric, testimonial, pricing, social-proof |\n| `chart` | Chart types, library recommendations | trend, comparison, timeline, funnel, pie |\n| `ux` | Best practices, anti-patterns | animation, accessibility, z-index, loading |\n| `react` | React/Next.js performance | waterfall, bundle, suspense, memo, rerender, cache |\n| `web` | Web interface guidelines | aria, focus, keyboard, semantic, virtualize |\n| `prompt` | AI prompts, CSS keywords | (style name) |\n\n### Available Stacks\n\n| Stack | Focus |\n|-------|-------|\n| `html-tailwind` | Tailwind utilities, responsive, a11y (DEFAULT) |\n| `react` | State, hooks, performance, patterns |\n| `nextjs` | SSR, routing, images, API routes |\n| `vue` | Composition API, Pinia, Vue Router |\n| `svelte` | Runes, stores, SvelteKit |\n| `swiftui` | Views, State, Navigation, Animation |\n| `react-native` | Components, Navigation, Lists |\n| `flutter` | Widgets, State, Layout, Theming |\n| `shadcn` | shadcn/ui components, theming, forms, patterns |\n| `jetpack-compose` | Composables, Modifiers, State Hoisting, Recomposition |\n\n---\n\n## Example Workflow\n\n**User request:** \"Làm landing page cho dịch vụ chăm sóc da chuyên nghiệp\"\n\n### Step 1: Analyze Requirements\n- Product type: Beauty/Spa service\n- Style keywords: elegant, professional, soft\n- Industry: Beauty/Wellness\n- Stack: html-tailwind (default)\n\n### Step 2: Generate Design System (REQUIRED)\n\n```bash\npython3 .agents/.shared/ui-ux-pro-max/scripts/search.py \"beauty spa wellness service elegant\" --design-system -p \"Serenity Spa\"\n```\n\n**Output:** Complete design system with pattern, style, colors, typography, effects, and anti-patterns.\n\n### Step 3: Supplement with Detailed Searches (as needed)\n\n```bash\n# Get UX guidelines for animation and accessibility\npython3 .agents/.shared/ui-ux-pro-max/scripts/search.py \"animation accessibility\" --domain ux\n\n# Get alternative typography options if needed\npython3 .agents/.shared/ui-ux-pro-max/scripts/search.py \"elegant luxury serif\" --domain typography\n```\n\n### Step 4: Stack Guidelines\n\n```bash\npython3 .agents/.shared/ui-ux-pro-max/scripts/search.py \"layout responsive form\" --stack html-tailwind\n```\n\n**Then:** Synthesize design system + detailed searches and implement the design.\n\n---\n\n## Output Formats\n\nThe `--design-system` flag supports two output formats:\n\n```bash\n# ASCII box (default) - best for terminal display\npython3 .agents/.shared/ui-ux-pro-max/scripts/search.py \"fintech crypto\" --design-system\n\n# Markdown - best for documentation\npython3 .agents/.shared/ui-ux-pro-max/scripts/search.py \"fintech crypto\" --design-system -f markdown\n```\n\n---\n\n## Tips for Better Results\n\n1. **Be specific with keywords** - \"healthcare SaaS dashboard\" > \"app\"\n2. **Search multiple times** - Different keywords reveal different insights\n3. **Combine domains** - Style + Typography + Color = Complete design system\n4. **Always check UX** - Search \"animation\", \"z-index\", \"accessibility\" for common issues\n5. **Use stack flag** - Get implementation-specific best practices\n6. **Iterate** - If first search doesn't match, try different keywords\n\n---\n\n## Common Rules for Professional UI\n\nThese are frequently overlooked issues that make UI look unprofessional:\n\n### Icons & Visual Elements\n\n| Rule | Do | Don't |\n|------|----|----- |\n| **No emoji icons** | Use SVG icons (Heroicons, Lucide, Simple Icons) | Use emojis like 🎨 🚀 ⚙️ as UI icons |\n| **Stable hover states** | Use color/opacity transitions on hover | Use scale transforms that shift layout |\n| **Correct brand logos** | Research official SVG from Simple Icons | Guess or use incorrect logo paths |\n| **Consistent icon sizing** | Use fixed viewBox (24x24) with w-6 h-6 | Mix different icon sizes randomly |\n\n### Interaction & Cursor\n\n| Rule | Do | Don't |\n|------|----|----- |\n| **Cursor pointer** | Add `cursor-pointer` to all clickable/hoverable cards | Leave default cursor on interactive elements |\n| **Hover feedback** | Provide visual feedback (color, shadow, border) | No indication element is interactive |\n| **Smooth transitions** | Use `transition-colors duration-200` | Instant state changes or too slow (>500ms) |\n\n### Light/Dark Mode Contrast\n\n| Rule | Do | Don't |\n|------|----|----- |\n| **Glass card light mode** | Use `bg-white/80` or higher opacity | Use `bg-white/10` (too transparent) |\n| **Text contrast light** | Use `#0F172A` (slate-900) for text | Use `#94A3B8` (slate-400) for body text |\n| **Muted text light** | Use `#475569` (slate-600) minimum | Use gray-400 or lighter |\n| **Border visibility** | Use `border-gray-200` in light mode | Use `border-white/10` (invisible) |\n\n### Layout & Spacing\n\n| Rule | Do | Don't |\n|------|----|----- |\n| **Floating navbar** | Add `top-4 left-4 right-4` spacing | Stick navbar to `top-0 left-0 right-0` |\n| **Content padding** | Account for fixed navbar height | Let content hide behind fixed elements |\n| **Consistent max-width** | Use same `max-w-6xl` or `max-w-7xl` | Mix different container widths |\n\n---\n\n## Pre-Delivery Checklist\n\nBefore delivering UI code, verify these items:\n\n### Visual Quality\n- [ ] No emojis used as icons (use SVG instead)\n- [ ] All icons from consistent icon set (Heroicons/Lucide)\n- [ ] Brand logos are correct (verified from Simple Icons)\n- [ ] Hover states don't cause layout shift\n- [ ] Use theme colors directly (bg-primary) not var() wrapper\n\n### Interaction\n- [ ] All clickable elements have `cursor-pointer`\n- [ ] Hover states provide clear visual feedback\n- [ ] Transitions are smooth (150-300ms)\n- [ ] Focus states visible for keyboard navigation\n\n### Light/Dark Mode\n- [ ] Light mode text has sufficient contrast (4.5:1 minimum)\n- [ ] Glass/transparent elements visible in light mode\n- [ ] Borders visible in both modes\n- [ ] Test both modes before delivery\n\n### Layout\n- [ ] Floating elements have proper spacing from edges\n- [ ] No content hidden behind fixed navbars\n- [ ] Responsive at 375px, 768px, 1024px, 1440px\n- [ ] No horizontal scroll on mobile\n\n### Accessibility\n- [ ] All images have alt text\n- [ ] Form inputs have labels\n- [ ] Color is not the only indicator\n- [ ] `prefers-reduced-motion` respected\n\n### Visual Validation (if Stitch was used in Step 2c)\n- [ ] Generated mockups align with design system tokens (colors, typography, geometry)\n- [ ] Key screens (dashboard, landing) have both MOBILE and DESKTOP variants\n- [ ] No purple, glassmorphism, or standard hero split in mockups (anti-cliche check)\n- [ ] Stitch project ID and screen IDs documented for future reference"
341
341
  };
342
- export const EMBEDDED_ARCHITECTURE = "# Inove AI Framework - Architecture\n\n> Multi-agent AI development framework with 21 agents, 41 skills, 22 workflows, and multi-platform support.\n\n---\n\n## 1. Overview\n\nInove AI Framework is a modular system that enhances AI coding assistants with:\n\n- **21 Specialist Agents** -- Role-based AI personas for different domains\n- **41 Skills** -- Domain-specific knowledge modules loaded on demand\n- **22 Workflows** -- Slash command procedures for structured processes\n- **22 Scripts** -- Python/Bash automation for task tracking, sessions, and validation\n- **Multi-Platform Support** -- Claude Code, Codex CLI, and Antigravity/Gemini\n\nThe canonical source of truth lives in `.agents/`. Other platforms access it through symlinks.\n\n---\n\n## 2. Directory Structure\n\n```\n.agents/\n├── ARCHITECTURE.md # This file\n├── INSTRUCTIONS.md # Canonical instructions (synced to CLAUDE.md, AGENTS.md)\n├── agents/ # 21 specialist agents\n│ ├── orchestrator.md\n│ ├── project-planner.md\n│ ├── product-manager.md\n│ ├── product-owner.md\n│ ├── frontend-specialist.md\n│ ├── backend-specialist.md\n│ ├── database-architect.md\n│ ├── mobile-developer.md\n│ ├── security-auditor.md\n│ ├── penetration-tester.md\n│ ├── debugger.md\n│ ├── devops-engineer.md\n│ ├── test-engineer.md\n│ ├── qa-automation-engineer.md\n│ ├── documentation-writer.md\n│ ├── code-archaeologist.md\n│ ├── performance-optimizer.md\n│ ├── seo-specialist.md\n│ ├── game-developer.md\n│ ├── ux-researcher.md\n│ └── explorer-agent.md\n├── skills/ # 41 skill modules\n│ ├── api-patterns/\n│ ├── app-builder/\n│ │ └── templates/ # 13 project templates\n│ ├── architecture/\n│ ├── ... # (see Skills section below)\n│ └── webapp-testing/\n├── workflows/ # 22 slash command workflows\n│ ├── brainstorm.md\n│ ├── context.md\n│ ├── ... # (see Workflows section below)\n│ └── ui-ux-pro-max.md\n├── scripts/ # 22 automation scripts\n│ ├── auto_finish.py\n│ ├── dashboard.py\n│ ├── ... # (see Scripts section below)\n│ └── verify_all.py\n├── config/ # Platform-specific configuration\n│ ├── codex.toml\n│ └── mcp.json\n├── rules/ # Global rules\n│ └── GEMINI.md\n└── .shared/ # Shared data resources\n └── ui-ux-pro-max/\n ├── data/ # 13 CSV datasets + 12 stack CSVs\n └── scripts/ # Python scripts (core, design_system, search)\n```\n\n---\n\n## 3. Agents (21)\n\nEach agent is a Markdown file in `.agents/agents/` defining a persona, rules, and skill dependencies.\n\n| Agent | Focus | Skills |\n| ----- | ----- | ------ |\n| `orchestrator` | Multi-agent coordination | parallel-agents, behavioral-modes, plan-writing, brainstorming, architecture, lint-and-validate, powershell-windows, bash-linux |\n| `project-planner` | Discovery, architecture, task planning | app-builder, plan-writing, brainstorming, architecture, system-design, gap-analysis |\n| `product-manager` | Requirements, user stories | plan-writing, brainstorming |\n| `product-owner` | Strategy, backlog, MVP, GAP analysis | plan-writing, brainstorming, gap-analysis, doc-review |\n| `frontend-specialist` | Web UI/UX, React, Next.js | nextjs-react-expert, web-design-guidelines, tailwind-patterns, frontend-design, lint-and-validate, gap-analysis |\n| `backend-specialist` | APIs, Node.js, Python, business logic | nodejs-best-practices, python-patterns, api-patterns, database-design, mcp-builder, lint-and-validate, powershell-windows, bash-linux |\n| `database-architect` | Schema design, queries, migrations | database-design |\n| `mobile-developer` | iOS, Android, React Native | mobile-design |\n| `security-auditor` | Security compliance, OWASP | vulnerability-scanner, red-team-tactics, api-patterns, gap-analysis |\n| `penetration-tester` | Offensive security testing | vulnerability-scanner, red-team-tactics, api-patterns |\n| `debugger` | Root cause analysis | systematic-debugging |\n| `devops-engineer` | CI/CD, Docker, infrastructure | deployment-procedures, server-management, powershell-windows, bash-linux |\n| `test-engineer` | Testing strategies | testing-patterns, tdd-workflow, webapp-testing, code-review-checklist, lint-and-validate |\n| `qa-automation-engineer` | E2E testing, CI pipelines | webapp-testing, testing-patterns, lint-and-validate |\n| `documentation-writer` | Manuals, technical docs | documentation-templates |\n| `code-archaeologist` | Legacy code, refactoring | code-review-checklist |\n| `performance-optimizer` | Speed, Web Vitals | performance-profiling |\n| `seo-specialist` | SEO, visibility, GEO | seo-fundamentals, geo-fundamentals |\n| `game-developer` | Game logic, mechanics | game-development |\n| `ux-researcher` | UX research, user flows, wireframes | ux-research, frontend-design, stitch-ui-design, gap-analysis |\n| `explorer-agent` | Codebase analysis, discovery | architecture, plan-writing, brainstorming, systematic-debugging |\n\n> **Note:** All agents implicitly load `clean-code` as a Tier 0 (mandatory) skill.\n\n---\n\n## 4. Skills (41)\n\nSkills are modular knowledge domains in `.agents/skills/`. Each contains at minimum a `SKILL.md` file, and optionally `scripts/` and `references/` subdirectories.\n\n### Frontend and UI\n\n| Skill | Description |\n| ----- | ----------- |\n| `nextjs-react-expert` | Next.js/React performance patterns and optimization rules |\n| `tailwind-patterns` | Tailwind CSS utility patterns and best practices |\n| `frontend-design` | UI/UX patterns, design systems, color/typography systems |\n| `web-design-guidelines` | UI audit against Web Interface Guidelines |\n| `stitch-ui-design` | Stitch MCP integration for generating high-fidelity UI designs from textual wireframes |\n\n### Backend and API\n\n| Skill | Description |\n| ----- | ----------- |\n| `api-patterns` | REST, GraphQL, tRPC design patterns and documentation |\n| `nodejs-best-practices` | Node.js async patterns, modules, error handling |\n| `python-patterns` | Python standards, FastAPI, idiomatic patterns |\n\n### Database\n\n| Skill | Description |\n| ----- | ----------- |\n| `database-design` | Schema design, indexing, migrations, ORM selection, optimization |\n\n### Architecture and Planning\n\n| Skill | Description |\n| ----- | ----------- |\n| `app-builder` | Full-stack app scaffolding with 13 project templates |\n| `architecture` | System design patterns, trade-off analysis, context discovery |\n| `system-design` | Large-scale system design patterns |\n| `plan-writing` | Task planning and breakdown |\n| `brainstorming` | Socratic questioning and dynamic exploration |\n| `gap-analysis` | Identify gaps in product, UX, infrastructure, security, and tech |\n\n### Testing and Quality\n\n| Skill | Description |\n| ----- | ----------- |\n| `testing-patterns` | Jest, Vitest, testing strategies |\n| `webapp-testing` | E2E testing with Playwright |\n| `tdd-workflow` | Test-driven development methodology |\n| `code-review-checklist` | Code review standards and checklists |\n| `lint-and-validate` | Linting, type coverage, validation scripts |\n\n### Security\n\n| Skill | Description |\n| ----- | ----------- |\n| `vulnerability-scanner` | Security auditing, OWASP checklists |\n| `red-team-tactics` | Offensive security techniques |\n\n### Mobile\n\n| Skill | Description |\n| ----- | ----------- |\n| `mobile-design` | Mobile UI/UX, platform-specific patterns (iOS/Android), debugging |\n\n### Game Development\n\n| Skill | Description |\n| ----- | ----------- |\n| `game-development` | 2D/3D games, multiplayer, VR/AR, game design, audio |\n\n### SEO and Growth\n\n| Skill | Description |\n| ----- | ----------- |\n| `seo-fundamentals` | SEO, E-E-A-T, Core Web Vitals optimization |\n| `geo-fundamentals` | Generative Engine Optimization (GEO) |\n\n### UX Research\n\n| Skill | Description |\n| ----- | ----------- |\n| `ux-research` | UX research methodology, user flows, usability testing |\n\n### DevOps and Infrastructure\n\n| Skill | Description |\n| ----- | ----------- |\n| `deployment-procedures` | CI/CD workflows, deploy procedures |\n| `server-management` | Infrastructure management, monitoring |\n\n### Shell and CLI\n\n| Skill | Description |\n| ----- | ----------- |\n| `bash-linux` | Linux commands, shell scripting |\n| `powershell-windows` | Windows PowerShell scripting |\n\n### Performance\n\n| Skill | Description |\n| ----- | ----------- |\n| `performance-profiling` | Web Vitals, Lighthouse audits, profiling |\n\n### Documentation\n\n| Skill | Description |\n| ----- | ----------- |\n| `documentation-templates` | README, API docs, ADR, changelog templates |\n| `doc-review` | Document review and validation |\n\n### Internationalization\n\n| Skill | Description |\n| ----- | ----------- |\n| `i18n-localization` | Internationalization patterns and i18n checking |\n\n### Agent Behavior and Coordination\n\n| Skill | Description |\n| ----- | ----------- |\n| `behavioral-modes` | Agent persona modes and behavioral configuration |\n| `parallel-agents` | Multi-agent coordination patterns |\n| `intelligent-routing` | Request routing to appropriate agents |\n\n### Cross-Cutting\n\n| Skill | Description |\n| ----- | ----------- |\n| `clean-code` | Pragmatic coding standards (mandatory Tier 0 for all agents) |\n| `systematic-debugging` | Root cause analysis, troubleshooting methodology |\n| `mcp-builder` | Model Context Protocol server/tool building |\n\n### App Builder Templates (13)\n\nThe `app-builder` skill includes a `templates/` subdirectory with scaffolding for:\n\n| Template | Stack |\n| -------- | ----- |\n| `astro-static` | Astro static site |\n| `chrome-extension` | Chrome browser extension |\n| `cli-tool` | Command-line tool |\n| `electron-desktop` | Electron desktop app |\n| `express-api` | Express.js REST API |\n| `flutter-app` | Flutter cross-platform app |\n| `monorepo-turborepo` | Turborepo monorepo setup |\n| `nextjs-fullstack` | Next.js full-stack app |\n| `nextjs-saas` | Next.js SaaS starter |\n| `nextjs-static` | Next.js static site |\n| `nuxt-app` | Nuxt.js application |\n| `python-fastapi` | Python FastAPI backend |\n| `react-native-app` | React Native mobile app |\n\n---\n\n## 5. Workflows (22)\n\nSlash command procedures in `.agents/workflows/`. Invoke with `/command`.\n\n| Command | Description |\n| ------- | ----------- |\n| `/define` | Full project planning in 9 phases with GAP Analysis |\n| `/journeys` | Document user journeys and flows |\n| `/context` | Create project context and technical conventions |\n| `/readiness` | Validate readiness for implementation |\n| `/brainstorm` | Socratic exploration and ideation |\n| `/create` | Create new features with guided implementation |\n| `/debug` | Systematic debugging workflow |\n| `/enhance` | Improve and refactor existing code |\n| `/deploy` | Application deployment procedure |\n| `/test` | Generate and run tests |\n| `/plan` | Task breakdown and planning |\n| `/orchestrate` | Multi-agent coordination |\n| `/preview` | Preview changes before applying |\n| `/track` | Update task progress |\n| `/status` | Consolidated project dashboard |\n| `/log` | Record session activity |\n| `/finish` | Mark tasks as complete |\n| `/review` | Post-sprint code review and quality checks |\n| `/test-book` | Generate or update testing notebook artifacts |\n| `/release` | Final release workflow for MVP or production |\n| `/ui-ux-pro-max` | Design system workflow with styles, palettes, and fonts |\n| `/squad` | Manage squads: reusable packages of agents, skills, and workflows |\n\n---\n\n## 6. Scripts (22)\n\nAutomation scripts in `.agents/scripts/` for task management, validation, and session tracking.\n\n### Task and Progress Management\n\n| Script | Description |\n| ------ | ----------- |\n| `finish_task.py` | Mark a backlog task as complete |\n| `auto_finish.py` | Automated task completion protocol |\n| `progress_tracker.py` | Update and display progress bar |\n| `checklist.py` | Priority-based validation (security, lint, types, tests, UX, SEO) |\n| `shard_epic.py` | Split backlog into individual story files (shard/sync/status/clean) |\n\n### Session Management\n\n| Script | Description |\n| ------ | ----------- |\n| `auto_session.py` | Start/stop session tracking |\n| `session_logger.py` | Log session activity |\n| `project_analyzer.py` | Analyze project state and tech stack |\n\n### Dashboard and Metrics\n\n| Script | Description |\n| ------ | ----------- |\n| `dashboard.py` | Consolidated project dashboard view |\n| `metrics.py` | Generate insights and metrics |\n\n### Multi-Agent Coordination\n\n| Script | Description |\n| ------ | ----------- |\n| `lock_manager.py` | File lock management for multi-agent work |\n| `sync_tracker.py` | Synchronization tracking between agents |\n| `platform_compat.py` | Auto-detect active AI platform (claude_code, codex, unknown) |\n\n### Validation\n\n| Script | Description |\n| ------ | ----------- |\n| `verify_all.py` | Comprehensive pre-deployment verification (all checks) |\n| `validate_installation.py` | Verify framework installation and setup |\n| `validate_traceability.py` | Validate backlog-to-code traceability |\n| `_check_runner.py` | Shared check runner utilities for verification scripts |\n\n### Notifications and Previews\n\n| Script | Description |\n| ------ | ----------- |\n| `notifier.py` | Send notifications on task events |\n| `reminder_system.py` | Scheduled reminders for pending tasks |\n| `auto_preview.py` | Automated preview generation |\n| `generate_web_data.py` | Generate JSON data artifacts for web docs/dashboard |\n\n### Squads and Recovery\n\n| Script | Description |\n| ------ | ----------- |\n| `squad_manager.py` | Create, validate, activate, deactivate, and export squads |\n| `recovery.py` | Retry with exponential backoff, safe execution with rollback, git checkpoints |\n\n### Git Hooks\n\n| Script | Description |\n| ------ | ----------- |\n| `install_git_hooks.sh` | Install pre-commit and post-commit hooks |\n\n---\n\n## 7. Multi-Platform Support\n\nInove AI Framework runs on three AI platforms simultaneously. The canonical source is `.agents/`, and each platform accesses it through symlinks or direct references.\n\n### Platform Configuration\n\n| Platform | Instruction File | Agents Path | Skills Path | Workflows Path |\n| -------- | ---------------- | ----------- | ----------- | -------------- |\n| Claude Code | `CLAUDE.md` | `.claude/agents/` -> `.agents/agents/` | `.claude/skills/` -> `.agents/skills/` | `.agents/workflows/` (direct) |\n| Codex CLI | `AGENTS.md` | `.codex/agents/` -> `.agents/agents/` | `.codex/skills/` -> `.agents/skills/` | `.codex/prompts/` -> `.agents/workflows/` |\n| Antigravity/Gemini | `GEMINI.md` | `.agents/agents/` (direct) | `.agents/skills/` (direct) | `.agents/workflows/` (direct) |\n\n### Symlink Map\n\n```\n.claude/\n├── agents -> ../.agents/agents (symlink)\n├── skills -> ../.agents/skills (symlink)\n├── project_instructions.md\n├── settings.json\n└── settings.local.json\n\n.codex/\n├── agents -> ../.agents/agents (symlink)\n├── skills -> ../.agents/skills (symlink)\n├── prompts -> ../.agents/workflows (symlink)\n└── config.toml\n```\n\n### Platform Detection\n\nScripts auto-detect the active platform:\n\n```python\nfrom platform_compat import get_agent_source\nsource = get_agent_source() # Returns 'claude_code', 'codex', or 'unknown'\n```\n\nEnvironment variable override:\n\n```bash\nexport AGENT_SOURCE=claude_code # For Claude Code\nexport AGENT_SOURCE=codex # For Codex CLI\nexport AGENT_SOURCE=antigravity # For Antigravity/Gemini\n```\n\n### Platform-Specific Config\n\n| File | Platform | Purpose |\n| ---- | -------- | ------- |\n| `.agents/config/codex.toml` | Codex CLI | Codex-specific configuration |\n| `.agents/config/mcp.json` | All | Model Context Protocol server configuration |\n| `.agents/rules/GEMINI.md` | Antigravity/Gemini | Gemini-specific rules and instructions |\n\n---\n\n## 8. Shared Resources\n\n### UI/UX Pro Max Data (`.agents/.shared/ui-ux-pro-max/`)\n\nA curated dataset of design system references used by the `/ui-ux-pro-max` workflow.\n\n#### Data CSVs (`.shared/ui-ux-pro-max/data/`)\n\n| File | Content |\n| ---- | ------- |\n| `styles.csv` | Design style references |\n| `colors.csv` | Color palettes |\n| `typography.csv` | Font pairings |\n| `icons.csv` | Icon sets |\n| `charts.csv` | Chart/data visualization patterns |\n| `landing.csv` | Landing page patterns |\n| `products.csv` | Product page patterns |\n| `prompts.csv` | AI prompt templates for design |\n| `react-performance.csv` | React performance rules |\n| `ui-reasoning.csv` | UI decision reasoning data |\n| `ux-guidelines.csv` | UX guideline references |\n| `web-interface.csv` | Web interface patterns |\n\n#### Stack-Specific Data (`.shared/ui-ux-pro-max/data/stacks/`)\n\nFramework-specific implementation patterns:\n\n| File | Framework |\n| ---- | --------- |\n| `react.csv` | React |\n| `nextjs.csv` | Next.js |\n| `vue.csv` | Vue.js |\n| `nuxtjs.csv` | Nuxt.js |\n| `nuxt-ui.csv` | Nuxt UI |\n| `svelte.csv` | Svelte |\n| `flutter.csv` | Flutter |\n| `react-native.csv` | React Native |\n| `swiftui.csv` | SwiftUI |\n| `jetpack-compose.csv` | Jetpack Compose |\n| `shadcn.csv` | shadcn/ui |\n| `html-tailwind.csv` | HTML + Tailwind CSS |\n\n#### Python Scripts (`.shared/ui-ux-pro-max/scripts/`)\n\n| Script | Purpose |\n| ------ | ------- |\n| `core.py` | Core utilities for data loading and processing |\n| `design_system.py` | Design system generation from CSV data |\n| `search.py` | Search across design data |\n\n---\n\n## 9. Squad System\n\nSquads are reusable packages of agents + skills + workflows for specific domains.\n\n### Structure\n\n```\nsquads/\n├── README.md # Documentation\n├── .templates/ # Templates for creation\n│ ├── basic/ # Minimal template\n│ └── specialist/ # Full template with skills + workflows\n└── <name>/ # User-created squads\n ├── squad.yaml # Required manifest\n ├── agents/ # Squad agents\n ├── skills/ # Squad skills\n ├── workflows/ # Squad workflows\n └── config/ # Optional configuration\n```\n\n### Activation\n\nWhen a squad is activated via `squad_manager.py activate <name>`, symlinks are created:\n- `.agents/agents/<agent>.md` -> `../../squads/<name>/agents/<agent>.md`\n- `.agents/skills/<skill>/` -> `../../squads/<name>/skills/<skill>/`\n- `.agents/workflows/<wf>.md` -> `../../squads/<name>/workflows/<wf>.md`\n\nThis makes squad components visible to the framework without code changes.\n\n### Recovery System\n\nThe `recovery.py` module provides resilience utilities:\n- `with_retry(fn, max_attempts=3, backoff=2)` — Retry with exponential backoff\n- `safe_execute(command, rollback_fn=None)` — Execute with rollback on failure\n- `git_checkpoint(label)` / `git_rollback(label)` — Git stash checkpoints\n\nUsed by: `checklist.py`, `auto_preview.py`, `finish_task.py`\n\n---\n\n## Skill Loading Protocol\n\n```\nUser Request\n |\n v\nDetect Domain -> Match Agent -> Read agent .md frontmatter\n |\n v\n Load skill SKILL.md files\n |\n v\n Load scripts/ (if present)\n |\n v\n Apply agent persona + rules\n```\n\n### Skill File Structure\n\n```\nskill-name/\n├── SKILL.md # Required: Metadata, instructions, rules\n├── scripts/ # Optional: Python/Bash validation scripts\n├── references/ # Optional: Templates, supplementary docs\n└── *.md # Optional: Additional topic-specific docs\n```\n\n---\n\n## Statistics\n\n| Metric | Count |\n| ------ | ----- |\n| Agents | 21 (core) + N (squads) |\n| Skills | 41 (core) + N (squads) |\n| Workflows | 22 |\n| Scripts | 22 |\n| App Templates | 13 |\n| Shared Data CSVs | 13 (general) + 12 (stack-specific) |\n| Supported Platforms | 3 (Claude Code, Codex CLI, Antigravity/Gemini) |\n";
343
- export const EMBEDDED_INSTRUCTIONS = "# INSTRUCTIONS.md - Instruções Compartilhadas do Inove AI Framework\n\n> Este arquivo contém as instruções compartilhadas para Claude Code e Codex CLI.\n> É carregado automaticamente por ambas as ferramentas.\n\n## Sobre Este Projeto\n\n**Inove AI Framework** é um kit de desenvolvimento AI com sistema multi-agent (Claude Code + Codex CLI + Antigravity/Gemini) que fornece:\n\n- **21 Agentes Especializados** para diferentes domínios\n- **41 Skills Modulares** carregadas sob demanda\n- **22 Workflows** (slash commands) para processos estruturados\n- **Sistema Multi-Agent** com sincronização de locks e ownership\n\n---\n\n## Estrutura do Framework\n\n```\n.agents/\n├── agents/ # 21 agentes especializados\n├── skills/ # 41 módulos de conhecimento\n├── workflows/ # 22 workflows (slash commands)\n├── scripts/ # Automação Python\n├── config/ # Configurações por plataforma\n└── ARCHITECTURE.md # Documentação técnica\n```\n\n---\n\n## Protocolo de Roteamento Inteligente\n\n### 1. Detecção de Domínio (AUTOMÁTICO)\n\n| Palavras-chave | Domínio | Agente Primário |\n|----------------|---------|-----------------|\n| \"UI\", \"componente\", \"página\", \"frontend\" | Frontend | `frontend-specialist` |\n| \"API\", \"endpoint\", \"backend\", \"servidor\" | Backend | `backend-specialist` |\n| \"database\", \"schema\", \"query\", \"migração\" | Database | `database-architect` |\n| \"mobile\", \"iOS\", \"Android\", \"React Native\" | Mobile | `mobile-developer` |\n| \"auth\", \"segurança\", \"vulnerabilidade\" | Security | `security-auditor` |\n| \"bug\", \"erro\", \"não funciona\", \"debug\" | Debug | `debugger` |\n| \"unit test\", \"TDD\", \"cobertura\", \"jest\", \"vitest\", \"pytest\" | Unit/Integration Testing | `test-engineer` |\n| \"e2e\", \"playwright\", \"cypress\", \"pipeline\", \"regressão\", \"automated test\" | E2E/QA Pipeline | `qa-automation-engineer` |\n| \"deploy\", \"docker\", \"infraestrutura\" | DevOps | `devops-engineer` |\n| \"requisitos\", \"user story\", \"backlog\", \"MVP\" | Product | `product-owner` |\n| \"UX\", \"user flow\", \"wireframe\", \"jornada\", \"usabilidade\" | UX Research | `ux-researcher` |\n\n### 2. Ativação de Agente (OBRIGATÓRIO)\n\nQuando um domínio for detectado:\n\n1. **Ler arquivo do agente:** `.agents/agents/{agent}.md`\n2. **Anunciar ativação:**\n ```\n 🤖 Ativando @{nome-do-agente}...\n 📖 Carregando regras e protocolos\n ```\n3. **Carregar skills** do frontmatter do agente\n4. **Aplicar persona e regras** do agente\n\n---\n\n## Workflows Disponíveis (Slash Commands)\n\n| Comando | Descrição | Quando Usar |\n|---------|-----------|-------------|\n| `/define` | Planejamento completo em 9 fases com GAP Analysis | Novos projetos do zero |\n| `/journeys` | Documentar jornadas de usuário | Contextualizar requisitos |\n| `/context` | Criar Project Context | Padronizar convenções técnicas |\n| `/readiness` | Validar prontidão para implementação | Antes de começar a codar |\n| `/brainstorm` | Exploração Socrática | Ideação e descoberta |\n| `/create` | Criar novas features | Implementação guiada |\n| `/debug` | Debug sistemático | Resolução de bugs |\n| `/enhance` | Melhorar código existente | Refatoração |\n| `/deploy` | Deploy de aplicação | Publicação |\n| `/test` | Gerar e rodar testes | Quality assurance |\n| `/track` | Atualizar progresso | Tracking de tarefas |\n| `/status` | Dashboard consolidado | Visão geral |\n| `/log` | Registrar sessões | Documentação |\n| `/finish` | Marcar tarefas completas | Conclusão |\n| `/orchestrate` | Coordenação multi-agente | Tarefas que requerem múltiplos agentes |\n| `/plan` | Planejamento rápido de tarefas | Plano leve (alternativa ao /define) |\n| `/preview` | Gerenciar servidor de preview | Start/stop/restart do dev server |\n| `/ui-ux-pro-max` | Design system avançado com base de dados | UI/UX com paletas, tipografia, estilos |\n| `/review` | Revisão de código pós-sprint | Após implementação, antes de /finish |\n| `/test-book` | Gerar/atualizar Caderno de Testes | Antes de finalizar MVP ou release |\n| `/release` | Finalizar projeto e gerar release | Conclusão de MVP ou Produção |\n| `/squad` | Gerenciar squads de agentes | Criação e ativação de squads |\n\n**Como usar:**\n```\n/define App de gestão de tarefas\n/debug O login não está funcionando\n/track\n```\n\n---\n\n## Protocolo Auto-Finish (OBRIGATÓRIO)\n\nApós completar QUALQUER tarefa do `docs/BACKLOG.md`:\n\n```bash\npython3 .agents/scripts/finish_task.py \"{task_id}\"\npython3 .agents/scripts/progress_tracker.py\n```\n\nInformar ao usuário:\n```\n✅ Task {task_id} marcada como completa\n📊 Progresso atualizado: {percentual}%\n🎯 Próxima tarefa: {nome_proxima_tarefa}\n```\n\n---\n\n## Integração com Backlog\n\nQuando o usuário disser \"implementar Epic X\" ou \"implementar Story Y.Z\":\n\n1. **Ler backlog:** `docs/BACKLOG.md`\n2. **Identificar detalhes** da tarefa\n3. **Detectar domínio** → Ativar agente apropriado\n4. **Implementar** seguindo regras do agente\n5. **Auto-finish** usando scripts\n6. **Atualizar progresso**\n\n---\n\n## Regras Universais (TIER 0)\n\n### Clean Code (Mandatório Global)\n\nTodo código DEVE seguir `.agents/skills/clean-code/SKILL.md`:\n\n- Código conciso e auto-documentado\n- Sem over-engineering\n- Testes obrigatórios (Unit > Integration > E2E)\n- Performance medida antes de otimizar\n\n### Tratamento de Idioma\n\n- **Prompt do usuário** em PT-BR → Responder em PT-BR\n- **Comentários de código** → Sempre em inglês\n- **Variáveis/funções** → Sempre em inglês\n\n\n### Socratic Gate\n\nPara requisições complexas, PERGUNTAR antes de implementar:\n\n- Propósito e escopo\n- Casos de borda\n- Implicações de performance\n- Considerações de segurança\n\n---\n\n## Registro de Sessoes de Trabalho (OBRIGATORIO)\n\n### Objetivo\nRastrear sessões de trabalho e gerar um relatório diário consolidado em Markdown.\n\n### Regras de Operação\n1. **Fonte Única:** SEMPRE use `auto_session.py` para gerir sessões. NUNCA edite os logs manualmente.\n2. **Abertura:** Use o comando start no início de cada sessão de trabalho.\n3. **Encerramento:** Ao concluir entregas ou terminar a interação, use o comando end passando a lista exata do que construiu/modificou.\n4. **Fechamento Automático:** O script cuida do cabeçalho, cálculo do resumo do dia e índice do README.\n\n### Comandos\n\n```bash\npython3 .agents/scripts/auto_session.py start --agent <claude_code|codex|antigravity> # Abrir sessão\npython3 .agents/scripts/auto_session.py end --activities \"ativ1; ativ2\" # Fechar sessão\npython3 .agents/scripts/auto_session.py status # Ver sessão ativa\n```\n\n### Critérios de Qualidade\nA saída da descrição das atividades enviadas à flag `--activities` deve ser curta e objetiva. Abstê-se de logar dados sensíveis.\n\n---\n\n## 📂 Organização de Documentação (OBRIGATÓRIO)\n\nA documentação DEVE seguir esta estrutura de pastas. Não crie arquivos soltos na raiz de `docs/` (exceto BACKLOG.md).\n\n**Padrão oficial** (criado pelo `/define`):\n\n```bash\ndocs/\n├── 00-Contexto/ # Contexto do projeto e regras\n│ ├── CONTEXT.md # Gerado por /context\n│ └── READINESS.md # Gerado por /readiness\n├── 01-Planejamento/ # Artefatos executivos do /define\n│ ├── 01-product-brief.md\n│ ├── 02-prd.md\n│ ├── 03-design-system.md\n│ ├── 04-database-schema.md\n│ └── 05-roadmap-backlog.md\n├── 02-Requisitos/ # Detalhamento funcional\n│ ├── User-Stories.md\n│ └── Jornadas.md # Gerado por /journeys\n├── 03-Arquitetura/ # Técnicos e Decisões\n│ ├── ADRs/ # Architecture Decision Records\n│ └── Diagramas/ # Mermaid/PlantUML (fluxos, classes)\n├── 04-API/ # Contratos de Interface\n│ └── Endpoints.md # OpenAPI ou Docs REST\n├── 08-Logs-Sessoes/ # Logs de Sessão de Trabalho\n│ └── {ANO}/{DATA}.md # Logs diários\n└── BACKLOG.md # Backlog Mestre (Raiz)\n```\n\n**Aliases aceitos** (fallback legado / projetos sem `/define`):\n\n| Oficial (padrão) | Alias aceito |\n|----------------------|-----------------------|\n| `docs/01-Planejamento/` | `docs/planning/` |\n| `docs/00-Contexto/` | `docs/context/` |\n| `docs/02-Requisitos/` | `docs/requirements/` |\n| `docs/03-Arquitetura/` | `docs/architecture/` |\n| `docs/04-API/` | `docs/api/` |\n| `docs/08-Logs-Sessoes/` | `docs/logs/` |\n\n> **Resolução:** Ao procurar documentos, tente primeiro o caminho oficial. Se não existir, tente o alias. Use `resolve_doc_path()` / `resolve_doc_file()` de `platform_compat.py` em scripts Python.\n\n**Regra:** Ao criar documentos, sempre verifique se a pasta existe. Se não existir, crie-a.\n\n---\n\n## Compatibilidade Multi-Plataforma\n\nEste framework suporta **três ferramentas AI simultaneamente**:\n\n| Ferramenta | Arquivo de Instrução | Skills Location | Config |\n|------------|---------------------|-----------------|--------|\n| Claude Code | `CLAUDE.md` | `.agents/skills/` | N/A |\n| Codex CLI | `AGENTS.md` | `.codex/skills/` (symlink) | `.agents/config/codex.toml` |\n| Antigravity/Gemini | `GEMINI.md` | `.agents/skills/` | `.agents/rules/GEMINI.md` |\n\n### Symlinks Nativos\n\nCada plataforma acessa os mesmos recursos via caminhos nativos (symlinks para `.agents/`):\n\n| Plataforma | Agents | Skills | Workflows |\n|------------|--------|--------|-----------|\n| Claude Code | `.claude/agents/` | `.claude/skills/` | `.agents/workflows/` |\n| Codex CLI | `.codex/agents/` | `.codex/skills/` | `.codex/prompts/` |\n| Antigravity | `.agents/agents/` | `.agents/skills/` | `.agents/workflows/` |\n\n> **Fonte canônica:** `.agents/` — todos os symlinks apontam para lá.\n\n### Detecção Automática de Plataforma\n\nOs scripts Python detectam automaticamente qual ferramenta está executando:\n\n```python\nfrom platform_compat import get_agent_source\nsource = get_agent_source() # 'claude_code', 'codex', ou 'unknown'\n```\n\n## Sistema Multi-Agent\n\nEste framework suporta múltiplos agentes AI trabalhando simultaneamente:\n\n### Identificação de Fonte\n```bash\n# Para Antigravity/Gemini\nexport AGENT_SOURCE=antigravity\n\n# Para Claude Code\nexport AGENT_SOURCE=claude_code\n\n# Para Codex CLI\nexport AGENT_SOURCE=codex\n```\n\n### Lock Manager\n```bash\npython3 .agents/scripts/lock_manager.py list # Ver locks ativos\npython3 .agents/scripts/lock_manager.py cleanup # Limpar locks expirados\n```\n\n### Ownership e Modelo Preferencial de Epics\n\nFormato no BACKLOG.md:\n```markdown\n## Epic 1: Nome [OWNER: claude_code] [MODEL: opus-4-5]\n```\n\n| Campo | Descrição | Valores |\n|-------|-----------|---------|\n| `OWNER` | Agente/ferramenta responsável | `claude_code`, `antigravity`, `codex` |\n| `MODEL` | Modelo AI preferencial | `opus-4-5`, `sonnet`, `haiku`, `gemini-2.0` |\n\n---\n\n## Scripts Úteis\n\n| Script | Comando | Descrição |\n|--------|---------|-----------|\n| Dashboard | `python3 .agents/scripts/dashboard.py` | Visão consolidada |\n| Progresso | `python3 .agents/scripts/progress_tracker.py` | Atualizar barra |\n| Sessão | `python3 .agents/scripts/auto_session.py start` | Iniciar sessão |\n| Finish | `python3 .agents/scripts/finish_task.py \"Epic-1\"` | Marcar completo |\n| Métricas | `python3 .agents/scripts/metrics.py` | Insights |\n| Validar | `python3 .agents/scripts/validate_installation.py` | Verificar setup |\n| Rastreabilidade | `python3 .agents/scripts/validate_traceability.py` | Validar cobertura |\n| Projeto | `python3 .agents/scripts/project_analyzer.py status` | Analisar tech stack |\n| Web Data | `python3 .agents/scripts/generate_web_data.py` | Gerar JSONs do site |\n| Checklist | `python3 .agents/scripts/checklist.py .` | Validação incremental |\n| Verificar Tudo | `python3 .agents/scripts/verify_all.py .` | Verificação completa |\n| Squad Manager | `python3 .agents/scripts/squad_manager.py list` | Gerenciar squads |\n| Recovery | `python3 .agents/scripts/recovery.py checkpoint <label>` | Retry + rollback |\n| Shard Epic | `python3 .agents/scripts/shard_epic.py shard` | Fatiar backlog em stories |\n\n---\n\n## Sistema de Squads\n\nSquads são pacotes reutilizáveis de agentes+skills+workflows para domínios específicos.\nSquads ficam em `squads/<nome>/` com manifesto `squad.yaml`. Detalhes em `squads/README.md`.\n\n| Comando | Descrição |\n|---------|-----------|\n| `/squad create <name>` | Criar novo squad |\n| `/squad list` | Listar squads |\n| `/squad activate <name>` | Ativar no framework |\n| `/squad deactivate <name>` | Desativar |\n\n---\n\n### Stitch MCP (Projetos com UI)\n\nPara TODOS os projetos com interface visual (HAS_UI=true):\n\n| Cenário | Comportamento |\n|---------|---------------|\n| Stitch MCP **disponível** + HAS_UI=true | **OBRIGATÓRIO** gerar protótipos via Stitch para **TODAS** as telas do sistema |\n| Stitch MCP **não disponível** + HAS_UI=true | **PARAR** e informar usuário para configurar Stitch antes de continuar |\n| HAS_UI=false | Fase 3.5 ignorada |\n\n**Regras de Cobertura Total:**\n- `/define` Fase 3.5: Prototipar **TODAS** as telas identificadas no UX Concept (não apenas 1 ou 2)\n- `/ui-ux-pro-max` Step 2c: Preview visual é OBRIGATÓRIO\n- `/readiness`: Valida existência de mockups E cobertura completa\n- **Gate de Bloqueio:** Fase 4 (Architecture) é BLOQUEADA até cobertura 100% das telas\n\nProjetos sem UI (API, CLI, backend-only): Stitch é ignorado.\n\n---\n\n### Recovery System\n\nScripts críticos usam retry automático e git checkpoint para operações seguras.\nMódulo: `.agents/scripts/recovery.py`\n\n---\n\n## Inicialização de Sessão\n\n> **PULO DO GATO (Context State):** Sempre que iniciar o trabalho com o usuário, **leia silenciosamente o arquivo `docs/PROJECT_STATUS.md`** (se existir). Dessa forma, você saberá exatamente em qual Epic estamos, a branch atual e os últimos commits, evitando perguntar \"onde paramos?\".\n\nToda conversa começa com:\n\n```\n✅ Project Instructions carregadas\n✅ Protocolo Inove AI Framework ativo\n✅ 21 agentes disponíveis\n✅ 41 skills disponíveis\n✅ 22 workflows disponíveis\n✅ Roteamento inteligente habilitado\n\n🎯 Pronto para trabalhar. O que devo fazer?\n```\n\n---\n\n## Referência Rápida de Agentes\n\n| Agente | Arquivo | Skills Primárias |\n|--------|---------|------------------|\n| `orchestrator` | `.agents/agents/orchestrator.md` | Coordenação multi-agente |\n| `project-planner` | `.agents/agents/project-planner.md` | Planejamento, discovery |\n| `product-manager` | `.agents/agents/product-manager.md` | Requisitos, user stories |\n| `frontend-specialist` | `.agents/agents/frontend-specialist.md` | React, UI/UX, Tailwind |\n| `backend-specialist` | `.agents/agents/backend-specialist.md` | APIs, Node.js, lógica |\n| `database-architect` | `.agents/agents/database-architect.md` | Schemas, Prisma, queries |\n| `mobile-developer` | `.agents/agents/mobile-developer.md` | iOS, Android, RN |\n| `security-auditor` | `.agents/agents/security-auditor.md` | Auth, OWASP, compliance |\n| `debugger` | `.agents/agents/debugger.md` | Root cause analysis |\n| `devops-engineer` | `.agents/agents/devops-engineer.md` | CI/CD, Docker, infra |\n| `test-engineer` | `.agents/agents/test-engineer.md` | Estratégias de teste |\n| `qa-automation-engineer` | `.agents/agents/qa-automation-engineer.md` | E2E, automação |\n| `documentation-writer` | `.agents/agents/documentation-writer.md` | Manuais, docs |\n| `code-archaeologist` | `.agents/agents/code-archaeologist.md` | Refatoração legacy |\n| `performance-optimizer` | `.agents/agents/performance-optimizer.md` | Otimizações |\n| `seo-specialist` | `.agents/agents/seo-specialist.md` | SEO, visibilidade |\n| `penetration-tester` | `.agents/agents/penetration-tester.md` | Security testing |\n| `game-developer` | `.agents/agents/game-developer.md` | Game logic |\n| `product-owner` | `.agents/agents/product-owner.md` | Requisitos, backlog, MVP |\n| `explorer-agent` | `.agents/agents/explorer-agent.md` | Análise de codebase |\n| `ux-researcher` | `.agents/agents/ux-researcher.md` | UX research, user flows, wireframes |\n\n---\n\n## Exemplo de Fluxo Completo\n\n**Usuário:** \"Implementar Epic 1: Autenticação de Usuários\"\n\n**Claude:**\n1. 🔍 Domínio detectado: Security + Backend\n2. 🤖 Ativando agentes:\n - @security-auditor (líder)\n - @backend-specialist (suporte)\n3. 📖 Carregando skills: vulnerability-scanner, api-patterns\n4. [Implementa código seguindo regras dos agentes]\n5. ✅ Implementação completa\n6. 🔧 Executando: `python3 .agents/scripts/finish_task.py \"Epic 1\"`\n7. 📊 Progresso: 25% (1/4 epics concluídos)\n\n**Usuário:** `/define App de gestão de tarefas`\n\n**Claude (ou Antigravity):**\n1. Fase 0: Discovery (12 perguntas estruturadas)\n2. Fase 1: Brief (`product-manager`)\n3. Fase 2: PRD + GAP Produto (`product-owner`)\n4. Fase 3: UX Concept + GAP UX (`ux-researcher`)\n5. Fase 4: Architecture + DB + GAP Infra (`project-planner`)\n6. Fase 5: Security + GAP Segurança (`security-auditor`)\n7. Fase 6: Stack + GAP Tech (`project-planner`)\n8. Fase 7: Design System + GAP Design (`frontend-specialist`)\n9. Fase 8: Backlog + GAPs consolidados (`product-owner`)\n10. Revisão: Claude Code/Codex valida com skill `doc-review`\n";
342
+ export const EMBEDDED_ARCHITECTURE = "# Inove AI Framework - Architecture\n\n> Multi-agent AI development framework with 22 agents, 42 skills, 25 workflows, and multi-platform support.\n\n---\n\n## 1. Overview\n\nInove AI Framework is a modular system that enhances AI coding assistants with:\n\n- **22 Specialist Agents** -- Role-based AI personas for different domains\n- **42 Skills** -- Domain-specific knowledge modules loaded on demand\n- **25 Workflows** -- Slash command procedures for structured processes\n- **22 Scripts** -- Python/Bash automation for task tracking, sessions, and validation\n- **Multi-Platform Support** -- Claude Code, Codex CLI, and Antigravity/Gemini\n\nThe canonical source of truth lives in `.agents/`. Other platforms access it through symlinks.\n\n---\n\n## 2. Directory Structure\n\n```\n.agents/\n├── ARCHITECTURE.md # This file\n├── INSTRUCTIONS.md # Canonical instructions (synced to CLAUDE.md, AGENTS.md)\n├── agents/ # 22 specialist agents\n│ ├── orchestrator.md\n│ ├── project-planner.md\n│ ├── product-manager.md\n│ ├── product-owner.md\n│ ├── frontend-specialist.md\n│ ├── backend-specialist.md\n│ ├── database-architect.md\n│ ├── mobile-developer.md\n│ ├── security-auditor.md\n│ ├── penetration-tester.md\n│ ├── debugger.md\n│ ├── devops-engineer.md\n│ ├── test-engineer.md\n│ ├── qa-automation-engineer.md\n│ ├── documentation-writer.md\n│ ├── code-archaeologist.md\n│ ├── performance-optimizer.md\n│ ├── seo-specialist.md\n│ ├── game-developer.md\n│ ├── ux-researcher.md\n│ └── explorer-agent.md\n├── skills/ # 41 skill modules\n│ ├── api-patterns/\n│ ├── app-builder/\n│ │ └── templates/ # 13 project templates\n│ ├── architecture/\n│ ├── ... # (see Skills section below)\n│ └── webapp-testing/\n├── workflows/ # 22 slash command workflows\n│ ├── brainstorm.md\n│ ├── context.md\n│ ├── ... # (see Workflows section below)\n│ └── ui-ux-pro-max.md\n├── scripts/ # 22 automation scripts\n│ ├── auto_finish.py\n│ ├── dashboard.py\n│ ├── ... # (see Scripts section below)\n│ └── verify_all.py\n├── config/ # Platform-specific configuration\n│ ├── codex.toml\n│ └── mcp.json\n├── rules/ # Global rules\n│ └── GEMINI.md\n└── .shared/ # Shared data resources\n └── ui-ux-pro-max/\n ├── data/ # 13 CSV datasets + 12 stack CSVs\n └── scripts/ # Python scripts (core, design_system, search)\n```\n\n---\n\n## 3. Agents (21)\n\nEach agent is a Markdown file in `.agents/agents/` defining a persona, rules, and skill dependencies.\n\n| Agent | Focus | Skills |\n| ----- | ----- | ------ |\n| `orchestrator` | Multi-agent coordination | parallel-agents, behavioral-modes, plan-writing, brainstorming, architecture, lint-and-validate, powershell-windows, bash-linux |\n| `project-planner` | Discovery, architecture, task planning | app-builder, plan-writing, brainstorming, architecture, system-design, gap-analysis |\n| `product-manager` | Requirements, user stories | plan-writing, brainstorming |\n| `product-owner` | Strategy, backlog, MVP, GAP analysis | plan-writing, brainstorming, gap-analysis, doc-review |\n| `frontend-specialist` | Web UI/UX, React, Next.js | nextjs-react-expert, web-design-guidelines, tailwind-patterns, frontend-design, lint-and-validate, gap-analysis |\n| `backend-specialist` | APIs, Node.js, Python, business logic | nodejs-best-practices, python-patterns, api-patterns, database-design, mcp-builder, lint-and-validate, powershell-windows, bash-linux |\n| `database-architect` | Schema design, queries, migrations | database-design |\n| `mobile-developer` | iOS, Android, React Native | mobile-design |\n| `security-auditor` | Security compliance, OWASP | vulnerability-scanner, red-team-tactics, api-patterns, gap-analysis |\n| `penetration-tester` | Offensive security testing | vulnerability-scanner, red-team-tactics, api-patterns |\n| `debugger` | Root cause analysis | systematic-debugging |\n| `devops-engineer` | CI/CD, Docker, infrastructure | deployment-procedures, server-management, powershell-windows, bash-linux |\n| `test-engineer` | Testing strategies | testing-patterns, tdd-workflow, webapp-testing, code-review-checklist, lint-and-validate |\n| `qa-automation-engineer` | E2E testing, CI pipelines | webapp-testing, testing-patterns, lint-and-validate |\n| `documentation-writer` | Manuals, technical docs | documentation-templates |\n| `code-archaeologist` | Legacy code, refactoring | code-review-checklist |\n| `performance-optimizer` | Speed, Web Vitals | performance-profiling |\n| `seo-specialist` | SEO, visibility, GEO | seo-fundamentals, geo-fundamentals |\n| `game-developer` | Game logic, mechanics | game-development |\n| `ux-researcher` | UX research, user flows, wireframes | ux-research, frontend-design, stitch-ui-design, gap-analysis |\n| `explorer-agent` | Codebase analysis, discovery | architecture, plan-writing, brainstorming, systematic-debugging |\n\n> **Note:** All agents implicitly load `clean-code` as a Tier 0 (mandatory) skill.\n\n---\n\n## 4. Skills (41)\n\nSkills are modular knowledge domains in `.agents/skills/`. Each contains at minimum a `SKILL.md` file, and optionally `scripts/` and `references/` subdirectories.\n\n### Frontend and UI\n\n| Skill | Description |\n| ----- | ----------- |\n| `nextjs-react-expert` | Next.js/React performance patterns and optimization rules |\n| `tailwind-patterns` | Tailwind CSS utility patterns and best practices |\n| `frontend-design` | UI/UX patterns, design systems, color/typography systems |\n| `web-design-guidelines` | UI audit against Web Interface Guidelines |\n| `stitch-ui-design` | Stitch MCP integration for generating high-fidelity UI designs from textual wireframes |\n\n### Backend and API\n\n| Skill | Description |\n| ----- | ----------- |\n| `api-patterns` | REST, GraphQL, tRPC design patterns and documentation |\n| `nodejs-best-practices` | Node.js async patterns, modules, error handling |\n| `python-patterns` | Python standards, FastAPI, idiomatic patterns |\n\n### Database\n\n| Skill | Description |\n| ----- | ----------- |\n| `database-design` | Schema design, indexing, migrations, ORM selection, optimization |\n\n### Architecture and Planning\n\n| Skill | Description |\n| ----- | ----------- |\n| `app-builder` | Full-stack app scaffolding with 13 project templates |\n| `architecture` | System design patterns, trade-off analysis, context discovery |\n| `system-design` | Large-scale system design patterns |\n| `plan-writing` | Task planning and breakdown |\n| `brainstorming` | Socratic questioning and dynamic exploration |\n| `gap-analysis` | Identify gaps in product, UX, infrastructure, security, and tech |\n\n### Testing and Quality\n\n| Skill | Description |\n| ----- | ----------- |\n| `testing-patterns` | Jest, Vitest, testing strategies |\n| `webapp-testing` | E2E testing with Playwright |\n| `tdd-workflow` | Test-driven development methodology |\n| `code-review-checklist` | Code review standards and checklists |\n| `lint-and-validate` | Linting, type coverage, validation scripts |\n\n### Security\n\n| Skill | Description |\n| ----- | ----------- |\n| `vulnerability-scanner` | Security auditing, OWASP checklists |\n| `red-team-tactics` | Offensive security techniques |\n\n### Mobile\n\n| Skill | Description |\n| ----- | ----------- |\n| `mobile-design` | Mobile UI/UX, platform-specific patterns (iOS/Android), debugging |\n\n### Game Development\n\n| Skill | Description |\n| ----- | ----------- |\n| `game-development` | 2D/3D games, multiplayer, VR/AR, game design, audio |\n\n### SEO and Growth\n\n| Skill | Description |\n| ----- | ----------- |\n| `seo-fundamentals` | SEO, E-E-A-T, Core Web Vitals optimization |\n| `geo-fundamentals` | Generative Engine Optimization (GEO) |\n\n### UX Research\n\n| Skill | Description |\n| ----- | ----------- |\n| `ux-research` | UX research methodology, user flows, usability testing |\n\n### DevOps and Infrastructure\n\n| Skill | Description |\n| ----- | ----------- |\n| `deployment-procedures` | CI/CD workflows, deploy procedures |\n| `server-management` | Infrastructure management, monitoring |\n\n### Shell and CLI\n\n| Skill | Description |\n| ----- | ----------- |\n| `bash-linux` | Linux commands, shell scripting |\n| `powershell-windows` | Windows PowerShell scripting |\n\n### Performance\n\n| Skill | Description |\n| ----- | ----------- |\n| `performance-profiling` | Web Vitals, Lighthouse audits, profiling |\n\n### Documentation\n\n| Skill | Description |\n| ----- | ----------- |\n| `documentation-templates` | README, API docs, ADR, changelog templates |\n| `doc-review` | Document review and validation |\n\n### Internationalization\n\n| Skill | Description |\n| ----- | ----------- |\n| `i18n-localization` | Internationalization patterns and i18n checking |\n\n### Agent Behavior and Coordination\n\n| Skill | Description |\n| ----- | ----------- |\n| `behavioral-modes` | Agent persona modes and behavioral configuration |\n| `parallel-agents` | Multi-agent coordination patterns |\n| `intelligent-routing` | Request routing to appropriate agents |\n\n### Cross-Cutting\n\n| Skill | Description |\n| ----- | ----------- |\n| `clean-code` | Pragmatic coding standards (mandatory Tier 0 for all agents) |\n| `systematic-debugging` | Root cause analysis, troubleshooting methodology |\n| `mcp-builder` | Model Context Protocol server/tool building |\n\n### App Builder Templates (13)\n\nThe `app-builder` skill includes a `templates/` subdirectory with scaffolding for:\n\n| Template | Stack |\n| -------- | ----- |\n| `astro-static` | Astro static site |\n| `chrome-extension` | Chrome browser extension |\n| `cli-tool` | Command-line tool |\n| `electron-desktop` | Electron desktop app |\n| `express-api` | Express.js REST API |\n| `flutter-app` | Flutter cross-platform app |\n| `monorepo-turborepo` | Turborepo monorepo setup |\n| `nextjs-fullstack` | Next.js full-stack app |\n| `nextjs-saas` | Next.js SaaS starter |\n| `nextjs-static` | Next.js static site |\n| `nuxt-app` | Nuxt.js application |\n| `python-fastapi` | Python FastAPI backend |\n| `react-native-app` | React Native mobile app |\n\n---\n\n## 5. Workflows (22)\n\nSlash command procedures in `.agents/workflows/`. Invoke with `/command`.\n\n| Command | Description |\n| ------- | ----------- |\n| `/define` | Full project planning in 9 phases with GAP Analysis |\n| `/journeys` | Document user journeys and flows |\n| `/context` | Create project context and technical conventions |\n| `/readiness` | Validate readiness for implementation |\n| `/brainstorm` | Socratic exploration and ideation |\n| `/create` | Create new features with guided implementation |\n| `/debug` | Systematic debugging workflow |\n| `/enhance` | Improve and refactor existing code |\n| `/deploy` | Application deployment procedure |\n| `/test` | Generate and run tests |\n| `/plan` | Task breakdown and planning |\n| `/orchestrate` | Multi-agent coordination |\n| `/preview` | Preview changes before applying |\n| `/track` | Update task progress |\n| `/status` | Consolidated project dashboard |\n| `/log` | Record session activity |\n| `/finish` | Mark tasks as complete |\n| `/review` | Post-sprint code review and quality checks |\n| `/test-book` | Generate or update testing notebook artifacts |\n| `/release` | Final release workflow for MVP or production |\n| `/ui-ux-pro-max` | Design system workflow with styles, palettes, and fonts |\n| `/squad` | Manage squads: reusable packages of agents, skills, and workflows |\n\n---\n\n## 6. Scripts (22)\n\nAutomation scripts in `.agents/scripts/` for task management, validation, and session tracking.\n\n### Task and Progress Management\n\n| Script | Description |\n| ------ | ----------- |\n| `finish_task.py` | Mark a backlog task as complete |\n| `auto_finish.py` | Automated task completion protocol |\n| `progress_tracker.py` | Update and display progress bar |\n| `checklist.py` | Priority-based validation (security, lint, types, tests, UX, SEO) |\n| `shard_epic.py` | Split backlog into individual story files (shard/sync/status/clean) |\n\n### Session Management\n\n| Script | Description |\n| ------ | ----------- |\n| `auto_session.py` | Start/stop session tracking |\n| `session_logger.py` | Log session activity |\n| `project_analyzer.py` | Analyze project state and tech stack |\n\n### Dashboard and Metrics\n\n| Script | Description |\n| ------ | ----------- |\n| `dashboard.py` | Consolidated project dashboard view |\n| `metrics.py` | Generate insights and metrics |\n\n### Multi-Agent Coordination\n\n| Script | Description |\n| ------ | ----------- |\n| `lock_manager.py` | File lock management for multi-agent work |\n| `sync_tracker.py` | Synchronization tracking between agents |\n| `platform_compat.py` | Auto-detect active AI platform (claude_code, codex, unknown) |\n\n### Validation\n\n| Script | Description |\n| ------ | ----------- |\n| `verify_all.py` | Comprehensive pre-deployment verification (all checks) |\n| `validate_installation.py` | Verify framework installation and setup |\n| `validate_traceability.py` | Validate backlog-to-code traceability |\n| `_check_runner.py` | Shared check runner utilities for verification scripts |\n\n### Notifications and Previews\n\n| Script | Description |\n| ------ | ----------- |\n| `notifier.py` | Send notifications on task events |\n| `reminder_system.py` | Scheduled reminders for pending tasks |\n| `auto_preview.py` | Automated preview generation |\n| `generate_web_data.py` | Generate JSON data artifacts for web docs/dashboard |\n\n### Squads and Recovery\n\n| Script | Description |\n| ------ | ----------- |\n| `squad_manager.py` | Create, validate, activate, deactivate, and export squads |\n| `recovery.py` | Retry with exponential backoff, safe execution with rollback, git checkpoints |\n\n### Git Hooks\n\n| Script | Description |\n| ------ | ----------- |\n| `install_git_hooks.sh` | Install pre-commit and post-commit hooks |\n\n---\n\n## 7. Multi-Platform Support\n\nInove AI Framework runs on three AI platforms simultaneously. The canonical source is `.agents/`, and each platform accesses it through symlinks or direct references.\n\n### Platform Configuration\n\n| Platform | Instruction File | Agents Path | Skills Path | Workflows Path |\n| -------- | ---------------- | ----------- | ----------- | -------------- |\n| Claude Code | `CLAUDE.md` | `.claude/agents/` -> `.agents/agents/` | `.claude/skills/` -> `.agents/skills/` | `.agents/workflows/` (direct) |\n| Codex CLI | `AGENTS.md` | `.codex/agents/` -> `.agents/agents/` | `.codex/skills/` -> `.agents/skills/` | `.codex/prompts/` -> `.agents/workflows/` |\n| Antigravity/Gemini | `GEMINI.md` | `.agents/agents/` (direct) | `.agents/skills/` (direct) | `.agents/workflows/` (direct) |\n\n### Symlink Map\n\n```\n.claude/\n├── agents -> ../.agents/agents (symlink)\n├── skills -> ../.agents/skills (symlink)\n├── project_instructions.md\n├── settings.json\n└── settings.local.json\n\n.codex/\n├── agents -> ../.agents/agents (symlink)\n├── skills -> ../.agents/skills (symlink)\n├── prompts -> ../.agents/workflows (symlink)\n└── config.toml\n```\n\n### Platform Detection\n\nScripts auto-detect the active platform:\n\n```python\nfrom platform_compat import get_agent_source\nsource = get_agent_source() # Returns 'claude_code', 'codex', or 'unknown'\n```\n\nEnvironment variable override:\n\n```bash\nexport AGENT_SOURCE=claude_code # For Claude Code\nexport AGENT_SOURCE=codex # For Codex CLI\nexport AGENT_SOURCE=antigravity # For Antigravity/Gemini\n```\n\n### Platform-Specific Config\n\n| File | Platform | Purpose |\n| ---- | -------- | ------- |\n| `.agents/config/codex.toml` | Codex CLI | Codex-specific configuration |\n| `.agents/config/mcp.json` | All | Model Context Protocol server configuration |\n| `.agents/rules/GEMINI.md` | Antigravity/Gemini | Gemini-specific rules and instructions |\n\n---\n\n## 8. Shared Resources\n\n### UI/UX Pro Max Data (`.agents/.shared/ui-ux-pro-max/`)\n\nA curated dataset of design system references used by the `/ui-ux-pro-max` workflow.\n\n#### Data CSVs (`.shared/ui-ux-pro-max/data/`)\n\n| File | Content |\n| ---- | ------- |\n| `styles.csv` | Design style references |\n| `colors.csv` | Color palettes |\n| `typography.csv` | Font pairings |\n| `icons.csv` | Icon sets |\n| `charts.csv` | Chart/data visualization patterns |\n| `landing.csv` | Landing page patterns |\n| `products.csv` | Product page patterns |\n| `prompts.csv` | AI prompt templates for design |\n| `react-performance.csv` | React performance rules |\n| `ui-reasoning.csv` | UI decision reasoning data |\n| `ux-guidelines.csv` | UX guideline references |\n| `web-interface.csv` | Web interface patterns |\n\n#### Stack-Specific Data (`.shared/ui-ux-pro-max/data/stacks/`)\n\nFramework-specific implementation patterns:\n\n| File | Framework |\n| ---- | --------- |\n| `react.csv` | React |\n| `nextjs.csv` | Next.js |\n| `vue.csv` | Vue.js |\n| `nuxtjs.csv` | Nuxt.js |\n| `nuxt-ui.csv` | Nuxt UI |\n| `svelte.csv` | Svelte |\n| `flutter.csv` | Flutter |\n| `react-native.csv` | React Native |\n| `swiftui.csv` | SwiftUI |\n| `jetpack-compose.csv` | Jetpack Compose |\n| `shadcn.csv` | shadcn/ui |\n| `html-tailwind.csv` | HTML + Tailwind CSS |\n\n#### Python Scripts (`.shared/ui-ux-pro-max/scripts/`)\n\n| Script | Purpose |\n| ------ | ------- |\n| `core.py` | Core utilities for data loading and processing |\n| `design_system.py` | Design system generation from CSV data |\n| `search.py` | Search across design data |\n\n---\n\n## 9. Squad System\n\nSquads are reusable packages of agents + skills + workflows for specific domains.\n\n### Structure\n\n```\nsquads/\n├── README.md # Documentation\n├── .templates/ # Templates for creation\n│ ├── basic/ # Minimal template\n│ └── specialist/ # Full template with skills + workflows\n└── <name>/ # User-created squads\n ├── squad.yaml # Required manifest\n ├── agents/ # Squad agents\n ├── skills/ # Squad skills\n ├── workflows/ # Squad workflows\n └── config/ # Optional configuration\n```\n\n### Activation\n\nWhen a squad is activated via `squad_manager.py activate <name>`, symlinks are created:\n- `.agents/agents/<agent>.md` -> `../../squads/<name>/agents/<agent>.md`\n- `.agents/skills/<skill>/` -> `../../squads/<name>/skills/<skill>/`\n- `.agents/workflows/<wf>.md` -> `../../squads/<name>/workflows/<wf>.md`\n\nThis makes squad components visible to the framework without code changes.\n\n### Recovery System\n\nThe `recovery.py` module provides resilience utilities:\n- `with_retry(fn, max_attempts=3, backoff=2)` — Retry with exponential backoff\n- `safe_execute(command, rollback_fn=None)` — Execute with rollback on failure\n- `git_checkpoint(label)` / `git_rollback(label)` — Git stash checkpoints\n\nUsed by: `checklist.py`, `auto_preview.py`, `finish_task.py`\n\n---\n\n## Skill Loading Protocol\n\n```\nUser Request\n |\n v\nDetect Domain -> Match Agent -> Read agent .md frontmatter\n |\n v\n Load skill SKILL.md files\n |\n v\n Load scripts/ (if present)\n |\n v\n Apply agent persona + rules\n```\n\n### Skill File Structure\n\n```\nskill-name/\n├── SKILL.md # Required: Metadata, instructions, rules\n├── scripts/ # Optional: Python/Bash validation scripts\n├── references/ # Optional: Templates, supplementary docs\n└── *.md # Optional: Additional topic-specific docs\n```\n\n---\n\n## Statistics\n\n| Metric | Count |\n| ------ | ----- |\n| Agents | 21 (core) + N (squads) |\n| Skills | 41 (core) + N (squads) |\n| Workflows | 22 |\n| Scripts | 22 |\n| App Templates | 13 |\n| Shared Data CSVs | 13 (general) + 12 (stack-specific) |\n| Supported Platforms | 3 (Claude Code, Codex CLI, Antigravity/Gemini) |\n";
343
+ export const EMBEDDED_INSTRUCTIONS = "# INSTRUCTIONS.md - Instruções Compartilhadas do Inove AI Framework\n\n> Este arquivo contém as instruções compartilhadas para Claude Code e Codex CLI.\n> É carregado automaticamente por ambas as ferramentas.\n\n## Sobre Este Projeto\n\n**Inove AI Framework** é um kit de desenvolvimento AI com sistema multi-agent (Claude Code + Codex CLI + Antigravity/Gemini) que fornece:\n\n- **22 Agentes Especializados** para diferentes domínios\n- **42 Skills Modulares** carregadas sob demanda\n- **25 Workflows** (slash commands) para processos estruturados\n- **Sistema Multi-Agent** com sincronização de locks e ownership\n\n---\n\n## Estrutura do Framework\n\n```\n.agents/\n├── agents/ # 22 agentes especializados\n├── skills/ # 41 módulos de conhecimento\n├── workflows/ # 25 workflows (slash commands)\n├── scripts/ # Automação Python\n├── config/ # Configurações por plataforma\n└── ARCHITECTURE.md # Documentação técnica\n```\n\n---\n\n## Protocolo de Roteamento Inteligente\n\n### 1. Detecção de Domínio (AUTOMÁTICO)\n\n| Palavras-chave | Domínio | Agente Primário |\n|----------------|---------|-----------------|\n| \"UI\", \"componente\", \"página\", \"frontend\" | Frontend | `frontend-specialist` |\n| \"API\", \"endpoint\", \"backend\", \"servidor\" | Backend | `backend-specialist` |\n| \"database\", \"schema\", \"query\", \"migração\" | Database | `database-architect` |\n| \"mobile\", \"iOS\", \"Android\", \"React Native\" | Mobile | `mobile-developer` |\n| \"auth\", \"segurança\", \"vulnerabilidade\" | Security | `security-auditor` |\n| \"bug\", \"erro\", \"não funciona\", \"debug\" | Debug | `debugger` |\n| \"unit test\", \"TDD\", \"cobertura\", \"jest\", \"vitest\", \"pytest\" | Unit/Integration Testing | `test-engineer` |\n| \"e2e\", \"playwright\", \"cypress\", \"pipeline\", \"regressão\", \"automated test\" | E2E/QA Pipeline | `qa-automation-engineer` |\n| \"deploy\", \"docker\", \"infraestrutura\" | DevOps | `devops-engineer` |\n| \"requisitos\", \"user story\", \"backlog\", \"MVP\" | Product | `product-owner` |\n| \"UX\", \"user flow\", \"wireframe\", \"jornada\", \"usabilidade\" | UX Research | `ux-researcher` |\n\n### 2. Ativação de Agente (OBRIGATÓRIO)\n\nQuando um domínio for detectado:\n\n1. **Ler arquivo do agente:** `.agents/agents/{agent}.md`\n2. **Anunciar ativação:**\n ```\n 🤖 Ativando @{nome-do-agente}...\n 📖 Carregando regras e protocolos\n ```\n3. **Carregar skills** do frontmatter do agente\n4. **Aplicar persona e regras** do agente\n\n---\n\n## Workflows Disponíveis (Slash Commands)\n\n| Comando | Descrição | Quando Usar |\n|---------|-----------|-------------|\n| `/define` | Planejamento completo em 9 fases com GAP Analysis | Novos projetos do zero |\n| `/journeys` | Documentar jornadas de usuário | Contextualizar requisitos |\n| `/context` | Criar Project Context | Padronizar convenções técnicas |\n| `/readiness` | Validar prontidão para implementação | Antes de começar a codar |\n| `/brainstorm` | Exploração Socrática | Ideação e descoberta |\n| `/create` | Criar novas features | Implementação guiada |\n| `/debug` | Debug sistemático | Resolução de bugs |\n| `/enhance` | Melhorar código existente | Refatoração |\n| `/deploy` | Deploy de aplicação | Publicação |\n| `/test` | Gerar e rodar testes | Quality assurance |\n| `/track` | Atualizar progresso | Tracking de tarefas |\n| `/status` | Dashboard consolidado | Visão geral |\n| `/log` | Registrar sessões | Documentação |\n| `/finish` | Marcar tarefas completas | Conclusão |\n| `/orchestrate` | Coordenação multi-agente | Tarefas que requerem múltiplos agentes |\n| `/plan` | Planejamento rápido de tarefas | Plano leve (alternativa ao /define) |\n| `/preview` | Gerenciar servidor de preview | Start/stop/restart do dev server |\n| `/ui-ux-pro-max` | Design system avançado com base de dados | UI/UX com paletas, tipografia, estilos |\n| `/review` | Revisão de código pós-sprint | Após implementação, antes de /finish |\n| `/test-book` | Gerar/atualizar Caderno de Testes | Antes de finalizar MVP ou release |\n| `/release` | Finalizar projeto e gerar release | Conclusão de MVP ou Produção |\n| `/squad` | Gerenciar squads de agentes | Criação e ativação de squads |\n\n**Como usar:**\n```\n/define App de gestão de tarefas\n/debug O login não está funcionando\n/track\n```\n\n---\n\n## Protocolo Auto-Finish (OBRIGATÓRIO)\n\nApós completar QUALQUER tarefa do `docs/BACKLOG.md`:\n\n```bash\npython3 .agents/scripts/finish_task.py \"{task_id}\"\npython3 .agents/scripts/progress_tracker.py\n```\n\nInformar ao usuário:\n```\n✅ Task {task_id} marcada como completa\n📊 Progresso atualizado: {percentual}%\n🎯 Próxima tarefa: {nome_proxima_tarefa}\n```\n\n---\n\n## Integração com Backlog\n\nQuando o usuário disser \"implementar Epic X\" ou \"implementar Story Y.Z\":\n\n1. **Ler backlog:** `docs/BACKLOG.md`\n2. **Identificar detalhes** da tarefa\n3. **Detectar domínio** → Ativar agente apropriado\n4. **Implementar** seguindo regras do agente\n5. **Auto-finish** usando scripts\n6. **Atualizar progresso**\n\n---\n\n## Regras Universais (TIER 0)\n\n### Clean Code (Mandatório Global)\n\nTodo código DEVE seguir `.agents/skills/clean-code/SKILL.md`:\n\n- Código conciso e auto-documentado\n- Sem over-engineering\n- Testes obrigatórios (Unit > Integration > E2E)\n- Performance medida antes de otimizar\n\n### Tratamento de Idioma\n\n- **Prompt do usuário** em PT-BR → Responder em PT-BR\n- **Comentários de código** → Sempre em inglês\n- **Variáveis/funções** → Sempre em inglês\n\n\n### Socratic Gate\n\nPara requisições complexas, PERGUNTAR antes de implementar:\n\n- Propósito e escopo\n- Casos de borda\n- Implicações de performance\n- Considerações de segurança\n\n---\n\n## Registro de Sessoes de Trabalho (OBRIGATORIO)\n\n### Objetivo\nRastrear sessões de trabalho e gerar um relatório diário consolidado em Markdown.\n\n### Regras de Operação\n1. **Fonte Única:** SEMPRE use `auto_session.py` para gerir sessões. NUNCA edite os logs manualmente.\n2. **Abertura:** Use o comando start no início de cada sessão de trabalho.\n3. **Encerramento:** Ao concluir entregas ou terminar a interação, use o comando end passando a lista exata do que construiu/modificou.\n4. **Fechamento Automático:** O script cuida do cabeçalho, cálculo do resumo do dia e índice do README.\n\n### Comandos\n\n```bash\npython3 .agents/scripts/auto_session.py start --agent <claude_code|codex|antigravity> # Abrir sessão\npython3 .agents/scripts/auto_session.py end --activities \"ativ1; ativ2\" # Fechar sessão\npython3 .agents/scripts/auto_session.py status # Ver sessão ativa\n```\n\n### Critérios de Qualidade\nA saída da descrição das atividades enviadas à flag `--activities` deve ser curta e objetiva. Abstê-se de logar dados sensíveis.\n\n---\n\n## 📂 Organização de Documentação (OBRIGATÓRIO)\n\nA documentação DEVE seguir esta estrutura de pastas. Não crie arquivos soltos na raiz de `docs/` (exceto BACKLOG.md).\n\n**Padrão oficial** (criado pelo `/define`):\n\n```bash\ndocs/\n├── 00-Contexto/ # Contexto do projeto e regras\n│ ├── CONTEXT.md # Gerado por /context\n│ └── READINESS.md # Gerado por /readiness\n├── 01-Planejamento/ # Artefatos executivos do /define\n│ ├── 01-product-brief.md\n│ ├── 02-prd.md\n│ ├── 03-design-system.md\n│ ├── 04-database-schema.md\n│ └── 05-roadmap-backlog.md\n├── 02-Requisitos/ # Detalhamento funcional\n│ ├── User-Stories.md\n│ └── Jornadas.md # Gerado por /journeys\n├── 03-Arquitetura/ # Técnicos e Decisões\n│ ├── ADRs/ # Architecture Decision Records\n│ └── Diagramas/ # Mermaid/PlantUML (fluxos, classes)\n├── 04-API/ # Contratos de Interface\n│ └── Endpoints.md # OpenAPI ou Docs REST\n├── 08-Logs-Sessoes/ # Logs de Sessão de Trabalho\n│ └── {ANO}/{DATA}.md # Logs diários\n└── BACKLOG.md # Backlog Mestre (Raiz)\n```\n\n**Aliases aceitos** (fallback legado / projetos sem `/define`):\n\n| Oficial (padrão) | Alias aceito |\n|----------------------|-----------------------|\n| `docs/01-Planejamento/` | `docs/planning/` |\n| `docs/00-Contexto/` | `docs/context/` |\n| `docs/02-Requisitos/` | `docs/requirements/` |\n| `docs/03-Arquitetura/` | `docs/architecture/` |\n| `docs/04-API/` | `docs/api/` |\n| `docs/08-Logs-Sessoes/` | `docs/logs/` |\n\n> **Resolução:** Ao procurar documentos, tente primeiro o caminho oficial. Se não existir, tente o alias. Use `resolve_doc_path()` / `resolve_doc_file()` de `platform_compat.py` em scripts Python.\n\n**Regra:** Ao criar documentos, sempre verifique se a pasta existe. Se não existir, crie-a.\n\n---\n\n## Compatibilidade Multi-Plataforma\n\nEste framework suporta **três ferramentas AI simultaneamente**:\n\n| Ferramenta | Arquivo de Instrução | Skills Location | Config |\n|------------|---------------------|-----------------|--------|\n| Claude Code | `CLAUDE.md` | `.agents/skills/` | N/A |\n| Codex CLI | `AGENTS.md` | `.codex/skills/` (symlink) | `.agents/config/codex.toml` |\n| Antigravity/Gemini | `GEMINI.md` | `.agents/skills/` | N/A |\n\n### Symlinks Nativos\n\nCada plataforma acessa os mesmos recursos via caminhos nativos (symlinks para `.agents/`):\n\n| Plataforma | Agents | Skills | Workflows |\n|------------|--------|--------|-----------|\n| Claude Code | `.claude/agents/` | `.claude/skills/` | `.agents/workflows/` |\n| Codex CLI | `.codex/agents/` | `.codex/skills/` | `.codex/prompts/` |\n| Antigravity | `.agents/agents/` | `.agents/skills/` | `.agents/workflows/` |\n\n> **Fonte canônica:** `.agents/` — todos os symlinks apontam para lá.\n\n### Detecção Automática de Plataforma\n\nOs scripts Python detectam automaticamente qual ferramenta está executando:\n\n```python\nfrom platform_compat import get_agent_source\nsource = get_agent_source() # 'claude_code', 'codex', ou 'unknown'\n```\n\n## Sistema Multi-Agent\n\nEste framework suporta múltiplos agentes AI trabalhando simultaneamente:\n\n### Identificação de Fonte\n```bash\n# Para Antigravity/Gemini\nexport AGENT_SOURCE=antigravity\n\n# Para Claude Code\nexport AGENT_SOURCE=claude_code\n\n# Para Codex CLI\nexport AGENT_SOURCE=codex\n```\n\n### Lock Manager\n```bash\npython3 .agents/scripts/lock_manager.py list # Ver locks ativos\npython3 .agents/scripts/lock_manager.py cleanup # Limpar locks expirados\n```\n\n### Ownership e Modelo Preferencial de Epics\n\nFormato no BACKLOG.md:\n```markdown\n## Epic 1: Nome [OWNER: claude_code] [MODEL: opus-4-5]\n```\n\n| Campo | Descrição | Valores |\n|-------|-----------|---------|\n| `OWNER` | Agente/ferramenta responsável | `claude_code`, `antigravity`, `codex` |\n| `MODEL` | Modelo AI preferencial | `opus-4-5`, `sonnet`, `haiku`, `gemini-2.0` |\n\n---\n\n## Scripts Úteis\n\n| Script | Comando | Descrição |\n|--------|---------|-----------|\n| Dashboard | `python3 .agents/scripts/dashboard.py` | Visão consolidada |\n| Progresso | `python3 .agents/scripts/progress_tracker.py` | Atualizar barra |\n| Sessão | `python3 .agents/scripts/auto_session.py start` | Iniciar sessão |\n| Finish | `python3 .agents/scripts/finish_task.py \"Epic-1\"` | Marcar completo |\n| Métricas | `python3 .agents/scripts/metrics.py` | Insights |\n| Validar | `python3 .agents/scripts/validate_installation.py` | Verificar setup |\n| Rastreabilidade | `python3 .agents/scripts/validate_traceability.py` | Validar cobertura |\n| Projeto | `python3 .agents/scripts/project_analyzer.py status` | Analisar tech stack |\n| Web Data | `python3 .agents/scripts/generate_web_data.py` | Gerar JSONs do site |\n| Checklist | `python3 .agents/scripts/checklist.py .` | Validação incremental |\n| Verificar Tudo | `python3 .agents/scripts/verify_all.py .` | Verificação completa |\n| Squad Manager | `python3 .agents/scripts/squad_manager.py list` | Gerenciar squads |\n| Recovery | `python3 .agents/scripts/recovery.py checkpoint <label>` | Retry + rollback |\n| Shard Epic | `python3 .agents/scripts/shard_epic.py shard` | Fatiar backlog em stories |\n\n---\n\n## Sistema de Squads\n\nSquads são pacotes reutilizáveis de agentes+skills+workflows para domínios específicos.\nSquads ficam em `squads/<nome>/` com manifesto `squad.yaml`. Detalhes em `squads/README.md`.\n\n| Comando | Descrição |\n|---------|-----------|\n| `/squad create <name>` | Criar novo squad |\n| `/squad list` | Listar squads |\n| `/squad activate <name>` | Ativar no framework |\n| `/squad deactivate <name>` | Desativar |\n\n---\n\n### Stitch MCP (Projetos com UI)\n\nPara TODOS os projetos com interface visual (HAS_UI=true):\n\n| Cenário | Comportamento |\n|---------|---------------|\n| Stitch MCP **disponível** + HAS_UI=true | **OBRIGATÓRIO** gerar protótipos via Stitch para **TODAS** as telas do sistema |\n| Stitch MCP **não disponível** + HAS_UI=true | **PARAR** e informar usuário para configurar Stitch antes de continuar |\n| HAS_UI=false | Fase 3.5 ignorada |\n\n**Regras de Cobertura Total:**\n- `/define` Fase 3.5: Prototipar **TODAS** as telas identificadas no UX Concept (não apenas 1 ou 2)\n- `/ui-ux-pro-max` Step 2c: Preview visual é OBRIGATÓRIO\n- `/readiness`: Valida existência de mockups E cobertura completa\n- **Gate de Bloqueio:** Fase 4 (Architecture) é BLOQUEADA até cobertura 100% das telas\n\nProjetos sem UI (API, CLI, backend-only): Stitch é ignorado.\n\n---\n\n### Recovery System\n\nScripts críticos usam retry automático e git checkpoint para operações seguras.\nMódulo: `.agents/scripts/recovery.py`\n\n---\n\n## Inicialização de Sessão\n\n> **PULO DO GATO (Context State):** Sempre que iniciar o trabalho com o usuário, **leia silenciosamente o arquivo `docs/PROJECT_STATUS.md`** (se existir). Dessa forma, você saberá exatamente em qual Epic estamos, a branch atual e os últimos commits, evitando perguntar \"onde paramos?\".\n\nToda conversa começa com:\n\n```\n✅ Project Instructions carregadas\n✅ Protocolo Inove AI Framework ativo\n✅ 22 agentes disponíveis\n✅ 42 skills disponíveis\n✅ 25 workflows disponíveis\n✅ Roteamento inteligente habilitado\n\n🎯 Pronto para trabalhar. O que devo fazer?\n```\n\n---\n\n## Referência Rápida de Agentes\n\n| Agente | Arquivo | Skills Primárias |\n|--------|---------|------------------|\n| `orchestrator` | `.agents/agents/orchestrator.md` | Coordenação multi-agente |\n| `project-planner` | `.agents/agents/project-planner.md` | Planejamento, discovery |\n| `product-manager` | `.agents/agents/product-manager.md` | Requisitos, user stories |\n| `frontend-specialist` | `.agents/agents/frontend-specialist.md` | React, UI/UX, Tailwind |\n| `backend-specialist` | `.agents/agents/backend-specialist.md` | APIs, Node.js, lógica |\n| `database-architect` | `.agents/agents/database-architect.md` | Schemas, Prisma, queries |\n| `mobile-developer` | `.agents/agents/mobile-developer.md` | iOS, Android, RN |\n| `security-auditor` | `.agents/agents/security-auditor.md` | Auth, OWASP, compliance |\n| `debugger` | `.agents/agents/debugger.md` | Root cause analysis |\n| `devops-engineer` | `.agents/agents/devops-engineer.md` | CI/CD, Docker, infra |\n| `test-engineer` | `.agents/agents/test-engineer.md` | Estratégias de teste |\n| `qa-automation-engineer` | `.agents/agents/qa-automation-engineer.md` | E2E, automação |\n| `documentation-writer` | `.agents/agents/documentation-writer.md` | Manuais, docs |\n| `code-archaeologist` | `.agents/agents/code-archaeologist.md` | Refatoração legacy |\n| `performance-optimizer` | `.agents/agents/performance-optimizer.md` | Otimizações |\n| `seo-specialist` | `.agents/agents/seo-specialist.md` | SEO, visibilidade |\n| `penetration-tester` | `.agents/agents/penetration-tester.md` | Security testing |\n| `game-developer` | `.agents/agents/game-developer.md` | Game logic |\n| `product-owner` | `.agents/agents/product-owner.md` | Requisitos, backlog, MVP |\n| `explorer-agent` | `.agents/agents/explorer-agent.md` | Análise de codebase |\n| `ux-researcher` | `.agents/agents/ux-researcher.md` | UX research, user flows, wireframes |\n\n---\n\n## Exemplo de Fluxo Completo\n\n**Usuário:** \"Implementar Epic 1: Autenticação de Usuários\"\n\n**Claude:**\n1. 🔍 Domínio detectado: Security + Backend\n2. 🤖 Ativando agentes:\n - @security-auditor (líder)\n - @backend-specialist (suporte)\n3. 📖 Carregando skills: vulnerability-scanner, api-patterns\n4. [Implementa código seguindo regras dos agentes]\n5. ✅ Implementação completa\n6. 🔧 Executando: `python3 .agents/scripts/finish_task.py \"Epic 1\"`\n7. 📊 Progresso: 25% (1/4 epics concluídos)\n\n**Usuário:** `/define App de gestão de tarefas`\n\n**Claude (ou Antigravity):**\n1. Fase 0: Discovery (12 perguntas estruturadas)\n2. Fase 1: Brief (`product-manager`)\n3. Fase 2: PRD + GAP Produto (`product-owner`)\n4. Fase 3: UX Concept + GAP UX (`ux-researcher`)\n5. Fase 4: Architecture + DB + GAP Infra (`project-planner`)\n6. Fase 5: Security + GAP Segurança (`security-auditor`)\n7. Fase 6: Stack + GAP Tech (`project-planner`)\n8. Fase 7: Design System + GAP Design (`frontend-specialist`)\n9. Fase 8: Backlog + GAPs consolidados (`product-owner`)\n10. Revisão: Claude Code/Codex valida com skill `doc-review`\n";
344
344
  //# sourceMappingURL=registry.js.map
package/dist/worker.js CHANGED
@@ -1,6 +1,6 @@
1
1
  /**
2
2
  * Cloudflare Workers entrypoint for Inove AI MCP Server.
3
- * Serves the same 21 agents, 41 skills, 22 workflows as the stdio server
3
+ * Serves the same 22 agents, 42 skills, 25 workflows as the stdio server
4
4
  * via Streamable HTTP transport (stateless, public).
5
5
  *
6
6
  * WARNING: This module must NOT import paths.ts or cache.ts — they use node:fs.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@joelbonito/mcp-server",
3
- "version": "5.1.4",
3
+ "version": "5.1.6",
4
4
  "description": "MCP server for Inove AI Framework — agents, skills, and workflows as MCP resources, tools and prompts",
5
5
  "license": "MIT",
6
6
  "author": "Inove AI <hello@inove.ai>",
@@ -58,4 +58,4 @@
58
58
  "publishConfig": {
59
59
  "access": "public"
60
60
  }
61
- }
61
+ }