sdd-es 2.0.0 → 2.5.0

package/skills/token-budget/SKILL.md

@@ -0,0 +1,154 @@
+---
+description: Dado el estado actual del proyecto (fase, tareas pendientes, historial de consumo), estima el presupuesto de tokens por fase restante y recomienda si usar PTC paralelo o serial. Reutiliza criterios de orquestacion-ptc para la recomendación de paralelización.
+model: claude-haiku-4-5-20251001
+allowed-tools: Read
+---
+
+# Skill: Token Budget
+
+## Propósito
+
+Antes de lanzar una fase costosa (planificación, análisis 7-dimensiones, implementación de 10+ tareas), esta skill proyecta el costo estimado en tokens y recomienda la estrategia de ejecución más eficiente. Evita sorpresas de presupuesto a mitad de un proyecto largo.
+
+---
+
+## Lo que lees
+
+```bash
+# Estado general del proyecto
+cat .sdd/estado.json
+
+# Tareas pendientes de la spec activa
+SPEC_ID=$(grep -o '"especificacion_activa": "[^"]*"' .sdd/estado.json 2>/dev/null | cut -d'"' -f4)
+[ -n "$SPEC_ID" ] && cat ".sdd/especificaciones/${SPEC_ID}/.estado-tareas.json" 2>/dev/null
+
+# Historial de consumo (para calcular velocidad real de la sesión)
+cat .sdd/observabilidad/consumo.jsonl 2>/dev/null | tail -50 || echo "SIN_HISTORIAL"
+
+# Configuración de agentes habilitados
+cat .sdd/sdd.config.yaml 2>/dev/null | head -30 || echo "SIN_CONFIG"
+```
+
+---
+
+## Modelo de estimación
+
+### Costos de referencia por fase (en unidades de "peso relativo")
+
+Las unidades son relativas entre sí — no son tokens reales, ya que Claude Code no expone el conteo exacto. Se calibran con los datos del ledger si están disponibles.
+
+| Fase | Agentes activos | Peso base | Factor por tarea |
+|---|---|---|---|
+| `especificacion` | arquitecto (Opus) | 8 | +1 por cada requisito ambiguo |
+| `aclaracion` | ninguno dedicado | 2 | fijo |
+| `checklist` | ninguno dedicado | 2 | fijo |
+| `planificacion` | arquitecto, critico (Opus) | 10 | +2 por cada riesgo identificado |
+| `tareas` | ninguno dedicado | 3 | +0.5 por tarea a generar |
+| `analisis` (7 dims) | critico, seguridad (Opus) | 12 | fijo (siempre 7 dimensiones) |
+| `implementacion` | 1-5 agentes (Sonnet) | 4 | ×N tareas pendientes |
+| `verificacion` | ninguno dedicado | 4 | ×N CAs a verificar |
+| `qa` | tester (Sonnet) | 5 | ×N flows a probar |
+| `deploy` | operaciones (Haiku) | 2 | fijo |
+
+### Calibración con ledger histórico
+
+Si existe `consumo.jsonl` con datos de la sesión actual:
+
+```
+node -e "
+const fs = require('fs');
+const path = '.sdd/observabilidad/consumo.jsonl';
+if (!fs.existsSync(path)) { console.log('SIN_DATOS'); process.exit(0); }
+
+const lineas = fs.readFileSync(path, 'utf8').trim().split('\n').filter(Boolean);
+const parsed = lineas.map(l => { try { return JSON.parse(l); } catch { return null; } }).filter(Boolean);
+
+// Bytes totales por fase (agrupando por agente que los escribió)
+const porAgente = {};
+for (const e of parsed) {
+  const a = e.agente || 'main';
+  porAgente[a] = (porAgente[a] || 0) + (e.bytes || 0);
+}
+
+const totalBytes = Object.values(porAgente).reduce((s,v) => s+v, 0);
+console.log('Bytes totales sesión: ' + totalBytes);
+console.log('Velocidad promedio: ' + Math.round(totalBytes / lineas.length) + ' bytes/evento');
+console.log('Eventos totales: ' + lineas.length);
+"
+```
+
+Usar la velocidad promedio como factor de calibración: si el historial muestra >1000 bytes/evento, los pesos base ×1.5.
+
+---
+
+## Recomendación de paralelización (reutiliza orquestacion-ptc)
+
+Regla del criterio de independencia (de `orquestacion-ptc`):
+
+**Usar PTC paralelo cuando:**
+- Las tareas no se bloquean entre sí (salida de A no es entrada de B)
+- Hay ≥3 tareas del mismo tipo para el mismo agente
+- Las tareas son verificaciones (sin efectos secundarios que se pisen)
+- Ahorro esperado: −70 a −85% en tokens del orquestador
+
+**Usar serial cuando:**
+- La tarea N+1 depende del resultado de la tarea N
+- Son acciones sobre infraestructura (migrations, deploys) donde el orden importa
+- Solo hay 1-2 tareas (overhead de PTC no vale)
+
+Para la fase `implementacion` con N tareas pendientes:
+
+| N tareas pendientes | Estrategia recomendada | Ahorro estimado |
+|---|---|---|
+| 1-2 | Serial (directo) | — |
+| 3-5 independientes | PTC paralelo (lote de 3-5) | ~70% |
+| 6-10 independientes | PTC en 2 lotes de 5 | ~65% |
+| >10 independientes | PTC en lotes de 5 + agrupación por agente | ~60% |
+| Cualquier N con deps | Serial (respetar grafo de dependencias) | — |
+
+---
+
+## Output que produces
+
+```
+╔══════════════════════════════════════════════════════════════════╗
+║           💰 TOKEN BUDGET — Proyección de Fases Restantes        ║
+╠══════════════════════════════════════════════════════════════════╣
+║  Fase actual: {fase}  |  Spec: {SPEC_ID}                        ║
+╠══════════════════════════════════════════════════════════════════╣
+║  FASES RESTANTES      | PESO EST. | ESTRATEGIA    | AGENTES     ║
+║  ─────────────────────┼───────────┼───────────────┼──────────── ║
+║  implementacion       | ████ 40   | PTC × 3 lotes | 3 agentes   ║
+║    └─ {N} tareas pend.|           | serial internamente         ║
+║  verificacion         | ██ 16     | Serial (deps) | —           ║
+║  qa                   | ██ 10     | PTC × flows   | tester      ║
+║  deploy               | █ 4       | Serial        | operaciones ║
+║  ─────────────────────┼───────────┼───────────────┼──────────── ║
+║  TOTAL ESTIMADO       | ████████  | 70            |             ║
+╠══════════════════════════════════════════════════════════════════╣
+║  📊 CALIBRACIÓN CON HISTORIAL                                    ║
+║                                                                  ║
+║  {datos del ledger o "Sin historial — usando pesos base"}        ║
+╠══════════════════════════════════════════════════════════════════╣
+║  🚀 RECOMENDACIÓN DE EJECUCIÓN                                   ║
+║                                                                  ║
+║  1. {fase más costosa}: usar effort-router para degradar         ║
+║     modelos donde sea posible (ahorro ~{%}% estimado)            ║
+║                                                                  ║
+║  2. {fase con tareas independientes}: usar PTC con lotes         ║
+║     de {N} → comando: /sdd.implementar ptc={N}                   ║
+║                                                                  ║
+║  3. Si el presupuesto es ajustado: comprimir memoria antes       ║
+║     de lanzar la fase de implementación                          ║
+╚══════════════════════════════════════════════════════════════════╝
+```
+
+---
+
+## Notas
+
+- Los pesos son relativos, no tokens reales. Claude Code no expone el conteo exacto de tokens al contexto.
+- La calibración con el ledger mejora la precisión: si la sesión actual ya tiene datos, los pesos se ajustan a la velocidad real observada.
+- Para proyectos con presupuesto de API estricto, usar junto con `effort-router` para maximizar el ahorro antes de lanzar fases costosas.
+- Esta skill se invoca desde `/sdd.optimizar presupuesto` y como PASO 6 de `/sdd.optimizar`.
+- Reutiliza los criterios de independencia de `orquestacion-ptc` — si esa skill tiene más detalle sobre cuándo paralelizar, referenciarlo directamente.

