@maestro-ai/mcp-server 1.0.0 → 1.0.1

package/dist/content/content/examples/Exemplo de Fluxo Completo com Node e NestJS.md

@@ -1,258 +0,0 @@
-# Exemplo de Fluxo Completo com Node e NestJS
-
-Este exemplo mostra, de forma resumida, como aplicar o **Playbook de Desenvolvimento com IA**
-para implementar uma funcionalidade simples usando **Node.js + NestJS**.
-
-Funcionalidade de exemplo: **Cadastro de Leads** em uma landing page.
-
----
-
-## 1. Visão & Problema
-
-### Contexto
-
-Uma landing page captura leads (nome, e-mail, origem). Queremos salvar esses dados em um banco
-(PostgreSQL) e ter um endpoint para listar os leads.
-
-### Prompt sugerido
-
-```text
-Você é um engenheiro de software sênior especialista em Node.js e NestJS.
-
-Contexto do produto:
-- Landing page para captura de leads com formulário (nome, email, origem)
-- Backend: API NestJS + PostgreSQL
-
-Me ajude a descrever a visão técnica mínima para essa feature, incluindo:
-- objetivo principal
-- atores
-- principais fluxos (cadastrar lead, listar leads)
-- riscos ou dúvidas técnicas.
-```
-
----
-
-## 2. Engenharia de Requisitos com IA
-
-### Requisitos funcionais (esperados)
-
-- RF1: O sistema deve permitir cadastrar um lead com `nome`, `email`, `origem`.
-- RF2: O sistema deve listar leads cadastrados, com paginação simples.
-
-### Requisitos não funcionais (exemplos)
-
-- RNF1: E-mail deve ser validado.
-- RNF2: API deve responder em < 500ms (p95) em condições normais.
-
-### Prompt sugerido
-
-```text
-A partir da visão abaixo, detalhe os requisitos funcionais e não funcionais
-para a funcionalidade de cadastro de leads.
-
-Visão:
-[COLE A VISÃO GERADA NA ETAPA 1]
-
-Responda com:
-- requisitos funcionais numerados (RF1, RF2...)
-- requisitos não funcionais principais
-- critérios de aceitação para cada requisito.
-```
-
----
-
-## 3. Modelagem & Arquitetura com IA
-
-### Modelo de domínio esperado
-
-Entidade `Lead`:
-- id (UUID)
-- nome (string)
-- email (string)
-- origem (string)
-- criadoEm (datetime)
-
-### Prompt para modelo de domínio
-
-```text
-Com base nestes requisitos:
-[COLE REQUISITOS]
-
-Proponha um modelo de domínio mínimo em NestJS + Prisma com:
-- entidades
-- campos e tipos
-- relacionamentos (se houver)
-
-Explique se há algo ambíguo ou faltando.
-```
-
-### Prompt para arquitetura/API
-
-```text
-Stack:
-- NestJS
-- Prisma
-- PostgreSQL
-
-Quero implementar a API de leads.
-
-Descreva:
-- endpoints necessários (rota, método, payload)
-- formato de resposta
-- status HTTP para casos de sucesso/erro
-- validações obrigatórias.
-```
-
----
-
-## 4. Planejamento / Backlog com IA
-
-### User story
-
-```text
-Como um analista de marketing,
-Quero cadastrar e consultar leads de uma landing page,
-Para que eu possa acompanhar o desempenho das campanhas.
-```
-
-### Prompt para backlog
-
-```text
-Usando a user story e requisitos abaixo:
-[COLE]
-
-Gere uma lista de tarefas técnicas para implementar isso em NestJS + Prisma:
-- modelagem de banco
-- criação de módulo/serviço/controller
-- validações
-- testes unitários e de integração
-
-Organize em uma sequência lógica de implementação.
-```
-
----
-
-## 5. Implementação (Vibe Coding Estruturado) com IA
-
-### Passo 1 – Service de domínio
-
-Prompt sugerido:
-
-```text
-Vamos implementar o serviço de domínio para cadastro e listagem de leads
-em NestJS usando Prisma.
-
-Contexto:
-- entidade Lead: id (UUID), nome, email, origem, criadoEm
-- regras: email obrigatório e válido; nome obrigatório
-
-Gere apenas o código do serviço (LeadService) com métodos:
-- createLead(dto)
-- listLeads(pagination)
-
-Use boas práticas de NestJS e Prisma.
-Não gere controller ainda.
-```
-
-### Passo 2 – Controller/Rotas
-
-```text
-Aqui está o LeadService que acabamos de implementar:
-[COLE CÓDIGO]
-
-Gere o controller NestJS correspondente (LeadController), com rotas:
-- POST /leads
-- GET /leads
-
-Inclua:
-- DTOs de entrada/saída com class-validator
-- tratamento básico de erros (ex.: BadRequestException).
-```
-
----
-
-## 6. Testes com IA
-
-### Testes unitários (service)
-
-```text
-Aqui está a implementação do LeadService em NestJS:
-[COLE]
-
-Gere testes unitários em Jest cobrindo:
-- criação de lead válido
-- erro quando email é inválido
-- listagem de leads com paginação.
-
-Explique em 1 linha o objetivo de cada teste.
-```
-
-### Testes de integração (API)
-
-```text
-Com base no controller de leads e requisitos da API:
-[COLE]
-
-Sugira testes de integração usando o testing module do NestJS,
-validando pelo menos:
-- POST /leads com payload válido (201)
-- POST /leads com payload inválido (400)
-- GET /leads retornando lista paginada.
-```
-
----
-
-## 7. Documentação & Revisão com IA
-
-### Prompt para revisão de código
-
-```text
-Atue como revisor de código sênior em NestJS.
-
-Aqui estão os arquivos do módulo de leads (service + controller + DTOs):
-[COLE]
-
-Avalie:
-- legibilidade
-- possíveis bugs
-- aderência às boas práticas de NestJS
-
-Sugira melhorias e, se necessário, proponha refatorações.
-```
-
-### Prompt para documentação técnica
-
-```text
-Com base no módulo de leads implementado:
-[COLE]
-
-Gere uma documentação técnica resumida com:
-- o que o módulo faz
-- endpoints expostos
-- principais validações
-- dependências externas.
-```
-
----
-
-## 8. Feedback & Evolução
-
-Depois de em produção, IA pode ajudar a:
-
-- Analisar logs/erros de requisições para `POST /leads`.
-- Sugerir melhorias de UX no formulário (com apoio do Especialista em UX).
-- Encontrar oportunidades de segmentação de leads.
-
-Prompt exemplo:
-
-```text
-Aqui estão logs de erros da API de leads e alguns feedbacks de usuários:
-[COLE]
-
-Agrupe em:
-- problemas de validação
-- problemas de usabilidade
-- bugs reais
-
-Sugira melhorias de curto prazo e possíveis ajustes na arquitetura.
-```

