don-cheli-sdd 1.13.0

package/scripts/.claude/don-cheli/habilidades/optimizador-contexto/HABILIDAD.md

@@ -0,0 +1,97 @@
+# Habilidad: Optimizador de Contexto
+
+**Versión:** 1.0.0
+**Categoría:** Rendimiento
+**Tipo:** Rígida
+
+> Adaptado de `context-optimizer` de Pro-Workflow.
+
+## Cómo Mejora el Framework
+
+El contexto del agente es un recurso finito. Sin gestión activa:
+- A 70% → la calidad empieza a degradarse
+- A 90% → entra en la "zona muda" — respuestas genéricas
+- A 100% → errores y hallucinations
+
+## Diagnóstico Rápido
+
+| Uso de Contexto | Estado | Acción |
+|-----------------|--------|--------|
+| < 50% | 🟢 Óptimo | Seguir normal |
+| 50-70% | 🟡 Aceptable | Planificar compactación |
+| 70-90% | 🟠 Degradado | **Compactar AHORA** |
+| > 90% | 🔴 Zona muda | **Sesión nueva inmediatamente** |
+
+## Estrategias de Optimización
+
+### Inmediatas
+
+| Acción | Ahorro | Cuándo |
+|--------|--------|--------|
+| Compactar contexto | 30-50% | Al cambiar de tarea |
+| Desactivar MCPs no usados | ~5% por MCP | Al cambiar de dominio |
+| Delegar a subagentes | Mantiene contexto limpio | Tareas pesadas de lectura |
+| Sesión nueva con traspaso | 100% reset | Trabajo no relacionado |
+
+### Prompts Eficientes en Tokens
+
+- ❌ "Arreglá el código" (obliga al agente a leer todo)
+- ✅ "En src/auth/, corregir el bug de login" (scope acotado)
+- ✅ "No modificar el middleware" (restricción explícita)
+- ✅ "Debe retornar 429 después de 5 intentos" (criterio de aceptación)
+
+### Delegación a Subagentes
+
+Operaciones que generan mucho output van a subagentes:
+- Ejecución de suite de tests completa → subagente
+- Exploración de archivos grandes → subagente
+- Generación de documentación → subagente
+- Análisis de logs → subagente
+
+El contexto principal se mantiene limpio.
+
+### Presupuesto de Contexto por Fase
+
+| Fase | Uso Target | Si Se Excede |
+|------|-----------|--------------|
+| Planificación | < 20% | Mantener planes concisos |
+| Implementación | < 60% | Compactar entre archivos |
+| Testing | < 80% | Delegar a subagente |
+| Revisión | < 90% | Sesión nueva |
+
+## Optimización del System Prompt
+
+- System prompt principal: **< 60 líneas** ideal, **< 150** máx
+- Mover info por paquete a system prompts por módulo
+- Mover preferencias personales a archivo local
+- Eliminar info obvia o que cambia rápidamente
+
+## Auditoría de MCPs
+
+> Mantener < 10 MCPs activos, < 80 herramientas totales.
+> Cada MCP agrega overhead a cada request.
+
+## Señales de Contexto Degradado
+
+- El agente se repite o olvida contexto previo
+- Respuestas genéricas sin conocimiento del proyecto
+- Tool calls que fallan por razones que antes funcionaban
+- "¿Me puedes repetir qué estamos haciendo?"
+
+### Solución
+
+1. Compactar manualmente
+2. Si persiste → sesión nueva con `/especdev:traspasar`
+3. Si es recurrente → reducir system prompt, desactivar MCPs
+
+## Integración con Don Cheli
+
+```yaml
+# .especdev/config.yaml
+contexto:
+  umbral_compactar: 70       # % para auto-compactar
+  umbral_zona_muda: 90       # % para forzar sesión nueva
+  max_mcps_activos: 10
+  max_herramientas: 80
+  subagentes_para_output_pesado: true
+```

package/scripts/.claude/don-cheli/habilidades/orquestacion-autonoma/HABILIDAD.md

