oden-forge 2.0.2 → 2.2.0

package/.claude/commands/oden/init-agents.md

@@ -1,268 +0,0 @@
----
-allowed-tools: Bash, Read, Write, LS, Glob
-description: Instalar agentes útiles para desarrollo de aplicaciones
----
-
-# Oden Forge - Init Agents
-
-Instala una colección curada de agentes especializados para desarrollo de aplicaciones.
-
-## Usage
-
-```
-/oden:init-agents [category]
-```
-
-Categories:
-- (vacío) - Instalar todos los agentes recomendados
-- `core` - Solo agentes esenciales
-- `frontend` - Agentes de frontend
-- `backend` - Agentes de backend
-- `mobile` - Agentes de mobile
-- `devops` - Agentes de DevOps
-- `data` - Agentes de datos
-
-## Agentes Disponibles
-
-### Core (Esenciales) - `core`
-
-Agentes fundamentales para cualquier proyecto:
-
-| Agente | Descripción | Uso |
-|--------|-------------|-----|
-| `fullstack-developer` | Desarrollo end-to-end | Implementación general |
-| `code-reviewer` | Code review | Revisar PRs y código |
-| `debugger` | Debugging | Resolver errores |
-| `test-engineer` | Testing | Estrategia y tests |
-| `code-analyzer` | Análisis de código | Buscar bugs potenciales |
-| `technical-writer` | Documentación | Escribir docs |
-| `git-flow-manager` | Git workflow | Branches y PRs |
-
-### Frontend - `frontend`
-
-| Agente | Descripción | Uso |
-|--------|-------------|-----|
-| `frontend-developer` | React/Vue/Svelte | UI components |
-| `ui-ux-designer` | Diseño de interfaces | UX/UI |
-| `javascript-pro` | JavaScript avanzado | ES6+, async |
-| `graphql-architect` | GraphQL | APIs GraphQL |
-
-### Backend - `backend`
-
-| Agente | Descripción | Uso |
-|--------|-------------|-----|
-| `backend-architect` | Arquitectura backend | APIs, servicios |
-| `database-architect` | Diseño de BD | Schemas, queries |
-| `database-optimization` | Optimización BD | Performance |
-| `python-pro` | Python | FastAPI, Django |
-| `php-pro` | PHP | Laravel, etc. |
-
-### Mobile - `mobile`
-
-| Agente | Descripción | Uso |
-|--------|-------------|-----|
-| `mobile-developer` | Cross-platform | React Native, Flutter |
-| `ios-developer` | iOS nativo | Swift, SwiftUI |
-
-### DevOps - `devops`
-
-| Agente | Descripción | Uso |
-|--------|-------------|-----|
-| `devops-engineer` | CI/CD, infra | Pipelines |
-| `deployment-engineer` | Deployments | Releases |
-| `performance-engineer` | Performance | Optimización |
-
-### Data - `data`
-
-| Agente | Descripción | Uso |
-|--------|-------------|-----|
-| `data-engineer` | Data pipelines | ETL |
-| `data-analyst` | Análisis | Métricas |
-| `data-scientist` | ML/Stats | Modelos |
-
-### Especialistas
-
-| Agente | Descripción | Uso |
-|--------|-------------|-----|
-| `ai-engineer` | LLM/RAG | Integrar IA |
-| `mcp-expert` | MCP servers | Integraciones |
-| `prompt-engineer` | Prompts | Optimizar prompts |
-| `search-specialist` | Búsqueda web | Investigación |
-| `technical-researcher` | Research técnico | Evaluar opciones |
-| `error-detective` | Logs/errores | Debug avanzado |
-| `penetration-tester` | Seguridad | Auditorías |
-
-### Utilidades
-
-| Agente | Descripción | Uso |
-|--------|-------------|-----|
-| `parallel-worker` | Trabajo paralelo | Multi-tareas |
-| `file-analyzer` | Análisis archivos | Logs, outputs |
-| `test-runner` | Ejecutar tests | CI/tests |
-| `context-manager` | Contexto | Sesiones largas |
-
----
-
-## Instrucciones de Instalación
-
-### Verificar directorio de agentes
-
-```bash
-# Verificar que existe el directorio
-mkdir -p ~/.claude/agents
-
-# Listar agentes actuales
-ls ~/.claude/agents/*.md 2>/dev/null | wc -l
-```
-
-### Descargar Agentes
-
-Los agentes se descargan desde el repositorio de Oden Forge:
-
-```bash
-ODEN_REPO="https://raw.githubusercontent.com/tu-usuario/oden-forge/main"
-
-# Core agents
-for agent in fullstack-developer code-reviewer debugger test-engineer code-analyzer technical-writer git-flow-manager; do
-  curl -sL "$ODEN_REPO/agents/$agent.md" -o ~/.claude/agents/$agent.md
-done
-```
-
-### Alternativamente: Copiar desde local
-
-Si tienes Oden Forge clonado:
-
-```bash
-cp /path/to/oden-forge/.claude/agents/*.md ~/.claude/agents/
-```
-
----
-
-## Proceso de Instalación
-
-### Paso 1: Detectar agentes existentes
-
-```bash
-echo "=== Agentes actuales ==="
-ls ~/.claude/agents/*.md 2>/dev/null | while read f; do
-  basename "$f" .md
-done
-```
-
-### Paso 2: Selección por categoría
-
-Si el usuario especificó categoría:
-- `core`: Instalar solo los 7 agentes esenciales
-- `frontend`: Core + 4 agentes de frontend
-- `backend`: Core + 5 agentes de backend
-- `mobile`: Core + 2 agentes de mobile
-- `devops`: Core + 3 agentes de devops
-- `data`: Core + 3 agentes de data
-- (vacío): Todos los agentes recomendados
-
-### Paso 3: Copiar agentes
-
-Los agentes incluidos en Oden Forge están en:
-```
-oden-forge/.claude/agents-library/
-```
-
-Copiar a:
-```
-~/.claude/agents/
-```
-
-### Paso 4: Verificar instalación
-
-```bash
-echo "=== Agentes instalados ==="
-ls ~/.claude/agents/*.md | wc -l
-echo "agentes instalados"
-```
-
----
-
-## Output
-
-```
-╔══════════════════════════════════════════════════════════════╗
-║               ODEN FORGE - AGENTS INSTALLED                  ║
-╠══════════════════════════════════════════════════════════════╣
-║                                                              ║
-║  ✅ Instalados: {N} agentes                                  ║
-║                                                              ║
-║  CORE:                                                       ║
-║  ├─ fullstack-developer                                      ║
-║  ├─ code-reviewer                                            ║
-║  ├─ debugger                                                 ║
-║  ├─ test-engineer                                            ║
-║  ├─ code-analyzer                                            ║
-║  ├─ technical-writer                                         ║
-║  └─ git-flow-manager                                         ║
-║                                                              ║
-║  {CATEGORY}:                                                 ║
-║  ├─ {agent1}                                                 ║
-║  └─ {agent2}                                                 ║
-║                                                              ║
-╠══════════════════════════════════════════════════════════════╣
-║                                                              ║
-║  USO:                                                        ║
-║  Los agentes están disponibles vía /oden:dev                 ║
-║                                                              ║
-║  Ejemplos:                                                   ║
-║  /oden:dev fullstack  → Desarrollo end-to-end                ║
-║  /oden:dev debug      → Debugging                            ║
-║  /oden:dev test       → Testing                              ║
-║  /oden:dev review     → Code review                          ║
-║                                                              ║
-╚══════════════════════════════════════════════════════════════╝
-```
-
----
-
-## Agentes Ya Instalados
-
-Si el usuario ya tiene agentes (como los de CCPM), este comando:
-1. Lista los existentes
-2. Pregunta si quiere agregar los nuevos
-3. No sobrescribe sin confirmación
-
----
-
-## Crear Agentes Personalizados
-
-Para crear un agente personalizado:
-
-```markdown
-# ~/.claude/agents/mi-agente.md
-
----
-name: mi-agente
-description: Descripción del agente
-model: sonnet
-tools: Read, Write, Edit, Bash
----
-
-# Mi Agente
-
-## Rol
-{Descripción del rol}
-
-## Responsabilidades
-1. {responsabilidad 1}
-2. {responsabilidad 2}
-
-## Proceso
-{Cómo trabaja}
-
-## Output
-{Qué produce}
-```
-
----
-
-## Notas
-
-- Los agentes se invocan con `Task` tool y `subagent_type`
-- Requieren Claude Code con soporte de agentes
-- Los agentes son archivos `.md` en `~/.claude/agents/`

