elsabro 2.0.0

package/commands/elsabro/insert-phase.md

@@ -0,0 +1,117 @@
+---
+name: insert-phase
+description: Insertar una nueva fase en una posición específica del milestone
+---
+
+# /elsabro:insert-phase
+
+<command-name>insert-phase</command-name>
+
+## Propósito
+
+Insertar una fase en una posición específica, reorganizando las fases existentes. Útil para agregar trabajo que debe ocurrir entre fases existentes.
+
+## Uso
+
+```bash
+# Insertar después de fase específica
+/elsabro:insert-phase "Security Audit" --after=P2
+
+# Insertar antes de fase específica
+/elsabro:insert-phase "Security Audit" --before=P3
+
+# Insertar en posición específica
+/elsabro:insert-phase "Security Audit" --position=3
+```
+
+## Proceso
+
+### Antes
+
+```
+P1: Design ✅
+P2: Backend ✅
+P3: Frontend 🟡
+P4: Testing ⬜
+```
+
+### Comando
+
+```bash
+/elsabro:insert-phase "Security Audit" --after=P2
+```
+
+### Después
+
+```
+P1: Design ✅
+P2: Backend ✅
+P3: Security Audit ⬜  ← INSERTED
+P4: Frontend 🟡       ← Renumbered
+P5: Testing ⬜        ← Renumbered
+```
+
+## Validaciones
+
+```
+┌─────────────────────────────────────────────┐
+│  INSERT VALIDATION                          │
+├─────────────────────────────────────────────┤
+│  ✓ Position valid                           │
+│  ✓ No circular dependencies                 │
+│  ⚠ Warning: P4 (was P3) is in progress      │
+│    This may affect current work             │
+└─────────────────────────────────────────────┘
+
+Proceed with insert? (y/n)
+```
+
+## Manejo de Dependencias
+
+Si la fase insertada crea dependencias:
+
+```
+P2: Backend produces API endpoints
+P3: Security Audit needs API endpoints
+P4: Frontend needs API endpoints
+
+Suggested dependencies:
+- P3 depends on P2 ✓
+- P4 now depends on P3? (y/n)
+```
+
+## Opciones
+
+```bash
+--after, -a        # Insert after this phase
+--before, -b       # Insert before this phase
+--position, -p     # Insert at position number
+--milestone, -m    # Target milestone
+--deps             # Set dependencies
+--blocking         # Set what this blocks
+```
+
+## Output
+
+```
+✓ Phase "Security Audit" inserted at position P3
+
+  Renumbered phases:
+  - P3 → P4 (Frontend)
+  - P4 → P5 (Testing)
+
+  Dependencies updated:
+  - P3: Security Audit depends on P2
+  - P4: Frontend depends on P2 (unchanged)
+
+  Timeline impact:
+  - Added ~3 days to milestone
+  - New completion: 2024-02-18
+```
+
+## Diferencia con add-phase
+
+| Comando | Uso |
+|---------|-----|
+| `add-phase` | Agrega al final |
+| `insert-phase` | Inserta en posición específica |

package/commands/elsabro/list-phase-assumptions.md

