@maestro-ai/mcp-server 1.2.0 → 2.1.0

package/dist/content/skills/specialist-migracao-modernizacao/SKILL.md

@@ -0,0 +1,485 @@
+---
+name: specialist-migracao-modernizacao
+description: Planejamento Strangler Fig, migrações de dados e rollback seguro.
+allowed-tools: Read, Write, Edit, Glob, Grep
+---
+
+# Migração e Modernização · Skill do Especialista
+
+## Missão
+Guiar transformações de legados com riscos controlados, aplicando Strangler Fig pattern, migração de dados e rollback seguro para modernização progressiva.
+
+## Quando ativar
+- Fase: Especialista Avançado
+- Workflows recomendados: /refatorar-codigo, /maestro
+- Use quando um sistema legado precisa ser substituído em ondas.
+
+## Inputs obrigatórios
+- Documentação do sistema legado
+- Mapeamento do legado
+- Arquitetura alvo
+- Planos de dados e cutover
+- CONTEXTO.md do projeto
+
+## Outputs gerados
+- Plano de migração completo
+- Mapeamento Strangler e matriz de riscos
+- Análise de débito técnico
+- Roadmap de modernização
+- ADRs de decisão
+- Estratégia de rollback
+
+## Quality Gate
+- Plano de rollback definido
+- Fases e milestones claros
+- Riscos mitigados
+- Coexistência planejada
+- Métricas de sucesso definidas
+
+## Estratégias de Migração
+
+### 1. Strangler Fig Pattern
+```text
+Sistema atual: [MONOLITO LEGADO]
+Sistema alvo: [MICROSSERVIÇOS/NOVA ARQUITETURA]
+
+Aplicação do Strangler Fig:
+1. **Identificar Edge Points:**
+   - APIs de entrada
+   - Interfaces de usuário
+   - Integrações externas
+
+2. **Priorizar Funcionalidades:**
+   - Baixo risco, alto valor
+   - Independentes
+   - Fácil de isolar
+
+3. **Implementar Façade:**
+   - Proxy para redirecionamento
+   - Feature toggles
+   - Monitoramento de performance
+
+4. **Migração Progressiva:**
+   - Extração incremental
+   - Testes de paralelismo
+   - Rollback por etapa
+```
+
+### 2. Branch by Abstraction
+```text
+Componente a substituir: [NOME]
+Nova implementação: [DESCRIÇÃO]
+
+Etapas do Branch by Abstraction:
+1. **Criar Abstração:**
+   - Interface/contract
+   - Implementação atual
+   - Configuração de toggle
+
+2. **Migrar Consumidores:**
+   - Atualizar dependências
+   - Testar compatibilidade
+   - Monitorar comportamento
+
+3. **Implementar Nova Versão:**
+   - Seguir mesmo contrato
+   - Testes de equivalência
+   - Performance comparativa
+
+4. **Switch Gradual:**
+   - Toggle por feature
+   - Monitoramento em tempo real
+   - Rollback automático
+```
+
+### 3. Parallel Run
+```text
+Executar sistemas em paralelo:
+- Legado: 100% do tráfego
+- Novo: 0% do tráfego
+
+Gradualmente:
+- Semana 1: 5% tráfego novo
+- Semana 2: 20% tráfego novo
+- Semana 3: 50% tráfego novo
+- Semana 4: 100% tráfego novo
+
+Métricas de comparação:
+- Performance
+- Consistência de dados
+- Taxa de erros
+- Satisfação do usuário
+```
+
+## Análise do Sistema Legado
+
+### 1. Mapeamento de Dependências
+```text
+Sistema: [NOME]
+Idade: [ANOS EM PRODUÇÃO]
+Stack: [TECNOLOGIAS]
+Tamanho: [LOC, MÓDULOS]
+Time: [PESSOAS]
+Criticidade: [ALTA/MÉDIA/BAIXA]
+
+Análise de Risco:
+- **Risco Técnico:** [1-10]
+- **Risco de Negócio:** [1-10]
+- **Complexidade:** [1-10]
+- **Impacto da Falha:** [1-10]
+
+Dependências Críticas:
+- [Dependência 1]: [Impacto se falhar]
+- [Dependência 2]: [Impacto se falhar]
+- [Dependência 3]: [Impacto se falhar]
+```
+
+### 2. Avaliação de Débito Técnico
+```text
+Qualidade do Código:
+- Testes existentes: [% cobertura]
+- Padrões arquiteturais: [sim/não/parcial]
+- Documentação: [completa/inexistente/parcial]
+- Complexidade ciclomática: [média]
+
+Infraestrutura:
+- Dependências desatualizadas: [lista]
+- Vulnerabilidades críticas: [quantidade]
+- Performance: [problemas identificados]
+- Deploy: [processo atual]
+
+Conhecimento:
+- Documentação técnica: [status]
+- Conhecimento tácito: [risco]
+- Time de manutenção: [experiência]
+- Rotatividade: [taxa anual]
+```
+
+## Processo de Migração
+
+### Fase 1: Descoberta e Análise
+```text
+1. **Mapeamento Completo:**
+   - Arquitetura atual
+   - Dependências externas
+   - Fluxos de negócio
+   - Dados críticos
+
+2. **Análise de Risco:**
+   - Identificar blockers
+   - Avaliar complexidade
+   - Estimar esforço
+   - Definir timeline
+
+3. **Validação de Negócio:**
+   - Stakeholders alinhados
+   - ROI justificado
+   - Success criteria definidos
+   - Budget aprovado
+```
+
+### Fase 2: Planejamento Estratégico
+```text
+1. **Definir Arquitetura Alvo:**
+   - Stack tecnológico
+   - Padrões arquiteturais
+   - Estratégia de dados
+   - Infraestrutura
+
+2. **Criar Roadmap:**
+   - Fases e milestones
+   - Dependências entre fases
+   - Pontos de decisão
+   - Critérios de sucesso
+
+3. **Planejar Coexistência:**
+   - APIs de integração
+   - Sincronização de dados
+   - Monitoramento
+   - Rollback procedures
+```
+
+### Fase 3: Implementação
+```text
+1. **Setup Inicial:**
+   - Infraestrutura base
+   - Pipelines de CI/CD
+   - Monitoramento
+   - Logging
+
+2. **Migração Incremental:**
+   - Funcionalidade por funcionalidade
+   - Testes automatizados
+   - Validção em staging
+   - Deploy controlado
+
+3. **Monitoramento Contínuo:**
+   - Métricas de performance
+   - Taxa de erros
+   - Satisfação do usuário
+   - Business metrics
+```
+
+### Fase 4: Cutover e Decomissionamento
+```text
+1. **Cutover Planejado:**
+   - Janela de manutenção
+   - Backup completo
+   - Testes de validação
+   - Plano de rollback
+
+2. **Monitoramento Pós-Cutover:**
+   - Alertas críticas
+   - Equipe de prontidão
+   - Documentação de incidentes
+   - Lições aprendidas
+
+3. **Decomissionamento:**
+   - Backup final
+   - Remoção de recursos
+   - Documentação histórica
+   - Comemoração do sucesso!
+```
+
+## Estratégias de Migração de Dados
+
+### 1. Change Data Capture (CDC)
+```text
+Fonte: [BANCO ORIGEM]
+Destino: [BANCO DESTINO]
+
+Implementação CDC:
+1. **Setup do CDC:**
+   - Ferramenta: [Debezium/CDC nativo]
+   - Tabelas críticas mapeadas
+   - Schema evolution
+   - Error handling
+
+2. **Sincronização Inicial:**
+   - Full load baseline
+   - Validação de dados
+   - Performance tuning
+   - Monitoramento de lag
+
+3. **Cutover de Dados:**
+   - Stop-the-world mínimo
+   - Validação final
+   - Switch de aplicação
+   - Monitoramento pós-cutover
+```
+
+### 2. Dual Write Pattern
+```text
+Escrita simultânea em ambos os bancos:
+
+1. **Implementação:**
+   - Transaction outbox
+   - Eventual consistency
+   - Reconciliation jobs
+   - Conflict resolution
+
+2. **Validação:**
+   - Comparação periódica
+   - Alertas de divergência
+   - Manual reconciliation
+   - Audit trails
+
+3. **Cutover:**
+   - Parar escrita no legado
+   - Validar consistência final
+   - Promover novo sistema
+   - Retirar dual write
+```
+
+## Templates Prontos
+
+### Migration Plan Template
+```markdown
+# Migration Plan: [System Name]
+
+## Executive Summary
+- **Current System:** [description]
+- **Target System:** [description]
+- **Timeline:** [duration]
+- **Budget:** [amount]
+- **ROI:** [expected return]
+
+## Current State Analysis
+### System Overview
+- **Age:** [years]
+- **Technology Stack:** [list]
+- **Team Size:** [people]
+- **Criticality:** [level]
+
+### Technical Debt
+- **Code Quality:** [assessment]
+- **Dependencies:** [outdated count]
+- **Security Issues:** [count]
+- **Performance Issues:** [list]
+
+## Migration Strategy
+### Approach
+- **Pattern:** [Strangler Fig/Branch by Abstraction]
+- **Phases:** [number]
+- **Duration:** [timeline]
+- **Risk Level:** [assessment]
+
+### Phases
+#### Phase 1: [Name] - [Duration]
+- **Objectives:** [list]
+- **Deliverables:** [list]
+- **Risks:** [list]
+- **Success Criteria:** [list]
+
+#### Phase 2: [Name] - [Duration]
+- **Objectives:** [list]
+- **Deliverables:** [list]
+- **Risks:** [list]
+- **Success Criteria:** [list]
+
+## Data Migration
+### Strategy
+- **Approach:** [CDC/Dual Write/Big Bang]
+- **Tools:** [list]
+- **Validation:** [method]
+- **Rollback:** [procedure]
+
+### Data Mapping
+| Source | Target | Transformation |
+|--------|--------|----------------|
+| [table] | [table] | [description] |
+| [table] | [table] | [description] |
+
+## Risk Management
+### High Risks
+1. **[Risk Name]**
+   - **Impact:** [description]
+   - **Probability:** [high/medium/low]
+   - **Mitigation:** [strategy]
+
+### Rollback Plan
+- **Trigger Conditions:** [list]
+- **Rollback Steps:** [list]
+- **Rollback Time:** [duration]
+- **Data Recovery:** [method]
+
+## Success Metrics
+### Technical Metrics
+- **Performance:** [targets]
+- **Availability:** [targets]
+- **Error Rate:** [targets]
+- **Data Quality:** [targets]
+
+### Business Metrics
+- **User Satisfaction:** [target]
+- **Cost Reduction:** [target]
+- **Time to Market:** [target]
+- **Revenue Impact:** [target]
+
+## Timeline
+| Phase | Start | End | Duration | Status |
+|-------|-------|-----|----------|--------|
+| [Phase 1] | [date] | [date] | [weeks] | [status] |
+| [Phase 2] | [date] | [date] | [weeks] | [status] |
+| [Phase 3] | [date] | [date] | [weeks] | [status] |
+```
+
+### Risk Assessment Matrix
+```markdown
+# Risk Assessment Matrix
+
+| Risk | Impact | Probability | Risk Score | Mitigation |
+|-------|---------|-------------|------------|------------|
+| **Data Loss** | Critical | Low | 3 | Daily backups, CDC validation |
+| **Performance Degradation** | High | Medium | 6 | Load testing, monitoring |
+| **Team Knowledge Gap** | Medium | High | 6 | Training, documentation |
+| **Vendor Lock-in** | Medium | Low | 2 | Open source alternatives |
+| **Security Breach** | Critical | Low | 3 | Security audit, penetration testing |
+
+### Risk Scoring
+- **1-3:** Low risk - Accept
+- **4-6:** Medium risk - Mitigate
+- **7-9:** High risk - Avoid or transfer
+```
+
+## Guardrails Críticos
+
+### NUNCA Faça
+- **NUNCA** migre sem backup completo
+- **NUNCA** ignore rollback procedures
+- **NUNCA** pule testes de paralelismo
+- **NUNCA** migre sem validação de dados
+
+### SEMPRE Faça
+- **SEMPRE** tenha plano de rollback
+- **SEMPRE** teste em staging primeiro
+- **SEMPRE** monitore em tempo real
+- **SEMPRE** documente cada passo
+
+## Context Flow
+
+### Artefatos Obrigatórios para Iniciar
+Cole no início:
+1. Documentação completa do sistema legado
+2. Arquitetura alvo definida
+3. Requisitos de negócio atuais
+4. CONTEXTO.md com restrições
+5. Análise de risco inicial
+
+### Prompt de Continuação
+```
+Atue como Arquiteto especialista em migração e modernização de sistemas.
+
+Contexto do projeto:
+[COLE docs/CONTEXTO.md]
+
+Sistema legado atual:
+[DESCREVA O SISTEMA ATUAL]
+
+Objetivo da modernização:
+[DESCREVA O QUE QUER ALCANÇAR]
+
+Preciso planejar a migração de [SISTEMA] para [NOVA ARQUITETURA] com risco controlado.
+```
+
+### Ao Concluir Esta Fase
+1. **Analise** sistema legado completamente
+2. **Planeje** estratégia de migração
+3. **Defina** fases e milestones
+4. **Implemente** coexistência segura
+5. **Execute** cutover controlado
+6. **Monitore** pós-migração
+7. **Documente** lições aprendidas
+
+## Métricas de Qualidade
+
+### Indicadores Obrigatórios
+- **Migration Success Rate:** 100%
+- **Data Integrity:** 100%
+- **Downtime:** < 4 horas
+- **Rollback Success:** 100%
+- **User Satisfaction:** > 4.0/5
+
+### Metas de Excelência
+- Migration Success Rate: 100%
+- Data Integrity: 100%
+- Downtime: < 1 hora
+- Rollback Success: 100%
+- User Satisfaction: > 4.5/5
+
+## Skills complementares
+- `clean-code`
+- `database-design`
+- `deployment-procedures`
+- `systematic-debugging`
+- `architecture-patterns`
+
+## Referências essenciais
+- **Especialista original:** `content/specialists/Especialista em Migração e Modernização.md`
+- **Artefatos alvo:**
+  - Plano de migração completo
+  - Mapeamento Strangler e matriz de riscos
+  - Análise de débito técnico
+  - Roadmap de modernização
+  - ADRs de decisão
+  - Estratégia de rollback

