nex-app 0.2.3 → 0.2.4

package/generator/cursor-integration.js

@@ -73,8 +73,8 @@ export async function integrateCursor(projectPath, agents) {
 
   // 3. Criar arquivos .mdc para cada agente (NOVO!)
   const agentPromises = agents.map(async (agentId) => {
-    // Tentar encontrar o agente no registry
-    const registryPath = path.join(projectPath, 'registry', 'bmad', agentId, 'README.md')
+    // Buscar no registry local do create-nex-app (agora incluído no pacote)
+    const registryPath = path.join(__dirname, '..', 'registry', 'bmad', agentId, 'README.md')
     
     let agentContent = `---
 description: NEX Agent - ${agentId}
@@ -88,7 +88,7 @@ Expert agent from NEX Framework.
 
 ## How to Use
 
-Reference this agent using: \`@nex/${agentId}\`
+Reference this agent using: \`@nex/bmad/agents/${agentId}\`
 
 ## Installation
 
@@ -105,9 +105,12 @@ alwaysApply: false
 ---
 
 ${readme}`
+      console.log(`   📄 README encontrado para ${agentId}`)
+    } else {
+      console.log(`   ⚠️  README não encontrado para ${agentId}, usando conteúdo genérico`)
     }
     
-    // Criar diretório para o agente (assumindo categoria 'bmad' para agora)
+    // Criar diretório para o agente
     const agentDir = path.join(cursorRulesDir, 'bmad', 'agents')
     await fs.ensureDir(agentDir)
     

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nex-app",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "Create NEX projects with interactive installer (CLI + Web UI)",
   "type": "module",
   "main": "cli/create.js",
@@ -15,6 +15,8 @@
     "templates/",
     "utils/",
     "lib/",
+    "registry/",
+    "scripts/",
     "README.md"
   ],
   "scripts": {

package/registry/README.md

@@ -0,0 +1,433 @@
+# 💎 BMAD Expert Agents
+
+> Better Model for AI Development - Expert Agents para Cursor & NEX
+
+Este diretório contém **BMAD Expert Agents** - agents especializados que funcionam tanto no **Cursor IDE** (via `.cursorrules`) quanto no **NEX Framework** (via CLI/API).
+
+---
+
+## 🎯 O que são BMAD Agents?
+
+**BMAD (Better Model for AI Development)** é um padrão de agents expert focados em domínios específicos. Diferente dos NEX Planning/Execution agents, BMAD agents são especialistas profundos em áreas como:
+
+- 🎭 **Conversion & Marketing**
+- 📊 **Analytics & Data**
+- 🔍 **SEO & Growth**
+- 💰 **Sales & Revenue**
+- 🎨 **Design & UX**
+
+---
+
+## 📦 Agents Oficiais
+
+### 🎭 VEX - The Conversion Hypnotist
+
+**Especialidade:** Conversion Rate Optimization
+
+```bash
+# Instalar
+nex agent install vex
+
+# Usar
+@vex analyze-page https://myapp.com/pricing
+@vex quick-scan https://myapp.com
+@vex ab-test-ideas pricing-page
+```
+
+**Frameworks:**
+- 5 Gatilhos de Cialdini
+- AIDA Hypnotic
+- CRO Best Practices
+
+**Use Cases:**
+- Landing pages
+- Pricing pages
+- Sign-up flows
+- E-commerce checkouts
+
+[Ver documentação completa →](./vex/README.md)
+
+---
+
+### 📊 ADA - The Analytics Oracle
+
+**Especialidade:** Analytics Intelligence & Data Insights
+
+```bash
+# Instalar
+nex agent install ada
+
+# Usar
+@ada audit google-analytics
+@ada funnel-analyze signup-flow
+@ada cohort-analysis monthly
+@ada find-north-star saas
+```
+
+**Frameworks:**
+- AARRR (Pirate Metrics)
+- North Star Metric
+- OKRs
+
+**Use Cases:**
+- Analytics audit
+- Funnel optimization
+- Cohort analysis
+- A/B test analysis
+
+[Ver documentação completa →](./ada/)
+
+---
+
+### 🔍 REX - The SEO Master
+
+**Especialidade:** SEO Strategy & Organic Growth
+
+```bash
+# Instalar
+nex agent install rex
+
+# Usar
+@rex audit https://mysite.com
+@rex keywords "saas analytics"
+@rex optimize-page blog-post.md
+@rex content-strategy "b2b saas"
+```
+
+**Frameworks:**
+- Topic Cluster Strategy
+- E-E-A-T
+- Search Intent Optimization
+- Core Web Vitals
+
+**Use Cases:**
+- Technical SEO audit
+- Keyword research
+- Content strategy
+- Backlink analysis
+
+[Ver documentação completa →](./rex/)
+
+---
+
+## 🔄 BMAD vs NEX Agents
+
+### Diferenças
+
+| Aspecto | NEX Agents | BMAD Agents |
+|---------|------------|-------------|
+| **Foco** | Planning & Execution | Domain Expertise |
+| **Escopo** | Broad (todo projeto) | Deep (domínio específico) |
+| **Framework** | NEX Framework | Cursor + NEX (Universal) |
+| **Exemplos** | ANX, PMX, ARX | VEX, ADA, REX |
+| **Uso** | Workflow completo | Tarefas especializadas |
+| **Integração** | NEX CLI + Web | Cursor + NEX CLI |
+
+### Quando usar cada um?
+
+**Use NEX Agents quando:**
+- ✅ Planejando projeto completo
+- ✅ Workflow end-to-end (requisitos → deploy)
+- ✅ Orquestração multi-agent
+
+**Use BMAD Agents quando:**
+- ✅ Expertise profunda necessária
+- ✅ Tarefa específica (CRO, SEO, Analytics)
+- ✅ Otimização pontual
+
+**Melhor dos dois mundos:**
+- 🎯 Use NEX para planejar
+- 💎 Use BMAD para otimizar
+
+---
+
+## 🚀 Como Instalar
+
+### Via NEX Hub (Recomendado)
+
+```bash
+# Buscar BMAD agents
+nex agent search "" --category bmad
+
+# Instalar todos os 3
+nex agent install vex
+nex agent install ada
+nex agent install rex
+
+# Ou instalar bundle
+nex agent install @bundle/bmad-growth
+```
+
+### Via Cursor (Manual)
+
+1. **Baixe os `.cursorrules`:**
+
+```bash
+# VEX
+curl -o .cursorrules/vex.cursorrules \
+  https://raw.githubusercontent.com/INOSX/nex-agents/main/registry/bmad/vex/vex.cursorrules
+
+# ADA
+curl -o .cursorrules/ada.cursorrules \
+  https://raw.githubusercontent.com/INOSX/nex-agents/main/registry/bmad/ada/ada.cursorrules
+
+# REX
+curl -o .cursorrules/rex.cursorrules \
+  https://raw.githubusercontent.com/INOSX/nex-agents/main/registry/bmad/rex/rex.cursorrules
+```
+
+2. **Ative no Cursor:**
+
+Adicione ao seu `.cursorrules`:
+
+```
+# BMAD Expert Agents
+- @vex - Conversion Expert
+- @ada - Analytics Expert
+- @rex - SEO Expert
+```
+
+---
+
+## 💡 Uso em Cursor
+
+### Ativar Agent
+
+```
+# No Cursor, em qualquer arquivo:
+@vex analyze-page https://myapp.com
+```
+
+### Combinar Agents
+
+```
+# Workflow completo de growth:
+@rex keywords "saas analytics"
+@vex optimize-page landing-page.html
+@ada funnel-analyze signup-flow
+```
+
+### Com Context
+
+```
+# Passar contexto adicional:
+@vex analyze-page --context "B2B SaaS, enterprise target"
+```
+
+---
+
+## 🛠️ Uso via NEX CLI
+
+```bash
+# Run agent command
+nex agent run vex analyze-page --url https://myapp.com
+
+# Com output customizado
+nex agent run ada funnel-analyze --data funnel.json --format detailed
+
+# Pipeline de agents
+nex agent run rex audit --url https://mysite.com > seo-report.md
+nex agent run vex quick-scan --url https://mysite.com > cro-report.md
+```
+
+---
+
+## 🎯 Workflows Sugeridos
+
+### Growth Stack Completo
+
+```bash
+# 1. SEO Foundation (REX)
+@rex audit https://mysite.com
+@rex content-strategy "your niche"
+
+# 2. Conversion Optimization (VEX)
+@vex analyze-page https://mysite.com/landing
+@vex quick-scan https://mysite.com/pricing
+
+# 3. Analytics Setup (ADA)
+@ada dashboard-recommend growth
+@ada funnel-analyze signup-flow
+```
+
+### Pre-Launch Checklist
+
+```bash
+# SEO Ready
+@rex audit https://staging.mysite.com
+
+# Conversion Optimized
+@vex analyze-page https://staging.mysite.com
+
+# Analytics Configured
+@ada audit google-analytics
+```
+
+### Post-Launch Optimization
+
+```bash
+# Week 1: Data Collection
+@ada anomaly-detect traffic-data
+
+# Week 2: Identify Issues
+@ada funnel-analyze signup-flow
+@vex quick-scan problem-pages
+
+# Week 3: Optimize
+@rex optimize-page low-performing-pages
+@vex ab-test-ideas pricing-page
+```
+
+---
+
+## 🔗 Integração NEX + BMAD
+
+### Exemplo: Landing Page Completa
+
+```bash
+# FASE 1: Planejamento (NEX)
+@anx analyze --requirements "Landing page for SaaS analytics"
+@pmx create-prd
+@arx design --type landing-page
+
+# FASE 2: Implementação (NEX)
+@dvx implement
+
+# FASE 3: Otimização (BMAD)
+@rex optimize-page landing-page.html
+@vex analyze-page https://deployed-url.com
+@ada dashboard-recommend product-analytics
+
+# FASE 4: Iteração
+@ada funnel-analyze
+@vex ab-test-ideas
+@rex content-strategy
+```
+
+---
+
+## 📊 Comparação de Agents
+
+| Agent | Categoria | Tempo Análise | Output | Impacto |
+|-------|-----------|---------------|--------|---------|
+| **VEX** | Conversion | 5-15 min | Detailed report + quick wins | +30-60% conversion |
+| **ADA** | Analytics | 10-30 min | Insights + recommendations | Better decisions |
+| **REX** | SEO | 15-45 min | Technical audit + strategy | +50-200% organic traffic |
+
+---
+
+## 🆕 Próximos BMAD Agents (Roadmap)
+
+### Em Desenvolvimento
+
+- 💰 **$LEX** - Sales Optimization Expert
+- 🎨 **PIX** - UI/UX Design Expert
+- 📧 **MEX** - Email Marketing Expert
+- 🚀 **GRO** - Growth Hacking Expert
+
+### Community Submissions
+
+Quer criar um BMAD agent? Veja:
+- [Como criar BMAD agent](../docs/CREATE_BMAD_AGENT.md)
+- [BMAD Agent Template](../.templates/bmad-template/)
+
+---
+
+## 📚 Recursos
+
+### Documentação
+- [VEX Documentation](./vex/README.md)
+- [ADA Documentation](./ada/)
+- [REX Documentation](./rex/)
+- [BMAD Integration Guide](../../docs/BMAD_INTEGRATION.md)
+
+### Tutoriais
+- [BMAD + Cursor Setup](../../docs/tutorials/bmad-cursor-setup.md)
+- [BMAD + NEX Workflow](../../docs/tutorials/bmad-nex-workflow.md)
+
+### Community
+- [Discord](https://discord.gg/nexhub)
+- [Examples Repository](https://github.com/INOSX/nex-agents/tree/main/examples/bmad)
+
+---
+
+## ❓ FAQ
+
+### BMAD agents funcionam sem Cursor?
+
+**Sim!** Via NEX CLI:
+
+```bash
+nex agent run vex analyze-page --url https://myapp.com
+```
+
+### BMAD agents funcionam sem NEX?
+
+**Sim!** Via Cursor `.cursorrules`:
+
+```
+@vex analyze-page https://myapp.com
+```
+
+### Posso usar BMAD + NEX juntos?
+
+**Sim! Recomendado!**
+
+```bash
+# NEX planeja
+@anx analyze
+@pmx create-prd
+
+# BMAD otimiza
+@vex optimize-conversion
+@rex optimize-seo
+```
+
+### BMAD agents são gratuitos?
+
+Agents oficiais (VEX, ADA, REX) são **gratuitos**.
+
+Community agents podem ser pagos (decisão do author).
+
+---
+
+## 🤝 Contribua
+
+Crie seu próprio BMAD agent:
+
+```bash
+# 1. Use template
+cp -r ../.templates/bmad-template registry/bmad/my-expert
+
+# 2. Edite manifest
+vim registry/bmad/my-expert/manifest.yaml
+
+# 3. Crie .cursorrules
+vim registry/bmad/my-expert/my-expert.cursorrules
+
+# 4. Documente
+vim registry/bmad/my-expert/README.md
+
+# 5. Submit PR
+git checkout -b add-bmad-my-expert
+git add registry/bmad/my-expert/
+git commit -m "Add: MY-EXPERT BMAD Agent"
+git push origin add-bmad-my-expert
+```
+
+---
+
+## 📄 Licença
+
+- **Agents Oficiais (VEX, ADA, REX):** Proprietary - INOSX
+- **Community Agents:** Conforme licença do author
+
+---
+
+**💎 BMAD Agents - Deep Expertise, Universal Compatibility**
+
+*"NEX plans, BMAD optimizes"*
+
+---
+
+**Desenvolvido com ❤️ pela [INOSX](https://inosx.com)**

package/registry/ada/manifest.yaml

@@ -0,0 +1,205 @@
+# BMAD Agent Manifest - ADA
+id: ada
+name: "ADA - The Analytics Oracle"
+tagline: "Expert em Analytics Intelligence & Data-Driven Insights"
+icon: "📊"
+type: bmad
+framework: Cursor
+category: expert
+subcategory: analytics
+
+# Version
+version: 2.0.1
+semantic_version:
+  major: 2
+  minor: 0
+  patch: 1
+
+# Author
+author:
+  name: INOSX
+  email: contact@inosx.com
+  github: INOSX
+  organization: INOSX
+
+# Description
+description: |
+  Expert em análise de dados, métricas e KPIs para produtos digitais.
+  Transforma dados brutos em insights acionáveis e recomendações estratégicas.
+
+long_description: |
+  ADA é o oráculo de analytics do BMAD. Especialista em interpretar dados
+  de analytics (Google Analytics, Mixpanel, Amplitude), identificar padrões,
+  anomalias e oportunidades de crescimento. Aplica frameworks como AARRR,
+  North Star Metric, e OKRs para guiar decisões de produto data-driven.
+  
+  Principais capacidades:
+  - Analytics audit completo (GA, Mixpanel, etc)
+  - Dashboard interpretation & recommendations
+  - Funnel analysis & optimization
+  - Cohort analysis & retention
+  - North Star Metric identification
+  - OKR creation & tracking
+  - A/B test analysis & statistical significance
+  - User behavior pattern recognition
+  - Anomaly detection & alerting
+
+# Tags
+tags:
+  - analytics
+  - data
+  - metrics
+  - kpis
+  - insights
+  - google-analytics
+  - mixpanel
+  - amplitude
+  - funnel-analysis
+  - aarrr
+  - growth
+  - bmad
+  - cursor
+  - expert
+
+# Compatibility
+compatibility:
+  cursor_version: ">=0.40.0"
+  nex_version: ">=1.0.0"
+  os: ["windows", "macos", "linux"]
+  required_tools:
+    - data-analysis
+
+# BMAD Specific
+bmad:
+  expert_type: analytics
+  cursor_integration: true
+  rules_file: ada.cursorrules
+  activation_trigger: "@ada"
+
+# Dependencies
+dependencies:
+  agents: []
+  tools:
+    - data-visualization
+  optional_tools:
+    - google-analytics-api
+    - mixpanel-api
+    - sql-database
+
+# Capabilities
+capabilities:
+  - Google Analytics audit & optimization
+  - Mixpanel/Amplitude analysis
+  - Funnel analysis & conversion optimization
+  - Cohort analysis & retention metrics
+  - User segmentation & behavior analysis
+  - A/B test statistical analysis
+  - Dashboard creation & recommendations
+  - Metric framework (AARRR, NSM, OKRs)
+  - Anomaly detection
+  - Predictive analytics
+  - Custom report generation
+  - Data storytelling
+
+# Commands (Cursor-style)
+commands:
+  - trigger: audit
+    description: Analytics audit completo
+    usage: "@ada audit [platform]"
+    example: "@ada audit google-analytics"
+    
+  - trigger: funnel-analyze
+    description: Análise de funil de conversão
+    usage: "@ada funnel-analyze [funnel-data]"
+    example: "@ada funnel-analyze signup-flow"
+    
+  - trigger: cohort-analysis
+    description: Análise de cohorts e retenção
+    usage: "@ada cohort-analysis [period]"
+    example: "@ada cohort-analysis monthly"
+    
+  - trigger: find-north-star
+    description: Identificar North Star Metric
+    usage: "@ada find-north-star [product-type]"
+    example: "@ada find-north-star saas"
+    
+  - trigger: ab-test-results
+    description: Analisar resultados de A/B test
+    usage: "@ada ab-test-results [data]"
+    
+  - trigger: anomaly-detect
+    description: Detectar anomalias em métricas
+    usage: "@ada anomaly-detect [metric-data]"
+    
+  - trigger: dashboard-recommend
+    description: Recomendar dashboard e métricas
+    usage: "@ada dashboard-recommend [goal]"
+    example: "@ada dashboard-recommend growth"
+
+# Installation
+installation:
+  size_mb: 0.8
+  install_time_minutes: 1
+  complexity: simple
+  cursor_setup: |
+    1. ADA será adicionado ao seu .cursorrules
+    2. Ative com @ada em qualquer arquivo
+    3. Conecte suas fontes de dados (opcional)
+  
+  post_install: |
+    📊 ADA instalado com sucesso!
+    
+    Como usar no Cursor:
+      @ada audit google-analytics
+      @ada funnel-analyze signup-flow
+    
+    Como usar via NEX CLI:
+      nex agent run ada audit --platform ga
+
+# Pricing
+pricing:
+  model: free
+  price: 0
+  currency: USD
+  license: PROPRIETARY
+
+# Stats
+stats:
+  installs: 892
+  stars: 67
+  rating: 4.7
+  last_updated: "2026-01-09"
+
+# Links
+links:
+  repository: https://github.com/INOSX/nex-agents
+  documentation: https://docs.inosx.com/nex/agents/ada
+  homepage: https://inosx.com/nex
+  issues: https://github.com/INOSX/nex-agents/issues
+
+# Metadata
+metadata:
+  is_official: true
+  is_verified: true
+  maturity: stable
+  support_level: full
+  language: cursorrules
+  framework: BMAD-Cursor
+  works_with: [Cursor, NEX]
+
+# Frameworks
+frameworks:
+  aarrr:
+    name: "Pirate Metrics"
+    stages: [Acquisition, Activation, Retention, Revenue, Referral]
+    
+  north_star:
+    description: "Única métrica que melhor prediz sucesso de longo prazo"
+    examples:
+      - "Airbnb: Nights booked"
+      - "Spotify: Time listening"
+      - "Slack: Messages sent"
+      
+  okrs:
+    name: "Objectives & Key Results"
+    structure: "Objective + 2-5 Key Results"