@saulwade/swl-ses 2.0.0 → 2.2.0

package/habilidades/planear-fase/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: planear-fase
 description: Crea el PLAN.md ejecutable para una fase de desarrollo. Descompone la fase en tareas atómicas con dependencias explícitas, las agrupa en oleadas de ejecución paralela cuando es posible, y aplica verificación goal-backward para garantizar que el plan completo satisface los criterios de éxito definidos en CONTEXTO.md.
-version: "1.3.0"
+version: "1.3.1"
 evolved: true
 evolved-from: "1.1.0"
 evolved-at: "2026-05-10"
@@ -138,7 +138,8 @@ Usar topological sort mental: la Oleada N contiene todas las tareas cuyas
 dependencias están en oleadas anteriores.
 
 **Paso 5 — Verificación goal-backward (matriz REQ×T)**
-Cuando el CONTEXTO.md tiene criterios con ID `REQ-NN:` (formato de Fase 10+), el
+Cuando el CONTEXTO.md tiene criterios con ID `REQ-NN:` (fases 10-11) o
+`REQ-<fase>-NN:` (namespaceados por fase, fases ≥12 — DT-IDS-NAMESPACE), el
 goal-backward deja de ser pregunta abierta y se vuelve **matriz verificable**:
 
 1. Cada tarea declara `**Verifica REQ**: REQ-XX[, REQ-YY]` (qué criterios cubre).

package/habilidades/swl-claudemd/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: swl-claudemd
 description: Conocimiento operacional para auditar y mantener archivos CLAUDE.md — contrato canónico de secciones (best practices Anthropic, ADR-0016), umbrales de bloat (líneas totales, bullets gigantes, placeholders, @references rotas), reglas de extracción a archivos referenciados con @, y plantillas de inicialización (init-user para ~/.claude/CLAUDE.md, init-project para CLAUDE.md raíz detectando stack). Provee las reglas; el comando /swl:claudemd ejecuta el flujo. Cargar desde ese comando o cuando el hook claudemd-bloat-detector sugiera intervención.
-version: "1.2.1"
+version: "1.3.0"
 herramientasPermitidas: [Read, Write, Edit, Bash, Glob, Grep]
 exclusiones:
   - "No cargar para editar reglas globales en ~/.claude/rules/ — usar Edit directo."
@@ -58,12 +58,15 @@ Más dos prácticas auxiliares del video:
 Ejecuta el auditor determinista:
 
 ```bash
-node scripts/auditar-claudemd.js
-node scripts/auditar-claudemd.js --json    # para parsing
-node scripts/auditar-claudemd.js --strict  # exit 1 si WARN
+# Repo de swl-ses (script local): node scripts/auditar-claudemd.js [--json|--strict]
+# Proyecto downstream (NO existe el script local): usar el subcomando del CLI:
+npx -y @saulwade/swl-ses@latest audit-claudemd [--json|--strict]
 ```
 
-El auditor verifica ocho dimensiones:
+Regla: si `scripts/auditar-claudemd.js` no existe en el CWD, usar SIEMPRE
+`npx ... audit-claudemd` — ambas rutas ejecutan el mismo auditor.
+
+El auditor verifica nueve dimensiones (la fila `@references rotos` caza el `@reglas/...` roto downstream):
 
 | Dimensión | Regla | Severidad |
 |---|---|---|
@@ -72,6 +75,7 @@ El auditor verifica ocho dimensiones:
 | Bullets monolíticos | Cada bullet/párrafo ≤ `SWL_CLAUDEMD_MAX_BULLET_CHARS` (default 1000). Tablas y bloques de código se ignoran | WARN |
 | Secciones canónicas | Stack, Comandos, Code style, Conventions presentes | WARN |
 | @references | Archivos >80 líneas usan al menos un `@docs/...md` | WARN |
+| @references rotos | `@-include` con path relativo cuyo destino no existe (resuelto relativo al CLAUDE.md; omite `~/` y absolutas). Caza el `@reglas/...` roto en proyectos donde las reglas viven en `.claude/rules/` | WARN |
 | Placeholders | `[TBD]`, `[TODO]`, `[COMPLETAR]` | ERROR |
 | Karpathy reference | Project-level >50 LOC menciona "Karpathy", los 4 principios, o `prevencion-sobreingenieria` | WARN |
 | Duplicación reglas globales | Bloque inline parafrasea regla de `~/.claude/rules/` ya cargada globalmente (catálogo en `scripts/lib/reglas-globales-conocidas.json`) | WARN |
@@ -167,7 +171,7 @@ Genera `./CLAUDE.md` raíz del proyecto detectando stack actual.
 2. Ejecutar `detectarStackDetallado(process.cwd())` (de
    `scripts/lib/detectar-stack-detallado.js`).
 3. Generar archivo con secciones pobladas:
-   - **Reglas obligatorias**: `@reglas/usar-sistema-swl.md`
+   - **Reglas obligatorias**: mención de texto de la regla global `usar-sistema-swl.md` (auto-cargada desde `.claude/rules/`). NUNCA `@reglas/usar-sistema-swl.md` — esa ruta no existe en proyectos downstream y queda como @-include roto
    - **Reglas de máxima prioridad** con sub-sección **Cuatro principios de
      implementación (Karpathy)** — bloque exacto definido abajo
    - **Stack**: lenguaje + framework + ORM + package manager detectados