package/dist/content/content/guides/Cat/303/241logo de Stacks para Cloud Moderna.md"

@@ -1,119 +0,0 @@
-# Catálogo de Stacks para Cloud Moderna
-
-Complemento ao catálogo de hospedagem compartilhada, focado em infraestrutura cloud.
-
----
-
-## Plano 1 – Serverless Simples
-
-**Tipo:** APIs leves, funções acionadas por eventos  
-**Complexidade:** Baixa
-
-### Stack
-- **Runtime:** Vercel Functions, Netlify Functions, AWS Lambda
-- **Banco:** PlanetScale, Supabase, Neon (PostgreSQL serverless)
-- **Auth:** Clerk, Auth0, Supabase Auth
-
-### Casos de Uso
-- APIs para landing pages
-- Webhooks e integrações
-- Backend-for-frontend (BFF)
-
----
-
-## Plano 2 – Aplicação Containerizada (PaaS)
-
-**Tipo:** Apps web completas, APIs com estado  
-**Complexidade:** Média
-
-### Stack
-- **Deploy:** Railway, Render, Fly.io
-- **Containers:** Docker
-- **Banco:** PostgreSQL gerenciado (Railway, Render, Supabase)
-- **Cache:** Redis (Upstash, Railway)
-
-### Casos de Uso
-- MVPs e apps early-stage
-- Projetos com orçamento limitado
-- Deploy rápido sem gerenciar infra
-
----
-
-## Plano 3 – AWS Estruturado
-
-**Tipo:** Sistemas de médio/grande porte  
-**Complexidade:** Alta
-
-### Stack
-- **Compute:** ECS Fargate, EC2, Lambda
-- **Banco:** RDS (PostgreSQL/MySQL), DynamoDB
-- **Storage:** S3
-- **CDN:** CloudFront
-- **Auth:** Cognito
-- **IaC:** Terraform, CDK
-
-### Casos de Uso
-- Sistemas enterprise
-- Alta disponibilidade necessária
-- Compliance (SOC2, HIPAA)
-
----
-
-## Plano 4 – GCP Moderno
-
-**Tipo:** Apps data-intensive, ML  
-**Complexidade:** Alta
-
-### Stack
-- **Compute:** Cloud Run, GKE
-- **Banco:** Cloud SQL, Firestore
-- **Data:** BigQuery, Dataflow
-- **ML:** Vertex AI
-- **IaC:** Terraform
-
-### Casos de Uso
-- Analytics e BI
-- Pipelines de ML
-- Integração com Google Workspace
-
----
-
-## Plano 5 – Kubernetes Full
-
-**Tipo:** Microserviços, multi-tenant  
-**Complexidade:** Muito Alta
-
-### Stack
-- **Orquestração:** EKS, GKE, AKS, ou self-hosted
-- **Ingress:** NGINX, Traefik
-- **Service Mesh:** Istio, Linkerd
-- **GitOps:** ArgoCD, Flux
-- **Observability:** Prometheus, Grafana, Loki
-
-### Casos de Uso
-- Microserviços em escala
-- Multi-tenant SaaS
-- Equipes grandes com autonomia
-
----
-
-## Comparativo
-
-| Critério | Serverless | PaaS | AWS/GCP | K8s Full |
-|---|---|---|---|---|
-| **Custo inicial** | Baixo | Baixo | Médio | Alto |
-| **Escala** | Auto | Auto | Configurável | Configurável |
-| **Complexidade** | Baixa | Baixa | Alta | Muito Alta |
-| **Vendor lock-in** | Alto | Médio | Médio | Baixo |
-| **Time to deploy** | Minutos | Minutos | Horas | Dias |
-
----
-
-## Relação com o Playbook
-
-Para qualquer plano cloud:
-
-1. Use o **Especialista em DevOps** para definir pipelines
-2. Use o **Especialista em Arquitetura** para decisões de design
-3. Use o **Especialista em Segurança** para IAM, secrets e compliance
-4. Documente decisões em ADRs

