oden-forge 2.0.0

package/.claude/commands/oden/help.md

@@ -0,0 +1,304 @@
+---
+allowed-tools: Read, LS
+description: Mostrar ayuda y guías de Oden Forge
+---
+
+# Oden Forge - Help
+
+Muestra información sobre los comandos disponibles y cómo usar Oden Forge.
+
+## Usage
+
+```
+/oden:help [topic]
+```
+
+Topics disponibles:
+- `commands` - Lista de todos los comandos
+- `workflow` - Flujo de trabajo recomendado
+- `philosophy` - Filosofía de la metodología
+- `agents` - Agentes especializados
+- `faq` - Preguntas frecuentes
+
+## Output Principal
+
+```
+╔══════════════════════════════════════════════════════════════╗
+║                      🔨 ODEN FORGE                           ║
+║         Documentation-First Development Toolkit              ║
+╠══════════════════════════════════════════════════════════════╣
+║                                                              ║
+║  "Documenta y diseña COMPLETAMENTE antes de codificar"       ║
+║                                                              ║
+╠══════════════════════════════════════════════════════════════╣
+║                                                              ║
+║  COMANDOS DISPONIBLES                                        ║
+║                                                              ║
+║  Setup:                                                      ║
+║  ├─ /oden:init         Wizard para crear proyecto            ║
+║  ├─ /oden:init-agents  Instalar agentes de desarrollo        ║
+║  ├─ /oden:init-mcp     Instalar MCPs recomendados            ║
+║  ├─ /oden:mcp [sub]    Gestionar MCPs (install/status/etc)   ║
+║  └─ /oden:help         Esta ayuda                            ║
+║                                                              ║
+║  Pre-Desarrollo (ejecutar en orden):                         ║
+║  ├─ /oden:architect    Technical decisions + DB schema       ║
+║  ├─ /oden:spec [mod]   Especificación de módulo              ║
+║  └─ /oden:checklist    Verificar todo listo                  ║
+║                                                              ║
+║  Feature Pipeline (nativo):                                  ║
+║  ├─ /oden:prd [name]   Crear PRD con brainstorming           ║
+║  ├─ /oden:epic [name]  PRD -> Epic con work streams          ║
+║  ├─ /oden:tasks [name] Epic -> Issues desglosados            ║
+║  └─ /oden:sync [sub]   Sincronizar con GitHub Issues         ║
+║                                                              ║
+║  Durante Desarrollo:                                         ║
+║  ├─ /oden:work [epic]  Orquestador con Teams (auto/config)   ║
+║  ├─ /oden:test [sub]   Testing                               ║
+║  ├─ /oden:debug [sub]  Debugging                             ║
+║  ├─ /oden:git [sub]    Git workflow                          ║
+║  ├─ /oden:review       Code review antes de merge            ║
+║  ├─ /oden:research     Investigación técnica                 ║
+║  └─ /oden:daily        Registrar progreso del día            ║
+║                                                              ║
+╠══════════════════════════════════════════════════════════════╣
+║                                                              ║
+║  FLUJO TÍPICO                                                ║
+║                                                              ║
+║  SETUP:                                                      ║
+║  /oden:init myproject      → Crear proyecto                  ║
+║  /oden:init-agents         → Instalar agentes                ║
+║  /oden:init-mcp            → Instalar MCPs                   ║
+║                                                              ║
+║  PRE-DEV:                                                    ║
+║  /oden:architect           → Arquitectura                    ║
+║  /oden:spec auth           → Specs por módulo                ║
+║  /oden:checklist           → Verificar                       ║
+║                                                              ║
+║  FEATURES (pipeline nativo):                                 ║
+║  /oden:prd auth            → Crear PRD                       ║
+║  /oden:epic auth           → PRD -> Epic tecnico             ║
+║  /oden:tasks auth          → Epic -> Issues                  ║
+║  /oden:sync auth           → Push a GitHub Issues            ║
+║                                                              ║
+║  DESARROLLO:                                                 ║
+║  /oden:work epic/auth      → Orquestador con Teams           ║
+║  /oden:test run            → Testing                         ║
+║  /oden:review branch       → Code review                     ║
+║  /oden:daily               → Log diario                      ║
+║  /oden:git pr              → Create PR                       ║
+║                                                              ║
+╠══════════════════════════════════════════════════════════════╣
+║                                                              ║
+║  FILOSOFÍA                                                   ║
+║                                                              ║
+║  ✅ Documenta TODO antes de codificar                        ║
+║  ✅ Analiza 3+ competidores                                  ║
+║  ✅ Specs de 800+ líneas por módulo                          ║
+║  ✅ Progreso diario documentado                              ║
+║  ✅ Define máquinas de estado                                ║
+║                                                              ║
+║  ❌ NO empieces sin specs completas                          ║
+║  ❌ NO documentes cambios triviales                          ║
+║  ❌ NO dupliques información                                 ║
+║                                                              ║
+╠══════════════════════════════════════════════════════════════╣
+║                                                              ║
+║  MÁS INFO                                                    ║
+║                                                              ║
+║  /oden:help workflow    - Flujo detallado                    ║
+║  /oden:help agents      - Sobre los agentes                  ║
+║  /oden:help faq         - Preguntas frecuentes               ║
+║                                                              ║
+╚══════════════════════════════════════════════════════════════╝
+```
+
+## Help: Workflow
+
+```
+╔══════════════════════════════════════════════════════════════╗
+║                    FLUJO DE TRABAJO ODEN                     ║
+╠══════════════════════════════════════════════════════════════╣
+║                                                              ║
+║  FASE 1: PRE-DESARROLLO (1-2 semanas)                        ║
+║  ════════════════════════════════════                        ║
+║                                                              ║
+║  Objetivo: Documentar TODO antes de escribir código          ║
+║                                                              ║
+║  Día 1-2: /oden:init + /oden:architect                       ║
+║  ├─ Inicializar proyecto                                     ║
+║  ├─ Definir stack tecnológico                                ║
+║  ├─ Diseñar schema de BD                                     ║
+║  └─ Documentar arquitectura (2000+ líneas)                   ║
+║                                                              ║
+║  Día 3-7: /oden:spec (por módulo)                            ║
+║  ├─ Spec de auth (800+ líneas)                               ║
+║  ├─ Spec de módulo principal                                 ║
+║  └─ Specs de otros módulos                                   ║
+║                                                              ║
+║  Día 9: /oden:checklist                                      ║
+║  └─ Verificar TODO completo antes de codificar               ║
+║                                                              ║
+║  ════════════════════════════════════════════════════════════║
+║                                                              ║
+║  FEATURE PIPELINE (por cada feature)                         ║
+║  ════════════════════════════════════                        ║
+║                                                              ║
+║  /oden:prd auth         → Crear PRD con brainstorming        ║
+║  /oden:epic auth        → PRD -> Epic con work streams       ║
+║  /oden:tasks auth       → Epic -> Issues individuales        ║
+║  /oden:sync auth        → Push a GitHub Issues               ║
+║                                                              ║
+║  ════════════════════════════════════════════════════════════║
+║                                                              ║
+║  FASE 2: IMPLEMENTACION (8-18 semanas)                       ║
+║  ═════════════════════════════════════                       ║
+║                                                              ║
+║  /oden:work epic/auth   → Orquestador con Teams              ║
+║                                                              ║
+║  Cada dia:                                                   ║
+║  ├─ Trabajar segun plan                                      ║
+║  ├─ Seguir specs al pie de la letra                          ║
+║  └─ /oden:daily al final del dia                             ║
+║                                                              ║
+║  Cada semana:                                                ║
+║  ├─ Review de progreso                                       ║
+║  ├─ Ajustar plan si necesario                                ║
+║  └─ Validar contra specs                                     ║
+║                                                              ║
+║  Cada milestone:                                             ║
+║  ├─ Demo con stakeholders                                    ║
+║  ├─ QA intensivo                                             ║
+║  └─ Actualizar documentación                                 ║
+║                                                              ║
+║  ════════════════════════════════════════════════════════════║
+║                                                              ║
+║  FASE 3: POST-DESARROLLO                                     ║
+║  ════════════════════════════                                ║
+║                                                              ║
+║  ├─ Mover docs a completed/                                  ║
+║  ├─ Archivar docs obsoletos                                  ║
+║  ├─ Crear guías de usuario                                   ║
+║  └─ Mantener índices actualizados                            ║
+║                                                              ║
+╚══════════════════════════════════════════════════════════════╝
+```
+
+## Help: Agents
+
+```
+╔══════════════════════════════════════════════════════════════╗
+║                 AGENTES DE DESARROLLO                        ║
+╠══════════════════════════════════════════════════════════════╣
+║                                                              ║
+║  INSTALACIÓN: /oden:init-agents [categoría]                  ║
+║                                                              ║
+║  Categorías disponibles:                                     ║
+║  • core      → Agentes esenciales (7)                        ║
+║  • frontend  → React, Vue, UX (4)                            ║
+║  • backend   → APIs, BD, arquitectura (5)                    ║
+║  • mobile    → React Native, iOS (2)                         ║
+║  • devops    → CI/CD, deploy (3)                             ║
+║  • data      → ETL, análisis (3)                             ║
+║                                                              ║
+║  ──────────────────────────────────────────────────────────  ║
+║                                                              ║
+║  🔧 AGENTES CORE (instalados por defecto)                    ║
+║  ─────────────────────────────────────                       ║
+║  fullstack-developer   Desarrollo end-to-end                 ║
+║  code-reviewer         Revisión de código                    ║
+║  debugger              Debugging de errores                  ║
+║  test-engineer         Estrategia de testing                 ║
+║  code-analyzer         Análisis de código                    ║
+║  technical-writer      Documentación                         ║
+║  git-flow-manager      Workflow de Git                       ║
+║                                                              ║
+║  ──────────────────────────────────────────────────────────  ║
+║                                                              ║
+║  USO VIA /oden:work (auto-selecciona agentes)                ║
+║  ──────────────────────────────────────────                  ║
+║  /oden:work epic/auth   → Orquesta agentes automaticamente   ║
+║  /oden:test run         → Testing                            ║
+║  /oden:debug            → Debugging                          ║
+║  /oden:review           → Code review                        ║
+║                                                              ║
+║  ──────────────────────────────────────────────────────────  ║
+║                                                              ║
+║  NOTA: Los agentes son archivos .md en ~/.claude/agents/     ║
+║  que definen roles especializados para el Task tool.         ║
+║                                                              ║
+╚══════════════════════════════════════════════════════════════╝
+```
+
+## Help: FAQ
+
+```
+╔══════════════════════════════════════════════════════════════╗
+║                   PREGUNTAS FRECUENTES                       ║
+╠══════════════════════════════════════════════════════════════╣
+║                                                              ║
+║  P: ¿Por qué tanta documentación antes de codificar?         ║
+║  ─────────────────────────────────────────────────           ║
+║  R: Porque documentar primero:                               ║
+║     • Evita retrabajo (90% menos bugs de diseño)             ║
+║     • Acelera desarrollo (el dev sabe qué construir)         ║
+║     • Reduce ambigüedad (specs claras = menos preguntas)     ║
+║     • Facilita colaboración (todos entienden el proyecto)    ║
+║                                                              ║
+║  ──────────────────────────────────────────────────────────  ║
+║                                                              ║
+║  P: ¿Puedo saltar algún paso?                                ║
+║  ─────────────────────────────                               ║
+║  R: NO recomendado. Cada paso construye sobre el anterior.   ║
+║     Si saltas:                                               ║
+║     • Sin architect → Decisiones inconsistentes              ║
+║     • Sin specs → Implementación ambigua                     ║
+║     • Sin plan → Caos y retrabajo                            ║
+║                                                              ║
+║  ──────────────────────────────────────────────────────────  ║
+║                                                              ║
+║  P: ¿Qué es MVP vs Modo Turbo?                               ║
+║  ─────────────────────────────                               ║
+║  R: Son dos enfoques de scope:                               ║
+║                                                              ║
+║     MVP (8-10 semanas):                                      ║
+║     • 30-40% de features                                     ║
+║     • Rápido al mercado                                      ║
+║     • Mayor deuda técnica                                    ║
+║                                                              ║
+║     Modo Turbo (14-20 semanas):                              ║
+║     • 100% features profesionales                            ║
+║     • Enterprise-ready desde día 1                           ║
+║     • Menor deuda técnica                                    ║
+║                                                              ║
+║  ──────────────────────────────────────────────────────────  ║
+║                                                              ║
+║  P: ¿Cuántas líneas es "suficiente" documentación?           ║
+║  ───────────────────────────────────────────────             ║
+║  R: Como mínimo:                                             ║
+║     • technical-decisions.md: 2000+ líneas                   ║
+║     • competitive-analysis.md: 1000+ líneas                  ║
+║     • {module}-spec.md: 800+ líneas cada uno                 ║
+║     • Total antes de código: 8000+ líneas                    ║
+║                                                              ║
+║  ──────────────────────────────────────────────────────────  ║
+║                                                              ║
+║  P: ¿Qué hago si cambio algo durante desarrollo?             ║
+║  ───────────────────────────────────────────────             ║
+║  R: Actualiza la documentación correspondiente:              ║
+║     • Si es técnico → technical-decisions.md                 ║
+║     • Si es feature → spec del módulo                        ║
+║     • Documenta el "por qué" del cambio                      ║
+║     • Registra en el daily log                               ║
+║                                                              ║
+║  ──────────────────────────────────────────────────────────  ║
+║                                                              ║
+║  P: ¿Funciona para proyectos pequeños?                       ║
+║  ─────────────────────────────────────                       ║
+║  R: Sí, pero ajusta el nivel de detalle:                     ║
+║     • Proyecto pequeño: 4000+ líneas total                   ║
+║     • Proyecto mediano: 8000+ líneas total                   ║
+║     • Proyecto grande: 15000+ líneas total                   ║
+║                                                              ║
+╚══════════════════════════════════════════════════════════════╝
+```

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

@@ -0,0 +1,268 @@
+---
+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/`