@maestro-ai/mcp-server 1.1.0 → 2.0.0

package/dist/content/skills/specialist-documentacao-tecnica/resources/templates/design-doc.md

@@ -0,0 +1,250 @@
+# 📚 Design Document: [Nome do Documento]
+
+## 📋 Metadados
+
+**Data de Criação:** [DD/MM/YYYY]  
+**Versão:** 1.0  
+**Autor:** [Nome do Autor]  
+**Status:** [Draft|Review|Approved|Published]  
+**Última Revisão:** [DD/MM/YYYY]  
+**Revisores:** [Lista de revisores]  
+
+---
+
+## 🎯 Visão Geral
+
+### Objetivo do Documento
+[ ] **Propósito:** [Descrição clara do propósito do documento]
+[ ] **Público-Alvo:** [Descreva quem vai usar este documento]
+[ ] **Escopo:** [O que está incluído e excluído]
+[ ] **Nível de Detalhe:** [Alto|Médio|Baixo]
+
+### Contexto do Projeto
+[ ] **Nome do Projeto:** [Nome completo do projeto]
+[ ] **Descrição:** [Descrição curta do projeto]
+[ ] **Versão:** [Versão atual do software]
+[ ] **Ambiente:** [Desenvolvimento|Staging|Produção]
+[ ] **Stakeholders:** [Lista de stakeholders]
+
+---
+
+## 📚 Estrutura do Documento
+
+### 1. Introdução
+[ ] **Visão Geral:** [Descrição geral do sistema]
+[ ] **Problema Resolvido:** [Problema que o sistema resolve]
+[ ] **Solução Proposta:** [Como o sistema resolve o problema]
+[ ] **Benefícios Principais:** [Principais benefícios para usuários]
+[ ] **Limitações:** [Limitações conhecidas]
+
+### 2. Arquitetura
+[ ] **Visão Arquitetural:** [Visão geral da arquitetura]
+[ ] **Componentes Principais:** [Lista de componentes principais]
+[ ] **Diagrama de Arquitetura:** [Descrição do diagrama]
+[ ] **Tecnologias Utilizadas:** [Stack tecnológico completo]
+[ ] **Padrões de Design:** [Padrões de design implementados]
+
+### 3. Componentes Detalhados
+[ ] **Componente 1:** [Nome e descrição]
+  - [ ] **Responsabilidades:** [O que o componente faz]
+  - [ ] **Interface:** [Como se comunica com outros componentes]
+  - [ ] **Dependências:** [Dependências do componente]
+  - [ ] **Configuração:** [Como configurar o componente]
+
+[ ] **Componente 2:** [Nome e descrição]
+  - [ ] **Responsabilidades:** [O que o componente faz]
+  - [ ] **Interface:** [Como se comunica com outros componentes]
+  - [ ] **Dependências:** [Dependências do componente]
+  - [ ] **Configuração:** [Como configurar o componente]
+
+### 4. Fluxos de Dados
+[ ] **Fluxo Principal:** [Descrição do fluxo principal]
+[ ] **Diagrama de Fluxo:** [Descrição do diagrama]
+[ ] **Fontes de Dados:** [Lista de fontes de dados]
+[ ] **Transformações:** [Transformações aplicadas nos dados]
+[ ] **Armazenamento:** [Onde os dados são armazenados]
+
+### 5. APIs e Interfaces
+[ ] **API REST:** [Descrição da API REST]
+  - [ ] **Endpoints:** [Lista de endpoints]
+  - [ ] **Autenticação:** [Método de autenticação]
+  - [ ] **Autorização:** [Método de autorização]
+  - [ ] **Rate Limiting:** [Limites de uso]
+
+[ ] **API GraphQL:** [Descrição da API GraphQL]
+  - [ ] **Schema:** [Schema GraphQL]
+  - [ ] **Queries:** [Queries disponíveis]
+  - [ ] **Mutations:** [Mutações disponíveis]
+  - [ ] **Subscriptions:** [Subscriptions disponíveis]
+
+[ ] **Webhooks:** [Descrição dos webhooks]
+  - [ ] **Eventos:** [Eventos disponíveis]
+  - [ ] **Configuração:** [Como configurar webhooks]
+  - [ ] **Segurança:** [Métodos de segurança]
+
+### 6. Banco de Dados
+[ ] **Schema do Banco:** [Descrição do schema]
+[ ] **Tabelas Principais:** [Lista de tabelas principais]
+[ ] **Relacionamentos:** [Relacionamentos entre tabelas]
+[ ] **Índices:** [Índices criados]
+[ ] **Migrações:** [Histórico de migrações]
+
+### 7. Segurança
+[ ] **Autenticação:** [Métodos de autenticação]
+[ ] **Autorização:** [Controle de acesso]
+[ ] **Criptografia:** [Métodos de criptografia]
+[ ] **Validação de Entrada:** [Validação de dados de entrada]
+[ ] **Logging e Auditoria:** [Sistema de logs]
+[ ] **Compliance:** [Requisitos de compliance]
+
+### 8. Performance
+[ ] **Métricas de Performance:** [Métricas monitoradas]
+[ ] **Otimizações Aplicadas:** [Otimizações implementadas]
+[ ] **Limites de Escalabilidade:** [Limites conhecidos]
+[ ] **Cache:** [Estratégias de cache]
+[ ] **Monitoramento:** [Sistema de monitoramento]
+
+### 9. Deploy e Operações
+[ ] **Ambientes:** [Descrição dos ambientes]
+[ ] **Processo de Deploy:** [Passos para deploy]
+[ ] **Configuração:** [Configuração necessária]
+[ ] **Monitoramento:** [Monitoramento pós-deploy]
+[ ] **Rollback:** [Estratégias de rollback]
+[ ] **Backup:** [Estratégias de backup]
+
+### 10. Testes
+[ ] **Testes Unitários:** [Estratégia de testes unitários]
+[ ] **Testes de Integração:** [Estratégia de testes de integração]
+[ ] **Testes E2E:** [Estratégia de testes end-to-end]
+[ ] **Testes de Performance:** [Estratégia de testes de performance]
+[ ] **Cobertura de Código:** [Métricas de cobertura]
+
+---
+
+## 🔧 Implementação
+
+### Guia de Estilo
+[ ] **Linguagem:** [Português brasileiro]
+[ ] **Tom de Voz:** [Formal/Técnico]
+[ ] **Formato:** [Markdown]
+[ ] **Estrutura:** [Estrutura de seções]
+[ ] **Convenções:** [Convenções de nomenclatura]
+
+### Ferramentas
+[ ] **Editor:** [Editor recomendado]
+[ ] **Versionamento:** [Sistema de versionamento]
+[ ] **Revisão:** [Processo de revisão]
+[ ] **Publicação:** [Onde e como publicar]
+
+### Templates e Exemplos
+[ ] **Código:** [Exemplos de código]
+[ ] **Configuração:** [Exemplos de configuração]
+[ ] **Comandos:** [Exemplos de comandos]
+[ ] **Respostas:** [Exemplos de respostas]
+
+---
+
+## 📊 Métricas e KPIs
+
+### Métricas de Qualidade
+[ ] **Completude:** [Métrica de completude]
+[ ] **Clareza:** [Métrica de clareza]
+[ ] **Consistência:** [Métrica de consistência]
+[ ] **Atualização:** [Métrica de atualização]
+[ ] **Feedback:** [Métrica de feedback]
+
+### KPIs de Documentação
+[ ] **Tempo de Leitura:** [Tempo médio de leitura]
+[ ] **Taxa de Uso:** [Taxa de uso do documento]
+[ ] **Satisfação:** [Pesquisa de satisfação]
+[ ] **Manutenção:** [Custo de manutenção]
+
+---
+
+## 🔄 Processo de Manutenção
+
+### Revisão e Atualização
+[ ] **Frequência:** [Frequência de revisão]
+[ ] **Responsáveis:** [Responsáveis pela manutenção]
+[ ] **Processo:** [Processo de revisão]
+[ ] **Aprovação:** [Processo de aprovação]
+
+### Versionamento
+[ ] **Controle de Versões:** [Sistema de controle]
+[ ] **Histórico:** [Histórico de alterações]
+[ ] **Tags:** [Sistema de tags]
+[ ] **Branches:** [Estratégia de branches]
+
+### Comunicação
+[ ] **Canais:** [Canais de comunicação]
+[ ] **Notificações:** [Sistema de notificações]
+[ ] **Feedback:** [Como fornecer feedback]
+[ ] **Discussões:** [Fórum de discussões]
+
+---
+
+## 📝 Histórico de Alterações
+
+| Data | Versão | Alteração | Autor | Revisores |
+|------|--------|-----------|-------|---------|
+| [DD/MM/YYYY] | 1.0 | Criação inicial | [Nome] | [Revisores] |
+| [DD/MM/YYYY] | 1.1 | [Descrição] | [Nome] | [Revisores] |
+
+---
+
+## ✅ Checklist de Validação
+
+### Antes da Publicação
+- [ ] **Conteúdo Completo:** Todas seções preenchidas
+- [ ] **Estrutura Correta:** Segue o template padrão
+- [ ] **Links Funcionando:** Todos os links testados
+- [ ] **Imagens Legíveis:** Todas as imagens claras
+- [ ] **Código Formatado:** Código formatado corretamente
+- [ ] **Exemplos Testados:** Exemplos funcionando
+- [ ] **Revisão Técnica:** Revisão técnica concluída
+- [ ] **Aprovação:** Aprovação obtida
+
+### Pós-Publicação
+- [ ] **Feedback Coletado:** Feedback dos usuários coletado
+- [ ] **Métricas Monitoradas:** Métricas monitoradas
+- [ ] **Atualizações:** Atualizações necessárias
+- [ ] **Versão Atualizada:** Versão mantida atualizada
+
+---
+
+## 📚 Referências
+
+### Documentação Relacionada
+[ ] **[Link 1]:** [Descrição]
+[ ] **[Link 2]:** [Descrição]
+[ ] **[Link 3]:** [Descrição]
+
+### Ferramentas e Recursos
+[ ] **[Ferramenta 1]:** [Descrição e link]
+[ ] **[Ferramenta 2]:** [Descrição e link]
+[ ] **[Ferramenta 3]:** [Descrição e link]
+
+### Padrões e Guias
+[ ] **[Padrão 1]:** [Descrição e link]
+[ ] **[Guia 1]:** [Descrição e link]
+[ ] **[Guia 2]:** [Descrição e link]
+
+---
+
+## 📞 Contato
+
+### Equipe de Documentação
+- **Lead Writer:** [Nome e contato]
+- **Revisores Técnicos:** [Lista e contatos]
+- **Revisores de Negócio:** [Lista e contatos]
+- **Manutenção:** [Nome e contato]
+
+### Canais de Comunicação
+- **Discord:** [Canal do Discord]
+- **Slack:** [Canal do Slack]
+- **Email:** [Email para feedback]
+- **Issues:** [Sistema de issues]
+
+---
+
+**Status Final:** [ ] ✅ **PRONTO PARA PUBLICAÇÃO** | [ ] 🔄 **EM REVISÃO** | [ ] ❌ **PENDENTE**

