oden-forge 2.4.0 → 3.0.0

package/MIGRATION.md

@@ -1,410 +0,0 @@
-# 🔄 Migraciones de Oden Forge
-
-Esta guía cubre todas las migraciones importantes de Oden Forge.
-
----
-
-## 🆕 Migración v2.0 → v2.2.1 (Latest)
-
-### 📋 Resumen de Cambios v2.2.1
-
-#### ✨ Nuevas Funcionalidades:
-- **🆕 `/oden:debug`** - Revolutionary Queue-Based Debug Orchestration
-- **⚡ 8 Comandos Esenciales** - Simplificación extrema (19 → 8 comandos)
-- **🔧 Fix versión display** - `oden-forge --version` ahora funciona correctamente
-- **🌐 Documentación actualizada** - Enfoque en Documentation-First Development
-
-#### ❌ Eliminado en v2.2.1:
-- **Comandos `/oden:dev`** individuales - Reemplazados por orquestación inteligente
-- **37+ comandos legacy** - Consolidados en flujo optimizado
-
-#### 🔄 Comandos Cambió:
-| Comando v2.0 | Comando v2.2.1 | Cambio |
-|--------------|----------------|---------|
-| `/oden:dev fullstack` | `/oden:work` | ✅ Selección automática de agentes |
-| `/oden:dev frontend` | `/oden:work` | ✅ Orquestador inteligente |
-| `/oden:dev debug` | `/oden:debug` | ✅ Sistema de cola avanzado |
-| `/oden:dev test` | `/oden:work` | ✅ Integrado en orquestador |
-| **12 comandos oden:dev** | **Consolidados** | ✅ Simplificación |
-
-### 🚀 Migración Automática v2.0 → v2.2.1
-
-```bash
-# Actualizar a v2.2.1
-npm update -g oden-forge
-
-# Verificar nueva versión
-oden-forge --version  # Debe mostrar: 2.2.1
-
-# Los comandos se actualizan automáticamente
-/oden:help  # Ver comandos disponibles
-```
-
-### 📊 Nuevo Flujo de Trabajo v2.2.1
-
-```bash
-# Flujo optimizado con 8 comandos esenciales:
-
-# 1. Setup
-/oden:init              # Wizard completo
-/oden:mcp install       # MCPs recomendados
-
-# 2. Pre-Desarrollo (Documentation-First)
-/oden:architect         # Technical decisions (2000+ líneas)
-/oden:prd auth          # PRD con brainstorming
-/oden:epic auth         # Work streams + tasks
-
-# 3. Desarrollo Inteligente
-/oden:work auth         # Orquestador automático con Teams
-/oden:debug             # ⭐ NUEVO: Queue-based debugging
-/oden:sync auth         # Sincronización GitHub
-```
-
-### 🔥 Nuevo Sistema `/oden:debug`
-
-**Reemplaza múltiples comandos debug anteriores:**
-
-```bash
-/oden:debug                    # Sesión interactiva
-
-# En el prompt debug>:
-debug> add "fix login validation error"
-debug> add "improve test coverage"
-debug> priority 1 "critical: production issue"
-debug> status                  # Ver progreso en tiempo real
-debug> analytics               # Métricas de sesión
-debug> stop                    # Finalizar sesión
-```
-
-**Características revolucionarias:**
-- ✅ **Cola inteligente** con auto-detección de dependencias
-- ✅ **8+ agentes especializados** (debugger, test-engineer, security-auditor...)
-- ✅ **Context preservation** máximo entre tareas (95%+)
-- ✅ **Session recovery** para sesiones interrumpidas
-- ✅ **Auto-close** después de 30min de inactividad
-- ✅ **Analytics** y métricas de éxito
-
-### 🧠 Orquestador `/oden:work` Mejorado
-
-**Selección automática de agentes** (sin comandos `/oden:dev` manuales):
-
-```bash
-/oden:work auth             # Detección automática: backend + security
-/oden:work ui-redesign      # Detección automática: frontend + design
-/oden:work performance      # Detección automática: performance + database
-```
-
-**Agentes disponibles automáticamente:**
-- **Code:** fullstack, frontend, backend, mobile, ios
-- **Database:** database-architect, performance-engineer
-- **Quality:** test-engineer, debugger, code-reviewer
-- **Security:** security-auditor
-- **DevOps:** devops-engineer, deployment-engineer
-
-### 📈 Métricas de Mejora v2.2.1
-
-| Métrica | v2.0 | v2.2.1 | Mejora |
-|---------|------|--------|---------|
-| Comandos totales | 19 | 8 | **58% menos** |
-| Context preservation | 85% | 95% | **+10%** |
-| Debug success rate | 75% | 90% | **+15%** |
-| Setup time | 5 min | 2 min | **60% más rápido** |
-| Agent efficiency | 70% | 87% | **+17%** |
-
-### ⚠️ Breaking Changes v2.0 → v2.2.1
-
-#### Comandos Eliminados:
-```bash
-# ❌ YA NO FUNCIONAN en v2.2.1:
-/oden:dev fullstack     # → Use /oden:work
-/oden:dev frontend      # → Use /oden:work
-/oden:dev backend       # → Use /oden:work
-/oden:dev mobile        # → Use /oden:work
-/oden:dev ios           # → Use /oden:work
-/oden:dev debug         # → Use /oden:debug
-/oden:dev test          # → Use /oden:work
-/oden:dev review        # → Use /oden:work
-/oden:dev deploy        # → Use /oden:work
-/oden:dev perf          # → Use /oden:work
-/oden:dev git           # → Use /oden:work
-/oden:dev docs          # → Use /oden:work
-```
-
-#### Migración Automática:
-El sistema detecta automáticamente el uso de comandos obsoletos y sugiere alternativas:
-
-```bash
-# Si intentas usar comando obsoleto:
-/oden:dev debug
-
-# Respuesta automática:
-❌ Comando obsoleto. En v2.2.1 usa:
-✅ /oden:debug    # Para debugging avanzado con cola
-✅ /oden:work     # Para desarrollo general
-```
-
-### 🔍 Verificación Post-Migración v2.2.1
-
-```bash
-# 1. Verificar versión
-oden-forge --version     # Debe mostrar: 2.2.1
-
-# 2. Comandos disponibles
-/oden:help               # 8 comandos esenciales
-
-# 3. Probar nuevo sistema debug
-/oden:debug
-debug> add "test new system"
-debug> status
-debug> stop
-
-# 4. Verificar orquestador
-/oden:work --help        # Ver opciones disponibles
-```
-
-**Output esperado:**
-```
-🔧 Oden Forge v2.2.1 - 8 Comandos Esenciales
-
-✅ Setup:
-   /oden:init    - Wizard completo
-   /oden:mcp     - Gestión MCPs
-   /oden:help    - Ayuda
-
-✅ Pre-Desarrollo:
-   /oden:architect - Technical decisions
-   /oden:prd      - Product requirements
-   /oden:epic     - Work streams
-
-✅ Desarrollo:
-   /oden:work    - Orquestador inteligente
-   /oden:debug   - Queue-based debugging ⭐
-   /oden:sync    - GitHub sync
-```
-
-### 📚 Recursos v2.2.1
-
-- **Documentación:** https://javikin.github.io/oden
-- **NPM Package:** https://npmjs.com/package/oden-forge
-- **GitHub:** https://github.com/javikin/oden
-- **Help integrado:** `/oden:help`
-
----
-
-## 🔄 Migración de Oden Forge v1 → v2
-
-Esta sección cubre la migración de Oden Forge v1 (o CCPM) a la versión 2.0.
-
-## 📋 Resumen de Cambios
-
-### ✅ Lo que MEJORA en v2:
-- **67% menos comandos** (57 → 19 comandos esenciales)
-- **Teams integrado** para desarrollo paralelo
-- **CCPM nativo** (sin dependencia externa)
-- **Gestión de MCPs** con instalación one-click
-- **Documentación profesional** con GitHub Pages
-
-### ⚠️ Lo que CAMBIA:
-- Comandos `/pm:*` → `/oden:*`
-- Estructura de archivos simplificada
-- Workflow con Teams para epics grandes
-
----
-
-## 🚀 Métodos de Migración
-
-### Opción 1: Automática (Recomendado)
-
-```bash
-# Instalar v2 con migración automática
-npm install -g oden-forge
-
-# Si necesitas forzar migración manual:
-oden-forge migrate
-```
-
-### Opción 2: Manual
-
-```bash
-# 1. Backup de datos importantes
-cp -r ~/.claude/prds ~/.claude/prds.backup
-cp -r ~/.claude/epics ~/.claude/epics.backup
-
-# 2. Limpiar instalación anterior
-rm -rf ~/.claude/commands/pm
-rm -rf ~/.claude/commands/ccpm
-rm -rf ~/.claude/scripts/pm
-rm -rf ~/.ccpm
-
-# 3. Instalar v2
-npm install -g oden-forge
-```
-
----
-
-## 🔧 Proceso Detallado de Migración
-
-### 1. Pre-Migración: Backup de Datos
-
-La herramienta preserva automáticamente:
-- ✅ PRDs existentes en `~/.claude/prds/`
-- ✅ Epics existentes en `~/.claude/epics/`
-- ✅ Configuraciones de proyecto
-- ✅ Archivos de documentación en `docs/`
-
-### 2. Detección Automática
-
-El migrador detecta y limpia:
-
-| Componente | Ubicación v1 | Acción |
-|------------|-------------|---------|
-| Comandos PM | `~/.claude/commands/pm/` | **Reemplazar** por `/oden:*` |
-| Comandos CCPM | `~/.claude/commands/ccmp/` | **Reemplazar** por nativos |
-| Scripts PM | `~/.claude/scripts/pm/` | **Actualizar** |
-| CCMP Installation | `~/.ccmp/` | **Archivar y remover** |
-| Rules antiguas | `~/.claude/rules/` | **Actualizar selectivamente** |
-
-### 3. Mapeo de Comandos
-
-| Comando v1 | Comando v2 | Cambios |
-|------------|------------|---------|
-| `/pm:init` | `/oden:init` | ✅ Mismo wizard mejorado |
-| `/pm:prd-new` | `/oden:prd` | ✅ Brainstorming inteligente |
-| `/pm:epic-decompose` | `/oden:epic` | ✅ Work streams + Teams |
-| `/pm:issue-start` | `/oden:work` | ✅ Orquestador inteligente |
-| `/pm:sync` | `/oden:sync` | ✅ 100% nativo, sin CCPM |
-| `/pm:daily` | `/oden:daily` | ✅ Sin cambios |
-| **37 comandos legacy** | **Removidos** | Simplificación |
-
----
-
-## ⚡ Quick Start Post-Migración
-
-### 1. Verificar Instalación
-```bash
-oden-forge status
-```
-
-### 2. Primer Proyecto v2
-```bash
-# En tu proyecto
-claude-code  # O tu comando de Claude Code
-
-# Dentro de Claude Code:
-/oden:init    # Wizard mejorado
-/oden:mcp recommend  # Nuevo: gestión de MCPs
-```
-
-### 3. Workflow Mejorado
-```bash
-# Flujo típico v2:
-/oden:prd feature-name     # PRD con brainstorming
-/oden:epic feature-name    # Epic con work streams
-/oden:tasks feature-name   # Descomposición automática
-/oden:work feature-name    # Teams para desarrollo paralelo
-/oden:sync feature-name    # Sync nativo con GitHub
-```
-
----
-
-## 🔍 Verificación de Migración
-
-### Comando de Status
-```bash
-oden-forge status
-```
-
-**Output esperado:**
-```
-📋 Oden Forge Status
-══════════════════════════════════════════════════
-✅ Installed: 19 commands
-   Location: /Users/tu-usuario/.claude/commands/oden
-
-💡 Quick Start:
-   1. cd your-project
-   2. claude-code
-   3. /oden:init
-```
-
-### Comandos Disponibles Post-Migración
-```bash
-/oden:init          # Wizard de inicialización
-/oden:architect     # Decisiones técnicas
-/oden:prd           # PRDs con brainstorming
-/oden:epic          # Epic con work streams
-/oden:tasks         # Descomposición de tasks
-/oden:work          # Orquestador con Teams
-/oden:sync          # Sync nativo con GitHub
-/oden:mcp           # Gestión de MCPs
-/oden:help          # Ayuda integrada
-```
-
----
-
-## ❓ Troubleshooting
-
-### ❌ "Command not found: oden-forge"
-```bash
-# Reinstalar globalmente
-npm uninstall -g oden-forge
-npm install -g oden-forge
-```
-
-### ❌ "Legacy installations detected"
-```bash
-# Migración manual
-oden-forge migrate
-```
-
-### ❌ "Commands not working in Claude Code"
-```bash
-# Verificar instalación
-oden-forge status
-
-# Reinstalar si es necesario
-oden-forge install --force
-```
-
-### ❌ "Lost my old PRDs/Epics"
-```bash
-# Buscar backups automáticos
-ls ~/.claude/*.backup*
-ls ~/.claude/prds.backup/
-ls ~/.claude/epics.backup/
-```
-
----
-
-## 🆘 Soporte
-
-### GitHub Issues
-- **Bug reports**: https://github.com/javikin/oden-forge/issues
-- **Feature requests**: https://github.com/javikin/oden-forge/discussions
-
-### Documentación
-- **Guía completa**: https://javikin.github.io/oden-forge
-- **Help integrado**: `/oden:help`
-
-### Rollback (Si es necesario)
-```bash
-# Solo en caso de emergencia - volver a v1
-npm uninstall -g oden-forge
-
-# Restaurar backup
-mv ~/.claude/prds.backup ~/.claude/prds
-mv ~/.claude/epics.backup ~/.claude/epics
-
-# Reinstalar v1 manualmente desde backup
-```
-
----
-
-## 🎯 Próximos Pasos
-
-1. ✅ **Completar migración** usando esta guía
-2. 🆕 **Probar nuevas features** (Teams, MCPs, brainstorming)
-3. 📚 **Explorar documentación** en GitHub Pages
-4. 💡 **Dar feedback** para futuras mejoras
-
-**¡Bienvenido a Oden Forge 2.0!** 🎉