package/dist/content/content/guides/Cat/303/241logo de Stacks para Hospedagem Compartilhada.md"

@@ -1,147 +0,0 @@
-# Catálogo de Stacks para Hospedagem Compartilhada (PHP)
-
-Este catálogo organiza os **planos de entrega** pensando em ambientes como cPanel, Locaweb, Hostgator, Hostinger (shared hosting), onde PHP + MySQL + Apache/Nginx são o padrão e o suporte a Node.js é limitado.
-
-Cada plano pode ser usado em conjunto com o **Playbook de Desenvolvimento com IA** e os especialistas do guia.
-
----
-
-## Plano 1 – Landing Page Essencial
-
-**Tipo de produto:** landing page simples para validação de oferta.  
-**Complexidade:** baixa.
-
-### Stack técnico
-- **Frontend:** HTML5 + CSS3 + JavaScript (Alpine.js opcional para interatividade leve).  
-- **Estilo:** Tailwind CSS (compilado localmente em um único `.css`).  
-- **Backend (formulários):** script PHP simples (`mail.php` com PHPMailer ou similar) para envio de e-mail, sem banco de dados.  
-- **Deploy:** upload via FTP/SFTP ou automação (GitHub Actions → FTP Deploy).
-
-### Notas
-- Substitui funções serverless (Vercel etc.) por **PHP clássico**.  
-- É ideal para aplicar o Playbook em escala reduzida, focando:  
-  - Gestão de Produto (mensagem de valor)  
-  - UX (estrutura da página)  
-  - Desenvolvimento/Vibe Coding (HTML/CSS/JS + script PHP).
-
----
-
-## Plano 2 – Landing Page Pro (Next.js Estático + PHP API)
-
-**Tipo de produto:** landing moderna com interatividade rica, mas servida como site estático.  
-**Complexidade:** média.
-
-### Stack técnico
-- **Frontend:** Next.js 14+ (App Router) configurado com `output: 'export'`.  
-- **Estilo:** Tailwind CSS + shadcn/ui.  
-- **Backend (formulários):** API PHP externa (`api/contact.php`) recebendo POST do formulário React.  
-- **Deploy:** gerar pasta `out` (HTML/CSS/JS estáticos) e subir para `public_html`.
-
-### Notas
-- Do ponto de vista da hospedagem, é **só um site estático + um PHP** para formulário.  
-- IA pode ajudar fortemente em:
-  - UX/copy da landing  
-  - design dos componentes React  
-  - contrato da API (`contact.php`).
-
----
-
-## Plano 3 – Site Institucional (CMS Flat-File ou PHP Leve)
-
-**Tipo de produto:** site institucional com conteúdo gerenciável.  
-**Complexidade:** média.
-
-### Stack técnico
-- **Opção A (flat-file):** Grav CMS ou Kirby CMS (PHP, sem banco de dados).  
-- **Opção B (Laravel-based):** Statamic (modo Solo/Free), usando armazenamento em arquivos.  
-- **Deploy:** upload de arquivos PHP para a hospedagem.
-
-### Notas
-- Cliente ganha **painel administrativo** sem precisar de um MySQL pesado.  
-- Boa combinação com o Playbook nas etapas de:
-  - Modelagem e Arquitetura de Domínio (páginas, posts, coleções)  
-  - Desenvolvimento/Vibe Coding (temas, templates)  
-  - Testes (links, SEO, erros de navegação).
-
----
-
-## Plano 4 – Site Institucional Profissional (Laravel Puro)
-
-**Tipo de produto:** site institucional sob medida, com mais lógica e segurança.  
-**Complexidade:** média/alta.
-
-### Stack técnico
-- **Framework:** Laravel 10/11.  
-- **Frontend:** Blade Templates + Alpine.js + Tailwind CSS.  
-- **Otimização:** cache de resposta (por exemplo, Spatie Response Cache) para aproximar de performance estática.  
-- **Deploy:** deploy Laravel padrão, apontando a pasta `public`.
-
-### Notas
-- Cliente não tem acesso direto à estrutura de templates (Blade); você controla o que é dinâmico.  
-- Excelente para aplicar o Playbook:  
-  - Requisitos (quais seções são gerenciáveis)  
-  - Modelagem (páginas, blocos, SEO, formulários)  
-  - Vibe Coding (controllers, services, policies)  
-  - Testes de feature (Laravel). 
-
----
-
-## Plano 5 – Site Premium (Laravel + Filament CMS)
-
-**Tipo de produto:** site com painel administrativo premium e altamente customizável.  
-**Complexidade:** alta.
-
-### Stack técnico
-- **Core:** Laravel 10/11.  
-- **Painel Administrativo:** FilamentPHP v3.  
-- **Frontend:** Blade com componentes Livewire (parte pública) **ou** frontend separado (ex.: Astro) consumindo APIs Laravel.  
-- **Banco de Dados:** MySQL/MariaDB.
-
-### Notas
-- Ideal para quem quer fugir da "cara de WordPress".  
-- IA pode auxiliar em:
-  - definição de entidades/recursos (Filament Resources)  
-  - geração de formulários, tabelas, filtros  
-  - regras de permissão, roles, policies  
-  - migrações e seeders.
-
----
-
-## Plano 6 – Sistema Personalizado (Laravel Fullstack)
-
-**Tipo de produto:** sistemas sob medida (CRM, ERPs leves, dashboards, etc.).  
-**Complexidade:** alta.
-
-### Stack técnico
-- **Backend:** Laravel 11.  
-- **Frontend:**
-  - Inertia.js (Vue ou React) **ou**  
-  - Livewire 3 (fullstack Laravel).
-- **Infraestrutura:** MySQL; Redis se a hospedagem permitir (senão, drivers baseados em banco/arquivo para cache/filas).  
-- **Real-time:** Laravel Reverb (se houver suporte a WebSockets) ou serviços externos (ex.: Pusher).
-
-### Notas
-- É o melhor candidato para **exemplos completos do Playbook**, pois exige:
-  - requisitos sólidos  
-  - modelagem de domínio rica  
-  - decisões arquiteturais claras  
-  - estratégia de testes mais robusta.
-
----
-
-## Relação com o Playbook de Desenvolvimento com IA
-
-Para qualquer plano:
-
-- Use o **Playbook** para guiar o processo (Visão → Requisitos → Modelagem → Execução → Testes → Evolução).  
-- Use os **Especialistas** conforme o tipo de projeto:
-  - Landing simples: Gestão de Produto, UX, Desenvolvimento/Vibe Coding.  
-  - CMS/Institucional: adicionar Modelagem de Domínio, Arquitetura, Segurança.  
-  - Sistemas personalizados: todos os especialistas, com mais peso em Requisitos, Modelagem, Arquitetura, Testes e Plano de Execução.
-
-Nos próximos passos, você pode adicionar **exemplos práticos** por plano mostrando:
-
-- 1 user story  
-- sequência de prompts  
-- esqueleto de código  
-- esqueleto de testes.