package/dist/content/skills/specialist-documentacao-tecnica/resources/templates/guia-tecnico.md

@@ -0,0 +1,383 @@
+# 📚 Guia Técnico: [Nome do Projeto]
+
+## 📋 Metadados
+
+**Data de Criação:** [DD/MM/YYYY]  
+**Versão:** 1.0  
+**Autor(es):** [Nome do(s) Autor(es)]  
+**Status:** [Draft|Review|Approved|Published]  
+**Última Revisão:** [DD/MM/YYYY]  
+**Revisores:** [Lista de revisores]  
+**Público-Alvo:** [Developers|Users|Both]  
+
+---
+
+## 🎯 Visão Geral
+
+### Resumo do Projeto
+[ ] **Nome:** [Nome completo do projeto]
+[ ] **Descrição:** [Descrição em 1-2 parágrafos]
+[ ] **Propósito:** [Problema que resolve]
+[ ] **Impacto:** [Benefícios principais]
+[ ] **Diferenciais:** [O que torna único]
+
+### Stack Tecnológica
+[ ] **Frontend:** [Framework, linguagem, estilização]
+[ ] **Backend:** [Framework, linguagem, banco]
+[ ] **Infraestrutura:** [Cloud, deploy, monitoramento]
+[ ] **Ferramentas:** [IDE, testing, CI/CD]
+
+---
+
+## 🚀 Getting Started
+
+### Pré-requisitos
+[ ] **Node.js:** Versão mínima [X.X.X]
+[ ] **npm/yarn:** Gerenciador de pacotes
+[ ] **Docker:** Para ambiente containerizado
+[ ] **Outros:** [Liste outros pré-requisitos]
+
+### Instalação
+```bash
+# Clone o repositório
+git clone [URL_DO_REPOSITORIO]
+cd [NOME_DO_PROJETO]
+
+# Instale dependências
+npm install
+
+# Configure variáveis de ambiente
+cp .env.example .env
+# Edite .env com suas configurações
+
+# Inicie o desenvolvimento
+npm run dev
+```
+
+### Configuração Inicial
+[ ] **Variáveis de Ambiente:** Configure as variáveis obrigatórias
+[ ] **Banco de Dados:** Execute migrações se necessário
+[ ] **Dependências Externas:** Configure APIs externas
+[ ] **Autenticação:** Configure método de autenticação
+
+---
+
+## 📁 Estrutura do Projeto
+
+```
+[NOME_DO_PROJETO]/
+├── src/                          # Código fonte
+│   ├── components/              # Componentes reutilizáveis
+│   │   ├── ui/                 # Componentes de UI
+│   │   └── business/           # Componentes de negócio
+│   ├── services/               # Serviços e APIs
+│   ├── utils/                  # Utilitários e helpers
+│   ├── types/                  # Definições TypeScript
+│   └── styles/                 # Estilos globais
+├── docs/                       # Documentação
+│   ├── api/                    # Documentação de APIs
+│   ├── guides/                 # Guias de uso
+│   └── adr/                    # Architecture Decision Records
+├── tests/                      # Testes
+│   ├── unit/                   # Testes unitários
+│   ├── integration/            # Testes de integração
+│   └── e2e/                    # Testes end-to-end
+├── scripts/                    # Scripts de automação
+├── tools/                      # Ferramentas de desenvolvimento
+└── public/                     # Arquivos estáticos
+```
+
+---
+
+## 🔧 Scripts Disponíveis
+
+### Desenvolvimento
+```bash
+npm run dev          # Servidor de desenvolvimento
+npm run build        # Build para produção
+npm run preview      # Preview do build
+npm run lint         # Análise de código
+npm run type-check   # Verificação de tipos
+```
+
+### Testes
+```bash
+npm test             # Executa todos os testes
+npm run test:unit    # Testes unitários
+npm run test:integration # Testes de integração
+npm run test:e2e     # Testes end-to-end
+npm run test:coverage # Cobertura de código
+```
+
+### Deploy
+```bash
+npm run deploy:dev   # Deploy para desenvolvimento
+npm run deploy:stg   # Deploy para staging
+npm run deploy:prod  # Deploy para produção
+```
+
+---
+
+## 🔐 Segurança
+
+### Autenticação
+[ ] **Método:** [JWT|OAuth|Session|Custom]
+[ ] **Configuração:** [Como configurar]
+[ ] **Tokens:** [Como gerenciar tokens]
+[ ] **Refresh:** [Estratégia de refresh token]
+
+### Autorização
+[ ] **RBAC:** Role-Based Access Control
+[ ] **Permissões:** [Lista de permissões]
+[ ] **Middleware:** [Como proteger rotas]
+[ ] **Admin:** [Acesso administrativo]
+
+### Segurança de Dados
+[ ] **Criptografia:** [Métodos utilizados]
+[ ] **Validação:** [Validação de entrada]
+[ ] **Sanitização:** [Limpeza de dados]
+[ ] **Headers:** [Headers de segurança]
+
+---
+
+## 📊 APIs e Endpoints
+
+### API REST
+[ ] **Base URL:** [URL base da API]
+[ ] **Versão:** [v1|v2]
+[ ] **Autenticação:** [Método de autenticação]
+[ ] **Rate Limiting:** [Limites de uso]
+
+#### Endpoints Principais
+```http
+GET    /api/v1/users           # Lista usuários
+POST   /api/v1/users           # Cria usuário
+GET    /api/v1/users/:id       # Detalhes do usuário
+PUT    /api/v1/users/:id       # Atualiza usuário
+DELETE /api/v1/users/:id       # Remove usuário
+```
+
+### Exemplos de Uso
+```bash
+# Listar usuários
+curl -H "Authorization: Bearer <TOKEN>" \
+     https://api.exemplo.com/v1/users
+
+# Criar usuário
+curl -X POST \
+     -H "Content-Type: application/json" \
+     -H "Authorization: Bearer <TOKEN>" \
+     -d '{"name":"João","email":"joao@exemplo.com"}' \
+     https://api.exemplo.com/v1/users
+```
+
+---
+
+## 🗄️ Banco de Dados
+
+### Schema Principal
+[ ] **Banco:** [PostgreSQL|MySQL|MongoDB]
+[ ] **ORM:** [Prisma|TypeORM|Mongoose]
+[ ] **Migrações:** [Como executar migrações]
+[ ] **Seeds:** [Dados iniciais]
+
+### Tabelas Principais
+```sql
+-- Exemplo de estrutura
+CREATE TABLE users (
+    id SERIAL PRIMARY KEY,
+    name VARCHAR(255) NOT NULL,
+    email VARCHAR(255) UNIQUE NOT NULL,
+    created_at TIMESTAMP DEFAULT NOW(),
+    updated_at TIMESTAMP DEFAULT NOW()
+);
+```
+
+### Queries Comuns
+```sql
+-- Buscar usuário por email
+SELECT * FROM users WHERE email = 'joao@exemplo.com';
+
+-- Contar usuários ativos
+SELECT COUNT(*) FROM users WHERE active = true;
+```
+
+---
+
+## 🚀 Deploy e Operações
+
+### Ambientes
+[ ] **Desenvolvimento:** [URL e configurações]
+[ ] **Staging:** [URL e configurações]
+[ ] **Produção:** [URL e configurações]
+
+### Processo de Deploy
+1. **Build:** `npm run build`
+2. **Testes:** `npm run test:ci`
+3. **Upload:** [Método de upload]
+4. **Health Check:** [Verificação pós-deploy]
+5. **Rollback:** [Estratégia de rollback]
+
+### Monitoramento
+[ ] **Logs:** [Onde encontrar logs]
+[ ] **Métricas:** [Métricas monitoradas]
+[ ] **Alertas:** [Configurações de alerta]
+[ ] **Health Checks:** [Endpoints de saúde]
+
+---
+
+## 🧪 Testes
+
+### Estratégia de Testes
+[ ] **Unitários:** [Framework e cobertura]
+[ ] **Integração:** [Como testar integrações]
+[ ] **E2E:** [Ferramenta e cenários]
+[ ] **Performance:** [Como testar performance]
+
+### Executando Testes
+```bash
+# Todos os testes
+npm test
+
+# Testes específicos
+npm test -- --grep "users"
+
+# Com cobertura
+npm run test:coverage
+
+# Watch mode
+npm run test:watch
+```
+
+---
+
+## 🔧 Troubleshooting
+
+### Problemas Comuns
+
+#### Erro de Instalação
+**Problema:** Falha ao instalar dependências  
+**Solução:** 
+```bash
+rm -rf node_modules package-lock.json
+npm install
+```
+
+#### Erro de Build
+**Problema:** Build falha com erro de TypeScript  
+**Solução:** Verifique tipos e execute `npm run type-check`
+
+#### Erro de Conexão
+**Problema:** Falha ao conectar com banco/API  
+**Solução:** Verifique variáveis de ambiente e conectividade
+
+### Logs e Debug
+[ ] **Development Logs:** [Onde encontrar]
+[ ] **Production Logs:** [Como acessar]
+[ ] **Debug Mode:** [Como habilitar]
+[ ] **Verbose Output:** [Como obter mais detalhes]
+
+---
+
+## 📈 Performance
+
+### Métricas Monitoradas
+[ ] **Response Time:** [Tempo médio de resposta]
+[ ] **Throughput:** [Requisições por segundo]
+[ ] **Error Rate:** [Taxa de erros]
+[ ] **Resource Usage:** [CPU, memória, disco]
+
+### Otimizações
+[ ] **Cache:** [Estratégias de cache]
+[ ] **Lazy Loading:** [Onde implementado]
+[ ] **Code Splitting:** [Como funciona]
+[ ] **Image Optimization:** [Como otimizar]
+
+---
+
+## 🔄 Manutenção
+
+### Atualizações
+[ ] **Dependencies:** [Como atualizar]
+[ ] **Security Patches:** [Processo de patch]
+[ ] **Major Versions:** [Como lidar com breaking changes]
+[ ] **Deprecations:** [Como substituir features deprecated]
+
+### Backup e Recovery
+[ ] **Database Backup:** [Frequência e método]
+[ ] **File Backup:** [O que e como backup]
+[ ] **Recovery:** [Processo de recovery]
+[ ] **Testing:** [Como testar backups]
+
+---
+
+## 📚 Recursos Adicionais
+
+### Documentação Relacionada
+[ ] **API Documentation:** [Link para docs da API]
+[ ] **Architecture:** [Link para docs de arquitetura]
+[ ] **Contributing:** [Link para guia de contribuição]
+[ ] **Changelog:** [Link para changelog]
+
+### Ferramentas e Links
+[ ] **Repository:** [Link para repositório]
+[ ] **Project Board:** [Link para board do projeto]
+[ ] **Monitoring:** [Link para dashboard]
+[ ] **Analytics:** [Link para analytics]
+
+### Comunidade e Suporte
+[ ] **Discord:** [Canal do Discord]
+[ ] **Slack:** [Canal do Slack]
+[ ] **Issues:** [Link para issues]
+[ ] **Discussions:** [Link para discussões]
+
+---
+
+## ✅ Checklist de Validação
+
+### Antes de Publicar
+- [ ] **Conteúdo Completo:** Todas seções preenchidas
+- [ ] **Links Funcionando:** Todos os links testados
+- [ ] **Exemplos Testados:** Código e comandos funcionando
+- [ ] **Formatação:** Markdown formatado corretamente
+- [ ] **Revisão Técnica:** Revisado por técnico especialista
+- [ ] **Aprovação:** Aprovação obtida
+
+### Pós-Publicação
+- [ ] **Feedback Coletado:** Feedback dos usuários
+- [ ] **Métricas Monitoradas:** Uso e engajamento
+- [ ] **Atualizações:** Manter conteúdo atualizado
+- [ ] **Versão Controlada:** Versionar mudanças
+
+---
+
+## 📝 Histórico de Alterações
+
+| Data | Versão | Alteração | Autor | Revisores |
+|------|--------|-----------|-------|---------|
+| [DD/MM/YYYY] | 1.0 | Criação inicial | [Nome] | [Revisores] |
+| [DD/MM/YYYY] | 1.1 | [Descrição] | [Nome] | [Revisores] |
+
+---
+
+## 📞 Contato e Suporte
+
+### Equipe do Projeto
+- **Tech Lead:** [Nome e contato]
+- **Product Manager:** [Nome e contato]
+- **DevOps:** [Nome e contato]
+- **QA:** [Nome e contato]
+
+### Canais de Comunicação
+- **Discord:** [Canal #projeto]
+- **Slack:** [Canal #projeto]
+- **Email:** [email@projeto.com]
+- **Issues:** [GitHub Issues]
+
+---
+
+**Status Final:** [ ] ✅ **PRONTO PARA PUBLICAÇÃO** | [ ] 🔄 **EM REVISÃO** | [ ] ❌ **PENDENTE**
+
+**Score de Qualidade:** [ ]/100 pontos (mínimo: 75)
+
+**Última Atualização:** [DD/MM/YYYY]