@maestro-ai/mcp-server 1.2.0 → 2.1.0

package/dist/content/prompts/testes/testes-performance.md

@@ -1,458 +0,0 @@
-# Prompt: Testes de Performance
-
-> **Quando usar**: Antes de ir para produção, ou ao identificar gargalos
-> **Especialista**: [Performance e Escalabilidade](../../02-especialistas/Especialista%20em%20Performance%20e%20Escalabilidade.md)
-> **Nível**: Médio a Complexo
-
----
-
-## Fluxo de Contexto
-
-Antes de usar este prompt, tenha em mãos:
-- `docs/CONTEXTO.md` - Entendimento do projeto
-- `docs/05-arquitetura/arquitetura.md` - Arquitetura e endpoints
-- Requisitos de performance (SLAs/SLOs)
-
-Após gerar, salve o resultado em:
-- `tests/performance/` - Scripts de teste
-- `docs/10-performance/baseline.md` - Resultados
-
----
-
-## Prompt Completo
-
-```text
-Atue como especialista em testes de performance e load testing.
-
-## Contexto do Projeto
-
-[COLE O CONTEÚDO DE docs/CONTEXTO.md]
-
-## Stack Tecnológica
-
-- Backend: [Framework/Linguagem]
-- Banco de dados: [Tipo]
-- Cache: [Redis/Memcached/Nenhum]
-- Infra: [Cloud provider, região]
-
-## Endpoints a Testar
-
-| Endpoint | Método | Criticidade | SLA (p95) |
-|----------|--------|-------------|-----------|
-| /api/auth/login | POST | Alta | 200ms |
-| /api/products | GET | Alta | 100ms |
-| /api/orders | POST | Crítica | 500ms |
-
-## Requisitos de Performance
-
-- Usuários simultâneos esperados: [número]
-- Requests por segundo (RPS): [número]
-- Latência p95 aceitável: [ms]
-- Latência p99 aceitável: [ms]
-- Taxa de erro aceitável: [%]
-
-## Ferramenta
-
-- [ ] k6
-- [ ] Artillery
-- [ ] JMeter
-- [ ] Locust
-- [ ] Gatling
-
----
-
-## Sua Missão
-
-Gere testes de performance completos:
-
-### 1. Estrutura do Projeto
-
-```
-tests/performance/
-├── scripts/
-│   ├── smoke.js
-│   ├── load.js
-│   ├── stress.js
-│   └── soak.js
-├── scenarios/
-│   ├── auth-flow.js
-│   └── checkout-flow.js
-├── lib/
-│   ├── helpers.js
-│   └── config.js
-├── data/
-│   └── users.csv
-└── results/
-    └── .gitkeep
-```
-
-### 2. Configuração Base (k6)
-
-```javascript
-// lib/config.js
-export const BASE_URL = __ENV.BASE_URL || 'http://localhost:3000';
-
-export const thresholds = {
-  http_req_duration: ['p(95)<200', 'p(99)<500'],
-  http_req_failed: ['rate<0.01'],  // < 1% de erro
-  http_reqs: ['rate>100'],          // > 100 RPS
-};
-
-export const defaultHeaders = {
-  'Content-Type': 'application/json',
-  'Accept': 'application/json',
-};
-
-// lib/helpers.js
-import http from 'k6/http';
-import { check, sleep } from 'k6';
-import { BASE_URL, defaultHeaders } from './config.js';
-
-export function login(email, password) {
-  const res = http.post(
-    `${BASE_URL}/api/auth/login`,
-    JSON.stringify({ email, password }),
-    { headers: defaultHeaders }
-  );
-  
-  check(res, {
-    'login successful': (r) => r.status === 200,
-    'has token': (r) => r.json('token') !== undefined,
-  });
-  
-  return res.json('token');
-}
-
-export function authenticatedRequest(token) {
-  return {
-    ...defaultHeaders,
-    'Authorization': `Bearer ${token}`,
-  };
-}
-```
-
-### 3. Smoke Test (Verificação Básica)
-
-```javascript
-// scripts/smoke.js
-import http from 'k6/http';
-import { check, sleep } from 'k6';
-import { BASE_URL } from '../lib/config.js';
-import { login } from '../lib/helpers.js';
-
-export const options = {
-  vus: 1,
-  duration: '1m',
-  thresholds: {
-    http_req_duration: ['p(99)<1500'],
-    http_req_failed: ['rate<0.05'],
-  },
-};
-
-export default function () {
-  // Health check
-  let res = http.get(`${BASE_URL}/api/health`);
-  check(res, {
-    'health check ok': (r) => r.status === 200,
-  });
-
-  // Login
-  const token = login('test@example.com', 'Test123!');
-  
-  // Endpoint protegido
-  res = http.get(`${BASE_URL}/api/me`, {
-    headers: { Authorization: `Bearer ${token}` },
-  });
-  check(res, {
-    'authenticated request ok': (r) => r.status === 200,
-  });
-
-  sleep(1);
-}
-```
-
-### 4. Load Test (Carga Normal)
-
-```javascript
-// scripts/load.js
-import http from 'k6/http';
-import { check, sleep, group } from 'k6';
-import { Counter, Trend } from 'k6/metrics';
-import { BASE_URL, thresholds, defaultHeaders } from '../lib/config.js';
-import { login, authenticatedRequest } from '../lib/helpers.js';
-
-// Custom metrics
-const ordersCreated = new Counter('orders_created');
-const orderDuration = new Trend('order_duration');
-
-export const options = {
-  stages: [
-    { duration: '2m', target: 50 },   // Ramp up
-    { duration: '5m', target: 50 },   // Stay at 50 VUs
-    { duration: '2m', target: 100 },  // Ramp up more
-    { duration: '5m', target: 100 },  // Stay at 100 VUs
-    { duration: '2m', target: 0 },    // Ramp down
-  ],
-  thresholds: {
-    http_req_duration: ['p(95)<200', 'p(99)<500'],
-    http_req_failed: ['rate<0.01'],
-    orders_created: ['count>100'],
-    order_duration: ['p(95)<1000'],
-  },
-};
-
-export function setup() {
-  // Preparar dados de teste
-  const token = login('loadtest@example.com', 'Test123!');
-  return { token };
-}
-
-export default function (data) {
-  const headers = authenticatedRequest(data.token);
-  
-  group('browsing', () => {
-    // Listar produtos
-    let res = http.get(`${BASE_URL}/api/products`, { headers });
-    check(res, {
-      'products loaded': (r) => r.status === 200,
-      'has products': (r) => r.json('data').length > 0,
-    });
-    
-    sleep(Math.random() * 2); // Think time
-    
-    // Ver detalhes
-    res = http.get(`${BASE_URL}/api/products/1`, { headers });
-    check(res, { 'product detail ok': (r) => r.status === 200 });
-  });
-
-  group('checkout', () => {
-    const start = Date.now();
-    
-    // Criar pedido
-    const orderData = {
-      items: [{ productId: 1, quantity: 1 }],
-      addressId: 1,
-    };
-    
-    const res = http.post(
-      `${BASE_URL}/api/orders`,
-      JSON.stringify(orderData),
-      { headers }
-    );
-    
-    const success = check(res, {
-      'order created': (r) => r.status === 201,
-    });
-    
-    if (success) {
-      ordersCreated.add(1);
-    }
-    
-    orderDuration.add(Date.now() - start);
-  });
-
-  sleep(1);
-}
-```
-
-### 5. Stress Test (Encontrar Limite)
-
-```javascript
-// scripts/stress.js
-import http from 'k6/http';
-import { check, sleep } from 'k6';
-import { BASE_URL } from '../lib/config.js';
-
-export const options = {
-  stages: [
-    { duration: '2m', target: 100 },
-    { duration: '5m', target: 100 },
-    { duration: '2m', target: 200 },
-    { duration: '5m', target: 200 },
-    { duration: '2m', target: 300 },  // Acima do esperado
-    { duration: '5m', target: 300 },
-    { duration: '2m', target: 400 },  // Estressar
-    { duration: '5m', target: 400 },
-    { duration: '10m', target: 0 },   // Recovery
-  ],
-  thresholds: {
-    http_req_duration: ['p(95)<500'],  // Mais tolerante
-    http_req_failed: ['rate<0.10'],     // Até 10% de erro
-  },
-};
-
-export default function () {
-  const res = http.get(`${BASE_URL}/api/products`);
-  check(res, {
-    'status is 200 or 503': (r) => [200, 503].includes(r.status),
-  });
-  sleep(0.5);
-}
-```
-
-### 6. Soak Test (Longa Duração)
-
-```javascript
-// scripts/soak.js
-import http from 'k6/http';
-import { check, sleep } from 'k6';
-import { BASE_URL } from '../lib/config.js';
-import { login, authenticatedRequest } from '../lib/helpers.js';
-
-export const options = {
-  stages: [
-    { duration: '5m', target: 50 },   // Ramp up
-    { duration: '4h', target: 50 },   // 4 horas de carga constante
-    { duration: '5m', target: 0 },    // Ramp down
-  ],
-  thresholds: {
-    http_req_duration: ['p(95)<200'],
-    http_req_failed: ['rate<0.01'],
-  },
-};
-
-// Detecção de memory leak: monitorar métricas do servidor
-// durante a execução deste teste
-```
-
-### 7. Cenário de Fluxo Realista
-
-```javascript
-// scenarios/checkout-flow.js
-import http from 'k6/http';
-import { check, sleep, group } from 'k6';
-import { SharedArray } from 'k6/data';
-import { BASE_URL } from '../lib/config.js';
-
-// Carregar dados de usuários de CSV
-const users = new SharedArray('users', function () {
-  return open('../data/users.csv').split('\n').slice(1).map(line => {
-    const [email, password] = line.split(',');
-    return { email, password };
-  });
-});
-
-export const options = {
-  scenarios: {
-    checkout_flow: {
-      executor: 'ramping-vus',
-      startVUs: 0,
-      stages: [
-        { duration: '5m', target: 20 },
-        { duration: '10m', target: 20 },
-        { duration: '5m', target: 0 },
-      ],
-    },
-  },
-};
-
-export default function () {
-  const user = users[Math.floor(Math.random() * users.length)];
-  
-  group('1. Login', () => {
-    const res = http.post(`${BASE_URL}/api/auth/login`, 
-      JSON.stringify(user),
-      { headers: { 'Content-Type': 'application/json' } }
-    );
-    check(res, { 'login ok': (r) => r.status === 200 });
-    return res.json('token');
-  });
-  
-  sleep(2); // Thinking time
-  
-  group('2. Browse products', () => {
-    http.get(`${BASE_URL}/api/products`);
-    sleep(3);
-    http.get(`${BASE_URL}/api/products/featured`);
-    sleep(2);
-  });
-  
-  group('3. Add to cart', () => {
-    http.post(`${BASE_URL}/api/cart/items`, 
-      JSON.stringify({ productId: 1, quantity: 1 })
-    );
-    sleep(1);
-  });
-  
-  group('4. Checkout', () => {
-    http.get(`${BASE_URL}/api/cart`);
-    sleep(2);
-    http.post(`${BASE_URL}/api/orders`, JSON.stringify({ /* ... */ }));
-  });
-  
-  sleep(5);
-}
-```
-
-### 8. Análise de Resultados
-
-```javascript
-// handleSummary para relatório customizado
-export function handleSummary(data) {
-  const summary = {
-    timestamp: new Date().toISOString(),
-    duration: data.state.testRunDurationMs,
-    metrics: {
-      http_reqs: data.metrics.http_reqs?.values?.count || 0,
-      http_req_duration_p95: data.metrics.http_req_duration?.values['p(95)'],
-      http_req_duration_p99: data.metrics.http_req_duration?.values['p(99)'],
-      http_req_failed_rate: data.metrics.http_req_failed?.values?.rate,
-    },
-    thresholds: data.thresholds,
-  };
-
-  return {
-    'results/summary.json': JSON.stringify(summary, null, 2),
-    'results/report.html': htmlReport(data),
-    stdout: textSummary(data, { indent: ' ', enableColors: true }),
-  };
-}
-```
-
-### 9. Comandos e CI
-
-```bash
-# Executar testes
-k6 run scripts/smoke.js
-k6 run scripts/load.js --env BASE_URL=https://staging.example.com
-k6 run scripts/stress.js --out json=results/stress.json
-
-# Com métricas para Grafana
-k6 run scripts/load.js --out influxdb=http://localhost:8086/k6
-```
-
-```yaml
-# .github/workflows/performance.yml
-name: Performance Tests
-
-on:
-  workflow_dispatch:
-  schedule:
-    - cron: '0 6 * * *'  # Diário às 6h
-
-jobs:
-  load-test:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: grafana/k6-action@v0.3.1
-        with:
-          filename: tests/performance/scripts/load.js
-          flags: --env BASE_URL=${{ secrets.STAGING_URL }}
-```
-```
-
----
-
-## Checklist Pós-Geração
-
-- [ ] Smoke test criado (verificação rápida)
-- [ ] Load test com cenário realista
-- [ ] Stress test para encontrar limites
-- [ ] Soak test para detecção de leaks (opcional)
-- [ ] Thresholds definidos (latência, erro, RPS)
-- [ ] Custom metrics para métricas de negócio
-- [ ] Think times realistas entre requests
-- [ ] Dados de teste variados (CSV/JSON)
-- [ ] handleSummary para relatórios
-- [ ] CI configurado para execução regular

