@maestro-ai/cli 1.0.0

package/content/templates/README.md

@@ -0,0 +1,65 @@
+# Templates de Artefatos
+
+Esta pasta contém templates padronizados para cada entregável do Maestro.
+
+## Como Usar
+
+1. Copie o template para seu projeto
+2. Renomeie conforme necessário
+3. Preencha as seções
+4. Use a IA para ajudar no preenchimento
+
+## Índice de Templates
+
+### Fase 1: Produto
+| Template | Descrição |
+|---|---|
+| [PRD.md](./PRD.md) | Product Requirements Document |
+
+### Contexto (Todas as Fases)
+| Template | Descrição |
+|---|---|
+| [contexto.md](./contexto.md) | **NOVO** - Mantém contexto entre sessões |
+
+### Fase 2: Requisitos
+| Template | Descrição |
+|---|---|
+| [requisitos.md](./requisitos.md) | Lista de RF/RNF |
+| [criterios-aceite.md](./criterios-aceite.md) | Cenários Gherkin |
+
+### Fase 3: UX
+| Template | Descrição |
+|---|---|
+| [design-doc.md](./design-doc.md) | Documento de design |
+
+### Fase 4: Modelagem
+| Template | Descrição |
+|---|---|
+| [modelo-dominio.md](./modelo-dominio.md) | Entidades e relacionamentos |
+
+### Fase 5: Arquitetura
+| Template | Descrição |
+|---|---|
+| [arquitetura.md](./arquitetura.md) | Arquitetura C4 |
+| [adr.md](./adr.md) | Architecture Decision Record |
+
+### Fase 6: Segurança
+| Template | Descrição |
+|---|---|
+| [checklist-seguranca.md](./checklist-seguranca.md) | Checklist de segurança |
+
+### Fase 7: Testes
+| Template | Descrição |
+|---|---|
+| [plano-testes.md](./plano-testes.md) | Plano de testes |
+
+### Fase 8: Execução
+| Template | Descrição |
+|---|---|
+| [backlog.md](./backlog.md) | Backlog de histórias |
+| [historia-usuario.md](./historia-usuario.md) | Template de história |
+
+### Rastreabilidade
+| Template | Descrição |
+|---|---|
+| [matriz-rastreabilidade.md](./matriz-rastreabilidade.md) | RF → US → TC |

package/content/templates/adr.md

@@ -0,0 +1,103 @@
+# ADR-[NNN]: [Título da Decisão]
+
+**Status:** Proposto | Aceito | Deprecado | Substituído  
+**Data:** YYYY-MM-DD  
+**Decisores:** [Nomes]  
+**Consultas:** [Quem foi consultado]
+
+---
+
+## Contexto
+
+[Descreva a situação que motivou esta decisão. Qual problema estamos tentando resolver? Quais forças estão em jogo?]
+
+### Requisitos
+- [Requisito que influencia a decisão]
+- [Outro requisito]
+
+### Restrições
+- [Restrição técnica ou de negócio]
+- [Outra restrição]
+
+---
+
+## Decisão
+
+**Decidimos [usar/adotar/implementar] [escolha] porque [razão principal].**
+
+[Elabore a decisão em mais detalhes se necessário]
+
+---
+
+## Alternativas Consideradas
+
+### Opção 1: [Nome da Opção Escolhida] ✅
+**Descrição:** [O que é esta opção]
+
+**Prós:**
+- [Vantagem 1]
+- [Vantagem 2]
+
+**Contras:**
+- [Desvantagem 1]
+- [Desvantagem 2]
+
+### Opção 2: [Nome da Alternativa]
+**Descrição:** [O que é esta opção]
+
+**Prós:**
+- [Vantagem 1]
+
+**Contras:**
+- [Desvantagem 1]
+- [Por que não foi escolhida]
+
+### Opção 3: [Outra Alternativa]
+**Descrição:** [O que é esta opção]
+
+**Prós:**
+- [Vantagem 1]
+
+**Contras:**
+- [Desvantagem 1]
+- [Por que não foi escolhida]
+
+---
+
+## Consequências
+
+### Positivas
+- [Benefício que ganhamos com esta decisão]
+- [Outro benefício]
+
+### Negativas
+- [Trade-off que aceitamos]
+- [Limitação que introduz]
+
+### Riscos
+| Risco | Probabilidade | Impacto | Mitigação |
+|---|---|---|---|
+| [Risco] | Alta/Média/Baixa | Alto/Médio/Baixo | [Como mitigar] |
+
+---
+
+## Métricas de Sucesso
+
+Como saberemos se esta decisão foi boa?
+
+- [ ] [Métrica 1]: [Valor esperado]
+- [ ] [Métrica 2]: [Valor esperado]
+
+---
+
+## Links Relacionados
+
+- [Link para documentação relevante]
+- [Link para discussão]
+- [ADR relacionado]
+
+---
+
+## Notas
+
+[Qualquer informação adicional relevante]

