@maestro-ai/cli 1.0.0

package/content/workflows/mcp-start.md

@@ -0,0 +1,304 @@
+---
+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

@@ -0,0 +1,400 @@
+---
+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.