@maestro-ai/mcp-server 1.2.0 → 2.0.0

package/dist/content/examples/Exemplo de Fluxo Completo com Java e Spring Boot.md

@@ -1,250 +0,0 @@
-# Exemplo de Fluxo Completo com Java e Spring Boot
-
-Este exemplo mostra como aplicar o **Playbook de Desenvolvimento com IA**
-para implementar uma funcionalidade simples em **Java + Spring Boot**.
-
-Funcionalidade de exemplo: **Cadastro de Clientes** em uma API REST.
-
----
-
-## 1. Visão & Problema
-
-### Contexto
-
-Precisamos de uma API que permita cadastrar clientes (nome, email, CPF) e consultá-los.
-O sistema será usado por um painel administrativo simples.
-
-### Prompt sugerido
-
-```text
-Você é um arquiteto de software sênior especializado em Java e Spring Boot.
-
-Contexto:
-- API REST de cadastro de clientes
-- Campos: nome, email, cpf
-- Banco: PostgreSQL
-
-Me ajude a descrever a visão técnica mínima dessa API, incluindo:
-- objetivo
-- atores
-- fluxos principais (criar, listar, buscar por ID)
-- riscos ou pontos de atenção.
-```
-
----
-
-## 2. Engenharia de Requisitos com IA
-
-### Requisitos funcionais (esperados)
-
-- RF1: Cadastrar cliente com `nome`, `email`, `cpf`.
-- RF2: Listar todos os clientes.
-- RF3: Buscar cliente por ID.
-
-### Requisitos não funcionais (exemplos)
-
-- RNF1: Validar formato de e-mail.
-- RNF2: Validar CPF (formato e dígitos verificadores).
-- RNF3: API deve ter logs mínimos para auditoria.
-
-### Prompt sugerido
-
-```text
-Com base na visão abaixo:
-[COLE VISÃO]
-
-Detalhe os requisitos funcionais e não funcionais para essa API de clientes.
-Inclua critérios de aceitação para cada requisito.
-```
-
----
-
-## 3. Modelagem & Arquitetura com IA
-
-### Modelo de domínio esperado
-
-Entidade `Cliente`:
-- id (Long ou UUID)
-- nome (String)
-- email (String)
-- cpf (String)
-- criadoEm (LocalDateTime)
-
-### Prompt para modelo de domínio
-
-```text
-A partir dos requisitos a seguir:
-[COLE REQUISITOS]
-
-Proponha o modelo de domínio para a entidade Cliente em Java:
-- campos e tipos
-- validações necessárias
-
-Sugira também anotações JPA/Bean Validation típicas.
-```
-
-### Prompt para arquitetura/API
-
-```text
-Com a entidade Cliente definida,
-
-Descreva a API REST em Spring Boot:
-- endpoints (método + URI)
-- payloads de requisição
-- formatos de resposta
-- códigos de status para sucesso/erro.
-```
-
----
-
-## 4. Planejamento / Backlog com IA
-
-### User story
-
-```text
-Como um atendente do sistema administrativo,
-Quero cadastrar e consultar clientes,
-Para que eu possa gerenciar o relacionamento com eles.
-```
-
-### Prompt para backlog
-
-```text
-Usando a user story e os requisitos abaixo:
-[COLE]
-
-Crie uma lista de tarefas técnicas para implementar essa API em Spring Boot:
-- criação da entidade JPA
-- criação do repositório (Spring Data JPA)
-- criação do service
-- criação do controller
-- testes unitários e de integração.
-
-Ordene as tarefas na sequência recomendada.
-```
-
----
-
-## 5. Implementação (Vibe Coding Estruturado) com IA
-
-### Passo 1 – Entidade + Repositório
-
-```text
-Vamos implementar a entidade Cliente e o repositório em Spring Boot.
-
-Requisitos da entidade:
-- id, nome, email, cpf, criadoEm
-- validação de email
-- validação simples de CPF (não vazio, formato XXX.XXX.XXX-YY ou só dígitos)
-
-Gere o código da classe `Cliente` anotada com JPA e Bean Validation,
-e a interface `ClienteRepository` com Spring Data JPA.
-```
-
-### Passo 2 – Service
-
-```text
-Com base na entidade Cliente e no ClienteRepository:
-[COLE DECLARAÇÕES]
-
-Implemente o `ClienteService` com métodos:
-- criarCliente(dto)
-- listarClientes()
-- buscarPorId(id)
-
-Inclua validações de negócio básicas e tratamento de erros.
-```
-
-### Passo 3 – Controller
-
-```text
-Agora gere o `ClienteController` em Spring Boot expondo:
-- POST /clientes
-- GET /clientes
-- GET /clientes/{id}
-
-Use DTOs para entrada/saída, ResponseEntity para respostas,
- e retorne códigos apropriados (201, 200, 404, 400).
-```
-
----
-
-## 6. Testes com IA
-
-### Testes unitários (service)
-
-```text
-Aqui está a implementação de ClienteService:
-[COLE]
-
-Gere testes unitários com JUnit + Mockito cobrindo:
-- criação de cliente válido
-- erro ao tentar criar cliente com email inválido
-- erro ao buscar cliente inexistente.
-```
-
-### Testes de integração (API)
-
-```text
-Com base no ClienteController e na configuração Spring Boot padrão:
-[COLE]
-
-Sugira testes de integração usando @SpringBootTest ou @WebMvcTest,
-validando:
-- POST /clientes com payload válido (201)
-- POST /clientes com email inválido (400)
-- GET /clientes retornando lista
-- GET /clientes/{id} para cliente inexistente (404).
-```
-
----
-
-## 7. Documentação & Revisão com IA
-
-### Prompt para documentação técnica
-
-```text
-Considere a API de clientes implementada em Spring Boot.
-
-Gere uma documentação técnica em formato Markdown contendo:
-- visão geral da API
-- endpoints
-- exemplos de requisição/resposta
-- principais validações e erros.
-```
-
-### Prompt para revisão de código
-
-```text
-Atue como revisor de código sênior em Java.
-
-Aqui estão as classes Cliente, ClienteService e ClienteController:
-[COLE]
-
-Avalie qualidade de código, manutenibilidade e possíveis bugs.
-Sugira melhorias e refatorações se necessário.
-```
-
----
-
-## 8. Feedback & Evolução
-
-Depois que a API estiver em produção, IA pode ajudar a:
-
-- analisar logs de erro
-- sugerir melhorias de validação
-- propor campos adicionais úteis (telefone, endereço etc.).
-
-Prompt exemplo:
-
-```text
-Aqui estão registros de erros e feedbacks de usuários sobre o cadastro de clientes:
-[COLE]
-
-Classifique em:
-- bugs
-- problemas de UX da API (mensagens confusas, validações frágeis)
-- melhorias de produto.
-
-Sugira ajustes de curto prazo e evoluções possíveis.
-```

