@maestro-ai/mcp-server 1.2.0 → 2.1.0

package/dist/content/playbook/Playbook de Desenvolvimento com IA.md

@@ -1,364 +0,0 @@
-# Playbook de Desenvolvimento com IA
-
-## 🎯 Objetivo
-
-Fornecer um método passo a passo para desenvolver software usando IA (ex.: GPT 5.1) em **todas as etapas** do ciclo de vida, como uma evolução do *vibe coding* tradicional, mas estruturado por **engenharia de software**.
-
-## 👥 Público-alvo
-
-- Devs que já usam IA para "quebrar galho" mas querem **processo**.
-- Times que desejam padronizar como usar IA em:
-  - definição de produto
-  - requisitos
-  - modelagem e arquitetura
-  - implementação (vibe coding estruturado)
-  - testes e qualidade.
-
-## 🔧 Especialistas relacionados
-
-Use este playbook em conjunto com os especialistas:
-
-- [Especialista em Gestão de Produto](./Especialista%20em%20Gestão%20de%20Produto%20.md)
-- [Especialista em Engenharia de Requisitos com IA](./Especialista%20em%20Engenharia%20de%20Requisitos%20com%20IA.md)
-- [Especialista em UX Design](./Especialista%20em%20UX%20Design.md)
-- [Especialista em Modelagem e Arquitetura de Domínio com IA](./Especialista%20em%20Modelagem%20e%20Arquitetura%20de%20Domínio%20com%20IA.md)
-- [Especialista em Arquitetura de Software](./Especialista%20em%20Arquitetura%20de%20Software.md)
-- [Especialista em Segurança da Informação](./Especialista%20em%20Segurança%20da%20Informação.md)
-- [Especialista em Análise de Testes](./Especialista%20em%20Análise%20de%20Testes.md)
-- [Especialista em Plano de Execução com IA](./Especialista%20em%20Plano%20de%20Execução%20com%20IA.md)
-- [Especialista em Desenvolvimento e Vibe Coding Estruturado](./Especialista%20em%20Desenvolvimento%20e%20Vibe%20Coding%20Estruturado.md)
-
----
-
-## 🔄 Visão geral do método (8 etapas)
-
-1. **Visão & problema**  
-   Entender o que estamos construindo, para quem e por quê.
-
-2. **Engenharia de requisitos com IA**  
-   Transformar visão em requisitos claros, completos e testáveis.
-
-3. **Modelagem & arquitetura com IA**  
-   Casos de uso, modelo de domínio, visão arquitetural inicial.
-
-4. **Planejamento / backlog**  
-   Fatiar o produto em épicos e histórias de usuário.
-
-5. **Vibe Coding Estruturado (implementação)**  
-   Implementar história a história com IA, em ciclos curtos.
-
-6. **Testes com IA**  
-   Planejar e gerar testes (unitários, integração, E2E) com apoio da IA.
-
-7. **Documentação & revisão**  
-   Usar IA para revisar código, gerar documentação e melhorar design.
-
-8. **Feedback & evolução**  
-   Analisar uso real, bugs e métricas para ajustar o produto.
-
----
-
-## 1. Visão & problema
-
-- **Especialista principal**: 
-  - [Especialista em Gestão de Produto](./Especialista%20em%20Gestão%20de%20Produto%20.md)
-- **Objetivo**: sair de ideia vaga para um recorte de produto com objetivo, público, dores e métricas.
-
-### Artefatos
-- Visão do produto
-- Personas
-- Principais dores e oportunidades
-
-### Prompts de exemplo
-
-```text
-Atue como um PM sênior. Quero descrever um produto que tenho em mente.
-
-Contexto bruto:
-[COLE SUAS ANOTAÇÕES]
-
-Organize em:
-- visão do produto
-- problema principal que resolve
-- público-alvo e 2–3 personas
-- principais riscos e hipóteses a validar
-```
-
-```text
-Com base na visão abaixo:
-[COLE VISÃO]
-
-Sugira 3 opções de recorte de MVP, com prós e contras de cada.
-```
-
----
-
-## 2. Engenharia de requisitos com IA
-
-- **Especialista principal**: 
-  - [Especialista em Engenharia de Requisitos com IA](./Especialista%20em%20Engenharia%20de%20Requisitos%20com%20IA.md)
-- **Objetivo**: gerar requisitos funcionais e não funcionais claros, completos e testáveis.
-
-### Artefatos
-- Lista de requisitos funcionais
-- Lista de requisitos não funcionais
-- Critérios de aceitação (idealmente em Gherkin)
-
-### Prompts de exemplo
-
-```text
-Vou colar abaixo anotações soltas de reuniões com o cliente.
-
-Notas:
-[COLE TEXTO]
-
-Atue como analista de requisitos.
-Organize em:
-- visão resumida
-- requisitos funcionais ("O sistema deve ...")
-- requisitos não funcionais
-- dúvidas que precisam ser respondidas com o cliente
-```
-
-```text
-Aqui estão alguns requisitos ainda vagos:
-[COLE REQUISITOS]
-
-Refine cada um para ficar:
-- claro e específico
-- mensurável/testável
-Inclua critérios de aceitação em Gherkin.
-```
-
----
-
-## 3. Modelagem & arquitetura com IA
-
-- **Especialistas principais**:
-  - [Especialista em Modelagem e Arquitetura de Domínio com IA](./Especialista%20em%20Modelagem%20e%20Arquitetura%20de%20Domínio%20com%20IA.md)
-  - [Especialista em Arquitetura de Software](./Especialista%20em%20Arquitetura%20de%20Software.md)
-- **Objetivo**: derivar casos de uso, entidades, relacionamentos e uma arquitetura inicial adequada ao contexto.
-
-### Artefatos
-- Casos de uso
-- Modelo de domínio (entidades, relacionamentos)
-- Diagrama/descrição C4 (Contexto, Containers, Componentes)
-
-### Prompts de exemplo
-
-```text
-Com base nesses requisitos:
-[COLE REQUISITOS]
-
-Liste:
-- atores
-- casos de uso principais
-- passos de alto nível de cada caso de uso
-```
-
-```text
-Usando os requisitos e casos de uso abaixo:
-[COLE]
-
-Proponha um modelo de domínio inicial:
-- entidades
-- principais atributos (com tipos aproximados)
-- relacionamentos (1-1, 1-N, N-N)
-- dúvidas abertas.
-```
-
-```text
-Quero implementar esse sistema com a stack:
-[DESCREVA STACK]
-
-Proponha uma arquitetura em estilo C4 (níveis 1–3)
-com justificativa das principais decisões.
-```
-
----
-
-## 4. Planejamento / backlog
-
-- **Especialistas principais**:
-  - [Especialista em Gestão de Produto](./Especialista%20em%20Gestão%20de%20Produto%20.md)
-  - [Especialista em Plano de Execução com IA](./Especialista%20em%20Plano%20de%20Execução%20com%20IA.md)
-- **Objetivo**: transformar requisitos em épicos e histórias de usuário, com prioridades.
-
-### Artefatos
-- Backlog de épicos
-- Histórias de usuário
-- Critérios de aceite por história
-
-### Prompts de exemplo
-
-```text
-Com base nesses requisitos e modelo de domínio:
-[COLE]
-
-Gere um backlog inicial com:
-- épicos
-- histórias de usuário em formato:
-  Como [persona], quero [ação] para [benefício].
-- critérios de aceitação para cada história.
-Ordene por prioridade para um MVP.
-```
-
-```text
-Aqui está um conjunto de histórias de usuário:
-[COLE HISTÓRIAS]
-
-Verifique:
-- histórias grandes demais que podem ser fatiadas
-- dependências importantes
-- riscos técnicos.
-Sugira uma ordem de implementação.
-```
-
----
-
-## 5. Vibe Coding Estruturado (implementação)
-
-- **Especialista principal**:
-  - [Especialista em Desenvolvimento e Vibe Coding Estruturado](./Especialista%20em%20Desenvolvimento%20e%20Vibe%20Coding%20Estruturado.md)
-- **Objetivo**: implementar funcionalidade por funcionalidade, em ciclos curtos, usando IA como pair programmer com foco em qualidade.
-
-### Artefatos
-- Código da funcionalidade
-- Casos de uso / endpoints
-- Testes automatizados (ao menos unitários)
-
-### Prompts de exemplo
-
-```text
-História de usuário:
-[COLE HISTÓRIA]
-
-Stack: [DESCREVA LINGUAGEM/FRAMEWORK].
-
-Detalhe, em alto nível:
-- endpoints ou casos de uso necessários
-- payloads de entrada/saída
-- validações obrigatórias
-- erros comuns e como tratar.
-```
-
-```text
-Agora gere APENAS o serviço/classe de domínio responsável por implementar
-essa regra de negócio, assumindo que já existe a entidade X com os campos:
-[DESCREVA].
-
-Inclua:
-- assinatura do método
-- lógica principal
-- tratamento básico de erros.
-Não gere controller/rota ainda.
-```
-
----
-
-## 6. Testes com IA
-
-- **Especialista principal**:
-  - [Especialista em Análise de Testes](./Especialista%20em%20Análise%20de%20Testes.md)
-- **Objetivo**: usar IA para planejar e gerar testes (unitários, integração, E2E) sem abrir mão de senso crítico humano.
-
-### Artefatos
-- Plano de testes
-- Testes automatizados
-- Métricas de cobertura e qualidade
-
-### Prompts de exemplo
-
-```text
-Aqui está a descrição da funcionalidade e seus requisitos:
-[COLE]
-
-Gere um plano de testes resumido com:
-- tipos de teste sugeridos (unitário, integração, E2E)
-- principais cenários de teste
-- casos de borda.
-```
-
-```text
-Aqui está a função/classe que implementei em [LINGUAGEM]:
-[COLE CÓDIGO]
-
-Gere testes unitários em [FRAMEWORK DE TESTE], cobrindo:
-- caso de sucesso
-- entradas inválidas
-- casos de borda.
-Explique rapidamente o raciocínio de cada teste.
-```
-
----
-
-## 7. Documentação & revisão
-
-- **Especialistas principais**:
-  - [Especialista em Arquitetura de Software](./Especialista%20em%20Arquitetura%20de%20Software.md)
-  - [Especialista em Plano de Execução com IA](./Especialista%20em%20Plano%20de%20Execução%20com%20IA.md)
-- **Objetivo**: garantir que o conhecimento não fique só no código e que decisões importantes estejam registradas.
-
-### Artefatos
-- Documentação técnica
-- ADRs (Architecture Decision Records) resumidos
-- Comentários de PR
-
-### Prompts de exemplo
-
-```text
-Aqui está um módulo/classe completo que escrevi:
-[COLE]
-
-Gere uma documentação técnica resumida com:
-- o que esse módulo faz
-- principais responsabilidades
-- dependências externas
-- exemplos de uso (se fizer sentido).
-```
-
-```text
-Com base nos pontos de dúvida/discussão abaixo:
-[COLE NOTAS]
-
-Gere um ADR resumido (1 página) com:
-- contexto
-- decisão
-- alternativas consideradas
-- trade-offs principais.
-```
-
----
-
-## 8. Feedback & evolução
-
-- **Especialistas principais**:
-  - [Especialista em Gestão de Produto](./Especialista%20em%20Gestão%20de%20Produto%20.md)
-  - [Especialista em Plano de Execução com IA](./Especialista%20em%20Plano%20de%20Execução%20com%20IA.md)
-- **Objetivo**: fechar o ciclo, aprendendo com uso real, métricas e bugs.
-
-### Artefatos
-- Registro de feedbacks de usuários
-- Lista de melhorias
-- Próximas iterações planejadas
-
-### Prompts de exemplo
-
-```text
-Aqui estão feedbacks e bugs coletados:
-[COLE TEXTO/ISSUES]
-
-Agrupe em:
-- problemas de usabilidade
-- bugs
-- pedidos de melhoria.
-Sugira ajustes no backlog (novas histórias ou mudanças em histórias existentes).
-```
-
-```text
-Com base nas métricas do produto abaixo:
-[COLE MÉTRICAS]
-
-Sugira hipóteses para explicar os números
- e 3 experimentos que poderíamos rodar na próxima sprint.
-```