package/dist/content/skills/specialist-migracao-modernizacao/mcp_functions/README.md

@@ -0,0 +1,10 @@
+# Funções MCP - Migração
+
+Referências para implementação no MCP.
+
+## Funções
+1. analyze_legacy_system
+2. create_migration_plan
+3. validate_migration
+
+Ver `MCP_INTEGRATION.md`.

package/dist/content/skills/specialist-migracao-modernizacao/resources/checklists/migration-validation.md

@@ -0,0 +1,23 @@
+# Checklist - Migração
+
+**Score Mínimo:** 75/100
+
+## Análise de Impacto (25 pts)
+- [ ] **[10 pts]** Código legado analisado
+- [ ] **[8 pts]** Dependências mapeadas
+- [ ] **[7 pts]** Riscos identificados
+
+## Estratégia de Migração (25 pts)
+- [ ] **[10 pts]** Fases definidas
+- [ ] **[8 pts]** Timeline realista
+- [ ] **[7 pts]** Feature flags configuradas
+
+## Testes de Regressão (25 pts)
+- [ ] **[10 pts]** Testes existentes passando
+- [ ] **[8 pts]** Novos testes criados
+- [ ] **[7 pts]** Coverage mantido
+
+## Rollback Plan (25 pts)
+- [ ] **[10 pts]** Estratégia de rollback
+- [ ] **[8 pts]** Backup de dados
+- [ ] **[7 pts]** Monitoramento configurado

