don-cheli-sdd 1.13.0

package/comandos/bucle.md

@@ -0,0 +1,74 @@
+---
+description: Lanzar bucle autónomo para ejecutar historias del PRD
+---
+
+# /bucle
+
+## Objetivo
+
+Lanzar el bucle autónomo que ejecuta las historias de usuario una por una hasta completar o agotar iteraciones.
+
+## Uso
+
+```
+/bucle [max_iteraciones]
+```
+
+- `max_iteraciones`: Número máximo de iteraciones (default: 10)
+
+## Prerrequisitos
+
+- Archivo `.especdev/sesion/prd.json` existente
+- Al menos una historia con `pasa: false`
+
+## Comportamiento
+
+1. **Verificar** que prd.json existe
+2. **Contar** historias restantes
+3. **Lanzar** el script `bucle.sh`
+4. **Para cada iteración:**
+   - Seleccionar historia prioritaria no completada
+   - Ejecutar en **contexto fresco** (aislado)
+   - Verificar criterios de aceptación
+   - Actualizar prd.json
+   - Registrar en progreso.md
+5. **Terminar** cuando:
+   - Todas las historias pasan → `COMPLETO`
+   - Máximo iteraciones alcanzado → fallo
+   - Historia bloqueada 2 veces → saltar y continuar
+
+## Output
+
+```
+=== Bucle Don Cheli Iniciado ===
+Historias: 5 pendientes, 0 completadas
+Máximo iteraciones: 10
+
+--- Iteración 1/10 ---
+Historia: HU-001 [P1] Estructura de archivos
+Estado: PASÓ ✅
+
+--- Iteración 2/10 ---
+Historia: HU-002 [P2] Comando historias-generar
+Estado: PASÓ ✅
+
+...
+
+=== COMPLETO ===
+Las 5 historias pasaron en 5 iteraciones.
+Ver progreso: .especdev/progreso.md
+```
+
+## Gestión de Errores
+
+| Situación | Comportamiento |
+|-----------|---------------|
+| prd.json faltante | Error + sugerir /historias-generar |
+| Sin historias pendientes | Mensaje "Nada que hacer" |
+| Historia falla 1x | Reintentar en siguiente iteración |
+| Historia falla 2x | Saltar + registrar |
+| Máximo iteraciones | Salir con mensaje |
+
+## Contexto Fresco
+
+Cada historia se ejecuta en su propio contexto aislado. El agente NO acumula confusión de sesiones anteriores. Investigaciones muestran que las respuestas de LLM degradan notablemente en contextos largos. **Contexto fresco = agente más inteligente.**

package/comandos/especdev/actualizar.md

