@maestro-ai/mcp-server 1.2.0 → 2.1.0

package/dist/content/skills/specialist-exploracao-codebase/resources/reference/exploration-guide.md

@@ -0,0 +1,111 @@
+# Guia Completo - Exploração de Codebase
+
+## 📋 Introdução
+
+Guia completo para análise sistemática de codebases existentes.
+
+---
+
+## 🔍 Técnicas de Análise
+
+### 1. Análise Estrutural
+- Mapeamento de diretórios
+- Identificação de entry points
+- Detecção de padrões arquiteturais
+
+### 2. Análise de Qualidade
+- Complexidade ciclomática
+- Duplicação de código
+- Cobertura de testes
+
+### 3. Análise de Dependências
+- Dependências desatualizadas
+- Vulnerabilidades conhecidas
+- Dependências circulares
+
+---
+
+## 🛠️ Ferramentas Recomendadas
+
+### Análise de Código
+```bash
+# Métricas básicas
+cloc .                    # Lines of code
+lizard src/               # Complexidade
+jscpd src/                # Duplicação
+
+# Visualização
+madge --circular src/     # Dependências circulares
+```
+
+### Dependências
+```bash
+# Node.js
+npm outdated              # Dependências desatualizadas
+npm audit                 # Vulnerabilidades
+
+# Python
+pip list --outdated       # Dependências desatualizadas
+pip-audit                 # Vulnerabilidades
+```
+
+---
+
+## 📊 Padrões Arquiteturais Comuns
+
+### MVC (Model-View-Controller)
+- **Estrutura:** models/, views/, controllers/
+- **Características:** Separação clara de responsabilidades
+
+### Clean Architecture
+- **Estrutura:** domain/, application/, infrastructure/
+- **Características:** Independência de frameworks
+
+### Microserviços
+- **Estrutura:** services/, shared/
+- **Características:** Serviços independentes
+
+---
+
+## 🚨 Code Smells Comuns
+
+### 1. Complexidade Alta
+- **Threshold:** Complexidade > 10
+- **Ação:** Refatorar em funções menores
+
+### 2. Duplicação
+- **Threshold:** Duplicação > 5%
+- **Ação:** Extrair código comum
+
+### 3. Baixa Cobertura
+- **Threshold:** Coverage < 70%
+- **Ação:** Adicionar testes
+
+---
+
+## 📈 Cálculo de Dívida Técnica
+
+### Fórmula
+```
+Debt = (Code Smells × 0.5) + (Complexity × 0.3) + (Duplication × 0.2)
+```
+
+### Classificação
+- **0-30:** Baixo
+- **31-60:** Médio
+- **61-100:** Alto
+
+---
+
+## 🔧 Troubleshooting
+
+### Problema: Codebase muito grande
+**Solução:** Analisar por módulos
+
+### Problema: Múltiplas linguagens
+**Solução:** Usar ferramentas multi-linguagem (cloc, SonarQube)
+
+---
+
+**Versão:** 1.0.0  
+**Última Atualização:** 30/01/2026

package/dist/content/skills/specialist-exploracao-codebase/resources/templates/codebase-map.md

