@maestro-ai/mcp-server 1.2.0 → 2.1.0

package/dist/content/skills/specialist-debugging-troubleshooting/resources/templates/post-mortem.md

@@ -0,0 +1,241 @@
+# Post-Mortem Template
+
+**Incident ID:** INC-XXX  
+**Severidade:** [P0 - Crítico | P1 - Alto | P2 - Médio | P3 - Baixo]  
+**Data do Incidente:** YYYY-MM-DD HH:MM  
+**Duração:** X horas Y minutos  
+**Status:** [Draft | Under Review | Published]
+
+---
+
+## 📋 Executive Summary
+
+[Resumo de 2-3 parágrafos para stakeholders não-técnicos]
+
+**O que aconteceu:**
+- Serviço de export de dados ficou indisponível por 2 horas
+- 500 usuários afetados, 150 tentativas de export falharam
+
+**Impacto:**
+- 12 tickets de suporte criados
+- -5% NPS temporário
+- $0 em revenue loss (feature gratuita)
+
+**Causa Raiz:**
+- Configuração de timezone ausente causou queries inválidas
+
+**Resolução:**
+- Fix deployado em 2 horas
+- Medidas preventivas implementadas
+
+---
+
+## 🕐 Timeline
+
+### Detecção
+- **12:00** - Primeiro erro reportado por usuário via support
+- **12:05** - Equipe de suporte escalou para engenharia
+- **12:10** - Engenheiro começou investigação
+
+### Investigação
+- **12:15** - Bug reproduzido localmente (100%)
+- **12:30** - Componente isolado: `ExportService.generateCSV()`
+- **12:45** - Causa raiz identificada: timezone configuration
+
+### Resolução
+- **13:00** - Fix implementado e testado localmente
+- **13:15** - Code review aprovado
+- **13:30** - Deploy em staging
+- **13:45** - Testes em staging passaram
+- **14:00** - Deploy em produção
+- **14:15** - Monitoramento confirmou resolução
+
+### Comunicação
+- **14:20** - Status page atualizado
+- **14:30** - Usuários afetados notificados
+- **15:00** - Post-mortem iniciado
+
+---
+
+## 🔍 Root Cause Analysis (5 Whys)
+
+### Pergunta Inicial
+**Por que o export de dados falhou?**
+
+### Análise
+1. **Por quê?** → `data.map` falha porque `data` é `undefined`
+2. **Por quê?** → Query ao banco retorna `null` em vez de array vazio
+3. **Por quê?** → Filtro de data está incorreto, não encontra registros
+4. **Por quê?** → Timezone não está sendo considerado na query
+5. **Por quê?** → Biblioteca de datas não foi configurada com timezone
+
+### Root Cause
+**Configuração de timezone ausente na biblioteca de datas**
+
+### Contributing Factors
+- Testes de edge cases não cobriam query com resultado vazio
+- Linter não detecta `.map()` sem validação de null
+- Monitoring não alertou sobre spike de erros 500
+
+---
+
+## 📊 Impact Analysis
+
+### Usuários Afetados
+| Métrica | Valor |
+|---------|-------|
+| Total de usuários | 500 |
+| Tentativas de export | 150 |
+| Período | 5 dias |
+| Taxa de falha | 100% |
+
+### Business Impact
+| Categoria | Impacto |
+|-----------|---------|
+| Revenue Loss | $0 |
+| Support Tickets | 12 |
+| NPS | -5% (temporário) |
+| Churn | 0% |
+
+### Technical Impact
+| Métrica | Valor |
+|---------|-------|
+| Erros 500 | 150 |
+| Downtime | 0% (feature específica) |
+| Database Load | Normal |
+| API Latency | Normal |
+
+---
+
+## 🛠️ Resolution
+
+### Fix Implementado
+```typescript
+// ANTES (export.service.ts:45)
+const data = await this.db.query(filter);
+return data.map(row => this.formatCSV(row));
+
+// DEPOIS
+const data = await this.db.query(filter) || [];
+return data.map(row => this.formatCSV(row));
+```
+
+### Regression Test
+```typescript
+it('should handle empty query results', async () => {
+  jest.spyOn(db, 'query').mockResolvedValue(null);
+  const result = await service.generateCSV(filter);
+  expect(result).toEqual([]);
+});
+```
+
+### Validação
+- ✅ Fix testado localmente
+- ✅ Code review aprovado
+- ✅ Testes em staging passaram
+- ✅ Deploy em produção bem-sucedido
+- ✅ Monitoring confirmou resolução
+
+---
+
+## 🚀 Action Items
+
+### Curto Prazo (1 semana)
+- [ ] **[ENG-123]** Adicionar validação de `null` em todos os `.map()` - @dev1
+- [ ] **[ENG-124]** Configurar timezone globalmente - @dev2
+- [ ] **[ENG-125]** Adicionar testes de edge cases - @qa1
+- [ ] **[ENG-126]** Atualizar documentação de setup - @tech-writer
+
+### Médio Prazo (1 mês)
+- [ ] **[ENG-127]** Implementar linter rule para `.map()` sem validação - @dev3
+- [ ] **[ENG-128]** Criar checklist de timezone para novos serviços - @architect
+- [ ] **[ENG-129]** Adicionar monitoring de erros 500 com alertas - @devops
+
+### Longo Prazo (3 meses)
+- [ ] **[ENG-130]** Revisar todos os serviços para edge cases similares - @team
+- [ ] **[ENG-131]** Implementar testes de chaos engineering - @sre
+- [ ] **[ENG-132]** Criar runbook para incidentes de export - @oncall
+
+---
+
+## 📚 Lessons Learned
+
+### O que funcionou bem ✅
+1. **Reprodução rápida:** Bug reproduzido em 15 minutos
+2. **Isolamento eficiente:** Binary search levou ao componente em 30 min
+3. **5 Whys efetivo:** Causa raiz identificada corretamente
+4. **Comunicação clara:** Stakeholders informados em tempo real
+5. **Deploy rápido:** Fix em produção em 2 horas
+
+### O que pode melhorar ⚠️
+1. **Testes de edge cases:** Deveriam ter detectado isso antes
+2. **Configuração inicial:** Timezone deveria ser no setup
+3. **Monitoring proativo:** Alertas deveriam ter disparado antes
+4. **Documentação:** Setup guide não mencionava timezone
+5. **Code review:** Checklist deveria incluir validação de null
+
+### Surpresas 🤔
+1. **Volume de usuários afetados:** Esperávamos menos
+2. **Tempo de detecção:** 5 dias até primeiro report
+3. **Simplicidade do fix:** 1 linha de código resolveu
+
+---
+
+## 🔄 Prevention Measures
+
+### Immediate Actions (Já Implementadas)
+- ✅ Fix deployado em produção
+- ✅ Regression test criado
+- ✅ Monitoring configurado
+- ✅ Documentação atualizada
+
+### Short-term Prevention
+- Linter rule para detectar `.map()` sem validação
+- Checklist de timezone para novos serviços
+- Testes de edge cases obrigatórios
+
+### Long-term Prevention
+- Chaos engineering para testar edge cases
+- Runbooks para incidentes comuns
+- Training sobre debugging sistemático
+
+---
+
+## 📞 Stakeholders
+
+### Equipe de Resolução
+- **Incident Commander:** @oncall-lead
+- **Engineering Lead:** @eng-manager
+- **Developer:** @dev1
+- **QA:** @qa1
+- **DevOps:** @devops1
+
+### Comunicação
+- **Support Team:** Notificado às 12:05
+- **Product Manager:** Notificado às 12:30
+- **CTO:** Notificado às 13:00
+- **Usuários:** Notificados às 14:30
+
+---
+
+## ✅ Sign-off
+
+### Aprovações
+- [ ] **Engineering Lead:** @eng-manager
+- [ ] **Product Manager:** @pm
+- [ ] **CTO:** @cto
+- [ ] **Support Lead:** @support-manager
+
+### Publicação
+- [ ] Post-mortem revisado pela equipe
+- [ ] Action items atribuídos
+- [ ] Documentação atualizada
+- [ ] Lessons learned compartilhadas
+- [ ] Post-mortem publicado no wiki
+
+---
+
+**Autor:** [Nome]  
+**Data de Criação:** YYYY-MM-DD  
+**Última Atualização:** YYYY-MM-DD  
+**Status:** [Draft | Under Review | Published]