package/dist/content/prompts/README.md

@@ -1,203 +0,0 @@
-# Biblioteca de Prompts
-
-Templates de prompts prontos para uso organizados por área.
-
----
-
-## Como Usar
-
-1. Copie o prompt da área desejada
-2. Substitua os placeholders `[...]` com seu contexto
-3. Cole na sua IA preferida (Claude, GPT, Gemini)
-4. Valide usando o checklist no final de cada prompt
-
-> **Dica**: Sempre inclua o conteúdo de `docs/CONTEXTO.md` para melhor resultado.
-
----
-
-## Como Escolher o Prompt Certo
-
-```mermaid
-flowchart TD
-    START[Início] --> Q1{Qual fase do projeto?}
-    
-    Q1 --> |Ideia inicial| DISC[discovery-inicial.md]
-    Q1 --> |Definindo escopo| REQ[refinar-requisitos.md]
-    Q1 --> |Modelando dados| MODEL[modelo-dominio.md]
-    Q1 --> |Prototipando UI| STITCH[gerar-ui-stitch.md]
-    
-    Q1 --> |Arquitetura| Q2{Complexidade?}
-    Q2 --> |Simples/Médio| CLEAN[clean-architecture.md]
-    Q2 --> |Médio| C4[arquitetura-c4-completo.md]
-    Q2 --> |Complexo| DDD[ddd-cqrs.md ou ddd-bounded-contexts.md]
-    
-    Q1 --> |Implementando| Q3{O que precisa?}
-    Q3 --> |API Design| API[design-api-rest.md]
-    Q3 --> |Serviço| SERV[gerar-servico.md]
-    Q3 --> |Testes| TEST[gerar-testes-unitarios.md]
-    Q3 --> |Review| REVIEW[code-review.md]
-    
-    Q1 --> |Preparando produção| Q4{Área?}
-    Q4 --> |Performance| PERF[analise-performance.md]
-    Q4 --> |Observabilidade| OBS[estrategia-observabilidade.md]
-    Q4 --> |Segurança| SEC[analise-seguranca.md]
-    Q4 --> |CI/CD| CICD[pipeline-cicd.md]
-    Q4 --> |Banco de dados| DB[otimizacao-queries.md]
-    Q4 --> |Acessibilidade| A11Y[analise-acessibilidade.md]
-```
-
----
-
-## Índice de Prompts
-
-### 📋 Produto & Requisitos
-
-| Prompt | Quando Usar | Nível |
-|--------|-------------|-------|
-| [discovery-inicial.md](./produto/discovery-inicial.md) | Início de projeto, ideia vaga | Simples |
-| [refinar-requisitos.md](./requisitos/refinar-requisitos.md) | Após discovery, formalizar requisitos | Simples |
-
----
-
-### 🎨 UX & Prototipagem
-
-| Prompt | Quando Usar | Nível |
-|--------|-------------|-------|
-| [gerar-ui-stitch.md](./ux/gerar-ui-stitch.md) | Prototipar UI com Google Stitch | Simples |
-
----
-
-### 🏗️ Arquitetura & Modelagem
-
-| Prompt | Quando Usar | Nível |
-|--------|-------------|-------|
-| [modelo-dominio.md](./arquitetura/modelo-dominio.md) | Modelar entidades e relacionamentos | Simples |
-| [arquitetura-c4-completo.md](./arquitetura/arquitetura-c4-completo.md) | Definir arquitetura com diagramas C4 | Médio |
-| [clean-architecture.md](./arquitetura/clean-architecture.md) | Arquitetura limpa para projetos médios | Médio |
-| [ddd-bounded-contexts.md](./arquitetura/ddd-bounded-contexts.md) | Definir contextos em DDD | Complexo |
-| [ddd-cqrs.md](./arquitetura/ddd-cqrs.md) | DDD + CQRS para sistemas complexos | Complexo |
-| [multi-tenancy.md](./arquitetura/multi-tenancy.md) | Arquitetura multi-tenant para SaaS | Complexo |
-
----
-
-### 🔌 APIs
-
-| Prompt | Quando Usar | Nível |
-|--------|-------------|-------|
-| [design-api-rest.md](./apis/design-api-rest.md) | Projetar API REST com OpenAPI | Médio |
-| [idempotencia.md](./apis/idempotencia.md) | Implementar idempotência em endpoints | Médio |
-| [versionamento.md](./apis/versionamento.md) | Estratégias de versionamento de API | Médio |
-
----
-
-### 💻 Desenvolvimento
-
-| Prompt | Quando Usar | Nível |
-|--------|-------------|-------|
-| [gerar-servico.md](./desenvolvimento/gerar-servico.md) | Gerar código de serviços/use cases | Médio |
-| [code-review.md](./desenvolvimento/code-review.md) | Revisar código de PRs | Médio |
-
----
-
-### 🧪 Testes
-
-| Prompt | Quando Usar | Nível |
-|--------|-------------|-------|
-| [gerar-testes-unitarios.md](./testes/gerar-testes-unitarios.md) | Criar testes unitários | Simples |
-| [testes-integracao.md](./testes/testes-integracao.md) | Testes de integração com banco/APIs | Médio |
-| [testes-e2e.md](./testes/testes-e2e.md) | Testes end-to-end com Playwright | Médio |
-| [testes-performance.md](./testes/testes-performance.md) | Load testing com k6 | Médio |
-| [contract-testing.md](./testes/contract-testing.md) | Contract testing com Pact | Médio |
-
----
-
-### 🚀 Performance & Escalabilidade
-
-| Prompt | Quando Usar | Nível |
-|--------|-------------|-------|
-| [analise-performance.md](./escalabilidade/analise-performance.md) | Identificar e corrigir gargalos | Médio |
-| [caching.md](./escalabilidade/caching.md) | Estratégias de cache com Redis | Médio |
-
----
-
-### 🗄️ Database
-
-| Prompt | Quando Usar | Nível |
-|--------|-------------|-------|
-| [otimizacao-queries.md](./database/otimizacao-queries.md) | Otimizar banco de dados e queries | Médio |
-| [migrations-zero-downtime.md](./database/migrations-zero-downtime.md) | Migrations sem downtime | Médio |
-
----
-
-### 📊 Observabilidade
-
-| Prompt | Quando Usar | Nível |
-|--------|-------------|-------|
-| [estrategia-observabilidade.md](./observabilidade/estrategia-observabilidade.md) | Configurar logs, métricas, traces | Médio |
-| [slos.md](./observabilidade/slos.md) | Definir SLOs, SLIs e Error Budgets | Médio |
-| [chaos-testing.md](./observabilidade/chaos-testing.md) | Experimentos de chaos engineering | Complexo |
-
----
-
-### 🔐 Segurança
-
-| Prompt | Quando Usar | Nível |
-|--------|-------------|-------|
-| [analise-seguranca.md](./seguranca/analise-seguranca.md) | Análise OWASP Top 10 | Médio |
-| [threat-modeling.md](./seguranca/threat-modeling.md) | Modelagem de ameaças STRIDE | Médio |
-| [revisao-lgpd.md](./seguranca/revisao-lgpd.md) | Conformidade LGPD/GDPR | Médio |
-| [pentest-checklist.md](./seguranca/pentest-checklist.md) | Checklist de pentest para devs | Médio |
-| [rate-limiting.md](./seguranca/rate-limiting.md) | Rate limiting e throttling | Médio |
-
----
-
-### ⚙️ DevOps
-
-| Prompt | Quando Usar | Nível |
-|--------|-------------|-------|
-| [pipeline-cicd.md](./devops/pipeline-cicd.md) | Configurar CI/CD com GitHub Actions | Médio |
-| [docker-compose.md](./devops/docker-compose.md) | Docker Compose multi-ambiente | Médio |
-| [kubernetes-deploy.md](./devops/kubernetes-deploy.md) | Deploy Kubernetes com manifests | Complexo |
-| [terraform-iac.md](./devops/terraform-iac.md) | Infrastructure as Code com Terraform | Complexo |
-| [feature-flags.md](./devops/feature-flags.md) | Feature flags e rollout gradual | Médio |
-
----
-
-### ♿ Acessibilidade
-
-| Prompt | Quando Usar | Nível |
-|--------|-------------|-------|
-| [analise-acessibilidade.md](./acessibilidade/analise-acessibilidade.md) | Verificar WCAG 2.1, screen readers | Médio |
-
----
-
-## Estrutura dos Prompts
-
-Todos os prompts seguem a mesma estrutura:
-
-```markdown
-# Prompt: [Nome]
-
-> **Quando usar**: [Contexto]
-> **Especialista**: [Link para especialista]
-> **Nível**: [Simples/Médio/Complexo]
-
----
-
-## Fluxo de Contexto
-[Documentos de entrada e saída]
-
-## Prompt Completo
-[Prompt para copiar]
-
-## Exemplo de Uso
-[Exemplo preenchido]
-
-## Resposta Esperada
-[Exemplo de saída]
-
-## Checklist Pós-Geração
-[Validações do resultado]
-```
-
-