package/install.sh

@@ -1,231 +0,0 @@
-#!/bin/bash
-
-# ============================================================================
-# ODEN FORGE - INSTALLER
-# ============================================================================
-# Instala todo lo necesario para usar Oden Forge:
-# - Comandos /oden:* (52 comandos unificados)
-# - Scripts de soporte
-# - Hooks
-# - Rules de Claude
-# - Carpetas para PRDs y Epics
-# - Agentes de desarrollo (opcional)
-# ============================================================================
-
-set -e
-
-# Colors
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-NC='\033[0m' # No Color
-
-# Get script directory
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-
-echo ""
-echo -e "${BLUE}╔══════════════════════════════════════════════════════════════╗${NC}"
-echo -e "${BLUE}║                    ODEN FORGE INSTALLER                      ║${NC}"
-echo -e "${BLUE}║         Documentation-First Development Toolkit              ║${NC}"
-echo -e "${BLUE}╚══════════════════════════════════════════════════════════════╝${NC}"
-echo ""
-
-# ============================================================================
-# CHECK PREREQUISITES
-# ============================================================================
-
-echo -e "${YELLOW}Verificando requisitos...${NC}"
-
-# Check if Claude directory exists
-if [ ! -d "$HOME/.claude" ]; then
-    echo -e "${YELLOW}Creando directorio ~/.claude...${NC}"
-    mkdir -p "$HOME/.claude"
-fi
-
-# Check for git
-if ! command -v git &> /dev/null; then
-    echo -e "${RED}❌ Git no está instalado. Por favor instala git primero.${NC}"
-    exit 1
-fi
-echo -e "${GREEN}✓ Git instalado${NC}"
-
-# Check for GitHub CLI
-if ! command -v gh &> /dev/null; then
-    echo -e "${YELLOW}⚠ GitHub CLI (gh) no está instalado.${NC}"
-    echo -e "  Para sync con GitHub, instala: https://cli.github.com/"
-    GH_INSTALLED=false
-else
-    echo -e "${GREEN}✓ GitHub CLI instalado${NC}"
-    GH_INSTALLED=true
-fi
-
-echo ""
-
-# ============================================================================
-# INSTALL COMMANDS
-# ============================================================================
-
-echo -e "${YELLOW}Instalando comandos /oden:*...${NC}"
-
-mkdir -p "$HOME/.claude/commands/oden"
-
-if [ -d "$SCRIPT_DIR/.claude/commands/oden" ]; then
-    cp -r "$SCRIPT_DIR/.claude/commands/oden/"* "$HOME/.claude/commands/oden/"
-    ODEN_COUNT=$(ls "$HOME/.claude/commands/oden/"*.md 2>/dev/null | wc -l | tr -d ' ')
-    echo -e "${GREEN}✓ $ODEN_COUNT comandos /oden:* instalados${NC}"
-else
-    echo -e "${RED}❌ No se encontraron comandos${NC}"
-    exit 1
-fi
-
-echo ""
-
-# ============================================================================
-# INSTALL SCRIPTS
-# ============================================================================
-
-echo -e "${YELLOW}Instalando scripts...${NC}"
-
-mkdir -p "$HOME/.claude/scripts/oden"
-
-if [ -d "$SCRIPT_DIR/.claude/scripts/oden" ]; then
-    cp -r "$SCRIPT_DIR/.claude/scripts/oden/"* "$HOME/.claude/scripts/oden/"
-    chmod +x "$HOME/.claude/scripts/oden/"*.sh 2>/dev/null || true
-    SCRIPT_COUNT=$(ls "$HOME/.claude/scripts/oden/"*.sh 2>/dev/null | wc -l | tr -d ' ')
-    echo -e "${GREEN}✓ $SCRIPT_COUNT scripts instalados${NC}"
-else
-    echo -e "${YELLOW}⚠ No se encontraron scripts${NC}"
-fi
-
-echo ""
-
-# ============================================================================
-# INSTALL HOOKS
-# ============================================================================
-
-echo -e "${YELLOW}Instalando hooks...${NC}"
-
-mkdir -p "$HOME/.claude/hooks"
-
-if [ -d "$SCRIPT_DIR/.claude/hooks" ]; then
-    cp -r "$SCRIPT_DIR/.claude/hooks/"* "$HOME/.claude/hooks/"
-    chmod +x "$HOME/.claude/hooks/"*.sh 2>/dev/null || true
-    echo -e "${GREEN}✓ Hooks instalados${NC}"
-else
-    echo -e "${YELLOW}⚠ No se encontraron hooks${NC}"
-fi
-
-echo ""
-
-# ============================================================================
-# INSTALL RULES
-# ============================================================================
-
-echo -e "${YELLOW}Instalando rules...${NC}"
-
-mkdir -p "$HOME/.claude/rules"
-
-if [ -d "$SCRIPT_DIR/.claude/rules" ]; then
-    cp -r "$SCRIPT_DIR/.claude/rules/"* "$HOME/.claude/rules/"
-    RULES_COUNT=$(ls "$HOME/.claude/rules/"*.md 2>/dev/null | wc -l | tr -d ' ')
-    echo -e "${GREEN}✓ $RULES_COUNT rules instaladas${NC}"
-else
-    echo -e "${YELLOW}⚠ No se encontraron rules${NC}"
-fi
-
-echo ""
-
-# ============================================================================
-# CREATE FOLDERS
-# ============================================================================
-
-echo -e "${YELLOW}Creando carpetas de trabajo...${NC}"
-
-mkdir -p "$HOME/.claude/prds"
-mkdir -p "$HOME/.claude/epics"
-touch "$HOME/.claude/prds/.gitkeep" 2>/dev/null || true
-touch "$HOME/.claude/epics/.gitkeep" 2>/dev/null || true
-echo -e "${GREEN}✓ Carpetas prds/ y epics/ creadas${NC}"
-
-echo ""
-
-# ============================================================================
-# INSTALL AGENTS (OPTIONAL)
-# ============================================================================
-
-echo -e "${YELLOW}¿Deseas instalar los agentes de desarrollo? (y/n)${NC}"
-read -r INSTALL_AGENTS
-
-if [[ "$INSTALL_AGENTS" =~ ^[Yy]$ ]]; then
-    echo -e "${YELLOW}Instalando agentes...${NC}"
-
-    mkdir -p "$HOME/.claude/agents"
-
-    if [ -d "$SCRIPT_DIR/.claude/agents" ]; then
-        cp -r "$SCRIPT_DIR/.claude/agents/"* "$HOME/.claude/agents/"
-        AGENTS_COUNT=$(ls "$HOME/.claude/agents/"*.md 2>/dev/null | wc -l | tr -d ' ')
-        echo -e "${GREEN}✓ $AGENTS_COUNT agentes instalados${NC}"
-    else
-        echo -e "${YELLOW}⚠ No se encontraron agentes en el repo.${NC}"
-        echo -e "  Usa /oden:init-agents dentro de Claude Code para instalarlos.${NC}"
-    fi
-else
-    echo -e "${BLUE}Agentes no instalados. Usa /oden:init-agents después.${NC}"
-fi
-
-echo ""
-
-# ============================================================================
-# GITHUB CLI SETUP
-# ============================================================================
-
-if [ "$GH_INSTALLED" = true ]; then
-    # Check if already authenticated
-    if gh auth status &> /dev/null; then
-        echo -e "${GREEN}✓ GitHub CLI ya está autenticado${NC}"
-    else
-        echo -e "${YELLOW}¿Deseas configurar GitHub CLI ahora? (y/n)${NC}"
-        read -r SETUP_GH
-
-        if [[ "$SETUP_GH" =~ ^[Yy]$ ]]; then
-            echo -e "${YELLOW}Iniciando autenticación de GitHub...${NC}"
-            gh auth login
-        fi
-    fi
-fi
-
-echo ""
-
-# ============================================================================
-# SUMMARY
-# ============================================================================
-
-echo -e "${GREEN}╔══════════════════════════════════════════════════════════════╗${NC}"
-echo -e "${GREEN}║                  INSTALACIÓN COMPLETADA                      ║${NC}"
-echo -e "${GREEN}╚══════════════════════════════════════════════════════════════╝${NC}"
-echo ""
-echo -e "${BLUE}COMANDOS INSTALADOS (/oden:*):${NC}"
-echo -e "  Setup:        init, init-agents, init-mcp, help"
-echo -e "  Pre-Dev:      architect, analyze, spec, plan, checklist"
-echo -e "  GitHub:       prd-new, epic-sync, issue-start, ..."
-echo -e "  Desarrollo:   dev, test, debug, research, daily"
-echo -e "  Git:          git start, git pr, git finish"
-echo ""
-echo -e "${BLUE}ESTRUCTURA CREADA:${NC}"
-echo -e "  ~/.claude/commands/oden/   → Comandos"
-echo -e "  ~/.claude/scripts/oden/    → Scripts"
-echo -e "  ~/.claude/hooks/           → Hooks"
-echo -e "  ~/.claude/rules/           → Rules"
-echo -e "  ~/.claude/prds/            → PRDs"
-echo -e "  ~/.claude/epics/           → Epics"
-echo ""
-echo -e "${BLUE}PRÓXIMOS PASOS:${NC}"
-echo -e "  1. Abre Claude Code en tu proyecto"
-echo -e "  2. Ejecuta: /oden:init"
-echo -e "  3. Sigue el wizard"
-echo ""
-echo -e "${YELLOW}DOCUMENTACIÓN:${NC}"
-echo -e "  README: $SCRIPT_DIR/README.md"
-echo -e "  Help:   /oden:help"
-echo ""