@@ -0,0 +1,129 @@
+# Codebase Map - [Nome do Projeto]
+
+## 📋 Informações Gerais
+
+**Data de Análise:** [DD/MM/AAAA]  
+**Versão:** 1.0  
+**Analisado por:** [Nome]  
+**Status:** [ ] Em Análise [ ] Concluído [ ] Aprovado
+
+---
+
+## 🎯 Visão Geral
+
+**Tipo:** [ ] Monolito [ ] Microserviços [ ] Híbrido  
+**Stack Principal:** [Tecnologias principais]  
+**Ano de Criação:** [Ano]  
+**Equipe Atual:** [Tamanho da equipe]  
+**Manutenção:** [ ] Ativa [ ] Parada [ ] Legada
+
+---
+
+## 💻 Stack Tecnológico
+
+### Frontend
+- **Framework:** [React/Vue/Angular/etc]
+- **Linguagem:** [JavaScript/TypeScript/etc]
+- **Build Tool:** [Webpack/Vite/etc]
+- **CSS Framework:** [Tailwind/Bootstrap/etc]
+- **State Management:** [Redux/Vuex/etc]
+
+### Backend
+- **Framework:** [Laravel/Django/Spring/etc]
+- **Linguagem:** [PHP/Python/Java/etc]
+- **Banco de Dados:** [MySQL/PostgreSQL/etc]
+- **Cache:** [Redis/Memcached/etc]
+- **Queue:** [Redis/SQS/etc]
+
+### Infraestrutura
+- **Cloud:** [AWS/Azure/GCP/On-premise]
+- **Containerização:** [Docker/Kubernetes]
+- **CI/CD:** [GitHub Actions/Jenkins/etc]
+- **Monitoramento:** [Datadog/New Relic/etc]
+
+---
+
+## 📁 Estrutura de Diretórios
+
+```
+src/
+├── controllers/          # [Descrição]
+├── services/            # [Descrição]
+├── models/              # [Descrição]
+├── views/               # [Descrição]
+├── utils/               # [Descrição]
+├── tests/               # [Descrição]
+├── config/              # [Descrição]
+└── docs/                # [Descrição]
+```
+
+---
+
+## 🚪 Entry Points
+
+- **Principal:** [arquivo principal]
+- **API:** [entry point da API]
+- **Frontend:** [entry point do frontend]
+- **CLI:** [scripts de linha de comando]
+- **Worker:** [background jobs]
+
+---
+
+## 🏗️ Padrões Identificados
+
+**Arquitetural:** [MVC/Clean/Hexagonal/etc]  
+**Design Patterns:** [Repository/Service/Factory/etc]  
+**Code Patterns:** [Singleton/Observer/etc]
+
+---
+
+## 📊 Métricas de Qualidade
+
+- **Total LOC:** [número]
+- **Complexidade Média:** [valor]
+- **Test Coverage:** [percentual]
+- **Code Duplication:** [percentual]
+
+---
+
+## 🔴 Débito Técnico
+
+### Críticos (Ação Imediata)
+- [ ] [Descrição do débito crítico]
+- [ ] [Localização no código]
+
+### Médios (Planejar)
+- [ ] [Descrição do débito médio]
+
+### Baixos (Monitorar)
+- [ ] [Descrição do débito baixo]
+
+---
+
+## ⚠️ Riscos Identificados
+
+### 🔴 Críticos
+- **Segurança:** [descrição]
+- **Performance:** [descrição]
+
+### 🟡 Médios
+- **Tecnologia:** [descrição]
+
+---
+
+## 💡 Recomendações Priorizadas
+
+### 1. Imediato (1-2 semanas)
+- [ ] [Ação 1 crítica]
+- [ ] [Ação 2 crítica]
+
+### 2. Curto Prazo (1 mês)
+- [ ] [Ação 1 média]
+
+### 3. Médio Prazo (2-3 meses)
+- [ ] [Ação 1 baixa]
+
+---
+
+**Versão do Template:** 1.0.0  
+**Última Atualização:** 30/01/2026

package/dist/content/skills/specialist-exploracao-codebase/resources/templates/refactoring-plan.md

