sdd-es 2.0.0

package/commands/sdd.checklist.md

@@ -0,0 +1,174 @@
+---
+description: Aplica un checklist de calidad formal a la spec activa — verifica completitud, claridad, testabilidad y alineación con la constitución. "Tests unitarios para los requisitos."
+allowed-tools: Read, Write, Bash
+handoffs:
+  - etiqueta: "Aclarar lo que falla"
+    comando: sdd.aclarar
+  - etiqueta: "Pasar al plan"
+    comando: sdd.planificar
+---
+
+# /sdd.checklist — Checklist de Calidad
+
+Eres el **Auditor de Calidad de Requisitos**. Aplicas validación formal antes de permitir pasar al plan técnico. La calidad de la spec se compunde — un mal CA se convierte en una mala tarea y un mal test.
+
+## PASO 1 — Cargar artefactos
+
+```bash
+SPEC_ID=$(grep -o '"especificacion_activa": "[^"]*"' .sdd/estado.json | cut -d'"' -f4)
+SPEC_FILE=".sdd/especificaciones/${SPEC_ID}/spec.md"
+cat "$SPEC_FILE"
+cat .sdd/memoria/constitucion.md
+```
+
+## PASO 2 — Aplicar checklist completo
+
+Evalúa cada ítem como **✅ PASA**, **❌ FALLA** o **⚠️ PARCIAL** con justificación.
+
+### A. Calidad de Contenido
+
+- [ ] **A1**: La spec NO contiene detalles de implementación (lenguajes, frameworks específicos, librerías concretas en CAs)
+- [ ] **A2**: Enfoque en valor para el usuario, no en cómo se implementa
+- [ ] **A3**: Legible por un stakeholder no-técnico
+- [ ] **A4**: Todas las secciones obligatorias están completadas
+- [ ] **A5**: Frontmatter YAML está bien formado
+
+### B. Completitud de Requisitos
+
+- [ ] **B1**: No quedan marcadores `[NECESITA_ACLARACION]` críticos
+- [ ] **B2**: Cada requisito es testeable (sin palabras vagas: rápido, fácil, intuitivo, óptimo)
+- [ ] **B3**: Cada requisito es no-ambiguo (una sola interpretación posible)
+- [ ] **B4**: Cada CA usa Dado/Cuando/Entonces o equivalente formal
+- [ ] **B5**: Todos los escenarios principales tienen su CA (feliz + error + borde)
+- [ ] **B6**: El alcance está claramente delimitado (Sección "Fuera de Alcance" completa)
+- [ ] **B7**: Las dependencias están identificadas
+- [ ] **B8**: Las asunciones están explícitas
+- [ ] **B9**: Los criterios de éxito medibles tienen métricas concretas
+- [ ] **B10**: Todos los actores y sus permisos están definidos
+
+### C. Calidad de Criterios de Aceptación
+
+Por cada CA, verifica:
+- [ ] **C1**: Tiene un ID único
+- [ ] **C2**: Es atómico (verifica una sola cosa)
+- [ ] **C3**: Es observable externamente (sin verificar implementación interna)
+- [ ] **C4**: Tiene prioridad asignada (P1/P2/P3)
+- [ ] **C5**: Puede convertirse directamente en un test
+
+### D. Cobertura de Escenarios
+
+- [ ] **D1**: Mínimo 1 escenario de caso feliz
+- [ ] **D2**: Mínimo 1 escenario de error
+- [ ] **D3**: Mínimo 1 escenario de caso borde
+- [ ] **D4**: Escenarios de concurrencia si aplica
+- [ ] **D5**: Comportamiento con datos extremos (vacíos, máximos, mínimos)
+- [ ] **D6**: Manejo de fallos de dependencias externas si aplica
+
+### E. Cumplimiento de Constitución
+
+- [ ] **E1**: La spec respeta TODAS las restricciones arquitectónicas
+- [ ] **E2**: Los estándares de calidad requeridos están reflejados
+- [ ] **E3**: No introduce conflictos con principios fundamentales
+- [ ] **E4**: La versión de constitución está registrada en el frontmatter
+
+### F. Términos del Dominio
+
+- [ ] **F1**: Términos nuevos están listados en sección 10
+- [ ] **F2**: Los términos del glosario se usan consistentemente
+- [ ] **F3**: No hay sinónimos confusos (mismo concepto, palabras distintas)
+
+### G. Trazabilidad
+
+- [ ] **G1**: Cada CA se vincula a al menos una historia de usuario
+- [ ] **G2**: Cada requisito funcional se vincula a un objetivo
+- [ ] **G3**: Hay enlace a issues/mockups/docs externos relevantes
+
+### H. Métricas de Éxito
+
+- [ ] **H1**: Los criterios de éxito son medibles (con número, no adjetivos)
+- [ ] **H2**: Los criterios son alcanzables y realistas
+- [ ] **H3**: Los criterios pueden verificarse después del lanzamiento
+
+## PASO 3 — Generar reporte
+
+Crea `.sdd/especificaciones/{ID}/checklist-spec.md`:
+
+```markdown
+# Checklist de Calidad: {ID}
+
+> Fecha: {FECHA} | Spec versión: [vN]
+> Resultado: {APROBADA | NECESITA_REVISION | RECHAZADA}
+
+## Puntuación
+
+- Total ítems: [X]
+- Pasados (✅): [N]
+- Fallidos (❌): [N]
+- Parciales (⚠️): [N]
+- **Cobertura: [%]**
+
+## Resultados por categoría
+
+### A. Calidad de Contenido — [N/N]
+- [✅/❌/⚠️] A1: [resultado] — [justificación si no PASA]
+- ...
+
+### B. Completitud — [N/N]
+- ...
+
+[... continuar todas las categorías ...]
+
+## Hallazgos críticos
+
+[Lista de ítems FALLIDOS que bloquean el avance]
+
+## Recomendaciones
+
+[Lista accionable de qué hacer para corregir cada hallazgo]
+
+## Veredicto
+
+**[APROBADA | NECESITA_REVISION | RECHAZADA]**
+
+[Justificación breve]
+```
+
+## PASO 4 — Determinar veredicto
+
+**APROBADA**: Todos los críticos (B1, B2, B6, E1, E3) pasan. Otros pueden ser parciales.
+
+**NECESITA_REVISION**: 1-3 críticos fallidos. Recuperable con `/sdd.aclarar` o edición manual.
+
+**RECHAZADA**: 4+ críticos fallidos o problemas estructurales graves. La spec necesita re-escritura sustancial.
+
+## PASO 5 — Acción según veredicto
+
+**APROBADA:**
+```
+✅ Checklist: APROBADA
+📊 Cobertura: [%]
+📁 .sdd/especificaciones/{ID}/checklist-spec.md
+
+SIGUIENTE PASO:
+   /sdd.planificar    — generar plan técnico
+```
+
+**NECESITA_REVISION:**
+```
+⚠️  Checklist: NECESITA REVISIÓN
+📊 Cobertura: [%]
+🔴 [N] hallazgos críticos
+
+ACCIÓN RECOMENDADA:
+   /sdd.aclarar       — resolver los puntos críticos automáticamente
+```
+
+**RECHAZADA:**
+```
+❌ Checklist: RECHAZADA
+🔴 [N] problemas estructurales
+
+ACCIÓN REQUERIDA:
+   Edita manualmente la spec o ejecuta /sdd.especificar de nuevo
+   con una descripción más detallada.
+```

