@maestro-ai/mcp-server 1.2.0 → 2.1.0

package/dist/content/skills/specialist-plano-execucao-ia/README.md

@@ -0,0 +1,194 @@
+# Especialista em Plano de Execução com IA
+
+**Versão:** 2.0  
+**Última Atualização:** 31/01/2026  
+**Status:** ✅ Estrutura Moderna Completa
+
+---
+
+## 📋 Visão Geral
+
+Especialista em transformar requisitos, design e arquitetura em backlog executável estruturado, com épicos, features e histórias de usuário prontas para implementação por squads frontend/backend trabalhando com IA.
+
+### **Quando Usar**
+
+- **Fase:** Fase 9 - Plano de Execução
+- **Após:** PRD, Requisitos, UX Design e Arquitetura concluídos
+- **Antes:** Início do desenvolvimento paralelo de squads
+- **Workflows:** `/maestro`, `/nova-feature`
+
+### **Valor Entregue**
+
+- Backlog estruturado com épicos e features priorizadas
+- Histórias de usuário com critérios de aceite em Gherkin
+- Separação clara entre Contrato API, Frontend, Backend e Integração
+- Timeline realista com buffer e dependências mapeadas
+- Definition of Done (DoD) por tipo de história
+
+---
+
+## 📥 Artefatos de Entrada
+
+| Artefato | Localização | Obrigatório |
+|----------|-------------|-------------|
+| **PRD** | `docs/01-produto/PRD.md` | ✅ Sim |
+| **Requisitos** | `docs/02-requisitos/requisitos.md` | ✅ Sim |
+| **Design Doc** | `docs/03-ux/design-doc.md` | ✅ Sim |
+| **Arquitetura** | `docs/06-arquitetura/arquitetura.md` | ✅ Sim |
+| **Contexto** | `docs/CONTEXTO.md` | ✅ Sim |
+| **Capacidade do Time** | Informado pelo usuário | ⚠️ Opcional (assume 1-2 devs + IA) |
+
+---
+
+## 📤 Artefatos de Saída
+
+| Artefato | Localização | Descrição |
+|----------|-------------|-----------|
+| **Backlog** | `docs/08-backlog/backlog.md` | Backlog completo com épicos e features |
+| **Features** | `docs/08-backlog/features/` | Features detalhadas por tipo (CONT, FE, BE, INT) |
+| **Contratos API** | `docs/08-backlog/contratos/` | Especificações OpenAPI/Swagger |
+| **Histórias** | Dentro de features | Histórias de usuário com critérios de aceite |
+| **Timeline** | Dentro de backlog | Roadmap com sprints e releases |
+
+---
+
+## 🎯 Processo de Planejamento
+
+### **1. Análise de Documentos**
+
+Antes de iniciar, o especialista DEVE:
+- Ler e validar consistência entre PRD, Requisitos, Design e Arquitetura
+- Identificar épicos principais e suas dependências
+- Mapear funcionalidades para componentes técnicos
+
+### **2. Perguntas de Contexto**
+
+Se informações incompletas, perguntar:
+1. **Quantos desenvolvedores disponíveis?** (assume 1-2 + IA)
+2. **Duração dos sprints?** (assume 1-2 semanas)
+3. **Há deadlines fixos?** (lançamento, evento, etc.)
+
+### **3. Planejamento Sequencial (Contract-First)**
+
+**Ordem Obrigatória:**
+1. **Setup** - Repositório, CI/CD, estrutura
+2. **Contrato API** - OpenAPI/Swagger completo
+3. **Mocks** - Mock server para frontend
+4. **Frontend** - Desenvolvimento contra mocks
+5. **Backend** - Implementação do contrato
+6. **Integração** - Conexão FE ↔ BE + testes E2E
+
+### **4. Validação com Usuário**
+
+**NUNCA avance automaticamente!**
+1. Resumir backlog (épicos, quantidade de histórias)
+2. Mostrar ordem de execução proposta
+3. Perguntar: "Este plano está viável? Posso salvar e avançar?"
+
+---
+
+## ✅ Quality Gates
+
+### **Checklist Obrigatório (Score Mínimo: 75/100)**
+
+**Estrutura do Backlog (25 pontos):**
+- [ ] Épicos claramente definidos e priorizados
+- [ ] Features mapeadas para épicos
+- [ ] Histórias mapeadas para features
+- [ ] Priorização RICE aplicada
+
+**Qualidade das Histórias (30 pontos):**
+- [ ] Formato "Como [persona], quero [ação], para [benefício]"
+- [ ] Critérios de aceite em Gherkin (Given/When/Then)
+- [ ] Estimativas de esforço (Story Points ou T-Shirt)
+- [ ] Dependências técnicas identificadas
+
+**Rastreabilidade (20 pontos):**
+- [ ] Histórias rastreadas para requisitos funcionais
+- [ ] Histórias rastreadas para design (wireframes)
+- [ ] Matriz de rastreabilidade completa
+
+**Planejamento (25 pontos):**
+- [ ] Sprints definidos com capacidade
+- [ ] Releases planejados com marcos
+- [ ] Riscos identificados e mitigados
+- [ ] Buffer de 20% no timeline
+
+---
+
+## 🔄 Context Flow
+
+### **Entrada desta Fase**
+- PRD aprovado (Gestão de Produto)
+- Requisitos validados (Engenharia de Requisitos)
+- Design aprovado (UX Design)
+- Arquitetura definida (Arquitetura de Software)
+
+### **Saída para Próxima Fase**
+- Backlog pronto para desenvolvimento
+- Contratos API para implementação
+- Histórias prontas para sprint planning
+- DoD definido para validação
+
+---
+
+## 📚 Estrutura de Recursos
+
+Este especialista possui recursos organizados em:
+
+### **Templates** (`resources/templates/`)
+- `backlog.md` - Template de backlog estruturado
+- `historia-usuario.md` - Template de história de usuário
+- `historia-frontend.md` - Template de história frontend
+- `historia-backend.md` - Template de história backend
+
+### **Examples** (`resources/examples/`)
+- Exemplos práticos de backlog completo (E-commerce, SaaS, Mobile App)
+- Input/Output pairs reais
+- Cenários de sprint planning e release planning
+
+### **Checklists** (`resources/checklists/`)
+- Checklist de validação com 100+ pontos
+- Critérios objetivos de qualidade
+- Score mínimo de 75/100 pontos
+
+### **Reference** (`resources/reference/`)
+- Guia completo de metodologias ágeis (Scrum, Kanban, SAFe)
+- Técnicas de priorização (RICE, MoSCoW, Value vs Effort)
+- Estrutura de histórias e estimativas
+- Planejamento de releases e capacidade
+
+---
+
+## 🤖 Funções MCP
+
+Este especialista possui 3 funções MCP para automação:
+
+1. **init_backlog_structure** - Inicializar estrutura de backlog
+2. **validate_backlog_quality** - Validar qualidade com score
+3. **process_backlog_to_next_phase** - Preparar para desenvolvimento
+
+Ver `MCP_INTEGRATION.md` para detalhes completos.
+
+---
+
+## 🎓 Skills Complementares
+
+- `plan-writing` - Escrita de planos
+- `documentation-templates` - Templates de documentação
+- `brainstorming` - Brainstorming de features
+- `agile-methodologies` - Metodologias ágeis
+
+---
+
+## 📖 Referências
+
+- **Especialista Original:** `content/specialists/Especialista em Plano de Execução com IA.md`
+- **Templates Maestro:** `content/templates/backlog.md`, `historia-usuario.md`
+- **Documentação Completa:** Ver README.md neste diretório
+
+---
+
+**Versão:** 2.0  
+**Framework:** Skills Modernas com Progressive Disclosure  
+**Arquitetura:** Skill Descritiva + Automação MCP

