@maestro-ai/cli 1.1.0 → 1.3.0

package/content/workflows/mcp-start.md

@@ -1,304 +0,0 @@
----
-description: Iniciar projeto MCP com classificação automática e wizard interativo
----
-
-# /mcp-start - Iniciar Projeto MCP Maestro
-
-$ARGUMENTS
-
----
-
-## Objetivo
-
-Iniciar novo projeto usando o sistema MCP Maestro com classificação automática de complexidade, seleção de tier de gates, e opção de prototipagem com Stitch.
-
----
-
-## Protocolo Stateless MCP (CRÍTICO)
-
-> [!IMPORTANT]
-> **ANTES de chamar QUALQUER tool MCP:**
-> 1. Ler `.maestro/estado.json` (se existir)
-> 2. Parsear conteúdo para variável `estado_json`
-> 3. Passar `estado_json` como argumento em TODOS os tools MCP
-> 4. NUNCA confiar em memória de conversação
-
----
-
-## Fluxo de Execução
-
-### Passo 1: Coleta de Informações
-
-**Perguntar ao usuário:**
-
-```
-🎯 **Iniciando Projeto MCP Maestro**
-
-1. Qual o nome do projeto?
-2. Descreva brevemente o projeto (problema, solução, público-alvo):
-```
-
-**Se usuário forneceu argumentos:**
-- `/mcp-start NomeProjeto` → Usar nome, pedir descrição
-- `/mcp-start` → Pedir nome e descrição
-
----
-
-### Passo 2: Análise e Classificação Automática
-
-**Chamar MCP tool:**
-
-```typescript
-await mcp_maestro_iniciar_projeto({
-  nome: "[nome fornecido]",
-  descricao: "[descrição fornecida]",
-  diretorio: process.cwd()
-});
-```
-
-**MCP retorna:**
-- Classificação sugerida: `tipo_artefato` (poc/script/internal/product)
-- Nível de complexidade: `nivel_complexidade` (simples/medio/complexo)
-- Tier de gates: `tier_gate` (essencial/base/avancado)
-- Número de fases resultante
-- Justificativa da classificação
-
----
-
-### Passo 3: Apresentar Classificação ao Usuário
-
-```markdown
-📊 **Classificação Automática**
-
-Analisei sua descrição e sugiro:
-
-- **Tipo de Artefato:** [POC/Script/Internal/Product]
-- **Complexidade:** [Simples/Médio/Complexo]
-- **Número de Fases:** [7/13/17]
-- **Tier de Gates:** [Essencial/Base/Avançado]
-
-**Justificativa:**
-- [motivo 1]
-- [motivo 2]
-- [motivo 3]
-
-**Isso significa:**
-- [O que o tier de gate valida]
-- [Quais especialistas serão usados]
-
-Confirmar classificação? (Y/N)
-Se quiser ajustar, responda: "reclassificar para [simples/medio/complexo]"
-```
-
----
-
-### Passo 4: Confirmação ou Reclassificação
-
-**Se usuário confirmar (Y):**
-
-```typescript
-const estadoJson = await fs.readFile('.maestro/estado.json', 'utf-8');
-
-await mcp_maestro_confirmar_projeto({
-  nome: "[nome]",
-  diretorio: process.cwd(),
-  tipo_artefato: "[tipo sugerido]",
-  nivel_complexidade: "[nivel sugerido]"
-});
-```
-
-**Se usuário quiser reclassificar:**
-
-```typescript
-const estadoJson = await fs.readFile('.maestro/estado.json', 'utf-8');
-
-await mcp_maestro_classificar({
-  nivel: "[simples/medio/complexo]",
-  estado_json: estadoJson,
-  diretorio: process.cwd()
-});
-
-// Após reclassificação, confirmar:
-await mcp_maestro_confirmar_classificacao({
-  nivel: "[novo nivel]",
-  tipo_artefato: "[tipo]",
-  estado_json: estadoJson,
-  diretorio: process.cwd()
-});
-```
-
----
-
-### Passo 5: Opção de Prototipagem com Stitch (Opcional)
-
-```markdown
-🎨 **Prototipagem com Google Stitch**
-
-Deseja incluir uma fase de **Prototipagem Rápida com Google Stitch**?
-
-Isso adiciona uma fase após UX Design para:
-- Gerar prompts otimizados para Stitch
-- Criar protótipos HTML/CSS validados
-- Exportar código para produção
-
-Usar Stitch? (Y/N)
-```
-
-**Se Y:**
-
-```typescript
-const estadoJson = await fs.readFile('.maestro/estado.json', 'utf-8');
-
-await mcp_maestro_confirmar_stitch({
-  usar_stitch: true,
-  estado_json: estadoJson,
-  diretorio: process.cwd()
-});
-```
-
----
-
-### Passo 6: Apresentar Fase Inicial
-
-```markdown
-✅ **Projeto Iniciado com Sucesso**
-
-📁 **Diretório:** [diretorio]
-📋 **Fase 1/[total]:** Produto
-🤖 **Especialista:** Gestão de Produto
-📄 **Entregável Esperado:** PRD.md
-
----
-
-## 🎯 Fase 1: Visão de Produto
-
-Como **Especialista em Gestão de Produto**, vou ajudá-lo a definir:
-
-1. **Problema** - Que dor estamos resolvendo?
-2. **Solução** - Como vamos resolver?
-3. **Público-alvo** - Quem são os usuários?
-4. **MVP** - O que entra na primeira versão?
-5. **Métricas** - Como medir sucesso (North Star Metric)?
-
-Vamos começar. Qual o **principal problema** que este produto resolve?
-```
-
-**Carregar especialista:**
-
-```typescript
-const especialista = await fetch('maestro://especialista/gestao-de-produto');
-// Aplicar persona e instruções do especialista
-```
-
----
-
-## Estrutura Criada
-
-Após execução bem-sucedida, o projeto terá:
-
-```
-[nome-projeto]/
-├── .maestro/
-│   ├── estado.json       # ⭐ Fonte da verdade (STATE)
-│   └── resumo.json       # Cache de contexto
-└── docs/
-    └── 01-produto/       # Criado quando salvar PRD
-```
-
----
-
-## Comandos Relacionados
-
-```
-/mcp-start              → Wizard completo (recomendado)
-/mcp-start MeuProjeto   → Inicia com nome, pede descrição
-/mcp-status             → Ver status após criação
-/mcp-next               → Avançar para próxima fase
-```
-
----
-
-## Exemplos de Uso
-
-### Exemplo 1: SaaS Simples
-
-```
-User: /mcp-start
-
-AI: Qual o nome do projeto?
-User: TaskFlow
-
-AI: Descreva brevemente o projeto:
-User: Gerenciador de tarefas para times pequenos, até 10 usuários
-
-AI: 📊 Classificação Automática
-    - Tipo: Internal
-    - Complexidade: Simples (7 fases)
-    - Tier: Base
-    - Justificativa: Escala pequena, sem integrações complexas
-
-User: Y
-
-AI: Usar Stitch?
-User: N
-
-AI: ✅ Projeto iniciado! Fase 1: Produto...
-```
-
-### Exemplo 2: Fintech Complexo
-
-```
-User: /mcp-start
-
-AI: Qual o nome do projeto?
-User: PaySecure
-
-AI: Descreva brevemente o projeto:
-User: Plataforma de pagamentos com multi-tenancy, compliance PCI-DSS, 100k+ usuários
-
-AI: 📊 Classificação Automática
-    - Tipo: Product
-    - Complexidade: Complexo (17 fases)
-    - Tier: Avançado
-    - Justificativa: 
-      - Multi-tenancy detectado
-      - Compliance rigoroso (PCI-DSS)
-      - Alta escala (100k+ usuários)
-
-User: Y
-
-AI: Usar Stitch?
-User: Y
-
-AI: ✅ Projeto iniciado! Fase Stitch incluída após UX...
-```
-
----
-
-## Regras Críticas
-
-1. ✅ **SEMPRE** ler `estado.json` antes de chamar tools MCP
-2. ✅ **SEMPRE** passar `estado_json` como argumento
-3. ✅ **AGUARDAR** confirmação do usuário antes de `confirmar_projeto`
-4. ❌ **NUNCA** assumir classificação sem mostrar ao usuário
-5. ❌ **NUNCA** pular wizard, sempre fazer perguntas
-6. ❌ **NUNCA** avançar automaticamente para Fase 2 (usar `/mcp-next`)
-
----
-
-## Troubleshooting
-
-### Erro: "estado.json not found"
-
-**Causa:** Tool MCP esperava estado mas projeto não foi criado ainda.
-
-**Solução:** Normal no primeiro `iniciar_projeto`. Ignorar e continuar.
-
-### Classificação Parece Errada
-
-**Solução:** Perguntar ao usuário se quer reclassificar:
-
-```
-A classificação parece adequada? Se quiser ajustar, diga:
-"reclassificar para [simples/medio/complexo]"
-```