@@ -0,0 +1,200 @@
+---
+description: Detectar actualizaciones del framework Don Cheli y aplicarlas
+i18n: true
+---
+
+# /especdev:actualizar
+
+## Objetivo
+
+Verificar si hay actualizaciones disponibles en el repositorio de Don Cheli y ofrecer aplicarlas.
+
+## Uso
+
+```
+/especdev:actualizar
+/especdev:actualizar --verificar    # Solo verificar, no aplicar
+/especdev:actualizar --forzar       # Aplicar sin confirmar
+```
+
+## Proceso
+
+### 1. Detectar instalación
+
+```bash
+# Verificar dónde está instalado
+GLOBAL="$HOME/.claude/don-cheli"
+LOCAL="./.claude/don-cheli"
+
+if [ -f "$GLOBAL/VERSION" ]; then
+  INSTALACION="$GLOBAL"
+elif [ -f "$LOCAL/VERSION" ]; then
+  INSTALACION="$LOCAL"
+else
+  echo "Don Cheli no está instalado"
+  exit 1
+fi
+
+VERSION_LOCAL=$(cat "$INSTALACION/VERSION")
+```
+
+### 2. Verificar versión remota
+
+```bash
+VERSION_REMOTA=$(curl -s https://raw.githubusercontent.com/doncheli/don-cheli-sdd/main/VERSION)
+```
+
+### 3. Comparar
+
+```
+=== Verificación de Actualización ===
+
+Versión instalada: 1.6.0
+Versión disponible: 1.7.0
+
+Estado: ⚠️ Actualización disponible
+```
+
+### 4. Mostrar cambios
+
+Obtener el changelog entre versiones:
+
+```bash
+# Mostrar commits entre versiones
+curl -s "https://api.github.com/repos/doncheli/don-cheli-sdd/compare/v${VERSION_LOCAL}...v${VERSION_REMOTA}" \
+  | jq '.commits[].commit.message'
+```
+
+### 5. Preguntar al usuario
+
+```
+¿Deseas actualizar Don Cheli de v1.6.0 a v1.7.0? (s/n)
+```
+
+### 6. Aplicar actualización
+
+```bash
+# Clonar versión nueva en temporal
+TEMP=$(mktemp -d)
+git clone --depth 1 https://github.com/doncheli/don-cheli-sdd.git "$TEMP"
+
+# Ejecutar instalador
+cd "$TEMP" && bash scripts/instalar.sh --global
+
+# Limpiar
+rm -rf "$TEMP"
+```
+
+## Output
+
+```
+=== Actualización Completada ===
+
+✅ Don Cheli actualizado: v1.6.0 → v1.7.0
+
+Cambios aplicados:
+- 3 habilidades nuevas
+- 2 comandos nuevos
+- 5 archivos actualizados
+
+Reinicia Claude Code para aplicar los cambios.
+```
+
+## Verificación de Anthropic Skills 2.0
+
+Además de actualizar el framework, este comando verifica la conformidad con el estándar Anthropic Agent Skills.
+
+### Proceso de verificación
+
+```
+1. FETCH — Obtener spec y template desde el repo oficial
+   ├── https://github.com/anthropics/skills/blob/main/spec/agent-skills-spec.md
+   ├── https://github.com/anthropics/skills/blob/main/template/SKILL.md
+   └── https://agentskills.io/specification (spec completa)
+
+2. COMPARE — Comparar con el formato actual del framework
+   ├── Campos requeridos en frontmatter (name, description)
+   ├── Campos nuevos agregados al spec
+   ├── Convenciones de naming (lowercase, hyphens, max 64 chars)
+   ├── Estructura de directorios (skill-name/SKILL.md)
+   └── Features nuevas (hooks, allowed-tools, model, effort, etc.)
+
+3. AUDIT — Validar archivos del framework
+   ├── Comandos en comandos/especdev/*.md → frontmatter válido
+   ├── Comandos en comandos/razonar/*.md → frontmatter válido
+   ├── Skills en .agent/skills/*/SKILL.md → conformidad Anthropic
+   ├── Habilidades en habilidades/*/HABILIDAD.md → formato extendido
+   └── Naming conventions en todos los archivos
+
+4. REPORT — Generar reporte de conformidad
+```
+
+### Output de verificación Skills 2.0
+
+```
+=== Anthropic Skills 2.0 — Verificación de Conformidad ===
+
+Spec source: https://agentskills.io/specification
+Template source: https://github.com/anthropics/skills/blob/main/template/SKILL.md
+Last check: 2026-03-24
+
+Campos requeridos:
+  ✅ name — presente en todos los skills
+  ✅ description — presente en todos los skills y comandos
+
+Campos opcionales detectados en spec:
+  ✅ allowed-tools — soportado
+  ✅ model — soportado
+  ✅ effort — soportado
+  ⚠️ hooks — no implementado en habilidades Don Cheli (solo en .agent/skills)
+  ⚠️ context: fork — no implementado
+
+Naming:
+  ✅ 125/125 archivos siguen convención lowercase-hyphens
+
+Novedades en el spec (si las hay):
+  ℹ️ Nuevo campo "argument-hint" detectado — considerar agregar
+  ℹ️ Nuevo campo "disable-model-invocation" — considerar agregar
+
+Resumen: 98% conformidad | 2 campos opcionales pendientes
+```
+
+### Qué se verifica contra el spec oficial
+
+| Check | Fuente | Qué valida |
+|-------|--------|------------|
+| Frontmatter YAML | Template oficial | `---` delimiters, campos `name` + `description` |
+| Naming | Spec | Solo lowercase, números, hyphens (max 64 chars) |
+| Estructura | Spec | `skill-name/SKILL.md` dentro del directorio de skills |
+| Campos opcionales | Spec en agentskills.io | Nuevos campos agregados al estándar |
+| Plugin format | `.claude-plugin` | Compatibilidad con marketplace oficial |
+| Description length | Spec | Max 1024 chars recomendado |
+
+### Comando combinado
+
+```bash
+/dc:actualizar                    # Actualiza framework + verifica Skills 2.0
+/dc:actualizar --solo-skills      # Solo verificar conformidad Skills 2.0
+/dc:actualizar --verificar        # Solo verificar, no aplicar nada
+/dc:actualizar --forzar           # Aplicar sin confirmar
+```
+
+## Verificación Automática
+
+Si se configura en `.especdev/config.yaml`:
+
+```yaml
+actualizaciones:
+  verificar_al_iniciar: true
+  frecuencia: semanal  # diario | semanal | nunca
+  verificar_skills_spec: true  # Verificar conformidad Anthropic Skills 2.0
+```
+
+El comando `/dc:continuar` verifica automáticamente si hay actualizaciones disponibles y notifica al usuario sin interrumpir el flujo.
+
+## Fuentes oficiales
+
+- Spec: https://agentskills.io/specification
+- Repo: https://github.com/anthropics/skills
+- Template: https://github.com/anthropics/skills/blob/main/template/SKILL.md
+- Docs: https://support.claude.com/en/articles/12512198-creating-custom-skills