package/dist/content/skills/specialist-plano-execucao-ia/SKILL.md

@@ -0,0 +1,271 @@
+---
+name: specialist-plano-execucao-ia
+description: Planejamento de backlog, épicos, histórias e roadmap operado com IA.
+allowed-tools: Read, Write, Edit, Glob, Grep
+---
+
+# Plano de Execução com IA · Skill do Especialista
+
+## Missão
+Quebrar visão em backlog FE/BE, definir épicos, histórias e DoD, otimizando para 1-2 devs + IA com qualidade e velocidade.
+
+## Quando ativar
+- Fase: Fase 9 · Execução
+- Workflows recomendados: /maestro, /nova-feature
+- Use quando precisar antes de iniciar desenvolvimento paralelo de squads.
+
+## Inputs obrigatórios
+- PRD (`docs/01-produto/PRD.md`)
+- Requisitos (`docs/02-requisitos/requisitos.md`)
+- Arquitetura (`docs/06-arquitetura/arquitetura.md`)
+- Design Doc (`docs/03-ux/design-doc.md`)
+- CONTEXTO.md do projeto
+- Capacidades do time e restrições de sprint
+
+## Outputs gerados
+- `docs/08-backlog/backlog.md` — backlog completo
+- Features detalhadas por tipo
+- Contratos de API (OpenAPI)
+- Histórias Frontend e Backend
+- Timeline e roadmap
+- Definition of Done por tipo
+
+## Quality Gate
+- Épicos identificados e priorizados
+- Features separadas por tipo (Contrato, FE, BE, Integração)
+- Dependências mapeadas
+- Ordem de execução definida (Contrato → FE/BE → Integração)
+- DoD (Definition of Done) definido por tipo
+- Timeline realista com buffer
+
+## Processo Obrigatório de Planejamento
+
+### 1. Análise dos Documentos
+Antes de começar, você DEVE:
+- Ler PRD, Design Doc e Arquitetura
+- Identificar épicos e dependências
+- Validar consistência entre documentos
+
+### 2. Perguntas Iniciais (se necessário)
+```text
+Se contexto incompleto, pergunte:
+1. Quantos desenvolvedores disponíveis? (assume 1-2 + IA)
+2. Qual a duração dos sprints? (assume 1-2 semanas)
+3. Há datas fixas/deadlines? (lançamento, evento, etc.)
+```
+
+### 3. Planejamento Sequencial Obrigatório
+Siga ESTA ordem:
+1. Setup do projeto
+2. Contrato de API (OpenAPI ou equivalente)
+3. Mocks
+4. Frontend (contra mocks)
+5. Backend (contra contrato)
+6. Integração
+
+### 4. Validação Antes de Avançar
+**NUNCA avance automaticamente!**
+1. **Resuma o backlog** (épicos, quantidade de histórias)
+2. **Mostre ordem de execução** proposta
+3. **Pergunte**: "Este plano está viável? Posso salvar e avançar?"
+
+## Estrutura do Plano de Execução
+
+### 1. Visão Geral
+- Objetivos do MVP
+- Stack técnica confirmada
+- Premissas e restrições
+- Time e capacidades
+
+### 2. Setup Inicial (Semana 0)
+- [ ] Repositório + CI/CD
+- [ ] Linting/Formatting configurado
+- [ ] Estrutura de pastas padronizada
+- [ ] Ambiente de desenvolvimento
+- [ ] Documentação inicial
+
+### 3. Fase 1: Fundação (Semanas 1-2)
+#### Contrato de API
+- [ ] Definir OpenAPI/Swagger completo
+- [ ] Gerar tipos/clients (TypeScript, etc.)
+- [ ] Configurar mocks (MSW, WireMock)
+- [ ] Testes de contrato no CI
+
+### 4. Fase 2: Frontend vs Mocks (Semanas 3-5)
+#### Componentes e Pages
+- [ ] Componentes reutilizáveis
+- [ ] Pages principais
+- [ ] Integração com mocks
+- [ ] Testes unitários e E2E
+
+### 5. Fase 3: Backend (Semanas 4-6)
+#### Services e APIs
+- [ ] Implementação dos endpoints
+- [ ] Lógica de negócio
+- [ ] Integração com banco
+- [ ] Testes unitários e integração
+
+### 6. Fase 4: Entrega (Semanas 7-8)
+#### Integração Final
+- [ ] Conectar Frontend ↔ Backend
+- [ ] Testes E2E completos
+- [ ] Deploy em staging
+- [ ] Feedback e ajustes
+
+## Guardrails Críticos
+
+### NUNCA Faça
+- **NUNCA** avance sem validação do usuário
+- **NUNCA** ignore dependências entre fases
+- **NUNCA** pule o contrato de API
+- **NUNCA** subestime tempo de integração
+
+### SEMPRE Faça
+- **SEMPRE** contrato primeiro (contract-first)
+- **SEMPRE** mocks para frontend
+- **SEMPRE** DoD rígido (testes + lint + CI)
+- **SEMPRE** buffer de 20% no timeline
+
+### Definition of Done (Obrigatório)
+
+#### Para Contratos
+- [ ] OpenAPI completo e validado
+- [ ] Types gerados para frontend
+- [ ] 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
+
+## Context Flow
+
+### Artefatos Obrigatórios para Iniciar
+Cole no início:
+1. PRD completo com visão
+2. Requisitos funcionais e não-funcionais
+3. Arquitetura com stack definida
+4. Design Doc com wireframes
+5. CONTEXTO.md com restrições
+
+### Prompt de Continuação
+```
+Atue como Tech Lead especializado em planejamento.
+
+Contexto do projeto:
+[COLE docs/CONTEXTO.md]
+
+PRD:
+[COLE docs/01-produto/PRD.md]
+
+Arquitetura:
+[COLE docs/06-arquitetura/arquitetura.md]
+
+Design Doc:
+[COLE docs/03-ux/design-doc.md]
+
+Preciso decompor em épicos, histórias e definir sprints para o MVP.
+```
+
+### Ao Concluir Esta Fase
+1. **Salve o backlog** em `docs/08-backlog/backlog.md`
+2. **Crie as features** em `docs/08-backlog/features/`
+3. **Defina os contratos** em `docs/08-backlog/contratos/`
+4. **Atualize o CONTEXTO.md** com resumo do planejamento
+5. **Valide o Gate** usando checklist
+6. **Obtenha aprovação** explícita do usuário
+
+## Métricas e KPIs
+
+### Indicadores de Planejamento
+- **Velocity Estimada:** points por sprint
+- **Burndown Chart:** acompanhamento diário
+- **Cycle Time:** tempo médio por história
+- **Throughput:** histórias por semana
+
+### Metas de Qualidade
+- Planning Accuracy: ≥ 80%
+- Sprint Completion: ≥ 90%
+- Defect Rate: < 5%
+- On-Time Delivery: ≥ 85%
+
+## Templates Prontos
+
+### Estrutura de Épico
+```markdown
+## Épico: [Nome]
+
+### Objetivo
+[Descrição clara do valor]
+
+### Features Incluídas
+- [ ] Feature 1
+- [ ] Feature 2
+
+### Dependências
+- [ ] Contrato API
+- [ ] Design aprovado
+
+### Timeline Estimada
+- Sprint 1: Feature 1
+- Sprint 2: Feature 2
+
+### DoD
+- [ ] Todas as features implementadas
+- [ ] Testes passando
+- [ ] Documentação atualizada
+```
+
+### Estrutura de História
+```markdown
+## US-XXX: [Título]
+
+### Como [persona], eu quero [ação] para [benefício]
+
+### Critérios de Aceite
+- [ ] Critério 1
+- [ ] Critério 2
+
+### Dependências
+- [ ] Contrato API
+- [ ] Componente X
+
+### Estimativa
+- Complexidade: [Média/Alta]
+- Tempo: [X dias]
+
+### DoD
+- [ ] Código implementado
+- [ ] Testes criados
+- [ ] Code review aprovado
+- [ ] Deploy em staging
+```
+
+## Skills complementares
+- `plan-writing`
+- `documentation-templates`
+- `brainstorming`
+- `agile-methodologies`
+
+## Referências essenciais
+- **Especialista original:** `content/specialists/Especialista em Plano de Execução com IA.md`
+- **Artefatos alvo:**
+  - `docs/08-backlog/backlog.md`
+  - Features detalhadas por tipo
+  - Contratos de API (OpenAPI)
+  - Timeline e roadmap
+  - Definition of Done por tipo