@@ -0,0 +1,129 @@
+---
+name: list-phase-assumptions
+description: Listar y validar los supuestos hechos para una fase del proyecto
+---
+
+# /elsabro:list-phase-assumptions
+
+<command-name>list-phase-assumptions</command-name>
+
+## Propósito
+
+Documentar y revisar las asunciones hechas durante la planificación de una fase. Las asunciones no validadas son riesgos ocultos.
+
+## Uso
+
+```bash
+# Listar asunciones de fase actual
+/elsabro:list-phase-assumptions
+
+# Listar asunciones de fase específica
+/elsabro:list-phase-assumptions P3
+
+# Listar todas las asunciones del milestone
+/elsabro:list-phase-assumptions --all
+
+# Filtrar por estado
+/elsabro:list-phase-assumptions P3 --status=unvalidated
+```
+
+## Categorías de Asunciones
+
+### Técnicas
+- "El API soporta paginación"
+- "La biblioteca X es compatible con React 18"
+- "El servidor tiene suficiente memoria"
+
+### De Negocio
+- "Los usuarios prefieren dark mode"
+- "El flujo actual es confuso"
+- "Esta feature aumentará retención"
+
+### De Timeline
+- "El diseño estará listo para D3"
+- "El equipo de backend entrega API en W2"
+- "QA puede testear en paralelo"
+
+### De Recursos
+- "Tenemos acceso al ambiente de staging"
+- "El desarrollador X estará disponible"
+- "El presupuesto cubre servicios externos"
+
+## Output
+
+```markdown
+# Phase Assumptions: P3 - Frontend
+
+## Technical Assumptions
+
+| # | Assumption | Status | Validated By |
+|---|------------|--------|--------------|
+| A1 | Backend API supports CORS | ✅ Validated | Tested locally |
+| A2 | WebSocket available for real-time | 🟡 Pending | Check with backend |
+| A3 | Browser support includes Safari | ⚠️ Risk | Need to verify |
+
+## Business Assumptions
+
+| # | Assumption | Status | Validated By |
+|---|------------|--------|--------------|
+| A4 | Users prefer card view | ❓ Unvalidated | User research needed |
+| A5 | Mobile is secondary priority | ✅ Validated | Product confirmed |
+
+## Timeline Assumptions
+
+| # | Assumption | Status | Validated By |
+|---|------------|--------|--------------|
+| A6 | Designs complete by D2 | ✅ Validated | Designer confirmed |
+| A7 | No scope changes mid-phase | 🟡 At Risk | History suggests changes |
+
+## Summary
+
+Total: 7 assumptions
+- ✅ Validated: 3
+- 🟡 Pending: 2
+- ⚠️ At Risk: 1
+- ❓ Unvalidated: 1
+
+## Recommended Actions
+
+1. **A2 (WebSocket):** Confirm with backend team today
+2. **A3 (Safari):** Run compatibility tests
+3. **A4 (Card view):** Optional - defer validation
+```
+
+## Validación de Asunciones
+
+```bash
+# Marcar asunción como validada
+/elsabro:list-phase-assumptions P3 --validate=A1 --by="Tested with curl"
+
+# Marcar asunción como invalidada
+/elsabro:list-phase-assumptions P3 --invalidate=A2 --reason="No WebSocket support"
+
+# Agregar nueva asunción
+/elsabro:list-phase-assumptions P3 --add="Users have stable internet"
+```
+
+## Visualización
+
+```
+╔═══════════════════════════════════════════════╗
+║  ASSUMPTIONS HEALTH: P3                       ║
+╠═══════════════════════════════════════════════╣
+║                                               ║
+║  ✅ Validated    ████████░░░░ 43% (3/7)       ║
+║  🟡 Pending      ████░░░░░░░░ 29% (2/7)       ║
+║  ⚠️  At Risk      ██░░░░░░░░░░ 14% (1/7)       ║
+║  ❓ Unvalidated  ██░░░░░░░░░░ 14% (1/7)       ║
+║                                               ║
+║  Risk Level: MEDIUM                           ║
+║  Action: Validate A2, A3 before continuing    ║
+║                                               ║
+╚═══════════════════════════════════════════════╝
+```
+
+## Integración
+
+- Alimenta risk assessment en `/elsabro:audit-milestone`
+- Referenced en `/elsabro:discuss-phase`
+- Stored en `.planning/milestones/M001/P3-ASSUMPTIONS.md`

package/commands/elsabro/map-codebase.md

