@maestro-ai/cli 1.0.0

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

@@ -0,0 +1,241 @@
+# 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/content/specialists/Especialista em Desenvolvimento e Vibe Coding Estruturado.md

@@ -0,0 +1,417 @@
+# 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.