@maestro-ai/mcp-server 1.0.0 → 1.1.0

package/dist/content/content/prompts/devops/docker-compose.md

@@ -1,336 +0,0 @@
-# Prompt: Configuração Docker Compose
-
-> **Quando usar**: Ao containerizar aplicação para desenvolvimento ou produção simples
-> **Especialista**: [DevOps e Infraestrutura](../../02-especialistas/Especialista%20em%20DevOps%20e%20Infraestrutura.md)
-> **Nível**: Simples a Médio
-
----
-
-## Fluxo de Contexto
-
-Antes de usar este prompt, tenha em mãos:
-- `docs/CONTEXTO.md` - Entendimento do projeto
-- `docs/05-arquitetura/arquitetura.md` - Stack e componentes
-
-Após gerar, salve o resultado em:
-- `docker-compose.yml` (raiz do projeto)
-- `docker-compose.dev.yml` (override de desenvolvimento)
-- `docker-compose.prod.yml` (override de produção)
-
----
-
-## Prompt Completo
-
-```text
-Atue como especialista em Docker e containerização.
-
-## Contexto do Projeto
-
-[COLE O CONTEÚDO DE docs/CONTEXTO.md]
-
-## Stack Tecnológica
-
-- Backend: [Framework/Linguagem]
-- Frontend: [Framework]
-- Banco de dados: [PostgreSQL/MySQL/MongoDB]
-- Cache: [Redis/Memcached/Nenhum]
-- Message broker: [RabbitMQ/Kafka/Nenhum]
-- Outros serviços: [ElasticSearch, MinIO, etc]
-
-## Ambientes Necessários
-
-- [ ] Desenvolvimento local
-- [ ] Staging
-- [ ] Produção
-
-## Requisitos Específicos
-
-- Hot reload em desenvolvimento: [Sim/Não]
-- Volumes persistentes: [quais dados]
-- Variáveis de ambiente: [como gerenciar]
-- Múltiplos serviços: [monolito/microsserviços]
-
----
-
-## Sua Missão
-
-Gere configuração Docker Compose completa:
-
-### 1. Dockerfiles
-
-#### Backend
-```dockerfile
-# Dockerfile para [linguagem]
-# Multi-stage build para produção
-# Stage 1: Build
-FROM [base-image] AS builder
-# ...
-
-# Stage 2: Production
-FROM [slim-image] AS production
-# ...
-
-# Stage 3: Development (opcional)
-FROM builder AS development
-# Hot reload setup
-```
-
-Inclua:
-- [ ] Multi-stage build
-- [ ] Non-root user
-- [ ] Healthcheck
-- [ ] Otimização de layers
-- [ ] .dockerignore
-
-#### Frontend (se aplicável)
-```dockerfile
-# Build estático ou SSR
-```
-
-### 2. Docker Compose Base
-
-```yaml
-# docker-compose.yml
-version: '3.8'
-
-services:
-  backend:
-    build:
-      context: .
-      dockerfile: Dockerfile
-      target: production
-    ports:
-      - "3000:3000"
-    environment:
-      - NODE_ENV=production
-    depends_on:
-      db:
-        condition: service_healthy
-    healthcheck:
-      test: ["CMD", "curl", "-f", "http://localhost:3000/health"]
-      interval: 30s
-      timeout: 10s
-      retries: 3
-    restart: unless-stopped
-    
-  db:
-    image: postgres:15-alpine
-    volumes:
-      - postgres_data:/var/lib/postgresql/data
-    environment:
-      POSTGRES_DB: ${DB_NAME}
-      POSTGRES_USER: ${DB_USER}
-      POSTGRES_PASSWORD: ${DB_PASSWORD}
-    healthcheck:
-      test: ["CMD-SHELL", "pg_isready -U ${DB_USER}"]
-      interval: 10s
-      timeout: 5s
-      retries: 5
-
-volumes:
-  postgres_data:
-
-networks:
-  default:
-    name: [project]-network
-```
-
-### 3. Override de Desenvolvimento
-
-```yaml
-# docker-compose.dev.yml
-version: '3.8'
-
-services:
-  backend:
-    build:
-      target: development
-    volumes:
-      - .:/app
-      - /app/node_modules  # Evita sobrescrever node_modules
-    environment:
-      - NODE_ENV=development
-      - DEBUG=*
-    ports:
-      - "9229:9229"  # Debug port
-    command: npm run dev
-
-  # Serviços extras de desenvolvimento
-  mailhog:
-    image: mailhog/mailhog
-    ports:
-      - "1025:1025"
-      - "8025:8025"
-```
-
-### 4. Override de Produção
-
-```yaml
-# docker-compose.prod.yml
-version: '3.8'
-
-services:
-  backend:
-    deploy:
-      replicas: 2
-      resources:
-        limits:
-          cpus: '0.5'
-          memory: 512M
-    logging:
-      driver: json-file
-      options:
-        max-size: "10m"
-        max-file: "3"
-
-  # Nginx como reverse proxy
-  nginx:
-    image: nginx:alpine
-    ports:
-      - "80:80"
-      - "443:443"
-    volumes:
-      - ./nginx.conf:/etc/nginx/nginx.conf:ro
-      - ./certs:/etc/nginx/certs:ro
-    depends_on:
-      - backend
-```
-
-### 5. Arquivo .env Template
-
-```env
-# .env.example
-# Copie para .env e preencha
-
-# Database
-DB_HOST=db
-DB_PORT=5432
-DB_NAME=myapp
-DB_USER=myuser
-DB_PASSWORD=changeme
-
-# Application
-APP_PORT=3000
-APP_SECRET=generate-a-secure-secret
-NODE_ENV=development
-
-# Redis (se aplicável)
-REDIS_URL=redis://redis:6379
-
-# External services
-SMTP_HOST=mailhog
-SMTP_PORT=1025
-```
-
-### 6. Scripts de Conveniência
-
-```makefile
-# Makefile
-.PHONY: dev prod build logs
-
-dev:
-	docker-compose -f docker-compose.yml -f docker-compose.dev.yml up --build
-
-prod:
-	docker-compose -f docker-compose.yml -f docker-compose.prod.yml up -d --build
-
-build:
-	docker-compose build --no-cache
-
-logs:
-	docker-compose logs -f
-
-shell:
-	docker-compose exec backend sh
-
-db-shell:
-	docker-compose exec db psql -U $${DB_USER} -d $${DB_NAME}
-
-clean:
-	docker-compose down -v --remove-orphans
-```
-
-### 7. .dockerignore
-
-```
-# .dockerignore
-node_modules
-npm-debug.log
-.git
-.env
-.env.*
-*.md
-.vscode
-.idea
-coverage
-dist
-.next
-```
-
-### 8. Comandos Úteis
-
-```bash
-# Desenvolvimento
-docker-compose -f docker-compose.yml -f docker-compose.dev.yml up --build
-
-# Produção
-docker-compose -f docker-compose.yml -f docker-compose.prod.yml up -d
-
-# Ver logs
-docker-compose logs -f [service]
-
-# Rebuild específico
-docker-compose build --no-cache [service]
-
-# Shell no container
-docker-compose exec [service] sh
-
-# Limpar tudo
-docker-compose down -v --remove-orphans
-```
-```
-
----
-
-## Exemplo de Uso
-
-```text
-Atue como especialista em Docker e containerização.
-
-## Contexto
-
-API de e-commerce com NestJS.
-
-## Stack
-
-- Backend: NestJS (Node 20)
-- Banco: PostgreSQL 15
-- Cache: Redis 7
-- Queue: Bull (Redis-based)
-
-## Ambientes
-
-- [x] Desenvolvimento local
-- [x] Produção
-
-## Requisitos
-
-- Hot reload com npm run start:dev
-- Prisma como ORM
-- Migrations automáticas em dev
-```
-
----
-
-## Checklist Pós-Geração
-
-- [ ] Dockerfile com multi-stage build
-- [ ] docker-compose.yml base criado
-- [ ] docker-compose.dev.yml com hot reload
-- [ ] docker-compose.prod.yml com limites de recursos
-- [ ] .env.example documentado
-- [ ] .dockerignore configurado
-- [ ] Healthchecks configurados
-- [ ] Volumes para persistência
-- [ ] Non-root user no container
-- [ ] Makefile ou scripts de conveniência