@@ -0,0 +1,124 @@
+# Habilidad: Orquestación Autónoma (Máquina de Estados)
+
+**Versión:** 1.0.0
+**Categoría:** Automatización
+**Tipo:** Flexible
+
+> Adaptado de OpenAI Symphony — máquina de estados para ejecución autónoma.
+
+## Cómo Mejora el Framework
+
+El bucle autónomo (`/bucle`) actual ejecuta tareas secuencialmente sin un modelo formal de estados. Symphony introduce una máquina de estados que permite:
+
+- Reintentos automáticos con backoff exponencial
+- Reconciliación (detectar tareas obsoletas)
+- Concurrencia controlada
+- Recuperación después de fallos
+
+## Estados de Orquestación
+
+```
+                    ┌──────────────┐
+                    │  Sin Reclamar │
+                    └──────┬───────┘
+                           │ dispatch
+                           ▼
+                    ┌──────────────┐
+                    │   Reclamada   │
+                    └──────┬───────┘
+                           │ workspace listo
+                           ▼
+┌───────────┐      ┌──────────────┐      ┌───────────────┐
+│  Reintento │◄─────│  Ejecutando   │─────►│   Completada   │
+│  Pendiente │      └──────────────┘      └───────────────┘
+└─────┬─────┘              │
+      │ timer              │ fallo / timeout
+      │                    ▼
+      │              ┌──────────────┐
+      └─────────────►│   Fallada     │
+                     └──────┬───────┘
+                            │ max reintentos
+                            ▼
+                     ┌──────────────┐
+                     │   Liberada    │
+                     └──────────────┘
+```
+
+## Fases de un Intento
+
+| Fase | Qué Sucede |
+|------|-----------|
+| `PreparandoWorkspace` | Crear/reusar directorio aislado |
+| `ConstruyendoPrompt` | Renderizar template con contexto |
+| `LanzandoAgente` | Iniciar sesión del agente |
+| `EjecutandoTareas` | Agente trabaja en las tareas |
+| `Verificando` | Ejecutar stop hooks |
+| `Exitoso` | Todo pasó |
+| `Fallido` | Algo falló → reintento |
+| `Timeout` | Excedió tiempo → reintento |
+| `Detenido` | Reconciliación detectó cambio de estado |
+
+## Reintentos con Backoff Exponencial
+
+```
+Intento 1: falla → esperar 10s
+Intento 2: falla → esperar 20s
+Intento 3: falla → esperar 40s
+Intento 4: falla → esperar 80s
+...hasta max_backoff (5 min por default)
+```
+
+### Reintentos de Continuación
+
+Cuando una tarea termina normalmente pero el issue sigue activo:
+- Reintento después de 1 segundo
+- Re-verificar si la tarea sigue siendo candidata
+- Si sí → nueva sesión de agente
+- Si no → liberar
+
+## Workspace Aislado por Tarea
+
+```
+.especdev/workspaces/
+├── PROJ-42/              # Workspace para issue PROJ-42
+│   ├── repo/             # Copia/clone del código
+│   ├── logs/             # Logs de la sesión
+│   └── metrics.json      # Métricas de la sesión
+├── PROJ-43/              # Otro workspace aislado
+└── ...
+```
+
+### Invariantes de Seguridad
+
+1. **Agente solo opera dentro de su workspace** — nunca fuera
+2. **Workspace siempre dentro de workspace root** — prevenir path traversal
+3. **Nombres sanitizados** — solo `[A-Za-z0-9._-]` en nombres de directorio
+
+## Hooks de Ciclo de Vida
+
+| Hook | Cuándo | Si Falla |
+|------|--------|----------|
+| `despues_crear` | Workspace recién creado | Fatal (no se crea) |
+| `antes_ejecutar` | Antes de cada ejecución | Fatal (intento falla) |
+| `despues_ejecutar` | Después de cada ejecución | Log y continuar |
+| `antes_eliminar` | Antes de limpiar workspace | Log y continuar |
+
+## Integración con WORKFLOW.md
+
+```yaml
+# WORKFLOW.md front matter
+agente:
+  max_turnos: 15
+  max_reintentos: 3
+  timeout_sesion_ms: 1800000
+concurrencia:
+  max_agentes: 3
+```
+
+## Cuándo Usar
+
+| Situación | Comando |
+|-----------|---------|
+| Una tarea a la vez, manual | `/especdev:implementar` |
+| Pipeline completo, un cambio | `/especdev:aplicar` |
+| Múltiples issues del tracker, autónomo | **Orquestación** |

