@maestro-ai/cli 1.0.0

package/content/templates/prototipo-stitch.md

@@ -0,0 +1,138 @@
+# Template: Registro de Protótipos Stitch
+
+## Metadados
+| Campo | Valor |
+|-------|-------|
+| Projeto | [NOME DO PROJETO] |
+| Data | [DATA] |
+| Responsável | [NOME] |
+| Status | 🔄 Em progresso / ✅ Validado / ❌ Descartado |
+
+---
+
+## Protótipos Criados
+
+### Tela 1: [Nome da Tela]
+
+**Prompt Usado:**
+```
+[Cole o prompt que usou no Stitch]
+```
+
+**Resultado:**
+- [ ] Gerado com sucesso
+- [ ] Aprovado por stakeholders
+- [ ] Código exportado
+
+**Iterações:**
+| Versão | Mudança | Resultado |
+|--------|---------|-----------|
+| v1 | Prompt inicial | [OK/Ajustar] |
+| v2 | [Ajuste feito] | [OK/Ajustar] |
+
+**Código Exportado:** `docs/03-ux/stitch-output/tela-1.html`
+
+**Observações:**
+- [Notas sobre o que funcionou/não funcionou]
+- [Decisões tomadas]
+
+---
+
+### Tela 2: [Nome da Tela]
+
+**Prompt Usado:**
+```
+[Cole o prompt que usou no Stitch]
+```
+
+**Resultado:**
+- [ ] Gerado com sucesso
+- [ ] Aprovado por stakeholders
+- [ ] Código exportado
+
+**Código Exportado:** `docs/03-ux/stitch-output/tela-2.html`
+
+**Observações:**
+- [Notas]
+
+---
+
+## Componentes Identificados
+
+Após análise dos protótipos, os seguintes componentes reutilizáveis foram identificados:
+
+| Componente | Aparece Em | Prioridade |
+|------------|------------|------------|
+| Navbar | Todas as telas | Alta |
+| Card | Dashboard, Listagem | Alta |
+| Button | Todas as telas | Alta |
+| Form Input | Cadastro, Edição | Alta |
+| [Outros] | [Telas] | [Alta/Média/Baixa] |
+
+---
+
+## Mapeamento UI → Domínio
+
+| Elemento de UI | Entidade/Campo | Requisito |
+|----------------|----------------|-----------|
+| Campo "Nome" | Cliente.nome | RF001 |
+| Card de agendamento | Agendamento | RF003 |
+| [Outros] | [Entidade.campo] | [RFxxx] |
+
+---
+
+## Decisões de Design
+
+### Tema Visual
+- **Modo:** Light / Dark
+- **Cor primária:** #[HEX]
+- **Cor secundária:** #[HEX]
+- **Fonte:** [Nome da fonte]
+
+### Padrões de UI
+- Cards com sombra sutil e bordas arredondadas
+- Botões com hover state
+- [Outros padrões observados]
+
+---
+
+## Próximos Passos
+
+- [ ] Exportar todos os códigos para `docs/03-ux/stitch-output/`
+- [ ] Exportar assets para `docs/03-ux/stitch-output/assets/`
+- [ ] Analisar código com IA para extrair componentes
+- [ ] Atualizar CONTEXTO.md com decisões visuais
+- [ ] Prosseguir para Modelagem de Domínio
+
+---
+
+## Arquivos Relacionados
+
+- Design Doc (base para prompts): `docs/03-ux/design-doc.md`
+- Prompts usados: `docs/03-ux/stitch-prompts.md`
+- Código exportado: `docs/03-ux/stitch-output/`
+
+---
+
+## 🔗 Integração com Frontend
+
+### Para Desenvolvimento Frontend
+
+Os arquivos exportados serão usados na fase de Frontend:
+
+| Arquivo | Destino Sugerido | Tipo |
+|---------|------------------|------|
+| `*.html` | `src/components/` | Referência estrutural |
+| `assets/*.png` | `public/images/` | Assets estáticos |
+| `assets/*.svg` | `src/assets/icons/` | Ícones vetoriais |
+
+### Instruções para o Desenvolvedor Frontend
+
+Na fase de Frontend, a IA deve:
+
+1. **Verificar** se existe `docs/03-ux/stitch-output/`
+2. **Ler todos os HTML** exportados
+3. **Extrair componentes** identificados neste documento
+4. **Copiar assets** para a estrutura correta do projeto
+5. **Adaptar markup** para a stack definida (React, Vue, etc.)
+

