@maestro-ai/mcp-server 1.0.0 → 1.0.1

package/dist/content/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.
-```

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

@@ -1,261 +0,0 @@
-# Exemplo de Fluxo Completo com Laravel e Livewire (Plano 6)
-
-Este exemplo mostra como aplicar o **Playbook de Desenvolvimento com IA**
-para um **Sistema Personalizado** em **Laravel + Livewire**.
-
-Funcionalidade de exemplo: **Gestão de Tarefas (To-Do Kanban simples)**.
-
-Stack alvo (alinhada ao Plano 6):
-- Laravel 11
-- Livewire 3
-- Tailwind CSS
-- MySQL/MariaDB
-- Hospedagem compartilhada.
-
----
-
-## 1. Visão & Problema
-
-### Contexto
-
-Sistema interno simples para um pequeno time organizar tarefas em colunas:
-- A Fazer
-- Em Progresso
-- Concluído
-
-Cada tarefa tem título, descrição, responsável e prazo.
-
-### Prompt sugerido
-
-```text
-Você é um engenheiro de software sênior especialista em Laravel + Livewire.
-
-Contexto:
-- Sistema interno de gestão de tarefas em estilo Kanban simples
-- Colunas: A Fazer, Em Progresso, Concluído
-- Campos da tarefa: título, descrição, responsável, prazo
-
-Me ajude a descrever a visão técnica mínima dessa funcionalidade,
-incluindo:
-- atores
-- fluxos principais
-- riscos ou dúvidas técnicas.
-```
-
----
-
-## 2. Engenharia de Requisitos com IA
-
-### Requisitos funcionais (esperados)
-
-- RF1: Criar tarefa com título, descrição, responsável, prazo, status inicial "A Fazer".
-- RF2: Mover tarefa entre colunas (status).
-- RF3: Editar tarefa.
-- RF4: Listar tarefas por coluna.
-
-### Requisitos não funcionais (exemplos)
-
-- RNF1: Interface responsiva com atualização em tempo real (sem recarregar página).
-- RNF2: Simplicidade de uso para equipe não técnica.
-
-### Prompt sugerido
-
-```text
-A partir da visão abaixo:
-[COLE VISÃO]
-
-Liste requisitos funcionais e não funcionais para o sistema de tarefas,
-com critérios de aceitação em bullets.
-```
-
----
-
-## 3. Modelagem & Arquitetura com IA
-
-### Modelo de domínio esperado
-
-Entidade `Task`:
-- id
-- title
-- description
-- assignee (string ou relação futura com usuário)
-- due_date
-- status (enum: todo, doing, done)
-- created_at, updated_at
-
-### Prompt para modelo de domínio
-
-```text
-Com base nestes requisitos do sistema de tarefas:
-[COLE REQUISITOS]
-
-Proponha o modelo de domínio em Laravel para a entidade Task,
-com campos, tipos e enum de status.
-
-Gere um esboço da migração e do model Task com casts apropriados.
-```
-
-### Prompt para arquitetura (components Livewire)
-
-```text
-Quero implementar a interface em Livewire 3.
-
-Descreva uma arquitetura de componentes Livewire para o Kanban,
-com:
-- um componente principal (ex.: TaskBoard)
-- componentes para cada coluna ou lista de tarefas (opcional)
-- eventos necessários para criar, atualizar e mover tarefas.
-```
-
----
-
-## 4. Planejamento / Backlog com IA
-
-### User story principal
-
-```text
-Como membro da equipe,
-Quero organizar minhas tarefas em colunas,
-Para ter clareza do que fazer e do que já foi concluído.
-```
-
-### Prompt para backlog
-
-```text
-Usando a user story e requisitos abaixo:
-[COLE]
-
-Gere uma lista de tarefas técnicas para implementar essa funcionalidade
-em Laravel + Livewire 3, incluindo:
-- migração e model Task
-- componentes Livewire necessários
-- rotas e views
-- testes básicos (modelo e componentes).
-
-Organize as tarefas em ordem de execução recomendada.
-```
-
----
-
-## 5. Implementação (Vibe Coding Estruturado) com IA
-
-### 5.1. Model e migração
-
-```text
-Vamos implementar a migração e o model Task em Laravel.
-
-Campos:
-- title (string, obrigatório)
-- description (text, opcional)
-- assignee (string, opcional)
-- due_date (date, opcional)
-- status (string ou enum: todo, doing, done; default todo)
-
-Gere o código da migração e do model Task,
-com casts/atributos necessários.
-```
-
-### 5.2. Componente Livewire principal
-
-```text
-Com base no model Task:
-[COLE]
-
-Gere um componente Livewire `TaskBoard` que:
-- carregue tarefas agrupadas por status
-- permita criar nova tarefa (form inline ou modal)
-- permita alterar o status de uma tarefa (ex.: via dropdown ou botões)
-
-Use Tailwind CSS para a estrutura básica do layout (3 colunas).
-```
-
-### 5.3. Interações e UX
-
-```text
-Aqui está o esqueleto do componente TaskBoard:
-[COLE]
-
-Sugira melhorias de UX:
-- feedback visual ao mover tarefas
-- confirmações para exclusão (se houver)
-- tratamento de erros (validação de formulário, falha de salvamento).
-
-Gere o código ajustado considerando essas melhorias.
-```
-
----
-
-## 6. Testes com IA
-
-### Testes de modelo
-
-```text
-Aqui está o model Task:
-[COLE]
-
-Gere testes de modelo em PHPUnit verificando:
-- criação de tarefa válida
-- valor default de status (todo)
-- comportamento de campos opcionais.
-```
-
-### Testes de componente Livewire
-
-```text
-Aqui está o componente TaskBoard:
-[COLE]
-
-Sugira testes de componente Livewire para:
-- exibir tarefas por coluna corretamente
-- criar uma nova tarefa via formulário
-- mover tarefa de uma coluna para outra.
-```
-
----
-
-## 7. Documentação & Revisão com IA
-
-### Documentação funcional
-
-```text
-Com base nos requisitos e no código do sistema de tarefas:
-[COLE]
-
-Gere uma documentação funcional em linguagem de negócio,
-explicando:
-- o que o sistema faz
-- como usar o quadro Kanban
-- principais limitações da primeira versão.
-```
-
-### Revisão técnica
-
-```text
-Atue como revisor de código sênior em Laravel + Livewire.
-
-Aqui estão o model Task e o componente TaskBoard:
-[COLE]
-
-Avalie legibilidade, simplicidade e possíveis problemas de performance/usabilidade.
-Sugira refatorações se necessário.
-```
-
----
-
-## 8. Feedback & Evolução
-
-Depois de em uso, IA pode ajudar a:
-
-- analisar padrões de tarefas (onde ficam presas: todo/doing)
-- sugerir novas colunas ou estados
-- propor filtros (por responsável, prazo, tags).
-
-Prompt exemplo:
-
-```text
-Aqui estão dados exportados do sistema de tarefas (status, datas, responsáveis):
-[COLE]
-
-Identifique padrões (ex.: tarefas que demoram mais em cada status)
- e sugira melhorias de fluxo para o time.
-```