@maestro-ai/cli 1.2.0 → 1.3.0

package/content/workflows/05-nova-feature.md

@@ -0,0 +1,39 @@
+---
+description: Adicionar nova feature com fluxo estruturado (Análise → Implementação → Deploy)
+---
+
+# 🆕 /nova-feature - Workflow de Nova Feature
+
+## 1. Preparação (Análise de Impacto)
+
+*   **Estratégia:** Verifique a complexidade. Se envolver múltiplos domínios ou alto risco, consulte `guides/guide-orquestracao.md` para ativar o **Modo Squad**.
+*   **Ação:** Pergunte ao usuário a descrição da feature e o impacto estimado (baixo/médio/alto).
+*   **Ação:** Crie o diretório `docs/features/{FEATURE-ID}/`.
+*   **Ação:** Crie o arquivo `docs/features/{FEATURE-ID}/01-analise.md` com a análise inicial:
+    *   Tabelas afetadas
+    *   Novos Endpoints
+    *   Componentes de UI necessários
+
+## 2. Refinamento e Design
+
+*   **Instrução:** Use o workflow padrão `/02-avancar-fase` para mover a feature para Design.
+*   **Entregável Esperado:** Contrato de Interface (OpenAPI) e Mockups/Wireframes se necessário.
+
+## 3. Implementação (O "Core")
+
+> Aqui usamos o workflow especializado de granularidade fina.
+
+*   **Ação:** Quebre a feature em Histórias de Usuário (ex: `US-01: Criar API`, `US-02: Tela de Listagem`).
+*   **Para cada História:**
+    *   Execute o workflow: **`/04-implementar-historia`**
+    *   Siga ordenadamente: Types -> Mocks -> Frontend -> Backend -> Integração.
+
+## 4. Testes e Validação
+
+*   **Verificação de Segurança:** Antes de finalizar, leia `rules/security-rules.md` e revise o código.
+*   **Testes:** Garanta que os testes criados na fase de implementação estão passando.
+
+## 5. Deploy e Encerramento
+
+*   **Ação:** Atualize o `estado.json` (ou use `/02-avancar-fase`) para marcar a feature como CONCLUÍDA.
+*   **Resumo:** Atualize `.maestro/resumo.json` adicionando a feature ao histórico.

package/content/workflows/06-corrigir-bug.md

@@ -0,0 +1,34 @@
+---
+description: Workflow para correção de bugs com análise de causa raiz e segurança
+---
+
+# 🐛 /corrigir-bug - Workflow de Correção
+
+## 1. Reprodução e Análise
+
+*   **Estratégia:** Se o bug for crítico, arquitetural ou envolver múltiplos serviços, consulte `guides/guide-orquestracao.md` para ativar o **Modo Squad**.
+*   **Ação:** Crie um caso de teste que reproduza o erro (se possível).
+*   **Ação:** Analise a causa raiz.
+
+## 2. Classificação de Segurança
+
+*   **Ação:** O bug é uma vulnerabilidade de segurança?
+    *   **Sim:** Leia imediatamente `rules/security-rules.md` para entender a categoria (ex: SQL Injection, XSS).
+    *   **Não:** Prossiga normalmente.
+
+## 3. Implementação da Correção
+
+*   **Ação:** Implemente o fix.
+*   **Regra:** Não altere comportamento não relacionado (escopo fechado).
+
+## 4. Verificação
+
+*   **Ação:** Rode o teste de reprodução (deve passar).
+*   **Ação:** Rode testes de regressão (não deve quebrar nada existente).
+*   **Revisão (Self-Code-Review):**
+    *   Verifique se não deixou `console.log` (Regra `SEC-LOG`).
+    *   Verifique se não hardcodou credenciais (Regra `A02-SECRET`).
+
+## 5. Finalização
+
+*   **Ação:** Atualize o histórico em `.maestro/resumo.json` registrando o bug fix.

package/content/workflows/07-refatorar-codigo.md

@@ -0,0 +1,34 @@
+---
+description: Workflow para refatoração segura de código existente
+---
+
+# 🧹 /refatorar-codigo - Workflow de Refatoração
+
+## 1. Análise Prévia
+
+*   **Estratégia:** Se a refatoração for estrutural ou de alto risco, consulte `guides/guide-orquestracao.md` para ativar o **Modo Squad**.
+*   **Ação:** Identifique a área a ser refatorada (arquivo, função, módulo).
+*   **Ação:** Entenda o "Motivo" (Legibilidade, Performance, Segurança, Estrutura).
+*   **Ação:** **Importante**: Garanta que existem testes cobrindo essa área. Se não houver, crie um "Teste de Caracterização" (Snapshot/Unitário) antes de tocar no código.
+
+## 2. Consulta de Regras
+
+*   **Ação:** Se for refatoração de Segurança, leia `rules/security-rules.md`.
+*   **Ação:** Se for refatoração de Estrutura, consulte `.maestro/mapa.md` para entender dependências.
+
+## 3. Execução (Ciclo Red-Green-Refactor)
+
+*   **Passo 1:** Rode os testes (Devem passar: 🟢).
+*   **Passo 2:** Aplique uma pequena mudança de refatoração.
+*   **Passo 3:** Rode os testes (Devem passar: 🟢).
+*   **Passo 4:** Repita.
+
+## 4. Atualização de Mapa
+
+*   **Ação:** Se você alterou nomes de classes, arquivos ou assinaturas de API:
+    *   Execute `guides/internal/automated-map.md`.
+*   **Ação:** Registre o evento de refatoração via `guides/internal/automated-events.md`.
+
+## 5. Registro
+
+*   **Ação:** Registre a refatoração no `.maestro/resumo.json`.