package/content/templates/arquitetura.md

@@ -0,0 +1,279 @@
+# Arquitetura: [Nome do Sistema]
+
+**Versão:** 1.0  
+**Data:** YYYY-MM-DD  
+**Arquiteto:** [Nome]  
+**Requisitos Relacionados:** [Link]
+
+---
+
+## 1. Visão Geral
+
+### 1.1 Contexto
+[Descrição de alto nível do sistema e seu propósito]
+
+### 1.2 Decisões Arquiteturais Chave
+| Decisão | Escolha | Justificativa | ADR |
+|---|---|---|---|
+| Padrão arquitetural | [MVC/Hexagonal/DDD/etc] | [Por quê] | [Link] |
+| Banco de dados | [PostgreSQL/MongoDB/etc] | [Por quê] | [Link] |
+| Comunicação | [REST/GraphQL/gRPC] | [Por quê] | [Link] |
+
+---
+
+## 2. Diagrama C4
+
+### 2.1 Nível 1: Contexto
+
+```mermaid
+graph TB
+    subgraph boundary [Sistema]
+        SISTEMA[Sistema Principal]
+    end
+    
+    USUARIO[👤 Usuário]
+    ADMIN[👤 Administrador]
+    EMAIL[📧 Serviço de Email]
+    PAGAMENTO[💳 Gateway de Pagamento]
+    
+    USUARIO -->|Usa| SISTEMA
+    ADMIN -->|Gerencia| SISTEMA
+    SISTEMA -->|Envia emails| EMAIL
+    SISTEMA -->|Processa pagamentos| PAGAMENTO
+```
+
+**Atores:**
+| Ator | Descrição | Interação |
+|---|---|---|
+| Usuário | Usuário final do sistema | Web/Mobile |
+| Administrador | Gerencia configurações | Painel admin |
+
+**Sistemas Externos:**
+| Sistema | Descrição | Protocolo |
+|---|---|---|
+| Serviço de Email | SendGrid/SES | API REST |
+| Gateway de Pagamento | Stripe/PagSeguro | API REST + Webhooks |
+
+---
+
+### 2.2 Nível 2: Containers
+
+```mermaid
+graph TB
+    subgraph boundary [Sistema Principal]
+        WEB[🌐 Web App<br/>Next.js]
+        API[⚙️ API<br/>NestJS]
+        WORKER[⏰ Worker<br/>Bull/Agenda]
+        DB[(🗄️ PostgreSQL)]
+        CACHE[(⚡ Redis)]
+        STORAGE[📁 S3/Minio]
+    end
+    
+    USUARIO[👤 Usuário] -->|HTTPS| WEB
+    WEB -->|HTTPS/JSON| API
+    API --> DB
+    API --> CACHE
+    API --> STORAGE
+    API --> WORKER
+    WORKER --> DB
+```
+
+**Containers:**
+| Container | Tecnologia | Responsabilidade | Porta |
+|---|---|---|---|
+| Web App | Next.js | Interface do usuário | 3000 |
+| API | NestJS | Lógica de negócio | 4000 |
+| Worker | Bull | Jobs assíncronos | - |
+| PostgreSQL | PostgreSQL 15 | Persistência | 5432 |
+| Redis | Redis 7 | Cache + Filas | 6379 |
+
+---
+
+### 2.3 Nível 3: Componentes (API)
+
+```mermaid
+graph TB
+    subgraph API [API - NestJS]
+        subgraph Controllers
+            UC[UserController]
+            PC[PedidoController]
+        end
+        subgraph Services
+            US[UserService]
+            PS[PedidoService]
+            ES[EmailService]
+        end
+        subgraph Repositories
+            UR[UserRepository]
+            PR[PedidoRepository]
+        end
+    end
+    
+    UC --> US
+    PC --> PS
+    US --> UR
+    PS --> PR
+    PS --> ES
+```
+
+**Componentes:**
+| Componente | Responsabilidade | Dependências |
+|---|---|---|
+| UserController | Endpoints de usuário | UserService |
+| UserService | Lógica de usuário | UserRepository |
+| UserRepository | Acesso a dados | Database |
+
+---
+
+## 3. Stack Tecnológica
+
+### 3.1 Backend
+| Camada | Tecnologia | Versão | Justificativa |
+|---|---|---|---|
+| Runtime | Node.js | 20 LTS | Ecosistema, performance |
+| Framework | NestJS | 10.x | Estrutura, TypeScript nativo |
+| ORM | Prisma | 5.x | Type-safety, migrations |
+| Validação | class-validator | - | Decorators, integração NestJS |
+
+### 3.2 Frontend
+| Camada | Tecnologia | Versão | Justificativa |
+|---|---|---|---|
+| Framework | Next.js | 14 | SSR, App Router |
+| UI | Tailwind + shadcn/ui | - | Produtividade, customização |
+| Estado | Zustand | - | Simplicidade |
+| Fetch | TanStack Query | - | Cache, invalidation |
+
+### 3.3 Infraestrutura
+| Componente | Tecnologia | Ambiente |
+|---|---|---|
+| Hospedagem | AWS / Railway | Produção |
+| CI/CD | GitHub Actions | - |
+| Containers | Docker | Todos |
+| Orquestração | Docker Compose / K8s | Dev / Prod |
+
+---
+
+## 4. Padrões e Convenções
+
+### 4.1 Estrutura de Pastas (Backend)
+```
+src/
+├── modules/
+│   └── [modulo]/
+│       ├── controllers/
+│       ├── services/
+│       ├── repositories/
+│       ├── entities/
+│       ├── dtos/
+│       └── [modulo].module.ts
+├── common/
+│   ├── decorators/
+│   ├── filters/
+│   ├── guards/
+│   └── interceptors/
+├── config/
+└── main.ts
+```
+
+### 4.2 Convenções de Código
+- **Nomenclatura**: camelCase para variáveis, PascalCase para classes
+- **Commits**: Conventional Commits (feat:, fix:, chore:)
+- **Branch**: feature/, fix/, hotfix/
+
+---
+
+## 5. Segurança
+
+### 5.1 Autenticação
+- **Método**: JWT + Refresh Token
+- **Expiração**: Access 15min, Refresh 7 dias
+- **Armazenamento**: HttpOnly Cookies
+
+### 5.2 Autorização
+- **Modelo**: RBAC (Role-Based Access Control)
+- **Roles**: Admin, User, Guest
+
+### 5.3 Proteções
+- [ ] Rate limiting
+- [ ] CORS configurado
+- [ ] Helmet (headers de segurança)
+- [ ] Validação de input
+- [ ] SQL Injection prevention (ORM)
+- [ ] HTTPS obrigatório
+
+---
+
+## 6. Escalabilidade
+
+### 6.1 Pontos de Escala
+| Componente | Estratégia | Trigger |
+|---|---|---|
+| API | Horizontal (réplicas) | CPU > 70% |
+| Worker | Horizontal | Queue size > 1000 |
+| Database | Read replicas | Queries > X/s |
+
+### 6.2 Caching
+| Camada | Tecnologia | TTL | Invalidação |
+|---|---|---|---|
+| HTTP | CDN | 1h | Deploy |
+| API | Redis | 5min | Mutation |
+| Query | Redis | 1min | TTL |
+
+---
+
+## 7. Observabilidade
+
+### 7.1 Logging
+- **Formato**: JSON estruturado
+- **Níveis**: error, warn, info, debug
+- **Destino**: CloudWatch / Loki
+
+### 7.2 Métricas
+- **Ferramenta**: Prometheus + Grafana
+- **Métricas-chave**:
+  - Request rate
+  - Latência (p50, p95, p99)
+  - Error rate
+  - CPU/Memory
+
+### 7.3 Tracing
+- **Ferramenta**: OpenTelemetry + Jaeger
+- **Spans**: HTTP, Database, External calls
+
+### 7.4 Alertas
+| Alerta | Condição | Severidade |
+|---|---|---|
+| API Down | Uptime < 99% em 5min | Critical |
+| Latência Alta | p95 > 2s | Warning |
+| Erros 5xx | Rate > 1% | Critical |
+
+---
+
+## 8. Disaster Recovery
+
+### 8.1 Backup
+| Componente | Frequência | Retenção | Localização |
+|---|---|---|---|
+| Database | Diário | 30 dias | S3 |
+| Files | Contínuo | 90 dias | S3 |
+
+### 8.2 RTO/RPO
+- **RTO** (Recovery Time Objective): < 1 hora
+- **RPO** (Recovery Point Objective): < 1 hora
+
+---
+
+## 9. ADRs Relacionados
+
+| ID | Título | Status |
+|---|---|---|
+| ADR-001 | [Escolha do banco de dados](./adr/001-banco-dados.md) | Aceito |
+| ADR-002 | [Padrão de autenticação](./adr/002-autenticacao.md) | Aceito |
+
+---
+
+## Changelog
+
+| Versão | Data | Autor | Mudanças |
+|---|---|---|---|
+| 1.0 | YYYY-MM-DD | [Nome] | Versão inicial |

