@maestro-ai/mcp-server 1.2.0 → 2.1.0

package/dist/content/skills/specialist-plano-execucao-ia/resources/examples/planning-examples.md

@@ -0,0 +1,203 @@
+# Exemplos Práticos - Plano de Execução
+
+**Versão:** 2.0  
+**Última Atualização:** 31/01/2026
+
+Este arquivo contém exemplos práticos completos de planejamento de execução para diferentes tipos de projetos.
+
+---
+
+## Exemplo 1: E-commerce - Backlog Completo
+
+### **Input: PRD de E-commerce**
+
+**Produto:** Loja online de roupas  
+**MVP:** Catálogo + Carrinho + Checkout  
+**Time:** 2 devs + IA  
+**Prazo:** 8 semanas
+
+### **Output: Backlog Estruturado**
+
+**Épicos Identificados:**
+1. Catálogo de Produtos (Alta prioridade)
+2. Carrinho de Compras (Alta prioridade)
+3. Checkout e Pagamento (Crítica)
+
+**Features por Tipo:**
+- **CONT-001:** API de Produtos (OpenAPI) - 2 dias
+- **CONT-002:** API de Carrinho - 1 dia
+- **CONT-003:** API de Checkout - 3 dias
+- **FE-001:** Listagem de Produtos - 3 dias
+- **FE-002:** Detalhes do Produto - 2 dias
+- **FE-003:** Carrinho de Compras - 4 dias
+- **FE-004:** Fluxo de Checkout - 5 dias
+- **BE-001:** CRUD de Produtos - 4 dias
+- **BE-002:** Lógica de Carrinho - 3 dias
+- **BE-003:** Processamento de Pagamento - 6 dias
+- **INT-001:** Integração Catálogo - 2 dias
+- **INT-002:** Integração Checkout - 3 dias
+
+**Timeline:**
+- Sprint 0: Setup (1 semana)
+- Sprint 1: Contratos (2 semanas)
+- Sprint 2-3: Frontend + Backend paralelo (4 semanas)
+- Sprint 4: Integração (1 semana)
+
+**Total:** 8 semanas com buffer de 20%
+
+---
+
+## Exemplo 2: SaaS - Sprint Planning
+
+### **Input: Requisitos de Dashboard**
+
+**Produto:** Dashboard de analytics  
+**Feature:** Visualização de métricas em tempo real  
+**Time:** 1 dev + IA  
+**Sprint:** 2 semanas
+
+### **Output: Sprint Backlog**
+
+**Histórias do Sprint:**
+
+1. **US-001:** Como usuário, quero ver métricas em cards
+   - Estimativa: 3 pontos
+   - Tarefas: Componente Card, API de métricas, Testes
+
+2. **US-002:** Como usuário, quero filtrar por período
+   - Estimativa: 5 pontos
+   - Tarefas: DatePicker, Query params, Cache
+
+3. **US-003:** Como usuário, quero exportar relatório
+   - Estimativa: 5 pontos
+   - Tarefas: Geração PDF, Download, Email
+
+**Capacity:** 13 pontos (assumindo velocity de 13 pontos/sprint)  
+**Commitment:** 13 pontos (100% da capacity)
+
+---
+
+## Exemplo 3: Mobile App - Release Planning
+
+### **Input: Design de App Mobile**
+
+**Produto:** App de delivery  
+**Releases:** 3 releases em 12 semanas  
+**Time:** 2 devs + IA
+
+### **Output: Roadmap de Releases**
+
+**Release 1.0 - MVP (Semana 4):**
+- Cadastro e Login
+- Listagem de Restaurantes
+- Cardápio
+- Carrinho básico
+
+**Release 1.1 - Pagamento (Semana 8):**
+- Integração com gateway
+- Histórico de pedidos
+- Notificações push
+
+**Release 1.2 - Gamificação (Semana 12):**
+- Sistema de pontos
+- Cupons de desconto
+- Avaliações
+
+**Métricas:**
+- Features por release: 4-5
+- Velocity média: 20 pontos/sprint
+- Buffer: 20% em cada release
+
+---
+
+## Exemplo 4: API REST - Contrato First
+
+### **Input: Requisito de API de Usuários**
+
+**Funcionalidade:** CRUD completo de usuários  
+**Stack:** NestJS + PostgreSQL
+
+### **Output: Contrato + Histórias**
+
+**CONT-001: Contrato de API de Usuários**
+
+```yaml
+openapi: 3.0.0
+paths:
+  /api/users:
+    get:
+      summary: Listar usuários
+      responses:
+        '200':
+          description: Lista de usuários
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: '#/components/schemas/User'
+    post:
+      summary: Criar usuário
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/CreateUserDto'
+      responses:
+        '201':
+          description: Usuário criado
+```
+
+**Histórias Derivadas:**
+- **FE-001:** Tela de listagem de usuários (contra mock)
+- **FE-002:** Formulário de criação (contra mock)
+- **BE-001:** Implementar GET /api/users
+- **BE-002:** Implementar POST /api/users
+- **INT-001:** Conectar frontend com backend real
+
+---
+
+## Exemplo 5: Microserviços - Dependências Complexas
+
+### **Input: Sistema com 3 Microserviços**
+
+**Serviços:**
+1. Auth Service
+2. User Service
+3. Order Service
+
+**Dependências:**
+- Order Service depende de User Service
+- Ambos dependem de Auth Service
+
+### **Output: Ordem de Execução**
+
+**Fase 1: Auth Service (Semanas 1-2)**
+- CONT-001: Contrato de Auth
+- BE-001: Implementar Auth
+- Testes de integração
+
+**Fase 2: User Service (Semanas 3-4)**
+- CONT-002: Contrato de User
+- BE-002: Implementar User (usa Auth)
+- Testes de integração
+
+**Fase 3: Order Service (Semanas 5-6)**
+- CONT-003: Contrato de Order
+- BE-003: Implementar Order (usa User + Auth)
+- Testes de integração
+
+**Fase 4: Frontend (Semanas 7-8)**
+- FE-001: Telas de autenticação
+- FE-002: Gestão de usuários
+- FE-003: Gestão de pedidos
+
+**Fase 5: Integração (Semana 9)**
+- INT-001: Testes E2E completos
+- Deploy orquestrado
+
+---
+
+**Total de Exemplos:** 5  
+**Cenários Cobertos:** E-commerce, SaaS, Mobile, API REST, Microserviços  
+**Complexidade:** Simples a Complexa

