@maestro-ai/mcp-server 1.1.0 → 2.0.0

package/dist/content/prompts/acessibilidade/analise-acessibilidade.md

@@ -1,257 +0,0 @@
-# Prompt: Análise de Acessibilidade
-
-> **Quando usar**: Durante desenvolvimento de UI ou antes de ir para produção
-> **Especialista**: UX/UI Design
-> **Nível**: Médio
-
----
-
-## Fluxo de Contexto
-
-Antes de usar este prompt, tenha em mãos:
-- URL do site/app ou código HTML/React
-- Tipo de aplicação (web, mobile, desktop)
-
-Após gerar, salve o resultado em:
-- `docs/11-acessibilidade/analise-acessibilidade.md`
-
----
-
-## Prompt Completo
-
-```text
-Atue como especialista em acessibilidade digital (WCAG).
-
-## Contexto
-
-Tipo de aplicação: [Web app / Mobile app / Site institucional]
-Framework: [React/Vue/Angular/HTML puro]
-Público-alvo: [Descreva o público, incluindo se há foco em usuários com deficiência]
-
-## Código/URL a Analisar
-
-```html
-[COLE O CÓDIGO HTML OU COMPONENTE REACT/VUE]
-```
-
-Ou: [URL do site para análise]
-
----
-
-## Sua Missão
-
-Realize uma análise de acessibilidade baseada em WCAG 2.1:
-
-### 1. Análise por Princípio WCAG
-
-#### 1.1 Perceivable (Perceptível)
-- Textos alternativos para imagens
-- Legendas para vídeos e áudios
-- Contraste de cores (mínimo 4.5:1)
-- Redimensionamento de texto (até 200%)
-- Conteúdo sem depender apenas de cor
-
-#### 1.2 Operable (Operável)
-- Navegação por teclado
-- Tempo suficiente para leitura
-- Sem elementos que causem convulsões (flashing)
-- Skip links para conteúdo principal
-- Títulos e labels claros
-
-#### 1.3 Understandable (Compreensível)
-- Texto legível e compreensível
-- Comportamento previsível
-- Ajuda na correção de erros
-- Labels em formulários
-
-#### 1.4 Robust (Robusto)
-- Compatibilidade com tecnologias assistivas
-- HTML semântico
-- ARIA roles quando necessário
-
-### 2. Checklist de Problemas
-
-Para cada problema encontrado:
-
-| Critério WCAG | Severidade | Elemento | Problema | Solução |
-|---------------|------------|----------|----------|---------|
-| [Ex: 1.1.1] | [A/AA/AAA] | [Elemento] | [Descrição] | [Como corrigir] |
-
-### 3. Navegação por Teclado
-
-- Tab order está lógico?
-- Focus visible em todos os elementos?
-- Todos os controles são acessíveis?
-- Modais capturam foco corretamente?
-- Atalhos de teclado documentados?
-
-### 4. Screen Reader
-
-- Headings hierárquicos (h1 > h2 > h3)?
-- Landmarks definidos (main, nav, aside)?
-- Live regions para conteúdo dinâmico?
-- Formulários com labels associados?
-- Tabelas com headers definidos?
-
-### 5. Contraste e Cores
-
-- Texto normal: 4.5:1 mínimo
-- Texto grande: 3:1 mínimo
-- Componentes UI: 3:1 mínimo
-- Não depende apenas de cor
-
-### 6. Formulários
-
-- Todos os inputs têm labels
-- Erros claramente identificados
-- Instruções antes do campo
-- Campos obrigatórios indicados
-- Mensagens de erro associadas ao campo
-
-### 7. Código Corrigido
-
-Forneça exemplos de código corrigido para os principais problemas:
-
-**Antes:**
-```html
-[Código com problema]
-```
-
-**Depois:**
-```html
-[Código corrigido com comentários]
-```
-
-### 8. Ferramentas de Teste
-
-Recomende ferramentas para testar:
-- Automatizadas (axe, WAVE, Lighthouse)
-- Manuais (VoiceOver, NVDA, JAWS)
-- Simuladores de daltonismo
-```
-
----
-
-## Exemplo de Uso
-
-```text
-Atue como especialista em acessibilidade digital (WCAG).
-
-## Contexto
-
-Tipo de aplicação: Web app
-Framework: React + Next.js
-Público-alvo: Clientes de salão de beleza, incluindo idosos
-
-## Código a Analisar
-
-```jsx
-function AgendamentoForm() {
-  return (
-    <div>
-      <div style={{color: '#999', background: '#fff'}}>
-        <img src="/calendar.png" />
-        <input type="text" placeholder="Seu nome" />
-        <input type="tel" placeholder="Telefone" />
-        <select>
-          <option>Selecione um serviço</option>
-          <option>Corte</option>
-          <option>Manicure</option>
-        </select>
-        <div onClick={() => submit()} style={{background: 'red', color: 'white'}}>
-          Agendar
-        </div>
-      </div>
-    </div>
-  );
-}
-```
-```
-
----
-
-## Resposta Esperada
-
-### Problemas Identificados
-
-| Critério | Severidade | Elemento | Problema | Solução |
-|----------|------------|----------|----------|---------|
-| 1.1.1 | A | img | Sem alt text | Adicionar alt="Ícone de calendário" |
-| 1.4.3 | AA | texto | Contraste #999 no branco = 2.8:1 | Usar #666 ou mais escuro |
-| 2.1.1 | A | div botão | Não acessível por teclado | Trocar por `<button>` |
-| 1.3.1 | A | form | Inputs sem labels | Adicionar `<label>` |
-| 4.1.2 | A | select | Sem identificação | Adicionar label/aria-label |
-
-### Código Corrigido
-
-```jsx
-function AgendamentoForm() {
-  return (
-    <form 
-      role="form" 
-      aria-labelledby="form-title"
-      onSubmit={handleSubmit}
-    >
-      <h2 id="form-title">Agendar horário</h2>
-      
-      {/* Imagem com alt text descritivo */}
-      <img src="/calendar.png" alt="Ícone de calendário" />
-      
-      {/* Inputs com labels associados */}
-      <div>
-        <label htmlFor="nome">Seu nome</label>
-        <input 
-          type="text" 
-          id="nome"
-          name="nome"
-          required
-          aria-required="true"
-        />
-      </div>
-      
-      <div>
-        <label htmlFor="telefone">Telefone</label>
-        <input 
-          type="tel" 
-          id="telefone"
-          name="telefone"
-          required
-          aria-required="true"
-        />
-      </div>
-      
-      <div>
-        <label htmlFor="servico">Serviço</label>
-        <select id="servico" name="servico" required>
-          <option value="">Selecione um serviço</option>
-          <option value="corte">Corte</option>
-          <option value="manicure">Manicure</option>
-        </select>
-      </div>
-      
-      {/* Botão real em vez de div clicável */}
-      <button 
-        type="submit"
-        style={{background: '#c00', color: 'white'}}
-      >
-        Agendar
-      </button>
-    </form>
-  );
-}
-```
-
----
-
-## Checklist Pós-Geração
-
-- [ ] Todas as imagens têm alt text
-- [ ] Contraste mínimo 4.5:1 verificado
-- [ ] Navegação por teclado funciona
-- [ ] Todos os inputs têm labels
-- [ ] Headings hierárquicos
-- [ ] Landmarks semânticos definidos
-- [ ] Botões usam elemento correto
-- [ ] Focus visible em todos os elementos
-- [ ] Testado com screen reader
-- [ ] Salvar em `docs/11-acessibilidade/analise-acessibilidade.md`