package/dist/content/content/prompts/devops/feature-flags.md

@@ -1,374 +0,0 @@
-# Prompt: Feature Flags
-
-> **Prioridade**: 🟡 MÉDIA  
-> **Aplicável a**: Projetos com deploys frequentes, rollouts graduais, experimentação
-
----
-
-## O que são Feature Flags?
-
-Feature flags (ou feature toggles) permitem:
-- **Rollout gradual** de features (1% → 10% → 50% → 100%)
-- **Desligar features** rapidamente sem deploy
-- **A/B testing** em produção
-- **Trunk-based development** (merge código incompleto)
-- **Kill switch** para features problemáticas
-
----
-
-## Tipos de Feature Flags
-
-| Tipo | Duração | Uso |
-|------|---------|-----|
-| **Release Flag** | Dias/semanas | Rollout gradual de nova feature |
-| **Experiment Flag** | Semanas | A/B testing |
-| **Ops Flag** | Permanente | Kill switches, manutenção |
-| **Permission Flag** | Permanente | Features por tier/plano |
-
----
-
-## Prompt Base: Implementar Feature Flags
-
-```text
-Atue como engenheiro de software sênior.
-
-Preciso implementar feature flags para:
-- Stack: [ex. Node.js + React / Java + Spring]
-- Escala: [ex. 10k DAU, 100 req/s]
-- Use cases: [ex. rollout gradual, A/B testing, kill switches]
-
-Ferramenta escolhida: [LaunchDarkly / Unleash / Flagsmith / Caseiro com Redis]
-
-Gere uma implementação com:
-
-1. **Setup da Ferramenta**
-   - Instalação e configuração
-   - SDK client e server-side
-
-2. **Tipos de Flags**
-   - Boolean simples
-   - Percentage rollout
-   - User targeting (por ID, email, etc)
-   - Multivariate (A/B/C testing)
-
-3. **Código de Integração**
-   - Wrapper/service para acessar flags
-   - Uso em backend
-   - Uso em frontend
-   - Defaults seguros (fallback)
-
-4. **Boas Práticas**
-   - Naming convention
-   - Documentação de flags
-   - Lifecycle (criar → usar → remover)
-   - Limpeza de flags antigas
-
-5. **Observabilidade**
-   - Logs de qual variant foi servida
-   - Métricas por flag
-   - Alertas se flag falhar
-```
-
----
-
-## Prompt: Feature Flag Caseiro (Redis)
-
-```text
-Não quero usar uma ferramenta externa para feature flags.
-Preciso de uma solução simples com Redis.
-
-Requisitos:
-- Boolean flags
-- Percentage rollout (0-100%)
-- User targeting básico
-- Admin UI simples para gerenciar
-
-Stack: [DESCREVA]
-
-Gere:
-1. Schema Redis para flags
-2. Service para avaliar flags
-3. API para CRUD de flags
-4. Middleware/HOC para usar em código
-5. Exemplo de uso em feature real
-```
-
----
-
-## Prompt: Migrar para Feature Flags
-
-```text
-Tenho código com lógica condicional hardcoded:
-[COLE CÓDIGO COM IFs PARA FEATURES]
-
-Quero migrar para feature flags para:
-- Controlar remotamente
-- Fazer rollout gradual
-- Ter fallback rápido
-
-Refatore o código para:
-1. Usar feature flag service
-2. Manter defaults seguros
-3. Documentar a flag
-4. Incluir limpeza futura
-```
-
----
-
-## Exemplo: Feature Flag Service (TypeScript)
-
-```typescript
-// src/services/featureFlags.ts
-import Redis from 'ioredis';
-
-interface Flag {
-  name: string;
-  enabled: boolean;
-  percentage?: number;        // 0-100 para rollout
-  allowedUsers?: string[];    // targeting específico
-  allowedGroups?: string[];   // ex: 'beta-testers', 'employees'
-  variants?: Record<string, number>; // A/B testing: { 'control': 50, 'treatment': 50 }
-}
-
-interface EvaluationContext {
-  userId?: string;
-  email?: string;
-  groups?: string[];
-  attributes?: Record<string, any>;
-}
-
-class FeatureFlagService {
-  private redis: Redis;
-  private cache: Map<string, Flag> = new Map();
-  private cacheRefreshInterval = 30000; // 30 segundos
-
-  constructor(redis: Redis) {
-    this.redis = redis;
-    this.startCacheRefresh();
-  }
-
-  async isEnabled(flagName: string, context: EvaluationContext = {}): Promise<boolean> {
-    const flag = await this.getFlag(flagName);
-    
-    if (!flag) return false; // Default: desligado se não existe
-    if (!flag.enabled) return false;
-
-    // User targeting
-    if (flag.allowedUsers?.includes(context.userId || '')) {
-      return true;
-    }
-
-    // Group targeting
-    if (flag.allowedGroups && context.groups) {
-      const hasGroup = flag.allowedGroups.some(g => context.groups!.includes(g));
-      if (hasGroup) return true;
-    }
-
-    // Percentage rollout
-    if (flag.percentage !== undefined) {
-      const hash = this.hashUser(context.userId || 'anonymous', flagName);
-      return hash < flag.percentage;
-    }
-
-    return true;
-  }
-
-  async getVariant(flagName: string, context: EvaluationContext = {}): Promise<string> {
-    const flag = await this.getFlag(flagName);
-    
-    if (!flag || !flag.variants) return 'control';
-    if (!flag.enabled) return 'control';
-
-    const hash = this.hashUser(context.userId || 'anonymous', flagName);
-    let cumulative = 0;
-    
-    for (const [variant, percentage] of Object.entries(flag.variants)) {
-      cumulative += percentage;
-      if (hash < cumulative) {
-        return variant;
-      }
-    }
-    
-    return 'control';
-  }
-
-  private hashUser(userId: string, flagName: string): number {
-    // Hash determinístico para consistência
-    const str = `${userId}:${flagName}`;
-    let hash = 0;
-    for (let i = 0; i < str.length; i++) {
-      hash = ((hash << 5) - hash) + str.charCodeAt(i);
-      hash = hash & hash;
-    }
-    return Math.abs(hash) % 100;
-  }
-
-  private async getFlag(name: string): Promise<Flag | null> {
-    if (this.cache.has(name)) {
-      return this.cache.get(name)!;
-    }
-    
-    const data = await this.redis.hget('feature_flags', name);
-    if (!data) return null;
-    
-    const flag = JSON.parse(data) as Flag;
-    this.cache.set(name, flag);
-    return flag;
-  }
-
-  private startCacheRefresh() {
-    setInterval(async () => {
-      const flags = await this.redis.hgetall('feature_flags');
-      this.cache.clear();
-      for (const [name, data] of Object.entries(flags)) {
-        this.cache.set(name, JSON.parse(data));
-      }
-    }, this.cacheRefreshInterval);
-  }
-
-  // Admin methods
-  async createFlag(flag: Flag): Promise<void> {
-    await this.redis.hset('feature_flags', flag.name, JSON.stringify(flag));
-  }
-
-  async updateFlag(name: string, updates: Partial<Flag>): Promise<void> {
-    const existing = await this.getFlag(name);
-    if (!existing) throw new Error(`Flag ${name} not found`);
-    
-    const updated = { ...existing, ...updates };
-    await this.redis.hset('feature_flags', name, JSON.stringify(updated));
-    this.cache.delete(name);
-  }
-
-  async deleteFlag(name: string): Promise<void> {
-    await this.redis.hdel('feature_flags', name);
-    this.cache.delete(name);
-  }
-
-  async listFlags(): Promise<Flag[]> {
-    const flags = await this.redis.hgetall('feature_flags');
-    return Object.values(flags).map(f => JSON.parse(f));
-  }
-}
-
-export const featureFlags = new FeatureFlagService(new Redis());
-```
-
----
-
-## Uso no Código
-
-### Backend
-
-```typescript
-// Em um controller
-app.get('/api/checkout', async (req, res) => {
-  const userId = req.user.id;
-
-  const useNewCheckout = await featureFlags.isEnabled('new_checkout_flow', { 
-    userId,
-    groups: req.user.groups 
-  });
-
-  if (useNewCheckout) {
-    return handleNewCheckout(req, res);
-  }
-  
-  return handleLegacyCheckout(req, res);
-});
-```
-
-### Frontend (React)
-
-```typescript
-// hooks/useFeatureFlag.ts
-import { useEffect, useState } from 'react';
-
-export function useFeatureFlag(flagName: string) {
-  const [enabled, setEnabled] = useState(false);
-  const [loading, setLoading] = useState(true);
-
-  useEffect(() => {
-    fetch(`/api/feature-flags/${flagName}`)
-      .then(res => res.json())
-      .then(data => {
-        setEnabled(data.enabled);
-        setLoading(false);
-      });
-  }, [flagName]);
-
-  return { enabled, loading };
-}
-
-// Uso no componente
-function CheckoutButton() {
-  const { enabled: showNewButton, loading } = useFeatureFlag('new_checkout_button');
-
-  if (loading) return <Skeleton />;
-
-  return showNewButton ? <NewCheckoutButton /> : <LegacyCheckoutButton />;
-}
-```
-
----
-
-## Naming Convention
-
-```
-{scope}_{feature}_{detail}
-
-Exemplos:
-- checkout_new_flow
-- checkout_express_enabled
-- payment_pix_enabled
-- experiment_homepage_hero
-- ops_maintenance_mode
-- tier_premium_analytics
-```
-
----
-
-## Lifecycle de uma Flag
-
-```mermaid
-graph LR
-    A[Criar Flag] -->|disabled| B[Testar em Dev]
-    B -->|enabled + targeting| C[Beta Users]
-    C -->|percentage 10%| D[Rollout Gradual]
-    D -->|percentage 100%| E[GA]
-    E -->|remover condicionais| F[Cleanup]
-    F --> G[Deletar Flag]
-```
-
----
-
-## Checklist
-
-- [ ] Ferramenta/implementação escolhida
-- [ ] SDK integrado no backend e frontend
-- [ ] Defaults seguros (fallback se flag não existir)
-- [ ] Naming convention definida
-- [ ] Documentação de cada flag (propósito, owner, prazo)
-- [ ] Processo de limpeza de flags antigas
-- [ ] Logs de avaliação para debugging
-- [ ] Alertas se serviço de flags falhar
-
----
-
-## Ferramentas Populares
-
-| Ferramenta | Tipo | Prós | Contras |
-|------------|------|------|---------|
-| **LaunchDarkly** | SaaS | Completo, robusto | Custo |
-| **Unleash** | Open Source | Self-hosted, simples | Menos features |
-| **Flagsmith** | Híbrido | Open core, UI boa | Algumas features pagas |
-| **ConfigCat** | SaaS | Simples, barato | Menos targeting |
-| **Caseiro (Redis)** | DIY | Controle total | Manutenção |
-
----
-
-## Referências
-
-- [Feature Toggles (Martin Fowler)](https://martinfowler.com/articles/feature-toggles.html)
-- [LaunchDarkly Best Practices](https://launchdarkly.com/blog/best-practices-for-feature-flags/)
-- [Unleash Documentation](https://docs.getunleash.io/)