package/dist/content/skills/specialist-plano-execucao-ia/mcp_functions/README.md

@@ -0,0 +1,38 @@
+# Funções MCP - Plano de Execução
+
+**Versão:** 2.0  
+**Última Atualização:** 31/01/2026
+
+Este diretório contém **referências** para implementação das funções MCP no servidor.
+
+---
+
+## 📚 Funções Disponíveis
+
+### **1. init_backlog_structure**
+- **Arquivo:** `init_backlog_structure.py`
+- **Propósito:** Inicializar estrutura de backlog
+- **Status:** Referência para implementação no MCP
+
+### **2. validate_backlog_quality**
+- **Arquivo:** `validate_backlog_quality.py`
+- **Propósito:** Validar qualidade com checklist
+- **Status:** Referência para implementação no MCP
+
+### **3. process_backlog_to_next_phase**
+- **Arquivo:** `process_backlog_to_next_phase.py`
+- **Propósito:** Preparar para próxima fase
+- **Status:** Referência para implementação no MCP
+
+---
+
+## ⚠️ Importante
+
+Estas funções são **REFERÊNCIAS** e devem ser implementadas no servidor MCP, não executadas localmente.
+
+Ver `MCP_INTEGRATION.md` para documentação completa das funções.
+
+---
+
+**Arquitetura:** Skills Descritivas + Automação MCP  
+**Execução:** Servidor MCP (não local)

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

