@maestro-ai/cli 1.0.0

package/content/templates/mapa-navegacao.md

@@ -0,0 +1,133 @@
+# Mapa de Navegação: [Nome do Sistema]
+
+**Versão:** 1.0  
+**Data:** YYYY-MM-DD  
+**Designer:** [Nome]  
+**Design Doc Relacionado:** [Link]
+
+---
+
+## 1. Diagrama de Navegação
+
+```mermaid
+flowchart LR
+    subgraph Public["🌐 Área Pública"]
+        HOME[Home]
+        LOGIN[Login]
+        REGISTER[Cadastro]
+        FORGOT[Esqueci Senha]
+    end
+    
+    subgraph Auth["🔐 Área Autenticada"]
+        DASH[Dashboard]
+        PROFILE[Perfil]
+        SETTINGS[Configurações]
+    end
+    
+    subgraph Module1["📦 Módulo 1"]
+        M1_LIST[Lista]
+        M1_DETAIL[Detalhe]
+        M1_CREATE[Criar/Editar]
+    end
+    
+    HOME --> LOGIN
+    HOME --> REGISTER
+    LOGIN --> FORGOT
+    LOGIN --> DASH
+    REGISTER --> DASH
+    
+    DASH --> PROFILE
+    DASH --> SETTINGS
+    DASH --> M1_LIST
+    
+    M1_LIST --> M1_DETAIL
+    M1_LIST --> M1_CREATE
+    M1_DETAIL --> M1_CREATE
+    M1_DETAIL -.->|voltar| M1_LIST
+```
+
+---
+
+## 2. Inventário de Telas
+
+| ID | Tela | URL | Acesso | RFs Relacionados | Descrição |
+|----|------|-----|--------|------------------|-----------|
+| T01 | Home | `/` | Público | - | Landing page |
+| T02 | Login | `/login` | Público | RF-001 | Autenticação |
+| T03 | Cadastro | `/register` | Público | RF-002 | Novo usuário |
+| T04 | Dashboard | `/dashboard` | Auth | RF-003 | Visão geral |
+| T05 | [Módulo] Lista | `/modulo` | Auth | RF-00X | Lista de itens |
+| T06 | [Módulo] Detalhe | `/modulo/:id` | Auth | RF-00X | Detalhes do item |
+| T07 | [Módulo] Criar | `/modulo/new` | Auth | RF-00X | Criar novo item |
+
+---
+
+## 3. Padrões de Navegação
+
+### 3.1 Navegação Global
+
+| Padrão | Telas Aplicáveis | Comportamento |
+|--------|------------------|---------------|
+| Header | Todas autenticadas | Logo, menu principal, avatar |
+| Sidebar | Dashboard, módulos | Menu colapsável |
+| Breadcrumb | Detalhes, edição | Home > Módulo > Item |
+| Back Button | Detalhes, formulários | Volta para lista |
+
+### 3.2 Transições entre Telas
+
+| Origem | Destino | Gatilho | Dados Passados |
+|--------|---------|---------|----------------|
+| Lista | Detalhe | Click no item | `id` do item |
+| Detalhe | Editar | Botão "Editar" | `id` do item |
+| Form | Lista | Submit sucesso | - (refresh lista) |
+| Qualquer | Login | Sessão expirada | `returnUrl` |
+
+---
+
+## 4. Estados por Tela
+
+| Tela | Loading | Empty | Error | Success |
+|------|---------|-------|-------|---------|
+| Lista | Skeleton table | "Nenhum item encontrado" + CTA | Toast + retry | - |
+| Detalhe | Spinner central | 404 page | Toast + back | - |
+| Form | Button loading | - | Inline errors | Toast + redirect |
+| Dashboard | Skeleton cards | Cards com zeros | Toast | - |
+
+---
+
+## 5. Responsividade
+
+| Breakpoint | Navegação | Layout |
+|------------|-----------|--------|
+| Mobile (< 768px) | Bottom nav ou hamburger | Stack vertical |
+| Tablet (768-1024px) | Sidebar colapsada | 2 colunas |
+| Desktop (> 1024px) | Sidebar fixa | 3+ colunas |
+
+---
+
+## 6. Acessibilidade na Navegação
+
+- [ ] Skip links no topo de cada página
+- [ ] Focus trap em modais
+- [ ] Aria-current para item ativo do menu
+- [ ] Landmarks (`nav`, `main`, `aside`)
+- [ ] Anúncio de mudança de página para screen readers
+
+---
+
+## 7. Deep Links e Compartilhamento
+
+| Tela | Pode Compartilhar | URL Pattern | Auth Required |
+|------|-------------------|-------------|---------------|
+| Detalhe | ✅ | `/modulo/:id` | Sim |
+| Lista com filtros | ✅ | `/modulo?filter=x` | Sim |
+| Dashboard | ❌ | - | Sim |
+| Login | ❌ | - | Não |
+
+---
+
+## Changelog
+
+| Versão | Data | Autor | Mudanças |
+|--------|------|-------|----------|
+| 1.0 | YYYY-MM-DD | [Nome] | Versão inicial |