package/dist/content/skills/specialist-plano-execucao-ia/resources/reference/planning-guide.md

@@ -0,0 +1,316 @@
+# Guia Completo - Plano de Execução
+
+**Versão:** 2.0  
+**Última Atualização:** 31/01/2026
+
+Este guia fornece metodologias, técnicas e best practices para planejamento de execução com IA.
+
+---
+
+## 📚 Metodologias Ágeis
+
+### **Scrum Framework**
+
+**Artefatos:**
+- Product Backlog
+- Sprint Backlog
+- Increment
+
+**Eventos:**
+- Sprint Planning
+- Daily Scrum
+- Sprint Review
+- Sprint Retrospective
+
+**Papéis:**
+- Product Owner
+- Scrum Master
+- Development Team
+
+### **Kanban Principles**
+
+**Práticas Core:**
+1. Visualizar o fluxo de trabalho
+2. Limitar WIP (Work In Progress)
+3. Gerenciar fluxo
+4. Tornar políticas explícitas
+5. Implementar feedback loops
+6. Melhorar colaborativamente
+
+### **SAFe for Enterprise**
+
+**Níveis:**
+- Team Level (Scrum/Kanban)
+- Program Level (Agile Release Train)
+- Portfolio Level (Strategic Themes)
+
+---
+
+## 🎯 Técnicas de Priorização
+
+### **RICE Framework**
+
+**Fórmula:** `Score = (Reach × Impact × Confidence) / Effort`
+
+- **Reach:** Quantas pessoas serão impactadas?
+- **Impact:** Qual o impacto no objetivo? (3=Massive, 2=High, 1=Medium, 0.5=Low)
+- **Confidence:** Quão confiante você está? (100%=High, 80%=Medium, 50%=Low)
+- **Effort:** Quanto esforço (person-months)?
+
+**Exemplo:**
+```
+Feature: Sistema de Notificações
+Reach: 1000 usuários/mês
+Impact: 2 (High)
+Confidence: 80%
+Effort: 2 person-months
+
+Score = (1000 × 2 × 0.8) / 2 = 800
+```
+
+### **MoSCoW Method**
+
+- **Must have:** Crítico para MVP
+- **Should have:** Importante mas não crítico
+- **Could have:** Desejável se houver tempo
+- **Won't have:** Fora do escopo atual
+
+### **Value vs Effort Matrix**
+
+```
+High Value, Low Effort  → Quick Wins (Prioridade 1)
+High Value, High Effort → Major Projects (Prioridade 2)
+Low Value, Low Effort   → Fill-Ins (Prioridade 3)
+Low Value, High Effort  → Time Sinks (Evitar)
+```
+
+---
+
+## 📝 Estrutura de Histórias
+
+### **User Story Format**
+
+**Template:**
+```
+Como [persona],
+Eu quero [ação],
+Para [benefício].
+```
+
+**Exemplo:**
+```
+Como cliente do e-commerce,
+Eu quero adicionar produtos ao carrinho,
+Para comprar múltiplos itens de uma vez.
+```
+
+### **Acceptance Criteria (Gherkin)**
+
+**Formato:**
+```gherkin
+Dado que [contexto inicial]
+Quando [ação do usuário]
+Então [resultado esperado]
+```
+
+**Exemplo:**
+```gherkin
+Dado que estou na página de produto
+Quando clico em "Adicionar ao Carrinho"
+Então o produto aparece no carrinho
+E o contador do carrinho incrementa em 1
+```
+
+### **Definition of Done**
+
+**Checklist Padrão:**
+- [ ] Código implementado
+- [ ] Testes unitários (>80% coverage)
+- [ ] Testes de integração passando
+- [ ] Code review aprovado
+- [ ] Documentação atualizada
+- [ ] Deploy em staging
+- [ ] Validação com stakeholder
+
+---
+
+## 📊 Estimation Techniques
+
+### **Story Points (Fibonacci)**
+
+**Escala:** 1, 2, 3, 5, 8, 13, 21
+
+- **1 ponto:** Tarefa trivial (~1-2 horas)
+- **2 pontos:** Tarefa simples (~half day)
+- **3 pontos:** Tarefa média (~1 dia)
+- **5 pontos:** Tarefa complexa (~2-3 dias)
+- **8 pontos:** Tarefa muito complexa (~1 semana)
+- **13+ pontos:** Épico - quebrar em histórias menores
+
+### **T-Shirt Sizing**
+
+- **XS:** Trivial
+- **S:** Simples
+- **M:** Médio
+- **L:** Grande
+- **XL:** Muito grande (quebrar)
+
+### **Planning Poker**
+
+1. Product Owner apresenta história
+2. Time discute brevemente
+3. Cada membro escolhe carta (Fibonacci)
+4. Revelação simultânea
+5. Discussão de discrepâncias
+6. Re-votação até consenso
+
+---
+
+## 📅 Planejamento de Releases
+
+### **Roadmap Creation**
+
+**Estrutura:**
+```
+Q1 2026
+├── Release 1.0 (MVP)
+│   ├── Épico 1: Auth
+│   └── Épico 2: Core Features
+├── Release 1.1
+│   └── Épico 3: Advanced Features
+```
+
+### **Sprint Planning**
+
+**Inputs:**
+- Product Backlog priorizado
+- Velocity do time
+- Capacity do sprint
+
+**Outputs:**
+- Sprint Goal
+- Sprint Backlog
+- Commitment
+
+**Fórmula de Capacity:**
+```
+Capacity = (Devs × Days × Hours) × Focus Factor
+
+Exemplo:
+2 devs × 10 dias × 8 horas × 0.7 = 112 horas
+```
+
+### **Capacity Planning**
+
+**Fatores a Considerar:**
+- Férias e feriados
+- Reuniões e overhead
+- Dívida técnica
+- Bugs e suporte
+- Focus factor (0.6-0.8)
+
+---
+
+## ⚠️ Risk Management
+
+### **Identificação de Riscos**
+
+**Categorias:**
+- **Técnicos:** Complexidade, dependências
+- **Recursos:** Disponibilidade do time
+- **Escopo:** Mudanças de requisitos
+- **Externos:** Integrações, APIs de terceiros
+
+### **Matriz de Riscos**
+
+| Risco | Probabilidade | Impacto | Score | Mitigação |
+|-------|---------------|---------|-------|-----------|
+| API de pagamento instável | Alta | Alto | 9 | Implementar retry + fallback |
+| Dev sai do projeto | Baixa | Alto | 6 | Documentação + pair programming |
+
+**Score = Probabilidade (1-3) × Impacto (1-3)**
+
+### **Mitigações Comuns**
+
+- **Buffer de 20%** no timeline
+- **Spike técnico** para incertezas
+- **Proof of Concept** para integrações
+- **Pair programming** para conhecimento compartilhado
+
+---
+
+## 🔄 Contract-First Development
+
+### **Benefícios**
+
+1. **Desenvolvimento Paralelo:** Frontend e Backend trabalham simultaneamente
+2. **Mocks Automáticos:** Frontend desenvolve contra mocks
+3. **Validação Antecipada:** Erros de contrato detectados cedo
+4. **Documentação Viva:** OpenAPI como fonte da verdade
+
+### **Fluxo**
+
+```
+1. Definir Contrato (OpenAPI)
+   ↓
+2. Gerar Types (TypeScript, DTOs)
+   ↓
+3. Criar Mocks (MSW, WireMock)
+   ↓
+4. Frontend desenvolve contra mocks
+   ↓
+5. Backend implementa contrato
+   ↓
+6. Testes de contrato validam
+   ↓
+7. Integração FE ↔ BE
+```
+
+### **Ferramentas**
+
+- **OpenAPI Generator:** Gera clients e types
+- **MSW (Mock Service Worker):** Mocks para frontend
+- **Pact:** Contract testing
+- **Swagger UI:** Documentação interativa
+
+---
+
+## 📊 Métricas e KPIs
+
+### **Velocity**
+
+**Definição:** Pontos completados por sprint
+
+**Cálculo:**
+```
+Velocity = Σ(Story Points Completed) / Number of Sprints
+```
+
+**Uso:** Previsão de entregas futuras
+
+### **Burndown Chart**
+
+**Eixos:**
+- X: Dias do sprint
+- Y: Trabalho restante (pontos ou horas)
+
+**Ideal:** Linha reta descendente
+
+### **Cycle Time**
+
+**Definição:** Tempo médio de "In Progress" até "Done"
+
+**Meta:** Reduzir ao longo do tempo
+
+### **Throughput**
+
+**Definição:** Histórias completadas por semana
+
+**Meta:** Aumentar ou estabilizar
+
+---
+
+**Total de Seções:** 8  
+**Metodologias Cobertas:** Scrum, Kanban, SAFe  
+**Técnicas:** RICE, MoSCoW, Story Points, Planning Poker  
+**Ferramentas:** OpenAPI, MSW, Pact