package/content/templates/backlog.md

@@ -0,0 +1,185 @@
+# Backlog: [Nome do Sistema]
+
+**Versão:** 1.0  
+**Data:** YYYY-MM-DD  
+**Product Owner:** [Nome]  
+**PRD Relacionado:** [Link]
+
+---
+
+## Épicos
+
+| ID | Épico | Descrição | Prioridade | Sprint Alvo |
+|---|---|---|---|---|
+| E001 | [Nome do Épico] | [Descrição breve] | P0 | 1-2 |
+| E002 | [Nome do Épico] | [Descrição breve] | P1 | 3-4 |
+| E003 | [Nome do Épico] | [Descrição breve] | P2 | Backlog |
+
+---
+
+## Histórias de Usuário
+
+### Épico: E001 - [Nome do Épico]
+
+#### US001 - [Título da História]
+
+**Como** [persona],  
+**Quero** [ação/funcionalidade],  
+**Para** [benefício/valor].
+
+| Campo | Valor |
+|---|---|
+| **Épico** | E001 |
+| **Prioridade** | P0 |
+| **Pontos** | 3 |
+| **Sprint** | 1 |
+| **Requisitos** | RF001, RF002 |
+
+**Critérios de Aceite:**
+- [ ] CA1: [Critério verificável]
+- [ ] CA2: [Critério verificável]
+- [ ] CA3: [Critério verificável]
+
+**Definição de Pronto:**
+- [ ] Código implementado
+- [ ] Testes unitários (cobertura > 80%)
+- [ ] Code review aprovado
+- [ ] Documentação atualizada
+- [ ] Deploy em staging
+
+**Notas técnicas:**
+- [Consideração técnica relevante]
+
+---
+
+#### US002 - [Título da História]
+
+**Como** [persona],  
+**Quero** [ação],  
+**Para** [benefício].
+
+| Campo | Valor |
+|---|---|
+| **Épico** | E001 |
+| **Prioridade** | P0 |
+| **Pontos** | 5 |
+| **Sprint** | 1 |
+| **Requisitos** | RF003 |
+| **Dependências** | US001 |
+
+**Critérios de Aceite:**
+- [ ] CA1:
+- [ ] CA2:
+
+---
+
+### Épico: E002 - [Nome do Épico]
+
+#### US003 - [Título]
+
+[Repetir estrutura]
+
+---
+
+## Sprint Planning
+
+### Sprint 1 (Semana X-Y)
+
+**Objetivo:** [Objetivo da sprint em uma frase]
+
+**Capacidade:** X pontos
+
+| ID | História | Pontos | Responsável | Status |
+|---|---|---|---|---|
+| US001 | [Título] | 3 | [Nome] | ⏳ To Do |
+| US002 | [Título] | 5 | [Nome] | ⏳ To Do |
+| **Total** | | **8** | | |
+
+### Sprint 2 (Semana X-Y)
+
+**Objetivo:** [Objetivo]
+
+| ID | História | Pontos | Responsável | Status |
+|---|---|---|---|---|
+| US003 | [Título] | 3 | | ⏳ |
+| US004 | [Título] | 5 | | ⏳ |
+
+---
+
+## Bugs e Débito Técnico
+
+| ID | Tipo | Título | Prioridade | Sprint |
+|---|---|---|---|---|
+| BUG001 | Bug | [Descrição] | Alta | 1 |
+| TECH001 | Tech Debt | [Descrição] | Média | Backlog |
+
+---
+
+## Métricas de Velocidade
+
+| Sprint | Planejado | Entregue | Velocidade |
+|---|---|---|---|
+| 1 | X pts | - | - |
+| 2 | X pts | - | - |
+| Média | | | - |
+
+---
+
+## Definição de Pronto (DoD) Global
+
+Toda história deve atender:
+
+- [ ] Código implementado e funcionando
+- [ ] Testes unitários com cobertura > 80%
+- [ ] Testes de integração para fluxos críticos
+- [ ] Code review aprovado por 1+ devs
+- [ ] Build passando no CI
+- [ ] Sem vulnerabilidades de segurança críticas
+- [ ] Documentação técnica atualizada
+- [ ] Deploy bem-sucedido em staging
+- [ ] Aceite do PO
+
+---
+
+## Diagrama de Dependências
+
+### Visão Geral
+
+```mermaid
+flowchart TD
+    subgraph E001["🔹 Épico: [Nome do Épico 1]"]
+        US001[US001: Título]
+        US002[US002: Título]
+        US001 --> US002
+    end
+    
+    subgraph E002["🔹 Épico: [Nome do Épico 2]"]
+        US003[US003: Título]
+        US004[US004: Título]
+        US003 --> US004
+    end
+    
+    US002 --> US003
+```
+
+### Tabela de Dependências
+
+| História | Depende de | Bloqueia | Prioridade |
+|----------|------------|----------|------------|
+| US001 | - | US002 | Alta |
+| US002 | US001 | US003 | Alta |
+| US003 | US002 | US004 | Média |
+
+### Legenda
+- ⬜ Pendente
+- 🔄 Em andamento
+- ✅ Concluído
+- ⏸️ Bloqueado
+
+---
+
+## Changelog
+
+| Versão | Data | Autor | Mudanças |
+|---|---|---|---|
+| 1.0 | YYYY-MM-DD | [Nome] | Versão inicial |