package/content/workflows/mcp-status.md

@@ -1,400 +0,0 @@
----
-description: Visualizar status completo do projeto MCP com métricas e progresso
----
-
-# /mcp-status - Status do Projeto MCP
-
-$ARGUMENTS
-
----
-
-## Objetivo
-
-Visualizar estado completo do projeto MCP Maestro: fase atual, progresso, gates, stack tecnológica e próximos passos.
-
----
-
-## Execução
-
-### Verificar Contexto MCP
-
-```typescript
-if (!fs.existsSync('.maestro/estado.json')) {
-  return `
-❌ **Nenhum projeto MCP ativo**
-
-Para iniciar um projeto, use:
-\`/mcp-start\`
-  `;
-}
-
-const estadoJson = await fs.readFile('.maestro/estado.json', 'utf-8');
-
-await mcp_maestro_status({
-  estado_json: estadoJson,
-  diretorio: process.cwd()
-});
-```
-
----
-
-## Formato de Saída
-
-```markdown
-# 📊 Status MCP Maestro
-
-## 📁 Projeto
-
-- **Nome:** [nome do projeto]
-- **Diretório:** [caminho absoluto]
-- **Tipo de Artefato:** [POC / Script / Internal / Product]
-- **Complexidade:** [Simples / Médio / Complexo]
-- **Tier de Gates:** [Essencial / Base / Avançado]
-
----
-
-## 🎯 Progresso
-
-**Fase Atual:** [numero]/[total] - [nome da fase]
-
-```
-[▓▓▓▓▓▓▓▓▓░░░░░░] 60% completo
-```
-
-**Fases:**
-1. ✅ Produto (100%)
-2. ✅ Requisitos (100%)
-3. ✅ UX Design (100%)
-4. 🔄 Modelagem de Domínio (em andamento)
-5. ⏳ Arquitetura de Software (pendente)
-6. ⏳ ... (pendente)
-
----
-
-## 🤖 Especialista Atual
-
-**Nome:** [Especialista em Modelagem de Domínio]
-**Papel:** [Definir entidades, relacionamentos, agregados e eventos de domínio]
-**Entregável Esperado:** `modelo-dominio.md`
-
----
-
-## 🏗️ Stack Tecnológica
-
-- **Framework:** [Next.js 14 / Laravel 11 / NestJS / etc]
-- **Database:** [PostgreSQL / MySQL / MongoDB]
-- **Linguagem:** [TypeScript / PHP / Java]
-- **Cloud:** [AWS / GCP / Azure / Vercel]
-
----
-
-## 🚦 Último Gate
-
-**Fase:** [numero] - [nome]
-**Score:** [score]/100
-**Status:** [✅ Aprovado / ⚠️ Aprovado com pendências / 🔴 Bloqueado]
-
-${score < 100 ? `
-**Pendências:**
-${pendencias.map(p => `- ${p}`).join('\n')}
-` : ''}
-
----
-
-## 📈 Métricas
-
-- **Fases Concluídas:** [numero]/[total] ([percentual]%)
-- **Entregáveis Salvos:** [numero]
-- **Gates Validados:** [numero_aprovados]/[numero_total]
-- **Tempo no Projeto:** [dias desde inicio]
-
----
-
-## 📋 Próximos Passos
-
-1. **Completar Fase Atual:** [nome da fase]
-   - Criar: `[entregável esperado]`
-   - Validação: [checklist resumido]
-
-2. **Avançar:** Use `/mcp-next [arquivo]`
-
-3. **Próxima Fase:** [numero+1] - [nome]
-   - Especialista: [nome]
-   - Template: [template.md]
-
----
-
-## 🔗 Comandos Úteis
-
-\`\`\`
-/mcp-next [arquivo]         → Avançar para próxima fase
-/mcp-gate                   → Validar gate atual
-/mcp-feature [descrição]    → Adicionar nova feature
-/mcp-debug [descrição]      → Corrigir bug
-\`\`\`
-```
-
----
-
-## Variações de Comando
-
-### Status Básico
-
-```
-/mcp-status
-```
-
-→ Saída completa acima
-
-### Status Resumido
-
-```
-/mcp-status --short
-```
-
-→ Saída:
-
-```
-📊 RestaurantePro - Product Médio (Fase 4/13)
-🎯 Modelagem de Domínio [▓▓▓▓▓▓░░░░░░░] 46%
-📄 Entregável: modelo-dominio.md
-```
-
-### Status com Histórico
-
-```
-/mcp-status --history
-```
-
-→ Adiciona seção:
-
-```markdown
-## 📜 Histórico de Fases
-
-| Fase | Nome | Concluída em | Score | Duração |
-|------|------|--------------|-------|---------|
-| 1 | Produto | 2026-01-20 | 95/100 | 2h |
-| 2 | Requisitos | 2026-01-21 | 85/100 | 3h |
-| 3 | UX Design | 2026-01-22 | 90/100 | 4h |
-| 4 | Modelagem | Em andamento | - | 1h até agora |
-```
-
----
-
-## Exemplos de Saída
-
-### Exemplo 1: Projeto no Meio (Fase 4/13)
-
-```markdown
-# 📊 Status MCP Maestro
-
-## 📁 Projeto
-
-- **Nome:** RestaurantePro
-- **Tipo:** Product
-- **Complexidade:** Médio (13 fases)
-- **Tier:** Base
-
----
-
-## 🎯 Progresso
-
-**Fase Atual:** 4/13 - Modelagem de Domínio
-
-[▓▓▓▓▓░░░░░░░░] 31% completo
-
-**Fases:**
-1. ✅ Produto
-2. ✅ Requisitos
-3. ✅ UX Design
-4. 🔄 Modelagem de Domínio (em andamento)
-5. ⏳ Banco de Dados
-6. ⏳ Arquitetura de Software
-...
-
----
-
-## 🤖 Especialista Atual
-
-**Nome:** Especialista em Modelagem de Domínio
-**Entregável:** `modelo-dominio.md`
-
----
-
-## 🏗️ Stack
-
-- Framework: Next.js 14
-- Database: PostgreSQL
-- Linguagem: TypeScript
-
----
-
-## 🚦 Último Gate
-
-**Fase:** 3 - UX Design
-**Score:** 90/100 ✅
-**Pendências:**
-- Protótipos de alta fidelidade (opcional para tier Base)
-
----
-
-## 📋 Próximos Passos
-
-1. Completar modelo de domínio (Entidades, Agregados, Eventos)
-2. Avançar: `/mcp-next docs/04-modelo/modelo-dominio.md`
-3. Próxima: Fase 5 - Banco de Dados
-```
-
-### Exemplo 2: Projeto Concluído
-
-```markdown
-# 📊 Status MCP Maestro
-
-## 📁 Projeto
-
-- **Nome:** TaskFlow
-- **Tipo:** Internal
-- **Complexidade:** Simples (7 fases)
-- **Tier:** Base
-
----
-
-## 🎯 Progresso
-
-**Status:** ✅ **PROJETO CONCLUÍDO**
-
-[▓▓▓▓▓▓▓▓▓▓▓▓▓▓] 100% completo
-
-**Todas as 7 fases finalizadas:**
-1. ✅ Produto
-2. ✅ Requisitos
-3. ✅ UX Design
-4. ✅ Modelagem
-5. ✅ Arquitetura
-6. ✅ Desenvolvimento
-7. ✅ Deploy
-
----
-
-## 🏆 Resumo Final
-
-- **Tempo Total:** 5 dias
-- **Entregáveis:** 7 documentos
-- **Score Médio dos Gates:** 87/100
-- **Deploy:** https://taskflow.example.com
-
----
-
-## 📋 Próximos Passos
-
-🎉 Projeto concluído!
-
-Para adicionar features:
-- `/mcp-feature [descrição]`
-
-Para manutenção:
-- `/mcp-debug [bug]`
-- `/mcp-refactor [área]`
-```
-
-### Exemplo 3: Nenhum Projeto Ativo
-
-```
-❌ **Nenhum projeto MCP ativo**
-
-Para iniciar um projeto, use:
-`/mcp-start`
-
-Ou, se já existe um projeto:
-`cd [diretorio-do-projeto]`
-`/mcp-status`
-```
-
----
-
-## Status em Contexto de Feature/Bug
-
-Se estiver em um fluxo de feature ou bug, mostra ambos:
-
-```markdown
-# 📊 Status MCP Maestro
-
-## 📁 Projeto Principal
-
-[status normal do projeto]
-
----
-
-## 🆕 Feature em Andamento
-
-**ID:** FEAT-001
-**Descrição:** Sistema de notificações push
-**Fase:** 3/6 - Design
-**Progresso:** [▓▓▓▓░░] 50%
-
-Use `/mcp-next` para avançar a feature
-
----
-
-## 🐛 Bug em Correção
-
-**ID:** BUG-002
-**Descrição:** Timeout no carregamento de imagens
-**Severidade:** Alta
-**Fase:** 2/4 - Análise de Causa Raiz
-
-Use `/mcp-next` para continuar o debug
-```
-
----
-
-## Integração com Dashboard Visual (Futuro)
-
-O status pode ser exportado para dashboards:
-
-```
-/mcp-status --export json > status.json
-/mcp-status --export html > dashboard.html
-```
-
----
-
-## Comandos Relacionados
-
-```
-/mcp-status                 → Status completo
-/mcp-status --short         → Resumo de uma linha
-/mcp-status --history       → Com histórico de fases
-/mcp-next                   → Avançar fase
-/mcp-start                  → Iniciar novo projeto
-```
-
----
-
-## Troubleshooting
-
-### Status Desatualizado
-
-**Sintoma:** Status mostra fase antiga
-
-**Causa:** Cache de `resumo.json`
-
-**Solução:**
-
-```bash
-# Forçar reload do estado.json
-/mcp-status --reload
-```
-
-### Múltiplos Projetos
-
-**Sintoma:** Status do projeto errado
-
-**Solução:**
-
-```bash
-cd /caminho/do/projeto/correto
-/mcp-status
-```
-
-O status sempre usa `.maestro/estado.json` do diretório atual.