package/content/templates/matriz-rastreabilidade.md

@@ -0,0 +1,121 @@
+# Matriz de Rastreabilidade: [Nome do Sistema]
+
+**Versão:** 1.0  
+**Data:** YYYY-MM-DD  
+**Responsável:** [Nome]
+
+---
+
+## Objetivo
+
+Garantir que todos os requisitos estejam cobertos por histórias de usuário e casos de teste, permitindo rastreabilidade completa do requisito até a validação.
+
+---
+
+## Matriz: Requisitos → User Stories → Testes
+
+| ID Requisito | Descrição Resumida | User Stories | Casos de Teste | Status |
+|---|---|---|---|---|
+| **RF001** | [Descrição curta] | US001, US002 | TC001, TC002, TC003 | ✅ Coberto |
+| **RF002** | [Descrição curta] | US003 | TC004, TC005 | ✅ Coberto |
+| **RF003** | [Descrição curta] | - | - | ❌ Não coberto |
+| **RF004** | [Descrição curta] | US004 | TC006 | 🔄 Em andamento |
+| **RNF001** | [Performance] | - | TC-PERF-001 | ⏳ Pendente |
+| **RNF002** | [Segurança] | - | TC-SEC-001 | ⏳ Pendente |
+
+---
+
+## Cobertura por Requisito
+
+### Requisitos Funcionais
+
+| Status | Quantidade | % |
+|---|---|---|
+| ✅ Coberto (US + TC) | X | X% |
+| 🔄 Parcial (só US ou só TC) | X | X% |
+| ❌ Não coberto | X | X% |
+| **Total** | X | 100% |
+
+### Requisitos Não-Funcionais
+
+| Status | Quantidade | % |
+|---|---|---|
+| ✅ Coberto | X | X% |
+| ⏳ Pendente | X | X% |
+| **Total** | X | 100% |
+
+---
+
+## Matriz: User Stories → Código → Testes
+
+| US ID | Módulo/Arquivo | Testes Unitários | Testes Integração | Cobertura |
+|---|---|---|---|---|
+| US001 | `src/modules/user/` | user.service.spec.ts | user.e2e.spec.ts | 85% |
+| US002 | `src/modules/order/` | order.service.spec.ts | order.e2e.spec.ts | 78% |
+| US003 | `src/modules/payment/` | - | - | 0% |
+
+---
+
+## Gaps Identificados
+
+### Requisitos sem Cobertura
+
+| ID | Descrição | Ação | Responsável | Prazo |
+|---|---|---|---|---|
+| RF003 | [Descrição] | Criar US e TC | [Nome] | [Data] |
+| RNF001 | [Performance] | Criar teste de carga | [Nome] | [Data] |
+
+### User Stories sem Testes
+
+| ID | Descrição | Ação | Responsável | Prazo |
+|---|---|---|---|---|
+| US003 | [Descrição] | Criar testes | [Nome] | [Data] |
+
+---
+
+## Dependências entre Requisitos
+
+```mermaid
+graph TD
+    RF001[RF001: Login] --> RF002[RF002: Dashboard]
+    RF001 --> RF003[RF003: Perfil]
+    RF002 --> RF004[RF004: Relatórios]
+    RF005[RF005: Pagamento] --> RF006[RF006: Fatura]
+```
+
+---
+
+## Histórico de Mudanças em Requisitos
+
+| ID | Data | Mudança | Impacto em US | Impacto em TC |
+|---|---|---|---|---|
+| RF001 | YYYY-MM-DD | [Descrição da mudança] | US001 atualizada | TC001, TC002 revisados |
+| RF004 | YYYY-MM-DD | [Novo requisito adicionado] | US005 criada | TC007 criado |
+
+---
+
+## Checklist de Rastreabilidade
+
+- [ ] Todo RF tem pelo menos 1 US associada
+- [ ] Toda US tem critérios de aceite em Gherkin
+- [ ] Todo critério de aceite tem TC correspondente
+- [ ] Todos os TCs estão implementados e passando
+- [ ] RNFs têm testes específicos (performance, segurança)
+- [ ] Matriz atualizada após cada sprint
+
+---
+
+## Exportação / Links
+
+- Requisitos: [Link para requisitos.md]
+- Backlog: [Link para backlog.md]
+- Plano de Testes: [Link para plano-testes.md]
+- Board (Jira/Linear): [Link]
+
+---
+
+## Changelog
+
+| Versão | Data | Autor | Mudanças |
+|---|---|---|---|
+| 1.0 | YYYY-MM-DD | [Nome] | Versão inicial |