package/dist/content/examples/Exemplo de Fluxo Completo com Laravel e Filament.md

@@ -1,278 +0,0 @@
-# Exemplo de Fluxo Completo com Laravel e Filament (Plano 5)
-
-Este exemplo mostra, de forma resumida, como aplicar o **Playbook de Desenvolvimento com IA**
-para construir um **Site Premium com painel administrativo em Laravel + Filament**.
-
-Funcionalidade de exemplo: **Gestão de Posts de Blog** (CRUD de posts com categorias).
-
-Stack alvo (alinhada ao Plano 5):
-- Laravel 10/11
-- FilamentPHP v3
-- MySQL/MariaDB
-- Hospedagem compartilhada (cPanel/Hostinger/Locaweb etc.).
-
----
-
-## 1. Visão & Problema
-
-### Contexto
-
-Cliente quer um site institucional com blog gerenciável via painel.
-Precisa:
-- criar/editar posts
-- categorizar conteúdos
-- agendar publicação (opcional)
-- ter URL amigável (slug).
-
-### Prompt sugerido
-
-```text
-Você é um engenheiro de software sênior especialista em Laravel e FilamentPHP.
-
-Contexto:
-- Site institucional com blog
-- Painel administrativo em Filament
-- Banco: MySQL
-- Hospedagem: compartilhada (cPanel/Hostinger etc.)
-
-Me ajude a descrever a visão técnica mínima para um módulo de posts de blog,
-incluindo:
-- objetivo
-- atores (admin, editor)
-- fluxos principais (criar, editar, listar, publicar)
-- riscos ou dúvidas técnicas.
-```
-
----
-
-## 2. Engenharia de Requisitos com IA
-
-### Requisitos funcionais (esperados)
-
-- RF1: Criar post com título, slug, conteúdo, categoria(s), status (rascunho/publicado).
-- RF2: Editar post existente.
-- RF3: Listar posts com filtros por categoria/status.
-- RF4: Agendar data de publicação (opcional).
-- RF5: Exibir posts publicados no site público.
-
-### Requisitos não funcionais (exemplos)
-
-- RNF1: Painel responsivo e fácil de usar.
-- RNF2: Permissões de acesso (somente usuários autenticados no Filament).
-- RNF3: URLs amigáveis e estáveis.
-
-### Prompt sugerido
-
-```text
-A partir da visão abaixo, detalhe os requisitos funcionais e não funcionais
-para o módulo de posts de blog:
-
-[COLE VISÃO]
-
-Inclua critérios de aceitação em bullets para cada requisito.
-```
-
----
-
-## 3. Modelagem & Arquitetura com IA
-
-### Modelo de domínio esperado
-
-Entidades principais:
-- `Post`  
-  - id, title, slug, content, status, published_at, created_at, updated_at
-- `Category`  
-  - id, name, slug
-- Relação `Post` N–N `Category`.
-
-### Prompt para modelo de domínio + migrações
-
-```text
-Com base nestes requisitos do módulo de posts:
-[COLE REQUISITOS]
-
-Proponha um modelo de domínio em Laravel,
-com:
-- entidades/tabelas
-- campos e tipos
-- relacionamentos
-
-Gere um esboço das migrações (tabelas posts, categories e tabela pivô),
-sem se preocupar com detalhes de sintaxe.
-```
-
-### Prompt para arquitetura (Laravel + Filament)
-
-```text
-Considerando:
-- Laravel 11
-- Filament v3 para painel administrativo
-
-Descreva a arquitetura do módulo de posts:
-- quais Models serão necessários
-- quais Filament Resources (PostResource, CategoryResource)
-- como será o fluxo entre CRUD do painel e exibição pública dos posts (Blade views).
-```
-
----
-
-## 4. Planejamento / Backlog com IA
-
-### User story principal
-
-```text
-Como um editor de conteúdo,
-Quero criar, editar e publicar posts de blog pelo painel,
-Para manter o site institucional sempre atualizado.
-```
-
-### Prompt para backlog técnico
-
-```text
-Usando a user story e os requisitos abaixo:
-[COLE]
-
-Gere uma lista de tarefas técnicas para implementar o módulo de posts
-em Laravel + Filament, incluindo:
-- migrações
-- models
-- Filament Resources (forms e tables)
-- rotas e controllers/blade para exibição pública
-- testes básicos (pelo menos de modelo e das rotas públicas).
-
-Organize as tarefas em ordem recomendada.
-```
-
----
-
-## 5. Implementação (Vibe Coding Estruturado) com IA
-
-### 5.1. Models e migrações
-
-```text
-Vamos implementar os models e migrações para Post e Category em Laravel.
-
-Requisitos de Post:
-- title (string)
-- slug (string único)
-- content (longText)
-- status (enum: draft/published)
-- published_at (nullable datetime)
-
-Requisitos de Category:
-- name (string)
-- slug (string único)
-
-Gere o código das migrações e models com relacionamentos adequados.
-Não gere nada de Filament ainda.
-```
-
-### 5.2. Filament Resources
-
-```text
-Com base nos models Post e Category:
-[COLE DECLARAÇÕES]
-
-Gere o PostResource do Filament com:
-- formulário de criação/edição (title, slug, content, categories, status, published_at)
-- tabela com colunas básicas (title, status, published_at)
-- filtros por categoria e status.
-
-Depois gere o CategoryResource básico.
-```
-
-### 5.3. Rotas e views públicas
-
-```text
-Agora gere as rotas e controllers para exibir posts publicados no site público,
-usando Blade:
-
-- GET /blog -> lista de posts publicados (com paginação)
-- GET /blog/{slug} -> post individual
-
-Inclua consultas usando o model Post e as relações com Category.
-```
-
----
-
-## 6. Testes com IA
-
-### Testes de modelo
-
-```text
-Aqui estão os models Post e Category:
-[COLE]
-
-Gere testes de modelo em PHPUnit cobrindo:
-- criação de um post com categorias
-- geração e unicidade de slug (se houver lógica específica)
-- escopo para filtrar apenas posts publicados.
-```
-
-### Testes de rotas públicas
-
-```text
-Considere as rotas /blog e /blog/{slug}:
-[COLE CONTROLLERS/ROTAS]
-
-Sugira testes de feature em Laravel testando:
-- listagem de posts publicados
-- não exibição de posts em rascunho
-- acesso a um post específico por slug (200)
-- 404 para slug inexistente.
-```
-
----
-
-## 7. Documentação & Revisão com IA
-
-### Documentação do módulo
-
-```text
-Com base nos requisitos e no código do módulo de posts (models, resources, controllers):
-[COLE]
-
-Gere uma documentação técnica resumida contendo:
-- visão geral do módulo
-- modelos e relacionamentos
-- rotas principais (painel e público)
-- pontos de extensão (ex.: tags, comentários no futuro).
-```
-
-### Revisão de segurança mínima
-
-```text
-Aqui está a descrição do módulo de posts e os arquivos relevantes:
-[COLE]
-
-Avalie sob a ótica de segurança e boas práticas:
-- permissões de acesso ao painel Filament
-- exposição de dados públicos
-- risco de XSS no conteúdo do post
-
-Sugira medidas de mitigação (ex.: sanitização de HTML, policies, etc.).
-```
-
----
-
-## 8. Feedback & Evolução
-
-Depois de em produção, IA pode ajudar a:
-
-- analisar quais posts têm mais tráfego (dados de analytics)
-- sugerir melhorias de UX na listagem de posts
-- propor novos campos ou tipos de conteúdo (ex.: destaques, autorias, tags).
-
-Prompt exemplo:
-
-```text
-Aqui estão métricas de acesso ao blog e feedbacks dos usuários:
-[COLE]
-
-Classifique em:
-- melhorias de UX
-- necessidades de novos tipos de conteúdo
-- ajustes técnicos
-
-Sugira uma pequena roadmap de evolução do módulo de blog.
-```