@maestro-ai/mcp-server 1.2.0 → 2.1.0

package/dist/content/templates/prototipo-stitch.md

@@ -1,138 +0,0 @@
-# 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/dist/content/templates/requisitos.md

@@ -1,162 +0,0 @@
-# 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/dist/content/templates/slo-sli.md

@@ -1,197 +0,0 @@
-# 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