@@ -0,0 +1,96 @@
+# Refactoring Plan - [Nome do Projeto]
+
+## 📋 Visão Geral
+
+**Data:** [DD/MM/AAAA]  
+**Duração Estimada:** [X semanas]  
+**Esforço Total:** [X dias-homem]  
+**Prioridade:** [ ] Alta [ ] Média [ ] Baixa
+
+---
+
+## 🎯 Objetivos
+
+1. [Objetivo 1]
+2. [Objetivo 2]
+3. [Objetivo 3]
+
+---
+
+## 📊 Situação Atual
+
+**Score de Qualidade:** [X/100]  
+**Principais Problemas:**
+- [Problema 1]
+- [Problema 2]
+- [Problema 3]
+
+---
+
+## 🔄 Fases de Refatoração
+
+### Fase 1: [Nome da Fase] (Semanas 1-2)
+
+**Objetivo:** [Descrição]
+
+**Ações:**
+- [ ] [Ação 1]
+- [ ] [Ação 2]
+- [ ] [Ação 3]
+
+**Impacto Esperado:**
+- [Métrica 1]: [Antes] → [Depois]
+- [Métrica 2]: [Antes] → [Depois]
+
+**Riscos:**
+- [Risco 1]
+- [Risco 2]
+
+---
+
+### Fase 2: [Nome da Fase] (Semanas 3-4)
+
+**Objetivo:** [Descrição]
+
+**Ações:**
+- [ ] [Ação 1]
+- [ ] [Ação 2]
+
+**Impacto Esperado:**
+- [Métrica 1]: [Antes] → [Depois]
+
+---
+
+### Fase 3: [Nome da Fase] (Semanas 5-6)
+
+**Objetivo:** [Descrição]
+
+**Ações:**
+- [ ] [Ação 1]
+- [ ] [Ação 2]
+
+---
+
+## ✅ Critérios de Sucesso
+
+- [ ] Score de qualidade ≥ 80
+- [ ] Test coverage ≥ 80%
+- [ ] Complexidade média ≤ 8
+- [ ] Duplicação ≤ 3%
+- [ ] Zero vulnerabilidades críticas
+
+---
+
+## 📈 Métricas de Acompanhamento
+
+| Métrica | Atual | Meta | Status |
+|---------|-------|------|--------|
+| Score | [X] | [Y] | [ ] |
+| Coverage | [X%] | [Y%] | [ ] |
+| Complexidade | [X] | [Y] | [ ] |
+| Duplicação | [X%] | [Y%] | [ ] |
+
+---
+
+**Versão do Template:** 1.0.0  
+**Última Atualização:** 30/01/2026

package/dist/content/skills/specialist-exploracao-codebase/resources/templates/technical-debt-report.md

@@ -0,0 +1,69 @@
+# Technical Debt Report - [Nome do Projeto]
+
+## 📋 Resumo Executivo
+
+**Data:** [DD/MM/AAAA]  
+**Débito Total:** [X dias-homem]  
+**Score de Qualidade:** [X/100]  
+**Risco Crítico:** [ ] Sim [ ] Não
+
+---
+
+## 📊 Métricas Gerais
+
+- **LOC Total:** [número]
+- **Complexidade Média:** [valor]
+- **Duplicação:** [percentual]
+- **Test Coverage:** [percentual]
+- **Vulnerabilidades:** [número]
+
+---
+
+## 🔴 Débitos Críticos (Ação Imediata)
+
+### 1. [Nome do Débito]
+- **Local:** [arquivo:linha]
+- **Descrição:** [descrição detalhada]
+- **Impacto:** [impacto no negócio]
+- **Estimativa:** [X dias-homem]
+- **Prioridade:** Alta
+
+---
+
+## 🟡 Débitos Médios (Planejar)
+
+### 1. [Nome do Débito]
+- **Local:** [arquivo:linha]
+- **Descrição:** [descrição]
+- **Estimativa:** [X dias-homem]
+- **Prioridade:** Média
+
+---
+
+## 🟢 Débitos Baixos (Monitorar)
+
+### 1. [Nome do Débito]
+- **Local:** [arquivo:linha]
+- **Descrição:** [descrição]
+- **Estimativa:** [X dias-homem]
+
+---
+
+## 📈 Plano de Ação
+
+### Fase 1 (Semanas 1-2)
+- [ ] Corrigir débitos críticos
+- [ ] Atualizar dependências de segurança
+
+### Fase 2 (Semanas 3-4)
+- [ ] Refatorar arquitetura
+- [ ] Aumentar test coverage
+
+### Fase 3 (Semanas 5-6)
+- [ ] Otimizar performance
+- [ ] Reduzir complexidade
+
+---
+
+**Versão do Template:** 1.0.0  
+**Última Atualização:** 30/01/2026