package/scripts/.claude/don-cheli/habilidades/permisos-seguridad/HABILIDAD.md

@@ -0,0 +1,67 @@
+# Habilidad: Sistema de Permisos y Seguridad
+
+**Versión:** 1.0.0
+**Categoría:** Seguridad
+**Tipo:** Rígida
+
+> Inspirado en el componente Permissions de Gentle-AI.
+
+## Cómo Mejora el Framework
+
+Los agentes de IA acceden a archivos, ejecutan comandos y modifican configuraciones. Sin permisos explícitos, pueden:
+- Leer `.env` y exponer secrets
+- Ejecutar `git push --force` sin confirmación
+- Borrar archivos o directorios por error
+- Instalar dependencias no deseadas
+
+## Permisos por Defecto (Security-First)
+
+### 🔒 DENEGADO (nunca sin confirmación explícita)
+
+| Acción | Razón |
+|--------|-------|
+| Leer `.env`, `.env.*`, secrets | Proteger credenciales |
+| `git push --force` | Prevenir pérdida de historial |
+| `git reset --hard` | Prevenir pérdida de cambios |
+| `rm -rf` en directorios | Prevenir borrado accidental |
+| Instalar dependencias globales | Prevenir contaminación del sistema |
+| Modificar archivos fuera del proyecto | Prevenir efectos laterales |
+
+### ⚠️ CONFIRMACIÓN REQUERIDA
+
+| Acción | Razón |
+|--------|-------|
+| `git push` a main/master/production | Ramas protegidas |
+| Eliminar archivos >5 archivos | Borrado masivo |
+| Cambiar configuración de CI/CD | Infraestructura crítica |
+| Agregar dependencia nueva | Evaluar necesidad |
+
+### ✅ PERMITIDO
+
+| Acción | Razón |
+|--------|-------|
+| Leer/escribir archivos del proyecto | Trabajo normal |
+| Ejecutar tests | Operación segura |
+| `git add`, `git commit` | Operaciones locales |
+| Crear archivos y directorios | Trabajo normal |
+| Ejecutar linter | Operación segura |
+
+## Configuración
+
+```yaml
+# .especdev/config.yaml
+permisos:
+  archivos_bloqueados:
+    - ".env"
+    - ".env.*"
+    - "*.pem"
+    - "*.key"
+  comandos_confirmacion:
+    - "git push"
+    - "rm -rf"
+    - "npm publish"
+  directorios_protegidos:
+    - "/"
+    - "/usr"
+    - "/etc"
+```

package/scripts/.claude/don-cheli/habilidades/persona/HABILIDAD.md