package/dist/content/prompts/ux/gerar-ui-stitch.md

@@ -1,151 +0,0 @@
-# Prompt: Gerar Prompts para Google Stitch
-
-## Quando Usar
-Após ter os requisitos definidos, use este prompt para gerar entradas otimizadas para o Google Stitch (stitch.withgoogle.com).
-
----
-
-## Prompt Principal
-
-```text
-Atue como especialista em UI/UX e prototipagem com IA.
-
-Contexto do projeto:
-[COLE O CONTEÚDO DE docs/CONTEXTO.md]
-
-Requisitos funcionais:
-[COLE OS RFs DE docs/02-requisitos/requisitos.md]
-
-Sua tarefa: Gerar prompts otimizados em INGLÊS para o Google Stitch 
-(stitch.withgoogle.com) que criarão protótipos de UI de alta qualidade.
-
-Para cada tela principal do sistema, forneça:
-
-## Tela: [Nome em português]
-
-### Prompt para o Stitch (copiar e colar)
-```
-[Prompt em inglês, 3-6 linhas, detalhado]
-```
-
-### Componentes Esperados
-- [Lista de componentes que devem aparecer]
-
-### Campos de Dados
-- [Campos que precisam existir, mapeados aos requisitos]
-
-### Sugestão Visual
-- Tema: [dark/light]
-- Cor principal: [hex ou nome]
-- Estilo: [modern/minimal/corporate/playful]
-
----
-
-Gere prompts para as seguintes telas principais:
-1. [Tela de login/home]
-2. [Dashboard/listagem principal]
-3. [Formulário principal]
-4. [Detalhes/visualização]
-5. [Outras telas críticas baseadas nos requisitos]
-
-Dicas para os prompts:
-- Use inglês (Stitch funciona melhor)
-- Seja específico sobre layout e componentes
-- Mencione cores e tema
-- Descreva hierarquia visual
-- Inclua tipo (mobile app / web app / dashboard)
-```
-
----
-
-## Prompt de Análise (Após Testar no Stitch)
-
-```text
-Testei o protótipo no Google Stitch e exportei o código.
-
-Contexto do projeto:
-[COLE O CONTEÚDO DE docs/CONTEXTO.md]
-
-Código HTML/CSS ou React gerado:
-[COLE O CÓDIGO]
-
-Analise o código gerado e:
-
-## 1. Componentes Identificados
-Liste cada componente visual encontrado no código.
-
-## 2. Mapeamento para o Domínio
-Relacione elementos de UI com entidades/campos dos requisitos.
-
-## 3. Componentes Reutilizáveis
-Identifique padrões que aparecem múltiplas vezes e podem virar componentes.
-
-## 4. Estrutura de Pastas Sugerida
-Proponha organização para os componentes no projeto.
-
-## 5. Ajustes Necessários
-O que precisa ser modificado para alinhar com a arquitetura planejada?
-
-## 6. Próximos Passos
-O que o UX Designer deve refinar a partir deste protótipo?
-```
-
----
-
-## Exemplos de Prompts de Alta Qualidade
-
-### Dashboard SaaS
-```
-Create a modern SaaS analytics dashboard with:
-- Top navbar: logo on left, search bar center, user avatar and notification bell right
-- Left sidebar: collapsible menu with icons for Dashboard, Analytics, Reports, Settings
-- Main area: 4 KPI cards in a row showing metrics with sparkline charts
-- Below cards: large area chart showing trends over time
-- Bottom section: data table with sortable columns and pagination
-- Use Inter font, white background, blue (#3B82F6) accent color
-- Add subtle shadows and rounded corners for modern feel
-```
-
-### Mobile E-commerce
-```
-Design a mobile product listing page for a fashion e-commerce app:
-- Top: search bar with filter icon and cart badge
-- Category pills: horizontally scrollable chips for Women, Men, Kids, Sale
-- Product grid: 2 columns of product cards with image, name, price, heart icon
-- Each card has rounded corners and subtle shadow on tap
-- Floating filter button at bottom right corner
-- Bottom navigation: Home, Categories, Wishlist, Cart, Profile
-- Clean white theme with coral (#FF6B6B) accent for sale items
-```
-
-### Formulário Complexo
-```
-Create a multi-step form for user onboarding:
-- Progress bar at top showing 4 steps with current step highlighted
-- Step 1: Personal info - name, email, phone fields with labels above
-- Avatar upload circle with camera icon
-- Date picker for birthdate
-- "Next" button at bottom, full width, primary color
-- Validation states: red outline for errors, green checkmark for valid
-- Light theme, plenty of whitespace, modern sans-serif font
-- Subtle animations mentioned but not implemented
-```
-
----
-
-## Fluxo Completo
-
-```mermaid
-flowchart TD
-    A[Requisitos prontos] --> B[Gerar prompts com IA]
-    B --> C[Copiar prompt]
-    C --> D[Colar no stitch.withgoogle.com]
-    D --> E{Gostou do resultado?}
-    E -->|Não| F[Ajustar prompt]
-    F --> D
-    E -->|Sim| G[Validar com stakeholders]
-    G --> H[Exportar código]
-    H --> I[Colar código na IA]
-    I --> J[IA analisa e organiza]
-    J --> K[Prosseguir para UX Design]
-```