package/comandos/especdev/agente.md

@@ -0,0 +1,43 @@
+---
+description: Cargar un agente especializado para una tarea específica
+i18n: true
+---
+
+# /especdev:agente
+
+## Objetivo
+
+Cargar un agente especializado con el modelo óptimo para una tarea específica.
+
+## Uso
+
+```
+/especdev:agente <nombre>
+/especdev:agente restablecer
+```
+
+## Agentes Disponibles
+
+| Agente | Modelo | Rol |
+|--------|--------|-----|
+| `planificador` | opus | Planificación, descomposición de tareas |
+| `arquitecto` | opus | Diseño de sistemas, decisiones técnicas |
+| `ejecutor` | sonnet | Implementación, escritura de código |
+| `revisor` | opus | Revisión de código, validación de calidad |
+| `tester` | sonnet | Escritura y ejecución de tests |
+| `documentador` | haiku | Actualización de documentación |
+| `estimador` | opus | Estimados de desarrollo y esfuerzo |
+
+## Flujo de Trabajo
+
+```
+Modo Completo: planificador → arquitecto → ejecutor ↔ tester → revisor → documentador
+Modo Rápido:   ejecutor → tester → documentador
+```
+
+## Ahorro de Costos
+
+| Modo | Distribución | Ahorro vs Opus-solo |
+|------|--------------|---------------------|
+| Rápido | 80% sonnet, 20% haiku | ~60% |
+| Completo | 50% sonnet, 30% opus, 20% haiku | ~40% |

package/comandos/especdev/analizar-sesiones.md