@@ -0,0 +1,57 @@
+# Habilidad: Persona del Agente
+
+**Versión:** 1.0.0
+**Categoría:** Configuración
+**Tipo:** Flexible
+
+> Inspirado en el sistema de Personas de Gentle-AI.
+
+## Cómo Mejora el Framework
+
+Un agente de IA sin persona es un chatbot genérico. Con persona:
+- **Enseña** en vez de solo completar código
+- **Desafía** malas prácticas con el POR QUÉ
+- **Consistente** en tono y estilo
+
+## Personas Disponibles
+
+### 🎓 Maestro (Default)
+
+```markdown
+Eres un Senior Architect mentor que enseña mientras construye.
+- Explica el POR QUÉ detrás de cada decisión
+- Desafía malas prácticas con justificación técnica
+- Usa analogías para conceptos complejos
+- Si el usuario pide algo anti-patrón, primero explica la alternativa
+- Idioma: Español
+```
+
+### 🔧 Profesional
+
+```markdown
+Eres un desarrollador senior profesional y directo.
+- Sin personalidad, solo hechos y código
+- Conciso y técnico
+- No explica a menos que se pida
+```
+
+### 🎨 Personalizado
+
+El usuario define su propia persona en `.especdev/persona.md`:
+
+```markdown
+# Mi Persona Personalizada
+
+Eres un desarrollador que:
+- Habla con humor y referencias a la cultura pop
+- Usa emojis para indicar estado
+- Explica con metáforas de cocina
+```
+
+## Configuración
+
+```yaml
+# .especdev/config.yaml
+persona: "maestro"  # maestro | profesional | personalizado
+# Si es personalizado, leer de .especdev/persona.md
+```

package/scripts/.claude/don-cheli/habilidades/presentaciones/HABILIDAD.md

@@ -0,0 +1,54 @@
+# Habilidad: Presentaciones Interactivas (HTML Slides)
+
+**Versión:** 1.0.0
+**Categoría:** Documentación
+**Tipo:** Flexible
+
+> Adaptado de frontend-slides (zarazhangrui/frontend-slides) — Generación de presentaciones HTML sin dependencias.
+
+## Cómo Mejora el Framework
+
+Permite generar presentaciones interactivas de proyectos, demos, pitches y documentación técnica como archivos HTML autocontenidos — sin PowerPoint, sin Figma, sin dependencias externas.
+
+## Uso
+
+```
+/especdev:presentar <tema o archivo>
+/especdev:presentar --tema "bold-signal"     # Elegir tema visual
+/especdev:presentar --desde pptx input.pptx  # Convertir desde PowerPoint
+```
+
+## Tecnología
+
+- HTML5/CSS3/JavaScript puro (sin frameworks)
+- Un solo archivo `.html` autocontenido
+- Navegación por teclado, mouse y touch
+- Animaciones con Intersection Observer
+- Responsive con `clamp()` para todos los tamaños
+- 12 temas de diseño disponibles
+
+## Temas Disponibles
+
+| Tema | Estilo | Ideal para |
+|------|--------|-----------|
+| **bold-signal** | Dark, alto contraste, acentos vibrantes | Demos técnicas |
+| **electric-studio** | Dark, profesional, minimalista | Pitches |
+| **neon-cyber** | Dark, futurista, cyan/magenta | Devtools |
+| **terminal-green** | Dark, hacker, monospace | Conferencias dev |
+| **notebook-tabs** | Light, editorial, tabs de color | Workshops |
+| **pastel-geometry** | Light, amigable, redondeado | Onboarding |
+| **swiss-modern** | Bauhaus, geométrico, precisión | Arquitectura |
+
+## Output
+
+Archivo HTML autocontenido con:
+- Slides de 100vh (una pantalla por slide)
+- Navegación: flechas, espacio, scroll, swipe
+- Barra de progreso
+- Animaciones de entrada
+
+## Guardrails
+
+- Cada slide debe caber en 100vh (sin scroll interno)
+- Imágenes con max-height relativo al viewport
+- Máximo ~15 slides para mantener engagement

package/scripts/.claude/don-cheli/habilidades/prueba-trabajo/HABILIDAD.md