package/skills/vercel-deploy/00-START-HERE.txt

@@ -0,0 +1,364 @@
+================================================================================
+                           ¡BIENVENIDO!
+                  Skill: Despliegue Automático en Vercel
+                          vercel-deploy v1.0.0
+================================================================================
+
+Ubicación: c:\Users\usuario\sdd-lite\sdd-lite\skills\vercel-deploy\
+
+Este directorio contiene un skill completo para automatizar deployments en
+Vercel con 6 pasos atómicos, health checks automáticos y rollback seguro.
+
+================================================================================
+                      ¿POR DÓNDE EMPIEZO? (Elige tu caso)
+================================================================================
+
+1️⃣  QUIERO DESPLEGAR YA (10 MINUTOS)
+    ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+    Paso 1: Lee README.md (2 min)
+    Paso 2: Genera VERCEL_TOKEN en https://vercel.com/account/tokens (2 min)
+    Paso 3: Haz export VERCEL_TOKEN="vercel_xxx..." (1 min)
+    Paso 4: Ejecuta bash deploy.sh (4 min)
+
+    RESULTADO: Tu app en vivo en Vercel
+
+    ➜ Ve a: README.md
+
+
+2️⃣  QUIERO ENTENDER EL FLUJO (20 MINUTOS)
+    ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+    Paso 1: Lee EXEC-SUMMARY.txt para overview (5 min)
+    Paso 2: Estudia SKILL.md para especificación completa (10 min)
+    Paso 3: Revisa FLOW.txt para diagrama visual (5 min)
+
+    RESULTADO: Entiendes 100% cómo funciona
+
+    ➜ Ve a: EXEC-SUMMARY.txt
+
+
+3️⃣  QUIERO INTEGRAR EN /sdd.implementar (25 MINUTOS)
+    ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+    Paso 1: Lee INTEGRATION.md (10 min)
+    Paso 2: Copia la configuración YAML a tu proyecto (5 min)
+    Paso 3: Configura VERCEL_TOKEN (5 min)
+    Paso 4: Prueba con /sdd.desplegar (5 min)
+
+    RESULTADO: Skill integrado en tu flujo SDD
+
+    ➜ Ve a: INTEGRATION.md
+
+
+4️⃣  NECESITO VERIFICAR TODO ESTÁ OK (5 MINUTOS)
+    ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+    Paso 1: Abre CHECKLIST.md
+    Paso 2: Ejecuta la lista de validaciones
+    Paso 3: Si todo está verde ✅, procede al deployment
+
+    RESULTADO: Validación completa pre-deploy
+
+    ➜ Ve a: CHECKLIST.md
+
+
+5️⃣  ALGO FALLÓ, NECESITO AYUDA (VARIABLE)
+    ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+    Paso 1: Revisa tabla de errores en README.md
+    Paso 2: Más detalles en SKILL.md → "Manejo de errores"
+    Paso 3: Si es integración, ve a INTEGRATION.md → "Troubleshooting"
+    Paso 4: Consulta FLOW.txt para visualizar dónde falló
+
+    RESULTADO: Diagnosis e instrucciones de remediar
+
+    ➜ Ve a: README.md → Errores comunes
+
+
+6️⃣  SOY ARQUITECTO/DEVOPS, QUIERO VER TODO (1 HORA)
+    ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+    Paso 1: MANIFEST.md — Contenido e índice (5 min)
+    Paso 2: SKILL.md — Especificación con código (20 min)
+    Paso 3: deploy.sh — Revisión de código (15 min)
+    Paso 4: skill.yaml — Metadata y configuración (10 min)
+    Paso 5: FLOW.txt — Diagrama de flujo (10 min)
+
+    RESULTADO: Visión 360° del skill
+
+    ➜ Ve a: MANIFEST.md
+
+
+================================================================================
+                          ARCHIVO CORRECTO PARA TI
+================================================================================
+
+Archivo              Tipo              Lectura   Propósito
+─────────────────────────────────────────────────────────────────────────────
+README.md            Quick start       2 min     Empezar YA
+CHECKLIST.md         Pre-requisitos    5 min     Validar antes de desplegar
+SKILL.md             Especificación   10 min     Entender flujo completo
+INTEGRATION.md       Integración      10 min     Conectar con /sdd.implementar
+FLOW.txt             Diagrama          5 min     Ver diagrama visual
+deploy.sh            Ejecutable        5 min     Ver código
+skill.yaml           Metadata          5 min     Referencia técnica
+INDEX.md             Navegación        5 min     Mapa de documentos
+MANIFEST.md          Resumen          10 min     Contenido e índice
+EXEC-SUMMARY.txt     Summary          10 min     Overview empresarial
+estado.json.example  Ejemplo JSON      2 min     Ver formato salida
+
+================================================================================
+                            FLUJO RÁPIDO: 3 PASOS
+================================================================================
+
+┌─────────────────────────────────────────────────────────────────────────┐
+│ PASO 1: Obtener VERCEL_TOKEN                                           │
+│ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ │
+│                                                                         │
+│ 1. Ve a: https://vercel.com/account/tokens                            │
+│ 2. Crea nuevo token (scope: full)                                     │
+│ 3. Copia el token: vercel_xxx_abc123...                               │
+│                                                                         │
+│ Luego guarda:                                                          │
+│   export VERCEL_TOKEN="vercel_xxx_abc123..."                          │
+│   # O persistente:                                                    │
+│   echo 'VERCEL_TOKEN=vercel_xxx_abc123...' >> .env.local              │
+│                                                                         │
+└─────────────────────────────────────────────────────────────────────────┘
+
+┌─────────────────────────────────────────────────────────────────────────┐
+│ PASO 2: Verificar pre-requisitos                                       │
+│ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ │
+│                                                                         │
+│ Abre CHECKLIST.md y ejecuta:                                          │
+│                                                                         │
+│ ✓ VERCEL_TOKEN presente                                              │
+│ ✓ Rama limpia (git status limpio)                                    │
+│ ✓ Sin secretos en src/                                               │
+│ ✓ Tests verdes (npm test)                                            │
+│ ✓ Build local OK (npm run build)                                     │
+│                                                                         │
+│ Si algo falla, ve a CHECKLIST.md para instrucc. de remediar          │
+│                                                                         │
+└─────────────────────────────────────────────────────────────────────────┘
+
+┌─────────────────────────────────────────────────────────────────────────┐
+│ PASO 3: Ejecutar el skill                                              │
+│ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ │
+│                                                                         │
+│ bash deploy.sh                                                         │
+│                                                                         │
+│ SALIDA ESPERADA:                                                       │
+│                                                                         │
+│ 🚀 DESPLIEGUE A VERCEL                                                │
+│                                                                         │
+│   ✅ Pre-checks completados                                           │
+│   ✅ Build exitoso                                                    │
+│   ✅ Vercel deployment: https://proyecto.vercel.app                  │
+│   ✅ Health check: HTTP 200 OK                                        │
+│                                                                         │
+│   Tu app está en vivo: https://proyecto.vercel.app                   │
+│   Tiempo total: 3m 42s                                                │
+│                                                                         │
+│ Próximos pasos:                                                       │
+│   • Comparte URL con testers                                         │
+│   • Monitorea por 15 minutos                                         │
+│   • Ejecuta /sdd.snapshot para actualizar estado                     │
+│                                                                         │
+└─────────────────────────────────────────────────────────────────────────┘
+
+================================================================================
+                           CARACTERÍSTICAS PRINCIPALES
+================================================================================
+
+✅ FLUJO ATÓMICO (6 PASOS)
+   1. Pre-checks: VERCEL_TOKEN, rama limpia, sin secretos, tests OK
+   2. Configuración: Detecta framework, genera vercel.json automáticamente
+   3. Build & Deploy: npm run build + vercel deploy --prod
+   4. Health Check: 3 reintentos automáticos con backoff
+   5. Rollback: Automático si falla
+   6. Registro: Metadatos en .sdd/estado.json
+
+✅ SEGURIDAD ENTERPRISE
+   • Detección de secretos pre-deploy
+   • VERCEL_TOKEN nunca se loguea
+   • Rama limpia antes de desplegar
+   • .env.local en .gitignore
+
+✅ CONFIABILIDAD
+   • Idempotencia (ejecutar 2x = mismo resultado)
+   • Health checks automáticos
+   • Rollback atómico
+   • Sin estados intermedios
+
+✅ OBSERVABILIDAD
+   • Output visual con emojis
+   • Logging completo en .sdd/estado.json
+   • Auditoría de cada paso
+   • Métricas de duración
+
+✅ DOCUMENTACIÓN
+   • 11 archivos completamente documentados
+   • 4 rutas de lectura diferentes
+   • Diagramas ASCII
+   • Ejemplos ejecutables
+
+================================================================================
+                       ESTRUCTURA DEL DIRECTORIO
+================================================================================
+
+📂 vercel-deploy/
+  │
+  ├─ 00-START-HERE.txt ⭐        Este archivo (empieza aquí)
+  │
+  ├─ ARCHIVOS PRINCIPALES:
+  │  ├─ SKILL.md                  Especificación completa (10 KB)
+  │  ├─ deploy.sh                 Script ejecutable (8 KB)
+  │  └─ README.md                 Quick start (2 KB)
+  │
+  ├─ GUÍAS ESPECIALIZADAS:
+  │  ├─ CHECKLIST.md              Pre-requisitos (5 KB)
+  │  ├─ INTEGRATION.md            Cómo integrar (8 KB)
+  │  └─ FLOW.txt                  Diagrama visual (15 KB)
+  │
+  ├─ REFERENCIA:
+  │  ├─ INDEX.md                  Mapa de navegación (6 KB)
+  │  ├─ MANIFEST.md               Contenido (8 KB)
+  │  ├─ EXEC-SUMMARY.txt          Overview empresarial (10 KB)
+  │  └─ skill.yaml                Metadata (10 KB)
+  │
+  └─ EJEMPLOS:
+     ├─ estado.json.example       Salida del deploy (15 KB)
+     └─ (más archivos)
+
+TOTAL: 11 archivos (~100 KB)
+
+================================================================================
+                       TIEMPO ESTIMADO POR TAREA
+================================================================================
+
+Tarea                                        Tiempo
+─────────────────────────────────────────────────────────────────────────────
+Leer este archivo (00-START-HERE.txt)        2 min
+Generar VERCEL_TOKEN                         2 min
+Leer README.md                               2 min
+Ejecutar deploy.sh                           4 min
+                                           ────────
+TOTAL PARA PRIMER DEPLOYMENT                10 min
+
+Integrar en /sdd.implementar                20 min
+Entrenar al team                            20 min
+Monitoreo post-deploy                       15 min
+                                           ────────
+TOTAL PRIMER DÍA                            65 min
+
+================================================================================
+                           PRÓXIMOS PASOS
+================================================================================
+
+Ya mismo:
+  1. Lee README.md (2 min)
+  2. Generas VERCEL_TOKEN (2 min)
+
+En los próximos 5 minutos:
+  3. Haz export VERCEL_TOKEN=...
+  4. Ejecuta bash deploy.sh
+  5. Verifica que tu app está en vivo
+
+Hoy:
+  6. Documenta la URL en tu proyecto
+  7. Avisa al team
+  8. Monitorea por 15 minutos
+
+Esta semana:
+  9. Integra el skill en /sdd.implementar
+  10. Entrena al team en el flujo
+
+Este mes:
+  11. Monitorea deployments
+  12. Ajusta configuración si necesario
+
+================================================================================
+                            SOPORTE RÁPIDO
+================================================================================
+
+PREGUNTA: "¿Por dónde empiezo?"
+RESPUESTA: Lee README.md (2 min)
+ARCHIVO: README.md
+
+PREGUNTA: "Necesito validar todo antes de desplegar"
+RESPUESTA: Abre CHECKLIST.md y sigue la lista
+ARCHIVO: CHECKLIST.md
+
+PREGUNTA: "¿Cómo integro en mi flujo SDD?"
+RESPUESTA: Ve a INTEGRATION.md (10 min)
+ARCHIVO: INTEGRATION.md
+
+PREGUNTA: "Algo falló, ¿qué hago?"
+RESPUESTA: Consulta tabla de errores en README.md
+ARCHIVO: README.md → "Errores comunes"
+
+PREGUNTA: "Quiero ver el diagrama de flujo"
+RESPUESTA: Abre FLOW.txt (diagrama ASCII)
+ARCHIVO: FLOW.txt
+
+PREGUNTA: "¿Qué contiene este skill?"
+RESPUESTA: Ve a MANIFEST.md
+ARCHIVO: MANIFEST.md
+
+PREGUNTA: "Soy DevOps, quiero detalles técnicos"
+RESPUESTA: EXEC-SUMMARY.txt → SKILL.md → skill.yaml
+ARCHIVOS: EXEC-SUMMARY.txt, SKILL.md, skill.yaml
+
+================================================================================
+                     LOS 6 PASOS EXPLICADOS EN 30 SEGUNDOS
+================================================================================
+
+1. PRE-CHECKS       → Verifica que todo está OK (token, rama, tests)
+2. CONFIGURACIÓN    → Auto-detecta framework (next, react, etc.)
+3. BUILD & DEPLOY   → Compila y envía a Vercel
+4. HEALTH CHECK     → Reintenta 3 veces hasta que responda HTTP 200
+5. ROLLBACK         → Si falla, vuelve al deploy anterior (automático)
+6. REGISTRO         → Guarda metadatos en .sdd/estado.json
+
+RESULTADO: Tu app en vivo en Vercel, 100% confiable.
+
+================================================================================
+                              COMIENZA AQUÍ
+================================================================================
+
+→ Para desplegar YA:
+  Abre: README.md
+
+→ Para entender todo:
+  Abre: EXEC-SUMMARY.txt
+
+→ Para integrar en SDD:
+  Abre: INTEGRATION.md
+
+→ Para validar pre-requisitos:
+  Abre: CHECKLIST.md
+
+→ Para ver el diagrama:
+  Abre: FLOW.txt
+
+¿LISTO? 🚀
+
+Ve al archivo que necesites arriba ↑
+
+================================================================================
+                             BIENVENIDO AL FUTURO
+                       DE DEPLOYMENTS SIN PREOCUPACIONES
+================================================================================
+
+Este skill automatiza lo que antes era manual y error-prone.
+Disfruta del deployment seguro, rápido y confiable a Vercel.
+
+Preguntas? Consulta la documentación dentro de este directorio.
+
+Versión: 1.0.0
+Estado: ✅ Listo para usar
+Fecha: 2026-06-13
+
+================================================================================