package/.claude/commands/oden/init-mcp.md

@@ -1,460 +0,0 @@
----
-allowed-tools: Bash, Read, Write, LS
-description: Instalar MCPs recomendados para desarrollo
----
-
-# Oden Forge - Init MCP
-
-Instala y configura MCPs (Model Context Protocol servers) recomendados para desarrollo.
-
-## Usage
-
-```
-/oden:init-mcp [category]
-```
-
-Categories:
-- (vacío) - Mostrar todos los MCPs disponibles
-- `essential` - MCPs esenciales para cualquier proyecto
-- `design` - MCPs de diseño (Figma)
-- `backend` - MCPs de backend (Supabase)
-- `productivity` - MCPs de productividad (Notion)
-- `devops` - MCPs de DevOps (Vercel)
-- `testing` - MCPs de testing (Playwright, Chrome DevTools)
-- `mobile` - MCPs de mobile (iOS Simulator)
-
-## MCPs Disponibles
-
-### Essential - `essential`
-
-| MCP | Tipo | Descripción | Requiere |
-|-----|------|-------------|----------|
-| `context7` | HTTP | Documentación actualizada de librerías | API Key (gratis) |
-
-### Design - `design`
-
-| MCP | Tipo | Descripción | Requiere |
-|-----|------|-------------|----------|
-| `figma` | HTTP | Acceso a diseños de Figma | Cuenta Figma |
-
-### Backend - `backend`
-
-| MCP | Tipo | Descripción | Requiere |
-|-----|------|-------------|----------|
-| `supabase` | NPX | Gestión de Supabase DB | Access Token + Project Ref |
-
-### Productivity - `productivity`
-
-| MCP | Tipo | Descripción | Requiere |
-|-----|------|-------------|----------|
-| `notion` | HTTP | Acceso a Notion | Cuenta Notion |
-
-### DevOps - `devops`
-
-| MCP | Tipo | Descripción | Requiere |
-|-----|------|-------------|----------|
-| `vercel` | HTTP | Deploy y gestión Vercel | Cuenta Vercel |
-
-### Testing - `testing`
-
-| MCP | Tipo | Descripción | Requiere |
-|-----|------|-------------|----------|
-| `playwright` | NPX | Testing E2E con Playwright | Node.js |
-| `chrome-devtools` | NPX | Control de Chrome DevTools | Chrome instalado |
-
-### Mobile - `mobile`
-
-| MCP | Tipo | Descripción | Requiere |
-|-----|------|-------------|----------|
-| `ios-simulator` | NPX | Control de iOS Simulator | Xcode + macOS |
-
----
-
-## Configuración de MCPs
-
-### Tipo HTTP (servicios remotos)
-
-Estos MCPs se conectan a servicios via URL. Se agregan a `~/.claude.json`:
-
-```json
-{
-  "mcpServers": {
-    "{nombre}": {
-      "type": "http",
-      "url": "{url}"
-    }
-  }
-}
-```
-
-### Tipo NPX (comandos locales)
-
-Estos MCPs ejecutan comandos localmente:
-
-```json
-{
-  "mcpServers": {
-    "{nombre}": {
-      "command": "npx",
-      "args": ["-y", "{package}@latest"],
-      "env": {
-        "VAR": "value"
-      }
-    }
-  }
-}
-```
-
----
-
-## Instalación por MCP
-
-### Context7 (Documentación de librerías)
-
-**Recomendado para:** Todos los proyectos
-
-```bash
-# 1. Obtener API Key gratis en https://context7.com
-# 2. Agregar a configuración de proyecto
-```
-
-**Configuración:**
-```json
-{
-  "context7": {
-    "type": "http",
-    "url": "https://mcp.context7.com/mcp",
-    "headers": {
-      "CONTEXT7_API_KEY": "{tu-api-key}"
-    }
-  }
-}
-```
-
-**Uso:**
-- Buscar documentación actualizada de cualquier librería
-- Ejemplos de código actualizados
-- Compatible con Next.js, React, Supabase, etc.
-
----
-
-### Figma (Diseños)
-
-**Recomendado para:** Proyectos con diseño UI/UX
-
-```json
-{
-  "figma": {
-    "type": "http",
-    "url": "https://mcp.figma.com/mcp"
-  }
-}
-```
-
-**Uso:**
-- Acceder a componentes de Figma
-- Extraer estilos y colores
-- Convertir diseños a código
-
----
-
-### Supabase (Base de datos)
-
-**Recomendado para:** Proyectos con Supabase
-
-```bash
-# 1. Obtener Access Token en https://supabase.com/dashboard/account/tokens
-# 2. Obtener Project Ref de tu proyecto
-```
-
-**Configuración:**
-```json
-{
-  "supabase": {
-    "command": "npx",
-    "args": [
-      "-y",
-      "@supabase/mcp-server-supabase@latest",
-      "--read-only",
-      "--project-ref={tu-project-ref}"
-    ],
-    "env": {
-      "SUPABASE_ACCESS_TOKEN": "{tu-access-token}"
-    }
-  }
-}
-```
-
-**Uso:**
-- Consultar schema de BD
-- Ejecutar queries (read-only por defecto)
-- Ver tablas y relaciones
-
----
-
-### Playwright (Testing E2E)
-
-**Recomendado para:** Testing de aplicaciones web
-
-```json
-{
-  "playwright": {
-    "command": "npx",
-    "args": ["-y", "@anthropic/mcp-server-playwright@latest"]
-  }
-}
-```
-
-**Uso:**
-- Testing end-to-end automatizado
-- Screenshots y grabación de videos
-- Testing cross-browser (Chrome, Firefox, Safari)
-- Assertions y validaciones
-
----
-
-### iOS Simulator (Mobile Testing)
-
-**Recomendado para:** Desarrollo y testing de apps iOS
-
-```json
-{
-  "ios-simulator": {
-    "command": "npx",
-    "args": ["-y", "@anthropic/mcp-server-ios-simulator@latest"]
-  }
-}
-```
-
-**Uso:**
-- Controlar iOS Simulator programáticamente
-- Tomar screenshots de apps
-- Instalar y ejecutar apps
-- Testing de UI móvil
-
-**Requisitos:**
-- macOS
-- Xcode instalado
-- iOS Simulator configurado
-
----
-
-### Notion (Documentación)
-
-**Recomendado para:** Equipos usando Notion
-
-```json
-{
-  "notion": {
-    "type": "http",
-    "url": "https://mcp.notion.com/mcp"
-  }
-}
-```
-
-**Uso:**
-- Acceder a páginas de Notion
-- Leer documentación del equipo
-- Crear notas
-
----
-
-### Vercel (Deploy)
-
-**Recomendado para:** Proyectos desplegados en Vercel
-
-```json
-{
-  "vercel": {
-    "type": "http",
-    "url": "https://mcp.vercel.com/"
-  }
-}
-```
-
-**Uso:**
-- Ver deployments
-- Acceder a logs
-- Gestionar proyectos
-
----
-
-### Chrome DevTools (Browser)
-
-**Recomendado para:** Testing y debugging de UI
-
-```json
-{
-  "chrome-devtools": {
-    "command": "npx",
-    "args": ["-y", "chrome-devtools-mcp@latest"]
-  }
-}
-```
-
-**Uso:**
-- Controlar Chrome programáticamente
-- Tomar screenshots
-- Inspeccionar elementos
-- Debugging de frontend
-
----
-
-## Proceso de Instalación
-
-### Paso 1: Verificar configuración actual
-
-```bash
-# Ver MCPs configurados globalmente
-cat ~/.claude.json | grep -A 20 '"mcpServers"'
-
-# Ver MCPs del proyecto actual
-cat .claude.json 2>/dev/null | grep -A 20 '"mcpServers"'
-```
-
-### Paso 2: Elegir nivel de configuración
-
-- **Global** (`~/.claude.json`): Disponible en todos los proyectos
-- **Proyecto** (`.claude.json` o `~/.claude.json` bajo "projects"): Solo en proyecto específico
-
-### Paso 3: Agregar configuración
-
-Para agregar a nivel de proyecto, crear/editar `.mcp.json` en la raíz:
-
-```json
-{
-  "mcpServers": {
-    "context7": {
-      "type": "http",
-      "url": "https://mcp.context7.com/mcp",
-      "headers": {
-        "CONTEXT7_API_KEY": "tu-key-aqui"
-      }
-    },
-    "figma": {
-      "type": "http",
-      "url": "https://mcp.figma.com/mcp"
-    }
-  }
-}
-```
-
-### Paso 4: Reiniciar Claude Code
-
-```bash
-# Los MCPs se cargan al iniciar
-# Salir y volver a entrar a Claude Code
-```
-
----
-
-## Verificar MCPs Activos
-
-Dentro de Claude Code:
-```
-/mcp
-```
-
-Muestra los MCPs conectados y sus herramientas disponibles.
-
----
-
-## MCPs Recomendados por Tipo de Proyecto
-
-### Web App (Next.js/React)
-```
-context7        → Documentación actualizada
-figma           → Diseños (si aplica)
-vercel          → Deploy
-playwright      → Testing E2E
-chrome-devtools → Debugging
-```
-
-### Backend/API
-```
-context7    → Documentación
-supabase    → Base de datos (si aplica)
-```
-
-### Mobile iOS
-```
-context7        → Documentación
-figma           → Diseños
-ios-simulator   → Testing en simulador
-```
-
-### Mobile React Native/Flutter
-```
-context7        → Documentación
-figma           → Diseños
-ios-simulator   → Testing iOS
-chrome-devtools → Debugging web views
-```
-
-### Full Stack
-```
-context7        → Documentación
-supabase        → Base de datos
-figma           → Diseños
-vercel          → Deploy
-playwright      → Testing E2E
-```
-
----
-
-## Output
-
-```
-╔══════════════════════════════════════════════════════════════╗
-║               ODEN FORGE - MCP INSTALLED                     ║
-╠══════════════════════════════════════════════════════════════╣
-║                                                              ║
-║  CONFIGURACIÓN AGREGADA A: .mcp.json                         ║
-║                                                              ║
-║  MCPs INSTALADOS:                                            ║
-║  ├─ context7        → Documentación de librerías             ║
-║  ├─ figma           → Acceso a diseños                       ║
-║  └─ vercel          → Deploy management                      ║
-║                                                              ║
-║  PRÓXIMOS PASOS:                                             ║
-║  1. Reiniciar Claude Code para cargar MCPs                   ║
-║  2. Verificar con /mcp                                       ║
-║  3. Configurar API keys si es necesario                      ║
-║                                                              ║
-╚══════════════════════════════════════════════════════════════╝
-```
-
----
-
-## Notas
-
-- Los MCPs HTTP requieren autenticación OAuth la primera vez
-- Los MCPs NPX se ejecutan localmente
-- Algunos MCPs requieren API keys (ej: Context7, Supabase)
-- La configuración de MCPs está en `~/.claude.json` o `.mcp.json`
-
----
-
-## Agregar MCP Personalizado
-
-Si quieres agregar un MCP que no está en la lista:
-
-```json
-{
-  "mi-mcp": {
-    "type": "http",
-    "url": "https://mcp.mi-servicio.com/mcp"
-  }
-}
-```
-
-O para MCPs locales:
-
-```json
-{
-  "mi-mcp-local": {
-    "command": "npx",
-    "args": ["-y", "@org/mcp-server@latest"]
-  }
-}
-```