package/dist/content/skills/specialist-migracao-modernizacao/resources/examples/migration-examples.md

@@ -0,0 +1,30 @@
+# Exemplos - Migração
+
+## Strangler Fig Pattern
+```typescript
+// Legacy route
+app.get('/old-api/users', legacyHandler);
+
+// New route (parallel)
+app.get('/api/v2/users', newHandler);
+
+// Gradual migration with feature flag
+app.get('/users', (req, res) => {
+  if (featureFlags.newAPI) {
+    return newHandler(req, res);
+  }
+  return legacyHandler(req, res);
+});
+```
+
+## Database Migration
+```sql
+-- Phase 1: Add new column
+ALTER TABLE users ADD COLUMN email_verified BOOLEAN DEFAULT FALSE;
+
+-- Phase 2: Migrate data
+UPDATE users SET email_verified = TRUE WHERE verified_at IS NOT NULL;
+
+-- Phase 3: Remove old column
+ALTER TABLE users DROP COLUMN verified_at;
+```

package/dist/content/skills/specialist-migracao-modernizacao/resources/reference/migration-guide.md

@@ -0,0 +1,27 @@
+# Guia - Migração
+
+## Estratégias
+
+### Strangler Fig
+Substituir gradualmente funcionalidades do sistema legado
+
+### Big Bang
+Migração completa de uma vez (alto risco)
+
+### Parallel Run
+Executar ambos sistemas em paralelo
+
+## Fases Típicas
+1. Análise do sistema legado
+2. Criação do plano de migração
+3. Setup do novo ambiente
+4. Migração incremental
+5. Testes de regressão
+6. Cutover
+7. Descomissionamento do legado
+
+## Riscos Comuns
+- Perda de dados
+- Downtime prolongado
+- Funcionalidades quebradas
+- Performance degradada