package/dist/content/skills/specialist-debugging-troubleshooting/scripts/README.md

@@ -0,0 +1,64 @@
+# Scripts MCP de Referência - Debugging e Troubleshooting
+
+Este diretório contém **funções de referência** para implementação no MCP.
+
+> **IMPORTANTE**: Estes scripts são **APENAS REFERÊNCIA** e **NÃO SÃO EXECUTÁVEIS** localmente.
+> Toda a lógica deve ser implementada no MCP externo.
+
+## 📋 Funções Disponíveis
+
+### 1. `init_debugging.py`
+Inicializa bug report estruturado com template padrão.
+
+**Responsabilidade do MCP:**
+- Criar diretório `docs/bugs/`
+- Gerar bug report a partir do template
+- Salvar arquivo `docs/bugs/BUG-XXX.md`
+- Retornar caminho do arquivo criado
+
+### 2. `validate_fix.py`
+Valida qualidade do processo de debugging.
+
+**Responsabilidade do MCP:**
+- Ler bug report
+- Aplicar checklist de validação (100 pontos)
+- Calcular score por fase (Reproduce, Isolate, Understand, Fix)
+- Gerar feedback detalhado
+- Retornar score e status
+
+### 3. `process_postmortem.py`
+Processa post-mortem e lessons learned.
+
+**Responsabilidade do MCP:**
+- Ler bug report validado
+- Gerar post-mortem a partir do template
+- Extrair lessons learned
+- Criar action items
+- Salvar documentação completa
+
+## 🔧 Implementação no MCP
+
+Consulte `MCP_INTEGRATION.md` para detalhes completos de implementação.
+
+### Exemplo de Chamada
+```python
+# No MCP
+result = await mcp.call_function("initialize_bug_report", {
+    "bug_id": "BUG-001",
+    "severity": "alta",
+    "description": "Login falha com erro 401"
+})
+```
+
+## 📚 Documentação
+
+- **Guia de Integração:** `../MCP_INTEGRATION.md`
+- **Templates:** `../resources/templates/`
+- **Exemplos:** `../resources/examples/`
+- **Validação:** `../resources/checklists/`
+
+---
+
+**Versão:** 1.0  
+**Status:** Referência (Não Executável)  
+**Implementação:** MCP Externo