@@ -0,0 +1,158 @@
+---
+description: Analizar sesiones de Claude en el equipo para extraer patrones de uso y generar recomendaciones de habilidades, plugins, agentes y reglas
+i18n: true
+---
+
+# /especdev:analizar-sesiones
+
+## Objetivo
+
+Escanear todas las sesiones de Claude en el equipo local, analizar patrones de uso, y generar recomendaciones concretas sobre qué debería convertirse en habilidades reutilizables, plugins, agentes autónomos o instrucciones de proyecto.
+
+## Uso
+
+```
+/especdev:analizar-sesiones
+/especdev:analizar-sesiones --periodo <dias>
+/especdev:analizar-sesiones --formato <resumen|detallado|ejecutivo>
+```
+
+## Comportamiento
+
+1. **Escanear** todas las sesiones de Claude en el equipo
+   - Ubicación típica: `~/.claude/projects/` y sesiones en ficheros JSONL
+   - Incluye: prompts del usuario, respuestas del agente, herramientas usadas, archivos editados
+
+2. **Clasificar** cada interacción por tipo:
+   - Generación de código
+   - Debugging / corrección de bugs
+   - Refactoring
+   - Code review
+   - Documentación
+   - Pregunta / Q&A
+   - Configuración / DevOps
+   - Diseño / Arquitectura
+   - Testing
+   - Scripting / Automatización
+
+3. **Analizar** patrones de frecuencia:
+   - ¿Qué tipo de tareas se repiten más?
+   - ¿Qué archivos se editan con más frecuencia?
+   - ¿Qué comandos/herramientas se usan más?
+   - ¿Qué patrones de prompt se repiten?
+   - ¿Cuántos tokens se consumen por tipo de tarea?
+
+4. **Generar** recomendaciones en 5 categorías
+
+## Output
+
+```markdown
+# Análisis de Sesiones de Claude
+
+## 📊 Resumen de Uso
+
+| Métrica | Valor |
+|---------|-------|
+| Sesiones analizadas | 47 |
+| Período | Últimos 30 días |
+| Tokens consumidos | ~2.4M |
+| Tipo más frecuente | Generación de código (38%) |
+
+## 🔁 Lo que Hago Más Frecuentemente
+
+| # | Actividad | Frecuencia | Tokens/Sesión |
+|---|----------|------------|---------------|
+| 1 | Crear componentes React | 23 veces | ~8K |
+| 2 | Corregir tests fallidos | 18 veces | ~5K |
+| 3 | Escribir endpoints API | 15 veces | ~12K |
+| 4 | Refactorizar funciones | 12 veces | ~6K |
+| 5 | Generar documentación | 9 veces | ~3K |
+
+## 🧠 Debería Convertirse en HABILIDAD (Skill)
+
+Flujos de trabajo reutilizables que repito constantemente:
+
+| Skill Propuesta | Basada en | Ahorro Estimado |
+|----------------|-----------|-----------------|
+| `crear-componente-react` | 23 sesiones de creación de componentes | ~40% tokens |
+| `fix-test-pattern` | 18 sesiones de debugging de tests | ~30% tokens |
+| `api-endpoint-scaffold` | 15 sesiones de creación de APIs | ~50% tokens |
+
+**Formato de skill:**
+```yaml
+# habilidades/crear-componente-react/HABILIDAD.md
+Patrón detectado: El usuario siempre pide...
+1. Crear componente funcional con TypeScript
+2. Agregar tests unitarios con testing-library
+3. Agregar storybook story
+4. Exportar desde index.ts
+```
+
+## 🔌 Debería Convertirse en PLUGIN (Herramienta Standalone)
+
+Herramientas que uso repetidamente que podrían automatizarse:
+
+| Plugin Propuesto | Basado en | Tipo |
+|-----------------|-----------|------|
+| `scaffold-feature` | Creación repetitiva de estructura feature/ | CLI tool |
+| `test-coverage-checker` | Verificación manual de cobertura | Script |
+| `pr-description-gen` | Redacción manual de descripciones de PR | Automatización |
+
+## 🤖 Debería Convertirse en AGENTE (Subagente Autónomo)
+
+Tareas que delego completas y que podrían ejecutarse autónomamente:
+
+| Agente Propuesto | Basado en | Modelo Recomendado |
+|-----------------|-----------|-------------------|
+| `code-reviewer` | Revisiones de código frecuentes | Sonnet |
+| `test-generator` | Generación repetitiva de tests | Haiku |
+| `doc-updater` | Actualización de docs tras cambios | Haiku |
+
+## 📋 Debería Ir en CLAUDE.md (Instrucciones de Proyecto)
+
+Reglas que repito en cada sesión y deberían ser instrucciones permanentes:
+
+| Regla | Veces Repetida |
+|-------|---------------|
+| "Usa TypeScript estricto" | 34 veces |
+| "Tests con testing-library, no enzyme" | 22 veces |
+| "No uses any" | 19 veces |
+| "Imports ordenados: react primero" | 15 veces |
+
+**CLAUDE.md sugerido:**
+```markdown
+## Convenciones
+- TypeScript estricto (no `any`)
+- Tests con @testing-library/react
+- Imports: React > libs externas > internos > tipos
+- Componentes funcionales, no clases
+```
+
+## 💡 Recomendaciones de Optimización
+
+1. **Tokenización:** ~40% de tus tokens se gastan en repetir contexto
+   → Crear skills reduciría consumo en ~35%
+2. **Modelo:** Usas Opus para tareas que Haiku podría resolver
+   → Usar la matriz de selección de modelos ahorraría ~60% costo
+3. **Sesiones largas:** El 30% de tus sesiones exceden 50K tokens
+   → Implementar context folding (RLM) mejoraría calidad
+```
+
+## Cómo Mejora el Framework
+
+| Aspecto | Sin Análisis | Con Análisis |
+|---------|-------------|-------------|
+| **Skills** | Genéricas, predefinidas | Personalizadas según tu uso real |
+| **Plugins** | No existen | Auto-generados desde patrones |
+| **Agentes** | Configuración manual | Asignación automática por patrón |
+| **CLAUDE.md** | Escribir manualmente | Auto-generado desde repeticiones |
+| **Costos** | Sin control | Optimizado por matriz de modelos |
+
+## Integración con Don Cheli
+
+Este comando se integra con:
+- `/especdev:iniciar` → Las skills detectadas se sugieren al crear un proyecto nuevo
+- `/especdev:agente` → Los agentes detectados se agregan al sistema de agentes
+- `/especdev:estimar` → Los datos históricos alimentan estimados más precisos
+- **Reglas de Trabajo Globales** → Las reglas detectadas se incorporan automáticamente
+- **Optimización de Tokens** → Los patrones de consumo optimizan uso de modelos

package/comandos/especdev/aplicar.md