package/dist/content/skills/specialist-plano-execucao-ia/resources/templates/backlog.md

@@ -0,0 +1,146 @@
+# Backlog - {{NOME_PROJETO}}
+
+**Data:** {{DATA}}  
+**Versão:** 1.0  
+**Status:** 🔄 Em Planejamento
+
+---
+
+## 📊 Visão Geral do MVP
+
+### **Objetivo**
+{{DESCREVER_OBJETIVO_MVP}}
+
+### **Stack Técnica**
+- **Frontend:** {{STACK_FRONTEND}}
+- **Backend:** {{STACK_BACKEND}}
+- **Banco de Dados:** {{BANCO_DADOS}}
+- **Infraestrutura:** {{INFRA}}
+
+### **Time e Capacidade**
+- **Desenvolvedores:** {{NUM_DEVS}}
+- **Duração Sprint:** {{DURACAO_SPRINT}} semanas
+- **Velocity Estimada:** {{VELOCITY}} pontos/sprint
+
+---
+
+## 🎯 Épicos
+
+### **Épico 1: {{NOME_EPICO_1}}**
+**Objetivo:** {{OBJETIVO_EPICO_1}}  
+**Prioridade:** Alta  
+**Features:** {{NUM_FEATURES}} features
+
+- [ ] FEAT-001: {{FEATURE_1}}
+- [ ] FEAT-002: {{FEATURE_2}}
+
+### **Épico 2: {{NOME_EPICO_2}}**
+**Objetivo:** {{OBJETIVO_EPICO_2}}  
+**Prioridade:** Média  
+**Features:** {{NUM_FEATURES}} features
+
+---
+
+## 📋 Features por Tipo
+
+### **Contratos de API (CONT)**
+| ID | Feature | Épico | Prioridade | Estimativa |
+|----|---------|-------|------------|------------|
+| CONT-001 | {{FEATURE_CONTRATO_1}} | Épico 1 | Alta | 3 dias |
+| CONT-002 | {{FEATURE_CONTRATO_2}} | Épico 2 | Média | 2 dias |
+
+### **Frontend (FE)**
+| ID | Feature | Épico | Dependência | Estimativa |
+|----|---------|-------|-------------|------------|
+| FE-001 | {{FEATURE_FRONTEND_1}} | Épico 1 | CONT-001 | 5 dias |
+| FE-002 | {{FEATURE_FRONTEND_2}} | Épico 2 | CONT-002 | 3 dias |
+
+### **Backend (BE)**
+| ID | Feature | Épico | Dependência | Estimativa |
+|----|---------|-------|-------------|------------|
+| BE-001 | {{FEATURE_BACKEND_1}} | Épico 1 | CONT-001 | 5 dias |
+| BE-002 | {{FEATURE_BACKEND_2}} | Épico 2 | CONT-002 | 4 dias |
+
+### **Integração (INT)**
+| ID | Feature | Épico | Dependências | Estimativa |
+|----|---------|-------|--------------|------------|
+| INT-001 | {{FEATURE_INTEGRACAO_1}} | Épico 1 | FE-001, BE-001 | 2 dias |
+| INT-002 | {{FEATURE_INTEGRACAO_2}} | Épico 2 | FE-002, BE-002 | 2 dias |
+
+---
+
+## 📅 Timeline e Sprints
+
+### **Sprint 0 - Setup (Semana 0)**
+- [ ] Repositório + CI/CD
+- [ ] Estrutura de pastas
+- [ ] Linting configurado
+
+### **Sprint 1 - Contratos (Semanas 1-2)**
+- [ ] CONT-001: {{FEATURE_CONTRATO_1}}
+- [ ] CONT-002: {{FEATURE_CONTRATO_2}}
+- [ ] Mocks configurados
+
+### **Sprint 2-3 - Frontend (Semanas 3-6)**
+- [ ] FE-001: {{FEATURE_FRONTEND_1}}
+- [ ] FE-002: {{FEATURE_FRONTEND_2}}
+
+### **Sprint 2-3 - Backend (Semanas 4-6)**
+- [ ] BE-001: {{FEATURE_BACKEND_1}}
+- [ ] BE-002: {{FEATURE_BACKEND_2}}
+
+### **Sprint 4 - Integração (Semanas 7-8)**
+- [ ] INT-001: {{FEATURE_INTEGRACAO_1}}
+- [ ] INT-002: {{FEATURE_INTEGRACAO_2}}
+- [ ] Testes E2E
+
+---
+
+## 🎯 Definition of Done
+
+### **Para Contratos**
+- [ ] OpenAPI completo e validado
+- [ ] Types gerados
+- [ ] Mocks funcionais
+- [ ] Testes de contrato passando
+
+### **Para Frontend**
+- [ ] Componentes testáveis
+- [ ] Integração com mocks
+- [ ] Responsivo e acessível
+- [ ] Performance aceitável
+
+### **Para Backend**
+- [ ] Endpoints implementados
+- [ ] Testes unitários (>80% coverage)
+- [ ] Documentação da API
+- [ ] Segurança implementada
+
+### **Para Integração**
+- [ ] Frontend ↔ Backend conectado
+- [ ] Testes E2E passando
+- [ ] Deploy em staging
+- [ ] Monitoramento configurado
+
+---
+
+## 📊 Métricas
+
+- **Total de Features:** {{TOTAL_FEATURES}}
+- **Total de Histórias:** {{TOTAL_HISTORIAS}}
+- **Estimativa Total:** {{ESTIMATIVA_TOTAL}} dias
+- **Com Buffer (20%):** {{ESTIMATIVA_COM_BUFFER}} dias
+- **Data Prevista:** {{DATA_PREVISTA}}
+
+---
+
+## ⚠️ Riscos Identificados
+
+| Risco | Probabilidade | Impacto | Mitigação |
+|-------|---------------|---------|-----------|
+| {{RISCO_1}} | {{PROB_1}} | {{IMPACTO_1}} | {{MITIGACAO_1}} |
+| {{RISCO_2}} | {{PROB_2}} | {{IMPACTO_2}} | {{MITIGACAO_2}} |
+
+---
+
+**Próxima Ação:** Iniciar Sprint 0 - Setup do Projeto