don-cheli-sdd 1.21.1 → 1.22.0

package/CHANGELOG.md

@@ -4,6 +4,12 @@ Todos los cambios notables en Don Cheli SDD Framework.
 
 Formato basado en [Conventional Commits](https://www.conventionalcommits.org/).
 
+## [1.22.0](https://github.com/doncheli/don-cheli-sdd/compare/v1.21.1...v1.22.0) (2026-04-07)
+
+### Nuevas Funcionalidades
+
+* dc/ como prefijo principal, especdev/ como retrocompatible ([521a93c](https://github.com/doncheli/don-cheli-sdd/commit/521a93cc87c40d8a74e81bbe29ff2c4996ed4eab))
+
 ## [1.21.1](https://github.com/doncheli/don-cheli-sdd/compare/v1.21.0...v1.21.1) (2026-04-07)
 
 ### Correcciones

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.21.1-blue" alt="Version">
+    <img src="https://img.shields.io/badge/versión-1.22.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">

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.21.1-blue" alt="Version">
+    <img src="https://img.shields.io/badge/version-1.22.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">

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.21.1-blue" alt="Version">
+    <img src="https://img.shields.io/badge/versão-1.22.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">

package/VERSION

@@ -1 +1 @@
-1.21.1
+1.22.0

package/comandos/dc/actualizar.md

@@ -0,0 +1,266 @@
+---
+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
+---
+
+# /dc:actualizar
+
+## Objetivo
+
+Verificar si hay actualizaciones disponibles en el repositorio de Don Cheli y ofrecer aplicarlas.
+
+## Uso
+
+```
+/dc:actualizar
+/dc:actualizar --verificar    # Solo verificar, no aplicar
+/dc:actualizar --forzar       # Aplicar sin confirmar
+/dc:actualizar --auto         # Auto-actualizar con auditoría de seguridad (usado por auto-check de sesión)
+```
+
+## 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. Auditoría de seguridad pre-actualización
+
+Antes de aplicar cualquier actualización, ejecutar auditoría de seguridad sobre los cambios:
+
+```
+1. DIFF — Obtener archivos cambiados entre versiones
+   curl -s "https://api.github.com/repos/doncheli/don-cheli-sdd/compare/v${VERSION_LOCAL}...v${VERSION_REMOTA}" \
+     | jq '.files[].filename'
+
+2. CLONAR — Descargar versión nueva en temporal
+   TEMP=$(mktemp -d)
+   git clone --depth 1 https://github.com/doncheli/don-cheli-sdd.git "$TEMP"
+
+3. AUDITAR — Análisis de seguridad sobre archivos cambiados
+   Ejecutar /dc:auditar-seguridad sobre $TEMP con:
+   - Buscar secretos hardcoded (API keys, tokens, passwords)
+   - Buscar inyección de comandos en scripts (exec, eval, spawn)
+   - Verificar que scripts de instalación no ejecuten código arbitrario
+   - Verificar integridad de dependencias (package.json, lockfile)
+   - Buscar URLs/endpoints sospechosos nuevos
+   - Verificar que no se introduzcan permisos excesivos
+
+4. CLASIFICAR — Severidad de hallazgos
+   🔴 Crítico → BLOQUEAR actualización, notificar al usuario
+   🟠 Alto → ADVERTIR, aplicar con nota de riesgo
+   🟡 Medio/🔵 Bajo → Registrar, no bloquear
+```
+
+#### Output de auditoría pre-actualización
+
+```markdown
+=== Auditoría de Seguridad Pre-Actualización ===
+
+Versión: v{local} → v{remota}
+Archivos cambiados: {N}
+Archivos auditados: {N} (scripts, configs, código ejecutable)
+
+Resultado: ✅ LIMPIO | ⚠️ ADVERTENCIAS | 🛑 BLOQUEADO
+
+Hallazgos:
+  (lista de hallazgos si los hay)
+```
+
+### 6. Preguntar al usuario (modo interactivo)
+
+En modo interactivo (sin `--auto` ni `--forzar`):
+```
+¿Deseas actualizar Don Cheli de v1.6.0 a v1.7.0? (s/n)
+```
+
+En modo `--auto`: aplicar directamente si la auditoría pasa. Bloquear si hay hallazgos críticos.
+
+### 7. Aplicar actualización
+
+```bash
+# Usar el temporal ya clonado en paso 5.2
+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
+```
+
+## Configuración de Auto-Actualización
+
+En `.dc/config.yaml`:
+
+```yaml
+actualizaciones:
+  verificar_al_iniciar: true
+  auto_actualizar: true          # Aplicar actualizaciones automáticamente (requiere auditoría limpia)
+  auditoria_pre_update: true     # Auditoría de seguridad obligatoria antes de aplicar
+  frecuencia: siempre            # siempre | diario | semanal | nunca
+  verificar_skills_spec: true    # Verificar conformidad Anthropic Skills 2.0
+  bloquear_en_critico: true      # Detener actualización si hay hallazgos 🔴
+```
+
+### Comportamiento al inicio de sesión
+
+Cada vez que un cliente inicia sesión con Don Cheli:
+1. Verificar versión remota vs local
+2. Si hay actualización → ejecutar `/dc:actualizar --auto` en background
+3. El proceso no bloquea la interacción del usuario
+4. El usuario recibe notificación al completar (éxito o bloqueo)
+
+### Flujo `--auto`
+
+```
+Inicio de sesión
+  → Detectar versión remota
+  → Si nueva versión disponible:
+    → Clonar en temporal
+    → Auditoría de seguridad (--severidad critica)
+    → Si 🔴 Crítico → BLOQUEAR + notificar
+    → Si limpio → instalar + notificar éxito
+    → Verificar Skills 2.0 (si habilitado)
+    → Limpiar temporal
+```
+
+## 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/dc/agente.md

@@ -0,0 +1,43 @@
+---
+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
+---
+
+# /dc:agente
+
+## Objetivo
+
+Cargar un agente especializado con el modelo óptimo para una tarea específica.
+
+## Uso
+
+```
+/dc:agente <nombre>
+/dc: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/dc/analizar-sesiones.md

@@ -0,0 +1,158 @@
+---
+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
+---
+
+# /dc: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
+
+```
+/dc:analizar-sesiones
+/dc:analizar-sesiones --periodo <dias>
+/dc: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:
+- `/dc:iniciar` → Las skills detectadas se sugieren al crear un proyecto nuevo
+- `/dc:agente` → Los agentes detectados se agregan al sistema de agentes
+- `/dc: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/dc/aplicar.md

@@ -0,0 +1,73 @@
+---
+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
+---
+
+# /dc: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
+
+```
+/dc:aplicar                     # Implementar el cambio activo
+/dc:aplicar <nombre-cambio>     # Implementar un cambio específico
+/dc:aplicar --continuar         # Retomar donde se dejó
+```
+
+## Diferencia con /dc:implementar
+
+| `/dc:implementar` | `/dc: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** `.dc/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...
+/dc:aplicar agregar-dark-mode   # tarea 4/8
+
+# Interrumpido por bug urgente
+/dc:aplicar corregir-login      # empieza desde tarea 1/3
+
+# Bug corregido, volver a dark mode
+/dc:aplicar agregar-dark-mode   # retoma en tarea 5/8
+```

package/comandos/dc/archivar.md

@@ -0,0 +1,69 @@
+---
+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
+---
+
+# /dc: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
+
+```
+/dc:archivar @specs/features/<dominio>/<Feature>.feature
+/dc: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 `.dc/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:
+- `/dc:estimar` → datos históricos para estimados más precisos
+- `/dc:analizar-sesiones` → patrones de desarrollo
+- Memoria persistente → decisiones y convenciones aprendidas