@maestro-ai/cli 1.1.0 → 1.3.0

package/content/workflows/README-MCP.md

@@ -1,363 +0,0 @@
-# Workflows MCP Maestro
-
-Workflows integrados para desenvolvimento com MCP Maestro.
-
----
-
-## 🎯 Workflows Disponíveis
-
-### Gerenciamento de Projeto
-
-| Comando | Descrição | Quando Usar |
-|---------|-----------|-------------|
-| **[/mcp-start](mcp-start.md)** | Iniciar projeto MCP | Criar novo projeto do zero |
-| **[/mcp-next](mcp-next.md)** | Avançar fase | Após completar entregável |
-| **[/mcp-status](mcp-status.md)** | Ver status | Verificar progresso e métricas |
-| **[/mcp-gate](mcp-gate.md)** | Validar gate | Checar qualidade antes de avançar |
-
-### Desenvolvimento
-
-| Comando | Descrição | Quando Usar |
-|---------|-----------|-------------|
-| **[/mcp-feature](mcp-feature.md)** | Nova feature | Adicionar funcionalidade |
-| **[/mcp-debug](mcp-debug.md)** | Corrigir bug | Debugging estruturado |
-| **[/mcp-refactor](mcp-refactor.md)** | Refatorar código | Melhorar qualidade sem mudar comportamento |
-
----
-
-## 🚀 Quick Start
-
-### 1. Criar Novo Projeto
-
-```bash
-/mcp-start
-```
-
-**O workflow irá:**
-- Perguntar nome e descrição do projeto
-- Classificar automaticamente (POC/Script/Internal/Product + Simples/Médio/Complexo)
-- Apresentar classificação sugerida
-- Aguardar confirmação
-- Iniciar Fase 1 (Produto)
-
-### 2. Trabalhar nas Fases
-
-```bash
-# Após completar entregável da fase
-/mcp-next docs/01-produto/PRD.md
-```
-
-**O workflow irá:**
-- Validar gate da fase (score 0-100)
-- Se score >= 70: Avança automaticamente ✅
-- Se score < 70: Mostra pendências e bloqueia 🔴
-- Apresenta próxima fase + especialista
-
-### 3. Verificar Progresso
-
-```bash
-/mcp-status
-```
-
-**Mostra:**
-- Fase atual (X/Y)
-- Progresso percentual
-- Score do último gate
-- Próximos passos
-
----
-
-## 📊 Fluxo Completo
-
-```
-/mcp-start
-  ↓
-[Trabalhar em Fase 1]
-  ↓
-/mcp-next [entregavel]
-  ↓
-[Trabalhar em Fase 2]
-  ↓
-/mcp-next [entregavel]
-  ↓
-...
-  ↓
-[Projeto Concluído] ✅
-```
-
----
-
-## 🔄 Fluxos Alternativos
-
-### Adicionar Feature em Projeto Existente
-
-```bash
-/mcp-feature Sistema de notificações push
-```
-
-**Fluxo de 6 fases:**
-1. Análise de Impacto
-2. Refinamento de Requisitos
-3. Design/Arquitetura
-4. Implementação (Contrato → FE/BE → Integração)
-5. Testes
-6. Deploy
-
-### Corrigir Bug
-
-```bash
-/mcp-debug Pedido duplicado ao clicar rapidamente
-```
-
-**Fluxo de 4 fases:**
-1. Reprodução do Bug
-2. Análise de Causa Raiz
-3. Fix + Testes de Regressão
-4. Deploy
-
-### Refatorar Código
-
-```bash
-/mcp-refactor Serviço de autenticação
-```
-
-**Fluxo de 5 fases:**
-1. Análise de Código Atual
-2. Testes de Caracterização
-3. Refatoração Incremental
-4. Validação
-5. Deploy
-
----
-
-## 🎚️ Sistema de Gates Adaptativos
-
-### Tier Essencial (POC, Script)
-**Foco:** Funciona?
-- Código executa sem erros
-- Funcionalidade principal OK
-
-### Tier Base (Internal, Product Simples)
-**Foco:** Padrão indústria
-- Tier Essencial +
-- Testes unitários (>60%)
-- Lint sem erros
-- Segurança básica (OWASP)
-
-### Tier Avançado (Product Complexo)
-**Foco:** Estado da arte
-- Tier Base +
-- Testes E2E
-- Observabilidade
-- Performance otimizada
-- Compliance (LGPD, SOC2)
-
----
-
-## 🔐 Gate Protection Protocol
-
-> [!CAUTION]
-> **Regras de Proteção:**
-> 
-> - ✅ Score >= 70: Avança automaticamente
-> - 🔴 Score < 70: **BLOQUEIA** avanço
-> - ⚠️ IA **NUNCA** aprova gates automaticamente
-> - 📝 Usuário pode forçar com `/mcp-gate approve [motivo]`
-
----
-
-## 📐 Protocolo Frontend-First
-
-Para features com Frontend + Backend:
-
-```
-1. CONT (Contrato API)
-   ├── Gera: openapi.yaml
-   ├── Gera: types (FE + BE)
-   └── Gera: Mock Server
-
-2. Paralelo ⚡
-   ├── FE (desenvolve contra mock)
-   └── BE (implementa contrato)
-
-3. INT (Integração)
-   ├── Remove mocks
-   ├── Conecta FE ↔ BE real
-   └── Testes E2E
-```
-
----
-
-## 🧠 Especialistas MCP
-
-Os workflows carregam especialistas automaticamente via:
-
-```
-maestro://especialista/{nome}
-```
-
-**24 especialistas disponíveis:**
-- Gestão de Produto
-- Engenharia de Requisitos
-- UX Design
-- Prototipagem com Stitch (opcional)
-- Modelagem de Domínio
-- Banco de Dados
-- Arquitetura de Software
-- Segurança
-- Testes
-- Performance
-- Observabilidade
-- Plano de Execução
-- Contrato de API
-- Frontend
-- Backend
-- DevOps
-- E mais...
-
----
-
-## 📁 Estrutura de Arquivos
-
-Workflows MCP criam automaticamente:
-
-```
-[projeto]/
-├── .maestro/
-│   ├── estado.json          # ⭐ Fonte da verdade
-│   ├── resumo.json          # Cache de contexto
-│   └── gates-forcados.log   # Histórico de aprovações manuais
-└── docs/
-    ├── 01-produto/
-    │   └── PRD.md
-    ├── 02-requisitos/
-    │   └── requisitos.md
-    ├── 03-ux/
-    │   └── design-doc.md
-    └── ...
-```
-
----
-
-## 🔧 Protocolo Stateless (CRÍTICO)
-
-> [!IMPORTANT]
-> **SEMPRE antes de chamar qualquer tool MCP:**
-> 
-> ```typescript
-> const estadoJson = await fs.readFile('.maestro/estado.json', 'utf-8');
-> 
-> await mcp_maestro_[tool]({
->   estado_json: estadoJson,  // OBRIGATÓRIO
->   diretorio: process.cwd(),
->   // ... outros parâmetros
-> });
-> ```
-
----
-
-## 🆚 Comparação com Workflows Padrão
-
-| Workflow Padrão | Workflow MCP | Diferença |
-|----------------|--------------|-----------|
-| `/create` | `/mcp-start` | Classificação adaptativa + gates |
-| `/plan` | `/mcp-start` | Fluxo de fases estruturado |
-| `/enhance` | `/mcp-feature` | Frontend-First + validação |
-| `/debug` | `/mcp-debug` | Análise de causa raiz |
-| `/status` | `/mcp-status` | Métricas MCP + progresso |
-| - | `/mcp-gate` | Validação de qualidade |
-| - | `/mcp-refactor` | Testes de caracterização |
-
----
-
-## 📖 Documentação Completa
-
-Cada workflow tem documentação detalhada:
-
-- **[/mcp-start](mcp-start.md)** - Wizard de inicialização
-- **[/mcp-next](mcp-next.md)** - Sistema de gates
-- **[/mcp-feature](mcp-feature.md)** - Fluxo de features
-- **[/mcp-debug](mcp-debug.md)** - Debugging sistêmico
-- **[/mcp-status](mcp-status.md)** - Dashboard de status
-- **[/mcp-gate](mcp-gate.md)** - Validação de qualidade
-- **[/mcp-refactor](mcp-refactor.md)** - Refatoração segura
-
----
-
-## 🎓 Exemplos Práticos
-
-### SaaS Simples (7 fases)
-
-```bash
-# Iniciar
-/mcp-start TaskFlow
-
-> Tipo: Internal
-> Complexidade: Simples
-> Fases: 7
-
-# Trabalhar em cada fase
-/mcp-next docs/01-produto/PRD.md
-/mcp-next docs/02-requisitos/requisitos.md
-...
-```
-
-### Fintech Complexo (17 fases)
-
-```bash
-# Iniciar
-/mcp-start PaySecure
-
-> Tipo: Product
-> Complexidade: Complexo
-> Fases: 17
-> Tier: Avançado (compliance, observabilidade, etc)
-
-# Trabalhar em cada fase
-/mcp-next [entregavel]
-...
-```
-
-### Adicionar Feature
-
-```bash
-# No projeto existente
-/mcp-feature Integração com WhatsApp
-
-> Impacto: médio
-> Fases: 6 (Análise → Deploy)
-
-# Avançar
-/mcp-next [entregavel]
-...
-```
-
----
-
-## ❓ FAQ
-
-**P: Posso pular fases?**
-R: Não com `/mcp-next`. Gates bloqueiam avanço se qualidade < 70%.
-
-**P: Posso forçar aprovação de gate?**
-R: Sim, usuário (não IA) pode usar `/mcp-gate approve [motivo]`.
-
-**P: Como ajustar complexidade depois?**
-R: Use `/mcp-start reclassificar`
-
-**P: Workflows MCP funcionam sem MCP server?**
-R: Não, eles chamam tools MCP. Use workflows padrão se não tiver MCP.
-
----
-
-## 🔗 Links Úteis
-
-- [Plano de Implementação](../../../.gemini/antigravity/brain/[conversation-id]/implementation_plan.md)
-- [MCP Maestro README](../../README.md)
-- [Documentação MCP](../../docs/)
-
----
-
-**Versão:** 1.0.0  
-**Data:** 2026-01-23  
-**Autor:** Sistema MCP Maestro