@@ -0,0 +1,108 @@
+---
+name: map-codebase
+description: Genera un mapa completo del codebase actual para entender estructura, dependencias y patrones
+---
+
+# /elsabro:map-codebase
+
+<command-name>map-codebase</command-name>
+
+## Propósito
+
+Analizar y documentar la estructura completa del codebase para facilitar navegación, comprensión y desarrollo futuro.
+
+## Cuándo Usar
+
+```
+✅ Ideal para:
+- Proyecto nuevo que no conoces
+- Onboarding en codebase existente
+- Antes de hacer cambios arquitectónicos
+- Documentar proyecto legacy
+- Preparar para code review grande
+
+❌ NO usar para:
+- Proyectos pequeños (<10 archivos)
+- Cuando ya conoces bien el código
+- Quick fixes (usa /elsabro:quick)
+```
+
+## Ejecución
+
+### Paso 1: Análisis de Estructura
+
+Usa agentes en paralelo para explorar:
+
+```
+Agent 1: Estructura de directorios y archivos clave
+Agent 2: Dependencias (package.json, requirements.txt, etc.)
+Agent 3: Patrones de código y convenciones
+```
+
+### Paso 2: Identificar Componentes
+
+```
+┌─────────────────────────────────────────────┐
+│  COMPONENTES A MAPEAR                        │
+├─────────────────────────────────────────────┤
+│  - Entry points (main, index)               │
+│  - Rutas/Endpoints                          │
+│  - Modelos/Schemas                          │
+│  - Servicios/Utils                          │
+│  - Tests                                    │
+│  - Configuración                            │
+└─────────────────────────────────────────────┘
+```
+
+### Paso 3: Generar Mapa
+
+Crear `.planning/CODEBASE-MAP.md` con:
+
+```markdown
+# Codebase Map
+
+## Estructura
+[Árbol de directorios con descripciones]
+
+## Componentes Principales
+[Lista de componentes con propósito]
+
+## Dependencias
+[Dependencias externas clave]
+
+## Patrones Detectados
+[Patrones de diseño usados]
+
+## Puntos de Entrada
+[Entry points y su función]
+
+## Áreas de Atención
+[Código complejo o legacy]
+```
+
+### Paso 4: Visualización
+
+Generar diagrama Mermaid de arquitectura:
+
+```mermaid
+graph TD
+    A[Entry Point] --> B[Routes]
+    B --> C[Controllers]
+    C --> D[Services]
+    D --> E[Models]
+    D --> F[External APIs]
+```
+
+## Output
+
+- `.planning/CODEBASE-MAP.md` - Mapa detallado
+- `.planning/ARCHITECTURE.mmd` - Diagrama Mermaid
+- Console output con resumen
+
+## Uso
+
+```
+/elsabro:map-codebase
+/elsabro:map-codebase --focus=backend
+/elsabro:map-codebase --depth=3
+```

package/commands/elsabro/new-milestone.md