package/dist/commands/init.js

@@ -43,7 +43,7 @@ export async function init(options) {
         await fse.ensureDir(join(cwd, '.maestro'));
         await fse.ensureDir(join(cwd, '.maestro', 'history'));
         await fse.writeJSON(join(cwd, '.maestro', 'config.json'), {
-            version: '1.0.0',
+            version: '1.3.0',
             initialized: new Date().toISOString(),
             ide: options.ide || 'windsurf',
             mcpFree: true
@@ -131,37 +131,38 @@ function generateDefaultRules() {
 
 ## Como Usar
 
-1. **Iniciar projeto**: Use \`/iniciar-projeto\` para começar
-2. **Avançar fases**: Use \`/avancar-fase\` para avançar
-3. **Ver status**: Use \`/status-projeto\` para ver progresso
-4. **Continuar**: Use \`/continuar\` para retomar trabalho
+1. **Ver status**: Use \`/00-maestro\` para ver progresso
+2. **Iniciar projeto**: Use \`/01-iniciar-projeto\` para começar
+3. **Avançar fases**: Use \`/02-avancar-fase\` para avançar
+4. **Continuar**: Use \`/03-continuar-fase\` para retomar trabalho
 
 ## Estrutura Local
 
 | Pasta | Conteúdo |
 |-------|----------|
 | \`.maestro/estado.json\` | Estado do projeto (fonte da verdade) |
-| \`.maestro/content/\` | Especialistas, templates, prompts |
+| \`.maestro/content/\` | Especialistas, templates, guides |
 | \`.windsurf/workflows/\` | Workflows para Windsurf |
 | \`.windsurf/skills/\` | Skills especializadas |
 | \`.cursor/commands/\` | Commands para Cursor |
 | \`.cursor/skills/\` | Skills especializadas |
-| \`.agent/workflows/\` | Workflows para Antigravity |
+| \`.agent/workflows/\` | Workflows Principais (00-08) |
 | \`.agent/skills/\` | Skills especializadas |
 
 ## Comandos Disponíveis
 
-### Gerenciamento de Projeto
-- \`/maestro\` - Comando universal inteligente
-- \`/iniciar-projeto\` - Iniciar novo projeto
-- \`/avancar-fase\` - Avançar para próxima fase
-- \`/status-projeto\` - Ver status e progresso
-- \`/continuar\` - Continuar fase atual
+### Gestão de Projeto
+- \`/00-maestro\` - Router Inteligente (Status)
+- \`/01-iniciar-projeto\` - Setup Inicial
+- \`/02-avancar-fase\` - Transição de Fase (com automações)
+- \`/03-continuar-fase\` - Retomada de Trabalho
+- \`/08-deploy-projeto\` - Deploy e Encerramento
 
 ### Desenvolvimento
-- \`/nova-feature\` - Criar nova funcionalidade
-- \`/corrigir-bug\` - Debugging estruturado
-- \`/refatorar-codigo\` - Refatoração segura
+- \`/04-implementar-historia\` - Frontend-First Dev
+- \`/05-nova-feature\` - Grandes Funcionalidades
+- \`/06-corrigir-bug\` - Fix com análise de causa
+- \`/07-refatorar-codigo\` - Melhoria técnica segura
 
 ## Especialistas IA
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@maestro-ai/cli",
-    "version": "1.2.0",
+    "version": "1.3.0",
     "description": "CLI para inicializar projetos Maestro File System - Orquestrador chat-first com workflows inteligentes",
     "type": "module",
     "main": "dist/index.js",

package/content/workflows/avancar-fase.md

@@ -1,84 +0,0 @@
----
-description: Valida fase atual com quality gates e prepara a próxima fase
----
-
-# 🔄 Workflow de Avanço - /avancar-fase
-
-## 1. Ler estado e fase atual
-
-```javascript
-const estado = lerJson('.maestro/estado.json');
-const faseAtual = estado.fases[estado.faseAtual];
-if (!faseAtual) throw new Error('Fase atual não existe');
-
-function salvarEstado(state) {
-  escreverJson('.maestro/estado.json', state, { spaces: 2 });
-}
-```
-
-## 2. Checklist obrigatório
-
-- `faseAtual.status` deve ser `concluida`.
-- `faseAtual.score >= faseAtual.scoreMinimo`.
-- Todos os itens de `faseAtual.validacoes` precisam estar `true`.
-- Verificar bloqueios pendentes.
-
-Se algum critério falhar, listar o motivo e encerrar sem avançar.
-
-## 3. Validação cruzada
-
-Use regras específicas da transição (ver `content/rules/quality-gates.md`). Exemplo:
-
-```javascript
-if (estado.faseAtual === 1) {
-  const prd = lerArquivo('docs/01-produto/PRD.md');
-  const requisitos = lerArquivo('docs/02-requisitos/requisitos.md');
-  const cobertura = validarCoberturaMVP(prd, requisitos);
-  if (cobertura.percentual < 100) throw new Error('MVP não está 100% coberto nos requisitos');
-}
-```
-
-## 4. Determinar próxima fase
-
-```javascript
-const PROGRESSAO = {
-  1: { numero: 2, nome: 'Requisitos', especialista: 'Engenharia de Requisitos', entregavel: 'docs/02-requisitos/requisitos.md' },
-  2: { numero: 3, nome: 'UX Design', especialista: 'UX Designer', entregavel: 'docs/03-ux/design-doc.md' },
-  // ... completar até o tier máximo
-};
-
-const proxima = PROGRESSAO[estado.faseAtual];
-if (!proxima) return 'Projeto já está na última fase';
-```
-
-Depois de obter `proxima`, consulte `content/guides/fases-mapeamento.md` para descobrir:
-
-- **Especialista** em `content/specialists/` que atuará na próxima fase
-- **Prompt principal** em `content/prompts/`
-- **Templates** que devem ser carregados/atualizados
-- **Skills** sugeridas em `content/skills/`
-
-Inclua essas referências na resposta final para orientar o usuário sobre o contexto que será carregado quando `/continuar-fase` for executado.
-
-## 5. Atualizar estado
-
-- Marcar `faseAtual.dataConclusao`.
-- Incrementar `estado.faseAtual` para `proxima.numero`.
-- Preparar entrada vazia para a próxima fase (`status: 'in_progress'`).
-- Registrar evento no histórico (`fase_avancada`).
-- Atualizar `estado.metrica.fasesConcluidas` e `estado.metrica.ultimoComando = '/avancar-fase'`.
-- Chamar `salvarEstado(estado)` após todas as alterações.
-
-## 6. Mensagem de saída
-
-```
-✅ **Fase {faseAtual.numero} - {faseAtual.nome} concluída!**
-📊 Score: {faseAtual.score}/{faseAtual.scoreMinimo}
-🔍 Validações: {lista de validações confirmadas}
-
-🎯 **Próxima fase:** {proxima.nome}
-👤 Especialista: {proxima.especialista}
-📁 Arquivo inicial: {proxima.entregavel}
-
-Execute `/continuar-fase` para começar imediatamente.
-```

package/content/workflows/brainstorm.md

@@ -1,127 +0,0 @@
----
-description: Exploração estruturada de ideias, integrada ao estado do Maestro.
----
-
-# /brainstorm - Exploração Estruturada de Ideias
-
-$ARGUMENTS
-
----
-
-## Pré-requisitos e conexão com o Maestro
-
-1. Execute `/maestro` para validar o estado atual e detectar fase/artefatos focos.
-2. Carregue `.maestro/estado.json` para contextualizar o brainstorming com o problema/fase em andamento:
-   ```javascript
-   const estado = lerJson('.maestro/estado.json');
-   const faseAtual = estado.fases?.[estado.faseAtual];
-   ```
-3. Registre no histórico (`estado.historico`) o evento `brainstorm_executado`, indicando o tópico e os caminhos escolhidos. Chame `salvarEstado(estado)` após concluir.
-4. Use `content/guides/fases-mapeamento.md` para puxar especialistas/prompts relacionados (ex.: fase 1 → Gestão de Produto, fase 3 → UX).
-
----
-
-## Purpose
-
-This command activates BRAINSTORM mode for structured idea exploration. Use when you need to explore options before committing to an implementation and quer salvar as conclusões no estado do Maestro.
-
----
-
-## Behavior
-
-When `/brainstorm` is triggered:
-
-1. **Understand the goal**
-   - What problem are we solving?
-   - Who is the user?
-   - What constraints exist?
-   - Relacione com `faseAtual.nome` e `faseAtual.especialista` para manter alinhamento.
-
-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 (registrar em `docs/brainstorm/<slug>.md` e anexar ao estado)
-
-```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 (fase 2 – requisitos)
-/brainstorm redesign para dashboard (fase 3 – UX)
-/brainstorm integrações com ERP (fase 6 – Integração)
-/brainstorm caching strategy para escala
-```
-
----
-
-## 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