don-cheli-sdd 1.25.1 → 1.27.0

package/CHANGELOG.md

@@ -4,6 +4,18 @@ Todos los cambios notables en Don Cheli SDD Framework.
 
 Formato basado en [Conventional Commits](https://www.conventionalcommits.org/).
 
+## [1.27.0](https://github.com/doncheli/don-cheli-sdd/compare/v1.26.0...v1.27.0) (2026-04-07)
+
+### Nuevas Funcionalidades
+
+* mejoras al framework — modo autónomo, triple source, crash recovery ([e5fbe15](https://github.com/doncheli/don-cheli-sdd/commit/e5fbe154be88a37ec40efb8d80f74f7b5f1841a3))
+
+## [1.26.0](https://github.com/doncheli/don-cheli-sdd/compare/v1.25.1...v1.26.0) (2026-04-07)
+
+### Nuevas Funcionalidades
+
+* auto-actualización automática del framework + skills al inicio de sesión ([54deefe](https://github.com/doncheli/don-cheli-sdd/commit/54deefe501fead50eeda67088a58e8d60f0b6adf))
+
 ## [1.25.1](https://github.com/doncheli/don-cheli-sdd/compare/v1.25.0...v1.25.1) (2026-04-07)
 
 ### Correcciones

package/CLAUDE.md

@@ -31,26 +31,36 @@ Lee bajo demanda:
 - `/razonar:*` — 15 modelos de razonamiento
 
 ## Auto-actualización al inicio de sesión
-Al inicio de la **primera interacción** de cada sesión:
+Al inicio de la **primera interacción** de cada sesión, ejecutar automáticamente:
+
+### Paso 1: Actualizar framework
 1. Leer `${FRAMEWORK_HOME}/VERSION` para obtener la versión local
-2. Ejecutar `curl -s https://raw.githubusercontent.com/doncheli/don-cheli-sdd/main/VERSION` para obtener la versión remota
-3. Si versiones iguales o falla el curl → silencio, no mostrar nada
-4. Si hay versión mayor → **notificar** al usuario (NO auto-aplicar):
-
-**Formato de notificación (según idioma configurado):**
-- **es:** `⬆️ Don Cheli v{remota} disponible (instalada: v{local}). Ejecuta /dc:actualizar para actualizar.`
-- **en:** `⬆️ Don Cheli v{remote} available (installed: v{local}). Run /dc:update to upgrade.`
-- **pt:** `⬆️ Don Cheli v{remota} disponível (instalada: v{local}). Execute /dc:atualizar para atualizar.`
-
-**Alternativa rápida vía terminal:**
-- `don-cheli update` (si instaló via npm)
-- `bash scripts/actualizar.sh` (si instaló via git clone)
-
-**Reglas:**
-- Solo notificar **una vez por sesión** (no repetir en cada mensaje)
-- Si no hay conexión o falla el curl → continuar sin notificar (no bloquear)
-- **Nunca** auto-aplicar actualizaciones sin confirmación del usuario
-5. El proceso NO debe bloquear la interacción del usuario
+2. Ejecutar `curl -s https://raw.githubusercontent.com/doncheli/don-cheli-sdd/main/VERSION`
+3. Si versiones iguales o falla el curl → silencio
+4. Si hay versión mayor → **auto-actualizar en background**:
+   a. Clonar versión nueva en directorio temporal
+   b. Ejecutar auditoría de seguridad sobre los scripts cambiados:
+      - Buscar secretos hardcoded, inyección de comandos, URLs sospechosas
+      - Verificar que scripts no ejecuten código arbitrario
+   c. Ejecutar validación de estructura: `bash scripts/validar.sh`
+   d. Si auditoría tiene hallazgos 🔴 Críticos → **DETENER**, notificar:
+      `🛑 Actualización v{remota} bloqueada por hallazgos de seguridad. Revisar con /dc:auditar-seguridad`
+   e. Si pasa auditoría y estructura → aplicar: `bash scripts/actualizar.sh --forzar`
+   f. Notificar: `✅ Don Cheli auto-actualizado: v{local} → v{remota} (seguridad: ✅ | estructura: ✅)`
+
+### Paso 2: Actualizar skills de terceros (semanal)
+1. Ejecutar `bash scripts/skill-updater.sh --quiet`
+2. El script tiene throttle de 7 días — solo verifica una vez por semana
+3. Si hay updates de Anthropic Skills → aplicar automáticamente
+4. Si hay updates de comunidad → solo notificar (no auto-aplicar)
+5. Notificar si hubo cambios: `✅ Skills actualizadas: {N} de Anthropic`
+
+### Reglas
+- **Una vez por sesión** — no repetir checks en cada mensaje
+- Si no hay conexión → silencio, no bloquear la interacción
+- El proceso NO debe bloquear la interacción del usuario
+- Siempre ejecutar checks de seguridad y estructura antes de aplicar
+- Si la auditoría falla → DETENER y notificar, nunca aplicar cambios inseguros
 
 ## Idioma (i18n)
 Detección: `${FRAMEWORK_HOME}/locale` → `.dc/config.yaml` → default `es`

package/README.es.md

@@ -12,11 +12,11 @@
   </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.25.1-blue" alt="Version">
+    <img src="https://img.shields.io/badge/versión-1.27.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">
-    <img src="https://img.shields.io/badge/habilidades-42+-orange" alt="Skills">
+    <img src="https://img.shields.io/badge/comandos-88+-purple" alt="Commands">
+    <img src="https://img.shields.io/badge/habilidades-51+-orange" alt="Skills">
     <img src="https://img.shields.io/badge/Anthropic%20Skills%202.0-compatible-blueviolet" alt="Skills 2.0">
     <a href="https://marketplace.visualstudio.com/items?itemName=doncheli.don-cheli-sdd"><img src="https://img.shields.io/visual-studio-marketplace/v/doncheli.don-cheli-sdd?label=VS%20Code&color=007ACC" alt="VS Code"></a>
     <br/>
@@ -258,6 +258,10 @@ No negociables. Se aplican siempre. Sin excepciones.
 <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>
+<tr><td>Modo Autónomo (anti-context-rot)</td><td>—</td><td>—</td><td>—</td><td>—</td><td><strong>✅</strong></td></tr>
+<tr><td>Crash Recovery (lock + PID + estado)</td><td>—</td><td>—</td><td>—</td><td>—</td><td><strong>✅</strong></td></tr>
+<tr><td>Triple Fuente de Verdad (Gherkin+OpenAPI+JSON Schema)</td><td>—</td><td>—</td><td>—</td><td>—</td><td><strong>✅</strong></td></tr>
+<tr><td>PRD Generator (Figma + briefs)</td><td>—</td><td>—</td><td>—</td><td>—</td><td><strong>✅</strong></td></tr>
 </table>
 
 <details>
@@ -432,6 +436,25 @@ Sabe **exactamente** cuanto costara una fase ANTES de ejecutarla:
 
 ---
 
+
+---
+
+## Modo Autónomo
+
+Ejecuta el pipeline SDD completo sin intervención. Agentes frescos por fase previenen context rot.
+
+```bash
+/dc:auto "Implementar autenticación JWT con refresh tokens"
+# → Research → Especificar → Planificar → Desglosar → Implementar → Revisar → Listo
+```
+
+- **Agentes frescos por fase** — Cada fase inicia con contexto limpio de 200K
+- **Crash recovery** — Lock files + detección de PID, resume desde último checkpoint
+- **Pre-flight** — Estima tokens/costo antes de ejecutar
+- **Quality gates** — Cada fase pasa su puerta antes de avanzar
+- **Triple fuente de verdad** — Gherkin + OpenAPI 3.1 + JSON Schema
+
+
 ## Multi-plataforma
 
 Don Cheli no es un programa. Son archivos Markdown que cualquier agente de IA puede interpretar.

package/README.md

@@ -12,11 +12,11 @@
   </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.25.1-blue" alt="Version">
+    <img src="https://img.shields.io/badge/version-1.27.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">
-    <img src="https://img.shields.io/badge/skills-42+-orange" alt="Skills">
+    <img src="https://img.shields.io/badge/commands-88+-purple" alt="Commands">
+    <img src="https://img.shields.io/badge/skills-51+-orange" alt="Skills">
     <img src="https://img.shields.io/badge/Anthropic%20Skills%202.0-compatible-blueviolet" alt="Skills 2.0">
     <a href="https://marketplace.visualstudio.com/items?itemName=doncheli.don-cheli-sdd"><img src="https://img.shields.io/visual-studio-marketplace/v/doncheli.don-cheli-sdd?label=VS%20Code&color=007ACC" alt="VS Code"></a>
     <br/>
@@ -258,6 +258,10 @@ Non-negotiable. Always enforced. No exceptions.
 <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>
+<tr><td>Autonomous Mode (anti-context-rot)</td><td>—</td><td>—</td><td>—</td><td>—</td><td><strong>✅</strong></td></tr>
+<tr><td>Crash Recovery (lock + PID + state)</td><td>—</td><td>—</td><td>—</td><td>—</td><td><strong>✅</strong></td></tr>
+<tr><td>Triple Source of Truth (Gherkin+OpenAPI+JSON Schema)</td><td>—</td><td>—</td><td>—</td><td>—</td><td><strong>✅</strong></td></tr>
+<tr><td>PRD Generator (Figma + briefs)</td><td>—</td><td>—</td><td>—</td><td>—</td><td><strong>✅</strong></td></tr>
 </table>
 
 <details>
@@ -432,6 +436,35 @@ Know **exactly** how much a phase will cost BEFORE executing:
 
 ---
 
+
+---
+
+## Autonomous Mode
+
+Execute the full SDD pipeline hands-off. Fresh agents per phase prevent context rot.
+
+```bash
+/dc:auto "Implement JWT authentication with refresh tokens"
+# → Research → Specify → Plan → Breakdown → Implement → Review → Done
+```
+
+- **Fresh agents per phase** — Each phase spawns a clean 200K context (no degradation)
+- **Crash recovery** — Lock files + PID detection resume from last checkpoint
+- **Pre-flight budget** — Estimates tokens/cost before executing
+- **Quality gates** — Each phase passes its gate before advancing
+- **Max retries** — 3 attempts per phase, then asks for human help
+
+```
+Orchestrator (30-40% context — optimal zone)
+  ├── Agent 1: RESEARCH  (fresh 200K) → .dc/auto/research.md
+  ├── Agent 2: SPECIFY   (fresh 200K) → .dc/specs/*.feature
+  ├── Agent 3: PLAN      (fresh 200K) → .dc/blueprints/*.md
+  ├── Agent 4: BREAKDOWN (fresh 200K) → .dc/tareas/*.md
+  ├── Agents 5-N: IMPLEMENT (fresh per task) → code + tests
+  └── Agent Final: REVIEW (fresh 200K) → .dc/reviews/*.md
+```
+
+
 ## Multi-platform
 
 Don Cheli is not a program. It's Markdown files that any AI agent can interpret.

package/README.pt.md

@@ -12,11 +12,11 @@
   </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.25.1-blue" alt="Version">
+    <img src="https://img.shields.io/badge/versão-1.27.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">
-    <img src="https://img.shields.io/badge/habilidades-42+-orange" alt="Skills">
+    <img src="https://img.shields.io/badge/comandos-88+-purple" alt="Commands">
+    <img src="https://img.shields.io/badge/habilidades-51+-orange" alt="Skills">
     <img src="https://img.shields.io/badge/Anthropic%20Skills%202.0-compatível-blueviolet" alt="Skills 2.0">
     <br/>
     <a href="https://github.com/doncheli/don-cheli-sdd/actions/workflows/validar.yml"><img src="https://github.com/doncheli/don-cheli-sdd/actions/workflows/validar.yml/badge.svg" alt="CI"></a>
@@ -257,6 +257,10 @@ Não negociáveis. Sempre aplicadas. Sem exceções.
 <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>
+<tr><td>Modo Autônomo (anti-context-rot)</td><td>—</td><td>—</td><td>—</td><td>—</td><td><strong>✅</strong></td></tr>
+<tr><td>Crash Recovery (lock + PID + estado)</td><td>—</td><td>—</td><td>—</td><td>—</td><td><strong>✅</strong></td></tr>
+<tr><td>Tripla Fonte de Verdade (Gherkin+OpenAPI+JSON Schema)</td><td>—</td><td>—</td><td>—</td><td>—</td><td><strong>✅</strong></td></tr>
+<tr><td>PRD Generator (Figma + briefs)</td><td>—</td><td>—</td><td>—</td><td>—</td><td><strong>✅</strong></td></tr>
 </table>
 
 <details>
@@ -431,6 +435,25 @@ Saiba **exatamente** quanto custara uma fase ANTES de executar:
 
 ---
 
+
+---
+
+## Modo Autônomo
+
+Execute o pipeline SDD completo sem intervenção. Agentes frescos por fase previnem context rot.
+
+```bash
+/dc:auto "Implementar autenticação JWT com refresh tokens"
+# → Research → Especificar → Planejar → Desdobrar → Implementar → Revisar → Pronto
+```
+
+- **Agentes frescos por fase** — Cada fase inicia com contexto limpo de 200K
+- **Crash recovery** — Lock files + detecção de PID, resume do último checkpoint
+- **Pre-flight** — Estima tokens/custo antes de executar
+- **Quality gates** — Cada fase passa sua porta antes de avançar
+- **Tripla fonte de verdade** — Gherkin + OpenAPI 3.1 + JSON Schema
+
+
 ## Multi-plataforma
 
 Don Cheli não é um programa. São arquivos Markdown que qualquer agente de IA pode interpretar.

package/VERSION

@@ -1 +1 @@
-1.25.1
+1.27.0

package/comandos/dc/auto.md

@@ -0,0 +1,177 @@
+---
+description: Modo autónomo que ejecuta el pipeline SDD completo sin intervención humana. Usa cuando el usuario dice "auto", "autónomo", "autonomous", "run automatically", "ejecutar solo", "auto mode", "hands-off", "unattended", "modo piloto automático". Spawna agentes frescos por tarea para evitar context rot.
+i18n: true
+---
+
+# /dc:auto — Modo Autónomo
+
+## Objetivo
+
+Ejecutar el pipeline SDD **completo** sin intervención humana: research → spec → plan → code → test → verify → commit. Cada fase usa un agente fresco para evitar context rot.
+
+## Uso
+
+```
+/dc:auto "Implementar autenticación JWT con refresh tokens"
+/dc:auto --nivel 2                     # Forzar nivel específico
+/dc:auto --hasta implementar           # Parar después de una fase
+/dc:auto --dry-run                     # Simular sin ejecutar código
+/dc:auto --max-iteraciones 5           # Límite de ciclos TDD
+/dc:auto --presupuesto 10.00           # Límite de costo en USD
+```
+
+## Arquitectura Anti-Context-Rot
+
+El problema fundamental: ejecutar todo en un solo contexto degrada la calidad.
+
+**Solución: Agentes frescos por fase.**
+
+```
+Orquestador (30-40% del contexto — zona óptima)
+  │
+  ├── Agente 1: RESEARCH (contexto fresco 200K)
+  │   └── Explora codebase, identifica constraints
+  │       Output → .dc/auto/research.md
+  │
+  ├── Agente 2: SPECIFY (contexto fresco 200K)
+  │   └── Lee research.md → genera specs Gherkin
+  │       Output → .dc/specs/*.feature
+  │
+  ├── Agente 3: PLAN (contexto fresco 200K)
+  │   └── Lee specs → genera blueprint técnico
+  │       Output → .dc/blueprints/*.md
+  │
+  ├── Agente 4: BREAKDOWN (contexto fresco 200K)
+  │   └── Lee blueprint → genera tareas TDD
+  │       Output → .dc/tareas/*.md
+  │
+  ├── Agentes 5-N: IMPLEMENT (contexto fresco por tarea)
+  │   └── Una tarea a la vez: RED → GREEN → REFACTOR
+  │       Output → código + tests
+  │
+  └── Agente Final: REVIEW (contexto fresco 200K)
+      └── Lee todo → peer review 7 dimensiones
+          Output → .dc/reviews/*.md
+```
+
+**Cada agente:**
+- Inicia con contexto 100% limpio
+- Lee SOLO los artefactos que necesita del disco (.dc/)
+- Escribe su output a disco antes de terminar
+- El orquestador decide si avanzar o reintentar
+
+## State Machine
+
+```
+┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐
+│ RESEARCH │───▶│ SPECIFY  │───▶│   PLAN   │───▶│BREAKDOWN │
+└──────────┘    └──────────┘    └──────────┘    └──────────┘
+                                                     │
+                    ┌──────────┐    ┌──────────┐     │
+                    │  REVIEW  │◀───│IMPLEMENT │◀────┘
+                    └──────────┘    └──────────┘
+                         │              │
+                    ┌────▼────┐    ┌────▼────┐
+                    │  DONE   │    │  RETRY  │──(max 3)
+                    └─────────┘    └─────────┘
+```
+
+**Persistencia en disco:**
+
+```
+.dc/auto/
+├── state.json              # Estado de la máquina de estados
+├── lock.pid                # PID del proceso (crash recovery)
+├── research.md             # Output de fase research
+├── cost-tracker.json       # Consumo de tokens acumulado
+└── log.md                  # Log detallado de cada paso
+```
+
+### state.json
+
+```json
+{
+  "task": "Implementar autenticación JWT",
+  "level": 2,
+  "current_phase": "implement",
+  "current_task": "T003",
+  "phases_completed": ["research", "specify", "plan", "breakdown"],
+  "phases_remaining": ["implement", "review"],
+  "started_at": "2026-04-07T10:00:00Z",
+  "tokens_used": 45000,
+  "cost_usd": 0.42,
+  "retries": 0,
+  "max_retries": 3
+}
+```
+
+## Crash Recovery
+
+Si el proceso se interrumpe (crash, timeout, ctrl+c):
+
+1. Al iniciar, verifica si existe `.dc/auto/lock.pid`
+2. Si existe y el PID sigue activo → error "otra instancia corriendo"
+3. Si existe pero el PID murió → **crash recovery**:
+   - Lee `state.json` para saber dónde quedó
+   - Resume desde la última fase completada
+   - No repite trabajo ya hecho
+
+```
+/dc:auto --continuar         # Resumir ejecución interrumpida
+```
+
+```
+🔄 Crash recovery activado
+  Última fase: implement (T003)
+  Fases completadas: research, specify, plan, breakdown
+  Tokens consumidos: 45,000 ($0.42)
+  Resumiendo desde: implement T004...
+```
+
+## Pre-Flight integrado
+
+Antes de ejecutar, muestra estimación:
+
+```
+═══════════════════════════════════════════
+  /dc:auto Pre-Flight
+═══════════════════════════════════════════
+
+  Tarea: Implementar autenticación JWT
+  Nivel: 2 — Estándar
+  Fases: 6 (research → review)
+  Agentes: 8 (1 por fase + 2 para implement)
+
+  Estimación:
+    Tokens: ~85,000
+    Costo:  ~$1.20
+    Tiempo: ~30 minutos
+
+  ¿Proceder? [S/n]
+```
+
+## Guardrails
+
+- **Max retries por fase:** 3 (configurable). Si falla 3 veces → parar y pedir ayuda humana.
+- **Presupuesto:** Si se excede → parar y notificar.
+- **Quality gates:** Cada fase pasa por su gate antes de avanzar. Si falla → reintentar o parar.
+- **Stubs:** Si se detectan stubs en implement → reintentar la tarea, no avanzar.
+- **Drift:** Al final, ejecutar `/dc:drift` para verificar que specs == código.
+
+## Integración con el pipeline existente
+
+`/dc:auto` es un **orquestador** que invoca los comandos existentes:
+
+```
+/dc:auto → internamente ejecuta:
+  /dc:explorar          (research)
+  /dc:especificar       (specify)
+  /dc:clarificar        (clarify, si nivel ≥ 2)
+  /dc:planificar-tecnico (plan)
+  /dc:desglosar         (breakdown)
+  /dc:implementar       (implement, por tarea)
+  /dc:revisar           (review)
+  /dc:drift             (verificación final)
+```
+
+No reemplaza ningún comando — los orquesta.

package/comandos/dc/especificar.md

@@ -7,10 +7,16 @@ i18n: true
 
 ## Objetivo
 
-Convertir un requerimiento en lenguaje natural a una especificación Gherkin estructurada (`.feature`), incluyendo auto-generación de schema DBML provisional si no existe.
+Convertir un requerimiento en **triple fuente de verdad**:
+
+1. **Gherkin** (.feature) — Comportamiento verificable con escenarios P1/P2/P3+
+2. **OpenAPI 3.1** (openapi.yaml) — Contratos de API auto-generados desde los endpoints detectados en Gherkin
+3. **JSON Schema** (schemas/*.json) — Estructura de datos generada desde DBML
+4. **DBML** — Schema de base de datos provisional o ratificado
 
 > Mejorado con el ciclo de vida DBML de Specular (constitution.md §I-B)
-> Alineado con spec-kit (github/spec-kit) — prioridades P1/P2/P3+, criterios de éxito y marcadores de clarificación
+> Alineado con spec-kit — prioridades P1/P2/P3+, criterios de éxito y marcadores de clarificación
+> Triple source of truth inspirado en BMAD — Gherkin + OpenAPI + JSON Schema
 
 ## Uso
 

package/comandos/especdev/auto.md

@@ -0,0 +1,177 @@
+---
+description: Modo autónomo que ejecuta el pipeline SDD completo sin intervención humana. Usa cuando el usuario dice "auto", "autónomo", "autonomous", "run automatically", "ejecutar solo", "auto mode", "hands-off", "unattended", "modo piloto automático". Spawna agentes frescos por tarea para evitar context rot.
+i18n: true
+---
+
+# /dc:auto — Modo Autónomo
+
+## Objetivo
+
+Ejecutar el pipeline SDD **completo** sin intervención humana: research → spec → plan → code → test → verify → commit. Cada fase usa un agente fresco para evitar context rot.
+
+## Uso
+
+```
+/dc:auto "Implementar autenticación JWT con refresh tokens"
+/dc:auto --nivel 2                     # Forzar nivel específico
+/dc:auto --hasta implementar           # Parar después de una fase
+/dc:auto --dry-run                     # Simular sin ejecutar código
+/dc:auto --max-iteraciones 5           # Límite de ciclos TDD
+/dc:auto --presupuesto 10.00           # Límite de costo en USD
+```
+
+## Arquitectura Anti-Context-Rot
+
+El problema fundamental: ejecutar todo en un solo contexto degrada la calidad.
+
+**Solución: Agentes frescos por fase.**
+
+```
+Orquestador (30-40% del contexto — zona óptima)
+  │
+  ├── Agente 1: RESEARCH (contexto fresco 200K)
+  │   └── Explora codebase, identifica constraints
+  │       Output → .dc/auto/research.md
+  │
+  ├── Agente 2: SPECIFY (contexto fresco 200K)
+  │   └── Lee research.md → genera specs Gherkin
+  │       Output → .dc/specs/*.feature
+  │
+  ├── Agente 3: PLAN (contexto fresco 200K)
+  │   └── Lee specs → genera blueprint técnico
+  │       Output → .dc/blueprints/*.md
+  │
+  ├── Agente 4: BREAKDOWN (contexto fresco 200K)
+  │   └── Lee blueprint → genera tareas TDD
+  │       Output → .dc/tareas/*.md
+  │
+  ├── Agentes 5-N: IMPLEMENT (contexto fresco por tarea)
+  │   └── Una tarea a la vez: RED → GREEN → REFACTOR
+  │       Output → código + tests
+  │
+  └── Agente Final: REVIEW (contexto fresco 200K)
+      └── Lee todo → peer review 7 dimensiones
+          Output → .dc/reviews/*.md
+```
+
+**Cada agente:**
+- Inicia con contexto 100% limpio
+- Lee SOLO los artefactos que necesita del disco (.dc/)
+- Escribe su output a disco antes de terminar
+- El orquestador decide si avanzar o reintentar
+
+## State Machine
+
+```
+┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐
+│ RESEARCH │───▶│ SPECIFY  │───▶│   PLAN   │───▶│BREAKDOWN │
+└──────────┘    └──────────┘    └──────────┘    └──────────┘
+                                                     │
+                    ┌──────────┐    ┌──────────┐     │
+                    │  REVIEW  │◀───│IMPLEMENT │◀────┘
+                    └──────────┘    └──────────┘
+                         │              │
+                    ┌────▼────┐    ┌────▼────┐
+                    │  DONE   │    │  RETRY  │──(max 3)
+                    └─────────┘    └─────────┘
+```
+
+**Persistencia en disco:**
+
+```
+.dc/auto/
+├── state.json              # Estado de la máquina de estados
+├── lock.pid                # PID del proceso (crash recovery)
+├── research.md             # Output de fase research
+├── cost-tracker.json       # Consumo de tokens acumulado
+└── log.md                  # Log detallado de cada paso
+```
+
+### state.json
+
+```json
+{
+  "task": "Implementar autenticación JWT",
+  "level": 2,
+  "current_phase": "implement",
+  "current_task": "T003",
+  "phases_completed": ["research", "specify", "plan", "breakdown"],
+  "phases_remaining": ["implement", "review"],
+  "started_at": "2026-04-07T10:00:00Z",
+  "tokens_used": 45000,
+  "cost_usd": 0.42,
+  "retries": 0,
+  "max_retries": 3
+}
+```
+
+## Crash Recovery
+
+Si el proceso se interrumpe (crash, timeout, ctrl+c):
+
+1. Al iniciar, verifica si existe `.dc/auto/lock.pid`
+2. Si existe y el PID sigue activo → error "otra instancia corriendo"
+3. Si existe pero el PID murió → **crash recovery**:
+   - Lee `state.json` para saber dónde quedó
+   - Resume desde la última fase completada
+   - No repite trabajo ya hecho
+
+```
+/dc:auto --continuar         # Resumir ejecución interrumpida
+```
+
+```
+🔄 Crash recovery activado
+  Última fase: implement (T003)
+  Fases completadas: research, specify, plan, breakdown
+  Tokens consumidos: 45,000 ($0.42)
+  Resumiendo desde: implement T004...
+```
+
+## Pre-Flight integrado
+
+Antes de ejecutar, muestra estimación:
+
+```
+═══════════════════════════════════════════
+  /dc:auto Pre-Flight
+═══════════════════════════════════════════
+
+  Tarea: Implementar autenticación JWT
+  Nivel: 2 — Estándar
+  Fases: 6 (research → review)
+  Agentes: 8 (1 por fase + 2 para implement)
+
+  Estimación:
+    Tokens: ~85,000
+    Costo:  ~$1.20
+    Tiempo: ~30 minutos
+
+  ¿Proceder? [S/n]
+```
+
+## Guardrails
+
+- **Max retries por fase:** 3 (configurable). Si falla 3 veces → parar y pedir ayuda humana.
+- **Presupuesto:** Si se excede → parar y notificar.
+- **Quality gates:** Cada fase pasa por su gate antes de avanzar. Si falla → reintentar o parar.
+- **Stubs:** Si se detectan stubs en implement → reintentar la tarea, no avanzar.
+- **Drift:** Al final, ejecutar `/dc:drift` para verificar que specs == código.
+
+## Integración con el pipeline existente
+
+`/dc:auto` es un **orquestador** que invoca los comandos existentes:
+
+```
+/dc:auto → internamente ejecuta:
+  /dc:explorar          (research)
+  /dc:especificar       (specify)
+  /dc:clarificar        (clarify, si nivel ≥ 2)
+  /dc:planificar-tecnico (plan)
+  /dc:desglosar         (breakdown)
+  /dc:implementar       (implement, por tarea)
+  /dc:revisar           (review)
+  /dc:drift             (verificación final)
+```
+
+No reemplaza ningún comando — los orquesta.

package/comandos/especdev/especificar.md

@@ -7,10 +7,16 @@ i18n: true
 
 ## Objetivo
 
-Convertir un requerimiento en lenguaje natural a una especificación Gherkin estructurada (`.feature`), incluyendo auto-generación de schema DBML provisional si no existe.
+Convertir un requerimiento en **triple fuente de verdad**:
+
+1. **Gherkin** (.feature) — Comportamiento verificable con escenarios P1/P2/P3+
+2. **OpenAPI 3.1** (openapi.yaml) — Contratos de API auto-generados desde los endpoints detectados en Gherkin
+3. **JSON Schema** (schemas/*.json) — Estructura de datos generada desde DBML
+4. **DBML** — Schema de base de datos provisional o ratificado
 
 > Mejorado con el ciclo de vida DBML de Specular (constitution.md §I-B)
-> Alineado con spec-kit (github/spec-kit) — prioridades P1/P2/P3+, criterios de éxito y marcadores de clarificación
+> Alineado con spec-kit — prioridades P1/P2/P3+, criterios de éxito y marcadores de clarificación
+> Triple source of truth inspirado en BMAD — Gherkin + OpenAPI + JSON Schema
 
 ## Uso