package/dist/content/skills/specialist-desenvolvimento-backend/MCP_INTEGRATION.md

@@ -0,0 +1,98 @@
+# Integração MCP - Desenvolvimento Backend
+
+**Versão:** 2.0  
+**Última Atualização:** 31/01/2026
+
+---
+
+## 🤖 Funções MCP Disponíveis
+
+### **1. init_backend_implementation**
+
+**Propósito:** Inicializar estrutura backend a partir do contrato API
+
+**Input:**
+```typescript
+{
+  contratoAPI: string;
+  modeloDominio: string;
+  historiaBackend: string;
+  stack: string;  // "NestJS", "Express", etc.
+}
+```
+
+**Output:**
+```typescript
+{
+  dtos: string[];
+  entities: string[];
+  services: string[];
+  controllers: string[];
+  repositories: string[];
+  tests: string[];
+}
+```
+
+---
+
+### **2. validate_backend_quality**
+
+**Propósito:** Validar qualidade do código backend
+
+**Input:**
+```typescript
+{
+  sourceCode: string[];
+  tests: string[];
+}
+```
+
+**Output:**
+```typescript
+{
+  score: number;  // 0-100
+  aprovado: boolean;
+  detalhes: {
+    arquitetura: { score: number; };
+    implementacao: { score: number; };
+    testes: { score: number; };
+    seguranca: { score: number; };
+  };
+}
+```
+
+**Checklist (100 pontos):**
+- Arquitetura (25 pts): Clean Architecture, SOLID
+- Implementação (30 pts): Endpoints, lógica, validação
+- Testes (25 pts): Coverage >80%, integração
+- Segurança (20 pts): Auth, sanitização, SQL injection
+
+---
+
+### **3. process_backend_to_integration**
+
+**Propósito:** Preparar backend para integração com frontend
+
+**Input:**
+```typescript
+{
+  implementacao: string[];
+  validacao: ValidationResult;
+}
+```
+
+**Output:**
+```typescript
+{
+  swaggerDocs: string;
+  proximaFase: {
+    nome: "Integração Frontend ↔ Backend";
+    artefatos: string[];
+  };
+}
+```
+
+---
+
+**Score Mínimo:** 75/100  
+**Arquitetura:** Skill Descritiva + Automação MCP

package/dist/content/skills/specialist-desenvolvimento-backend/README.md

