@maestro-ai/cli 1.0.0

package/content/templates/design-doc.md

@@ -0,0 +1,240 @@
+# Design Doc: [Nome do Sistema]
+
+**Versão:** 1.0  
+**Data:** YYYY-MM-DD  
+**Designer:** [Nome]  
+**PRD Relacionado:** [Link]
+
+---
+
+## 1. Visão Geral de UX
+
+### 1.1 Objetivo do Design
+[O que este design visa alcançar em termos de experiência do usuário]
+
+### 1.2 Princípios de Design
+1. **[Princípio 1]**: [Descrição]
+2. **[Princípio 2]**: [Descrição]
+3. **[Princípio 3]**: [Descrição]
+
+---
+
+## 2. Personas e Jornadas
+
+### Persona Principal: [Nome]
+**Objetivo:** [O que quer alcançar]
+
+#### Jornada do Usuário
+```mermaid
+journey
+    title Jornada: [Nome da Jornada]
+    section Descoberta
+      Encontra o produto: 3: Usuário
+      Lê landing page: 4: Usuário
+    section Onboarding
+      Cria conta: 3: Usuário
+      Completa perfil: 4: Usuário
+    section Uso
+      Realiza ação principal: 5: Usuário
+      Obtém resultado: 5: Usuário
+```
+
+---
+
+## 3. Arquitetura de Informação
+
+### 3.1 Mapa do Site
+```
+├── Home
+├── Dashboard
+│   ├── Visão Geral
+│   └── Relatórios
+├── [Módulo 1]
+│   ├── Lista
+│   ├── Detalhes
+│   └── Criar/Editar
+├── Configurações
+│   ├── Perfil
+│   └── Preferências
+└── Ajuda
+```
+
+### 3.2 Navegação Principal
+| Item | Destino | Ícone | Prioridade |
+|---|---|---|---|
+| Dashboard | /dashboard | 📊 | 1 |
+| [Módulo 1] | /modulo1 | 📁 | 2 |
+| Configurações | /settings | ⚙️ | 3 |
+
+---
+
+## 5. Mapa de Navegação
+
+### 5.1 Diagrama de Navegação
+
+```mermaid
+flowchart LR
+    subgraph Public["🌐 Área Pública"]
+        HOME[Home]
+        LOGIN[Login]
+    end
+    
+    subgraph Auth["🔐 Área Autenticada"]
+        DASH[Dashboard]
+        MODULE[Módulo Principal]
+    end
+    
+    HOME --> LOGIN
+    LOGIN --> DASH
+    DASH --> MODULE
+```
+
+### 5.2 Inventário de Telas
+
+| ID | Tela | URL | Acesso | RFs |
+|----|------|-----|--------|-----|
+| T01 | Home | `/` | Público | - |
+| T02 | Login | `/login` | Público | RF-001 |
+| T03 | Dashboard | `/dashboard` | Auth | RF-002 |
+
+> Para detalhamento completo, veja o [Mapa de Navegação](./mapa-navegacao.md) usando o [template](../06-templates/mapa-navegacao.md).
+
+---
+
+## 6. Fluxos de Usuário
+
+### 4.1 Fluxo: [Nome do Fluxo Principal]
+
+```mermaid
+flowchart TD
+    A[Início] --> B{Usuário logado?}
+    B -->|Não| C[Tela de Login]
+    C --> D[Autentica]
+    D --> B
+    B -->|Sim| E[Dashboard]
+    E --> F[Seleciona ação]
+    F --> G[Executa]
+    G --> H{Sucesso?}
+    H -->|Sim| I[Exibe confirmação]
+    H -->|Não| J[Exibe erro]
+    J --> F
+    I --> E
+```
+
+### 4.2 Fluxo: [Outro Fluxo Importante]
+
+[Adicionar diagrama]
+
+---
+
+## 5. Wireframes
+
+### 5.1 Tela: [Nome da Tela]
+
+**Objetivo:** [Para que serve esta tela]
+
+**Elementos:**
+- Header com logo e navegação
+- [Elemento 1]
+- [Elemento 2]
+- [Elemento 3]
+
+**Estados:**
+- Empty state: [Descrição]
+- Loading state: [Descrição]
+- Error state: [Descrição]
+
+**Link do wireframe:** [Figma/Whimsical/etc]
+
+### 5.2 Tela: [Outra Tela]
+
+[Repetir estrutura]
+
+---
+
+## 6. Design System / UI
+
+### 6.1 Cores
+| Nome | Hex | Uso |
+|---|---|---|
+| Primary | #XXXXXX | Botões principais, links |
+| Secondary | #XXXXXX | Elementos secundários |
+| Success | #XXXXXX | Confirmações |
+| Error | #XXXXXX | Erros |
+| Background | #XXXXXX | Fundo |
+
+### 6.2 Tipografia
+| Uso | Fonte | Tamanho | Peso |
+|---|---|---|---|
+| H1 | [Fonte] | Xpx | Bold |
+| H2 | [Fonte] | Xpx | Bold |
+| Body | [Fonte] | Xpx | Regular |
+| Caption | [Fonte] | Xpx | Regular |
+
+### 6.3 Componentes
+- Botões: [Descrição ou link]
+- Inputs: [Descrição ou link]
+- Cards: [Descrição ou link]
+- Modais: [Descrição ou link]
+
+### 6.4 Database Design System (Se aplicável)
+
+> Se este design foi gerado com database `content/design-system/`, preencher:
+
+**Database Usado:** ✅ Sim / ❌ Não
+
+**Database Query:** `[keywords usados para busca]`  
+**Exemplo:** `saas productivity modern clean`
+
+**Pattern Recomendado:** [Product-Centric / Hero-Centric / Service-Centric / ...]
+
+**Style Visual:** [Minimalism / Modern Professional / Glassmorphism / ...]
+
+**Referências no Database:**
+- Paleta de Cores: `colors.csv` linha [#]
+- Par de Fontes: `typography.csv` linha [STT]
+- Estilo UI: `styles.csv` linha [STT]
+
+**Ajustes Manuais:**
+- [Listar ajustes feitos em relação à sugestão original do database]
+- Exemplo: "Mudei CTA de #F97316 para #EA580C (tom mais escuro)"
+- Exemplo: "Purple Ban: substituí #7C3AED por #3B82F6"
+
+---
+
+## 7. Acessibilidade
+
+### 7.1 Requisitos WCAG AA
+- [ ] Contraste mínimo 4.5:1 para texto
+- [ ] Navegação por teclado funcional
+- [ ] Labels em todos os inputs
+- [ ] Alt text em imagens
+- [ ] Hierarquia de headings correta
+
+### 7.2 Tecnologias Assistivas
+- Testado com: [NVDA, VoiceOver, etc]
+
+---
+
+## 8. Responsividade
+
+### Breakpoints
+| Dispositivo | Largura | Adaptações |
+|---|---|---|
+| Mobile | < 768px | [Mudanças] |
+| Tablet | 768-1024px | [Mudanças] |
+| Desktop | > 1024px | Layout completo |
+
+---
+
+## 9. Protótipo
+
+**Link do protótipo interativo:** [URL Figma/Prototype]
+
+---
+
+## Changelog
+
+| Versão | Data | Autor | Mudanças |
+|---|---|---|---|
+| 1.0 | YYYY-MM-DD | [Nome] | Versão inicial |

package/content/templates/feature.md

@@ -0,0 +1,88 @@
+# Template: Feature
+
+## [FEAT-XXX]: [Nome da Feature]
+
+### Visão Geral
+[Descrição breve da feature em 2-3 linhas]
+
+### Requisitos Relacionados
+- [RF-XXX](../../02-requisitos/requisitos.md#RF-XXX)
+
+### Épico Pai
+← [EPIC-XXX: Nome do Épico](../epicos/EPIC-XXX.md)
+
+---
+
+## Histórias Derivadas
+
+### Fase 1: Contrato
+| ID | Título | Status | Dependências |
+|----|--------|--------|--------------|
+| CONT-XXX | Contrato da API | ⬜ | - |
+
+### Fase 2: Frontend
+| ID | Título | Status | Dependências |
+|----|--------|--------|--------------|
+| US-XXX-FE | [Nome da história frontend] | ⬜ | CONT-XXX |
+
+### Fase 3: Backend
+| ID | Título | Status | Dependências |
+|----|--------|--------|--------------|
+| US-XXX-BE | [Nome da história backend] | ⬜ | CONT-XXX |
+
+### Fase 4: Integração
+| ID | Título | Status | Dependências |
+|----|--------|--------|--------------|
+| INT-XXX | Integrar Frontend + Backend | ⬜ | US-XXX-FE, US-XXX-BE |
+
+---
+
+## Ordem de Execução
+```
+1. CONT-XXX (Contrato)
+       │
+   ┌───┴───┐
+   ▼       ▼
+2. US-XXX-FE   3. US-XXX-BE  (paralelo)
+   │               │
+   └───────┬───────┘
+           ▼
+      4. INT-XXX (Integração)
+```
+
+---
+
+## Legenda de Status
+- ⬜ Pendente
+- 🔄 Em andamento
+- ✅ Concluído
+- ⏸️ Bloqueado
+
+---
+
+## Telas Afetadas
+
+### Mapa de Impacto
+
+```mermaid
+flowchart LR
+    FEAT[FEAT-XXX] --> T1[Tela 1]
+    FEAT --> T2[Tela 2]
+    FEAT --> T3[Tela 3 - Nova]
+    T1 --> C1[Componente A]
+    T2 --> C2[Componente B]
+```
+
+### Tabela de Impacto
+
+| Tela | Ação | Detalhes | Componentes |
+|------|------|----------|-------------|
+| [Nome Tela 1] | Modifica | [O que muda] | [Componentes afetados] |
+| [Nome Tela 2] | Nova | [Descrição] | [Novos componentes] |
+| [Nome Tela 3] | Remove | [Justificativa] | - |
+
+### Legenda de Ações
+- **Nova**: Tela criada por esta feature
+- **Modifica**: Tela existente que será alterada
+- **Remove**: Tela que será descontinuada
+

package/content/templates/historia-backend.md

@@ -0,0 +1,84 @@
+# Template: História Backend
+
+## [US-XXX-BE]: [Título da História]
+
+### Tipo: `backend`
+
+### Feature Pai
+← [FEAT-XXX: Nome da Feature](../features/FEAT-XXX.md)
+
+### Dependências
+| ID | Tipo | Status | Obrigatório |
+|----|------|--------|-------------|
+| CONT-XXX | Contrato | ⬜ | ✅ Sim |
+
+### Histórias Relacionadas
+| ID | Tipo | Relação |
+|----|------|---------|
+| US-XXX-FE | Frontend | Correspondente |
+| INT-XXX | Integração | Depende desta |
+
+---
+
+## Descrição
+Como **[sistema/API]**, 
+devo **[implementar endpoint/lógica]**,
+para **[suportar funcionalidade frontend]**.
+
+## Critérios de Aceite
+- [ ] Endpoint responde conforme contrato
+- [ ] Validações implementadas
+- [ ] Erros tratados corretamente
+- [ ] Testes unitários (> 80% coverage)
+- [ ] Testes de integração
+
+---
+
+## Contrato a Implementar
+
+```yaml
+# Endpoint
+[MÉTODO] /[path]
+
+Request:
+  - campo1: tipo (validação)
+  - campo2: tipo (validação)
+
+Response 200:
+  - campo1: tipo
+  - campo2: tipo
+
+Response 400:
+  - error: string
+  - details: object
+
+Response 500:
+  - error: string
+```
+
+> Referência: [CONT-XXX](../contratos/CONT-XXX.yaml)
+
+---
+
+## Blocos de Implementação
+
+| # | Bloco | Nome | Descrição |
+|---|-------|------|-----------|
+| 1 | DTO | [CreateXxxDto] | Tipos entrada/saída |
+| 2 | Entity | [Xxx] | Modelo de dados |
+| 3 | Repository | [XxxRepository] | Camada de dados |
+| 4 | Service | [XxxService] | Regra de negócio |
+| 5 | Controller | [XxxController] | Endpoint |
+| 6 | Teste | [XxxService.spec] | Cobertura |
+
+---
+
+## Regras de Negócio
+1. [Regra 1]
+2. [Regra 2]
+3. [Regra 3]
+
+---
+
+## Notas Técnicas
+[Observações relevantes para implementação]

package/content/templates/historia-frontend.md

@@ -0,0 +1,75 @@
+# Template: História Frontend
+
+## [US-XXX-FE]: [Título da História]
+
+### Tipo: `frontend`
+
+### Feature Pai
+← [FEAT-XXX: Nome da Feature](../features/FEAT-XXX.md)
+
+### Dependências
+| ID | Tipo | Status | Obrigatório |
+|----|------|--------|-------------|
+| CONT-XXX | Contrato | ⬜ | ✅ Sim |
+
+### Histórias Relacionadas
+| ID | Tipo | Relação |
+|----|------|---------|
+| US-XXX-BE | Backend | Correspondente |
+| INT-XXX | Integração | Depende desta |
+
+---
+
+## Descrição
+Como **[persona]**, 
+quero **[ação no frontend]**,
+para **[benefício/valor]**.
+
+## Critérios de Aceite
+- [ ] [Critério 1]
+- [ ] [Critério 2]
+- [ ] [Critério 3]
+- [ ] Responsivo (mobile-first)
+- [ ] Acessível (WCAG AA)
+
+---
+
+## Contrato a Seguir
+
+```yaml
+# Endpoint principal
+[MÉTODO] /[path]
+
+Request:
+  - campo1: tipo
+  - campo2: tipo
+
+Response:
+  - campo1: tipo
+  - campo2: tipo
+```
+
+> Referência: [CONT-XXX](../contratos/CONT-XXX.yaml)
+
+---
+
+## Blocos de Implementação
+
+| # | Bloco | Nome | Descrição |
+|---|-------|------|-----------|
+| 1 | Component | [NomeComponent] | [O que faz] |
+| 2 | Hook/Store | [useNome] | [Estado e chamadas] |
+| 3 | Page | [/path] | [Composição] |
+| 4 | Teste | [NomeComponent.test] | [Cobertura] |
+
+---
+
+## Referências de Design
+- Wireframe: [link ou caminho]
+- Figma/Design: [link ou caminho]
+- Componentes base: [lista]
+
+---
+
+## Notas Técnicas
+[Observações relevantes para implementação]

package/content/templates/historia-usuario.md

@@ -0,0 +1,125 @@
+# História de Usuário: US[NNN]
+
+---
+
+## Descrição
+
+**Como** [persona/tipo de usuário],  
+**Quero** [ação ou funcionalidade desejada],  
+**Para** [benefício ou valor obtido].
+
+---
+
+## Metadados
+
+| Campo | Valor |
+|---|---|
+| **ID** | US[NNN] |
+| **Épico** | E[NNN] - [Nome] |
+| **Prioridade** | P0 (Must) / P1 (Should) / P2 (Could) |
+| **Pontos** | [Estimativa] |
+| **Sprint** | [Número] |
+| **Requisitos** | RF[NNN], RF[NNN] |
+| **Responsável** | [Nome] |
+| **Status** | To Do / In Progress / Review / Done |
+
+---
+
+## Critérios de Aceite
+
+### Cenário 1: [Happy Path]
+```gherkin
+Dado que [contexto/pré-condição]
+  E [outra condição se necessário]
+Quando [ação do usuário]
+Então [resultado esperado]
+  E [outro resultado se necessário]
+```
+
+### Cenário 2: [Caso de Erro]
+```gherkin
+Dado que [contexto]
+  E [condição que causa erro]
+Quando [ação do usuário]
+Então [comportamento de erro esperado]
+  E [mensagem exibida]
+```
+
+### Cenário 3: [Edge Case]
+```gherkin
+Dado que [condição de borda]
+Quando [ação]
+Então [comportamento esperado]
+```
+
+---
+
+## Regras de Negócio
+
+- **RN1**: [Regra que se aplica a esta história]
+- **RN2**: [Outra regra]
+
+---
+
+## Design / Wireframes
+
+- Link para Figma: [URL]
+- Telas afetadas: [Lista]
+
+---
+
+## Notas Técnicas
+
+### Impacto no Modelo
+- [ ] Nova entidade: [Nome]
+- [ ] Alteração em: [Nome]
+- [ ] Novo campo: [tabela.campo]
+
+### Endpoints Afetados
+| Método | Rota | Descrição |
+|---|---|---|
+| POST | /api/[recurso] | Criar [recurso] |
+| GET | /api/[recurso]/:id | Buscar [recurso] |
+
+### Dependências
+- US[NNN] deve estar pronta antes
+- Integração com [sistema externo] necessária
+
+### Riscos Técnicos
+- [Risco identificado e como mitigar]
+
+---
+
+## Subtarefas
+
+- [ ] Criar migration para novo campo
+- [ ] Implementar service
+- [ ] Implementar controller/endpoint
+- [ ] Testes unitários
+- [ ] Testes de integração
+- [ ] Atualizar documentação da API
+- [ ] Code review
+- [ ] Deploy em staging
+- [ ] Teste de aceite com PO
+
+---
+
+## Definição de Pronto (DoD)
+
+- [ ] Todos os critérios de aceite validados
+- [ ] Testes unitários (cobertura > 80%)
+- [ ] Testes de integração para fluxos principais
+- [ ] Code review aprovado
+- [ ] Build verde no CI
+- [ ] Deploy em staging bem-sucedido
+- [ ] Documentação atualizada
+- [ ] Aceite do PO
+
+---
+
+## Histórico
+
+| Data | Autor | Mudança |
+|---|---|---|
+| YYYY-MM-DD | [Nome] | Criação |
+| YYYY-MM-DD | [Nome] | [Alteração] |