don-cheli-sdd 1.19.0 → 1.20.0

package/CHANGELOG.md

@@ -4,6 +4,24 @@ Todos los cambios notables en Don Cheli SDD Framework.
 
 Formato basado en [Conventional Commits](https://www.conventionalcommits.org/).
 
+## [1.20.0](https://github.com/doncheli/don-cheli-sdd/compare/v1.19.1...v1.20.0) (2026-04-06)
+
+### Nuevas Funcionalidades
+
+* Killer Features — Drift Detection, Time Travel y Pre-Flight ([0450130](https://github.com/doncheli/don-cheli-sdd/commit/0450130830dc7c9307e8539f2e2fab373e61b6cb))
+
+### Documentación
+
+* agregar regla protocolo-debugging ([dfe3d24](https://github.com/doncheli/don-cheli-sdd/commit/dfe3d243718258308235b45ac67c808cf3498845))
+* documentar convención de idioma por capa de definición de skills ([5bba3e5](https://github.com/doncheli/don-cheli-sdd/commit/5bba3e5b867a65c90f380d47c78c032ec5287d9c))
+* optimizar descripciones de comandos /dc:* para mejorar triggering ([7912187](https://github.com/doncheli/don-cheli-sdd/commit/7912187edb9994a42aaa5d2d974f23c9d4d418fc))
+
+## [1.19.1](https://github.com/doncheli/don-cheli-sdd/compare/v1.19.0...v1.19.1) (2026-04-03)
+
+### Correcciones
+
+* **opencode:** agregar generación de config para skills.paths ([8583f98](https://github.com/doncheli/don-cheli-sdd/commit/8583f983904ebe19cc4348ef7b8a364d4507ea7e))
+
 ## [1.19.0](https://github.com/doncheli/don-cheli-sdd/compare/v1.18.0...v1.19.0) (2026-04-02)
 
 ### Nuevas Funcionalidades

package/README.es.md

@@ -12,7 +12,7 @@
   </p>
   <p align="center">
     <a href="#-instalación"><img src="https://img.shields.io/badge/instalación-2_minutos-brightgreen" alt="Install"></a>
-    <img src="https://img.shields.io/badge/versión-1.19.0-blue" alt="Version">
+    <img src="https://img.shields.io/badge/versión-1.20.0-blue" alt="Version">
     <img src="https://img.shields.io/badge/licencia-Apache%202.0-green" alt="License">
     <img src="https://img.shields.io/badge/idiomas-ES%20|%20EN%20|%20PT-red" alt="Languages">
     <img src="https://img.shields.io/badge/comandos-85+-purple" alt="Commands">
@@ -251,6 +251,9 @@ No negociables. Se aplican siempre. Sin excepciones.
 <tr><td>Custom Quality Gates (plugins)</td><td>—</td><td>—</td><td>—</td><td><strong>✅</strong></td></tr>
 <tr><td>Dashboard de telemetría</td><td>—</td><td>—</td><td>—</td><td><strong>✅</strong></td></tr>
 <tr><td>Extensión VS Code</td><td>—</td><td>—</td><td>—</td><td><strong>✅</strong></td></tr>
+<tr><td>Drift Detection (vigilante async)</td><td>—</td><td>—</td><td>—</td><td><strong>✅</strong></td></tr>
+<tr><td>Time Travel del Razonamiento</td><td>—</td><td>—</td><td>—</td><td><strong>✅</strong></td></tr>
+<tr><td>Simulación Pre-Flight de Costos</td><td>—</td><td>—</td><td>—</td><td><strong>✅</strong></td></tr>
 </table>
 
 <details>
@@ -362,6 +365,69 @@ Top 20 más usados. [Lista completa en la documentación web →](https://donche
 
 ---
 
+## Killer Features
+
+### Drift Detection — Vigilante de Arquitectura
+
+Detecta cuando el codigo diverge de las especificaciones. Si el codigo cambia pero las specs no, recibes una alerta inmediata:
+
+```
+⚠️ DRIFT ALERT: Arquitectura Comprometida
+  Archivo modificado:  src/services/auth.ts (línea 45-67)
+  Spec afectada:       specs/auth/login.feature:23
+  Escenario:           "Login con MFA por TOTP"
+  Drift:               Lógica de MFA eliminada, spec sigue requiriéndola
+  Severidad:           🔴 CRÍTICO
+```
+
+```bash
+/dc:drift                    # Escaneo completo del proyecto
+/dc:drift --vigilante        # Activar vigilante asíncrono
+```
+
+### Time Travel — Debugger de Razonamiento
+
+Ve **por que** el framework eligio cada modelo, skill y decision. Navega el historial de razonamiento como una linea de tiempo:
+
+```
+10:15 ─── /dc:comenzar ──────────────────
+│  D001: Nivel detectado → 2 (Estándar)
+│  Modelo: sonnet (confianza: 85%)
+│  Descartados: N1 (>3 archivos), N3 (1 módulo)
+│
+10:22 ─── /dc:especificar ────────────────
+│  D003: Razonamiento → /razonar:pre-mortem
+│  Razón: Feature de pagos (alto riesgo)
+│  Modelo: sonnet → opus (escalado por complejidad)
+```
+
+```bash
+/dc:time-travel              # Línea de tiempo completa
+/dc:time-travel --ajustar    # Ajustar thresholds de modelos dinámicamente
+```
+
+### Pre-Flight — Simulador de Costos
+
+Sabe **exactamente** cuanto costara una fase ANTES de ejecutarla:
+
+```
+┌──────────────────────────────────────────────────┐
+│  Fase            │ Tokens   │ Modelo  │ Costo    │
+├──────────────────┼──────────┼─────────┼──────────┤
+│  Implementar     │ ~45,000  │ sonnet  │ $0.27    │
+│  Revisar         │ ~18,000  │ opus    │ $0.54    │
+│  TOTAL           │ ~63,000  │ mixed   │ $0.81    │
+└──────────────────┴──────────┴─────────┴──────────┘
+✅ Dentro del presupuesto ($0.81 < $5.00)
+```
+
+```bash
+/dc:preflight                    # Estimar fases pendientes
+/dc:preflight --presupuesto 5.00 # Alertar si excede $5
+```
+
+---
+
 ## Multi-plataforma
 
 Don Cheli no es un programa. Son archivos Markdown que cualquier agente de IA puede interpretar.

package/README.md

@@ -12,7 +12,7 @@
   </p>
   <p align="center">
     <a href="#-installation"><img src="https://img.shields.io/badge/install-2_minutes-brightgreen" alt="Install"></a>
-    <img src="https://img.shields.io/badge/version-1.19.0-blue" alt="Version">
+    <img src="https://img.shields.io/badge/version-1.20.0-blue" alt="Version">
     <img src="https://img.shields.io/badge/license-Apache%202.0-green" alt="License">
     <img src="https://img.shields.io/badge/languages-ES%20|%20EN%20|%20PT-red" alt="Languages">
     <img src="https://img.shields.io/badge/commands-85+-purple" alt="Commands">
@@ -251,6 +251,9 @@ Non-negotiable. Always enforced. No exceptions.
 <tr><td>Custom Quality Gates (plugins)</td><td>—</td><td>—</td><td>—</td><td><strong>✅</strong></td></tr>
 <tr><td>Telemetry Dashboard</td><td>—</td><td>—</td><td>—</td><td><strong>✅</strong></td></tr>
 <tr><td>VS Code Extension</td><td>—</td><td>—</td><td>—</td><td><strong>✅</strong></td></tr>
+<tr><td>Drift Detection (async watcher)</td><td>—</td><td>—</td><td>—</td><td><strong>✅</strong></td></tr>
+<tr><td>Reasoning Time Travel</td><td>—</td><td>—</td><td>—</td><td><strong>✅</strong></td></tr>
+<tr><td>Pre-Flight Cost Simulation</td><td>—</td><td>—</td><td>—</td><td><strong>✅</strong></td></tr>
 </table>
 
 <details>
@@ -362,6 +365,69 @@ Top 20 most used. [Full list in the web docs →](https://doncheli.tv/comousar.h
 
 ---
 
+## Killer Features
+
+### Drift Detection — Architecture Watchdog
+
+Detects when code diverges from specifications. If code changes but specs don't, you get an immediate alert:
+
+```
+⚠️ DRIFT ALERT: Architecture Compromised
+  File changed:   src/services/auth.ts (line 45-67)
+  Spec affected:  specs/auth/login.feature:23
+  Scenario:       "Login with MFA via TOTP"
+  Drift:          MFA logic removed, spec still requires it
+  Severity:       🔴 CRITICAL
+```
+
+```bash
+/dc:drift                    # Full project scan
+/dc:drift --watch            # Activate async watcher
+```
+
+### Time Travel — Reasoning Debugger
+
+See **why** the framework chose each model, skill and decision. Navigate the reasoning history like a timeline:
+
+```
+10:15 ─── /dc:start ──────────────────
+│  D001: Level detected → 2 (Standard)
+│  Model: sonnet (confidence: 85%)
+│  Discarded: N1 (>3 files), N3 (1 module)
+│
+10:22 ─── /dc:specify ────────────────
+│  D003: Reasoning → /razonar:pre-mortem
+│  Reason: Payment feature (high risk)
+│  Model: sonnet → opus (escalated by complexity)
+```
+
+```bash
+/dc:time-travel              # Full session timeline
+/dc:time-travel --adjust     # Tune model thresholds dynamically
+```
+
+### Pre-Flight — Cost Simulator
+
+Know **exactly** how much a phase will cost BEFORE executing:
+
+```
+┌──────────────────────────────────────────────────┐
+│  Fase            │ Tokens   │ Model   │ Cost     │
+├──────────────────┼──────────┼─────────┼──────────┤
+│  Implement       │ ~45,000  │ sonnet  │ $0.27    │
+│  Review          │ ~18,000  │ opus    │ $0.54    │
+│  TOTAL           │ ~63,000  │ mixed   │ $0.81    │
+└──────────────────┴──────────┴─────────┴──────────┘
+✅ Within budget ($0.81 < $5.00)
+```
+
+```bash
+/dc:preflight                # Estimate pending phases
+/dc:preflight --budget 5.00  # Alert if exceeds $5
+```
+
+---
+
 ## Multi-platform
 
 Don Cheli is not a program. It's Markdown files that any AI agent can interpret.

package/README.pt.md

@@ -12,7 +12,7 @@
   </p>
   <p align="center">
     <a href="#-instalação"><img src="https://img.shields.io/badge/instalação-2_minutos-brightgreen" alt="Install"></a>
-    <img src="https://img.shields.io/badge/versão-1.19.0-blue" alt="Version">
+    <img src="https://img.shields.io/badge/versão-1.20.0-blue" alt="Version">
     <img src="https://img.shields.io/badge/licença-Apache%202.0-green" alt="License">
     <img src="https://img.shields.io/badge/idiomas-ES%20|%20EN%20|%20PT-red" alt="Languages">
     <img src="https://img.shields.io/badge/comandos-85+-purple" alt="Commands">
@@ -250,6 +250,9 @@ Não negociáveis. Sempre aplicadas. Sem exceções.
 <tr><td>Custom Quality Gates (plugins)</td><td>—</td><td>—</td><td>—</td><td><strong>✅</strong></td></tr>
 <tr><td>Dashboard de telemetria</td><td>—</td><td>—</td><td>—</td><td><strong>✅</strong></td></tr>
 <tr><td>Extensao VS Code</td><td>—</td><td>—</td><td>—</td><td><strong>✅</strong></td></tr>
+<tr><td>Drift Detection (vigilante async)</td><td>—</td><td>—</td><td>—</td><td><strong>✅</strong></td></tr>
+<tr><td>Time Travel do Raciocinio</td><td>—</td><td>—</td><td>—</td><td><strong>✅</strong></td></tr>
+<tr><td>Simulacao Pre-Flight de Custos</td><td>—</td><td>—</td><td>—</td><td><strong>✅</strong></td></tr>
 </table>
 
 <details>
@@ -361,6 +364,69 @@ Top 20 mais usados. [Lista completa na documentação web →](https://doncheli.
 
 ---
 
+## Killer Features
+
+### Drift Detection — Vigilante de Arquitetura
+
+Detecta quando o codigo diverge das especificacoes. Se o codigo muda mas as specs nao, voce recebe um alerta imediato:
+
+```
+⚠️ DRIFT ALERT: Arquitetura Comprometida
+  Arquivo modificado:  src/services/auth.ts (linha 45-67)
+  Spec afetada:        specs/auth/login.feature:23
+  Cenario:             "Login com MFA via TOTP"
+  Drift:               Logica de MFA removida, spec ainda requer
+  Severidade:          🔴 CRITICO
+```
+
+```bash
+/dc:drift                    # Varredura completa do projeto
+/dc:drift --vigilante        # Ativar vigilante assincrono
+```
+
+### Time Travel — Debugger de Raciocinio
+
+Veja **por que** o framework escolheu cada modelo, skill e decisao. Navegue o historico de raciocinio como uma linha do tempo:
+
+```
+10:15 ─── /dc:começar ──────────────────
+│  D001: Nivel detectado → 2 (Padrao)
+│  Modelo: sonnet (confianca: 85%)
+│  Descartados: N1 (>3 arquivos), N3 (1 modulo)
+│
+10:22 ─── /dc:especificar ────────────────
+│  D003: Raciocinio → /razonar:pre-mortem
+│  Razao: Feature de pagamentos (alto risco)
+│  Modelo: sonnet → opus (escalado por complexidade)
+```
+
+```bash
+/dc:time-travel              # Linha do tempo completa
+/dc:time-travel --ajustar    # Ajustar thresholds de modelos dinamicamente
+```
+
+### Pre-Flight — Simulador de Custos
+
+Saiba **exatamente** quanto custara uma fase ANTES de executar:
+
+```
+┌──────────────────────────────────────────────────┐
+│  Fase            │ Tokens   │ Modelo  │ Custo    │
+├──────────────────┼──────────┼─────────┼──────────┤
+│  Implementar     │ ~45,000  │ sonnet  │ $0.27    │
+│  Revisar         │ ~18,000  │ opus    │ $0.54    │
+│  TOTAL           │ ~63,000  │ mixed   │ $0.81    │
+└──────────────────┴──────────┴─────────┴──────────┘
+✅ Dentro do orcamento ($0.81 < $5.00)
+```
+
+```bash
+/dc:preflight                    # Estimar fases pendentes
+/dc:preflight --orcamento 5.00   # Alertar se exceder $5
+```
+
+---
+
 ## Multi-plataforma
 
 Don Cheli não é um programa. São arquivos Markdown que qualquer agente de IA pode interpretar.

package/VERSION

@@ -1 +1 @@
-1.19.0
+1.20.0

package/comandos/especdev/actualizar.md

@@ -1,5 +1,5 @@
 ---
-description: Detectar actualizaciones del framework Don Cheli y aplicarlas
+description: Detectar y aplicar actualizaciones del framework Don Cheli. Usa cuando el usuario dice "actualizar Don Cheli", "update framework", "nueva versión", "upgrade". Aplica updates con auditoría de seguridad sobre archivos cambiados. POST-INVOCATION: solo se invoca manualmente.
 i18n: true
 ---
 
@@ -18,26 +18,6 @@ Verificar si hay actualizaciones disponibles en el repositorio de Don Cheli y of
 /dc:actualizar --auto         # Auto-actualizar con auditoría de seguridad (usado por auto-check de sesión)
 ```
 
-## Script ejecutable
-
-Para ejecutar directamente desde terminal (sin agente IA):
-
-```bash
-bash scripts/actualizar.sh              # Interactivo con barra de progreso
-bash scripts/actualizar.sh --verificar  # Solo verificar
-don-cheli update                        # Via CLI npm
-don-cheli update --check                # Solo verificar via npm
-```
-
-El script incluye:
-- Barra de progreso visual con porcentaje
-- Comparación de versiones (local vs remota)
-- Reporte de commits por tipo (feat/fix/refactor/docs)
-- Tabla de componentes (comandos, habilidades) con delta
-- Lista de nuevas funcionalidades y correcciones
-- Auditoría de seguridad pre-actualización
-- Preservación de perfil e idioma al actualizar
-
 ## Proceso
 
 ### 1. Detectar instalación

package/comandos/especdev/agente.md

@@ -1,5 +1,5 @@
 ---
-description: Cargar un agente especializado para una tarea específica
+description: Cargar un agente especializado para una tarea específica. Usa cuando el usuario dice "cargar agente", "usar agente", "specialist agent", "spawn agent", "subagent", "agente especializado", "run agent", "delegar a agente". Detecta el tipo de agente necesario (Explore, Plan, general-purpose) y spawnea el subagent apropiado.
 i18n: true
 ---
 

package/comandos/especdev/analizar-sesiones.md

@@ -1,5 +1,5 @@
 ---
-description: Analizar sesiones de Claude en el equipo para extraer patrones de uso y generar recomendaciones de habilidades, plugins, agentes y reglas
+description: Analizar sesiones de Claude en el equipo para extraer patrones de uso y generar recomendaciones. Usa cuando el usuario dice "analizar sesiones", "session analysis", "patrones de uso", "usage patterns", "recommendations", "analizar cómo uso Claude". Extrae patterns y genera recomendaciones de skills, plugins, agentes y rules.
 i18n: true
 ---
 

package/comandos/especdev/aplicar.md

@@ -1,5 +1,5 @@
 ---
-description: Aplicar (implementar) tareas de un cambio específico
+description: Aplicar (implementar) tareas de un cambio o feature específica. Usa cuando el usuario dice "aplicar cambio", "implement this change", "aplicar feature", "apply feature", "ejecutar cambio", "apply diff". Toma un cambio ya planificado y lo implementa siguiendo el workflow TDD.
 i18n: true
 ---
 

package/comandos/especdev/archivar.md

@@ -1,5 +1,5 @@
 ---
-description: Archivar specs completadas y sincronizar delta specs con specs principales
+description: Archivar specs completadas y sincronizar delta specs con specs principales. Usa cuando el usuario dice "archivar specs", "archivar", "close completed specs", "spec archiving", "archive specs", "especificaciones completadas". Limpia specs cerradas y sincroniza delta specs con el main branch.
 i18n: true
 ---
 

package/comandos/especdev/audit-trail.md

@@ -1,5 +1,5 @@
 ---
-description: Generar y consultar el log de auditoría de decisiones asistidas por IA
+description: Generar y consultar el log de auditoría de decisiones asistidas por IA. Usa cuando el usuario dice "audit trail", "decision log", "log de decisiones", "AI decisions", "audit log", "追溯", "track decisions", "quien decidió qué", "decision history". Registra y consulta el log de decisiones tomadas durante la sesión.
 i18n: true
 ---
 

package/comandos/especdev/auditar-seguridad.md

@@ -1,5 +1,5 @@
 ---
-description: Auditoría de seguridad estática del código (OWASP Top 10, SecDevOps)
+description: Auditoría de seguridad estática OWASP Top 10 y SecDevOps. Usa cuando el usuario dice "security audit", "OWASP", "auditar seguridad", "vulnerability scan", "pentest", "seguridad del código", "security review", "CVEs", "inyección SQL", "XSS", "CSRF", "auditoría de seguridad", "seguridad antes de deploy". Detecta las 10 vulnerabilidades OWASP más críticas.
 i18n: true
 ---
 

package/comandos/especdev/auditar.md

@@ -1,5 +1,5 @@
 ---
-description: Auditar componentes del framework
+description: Auditar componentes del framework Don Cheli. Usa cuando el usuario dice "auditar framework", "framework audit", "audit Don Cheli", "componentes", "validar framework", "audit components". Verifica Conformidad de hooks, CI/CD, repo standards y detecta misconfiguraciones.
 i18n: true
 ---
 

package/comandos/especdev/avance-rapido.md

@@ -1,5 +1,5 @@
 ---
-description: Crear todos los artefactos de planificación de un golpe (fast-forward)
+description: Crear todos los artefactos de planificación de un golpe (fast-forward). Usa cuando el usuario dice "fast-forward", "avance rápido", "generar todo", "boilerplate", "generate all artifacts", "fast setup", "scaffold", "generar planning artifacts", "一次性", "generate everything". Genera specs, stories, tasks, estimates y docs desde un requerimiento en una sola pasada.
 i18n: true
 ---
 

package/comandos/especdev/capturar.md

@@ -1,5 +1,5 @@
 ---
-description: Capturar ideas y notas sin interrumpir el flujo de trabajo
+description: Capturar ideas y notas sin interrumpir el flujo de trabajo. Usa cuando el usuario dice "capturar idea", "quick note", "nota rápida", "grab this", "take a note", "guardar idea", "note to self", "capture thought", "I should remember", "guardar esto". Guarda en memoria persistente sin romper el contexto actual.
 i18n: true
 ---
 

package/comandos/especdev/cerrar-sesion.md

@@ -1,5 +1,5 @@
 ---
-description: Ritual de cierre de sesión con auditoría, calidad, aprendizajes y contexto para la próxima sesión
+description: Ritual de cierre de sesión con auditoría, calidad, aprendizajes y contexto para la próxima sesión. Usa cuando el usuario dice "cerrar sesión", "end session", "cierre", "session close", "ritual cierre", "wrap up", "end of day", "fin de sesión". Ejecuta auditoría, registra quality metrics, aprendizajes y guarda contexto para la próxima sesión.
 i18n: true
 ---
 

package/comandos/especdev/changelog-auto.md

@@ -1,5 +1,5 @@
 ---
-description: Auto-generar entradas de CHANGELOG.md desde commits convencionales
+description: Auto-generar entradas de CHANGELOG.md desde commits convencionales. Usa cuando el usuario dice "generar changelog", "update changelog", "changelog", "conventional commits", "auto changelog", "release notes", "generar release notes", "伽 changelog". Genera entradas desde conventional commits (feat, fix, docs, etc.) con agrupamiento por categoría.
 i18n: true
 ---
 

package/comandos/especdev/clarificar.md

@@ -1,5 +1,5 @@
 ---
-description: Detectar ambigüedades en una especificación, ejecutar Auto-QA y registrar respuestas
+description: Detectar ambigüedades en una especificación, ejecutar Auto-QA y registrar respuestas. Usa cuando el usuario dice "clarificar", "detectar ambigüedad", "ambigüedad en specs", "vague spec", "spec ambiguity", "aclarar requerimiento", "QA specs", "Auto-QA". Detecta gaps, contradictions y vagueness en specs y las registra para resolution.
 i18n: true
 ---
 

package/comandos/especdev/comenzar.md

@@ -1,5 +1,5 @@
 ---
-description: Iniciar tarea con nivel de complejidad auto-detectado (0-4)
+description: Iniciar tarea nueva SDD con complejidad auto-detectada (0-4). Usa cuando el usuario dice "quiero iniciar tarea", "empezar feature", "nueva historia", "comenzar desarrollo", "start a new task/feature/story", "iniciar un feature". Detecta si es tarea rápida (nivel 1), normal (nivel 2) o compleja (nivel 3-4) y adapta el flujo TDD. No usar para código existente.
 i18n: true
 ---
 

package/comandos/especdev/completo.md

@@ -1,5 +1,5 @@
 ---
-description: Modo completo para proyectos grandes y complejos (Nivel 3)
+description: Modo completo para proyectos grandes y complejos (Nivel 3). Usa cuando el usuario dice "modo completo", "proyecto grande", "complejo", "full mode", "large project", "complex feature", "level 3", "gran proyecto". Activa el workflow SDD completo con todas las fases: especificar → planificar → estimar → implementar → testear → revisar.
 i18n: true
 ---
 

package/comandos/especdev/context-health.md

@@ -1,5 +1,5 @@
 ---
-description: Dashboard de salud del contexto activo con predicción de degradación y recomendaciones de compactación
+description: Dashboard de salud del contexto activo con predicción de degradación y recomendaciones de compactación. Usa cuando el usuario dice "context health", "salud del contexto", "degradation", "compactar contexto", "context overflow", "tokens", "session health", "compact", "contexto lleno". Monitorea degrdación del contexto y recomienda compactación antes de overflow.
 i18n: true
 ---
 

package/comandos/especdev/continuar.md

@@ -1,5 +1,5 @@
 ---
-description: Recuperar sesión previa y generar reporte de puesta al día
+description: Recuperar sesión previa y generar reporte de puesta al día. Usa cuando el usuario dice "continuar", "resume session", "recuperar sesión", "continue working", "reanudar", "pick up where we left", "recuperar contexto", "resume". Lee el estado guardado, genera reporte de lo hecho y propone next steps.
 i18n: true
 ---
 

package/comandos/especdev/contrato-api.md

@@ -1,5 +1,5 @@
 ---
-description: Diseñar contratos de API, webhooks e integraciones con manejo de errores y reintentos
+description: Diseñar contratos de API, webhooks e integraciones con manejo de errores y reintentos. Usa cuando el usuario dice "contrato API", "API contract", "diseñar API", "webhook", "API design", "contrato de integración", "OpenAPI", "REST contract", "request/response spec". Define request/response schemas, error handling y retry policies.
 i18n: true
 ---
 

package/comandos/especdev/contrato-ui.md

@@ -1,5 +1,5 @@
 ---
-description: Bloquear estándares visuales antes de codear frontend (UI Design Contract)
+description: Bloquear estándares visuales antes de codear frontend (UI Design Contract). Usa cuando el usuario dice "UI contract", "diseño UI", "frontend standards", "visual contract", "CSS standards", "UI design", "design system", "componentes UI", "mockups", "wireframes", "bloquear UI antes de codear". Define spacing, colors, typography y component specs antes del desarrollo.
 i18n: true
 ---
 

package/comandos/especdev/crear-skill.md

@@ -1,5 +1,5 @@
 ---
-description: Crear, probar y mejorar habilidades (skills) de forma iterativa
+description: Crear, probar y mejorar skills de forma iterativa. Usa cuando el usuario dice "crear skill", "crear habilidad", "build skill", "create a skill", "skill development", "desarrollar skill", "nueva habilidad". Usa el workflow: draft → test → review → improve → repeat con evaluación cuantitativa y qualitative review.
 i18n: true
 ---
 

package/comandos/especdev/data-policy.md

@@ -1,5 +1,5 @@
 ---
-description: Documentar qué datos toca el framework, qué sale a APIs externas y generar política de privacidad del proyecto
+description: Documentar qué datos toca el framework, qué sale a APIs externas y generar política de privacidad. Usa cuando el usuario dice "data policy", "política de datos", "privacy policy", "datos sensibles", "GDPR", "data handling", "APIs externas", "external APIs", "qué datos se comparten". Mapea data flows y genera política de privacidad del proyecto.
 i18n: true
 ---
 

package/comandos/especdev/debate.md

@@ -1,5 +1,5 @@
 ---
-description: Deliberación multi-rol con tensiones explícitas para decisiones de arquitectura y trade-offs
+description: Deliberación multi-rol con tensiones explícitas para decisiones de arquitectura y trade-offs. Usa cuando el usuario dice "debatir", "debate", "discuss trade-offs", "arquitectura debate", "multi-role", "tensiones", "decision debate", "pros cons", "权衡". Simula múltiples perspectives (dev, security, ops, business) con tensiones explícitas para decisions complejas.
 i18n: true
 ---
 

package/comandos/especdev/desglosar.md

@@ -1,5 +1,5 @@
 ---
-description: Dividir un blueprint técnico en tareas con TDD (RED→GREEN) y marcadores de paralelismo
+description: Dividir blueprint técnico en tareas ejecutables con marcadores de paralelismo. Usa cuando el usuario dice "desglosar", "dividir en tareas", "breakdown", "task breakdown", "WBS", "dividir feature", "plan de tareas", "decompose", "story to tasks", "task planning", "subtareas". Aplica TDD markers (RED→GREEN) e indica tareas paralelizables.
 i18n: true
 ---
 

package/comandos/especdev/destilar.md

@@ -1,5 +1,5 @@
 ---
-description: Extraer especificaciones compactas desde código existente (Blueprint Distillation)
+description: Extraer especificaciones compactas desde código existente (Blueprint Distillation). Usa cuando el usuario dice "destilar", "extraer specs", "reverse specs", "code to specs", "distill", "existing code to Gherkin", "specification from code", "document existing code". Convierte código legacy en specs Gherkin compactas para enabling TDD en código existente.
 i18n: true
 ---
 

package/comandos/especdev/detectar-ambiguedad.md

@@ -1,5 +1,5 @@
 ---
-description: Detectar ambigüedades y contradicciones en specs de forma exhaustiva
+description: Detectar ambigüedades y contradicciones en specs de forma exhaustiva. Usa cuando el usuario dice "detectar ambigüedad", "spec contradictions", "vague requirements", "spec gaps", "ambigüedad", "contradiction in specs", "inconsistency", "fuzzy spec", "req ambiguity". Análisis exhaustivo línea por línea buscando gaps, contradictions y vagueness.
 i18n: true
 ---
 

package/comandos/especdev/diagnostico.md

@@ -1,5 +1,5 @@
 ---
-description: Verificar la salud del setup de Don Cheli en el proyecto actual
+description: Verificar la salud del setup de Don Cheli en el proyecto actual. Usa cuando el usuario dice "diagnóstico", "health check", "verificar setup", "don cheli health", "framework status", "setup issues", "validar configuración", "check Don Cheli". Detecta problemas de configuración, missing files, y propone repairs automáticos.
 i18n: true
 ---
 

package/comandos/especdev/diagram.md

@@ -1,5 +1,5 @@
 ---
-description: Auto-generar diagramas Mermaid/C4 desde análisis de código
+description: Auto-generar diagramas Mermaid/C4 desde análisis de código. Usa cuando el usuario dice "diagrama", "generar diagrama", "mermaid", "C4 model", "architecture diagram", "flowchart", "sequence diagram", "class diagram", "visualizar", "generate diagram", "diagram from code". Genera diagrams automáticamente desde análisis del codebase.
 i18n: true
 ---
 

package/comandos/especdev/dise/303/261ar.md

@@ -1,5 +1,5 @@
 ---
-description: Diseño técnico con decisiones de arquitectura documentadas
+description: Diseño técnico con decisiones de arquitectura documentadas (ADR). Usa cuando el usuario dice "diseño técnico", "technical design", "architecture decision", "ADR", "Architecture Decision Record", "diseñar sistema", "system design", "trade-offs", "decisiones de arquitectura", "design doc". Captura el why junto con el what, evaluando alternatives y consequences.
 i18n: true
 ---
 

package/comandos/especdev/doctor.md

@@ -1,5 +1,5 @@
 ---
-description: Diagnosticar y reparar problemas del framework, git y entorno
+description: Diagnosticar y reparar problemas del framework Don Cheli, git y entorno. Usa cuando el usuario dice "doctor", "problemas del framework", "don cheli no funciona", "repair Don Cheli", "debug setup", "setup broken", "framework broken", "reparar entorno". Detecta y repara issues de configuración, git y dependencias automáticamente.
 i18n: true
 ---
 

package/comandos/especdev/donde-estoy.md

@@ -1,5 +1,5 @@
 ---
-description: Test rápido de 5 preguntas para verificar contexto
+description: Test rápido de 5 preguntas para verificar contexto antes de continuar. Usa cuando el usuario dice "donde estoy", "verify context", "context check", "check my context", "Dónde estamos", "am I in the right context", "context verification", "5 preguntas", "verificar contexto". Test de 5 preguntas que verifica si el modelo tiene el contexto correcto antes de proceder.
 i18n: true
 ---
 

package/comandos/especdev/drift.md

@@ -1,5 +1,5 @@
 ---
-description: Detectar divergencias entre specs Gherkin e implementación real
+description: Detectar divergencias entre specs Gherkin e implementación (spec drift). Usa cuando el usuario dice "spec drift", "drift detection", "spec vs código", "conformance check", "spec deviation", "código no matchea specs", "implementation diverged", "spec vs implementation", "verificar specs". Compara features implementadas contra specs y reporta gaps con severity.
 i18n: true
 ---
 
@@ -125,6 +125,34 @@ Detectar y reportar divergencias entre las especificaciones Gherkin (`.feature`)
 
 Ejecutar automáticamente antes de `/dc:implementar` y después de cada merge.
 
+## Modo Vigilante (Async Watcher)
+
+```
+/dc:drift --vigilante          # Activar vigilante continuo
+/dc:drift --vigilante --off    # Desactivar
+```
+
+Cuando está activo, el vigilante:
+
+1. **Detecta cambios en código** — Monitorea archivos fuente modificados desde el último commit
+2. **Compara contra specs** — Verifica que los cambios no violen escenarios Gherkin existentes
+3. **Alerta inmediata** — Si el código cambia pero la spec no se actualiza:
+
+```
+⚠️ DRIFT ALERT: Arquitectura Comprometida
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Archivo modificado:  src/services/auth.ts (línea 45-67)
+Spec afectada:       specs/auth/login.feature:23
+Escenario:           "Login con MFA por TOTP"
+Drift:               Lógica de MFA eliminada, spec sigue requiriéndola
+Severidad:           🔴 CRÍTICO
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Acción: Actualiza la spec o revierte el cambio.
+```
+
+4. **Registro en `.dc/drift/alerts.json`** — Historial de alertas para trending
+5. **Integración CI** — Se ejecuta automáticamente en el GitHub Action con `gates: drift`
+
 ## Guardrails
 
 - **Nunca** marcar como cubierto un escenario si el test solo coincide por nombre pero no por comportamiento

package/comandos/especdev/especificar.md

@@ -1,5 +1,5 @@
 ---
-description: Crear especificación Gherkin desde un requerimiento con schema DBML auto-generado
+description: Crear especificaciones Gherkin desde un requerimiento/requisito. Usa cuando el usuario dice "escribir specs", "especificar feature", "crear Gherkin", "escribir requerimientos", "write specs", "requirements to Gherkin", "escribir scenarios", "documentar feature en Gherkin". Genera DBML schema auto-máticamente para persistence. Incluye validación contra el schema IEEE 29148.
 i18n: true
 ---