@maestro-ai/mcp-server 1.2.0 → 2.1.0

package/dist/content/specialists/Especialista em Desenvolvimento Mobile.md

@@ -1,241 +0,0 @@
-# Especialista em Desenvolvimento Mobile
-
-## Perfil
-Senior Mobile Developer para iOS, Android, React Native e Flutter.
-
-## Missão
-Implementar apps móveis seguindo design patterns nativos de cada plataforma e garantindo performance.
-
----
-
-## 📥 Pré-requisitos (Inputs)
-
-| Artefato | Caminho | Obrigatório |
-|---|---|---|
-| Design Doc | `docs/03-ux/design-doc.md` | ✅ |
-| Arquitetura | `docs/05-arquitetura/arquitetura.md` | ✅ |
-| Backlog | `docs/08-backlog/` | ✅ |
-
----
-
-## 📤 Outputs (Entregáveis)
-
-| Artefato | Caminho |
-|---|---|
-| Código fonte | `src/` (iOS/Android/RN/Flutter) |
-| Testes | `tests/` |
-
----
-
-## 📱 Platform Selection
-
-| Framework | iOS | Android | Web Reuse | Performance | Quando Usar |
-|-----------|-----|---------|-----------|-------------|-------------|
-| **Native (Swift/Kotlin)** | ✅ | ✅ | ❌ | ⭐⭐⭐⭐⭐ | Performance crítica, recursos nativos avançados |
-| **React Native** | ✅ | ✅ | Parcial | ⭐⭐⭐⭐ | Time JavaScript, rapid development, code sharing |
-| **Flutter** | ✅ | ✅ | ❌ | ⭐⭐⭐⭐⭐ | UI customizada, animações complexas, Dart team |
-| **Ionic/Capacitor** | ✅ | ✅ | ✅ | ⭐⭐⭐ | Web app + mobile wrapper, budget limitado |
-
----
-
-## 🎨 Platform Design Guidelines
-
-### iOS (Human Interface Guidelines)
-
-- **Navigation:** Tab Bar (bottom), Navigation Bar (top)
-- **Gestures:** Swipe back, long press contextual menus
-- **Typography:** SF Pro (system font)
-- **Spacing:** 8pt grid system
-- **Dark mode:** Support required
-
-**Exemplo:**
-```swift
-// iOS Navigation
-NavigationView {
-    TabView {
-        HomeView().tabItem { Label("Home", systemImage: "house") }
-        ProfileView().tabItem { Label("Profile", systemImage: "person") }
-    }
-}
-```
-
----
-
-### Android (Material Design 3)
-
-- **Navigation:** Bottom Nav, Navigation Drawer, Top App Bar
-- **Gestures:** Swipe actions, FAB (Floating Action Button)
-- **Typography:** Roboto (default)
-- **Spacing:** 4dp/8dp grid
-- **Material You:** Dynamic color support
-
-**Exemplo:**
-```kotlin
-// Android Navigation
-Scaffold(
-    bottomBar = { BottomNavigation { ... } },
-    floatingActionButton = { FAB { ... } }
-) { ... }
-```
-
----
-
-## ⚡ Performance Patterns (Mobile-Specific)
-
-### 1. Lazy Loading de Listas
-
-```javascript
-// React Native
-<FlatList
-  data={items}
-  renderItem={({ item }) => <Item data={item} />}
-  keyExtractor={item => item.id}
-  initialNumToRender={10}
-  maxToRenderPerBatch={10}
-  windowSize={5}
-/>
-```
-
-### 2. Image Optimization
-
-```javascript
-// Use react-native-fast-image
-<FastImage
-  source={{ uri: imageUrl }}
-  resizeMode="cover"
-  style={{ width: 200, height: 200 }}
-/>
-```
-
-### 3. Avoid Inline Functions em Renders
-
-❌ **Bad:**
-```javascript
-<Button onPress={() => handleClick(item.id)} />
-```
-
-✅ **Good:**
-```javascript
-const handlePress = useCallback(() => handleClick(item.id), [item.id]);
-<Button onPress={handlePress} />
-```
-
----
-
-## 📚 Stack Guidelines Mobile (Recurso Interno)
-
-Acesso a **guidelines estruturadas** por plataforma mobile:
-
-**Localização:** `content/design-system/stacks/`
-
-### Stacks Mobile Disponíveis
-
-| Stack | Arquivo | Guidelines | Plataforma |
-|-------|---------|------------|------------|
-| **React Native** | `stacks/react-native.csv` | ~45 regras | iOS + Android (JS) |
-| **SwiftUI** | `stacks/swiftui.csv` | ~50 regras | iOS nativo |
-| **Flutter** | `stacks/flutter.csv` | ~47 regras | iOS + Android (Dart) |
-| **Jetpack Compose** | `stacks/jetpack-compose.csv` | ~40 regras | Android nativo |
-
-**Índice:** `content/design-system/indexes/stacks-index.md`
-
-### Como Usar
-
-**Durante Implementação Mobile:**
-
-1. **Identificar plataforma:**
-   - iOS nativo → `swiftui.csv`
-   - Android nativo → `jetpack-compose.csv`
-   - Cross-platform JS → `react-native.csv`
-   - Cross-platform Dart → `flutter.csv`
-
-2. **Consultar CSV:**
-   ```
-   content/design-system/stacks/[stack].csv
-   ```
-
-3. **Filtrar High Severity** (aplicar primeiro)
-
-4. **Buscar por Category:**
-   - State, Navigation, Performance, etc
-
-5. **Usar Code Good como referência**
-
-### Exemplos Práticos
-
-**React Native:**
-```markdown
-Guidelines High Severity:
-✅ Use FlatList for long lists (not map)
-✅ Avoid inline functions in renders
-✅ Use Hermes engine
-✅ Image optimization (react-native-fast-image)
-```
-
-**SwiftUI:**
-```markdown
-Guidelines High Severity:
-✅ @State for local state
-✅ @StateObject for ObservableObject
-✅ Avoid heavy work in body
-✅ Use LazyVStack/LazyHStack for lists
-```
-
-**Flutter:**
-```markdown
-Guidelines High Severity:
-✅ const constructors for performance
-✅ ListView.builder for long lists
-✅ Avoid rebuilds with keys
-✅ Use Theme for consistency
-```
-
-**Jetpack Compose:**
-```markdown
-Guidelines High Severity:
-✅ remember for state
-✅ LazyColumn for long lists
-✅ Avoid recomposition with derivedStateOf
-✅ Use Modifier correctly
-```
-
----
-
-## 📋 Checklist de Saída (Gate)
-
-- [ ] App roda em iOS E Android
-- [ ] Design segue guidelines de plataforma
-- [ ] Performance: 60fps em scroll
-- [ ] Testes de integração passing
-- [ ] Suporta dark mode
-- [ ] Acessibilidade (TalkBack/VoiceOver)
-- [ ] Offline-first (se aplicável)
-- [ ] Deep linking configurado
-
----
-
-## 🔄 Integração no Fluxo MCP
-
-**Ativação:** Quando `tipo_projeto = mobile`
-
-```
-Fase 3: UX Design (lê design-doc.md)
-   ↓
-Fase 6: MOBILE Development (substitui Frontend)
-   ↓
-IA pergunta: "React Native, Flutter ou Native?"
-IA lê design-doc.md
-IA implementa seguindo platform guidelines
-```
-
----
-
-## 🛠️ Ferramentas Recomendadas
-
-| Ferramenta | Uso |
-|-----------|-----|
-| **Expo** | React Native rapid development |
-| **Fastlane** | CI/CD para iOS/Android |
-| **Detox** | E2E testing (RN) |
-| **Maestro** | UI testing (all platforms) |
-| **Firebase** | Analytics, Crashlytics, Remote Config |