@@ -0,0 +1,122 @@
+# Habilidad: Prueba de Trabajo (Proof of Work)
+
+**Versión:** 1.0.0
+**Categoría:** Verificación
+**Tipo:** Rígida
+
+> Adaptado de OpenAI Symphony — evidencia verificable de que el trabajo fue completado correctamente.
+
+## Cómo Mejora el Framework
+
+Sin prueba de trabajo, el equipo debe revisar TODO el código manualmente para verificar que funciona. Con prueba de trabajo, el agente **demuestra** que su implementación es correcta con evidencia verificable.
+
+## Componentes de la Prueba de Trabajo
+
+### 1. Estado de CI ✅
+
+```markdown
+## CI Status
+- Lint: ✅ PASS (0.8s)
+- Type Check: ✅ PASS (2.1s)
+- Unit Tests: ✅ PASS (47/47, 3.2s)
+- Integration Tests: ✅ PASS (12/12, 8.5s)
+- Build: ✅ PASS (5.1s)
+- Coverage: 87% (umbral: 85%) ✅
+```
+
+### 2. Análisis de Complejidad 📊
+
+```markdown
+## Análisis de Complejidad
+- Archivos modificados: 8
+- Líneas agregadas: 234
+- Líneas eliminadas: 45
+- Complejidad ciclomática promedio: 3.2 (bajo)
+- Archivo más complejo: auth_service.py (cc: 7)
+- Dependencias nuevas: 1 (python-jose)
+- Riesgo de regresión: BAJO
+```
+
+### 3. Revisión de PR 📋
+
+```markdown
+## Checklist de PR
+- [x] Specs seguidas: auth-oauth.delta.md
+- [x] Tests unitarios para lógica nueva
+- [x] Tests de integración para endpoints
+- [x] No hay TODO/FIXME sin resolver
+- [x] Documentación actualizada
+- [x] No hay secrets en el código
+- [x] Backward compatible
+```
+
+### 4. Video Walkthrough 🎥 (Opcional)
+
+Grabación del agente ejecutando los tests y mostrando que la funcionalidad opera correctamente. Especialmente útil para cambios de UI.
+
+### 5. Contabilidad de Tokens 💰
+
+```markdown
+## Consumo de Recursos
+- Tokens input: 45,230
+- Tokens output: 12,890
+- Tokens total: 58,120
+- Sesiones: 2
+- Tiempo total: 7m 23s
+- Reintentos: 0
+- Costo estimado: $0.14
+```
+
+## Output Completo
+
+Cada PR o tarea completada incluye un archivo `prueba-trabajo.md`:
+
+```markdown
+# Prueba de Trabajo: PROJ-42 — Agregar OAuth
+
+## Resumen
+Feature implementada según spec auth-oauth.delta.md.
+3 endpoints nuevos, 12 tests, 0 bugs.
+
+## CI Status
+✅ Lint | ✅ Types | ✅ Tests (47/47) | ✅ Build | ✅ Coverage (87%)
+
+## Complejidad
+8 archivos | +234 -45 líneas | CC promedio: 3.2 | Riesgo: BAJO
+
+## Trazabilidad
+| Escenario Gherkin | Test | Estado |
+|-------------------|------|--------|
+| Login Google exitoso | test_google_login_success | ✅ |
+| Tarjeta rechazada | test_card_declined | ✅ |
+| Vincular OAuth a existente | test_link_oauth | ✅ |
+
+## Tokens
+58,120 tokens | 2 sesiones | 7m 23s | ~$0.14
+
+## Aprobación
+Estado: LISTO PARA REVISIÓN HUMANA
+Solicitante: Don Cheli Agent
+Fecha: 2026-03-21T16:30:00-05:00
+```
+
+## Integración con Pipeline
+
+```
+implementar → stop hooks → generar prueba-trabajo.md
+    → crear PR con prueba adjunta
+    → solicitar revisión humana
+    → si aprobada → archivar
+```
+
+## Configuración
+
+```yaml
+# WORKFLOW.md
+prueba_trabajo:
+  ci_status: true          # Siempre
+  complejidad: true         # Siempre
+  trazabilidad: true        # Siempre
+  walkthrough_video: false  # Opcional
+  tokens: true              # Siempre
+```

package/scripts/.claude/don-cheli/habilidades/razonamiento/HABILIDAD.md