package/content/workflows/brainstorm.md

@@ -1,113 +0,0 @@
----
-description: Structured brainstorming for projects and features. Explores multiple options before implementation.
----
-
-# /brainstorm - Structured Idea Exploration
-
-$ARGUMENTS
-
----
-
-## Purpose
-
-This command activates BRAINSTORM mode for structured idea exploration. Use when you need to explore options before committing to an implementation.
-
----
-
-## Behavior
-
-When `/brainstorm` is triggered:
-
-1. **Understand the goal**
-   - What problem are we solving?
-   - Who is the user?
-   - What constraints exist?
-
-2. **Generate options**
-   - Provide at least 3 different approaches
-   - Each with pros and cons
-   - Consider unconventional solutions
-
-3. **Compare and recommend**
-   - Summarize tradeoffs
-   - Give a recommendation with reasoning
-
----
-
-## Output Format
-
-```markdown
-## 🧠 Brainstorm: [Topic]
-
-### Context
-[Brief problem statement]
-
----
-
-### Option A: [Name]
-[Description]
-
-✅ **Pros:**
-- [benefit 1]
-- [benefit 2]
-
-❌ **Cons:**
-- [drawback 1]
-
-📊 **Effort:** Low | Medium | High
-
----
-
-### Option B: [Name]
-[Description]
-
-✅ **Pros:**
-- [benefit 1]
-
-❌ **Cons:**
-- [drawback 1]
-- [drawback 2]
-
-📊 **Effort:** Low | Medium | High
-
----
-
-### Option C: [Name]
-[Description]
-
-✅ **Pros:**
-- [benefit 1]
-
-❌ **Cons:**
-- [drawback 1]
-
-📊 **Effort:** Low | Medium | High
-
----
-
-## 💡 Recommendation
-
-**Option [X]** because [reasoning].
-
-What direction would you like to explore?
-```
-
----
-
-## Examples
-
-```
-/brainstorm authentication system
-/brainstorm state management for complex form
-/brainstorm database schema for social app
-/brainstorm caching strategy
-```
-
----
-
-## Key Principles
-
-- **No code** - this is about ideas, not implementation
-- **Visual when helpful** - use diagrams for architecture
-- **Honest tradeoffs** - don't hide complexity
-- **Defer to user** - present options, let them decide