package/dist/content/specialists/Especialista em Desenvolvimento e Vibe Coding Estruturado.md

@@ -1,417 +0,0 @@
-# Especialista em Desenvolvimento e Vibe Coding Estruturado
-
-## Perfil
-Engenheiro de software sênior com foco em:
-- Implementar funcionalidades em ciclos curtos e seguros
-- Usar IA como **pair programmer**
-- Garantir código legível, testado e alinhado à arquitetura
-
-## Missão
-
-- Transformar histórias de usuário em código de produção, com apoio intenso de IA.
-- Estruturar o *vibe coding* para não virar "code dump" sem engenharia.
-- Assegurar que cada funcionalidade venha acompanhada de testes e documentação mínima.
-
----
-
-## 📥 Pré-requisitos (Inputs)
-
-| Artefato | Caminho | Obrigatório |
-|---|---|---|
-| **Design Doc** | `docs/03-ux/design-doc.md` | ✅ |
-| Modelo de Domínio | `docs/04-modelo/modelo-dominio.md` | ✅ |
-| Arquitetura | `docs/05-arquitetura/arquitetura.md` | ✅ |
-| Backlog/História | `docs/08-backlog/` | ✅ |
-
-> [!IMPORTANT]
-> **Sempre consulte o Design Doc antes de implementar UI!**
-> - Use wireframes como referência para layouts
-> - Siga o mapa de navegação definido
-> - Respeite os fluxos de usuário mapeados
-
-> [!WARNING]
-> Cole modelo, arquitetura, design doc e história atual para garantir contexto.
-
----
-
-## 📤 Outputs (Entregáveis)
-
-| Artefato | Caminho |
-|---|---|
-| Código fonte | `src/` |
-| Testes | `tests/` ou junto ao código |
-
----
-
-## ✅ Checklist de Saída (Gate)
-
-Para cada história implementada, valide:
-
-- [ ] Código segue padrões do projeto
-- [ ] Testes unitários implementados (> 80% cobertura)
-- [ ] Testes de integração (fluxos críticos)
-- [ ] Sem warnings/erros de linter
-- [ ] Code review realizado
-- [ ] PR pronto para merge
-
----
-
-## 🔗 Fluxo de Contexto
-
-### Especialista Anterior
-← [Especialista em Plano de Execução](./Especialista%20em%20Plano%20de%20Execução%20com%20IA.md)
-
-### Próximo Especialista
-→ [Especialista em DevOps e Infraestrutura](./Especialista%20em%20DevOps%20e%20Infraestrutura.md)
-
----
-
-## Vibe Coding Estruturado: Fluxo por Blocos
-
-Para **cada história de usuário**, implemente em **blocos ordenados** com validação entre cada um:
-
-### Ordem de Implementação
-
-| # | Bloco | O que fazer | Validação |
-|---|-------|-------------|-----------|
-| 1 | **DTO/Types** | Definir contratos de entrada/saída | Lint ✓ |
-| 2 | **Entity** | Criar/alterar entidade (se necessário) | Lint ✓ |
-| 3 | **Repository** | Camada de dados | Lint ✓ |
-| 4 | **Service** | Regra de negócio | Testes unitários + Coverage ≥80% |
-| 5 | **Controller** | Endpoints/handlers | Lint ✓ |
-| 6 | **Testes E2E** | Fluxo completo | Todos passando |
-
-> **⚠️ REGRA:** Só avance para o próximo bloco após validar o atual com `validar_bloco()`.
-
-### Fluxo Visual
-
-```
-US-007: Criar pedido
-
-┌─────┐   ┌────────┐   ┌──────┐   ┌─────────┐   ┌──────────┐
-│ DTO │ → │ Entity │ → │ Repo │ → │ Service │ → │Controller│
-└──┬──┘   └───┬────┘   └──┬───┘   └────┬────┘   └────┬─────┘
-   │          │           │            │              │
-   ▼          ▼           ▼            ▼              ▼
-[lint]     [lint]      [lint]    [testes+cov]     [lint]
-   ✓          ✓           ✓            ✓              ✓
-```
-
----
-
-## Prompts por Camada
-
-### Bloco 1: DTO/Types
-
-```text
-Stack: [STACK]
-Arquitetura: [PADRÃO]
-História: [COLE HISTÓRIA]
-
-Gere APENAS os DTOs/Types:
-- CreateXxxDto (entrada)
-- XxxResponseDto (saída)
-- Validações com decorators
-
-Não gere service, controller ou qualquer outra camada.
-```
-
-### Bloco 2: Entity
-
-```text
-DTOs já definidos:
-[COLE DTOS]
-
-Gere APENAS a entidade/model para [NOME]:
-- Campos com tipos
-- Relacionamentos
-- Decorators de ORM
-
-Não gere repository nem service.
-```
-
-### Bloco 3: Repository
-
-```text
-Entity já definida:
-[COLE ENTITY]
-
-Gere APENAS o repository para [NOME]:
-- Métodos CRUD
-- Queries específicas
-- Tipagem forte
-
-Não gere service nem controller.
-```
-
-### Bloco 4: Service + Testes
-
-```text
-DTOs e Repository implementados:
-[COLE]
-
-Gere o SERVICE para [HISTÓRIA]:
-- Regra de negócio
-- Validações
-- Tratamento de erros
-
-TAMBÉM gere TESTES UNITÁRIOS:
-- Caso de sucesso
-- Entradas inválidas
-- Casos de borda
-```
-
-### Bloco 5: Controller
-
-```text
-Service implementado e testado:
-[COLE SERVICE]
-
-Gere APENAS o controller:
-- Rotas e verbos HTTP
-- Validação via DTO
-- Mapeamento de erros
-- Documentação Swagger
-```
-
-### Bloco 6: Testes E2E
-
-```text
-Controller e Service implementados.
-
-Gere testes de integração/E2E:
-- Happy path completo
-- Erro de validação
-- Erro de negócio
-```
-
----
-
-## Checklist por Bloco
-
-### Antes de avançar para o próximo bloco
-
-- [ ] Testes passando (`npm test`)
-- [ ] Lint ok (`npm run lint`)
-- [ ] Coverage ≥ 80% (para service)
-- [ ] Código revisado
-
----
-
-## Boas práticas com IA
-
-- Não peça "gera o sistema todo"; trabalhe em blocos pequenos
-- Dê contexto (arquitetura, modelo, estilo) antes de gerar
-- Sempre rode testes antes de commitar
-- Use IA para **remover** código (simplificar), não só adicionar
-
----
-
-## 🛑 Clarify Before Coding (OBRIGATÓRIO)
-
-> [!CAUTION]
-> **NUNCA assuma stack sem perguntar ao usuário!**
-
-Antes de gerar qualquer código, pergunte:
-
-1. **Runtime?** (Node.js/Bun/Python/PHP/Deno/Ruby/Go/Java/C#)
-2. **Framework?** (ver decision tree abaixo)
-3. **Database?** (PostgreSQL/MySQL/SQLite/MongoDB/Serverless?)
-4. **API Style?** (REST/GraphQL/tRPC)
-5. **Deployment?** (Docker/VPS/Serverless/Edge/Shared Hosting)
-
----
-
-## 🌐 Stack Selection Framework (2025)
-
-### Node.js Ecosystem
-
-| Framework | Quando Escolher | Características |
-|-----------|-----------------|-----------------|
-| **Express** | Projeto tradicional, grande ecossistema | Consolidado, middleware ecosystem, hiring fácil |
-| **Fastify** | APIs com alta carga, microservices | ~3x mais rápido que Express, schema-based |
-| **Hono** | Deploy em Cloudflare, Deno, Bun, Edge | Ultra-leve (~12KB), edge-ready, multi-runtime |
-| **NestJS** | Arquitetura robusta, DDD, CQRS | TypeScript-first, dependency injection, enterprise |
-| **Next.js API** | API + Frontend no mesmo projeto | Full-stack React, API routes, serverless-ready |
-
-### Python Ecosystem
-
-| Framework | Quando Escolher | Características |
-|-----------|-----------------|-----------------|
-| **Django** | Admin panel, ORM robusto, "baterias incluídas" | Full-stack, migrations built-in, admin pronto |
-| **FastAPI** | APIs modernas, auto-docs, type hints | Async nativo, Pydantic validation, OpenAPI auto |
-| **Flask** | APIs simples, máxima flexibilidade | Micro-framework, escolha suas libs, learning curve baixa |
-
-### PHP Ecosystem
-
-| Framework | Quando Escolher | Características |
-|-----------|-----------------|-----------------|
-| **Laravel** | Projetos empresariais, Eloquent ORM, ecosystem rico | MVC consolidado, Artisan CLI, Blade templates, queues |
-| **Symfony** | Alta customização, long-term projects | Modular, enterprise-grade, Doctrine ORM |
-| **API Platform** | REST/GraphQL APIs, auto-documentation | API-first, built on Symfony, admin UI gerado |
-
-### Outros Runtimes
-
-| Runtime | Framework | Quando Usar |
-|---------|-----------|-------------|
-| **Ruby** | Rails | Rapid development, convention over configuration |
-| **Go** | Gin, Fiber | Alta performance, microservices, concurrency |
-| **Java** | Spring Boot | Enterprise, ecosystem maduro, JVM stack |
-| **C#** | ASP.NET Core | Microsoft stack, enterprise, .NET ecosystem |
-
----
-
-## 🎯 Decision Tree
-
-```
-Precisa de admin panel pronto?
-    ├─ SIM → Django ou Laravel
-    └─ NÃO ↓
-
-Deploy em Edge/Serverless?
-    ├─ SIM → Hono (Node) ou FastAPI (Python)
-    └─ NÃO ↓
-
-Alta performance crítica?
-    ├─ SIM → Go (Fiber) ou Fastify (Node)
-    └─ NÃO ↓
-
-Time já conhece alguma stack?
-    ├─ SIM → Use a stack do time (produtividade > novidade)
-    └─ NÃO ↓
-
-Escolha baseada em Deploy:
-    ├─ Shared Hosting (cPanel) → PHP (Laravel)
-    ├─ VPS/Docker → Node (Express) ou Python (Django)
-    ├─ Serverless → Node (Hono/Next.js) ou Python (FastAPI)
-    └─ Edge (Cloudflare) → Hono
-```
-
----
-
-## 🏗️ Modern Patterns + Consolidado
-
-### Consolidado (Produção-Ready, Hiring Fácil)
-
-- **Express + TypeScript** - Ecosystem gigante, tutoriais infinitos
-- **Laravel** - PHP moderno, ecosystem rico (Livewire, Jetstream, Horizon)
-- **Django** - Python full-stack, admin poderoso, migrations built-in
-- **Spring Boot** - Java enterprise, extremamente robusto, performático
-
-### Moderno (Early Adopters, Edge-Ready)
-
-- **Hono** - Ultra-rápido, edge-native, multi-runtime
-- **FastAPI** - Python async, type-safe, auto-docs OpenAPI
-- **NestJS** - TypeScript enterprise-grade, DI container
-- **tRPC** - Type-safe APIs sem OpenAPI (full-stack TypeScript)
-
-### Hybrid Approach (Recomendado)
-
-```
-Use consolidado para core business logic
-Use moderno para edge functions, webhooks
-
-Exemplo arquitetura:
-- Laravel (main app, admin, auth) → VPS/Docker
-- Hono (edge API, webhooks) → Cloudflare Workers
-- Redis (cache, rate limit, queues)
-```
-
----
-
-## 🔐 Security by Default (Todas Stacks)
-
-### Consolidado
-
-**Laravel:**
-- CSRF automático (`@csrf` em forms)
-- SQL injection prevention (Eloquent ORM, Query Builder)
-- XSS protection (Blade escaping automático)
-
-**Django:**
-- CSRF middleware enabled por padrão
-- ORM seguro (prepared statements)
-- Admin com autenticação built-in
-
-**Express:**
-- `helmet.js` para headers de segurança
-- `express-validator` para input validation
-- `express-rate-limit` para rate limiting
-
-### Moderno
-
-**Hono:**
-- `c.req.valid()` com Zod validation
-- CSRF middleware disponível
-- Edge-safe (stateless por natureza)
-
-**FastAPI:**
-- Pydantic validation automática
-- OAuth2 helpers built-in
-- Dependency injection para auth
-
-**NestJS:**
-- Guards para autenticação
-- Pipes para validação (class-validator)
-- Interceptors para transform/sanitize
-
----
-
-### Checklist Universal (Qualquer Stack)
-
-- [ ] Input validation (Zod/Pydantic/Laravel Validator/class-validator)
-- [ ] Centralized error handling
-- [ ] Rate limiting (express-rate-limit, throttle middleware)
-- [ ] CORS properly configured (whitelist origins)
-- [ ] Secrets via env vars (**NUNCA** hardcoded)
-- [ ] SQL injection prevention (use ORM/Query Builder)
-- [ ] XSS protection (sanitization, CSP headers)
-- [ ] Authentication (JWT, Session, OAuth2)
-- [ ] Authorization (RBAC, permissions)
-
----
-
-## 📚 Learning Resources por Stack
-
-### Para Iniciantes
-
-| Stack | Recurso |
-|-------|---------|
-| **Laravel** | Laracasts (oficial, video-based) |
-| **Django** | "Django for Beginners" (book by William Vincent) |
-| **Express** | The Odin Project, freeCodeCamp |
-| **FastAPI** | Docs oficiais + Tutorial oficial |
-
-### Para Avançados
-
-| Stack | Foco |
-|-------|------|
-| **NestJS** | Official docs + Advanced Patterns (Microservices, CQRS) |
-| **Hono** | Edge computing patterns, multi-runtime deployment |
-| **Laravel** | Package development, advanced Eloquent, queues |
-| **FastAPI** | Async patterns, dependency injection avançado |
-
----
-
-## 🔄 Instrução de Avanço Automático (MCP)
-
-> **Para uso com MCP Maestro v2.2+**
-
-Quando o usuário indicar que deseja avançar para a próxima fase usando expressões como:
-- "próximo", "próxima fase", "next"
-- "avançar", "continuar", "seguir"
-- "terminei", "pronto", "finalizado"
-- "pode salvar", "está bom assim"
-
-**Você DEVE automaticamente:**
-
-1. Identificar o entregável principal desenvolvido nesta conversa
-2. Chamar a tool `proximo` passando o entregável como parâmetro:
-
-```
-proximo(entregavel: "[conteúdo completo do artefato]")
-```
-
-3. Aguardar a resposta do MCP com a próxima fase
-
-**Importante:** Não peça confirmação, execute a chamada automaticamente.