package/content/templates/modelo-dominio.md

@@ -0,0 +1,219 @@
+# Modelo de Domínio: [Nome do Sistema]
+
+**Versão:** 1.0  
+**Data:** YYYY-MM-DD  
+**Requisitos Relacionados:** [Link]
+
+---
+
+## 1. Bounded Contexts
+
+```mermaid
+graph TB
+    subgraph Core["🔴 Core Domain"]
+        BC1[Contexto Principal]
+    end
+    subgraph Supporting["🟡 Supporting"]
+        BC2[Contexto de Suporte 1]
+        BC3[Contexto de Suporte 2]
+    end
+    subgraph Generic["🟢 Generic"]
+        BC4[Autenticação]
+        BC5[Notificações]
+    end
+    
+    BC1 --> BC2
+    BC1 --> BC4
+    BC2 --> BC5
+```
+
+| Bounded Context | Responsabilidade | Tipo | Linguagem Ubíqua |
+|---|---|---|---|
+| [Nome] | [O que faz] | Core/Supporting/Generic | [Termos específicos] |
+
+---
+
+## 2. Entidades
+
+### 2.1 [NomeEntidade]
+
+**Descrição:** [O que esta entidade representa no domínio]
+
+**Bounded Context:** [A qual contexto pertence]
+
+| Campo | Tipo | Obrigatório | Descrição | Validações |
+|---|---|---|---|---|
+| id | UUID | ✅ | Identificador único | Auto-gerado |
+| nome | string(100) | ✅ | Nome do... | Min 2 chars |
+| email | string(255) | ✅ | Email do... | Formato email |
+| status | enum | ✅ | Status atual | [ATIVO, INATIVO] |
+| createdAt | datetime | ✅ | Data de criação | Auto |
+| updatedAt | datetime | ✅ | Última atualização | Auto |
+
+**Regras de Negócio:**
+- RN1: [Nome deve ser único dentro de X]
+- RN2: [Status só pode mudar de ATIVO para INATIVO se Y]
+
+**Invariantes:**
+- [Condição que SEMPRE deve ser verdadeira para esta entidade]
+- Email não pode ser alterado após criação
+
+**Métodos de Domínio:**
+- `ativar()`: Muda status para ATIVO
+- `desativar()`: Muda status para INATIVO se [condição]
+
+---
+
+### 2.2 [OutraEntidade]
+
+**Descrição:** [Descrição]
+
+| Campo | Tipo | Obrigatório | Descrição | Validações |
+|---|---|---|---|---|
+| id | UUID | ✅ | | |
+| | | | | |
+
+---
+
+## 3. Value Objects
+
+### 3.1 [NomeVO]
+
+**Descrição:** [Objeto imutável que representa um conceito]
+
+| Campo | Tipo | Validação |
+|---|---|---|
+| valor | string | [Regra] |
+
+**Exemplo:** Email, CPF, Dinheiro, Endereço
+
+```typescript
+// Exemplo de uso
+class Email {
+  constructor(private readonly value: string) {
+    if (!this.isValid(value)) throw new Error('Email inválido');
+  }
+}
+```
+
+---
+
+## 4. Agregados
+
+### 4.1 Agregado: [Nome]
+
+**Raiz do Agregado:** [Entidade raiz]
+
+**Descrição:** [O que este agregado encapsula]
+
+```mermaid
+classDiagram
+    class RaizAgregado {
+        +id: UUID
+        +campo1: tipo
+        +adicionarFilho()
+        +removerFilho()
+    }
+    class EntidadeFilha {
+        +id: UUID
+        +campo: tipo
+    }
+    class ValueObject {
+        +valor: tipo
+    }
+    RaizAgregado "1" --> "*" EntidadeFilha
+    RaizAgregado --> ValueObject
+```
+
+**Regras do Agregado:**
+- Acesso às entidades filhas somente através da raiz
+- [Regra específica]
+
+---
+
+## 5. Relacionamentos
+
+### Diagrama ER
+
+```mermaid
+erDiagram
+    USUARIO ||--o{ PEDIDO : "faz"
+    PEDIDO ||--|{ ITEM_PEDIDO : "contém"
+    ITEM_PEDIDO }|--|| PRODUTO : "referencia"
+    USUARIO ||--o{ ENDERECO : "tem"
+```
+
+### Tabela de Relacionamentos
+
+| Origem | Destino | Cardinalidade | Descrição | Obrigatório |
+|---|---|---|---|---|
+| Usuario | Pedido | 1:N | Um usuário faz vários pedidos | Não |
+| Pedido | ItemPedido | 1:N | Um pedido tem vários itens | Sim (min 1) |
+| ItemPedido | Produto | N:1 | Item referencia um produto | Sim |
+
+---
+
+## 6. Eventos de Domínio
+
+| Evento | Trigger | Payload | Consumidores |
+|---|---|---|---|
+| UsuarioCriado | Após criar usuário | `{id, email, nome}` | EmailService, Analytics |
+| PedidoFinalizado | Após finalizar pedido | `{id, total, itens}` | Estoque, Financeiro |
+| | | | |
+
+### Exemplo de Evento
+
+```typescript
+interface PedidoFinalizadoEvent {
+  eventType: 'PedidoFinalizado';
+  occurredAt: Date;
+  payload: {
+    pedidoId: string;
+    usuarioId: string;
+    total: number;
+    itens: Array<{produtoId: string; quantidade: number}>;
+  };
+}
+```
+
+---
+
+## 7. Serviços de Domínio
+
+| Serviço | Responsabilidade | Entidades Envolvidas |
+|---|---|---|
+| CalculadoraPreco | Calcula preço com descontos | Pedido, Cupom, Produto |
+| ValidadorEstoque | Verifica disponibilidade | Produto, ItemPedido |
+
+---
+
+## 8. Repositórios
+
+| Repositório | Entidade | Métodos Principais |
+|---|---|---|
+| UsuarioRepository | Usuario | `findById`, `findByEmail`, `save` |
+| PedidoRepository | Pedido | `findById`, `findByUsuario`, `save` |
+
+---
+
+## 9. Dúvidas em Aberto
+
+- [ ] [Pergunta sobre o domínio para stakeholder]
+- [ ] [Outra dúvida]
+
+---
+
+## Glossário (Linguagem Ubíqua)
+
+| Termo | Definição no Domínio |
+|---|---|
+| [Termo] | [O que significa neste contexto] |
+| | |
+
+---
+
+## Changelog
+
+| Versão | Data | Autor | Mudanças |
+|---|---|---|---|
+| 1.0 | YYYY-MM-DD | [Nome] | Versão inicial |