package/content/workflows/create.md

@@ -1,59 +0,0 @@
----
-description: Create new application command. Triggers App Builder skill and starts interactive dialogue with user.
----
-
-# /create - Create Application
-
-$ARGUMENTS
-
----
-
-## Task
-
-This command starts a new application creation process.
-
-### Steps:
-
-1. **Request Analysis**
-   - Understand what the user wants
-   - If information is missing, use `conversation-manager` skill to ask
-
-2. **Project Planning**
-   - Use `project-planner` agent for task breakdown
-   - Determine tech stack
-   - Plan file structure
-   - Create plan file and proceed to building
-
-3. **Application Building (After Approval)**
-   - Orchestrate with `app-builder` skill
-   - Coordinate expert agents:
-     - `database-architect` → Schema
-     - `backend-specialist` → API
-     - `frontend-specialist` → UI
-
-4. **Preview**
-   - Start with `auto_preview.py` when complete
-   - Present URL to user
-
----
-
-## Usage Examples
-
-```
-/create blog site
-/create e-commerce app with product listing and cart
-/create todo app
-/create Instagram clone
-/create crm system with customer management
-```
-
----
-
-## Before Starting
-
-If request is unclear, ask these questions:
-- What type of application?
-- What are the basic features?
-- Who will use it?
-
-Use defaults, add details later.