@@ -0,0 +1,128 @@
+---
+name: new-milestone
+description: Crear un nuevo milestone con objetivos, timeline y métricas de éxito
+---
+
+# /elsabro:new-milestone
+
+<command-name>new-milestone</command-name>
+
+## Propósito
+
+Crear un milestone formal para organizar el trabajo en objetivos alcanzables con deadlines claros.
+
+## Proceso de Creación
+
+### Paso 1: Definir Milestone
+
+```
+/elsabro:new-milestone "MVP Launch"
+```
+
+ELSABRO pregunta:
+1. **Objetivo principal** - ¿Qué logras al completar esto?
+2. **Deadline** - ¿Cuándo debe estar listo?
+3. **Dependencias** - ¿Qué debe existir antes?
+
+### Paso 2: Generar Estructura
+
+Crea `.planning/milestones/M001-mvp-launch/`:
+
+```
+M001-mvp-launch/
+├── MILESTONE.md      # Definición del milestone
+├── OBJECTIVES.md     # Objetivos específicos
+├── PHASES.md         # Fases del milestone
+└── METRICS.md        # Métricas de éxito
+```
+
+### Template de MILESTONE.md
+
+```markdown
+# Milestone: MVP Launch
+
+## Overview
+- **ID:** M001
+- **Status:** 🟡 In Progress
+- **Created:** 2024-01-15
+- **Target:** 2024-03-01
+- **Owner:** [Team/Person]
+
+## Objective
+[Descripción clara de qué se logra]
+
+## Success Criteria
+- [ ] Criteria 1
+- [ ] Criteria 2
+- [ ] Criteria 3
+
+## Phases
+| Phase | Description | Status | ETA |
+|-------|-------------|--------|-----|
+| P1 | Foundation | ✅ Done | W1 |
+| P2 | Core Features | 🟡 WIP | W2-3 |
+| P3 | Polish | ⬜ Pending | W4 |
+
+## Dependencies
+- [x] Dependency 1
+- [ ] Dependency 2
+
+## Risks
+| Risk | Impact | Mitigation |
+|------|--------|------------|
+| Risk 1 | High | Plan B |
+
+## Progress
+- 2024-01-15: Milestone created
+- 2024-01-20: P1 completed
+```
+
+## Opciones
+
+```bash
+# Milestone básico
+/elsabro:new-milestone "Feature X"
+
+# Con deadline específico
+/elsabro:new-milestone "Feature X" --deadline=2024-03-01
+
+# Basado en template
+/elsabro:new-milestone "Feature X" --template=sprint
+
+# Con fases predefinidas
+/elsabro:new-milestone "Feature X" --phases="design,develop,test,deploy"
+```
+
+## Templates Disponibles
+
+### Sprint (2 semanas)
+```
+P1: Planning (D1)
+P2: Development (D2-8)
+P3: Testing (D9-10)
+P4: Review & Deploy (D11-14)
+```
+
+### Feature (4 semanas)
+```
+P1: Research & Design (W1)
+P2: Implementation (W2-3)
+P3: Testing & QA (W4)
+P4: Documentation & Deploy (W4)
+```
+
+### Epic (8+ semanas)
+```
+P1: Discovery (W1-2)
+P2: Design (W3-4)
+P3: Development - Phase 1 (W5-6)
+P4: Development - Phase 2 (W7-8)
+P5: Integration & Testing (W9)
+P6: Launch (W10)
+```
+
+## Integración
+
+- Linked con `/elsabro:progress` para tracking
+- Linked con `/elsabro:complete-milestone` para cierre
+- Linked con `/elsabro:audit-milestone` para revisión

package/commands/elsabro/new.md