package/dist/content/prompts/apis/design-api-rest.md

@@ -1,303 +0,0 @@
-# Prompt: Design de API REST
-
-> **Quando usar**: Fase de arquitetura, antes de implementar endpoints
-> **Especialista**: [Arquitetura de Software](../../02-especialistas/Especialista%20em%20Arquitetura%20de%20Software.md)
-> **Nível**: Médio
-
----
-
-## Fluxo de Contexto
-
-Antes de usar este prompt, tenha em mãos:
-- `docs/CONTEXTO.md` - Entendimento do projeto
-- `docs/02-requisitos/requisitos.md` - Requisitos funcionais
-- `docs/04-modelo/modelo-dominio.md` - Entidades do sistema
-
-Após gerar, salve o resultado em:
-- `docs/06-api/api-design.md`
-- `docs/06-api/openapi.yaml` (especificação)
-
----
-
-## Prompt Completo
-
-```text
-Atue como arquiteto de APIs especializado em REST e OpenAPI.
-
-## Contexto do Projeto
-
-[COLE O CONTEÚDO DE docs/CONTEXTO.md]
-
-## Requisitos Funcionais
-
-[COLE RFs DE docs/02-requisitos/requisitos.md]
-
-## Modelo de Domínio
-
-[COLE ENTIDADES DE docs/04-modelo/modelo-dominio.md]
-
-## Configurações
-
-Versionamento: [URL path: /v1 | Header: X-API-Version | Query: ?version=1]
-Autenticação: [JWT Bearer | API Key | OAuth 2.0 | Session]
-Formato: [JSON | JSON:API | HAL]
-Base URL: [https://api.exemplo.com]
-
----
-
-## Sua Missão
-
-Projete uma API REST completa seguindo boas práticas:
-
-### 1. Recursos e Endpoints
-
-Para cada recurso (baseado nas entidades):
-
-**Recurso: /recursos**
-
-| Método | Endpoint | Descrição | Auth |
-|--------|----------|-----------|------|
-| GET | /recursos | Listar (paginado) | Sim/Não |
-| GET | /recursos/:id | Obter por ID | Sim/Não |
-| POST | /recursos | Criar | Sim/Não |
-| PUT | /recursos/:id | Atualizar completo | Sim/Não |
-| PATCH | /recursos/:id | Atualizar parcial | Sim/Não |
-| DELETE | /recursos/:id | Remover | Sim/Não |
-
-### 2. Padrões de Nomenclatura
-
-- Recursos no plural: /users, /orders
-- Kebab-case para multi-palavras: /order-items
-- IDs como path parameter: /users/:id
-- Relacionamentos: /users/:id/orders
-- Ações especiais: POST /orders/:id/cancel
-
-### 3. Query Parameters
-
-Padronize:
-- **Paginação**: page, limit (ou cursor)
-- **Ordenação**: sort=field:asc,field2:desc
-- **Filtros**: filter[field]=value
-- **Campos**: fields=id,name,email
-- **Expands**: include=orders,profile
-
-### 4. Request/Response Schemas
-
-Para cada endpoint principal, defina:
-
-**Request Body (POST/PUT)**
-```json
-{
-  "campo1": "tipo",
-  "campo2": "tipo"
-}
-```
-
-**Response Body (Sucesso)**
-```json
-{
-  "data": { ... },
-  "meta": { ... }
-}
-```
-
-**Response Body (Lista)**
-```json
-{
-  "data": [ ... ],
-  "meta": {
-    "page": 1,
-    "limit": 20,
-    "total": 100,
-    "totalPages": 5
-  }
-}
-```
-
-### 5. HTTP Status Codes
-
-| Código | Quando Usar |
-|--------|-------------|
-| 200 | Sucesso (GET, PUT, PATCH) |
-| 201 | Criado (POST) |
-| 204 | Sem conteúdo (DELETE) |
-| 400 | Request inválido |
-| 401 | Não autenticado |
-| 403 | Não autorizado |
-| 404 | Não encontrado |
-| 409 | Conflito (duplicação) |
-| 422 | Erro de validação |
-| 429 | Rate limit exceeded |
-| 500 | Erro interno |
-
-### 6. Formato de Erros
-
-```json
-{
-  "error": {
-    "code": "VALIDATION_ERROR",
-    "message": "Mensagem amigável",
-    "details": [
-      {
-        "field": "email",
-        "message": "Email inválido"
-      }
-    ],
-    "traceId": "abc-123"
-  }
-}
-```
-
-### 7. Headers
-
-**Request Headers**
-- Authorization: Bearer {token}
-- Content-Type: application/json
-- Accept: application/json
-- X-Request-ID: {uuid}
-
-**Response Headers**
-- X-Request-ID: {uuid}
-- X-RateLimit-Limit: 100
-- X-RateLimit-Remaining: 95
-- X-RateLimit-Reset: timestamp
-
-### 8. Versionamento
-
-Estratégia escolhida e como deprecar versões antigas.
-
-### 9. Segurança
-
-- Rate limiting por endpoint
-- Validação de input
-- CORS configuration
-
-### 10. OpenAPI Specification
-
-Gere a especificação OpenAPI 3.0 em YAML para os endpoints principais.
-```
-
----
-
-## Exemplo de Uso
-
-```text
-Atue como arquiteto de APIs especializado em REST e OpenAPI.
-
-## Contexto do Projeto
-
-Sistema de agendamento para salões de beleza.
-
-## Requisitos Funcionais
-
-- RF-001: Listar horários disponíveis
-- RF-002: Criar agendamento
-- RF-003: Cancelar agendamento
-- RF-004: Listar agendamentos do dia
-
-## Modelo de Domínio
-
-- Cliente (id, nome, telefone, email)
-- Servico (id, nome, duracao, preco)
-- Profissional (id, nome, especialidades)
-- Agendamento (id, clienteId, servicoId, profissionalId, dataHora, status)
-
-## Configurações
-
-Versionamento: URL path /v1
-Autenticação: JWT Bearer (admin) / Público (cliente agendando)
-Formato: JSON
-Base URL: https://api.salao.com
-```
-
----
-
-## Resposta Esperada
-
-### Recursos
-
-**Recurso: /agendamentos**
-
-| Método | Endpoint | Descrição | Auth |
-|--------|----------|-----------|------|
-| GET | /v1/agendamentos | Listar (admin) | JWT |
-| GET | /v1/agendamentos/:id | Obter | JWT |
-| POST | /v1/agendamentos | Criar | Público |
-| DELETE | /v1/agendamentos/:id | Cancelar | JWT ou Token |
-
-**Recurso: /disponibilidade**
-
-| Método | Endpoint | Descrição | Auth |
-|--------|----------|-----------|------|
-| GET | /v1/profissionais/:id/disponibilidade | Horários livres | Público |
-
-### Request/Response
-
-**POST /v1/agendamentos**
-
-Request:
-```json
-{
-  "profissionalId": "uuid",
-  "servicoId": "uuid",
-  "dataHora": "2024-01-15T14:00:00Z",
-  "cliente": {
-    "nome": "Maria Silva",
-    "telefone": "11999998888"
-  }
-}
-```
-
-Response (201):
-```json
-{
-  "data": {
-    "id": "uuid",
-    "status": "CONFIRMADO",
-    "dataHora": "2024-01-15T14:00:00Z",
-    "profissional": { "id": "uuid", "nome": "Ana" },
-    "servico": { "id": "uuid", "nome": "Corte", "duracao": 30 }
-  }
-}
-```
-
-### OpenAPI (Resumo)
-
-```yaml
-openapi: 3.0.3
-info:
-  title: API Salão de Beleza
-  version: 1.0.0
-  
-paths:
-  /v1/agendamentos:
-    post:
-      summary: Criar agendamento
-      requestBody:
-        content:
-          application/json:
-            schema:
-              $ref: '#/components/schemas/CriarAgendamento'
-      responses:
-        '201':
-          description: Agendamento criado
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/AgendamentoResponse'
-```
-
----
-
-## Checklist Pós-Geração
-
-- [ ] Todos os recursos mapeados das entidades
-- [ ] Verbos HTTP corretos para cada ação
-- [ ] Paginação padronizada
-- [ ] Formato de erro consistente
-- [ ] Status codes documentados
-- [ ] Headers de request/response definidos
-- [ ] Rate limiting especificado
-- [ ] Versionamento definido
-- [ ] OpenAPI spec gerada
-- [ ] Salvar em `docs/06-api/api-design.md`