@@ -0,0 +1,60 @@
+# Habilidad: Razonamiento (15 modelos + RLM)
+
+**Versión:** 1.0.0
+**Categoría:** Decisiones
+**Tipo:** Flexible
+
+## Modelos Disponibles
+
+### Modelos de Análisis (Entender)
+| # | Modelo | Comando | Uso |
+|---|--------|---------|-----|
+| 1 | Primeros Principios | `/razonar:primeros-principios` | Innovación |
+| 2 | 5 Porqués | `/razonar:5-porques` | Causa raíz |
+| 3 | Mapa vs Territorio | `/razonar:mapa-territorio` | Validar suposiciones |
+
+### Modelos de Decisión (Elegir)
+| # | Modelo | Comando | Uso |
+|---|--------|---------|-----|
+| 4 | Pareto | `/razonar:pareto` | Priorización |
+| 5 | Costo de Oportunidad | `/razonar:costo-oportunidad` | Trade-offs |
+| 6 | Reversibilidad | `/razonar:reversibilidad` | Compromiso |
+| 7 | Minimizar Arrepentimiento | `/razonar:minimizar-arrepentimiento` | Largo plazo |
+| 8 | Probabilístico | `/razonar:probabilistico` | Incertidumbre |
+
+### Modelos de Perspectiva (Pensar)
+| # | Modelo | Comando | Uso |
+|---|--------|---------|-----|
+| 9 | Inversión | `/razonar:inversion` | Pensar al revés |
+| 10 | Segundo Orden | `/razonar:segundo-orden` | Pensar adelante |
+| 11 | Pre-Mortem | `/razonar:pre-mortem` | Pensar fracaso |
+| 12 | Círculo de Competencia | `/razonar:circulo-competencia` | Pensar límites |
+
+### 🧠 Modelos RLM (Modelo de Lenguaje Recursivo — PrimeIntellect)
+| # | Modelo | Comando | Uso |
+|---|--------|---------|-----|
+| 13 | Verificación con Sub-LLMs | `/razonar:rlm-verificacion` | Verificar código contra specs |
+| 14 | Cadena + Context Folding | `/razonar:rlm-cadena-pensamiento` | Razonamiento multi-paso sin context rot |
+| 15 | Descomposición Recursiva | `/razonar:rlm-descomposicion` | Inputs masivos, codebases grandes |
+
+## Árbol de Decisión
+
+```
+¿Qué tipo de problema tengo?
+├── No entiendo el problema → Análisis
+│   ├── Suposiciones → primeros-principios
+│   ├── Bug/Error → 5-porques
+│   └── Datos confusos → mapa-territorio
+├── Necesito elegir → Decisión
+│   ├── Qué priorizar → pareto
+│   ├── Qué compromiso → reversibilidad / probabilístico
+│   └── Largo plazo → minimizar-arrepentimiento
+├── Necesito perspectiva → Perspectiva
+│   ├── Evitar fracaso → pre-mortem / inversión
+│   ├── Ver más allá → segundo-orden
+│   └── ¿Sé lo suficiente? → circulo-competencia
+└── Necesito manejar contexto largo / input masivo → RLM
+    ├── Verificar contra specs → rlm-verificacion
+    ├── Razonamiento multi-paso → rlm-cadena-pensamiento
+    └── Codebase grande / datos masivos → rlm-descomposicion
+```

package/scripts/.claude/don-cheli/habilidades/recuperacion-sesion/HABILIDAD.md

@@ -0,0 +1,18 @@
+# Habilidad: Recuperación de Sesión
+
+**Versión:** 1.0.0
+**Categoría:** Fundamental
+
+## Propósito
+
+Recuperar contexto completo tras reset de sesión usando los archivos persistentes.
+
+## Test de 5 Preguntas
+
+| # | Pregunta | Fuente |
+|---|----------|--------|
+| 1 | ¿Dónde estoy? | estado.md |
+| 2 | ¿A dónde voy? | plan.md |
+| 3 | ¿Cuál es la meta? | config.yaml |
+| 4 | ¿Qué he aprendido? | hallazgos.md |
+| 5 | ¿Qué he hecho? | progreso.md |