@@ -0,0 +1,167 @@
+# Especialista em Desenvolvimento Backend
+
+**Versão:** 2.0  
+**Última Atualização:** 31/01/2026  
+**Status:** ✅ Estrutura Moderna Completa
+
+---
+
+## 📋 Visão Geral
+
+Especialista em implementar lógica de negócio, APIs RESTful, serviços, repositórios e integração com banco de dados seguindo Clean Architecture e SOLID principles, com foco em qualidade, testes e segurança.
+
+### **Quando Usar**
+
+- **Fase:** Fase 9 - Desenvolvimento Backend
+- **Após:** Contrato de API definido
+- **Antes:** Integração Frontend ↔ Backend
+- **Workflows:** `/implementar-historia`, `/refatorar-codigo`
+
+### **Valor Entregue**
+
+- Endpoints implementados conforme contrato OpenAPI
+- Lógica de negócio com SOLID principles
+- Camadas bem definidas (Controller, Service, Repository)
+- Validação de entrada robusta
+- Error handling consistente
+- Testes unitários e de integração
+- Segurança implementada (auth, sanitização)
+
+---
+
+## 📥 Artefatos de Entrada
+
+| Artefato | Localização | Obrigatório |
+|----------|-------------|-------------|
+| **Contrato API** | `docs/09-api/contrato-api.md` | ✅ Sim |
+| **OpenAPI YAML** | `docs/09-api/openapi.yaml` | ✅ Sim |
+| **Modelo de Domínio** | `docs/04-modelo/modelo-dominio.md` | ✅ Sim |
+| **Arquitetura** | `docs/06-arquitetura/arquitetura.md` | ✅ Sim |
+| **História Backend** | `docs/08-backlog/features/BE-*.md` | ✅ Sim |
+
+---
+
+## 📤 Artefatos de Saída
+
+| Artefato | Localização | Descrição |
+|----------|-------------|-----------|
+| **Controllers** | `src/controllers/` | Endpoints HTTP |
+| **Services** | `src/services/` | Lógica de negócio |
+| **Repositories** | `src/repositories/` | Acesso a dados |
+| **DTOs** | `src/dtos/` | Data Transfer Objects |
+| **Entities** | `src/entities/` | Modelos de domínio |
+| **Tests** | `src/**/*.spec.ts` | Testes unitários e integração |
+
+---
+
+## 🎯 Processo de Implementação
+
+### **1. Criar DTOs**
+- CreateXxxDto (validação com class-validator)
+- UpdateXxxDto (campos opcionais)
+- XxxResponseDto (formato de saída)
+
+### **2. Criar Entity e Repository**
+- Entity com decorators ORM
+- Repository com métodos CRUD
+- Queries otimizadas
+
+### **3. Implementar Service**
+- Lógica de negócio
+- Validações de regras
+- Tratamento de erros
+
+### **4. Implementar Controller**
+- Rotas HTTP
+- Validação de entrada
+- Documentação Swagger
+
+### **5. Criar Testes**
+- Testes unitários (Jest)
+- Testes de integração (Supertest)
+- Coverage > 80%
+
+---
+
+## ✅ Quality Gates
+
+### **Checklist Obrigatório (Score Mínimo: 75/100)**
+
+**Arquitetura (25 pontos):**
+- [ ] Clean Architecture implementada
+- [ ] SOLID principles seguidos
+- [ ] Dependency Injection configurada
+
+**Implementação (30 pontos):**
+- [ ] Endpoints conforme contrato
+- [ ] Lógica de negócio implementada
+- [ ] Validação de entrada (DTOs)
+- [ ] Error handling robusto
+
+**Testes (25 pontos):**
+- [ ] Testes unitários (>80% coverage)
+- [ ] Testes de integração passando
+- [ ] Edge cases cobertos
+
+**Segurança (20 pontos):**
+- [ ] Autenticação implementada
+- [ ] Autorização por roles
+- [ ] Sanitização de entrada
+- [ ] SQL injection prevenido
+
+---
+
+## 🔄 Context Flow
+
+### **Entrada desta Fase**
+- Contrato API aprovado (Contrato de API)
+- Modelo de domínio definido (Modelagem de Domínio)
+- História backend pronta (Plano de Execução)
+
+### **Saída para Próxima Fase**
+- Backend implementado e testado
+- Endpoints prontos para integração
+- Documentação Swagger atualizada
+
+---
+
+## 📚 Estrutura de Recursos
+
+### **Templates** (`resources/templates/`)
+- `historia-backend.md` - Template de história
+- `service-layer.md` - Template de service
+- `repository-pattern.md` - Template de repository
+
+### **Examples** (`resources/examples/`)
+- CRUD completo (NestJS)
+- Authentication service
+- Payment integration
+- Background jobs
+- Caching layer
+
+### **Checklists** (`resources/checklists/`)
+- Validação backend (100+ pontos)
+- Clean Architecture
+- SOLID principles
+
+### **Reference** (`resources/reference/`)
+- NestJS best practices
+- Clean Architecture guide
+- Testing strategies
+- Security hardening
+
+---
+
+## 🤖 Funções MCP
+
+1. **init_backend_implementation** - Inicializar estrutura backend
+2. **validate_backend_quality** - Validar código e testes
+3. **process_backend_to_integration** - Preparar para integração
+
+Ver `MCP_INTEGRATION.md` para detalhes.
+
+---
+
+**Versão:** 2.0  
+**Framework:** Skills Modernas com Progressive Disclosure  
+**Arquitetura:** Skill Descritiva + Automação MCP