package/content/templates/requisitos.md

@@ -0,0 +1,162 @@
+# Requisitos: [Nome do Sistema]
+
+**Versão:** 1.0  
+**Data:** YYYY-MM-DD  
+**Autor:** [Nome]  
+**PRD Relacionado:** [Link para PRD]
+
+---
+
+## 1. Visão Geral
+
+[Resumo de 2-3 linhas do sistema baseado no PRD]
+
+---
+
+## 2. Requisitos Funcionais
+
+### RF001 - [Título do Requisito]
+| Campo | Valor |
+|---|---|
+| **Descrição** | O sistema deve [ação específica] |
+| **Prioridade** | P0/P1/P2 |
+| **Persona** | [Qual persona usa] |
+| **Critérios de Aceite** | Ver CA001 |
+| **Dependências** | RF002, RF003 |
+
+### RF002 - [Título do Requisito]
+| Campo | Valor |
+|---|---|
+| **Descrição** | O sistema deve [ação específica] |
+| **Prioridade** | P0/P1/P2 |
+| **Persona** | |
+| **Critérios de Aceite** | Ver CA002 |
+| **Dependências** | |
+
+### RF003 - [Título do Requisito]
+| Campo | Valor |
+|---|---|
+| **Descrição** | O sistema deve [ação específica] |
+| **Prioridade** | |
+| **Persona** | |
+| **Critérios de Aceite** | |
+| **Dependências** | |
+
+[Adicione mais RFs conforme necessário]
+
+---
+
+## 3. Requisitos Não-Funcionais
+
+### RNF001 - Performance
+| Campo | Valor |
+|---|---|
+| **Descrição** | O sistema deve responder em menos de [X]ms para [Y]% das requisições |
+| **Métrica** | Latência p95 < Xms |
+| **Como medir** | APM, logs, load test |
+
+### RNF002 - Disponibilidade
+| Campo | Valor |
+|---|---|
+| **Descrição** | O sistema deve estar disponível [X]% do tempo |
+| **Métrica** | Uptime >= X% |
+| **Como medir** | Monitoramento, alertas |
+
+### RNF003 - Segurança
+| Campo | Valor |
+|---|---|
+| **Descrição** | [Requisito de segurança] |
+| **Métrica** | |
+| **Como medir** | |
+
+### RNF004 - Escalabilidade
+| Campo | Valor |
+|---|---|
+| **Descrição** | O sistema deve suportar [X] usuários simultâneos |
+| **Métrica** | |
+| **Como medir** | Load test |
+
+### RNF005 - Usabilidade
+| Campo | Valor |
+|---|---|
+| **Descrição** | [Requisito de UX] |
+| **Métrica** | |
+| **Como medir** | |
+
+---
+
+## 4. Regras de Negócio
+
+### RN001 - [Título]
+**Descrição:** [Regra específica que o sistema deve seguir]
+
+**Exemplo:**
+- Se [condição], então [ação]
+- Caso [situação], [comportamento esperado]
+
+### RN002 - [Título]
+**Descrição:** [Regra]
+
+---
+
+## 5. Integrações
+
+| ID | Sistema Externo | Tipo | Descrição |
+|---|---|---|---|
+| INT001 | [Nome] | API REST / Webhook / File | [O que integra] |
+| INT002 | | | |
+
+---
+
+## 6. Dúvidas em Aberto
+
+| ID | Pergunta | Responsável | Status | Resposta |
+|---|---|---|---|---|
+| Q001 | [Pergunta para stakeholder] | [Nome] | Pendente | |
+| Q002 | | | | |
+
+---
+
+## 7. Glossário
+
+| Termo | Definição |
+|---|---|
+| [Termo técnico ou de negócio] | [Definição clara] |
+| | |
+
+---
+
+## Matriz de Rastreabilidade
+
+| Requisito | User Stories | Casos de Teste |
+|---|---|---|
+| RF001 | US001, US002 | TC001, TC002 |
+| RF002 | US003 | TC003 |
+
+---
+
+## 8. Matriz Requisitos × Telas
+
+> [!NOTE]
+> Mapeie quais telas serão afetadas por cada requisito. Telas são estimativas iniciais que serão refinadas na fase de UX.
+
+| RF ID | Descrição Resumida | Telas Estimadas | Componentes Prováveis |
+|-------|-------------------|-----------------|----------------------|
+| RF001 | [Descrição curta] | [Tela1, Tela2] | [Componente1] |
+| RF002 | [Descrição curta] | [Tela1] | [Componente1, Componente2] |
+| RF003 | [Descrição curta] | [Tela2, Tela3] | [Componente2] |
+
+### Legenda de Telas
+
+| ID | Nome da Tela | Tipo | Área |
+|----|-------------|------|------|
+| T01 | [Nome] | [Lista/Detalhe/Form] | [Pública/Auth] |
+| T02 | [Nome] | | |
+
+---
+
+## Changelog
+
+| Versão | Data | Autor | Mudanças |
+|---|---|---|---|
+| 1.0 | YYYY-MM-DD | [Nome] | Versão inicial |