@@ -0,0 +1,230 @@
+---
+name: new
+description: Crear un nuevo proyecto desde cero con investigación previa
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Glob
+  - Grep
+  - Task
+  - AskUserQuestion
+  - WebSearch
+  - mcp__plugin_context7_context7__*
+argument-hint: "[tipo de proyecto: web, mobile, api]"
+---
+
+# ELSABRO: Nuevo Proyecto
+
+<objective>
+Crear un proyecto nuevo con investigación previa, configuración correcta, y estructura lista para desarrollo.
+
+**El usuario puede no saber nada de código.** Guiarlo paso a paso con opciones claras.
+</objective>
+
+<process>
+## Paso 1: Detectar Contexto
+
+Verificar si ya hay código:
+
+```bash
+ls -la
+```
+
+Si hay código → Sugerir `/elsabro:start` en su lugar.
+
+## Paso 2: Entender Qué Quiere Crear
+
+Si no hay argumento, preguntar:
+
+```
+¿Qué tipo de proyecto quieres crear?
+
+1) 🌐 Aplicación web (páginas, dashboard, tienda online)
+2) 📱 App para celular (iOS y Android)
+3) 🔌 API o backend (servicios, webhooks)
+4) 🎯 No estoy seguro (cuéntame tu idea)
+```
+
+## Paso 3: Profundizar en la Idea
+
+Hacer preguntas de clarificación (una a la vez):
+
+```
+¿Puedes contarme más sobre tu idea?
+- ¿Qué problema resuelve?
+- ¿Quién la va a usar?
+- ¿Tienes algún ejemplo de algo similar?
+```
+
+## Paso 4: Spawnnear Agentes en Paralelo para Research
+
+Usar Task tool para investigar en paralelo:
+
+```
+Task(elsabro-analyst, model: haiku):
+  Investiga el dominio de: [descripción de la idea]
+  Enfócate en:
+  - Competidores o productos similares
+  - Funcionalidades comunes esperadas
+  - Terminología del dominio
+
+Task(elsabro-planner, model: haiku):
+  Investiga el stack técnico para: [tipo de proyecto]
+  Usa Context7 para verificar:
+  - Versiones actuales de frameworks
+  - Mejores prácticas [año actual]
+  - Patrones recomendados
+```
+
+Nota: Como es proyecto NUEVO, no hay código existente que analizar.
+
+## Paso 5: Elegir Skill según Tipo
+
+| Tipo | Skill | Comando |
+|------|-------|---------|
+| Web | nextjs-app | `@skills/nextjs-app.md` |
+| Mobile | expo-app | `@skills/expo-app.md` |
+| API | api-setup | `@skills/api-setup.md` |
+
+Leer el skill correspondiente y seguir sus pasos.
+
+## Paso 6: Crear Estructura Base
+
+Ejecutar los pasos del skill seleccionado para:
+1. Crear el proyecto con el CLI oficial
+2. Configurar dependencias
+3. Verificar que funciona
+
+## Paso 7: Crear .planning/
+
+Una vez el proyecto base funciona:
+
+```bash
+mkdir -p .planning
+```
+
+Crear archivos iniciales:
+
+### PROJECT.md
+```markdown
+# [Nombre del Proyecto]
+
+## Idea
+[Una oración describiendo qué es]
+
+## Problema que Resuelve
+[Lo que el usuario describió]
+
+## Usuarios
+[Quién lo va a usar]
+
+## Creado
+[Fecha]
+
+## Stack
+[Tecnologías elegidas]
+```
+
+### config.json
+```json
+{
+  "mode": "interactive",
+  "depth": "standard",
+  "workflow": {
+    "research": true,
+    "plan_check": true,
+    "verifier": true
+  },
+  "user_skill_level": "beginner"
+}
+```
+
+## Paso 8: Verificar con Usuario
+
+```
+¡Tu proyecto está listo!
+
+Lo que creé:
+- [Carpeta del proyecto]
+- [Archivos de configuración]
+- [Estructura base]
+
+Para probarlo:
+1. [Instrucción específica]
+2. [Instrucción específica]
+
+¿Todo funciona? Si sí, podemos empezar a agregar funcionalidades.
+```
+</process>
+
+<skills_routing>
+## Routing a Skills
+
+### Web → Next.js
+```
+@skills/nextjs-app.md
+
+Antes de ejecutar:
+1. Context7: resolve-library-id("next.js")
+2. Context7: query-docs(id, "create next app")
+3. Verificar comando actual
+```
+
+### Mobile → Expo
+```
+@skills/expo-app.md
+
+Antes de ejecutar:
+1. Context7: resolve-library-id("expo")
+2. Context7: query-docs(id, "create expo app")
+3. Verificar comando actual
+```
+
+### API → Express/Fastify/Hono
+```
+@skills/api-setup.md
+
+Antes de ejecutar:
+1. Context7: query comparación de frameworks
+2. Elegir basado en requisitos
+3. Verificar setup actual
+```
+</skills_routing>
+
+<user_experience>
+## UX para Usuarios Sin Experiencia
+
+### Lenguaje Simple
+- "página web" no "aplicación Next.js"
+- "app para celular" no "React Native con Expo"
+- "guardar datos" no "base de datos PostgreSQL"
+
+### Opciones Claras
+Siempre ofrecer opciones numeradas, no preguntas abiertas.
+
+### Explicar cuando Pidan
+Si dicen "no entiendo" o "explícame":
+- Dar más contexto
+- Usar analogías
+- Mostrar ejemplos
+</user_experience>
+
+<verification>
+## Verificación Final
+
+Antes de terminar, confirmar:
+
+1. **Proyecto creado:**
+   ```bash
+   ls -la [proyecto]
+   ```
+
+2. **Funciona:**
+   ```bash
+   cd [proyecto] && npm run dev
+   ```
+
+3. **Usuario confirma:**
+   "¿Puedes ver [lo esperado]?"
+</verification>