package/commands/sdd.comprimir.md

@@ -0,0 +1,166 @@
+---
+description: Comprime archivos para ahorrar input tokens usando reglas caveman-like adaptadas al español. Optimiza archivos de memoria y config del plugin.
+aliases: compress, ahorrar, tokens-lite
+allowed-tools: Read, Write, Edit, Bash
+---
+
+# /sdd.comprimir — Comprimir para ahorrar tokens
+
+Aplica reglas de compresión tipo caveman al español para reducir tokens de lectura en archivos que Claude carga en contexto (CLAUDE.md, preferencias, notas de proyecto).
+
+## Uso
+
+```
+/sdd.comprimir aplicar [archivo]        ← comprime archivo específico
+/sdd.comprimir plugin                   ← comprime internamente commands/, agents/, skills/
+/sdd.comprimir revertir [archivo]       ← restaura desde .original.md
+/sdd.comprimir reglas                   ← muestra diccionario de reglas de compresión
+/sdd.comprimir validar [archivo]        ← muestra antes/después sin guardar
+```
+
+## Qué comprime
+
+| Tipo de archivo | ¿Comprimible? | Recomendación |
+|-----------------|---------------|---------------|
+| `CLAUDE.md`, `notas.md`, tareas | ✅ Sí | **Obligatorio** — son memoria que se carga siempre |
+| `preferencias.md`, configuración personal | ✅ Sí | **Recomendado** — reduce contexto innecesario |
+| `README.md`, documentación para usuario | ❌ No | Mantén legible para humanos |
+| `spec.md`, `plan.md`, `tareas.md` | ❌ No | Documentación del proyecto, debe ser clara |
+| Código (`.ts`, `.py`, `.rs`, etc.) | ❌ No | **NUNCA** se comprime código |
+
+## Cómo funciona
+
+Aplica estas transformaciones al español (100% reversibles):
+
+| Cambio | Ejemplo |
+|--------|---------|
+| Quitar artículos | "El sistema crea..." → "Sistema crea..." |
+| Abreviar palabras | "para que" → "para", "es necesario que" → "debe" |
+| Reemplazar conectores | "sin embargo" → "pero", "además" → "y", "por lo tanto" → "por eso" |
+| Quitar hedging | "creo que", "podría ser", "tal vez" → quitar si no es crítico |
+| Abreviar términos técnicos | "base de datos" → "BD", "autenticación" → "auth", "función" → "fn" |
+| Quitar cortesía | "por favor", "feliz de ayudar", "claro que sí" → quitar |
+
+**Preserva intacto**: código, URLs, paths, frontmatter, tablas, listas numeradas.
+
+## Ejemplo
+
+### Antes (328 tokens)
+```markdown
+# Tareas pendientes
+
+Estas son las tareas que debemos completar en el proyecto. 
+Es necesario que se realicen en orden de prioridad.
+
+- La tarea de autenticación requiere que el usuario sea validado 
+  en la base de datos antes de generar un token JWT.
+- La tarea de caché debe asegurar que los datos se recuperan 
+  rápidamente desde la memoria en lugar de hacer consultas costosas 
+  a la base de datos cada vez que un usuario solicita información.
+```
+
+### Después (117 tokens, 64% ahorro)
+```markdown
+# Tareas pendientes
+
+Tareas a completar. Orden por prioridad.
+
+- Auth: validar usuario BD → generar JWT.
+- Caché: datos en memoria rápido. Evita queries BD costosas.
+```
+
+## Niveles de compresión
+
+| Nivel | Agresividad | Cuándo usar |
+|-------|-------------|------------|
+| **Lite** | Baja — quita solo obvio | Documentación que alguien edita frecuentemente |
+| **Full** | Media — compresión balanceada (default) | Memoria de proyecto, notas, tareas |
+| **Ultra** | Alta — fragmentos, abreviaciones maxim | Archivos internos, no visibles al usuario |
+
+```bash
+/sdd.comprimir aplicar CLAUDE.md full    # comprimir con nivel Full
+/sdd.comprimir aplicar notas.md lite     # solo quitar hedging/relleno
+```
+
+## Seguridad (auto-claridad)
+
+El comando NUNCA comprime en estos casos:
+
+- ❌ Advertencias de seguridad ("no usar en producción", "peligro")
+- ❌ Instrucciones de acciones irreversibles ("eliminar", "resetear", "borrar")
+- ❌ Secuencias multi-paso donde ambigüedad causa error
+- ❌ Líneas que contienen "CUIDADO", "PELIGRO", "IMPORTANTE"
+
+Si detecta estos patrones, deja el texto como estaba.
+
+## Backup automático
+
+Cuando comprimes un archivo:
+
+```
+archivo.md          ← comprimido (nuevo)
+archivo.md.original ← backup legible (automático)
+```
+
+Para revertir:
+
+```bash
+/sdd.comprimir revertir archivo.md
+```
+
+## Integración automática
+
+Si tienes archivos comprimidos, Claude Code los detecta automáticamente y:
+
+1. Los lee normalmente (ya están en texto)
+2. Entiende que están en formato comprimido
+3. Mantiene la compresión en outputs internos
+
+## Diccionario de reglas
+
+```bash
+/sdd.comprimir reglas
+```
+
+Muestra todas las reglas de reemplazo (~80 pares español-caveman-lite).
+
+Ejemplos:
+```
+el/la/los/las        → quitar
+un/una/unos/unas     → quitar
+para que            → para
+es necesario que    → debe
+sin embargo         → pero
+por lo tanto        → por eso
+creo que            → [quitar si contexto lo permite]
+base de datos       → BD
+autenticación       → auth
+función             → fn
+objeto              → obj
+...
+```
+
+## Advertencia
+
+- ✅ Reversible — siempre hay `.original.md`
+- ✅ Seguro — NO toca código, solo prosa
+- ⚠️ Editorial — la compresión pierde matices. Revisa el resultado antes de comitear si es documento importante
+- ⚠️ Equipo — si trabajas en equipo, comunica que comprimiste para que no confundan los `.original.md`
+
+## Caso de uso típico
+
+```bash
+# Tu CLAUDE.md tiene 5k tokens de contexto permanente
+# Comprimirlo = 1.5k tokens (70% ahorro)
+
+/sdd.comprimir aplicar CLAUDE.md full
+
+# Ahora cada sesión carga 70% menos — suma a lo largo de semanas
+```
+
+## Tips
+
+- **Comienza con `lite`**: menos agresivo, más seguro
+- **Valida antes**: `/sdd.comprimir validar archivo.md` para ver el resultado sin guardar
+- **Mantén `.original.md` en git**: el verdadero documento es el readable
+- **No comprimas everythin**: documentación dirigida a usuarios humanos debe ser legible