package/content/templates/plano-testes.md

@@ -0,0 +1,199 @@
+# Plano de Testes: [Nome do Sistema]
+
+**Versão:** 1.0  
+**Data:** YYYY-MM-DD  
+**QA Responsável:** [Nome]  
+**Requisitos Relacionados:** [Link]
+
+---
+
+## 1. Escopo
+
+### 1.1 O que será testado
+- [Módulo/Funcionalidade 1]
+- [Módulo/Funcionalidade 2]
+- [Módulo/Funcionalidade 3]
+
+### 1.2 O que NÃO será testado
+- [Funcionalidades fora do escopo e porquê]
+
+### 1.3 Riscos de Qualidade
+| Risco | Probabilidade | Impacto | Mitigação |
+|---|---|---|---|
+| [Risco 1] | Alta/Média/Baixa | Alto/Médio/Baixo | [Ação] |
+
+---
+
+## 2. Estratégia de Testes
+
+### Pirâmide de Testes
+
+```
+         /\
+        /  \  E2E (10%)
+       /----\
+      /      \  Integração (20%)
+     /--------\
+    /          \  Unitários (70%)
+   /--------------\
+```
+
+### Tipos de Teste por Camada
+
+| Tipo | Ferramenta | Cobertura Alvo | Responsável |
+|---|---|---|---|
+| Unitários | Jest/Vitest | 80% | Devs |
+| Integração | Jest + Supertest | 60% | Devs |
+| E2E | Playwright/Cypress | Fluxos críticos | QA |
+| Performance | k6/Artillery | - | DevOps/QA |
+| Segurança | OWASP ZAP | - | Sec/QA |
+
+---
+
+## 3. Casos de Teste
+
+### 3.1 [Módulo/Funcionalidade 1]
+
+#### TC001 - [Nome do Caso de Teste] (RF001)
+| Campo | Valor |
+|---|---|
+| **Prioridade** | Alta/Média/Baixa |
+| **Tipo** | Funcional/Integração/E2E |
+| **Pré-condições** | [O que precisa estar configurado] |
+
+**Passos:**
+1. [Ação 1]
+2. [Ação 2]
+3. [Ação 3]
+
+**Resultado Esperado:**
+- [O que deve acontecer]
+
+**Dados de Teste:**
+| Input | Output Esperado |
+|---|---|
+| [Valor 1] | [Resultado 1] |
+| [Valor 2] | [Resultado 2] |
+
+---
+
+#### TC002 - [Caso de Erro] (RF001)
+| Campo | Valor |
+|---|---|
+| **Prioridade** | Alta |
+| **Tipo** | Funcional |
+| **Pré-condições** | [Condição de erro] |
+
+**Passos:**
+1. [Ação que causa erro]
+
+**Resultado Esperado:**
+- Mensagem de erro "[texto]"
+- Sistema mantém estado anterior
+
+---
+
+### 3.2 [Módulo/Funcionalidade 2]
+
+#### TC003 - [Nome do Caso]
+[Repetir estrutura]
+
+---
+
+## 4. Matriz de Rastreabilidade
+
+| Requisito | Casos de Teste | Status |
+|---|---|---|
+| RF001 | TC001, TC002 | ✅ Passando |
+| RF002 | TC003 | 🔄 Em desenvolvimento |
+| RF003 | TC004, TC005 | ⏳ Pendente |
+
+---
+
+## 5. Ambiente de Testes
+
+### 5.1 Configuração
+| Componente | Ambiente de Teste | Observações |
+|---|---|---|
+| API | staging.api.example.com | Reset diário |
+| Banco | PostgreSQL (container) | Seeds automáticos |
+| Redis | Container local | - |
+
+### 5.2 Dados de Teste
+- [ ] Seeds de dados configurados
+- [ ] Usuários de teste criados
+- [ ] Limpeza entre execuções
+
+---
+
+## 6. Critérios de Aceitação
+
+### 6.1 Critérios de Entrada
+- [ ] Código em branch de feature
+- [ ] Build passando
+- [ ] Code review aprovado
+
+### 6.2 Critérios de Saída
+- [ ] Todos os testes passando
+- [ ] Cobertura mínima atingida (80% unit, 60% integration)
+- [ ] Zero bugs críticos/bloqueadores
+- [ ] Bugs médios documentados
+
+---
+
+## 7. Métricas de Qualidade
+
+| Métrica | Alvo | Atual |
+|---|---|---|
+| Cobertura unitária | > 80% | - |
+| Cobertura integração | > 60% | - |
+| Taxa de bugs escapados | < 5% | - |
+| Tempo médio de fix | < 2 dias | - |
+
+---
+
+## 8. Cronograma
+
+| Fase | Data Início | Data Fim | Status |
+|---|---|---|---|
+| Testes unitários | | | ⏳ |
+| Testes integração | | | ⏳ |
+| Testes E2E | | | ⏳ |
+| Testes performance | | | ⏳ |
+| Regression final | | | ⏳ |
+
+---
+
+## 9. Relatório de Bugs
+
+Template para reportar bugs encontrados:
+
+```markdown
+## BUG-XXX: [Título]
+
+**Severidade:** Crítico/Alto/Médio/Baixo
+**Ambiente:** [Onde ocorreu]
+**Requisito:** [RF relacionado]
+
+### Passos para Reproduzir
+1. 
+2. 
+3. 
+
+### Resultado Atual
+[O que acontece]
+
+### Resultado Esperado
+[O que deveria acontecer]
+
+### Evidências
+[Screenshots, logs]
+```
+
+---
+
+## Changelog
+
+| Versão | Data | Autor | Mudanças |
+|---|---|---|---|
+| 1.0 | YYYY-MM-DD | [Nome] | Versão inicial |