@@ -0,0 +1,144 @@
+# Checklist de Validação - Plano de Execução
+
+**Versão:** 2.0  
+**Score Mínimo:** 75/100 pontos  
+**Última Atualização:** 31/01/2026
+
+---
+
+## 📊 Estrutura do Backlog (25 pontos)
+
+### **Épicos (10 pontos)**
+- [ ] **[5 pts]** Épicos claramente definidos com objetivos
+- [ ] **[3 pts]** Épicos priorizados (RICE, MoSCoW ou similar)
+- [ ] **[2 pts]** Épicos mapeados para objetivos do PRD
+
+### **Features (10 pontos)**
+- [ ] **[4 pts]** Features mapeadas para épicos
+- [ ] **[3 pts]** Features separadas por tipo (CONT, FE, BE, INT)
+- [ ] **[3 pts]** Features com estimativas realistas
+
+### **Dependências (5 pontos)**
+- [ ] **[3 pts]** Dependências entre features identificadas
+- [ ] **[2 pts]** Ordem de execução definida (Contract-First)
+
+---
+
+## ✅ Qualidade das Histórias (30 pontos)
+
+### **Formato (10 pontos)**
+- [ ] **[5 pts]** Formato "Como [persona], quero [ação], para [benefício]"
+- [ ] **[3 pts]** Título descritivo e único (US-XXX)
+- [ ] **[2 pts]** Tipo claramente identificado (US, FE, BE, INT)
+
+### **Critérios de Aceite (10 pontos)**
+- [ ] **[6 pts]** Critérios em Gherkin (Given/When/Then)
+- [ ] **[4 pts]** Múltiplos cenários (sucesso + erro)
+
+### **Estimativas (5 pontos)**
+- [ ] **[3 pts]** Estimativas de esforço (Story Points ou dias)
+- [ ] **[2 pts]** Estimativas consistentes com capacidade do time
+
+### **Dependências Técnicas (5 pontos)**
+- [ ] **[3 pts]** Dependências técnicas identificadas
+- [ ] **[2 pts]** Bloqueadores documentados
+
+---
+
+## 🔗 Rastreabilidade (20 pontos)
+
+### **Requisitos (8 pontos)**
+- [ ] **[5 pts]** Histórias rastreadas para requisitos funcionais
+- [ ] **[3 pts]** Cobertura de 100% dos RFs críticos
+
+### **Design (7 pontos)**
+- [ ] **[4 pts]** Histórias rastreadas para wireframes/mockups
+- [ ] **[3 pts]** Componentes UI mapeados
+
+### **Matriz de Rastreabilidade (5 pontos)**
+- [ ] **[3 pts]** Matriz RF → História criada
+- [ ] **[2 pts]** Matriz Design → História criada
+
+---
+
+## 📅 Planejamento (25 pontos)
+
+### **Sprints (10 pontos)**
+- [ ] **[4 pts]** Sprints definidos com duração
+- [ ] **[3 pts]** Capacidade do time considerada
+- [ ] **[3 pts]** Histórias distribuídas por sprint
+
+### **Releases (7 pontos)**
+- [ ] **[4 pts]** Releases planejados com marcos
+- [ ] **[3 pts]** Roadmap visual criado
+
+### **Riscos (5 pontos)**
+- [ ] **[3 pts]** Riscos identificados e documentados
+- [ ] **[2 pts]** Mitigações definidas
+
+### **Buffer (3 pontos)**
+- [ ] **[3 pts]** Buffer de 20% no timeline
+
+---
+
+## 🎯 Definition of Done (Bonus: +10 pontos)
+
+### **Por Tipo de História**
+- [ ] **[3 pts]** DoD para Contratos definido
+- [ ] **[2 pts]** DoD para Frontend definido
+- [ ] **[2 pts]** DoD para Backend definido
+- [ ] **[2 pts]** DoD para Integração definido
+- [ ] **[1 pt]** DoD inclui testes automatizados
+
+---
+
+## 📊 Cálculo de Score
+
+**Fórmula:**
+```
+Score = (Estrutura + Qualidade + Rastreabilidade + Planejamento + Bonus)
+Score Máximo = 110 pontos (100 + 10 bonus)
+```
+
+**Thresholds:**
+- **Score >= 85:** ✅ Excelente - Aprovado automaticamente
+- **Score 75-84:** ✅ Bom - Aprovado com recomendações
+- **Score 70-74:** ⚠️ Aceitável - Requer aprovação manual
+- **Score < 70:** ❌ Insuficiente - BLOQUEADO
+
+---
+
+## ⚠️ Critérios de Bloqueio Automático
+
+Independente do score, o backlog é **BLOQUEADO** se:
+
+1. **Histórias sem critérios de aceite** (>20% das histórias)
+2. **Épicos sem features** (qualquer épico vazio)
+3. **Timeline sem buffer** (0% de margem)
+4. **Dependências circulares** (features dependem umas das outras em loop)
+5. **Estimativas ausentes** (>30% das histórias sem estimativa)
+
+---
+
+## ✅ Checklist Rápida (Top 10)
+
+Para validação rápida, verificar:
+
+1. [ ] Épicos definidos e priorizados
+2. [ ] Features separadas por tipo (CONT, FE, BE, INT)
+3. [ ] Histórias no formato "Como... quero... para..."
+4. [ ] Critérios de aceite em Gherkin
+5. [ ] Estimativas de esforço presentes
+6. [ ] Dependências técnicas mapeadas
+7. [ ] Rastreabilidade para requisitos
+8. [ ] Sprints definidos
+9. [ ] Buffer de 20% no timeline
+10. [ ] DoD definido por tipo
+
+**Se todos os 10 itens estão OK:** Score mínimo de 75 garantido ✅
+
+---
+
+**Total de Pontos Possíveis:** 110  
+**Score Mínimo para Aprovação:** 75  
+**Itens de Bloqueio Automático:** 5