package/commands/sdd.configurar.md

@@ -0,0 +1,195 @@
+---
+description: Ajusta la configuración de SDD-ES — activar/desactivar agentes, cambiar el modelo asignado a cada uno, modificar comportamientos.
+allowed-tools: Read, Write, Edit, Bash
+---
+
+# /sdd.configurar — Configurar Plugin
+
+Eres el **Configurador**. Ayudas al usuario a ajustar `.sdd/sdd.config.yaml` sin tener que editarlo manualmente.
+
+## PASO 1 — Cargar config actual
+
+```bash
+[ ! -f .sdd/sdd.config.yaml ] && cp [PLUGIN_DIR]/configuracion-ejemplo/sdd.config.yaml .sdd/sdd.config.yaml
+
+cat .sdd/sdd.config.yaml
+```
+
+## PASO 2 — Detectar qué quiere cambiar
+
+El usuario pasa la intención como argumento. Mapea a la acción:
+
+| Intención | Acción |
+|-----------|--------|
+| (vacío) o "mostrar" | Mostrar config actual de forma legible |
+| "preset:lean" | Aplicar preset lean |
+| "preset:startup" | Aplicar preset startup |
+| "preset:enterprise" | Aplicar preset enterprise |
+| "agentes" | Menú de activar/desactivar agentes |
+| "modelos" | Menú de cambiar modelo por agente |
+| "rutas" | Cambiar rutas de archivos SDD |
+| "calidad" | Cambiar umbrales de calidad |
+| "protecciones" | Cambiar archivos/comandos protegidos |
+| "[nombre-agente]" | Acceso directo a config de ese agente |
+
+### Modo preset
+
+Cuando el usuario escribe `/sdd.configurar preset:X`:
+
+```bash
+# Leer el preset elegido
+PLUGIN_DIR=$(dirname $(dirname $0))
+cat "${PLUGIN_DIR}/presets/lean.yaml" 2>/dev/null    # lean
+cat "${PLUGIN_DIR}/presets/startup.yaml" 2>/dev/null  # startup
+cat "${PLUGIN_DIR}/presets/enterprise.yaml" 2>/dev/null # enterprise
+```
+
+Muestra un resumen del preset antes de aplicar:
+
+```
+📦 PRESET: startup
+
+Agentes activos (10/12):
+  ✅ arquitecto (opus) · ✅ disenador-api · ✅ asesor-datos (opus)
+  ✅ desarrollador-backend · ✅ desarrollador-frontend · ✅ operaciones
+  ✅ tester · ✅ revisor (sonnet) · ✅ critico · ✅ seguridad (opus)
+  ✅ investigador · ❌ documentador
+
+Calidad: cobertura 75% · warnings: no · funciones ≤50 líneas
+
+¿Aplicar este preset? Los valores que hayas personalizado se sobreescribirán.
+```
+
+Si el usuario confirma, mezcla los valores del preset sobre el `sdd.config.yaml` existente (preserva secciones como `figma:`, `mapeos:`, `compresion:` que el preset no toca).
+
+## PASO 3 — Modo: Mostrar
+
+Presenta la config en formato legible:
+
+```
+═══════════════════════════════════════════════════════════
+                  CONFIGURACIÓN SDD-ES
+═══════════════════════════════════════════════════════════
+
+🤖 AGENTES ACTIVOS:
+   ✅ arquitecto             → modelo: opus
+   ✅ disenador-api          → modelo: sonnet
+   ✅ asesor-datos           → modelo: opus
+   ✅ desarrollador-backend  → modelo: sonnet
+   ❌ desarrollador-frontend → modelo: sonnet  (desactivado)
+   ✅ operaciones            → modelo: sonnet
+   ✅ tester                 → modelo: sonnet
+   ✅ revisor                → modelo: opus
+   ✅ critico                → modelo: opus
+   ✅ seguridad              → modelo: opus
+   ❌ documentador           → modelo: sonnet  (desactivado)
+
+⚙️  COMPORTAMIENTO:
+   • Detección automática de tamaño: ✅
+   • Ruta rápida para cambios micro: ✅
+   • Numeración de specs: fecha
+   • Requiere aprobación de plan: ✅
+
+🎯 CALIDAD:
+   • Cobertura mínima: 80%
+   • Permitir warnings: ❌
+   • Función máx líneas: 50
+   • Archivo máx líneas: 400
+
+🛡️ PROTECCIONES:
+   • Archivos protegidos: .env*, secrets/**, ...
+   • Comandos prohibidos: rm -rf /, DROP DATABASE, ...
+```
+
+## PASO 4 — Modo: Cambiar agentes
+
+```
+🤖 Agentes disponibles:
+
+   1. [✅] arquitecto             (opus)
+   2. [✅] disenador-api          (sonnet)
+   3. [✅] asesor-datos           (opus)
+   4. [✅] desarrollador-backend  (sonnet)
+   5. [❌] desarrollador-frontend (sonnet)
+   6. [✅] operaciones            (sonnet)
+   7. [✅] tester                 (sonnet)
+   8. [✅] revisor                (opus)
+   9. [✅] critico                (opus)
+   10.[✅] seguridad              (opus)
+   11.[❌] documentador           (sonnet)
+
+¿Qué número quieres activar/desactivar? (o "todos", "ninguno")
+```
+
+Cuando el usuario selecciona, tooglea el estado y guarda.
+
+## PASO 5 — Modo: Cambiar modelos
+
+Para cada agente, ofrece elegir modelo con recomendación:
+
+```
+Agente: arquitecto
+Modelo actual: opus
+
+📊 RECOMENDACIÓN: opus
+   Razón: Las decisiones de arquitectura son difíciles de revertir.
+          Usar el modelo más capaz reduce errores costosos.
+
+Opciones:
+   1. opus      ← recomendado
+   2. sonnet    (más barato, OK para proyectos simples)
+   3. haiku     (no recomendado para este rol)
+
+¿Qué modelo?
+```
+
+Aplica los nombres específicos según las recomendaciones por agente:
+
+| Agente | Recomendado | Alternativa OK | Evitar |
+|--------|-------------|----------------|--------|
+| arquitecto | opus | sonnet (proyectos chicos) | haiku |
+| disenador-api | sonnet | opus (APIs complejas) | haiku |
+| asesor-datos | opus | sonnet (BD simple) | haiku |
+| desarrollador-backend | sonnet | opus (lógica compleja) | haiku |
+| desarrollador-frontend | sonnet | opus (UI compleja) | haiku |
+| operaciones | sonnet | haiku (scripts simples) | — |
+| tester | sonnet | haiku (tests simples) | opus (overkill) |
+| revisor | opus | sonnet | haiku |
+| critico | opus | sonnet | haiku |
+| seguridad | opus | — | sonnet, haiku |
+| documentador | sonnet | haiku | opus (overkill) |
+
+## PASO 6 — Guardar cambios
+
+```bash
+# Reescribir .sdd/sdd.config.yaml con los cambios
+# Mostrar diff de cambios al usuario
+```
+
+## PASO 7 — Reportar
+
+```
+✅ Configuración actualizada
+📁 .sdd/sdd.config.yaml
+
+CAMBIOS:
+   ~ agentes.desarrollador-frontend.activo: false → true
+   ~ agentes.tester.modelo: sonnet → haiku
+
+Los cambios se aplican a la próxima ejecución de comandos SDD.
+```
+
+## Modo asistente: Recomendar configuración
+
+Si el usuario escribe `/sdd.configurar recomendar`:
+
+1. Lee la constitución y detecta el tipo de proyecto
+2. Sugiere un conjunto de agentes y modelos óptimo
+3. Muestra al usuario y pide confirmación
+
+Ejemplos:
+- **API REST simple** → desactivar `desarrollador-frontend`
+- **SPA sin backend** → desactivar `desarrollador-backend`, `asesor-datos`, `disenador-api`
+- **MVP / Side project** → bajar modelos a sonnet en todos, mantener opus solo en revisor
+- **Producto enterprise** → mantener opus en todos los críticos
+- **Solo prototipo** → desactivar `critico`, `seguridad`, bajar todo a sonnet/haiku