package/content/templates/slo-sli.md

@@ -0,0 +1,197 @@
+# Template: SLOs e SLIs do Sistema
+
+> **Preencha este template** para definir os objetivos de confiabilidade do seu sistema.
+
+---
+
+## Informações do Sistema
+
+| Campo | Valor |
+|-------|-------|
+| **Nome do Sistema** | [NOME] |
+| **Responsável** | [TIME/PESSOA] |
+| **Criticidade** | [ ] Baixa [ ] Média [ ] Alta [ ] Crítica |
+| **Data de Criação** | [DATA] |
+| **Última Revisão** | [DATA] |
+
+---
+
+## Definições
+
+| Termo | Significado |
+|-------|-------------|
+| **SLA** | Service Level Agreement - Acordo contratual com clientes externos |
+| **SLO** | Service Level Objective - Meta interna de confiabilidade |
+| **SLI** | Service Level Indicator - Métrica que mede o SLO |
+| **Error Budget** | Quantidade de erros/indisponibilidade permitida antes de violar o SLO |
+
+---
+
+## SLOs Definidos
+
+### SLO-001: Disponibilidade
+
+| Aspecto | Valor |
+|---------|-------|
+| **Descrição** | O sistema deve estar disponível para responder requisições |
+| **SLI** | `(requests bem-sucedidos / total de requests) × 100%` |
+| **SLO Target** | [99.9%] |
+| **Error Budget** | [43.2 min/mês] ou [0.1% de requests podem falhar] |
+| **Janela de Medição** | Rolling [30] dias |
+| **Exclusões** | Manutenções programadas, dependências externas |
+
+**Cálculo do Error Budget:**
+
+| SLO | Error Budget (30 dias) | Error Budget (por semana) |
+|-----|------------------------|---------------------------|
+| 99% | 7.2 horas | 1.68 horas |
+| 99.9% | 43.2 minutos | 10 minutos |
+| 99.95% | 21.6 minutos | 5 minutos |
+| 99.99% | 4.32 minutos | 1 minuto |
+
+---
+
+### SLO-002: Latência
+
+| Aspecto | Valor |
+|---------|-------|
+| **Descrição** | Tempo de resposta para requisições |
+| **SLI** | Percentil de latência das requisições |
+| **SLO Target p50** | [< 100ms] (mediana) |
+| **SLO Target p95** | [< 300ms] |
+| **SLO Target p99** | [< 1000ms] |
+| **Janela de Medição** | Rolling [7] dias |
+| **Exclusões** | Operações de export/batch, uploads grandes |
+
+**Endpoints Críticos (medir separadamente):**
+
+| Endpoint | p50 | p95 | p99 |
+|----------|-----|-----|-----|
+| `GET /api/health` | < 10ms | < 50ms | < 100ms |
+| `POST /api/auth/login` | < 200ms | < 500ms | < 1s |
+| `GET /api/products` | < 100ms | < 300ms | < 500ms |
+| [ADICIONAR SEUS ENDPOINTS] | | | |
+
+---
+
+### SLO-003: Taxa de Erros
+
+| Aspecto | Valor |
+|---------|-------|
+| **Descrição** | Proporção de requisições que resultam em erro |
+| **SLI** | `(erros 5xx / total de requests) × 100%` |
+| **SLO Target** | [< 0.1%] |
+| **Janela de Medição** | Rolling [24] horas |
+| **Exclusões** | Erros 4xx (responsabilidade do cliente) |
+
+---
+
+### SLO-004: Throughput
+
+| Aspecto | Valor |
+|---------|-------|
+| **Descrição** | Capacidade de processamento do sistema |
+| **SLI** | Requests processados por segundo |
+| **SLO Target** | Suportar [1000] req/s sem degradação |
+| **Degradação Aceitável** | Até [20%] aumento de latência em picos |
+| **Janela de Medição** | Picos de [5] minutos |
+
+---
+
+### SLO-005: Durabilidade de Dados (se aplicável)
+
+| Aspecto | Valor |
+|---------|-------|
+| **Descrição** | Dados armazenados não devem ser perdidos |
+| **SLI** | % de objetos preservados |
+| **SLO Target** | [99.999999999%] (11 noves) |
+| **Janela de Medição** | Anual |
+| **Estratégia** | Replicação multi-região, backups diários |
+
+---
+
+## Ações por Consumo de Error Budget
+
+| Budget Consumido | Status | Ações |
+|------------------|--------|-------|
+| 0-50% | 🟢 Normal | Operação normal, deploys liberados |
+| 50-75% | 🟡 Atenção | Alerta para time, revisar deploys |
+| 75-90% | 🟠 Alerta | Freeze parcial, priorizar estabilidade |
+| 90-100% | 🔴 Crítico | Freeze total de features, foco em bugs |
+| >100% | ⚫ Violação | Post-mortem obrigatório, plano de ação |
+
+---
+
+## Alertas Configurados
+
+| SLO | Condição de Alerta | Severidade | Canal |
+|-----|-------------------|------------|-------|
+| Disponibilidade | < 99.5% (1h window) | Warning | Slack |
+| Disponibilidade | < 99% (1h window) | Critical | PagerDuty |
+| Latência p95 | > 500ms (5min window) | Warning | Slack |
+| Latência p99 | > 2s (5min window) | Critical | PagerDuty |
+| Error Rate | > 1% (5min window) | Critical | PagerDuty |
+| Error Budget | > 50% consumido | Warning | Slack |
+| Error Budget | > 80% consumido | Critical | Email + Slack |
+
+---
+
+## Dashboard e Observabilidade
+
+### Métricas a Coletar
+
+```yaml
+# Prometheus/OpenTelemetry metrics
+- http_requests_total{status, endpoint, method}
+- http_request_duration_seconds{endpoint, method, quantile}
+- http_errors_total{status, endpoint}
+- error_budget_remaining_percent{service}
+```
+
+### Queries de Referência (PromQL)
+
+```promql
+# Disponibilidade (últimas 24h)
+sum(rate(http_requests_total{status=~"2.."}[24h])) 
+/ 
+sum(rate(http_requests_total[24h])) * 100
+
+# Latência p95
+histogram_quantile(0.95, 
+  sum(rate(http_request_duration_seconds_bucket[5m])) by (le)
+)
+
+# Taxa de erros
+sum(rate(http_requests_total{status=~"5.."}[5m])) 
+/ 
+sum(rate(http_requests_total[5m])) * 100
+```
+
+---
+
+## Revisão e Governança
+
+| Atividade | Frequência | Responsável |
+|-----------|------------|-------------|
+| Revisão de SLOs | Trimestral | Tech Lead + SRE |
+| Análise de Error Budget | Semanal | Time de Produto |
+| Post-mortem de violações | Após cada violação | Time responsável |
+| Atualização de alertas | Mensal | SRE |
+
+---
+
+## Histórico de Violações
+
+| Data | SLO Violado | Duração | Causa Raiz | Ação Corretiva |
+|------|-------------|---------|------------|----------------|
+| [DATA] | [SLO-XXX] | [DURAÇÃO] | [CAUSA] | [AÇÃO] |
+
+---
+
+## Próximos Passos
+
+- [ ] Configurar coleta de métricas (Prometheus/Datadog/New Relic)
+- [ ] Criar dashboard com SLIs em tempo real
+- [ ] Configurar alertas conforme tabela acima
+- [ ] Integrar com sistema de on-call (PagerDuty/Opsgenie)
+- [ ] Agendar primeira revisão de SLOs