@@ -0,0 +1,73 @@
+---
+description: Aplicar (implementar) tareas de un cambio específico
+i18n: true
+---
+
+# /especdev:aplicar
+
+## Objetivo
+
+Implementar las tareas de un cambio específico, con soporte para cambios paralelos y context switching.
+
+> Adaptado de `/opsx:apply` de OpenSpec — implementación fluida con soporte multi-cambio.
+
+## Uso
+
+```
+/especdev:aplicar                     # Implementar el cambio activo
+/especdev:aplicar <nombre-cambio>     # Implementar un cambio específico
+/especdev:aplicar --continuar         # Retomar donde se dejó
+```
+
+## Diferencia con /especdev:implementar
+
+| `/especdev:implementar` | `/especdev:aplicar` |
+|------------------------|---------------------|
+| Trabaja con .tasks.md clásico | Trabaja con carpeta de cambio |
+| Un cambio a la vez | Múltiples cambios en paralelo |
+| Pipeline rígido | Flujo flexible |
+| Sin context switching | Con context switching |
+
+## Comportamiento
+
+1. **Leer** `.especdev/cambios/<nombre>/tareas.md`
+2. **Detectar** progreso previo (si hay tareas ya completadas)
+3. **Ejecutar** tareas pendientes una por una
+4. **Ejecutar** stop hooks después de cada fase
+5. **Marcar** tareas como completadas
+6. **Reportar** progreso
+
+## Output
+
+```
+=== Aplicando: agregar-dark-mode ===
+
+Progreso: retomando desde tarea 3/8
+
+✅ 1.1 Crear ThemeContext provider (ya hecho)
+✅ 1.2 Crear hook useTheme (ya hecho)
+✅ 2.1 Agregar CSS custom properties (ya hecho)
+🔄 2.2 Crear componente ThemeToggle ← EN PROGRESO
+   → Escribiendo tests...
+   → Implementando componente...
+   → Tests pasan ✅
+⬜ 3.1 Integrar toggle en header
+⬜ 3.2 Agregar localStorage persistence
+⬜ 4.1 Dark mode para todas las páginas
+⬜ 4.2 Transición suave entre temas
+
+Progreso: 4/8 tareas completadas (50%)
+```
+
+## Context Switching
+
+```bash
+# Trabajando en dark mode...
+/especdev:aplicar agregar-dark-mode   # tarea 4/8
+
+# Interrumpido por bug urgente
+/especdev:aplicar corregir-login      # empieza desde tarea 1/3
+
+# Bug corregido, volver a dark mode
+/especdev:aplicar agregar-dark-mode   # retoma en tarea 5/8
+```

package/comandos/especdev/archivar.md

@@ -0,0 +1,69 @@
+---
+description: Archivar specs completadas y sincronizar delta specs con specs principales
+i18n: true
+---
+
+# /especdev:archivar
+
+## Objetivo
+
+Sincronizar las specs delta (cambios incrementales) con las specs principales y archivar las features completadas para referencia futura.
+
+> Adaptado de `sdd-archive` de Gentle-AI — fase de cierre que Don Cheli no tenía.
+
+## Uso
+
+```
+/especdev:archivar @specs/features/<dominio>/<Feature>.feature
+/especdev:archivar --todo   # Archivar todas las features @implementada
+```
+
+## Comportamiento
+
+1. **Verificar** que la feature tiene tag `@implementada` (todos los tests pasan)
+2. **Mover** artefactos completados a `specs/archivo/`
+3. **Actualizar** la spec principal del dominio si existe
+4. **Registrar** en `.especdev/memoria/decisiones.md`
+5. **Limpiar** archivos temporales de la feature
+
+## Estructura de Archivo
+
+```
+specs/
+├── features/          # Features ACTIVAS
+│   └── usuario/
+│       └── EditarPerfil.feature  (en progreso)
+├── archivo/           # Features COMPLETADAS
+│   └── usuario/
+│       └── CrearUsuario/
+│           ├── CrearUsuario.feature
+│           ├── CrearUsuario.plan.md
+│           ├── CrearUsuario.tasks.md
+│           ├── review.md
+│           └── metadata.json  # Fechas, métricas, estimado vs real
+└── db_schema/         # Schemas (no se archivan)
+```
+
+## metadata.json
+
+```json
+{
+  "feature": "CrearUsuario",
+  "dominio": "usuario",
+  "archivada": "2026-03-21",
+  "iniciada": "2026-03-18",
+  "duracion_real_dias": 3,
+  "estimado_dias": 5,
+  "precision_estimado": "60%",
+  "escenarios_gherkin": 5,
+  "tests_totales": 12,
+  "archivos_modificados": 8
+}
+```
+
+## Valor para el Framework
+
+Los datos archivados alimentan:
+- `/especdev:estimar` → datos históricos para estimados más precisos
+- `/especdev:analizar-sesiones` → patrones de desarrollo
+- Memoria persistente → decisiones y convenciones aprendidas