package/content/workflows/debug.md

@@ -1,103 +0,0 @@
----
-description: Debugging command. Activates DEBUG mode for systematic problem investigation.
----
-
-# /debug - Systematic Problem Investigation
-
-$ARGUMENTS
-
----
-
-## Purpose
-
-This command activates DEBUG mode for systematic investigation of issues, errors, or unexpected behavior.
-
----
-
-## Behavior
-
-When `/debug` is triggered:
-
-1. **Gather information**
-   - Error message
-   - Reproduction steps
-   - Expected vs actual behavior
-   - Recent changes
-
-2. **Form hypotheses**
-   - List possible causes
-   - Order by likelihood
-
-3. **Investigate systematically**
-   - Test each hypothesis
-   - Check logs, data flow
-   - Use elimination method
-
-4. **Fix and prevent**
-   - Apply fix
-   - Explain root cause
-   - Add prevention measures
-
----
-
-## Output Format
-
-```markdown
-## 🔍 Debug: [Issue]
-
-### 1. Symptom
-[What's happening]
-
-### 2. Information Gathered
-- Error: `[error message]`
-- File: `[filepath]`
-- Line: [line number]
-
-### 3. Hypotheses
-1. ❓ [Most likely cause]
-2. ❓ [Second possibility]
-3. ❓ [Less likely cause]
-
-### 4. Investigation
-
-**Testing hypothesis 1:**
-[What I checked] → [Result]
-
-**Testing hypothesis 2:**
-[What I checked] → [Result]
-
-### 5. Root Cause
-🎯 **[Explanation of why this happened]**
-
-### 6. Fix
-```[language]
-// Before
-[broken code]
-
-// After
-[fixed code]
-```
-
-### 7. Prevention
-🛡️ [How to prevent this in the future]
-```
-
----
-
-## Examples
-
-```
-/debug login not working
-/debug API returns 500
-/debug form doesn't submit
-/debug data not saving
-```
-
----
-
-## Key Principles
-
-- **Ask before assuming** - get full error context
-- **Test hypotheses** - don't guess randomly
-- **Explain why** - not just what to fix
-- **Prevent recurrence** - add tests, validation

package/content/workflows/enhance.md

@@ -1,63 +0,0 @@
----
-description: Add or update features in existing application. Used for iterative development.
----
-
-# /enhance - Update Application
-
-$ARGUMENTS
-
----
-
-## Task
-
-This command adds features or makes updates to existing application.
-
-### Steps:
-
-1. **Understand Current State**
-   - Load project state with `python .agent/scripts/session_manager.py info`
-   - Understand existing features, tech stack
-
-2. **Plan Changes**
-   - Determine what will be added/changed
-   - Detect affected files
-   - Check dependencies
-
-3. **Present Plan to User** (for major changes)
-   ```
-   "To add admin panel:
-   - I'll create 15 new files
-   - Update 8 files
-   - Takes ~10 minutes
-   
-   Should I start?"
-   ```
-
-4. **Apply**
-   - Call relevant agents
-   - Make changes
-   - Test
-
-5. **Update Preview**
-   - Hot reload or restart
-
----
-
-## Usage Examples
-
-```
-/enhance add dark mode
-/enhance build admin panel
-/enhance integrate payment system
-/enhance add search feature
-/enhance edit profile page
-/enhance make responsive
-```
-
----
-
-## Caution
-
-- Get approval for major changes
-- Warn on conflicting requests (e.g., "use Firebase" when project uses PostgreSQL)
-- Commit each change with git