package/dist/content/content/guides/Checklist Mestre de Entrega.md

@@ -1,68 +0,0 @@
-# Checklist Mestre de Entrega
-
-Definition of Done consolidado de todos os especialistas. Use antes de considerar uma feature "pronta".
-
----
-
-## ✅ Produto
-- [ ] História de usuário clara (Como/Quero/Para)
-- [ ] Critérios de aceitação definidos
-- [ ] Escopo validado com stakeholders
-
-## ✅ Requisitos
-- [ ] Requisitos funcionais documentados
-- [ ] Requisitos não-funcionais definidos
-- [ ] Dúvidas esclarecidas com cliente/PM
-
-## ✅ UX/Design
-- [ ] Fluxos de usuário mapeados (happy path + erros)
-- [ ] Wireframes/protótipos aprovados
-- [ ] Acessibilidade considerada (WCAG AA)
-
-## ✅ Arquitetura
-- [ ] Impacto no modelo de domínio analisado
-- [ ] Decisões arquiteturais documentadas (ADR)
-- [ ] APIs/contratos definidos
-
-## ✅ Código
-- [ ] Código implementado seguindo padrões do projeto
-- [ ] Code review realizado
-- [ ] Sem warnings/erros de linter
-- [ ] Commits atômicos com mensagens claras
-
-## ✅ Testes
-- [ ] Testes unitários implementados
-- [ ] Testes de integração (quando aplicável)
-- [ ] Cobertura mínima atingida (ex: 80%)
-- [ ] Testes passando no CI
-
-## ✅ Segurança
-- [ ] Validação de entrada implementada
-- [ ] Sem secrets hardcoded
-- [ ] Autenticação/autorização verificadas
-- [ ] Vulnerabilidades conhecidas checadas
-
-## ✅ Documentação
-- [ ] README atualizado (se necessário)
-- [ ] Comentários em código complexo
-- [ ] Changelog atualizado
-- [ ] API documentada (OpenAPI/Swagger)
-
-## ✅ Deploy
-- [ ] Pipeline CI/CD verde
-- [ ] Migrations preparadas
-- [ ] Rollback planejado
-- [ ] Métricas/alertas configurados
-
----
-
-## Por Fase do Projeto
-
-### MVP / v1
-Foque em: Produto, Requisitos, Código, Testes básicos
-
-### Produção
-Adicione: Segurança, Deploy, Documentação completa
-
-### Escala
-Adicione: Performance, Observabilidade, Disaster Recovery