@saulwade/swl-ses 1.8.0 → 2.0.0

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.0"
+version: "1.2.1"
 herramientasPermitidas: [Read, Write, Edit, Bash, Glob, Grep]
 exclusiones:
   - "No cargar para editar reglas globales en ~/.claude/rules/ — usar Edit directo."
@@ -148,19 +148,11 @@ secciones faltantes pero NO sobreescribe.
 
 ### Template
 
-Ver template completo en el comando `/swl:claudemd` sección `init-user`.
-
-Las secciones canónicas para user-level son DISTINTAS de project-level:
-
-| Sección | Project-level | User-level |
-|---|---|---|
-| Stack | Sí — del proyecto | No (varía por proyecto) |
-| Comandos | Sí — del proyecto | No |
-| Code style | Sí — convenciones del equipo | Sí — preferencias personales (indent, naming favorito) |
-| Conventions | Sí — del proyecto | No |
-| Mi rol y stack preferido | No | Sí |
-| Estilo de comunicación | No | Sí |
-| Patrones que aplico siempre | No | Sí — meta-preferencias cross-project |
+Las secciones canónicas user-level son DISTINTAS de project-level (Stack y
+Comandos no aplican; sí aplican rol, estilo de comunicación y meta-preferencias).
+Tabla comparativa completa y template: ver
+[plantillas-init](recursos/plantillas-init.md) y el comando `/swl:claudemd`
+sección `init-user`.
 
 ---
 
@@ -182,222 +174,70 @@ Genera `./CLAUDE.md` raíz del proyecto detectando stack actual.
    - **Comandos**: npm scripts detectados o comandos típicos por lenguaje
    - **Code style**: placeholders explícitos (`<!-- pendiente: definir convención de X -->`)
    - **Conventions**: placeholders explícitos
+   - **SWL es tooling (frontera de versionado)** — bloque exacto definido abajo.
+     OBLIGATORIO cuando el proyecto destino NO es el repo madre de swl-ses (es
+     decir, siempre en `init-project` sobre un proyecto del usuario). Mantiene
+     el CLAUDE.md consistente con la sección swl-ses del `.gitignore`.
    - **@references**: enlazar a `.planning/PROYECTO.md`, `README.md`,
      `CONTRIBUTING.md` solo si existen
 4. Imprimir mensaje con próximo paso: "ejecuta `/swl:claudemd audit`
    para verificar".
 
-### Bloque obligatorio Karpathy en init-project
+### Bloques literales de init-project
 
-Toda generación nueva incluye esta sub-sección literal en "Reglas de
-máxima prioridad":
-
-```markdown
-### Cuatro principios de implementación (Karpathy)
-Antes de implementar, refactorizar o corregir bugs: (1) **pensar antes de codificar** (no asumir en silencio), (2) **simplicidad primero** (sin abstracciones especulativas), (3) **cambios quirúrgicos** (leer archivo completo antes de editar, no refactor de oportunidad), (4) **ejecución orientada a metas** (criterios verificables, test que reproduce bugs antes del fix). Detalle + 9 ejemplos MAL→BIEN: `Skill("prevencion-sobreingenieria")` + `recursos/EXAMPLES.md`.
-```
+Los dos bloques OBLIGATORIOS que toda generación nueva inserta literal viven en
+[plantillas-init](recursos/plantillas-init.md) (fuente de verdad de los templates):
 
-Justificación: el skill `prevencion-sobreingenieria` y su `recursos/EXAMPLES.md`
-se distribuyen con cada instalación SWL, así que la referencia siempre resuelve.
-La sub-sección compacta (5 líneas) ataca los gaps cognitivos más frecuentes
-de cualquier proyecto sin agregar opinión específica.
+- **Bloque SWL-tooling (frontera de versionado)**: documenta en el CLAUDE.md del
+  proyecto destino qué archivos son runtime gitignored (gestionado por
+  `scripts/lib/gitignore-manifest.js`) vs qué versiona el equipo. Si
+  `ENTRADAS_BASE` cambia, el bloque del recurso se actualiza en sync.
+- **Bloque Karpathy (4 principios)**: sub-sección compacta en "Reglas de máxima
+  prioridad" que referencia `Skill("prevencion-sobreingenieria")` (siempre
+  resuelve — se distribuye con cada instalación SWL).
 
-### Check Karpathy en audit
-
-`scripts/auditar-claudemd.js` debe verificar (search regex case-insensitive):
-
-- `/karpathy/i`
-- `/cuatro principios/i` o `/4 principios/i`
-- `/prevencion-sobreingenieria/`
-- `/Skill\(["'`]prevencion-sobreingenieria["'`]\)/`
-
-Si NO encuentra ninguna AND el archivo tiene >50 LOC AND es project-level
-(no `~/.claude/CLAUDE.md`): emitir hallazgo WARN con mensaje:
-
-```
-CLAUDE.md no menciona los cuatro principios Karpathy ni el skill
-prevencion-sobreingenieria. Considerar agregar la sub-sección compacta
-(ver /swl:claudemd init-project § Bloque obligatorio Karpathy).
-```
-
-Esta dimensión es WARN, no ERROR — guía sin imponer. CLAUDE.md user-level
-(`~/.claude/`) NO se evalúa contra este check.
+El recurso incluye también el **check Karpathy del auditor** (regex, condiciones
+y mensaje WARN — project-level >50 LOC sin mención a los 4 principios).
 
 ---
 
 ## Interacción con /swl:aprender (contrato cruzado)
 
-`/swl:aprender` y `/swl:claudemd` operan sobre el mismo archivo desde
-ángulos opuestos: aprender **muta**, claudemd **prescribe contrato**.
-Sin coordinación explícita, una sesión de aprender puede romper el
-contrato silenciosamente.
-
-### El gap arquitectural que esta interacción cierra
-
-`/swl:aprender` Paso 6 Tipo A agrega reglas a `CLAUDE.md` del proyecto.
-El hook `claudemd-bloat-detector.js` (PostToolUse, async, no bloqueante)
-emite nudge tras Write/Edit/MultiEdit sobre CLAUDE.md, pero **el nudge
-llega después** del comando de aprender. Resultado: aprender termina,
-reporta éxito al usuario, y solo después aparece el nudge — con el
-commit ya hecho.
-
-Origen detectado: sesión 2026-05-22 al evaluar el flujo SIGAF→swl-ses.
-CLAUDE.md SIGAF recibió ~25 líneas inline de "Triangulación schema
-cross-stack" sin validación post-mutación → archivo probablemente
-superó el umbral de 200 LOC sin warning consciente.
-
-### Contrato canónico de interacción
-
-Para cualquier comando SWL que escriba a CLAUDE.md del proyecto
-(`/swl:aprender`, `/swl:adoptar-proyecto`, `/swl:nuevo-proyecto`,
-`/swl:claudemd init-project`, futuros comandos similares):
+`/swl:aprender` **muta** CLAUDE.md; `/swl:claudemd` **prescribe contrato**.
+Todo comando SWL que escriba a CLAUDE.md del proyecto (`aprender`,
+`adoptar-proyecto`, `nuevo-proyecto`, `claudemd init-project`, futuros) DEBE
+ejecutar el auditor síncrono tras escribir (`node scripts/auditar-claudemd.js
+--json`), evaluar el veredicto (OK→continuar; WARN→proponer condensar/extraer;
+`ERROR placeholders`→**DETENER y revertir**) y re-auditar hasta OK/WARN aceptable.
 
-1. **Antes de escribir**: opcional, pero recomendado — leer el tamaño
-   actual del archivo y estimar el delta.
-2. **Después de escribir**: OBLIGATORIO ejecutar el auditor síncrono:
+Doble red: capa síncrona (Paso 6.5 de aprender — proactiva, bloquea el comando)
++ capa async (hook `claudemd-bloat-detector.js` — nudge universal para
+escrituras fuera de comandos SWL). NO crear hook nuevo dedicado — duplicaría el
+existente.
 
-   ```bash
-   node scripts/auditar-claudemd.js --json
-   # o fallback:
-   npx -y @saulwade/swl-ses@latest audit-claudemd --json
-   ```
-
-3. **Evaluar veredicto**:
-   - `OK` → continuar
-   - `WARN tamano-total` → proponer condensar o extraer a `@docs/lessons-<tema>.md`
-   - `WARN bullet-gigante` → proponer condensar a tabla/lista jerárquica
-   - `WARN secciones-canonicas` / `WARN sin-at-references` / `WARN karpathy-reference` → reportar al usuario, permitir continuar
-   - `ERROR placeholders` → **DETENER** y revertir
-
-4. **Re-ejecutar el auditor** tras la corrección hasta veredicto OK o
-   WARN aceptable.
-
-### Doble red de seguridad
-
-El sistema tiene dos capas de protección complementarias:
-
-| Capa | Mecanismo | Cuándo actúa | Bloqueo |
-|------|-----------|--------------|---------|
-| Síncrona | Paso 6.5 de `/swl:aprender` (y equivalente en otros comandos) | Justo después del Write/Edit, antes del reporte final | Bloquea pasos posteriores hasta resolver |
-| Asíncrona | Hook `claudemd-bloat-detector.js` (PostToolUse) | Tras cualquier Write/Edit/MultiEdit a CLAUDE.md (incluso fuera de comandos SWL) | No bloquea — emite nudge a `.planning/evolution/nudges.jsonl` |
-
-La capa síncrona es proactiva (detiene el comando antes de reportar
-éxito). La asíncrona es retroactiva (cubre escrituras desde fuera de
-comandos SWL, ej. edición manual).
-
-### Por qué NO se duplica al hook
-
-El hook async existente cubre el caso de escrituras desde **cualquier
-fuente** (edición manual del usuario, otros comandos, scripts externos).
-Es la red de seguridad universal. La validación síncrona en aprender es
-específica para el flujo del comando — donde el agente puede actuar
-sobre el WARN antes de continuar.
-
-NO crear un hook nuevo dedicado a aprender — duplicaría el rol del
-existente. La invocación síncrona en el Paso 6.5 es suficiente.
-
-### Reglas duras
-
-- `/swl:aprender` Paso 6.5 es OBLIGATORIO si se aplicó Tipo A.
-- `/swl:adoptar-proyecto` Paso 8 debe ejecutar el auditor tras
-  generar/modificar CLAUDE.md.
-- `/swl:nuevo-proyecto` Paso 6 debe ejecutar el auditor tras generar
-  CLAUDE.md inicial.
-- `/swl:claudemd init-project` debe ejecutar el auditor sobre el
-  archivo recién generado.
-
-Cualquier comando futuro que escriba a CLAUDE.md DEBE seguir este
-contrato.
-
----
+Detalle completo (gap arquitectural de origen, contrato canónico de 4 pasos,
+tabla de capas, reglas duras por comando): ver
+[contrato-aprender](recursos/contrato-aprender.md).
 
 ---
 
 ## Detección de duplicación de reglas globales (dimensión 8)
 
-### Por qué existe
-
-Las reglas en `~/.claude/rules/` se cargan automáticamente en cada
-sesión SWL. Si un proyecto duplica inline el contenido de esas reglas
-en su `CLAUDE.md`, ocurren tres patologías:
-
-1. **Bloat acumulativo**: 7-15 líneas por regla duplicada × N proyectos
-   = inflación silenciosa que rompe el umbral de 200 LOC.
-2. **Drift al actualizar la global**: si la regla global cambia, las
-   copias en cada CLAUDE.md quedan obsoletas sin alerta.
-3. **Erosión del contrato canónico**: cada CLAUDE.md re-deriva el
-   principio con palabras propias, generando 4 paráfrasis distintas
-   del mismo contenido.
-
-La regla `reglas/sin-duplicacion-reglas-globales.md` (v1.7.0) prohíbe
-esta duplicación. Esta dimensión del auditor la detecta.
-
-### Catálogo declarativo
-
-`scripts/lib/reglas-globales-conocidas.json` lista las reglas globales
-conocidas con sus patrones de detección. Estructura por entrada:
-
-```json
-{
-  "id": "idioma-espanol-mexico",
-  "regla_global": "brevedad-output.md",
-  "seccion_canonica": "Idioma obligatorio: español de México",
-  "referencia_canonica": "@~/.claude/rules/brevedad-output.md § Idioma obligatorio",
-  "patrones": ["\\bespañol\\s+de\\s+M[ée]xico\\b", "..."],
-  "min_matches": 2,
-  "remediacion_sugerida": "Eliminar el bloque local..."
-}
-```
-
-Reglas incluidas en v1.7.0:
-
-- `idioma-espanol-mexico` (brevedad-output.md § Idioma)
-- `brevedad-sin-aiisms` (brevedad-output.md § Brevedad)
-- `git-sin-coautores` (git-coauthor.md)
-- `arreglar-al-detectar` (arreglar-al-detectar.md)
-- `debatir-antes-de-aceptar` (debatir-antes-de-aceptar.md)
-- `usar-context7` (usar-context7.md)
-
-### Cuándo NO se evalúa
-
-- **User-level** (`~/.claude/CLAUDE.md`): ahí sí pueden declararse
-  preferencias personales que parafrasean reglas globales. La opción
-  `esUserLevel: true` skipea la evaluación.
-- **Archivos < 20 LOC**: CLAUDE.md mínimos no acumulan duplicaciones
-  con suficiente densidad para evaluar.
-
-### Capa async — hook
-
-`hooks/claudemd-duplicacion-detector.js` (PostToolUse, no bloquea)
-ejecuta el detector tras cualquier Write/Edit a CLAUDE.md y emite
-nudge a `.planning/evolution/nudges.jsonl` con `kind:
-claudemd-duplicacion-reglas`. Opt-out: `SWL_CLAUDEMD_DUPLICACION=0`.
-
-### Cómo refactorizar duplicaciones detectadas
-
-Tres opciones para cada hallazgo:
-
-1. **Eliminar** (default recomendado): el bloque solo repite la regla
-   global, eliminarlo no pierde información.
-2. **Convertir a matiz local** (≤3 líneas): si el bloque agrega valor
-   local genuino, reescribirlo corto referenciando la regla global:
-   ```markdown
-   Convenciones locales: identificadores técnicos en inglés (rutas,
-   comandos). Ver @~/.claude/rules/brevedad-output.md.
-   ```
-3. **Documentar override explícito** (raro): si el proyecto contradice
-   la regla global por requerimiento documentable:
-   ```markdown
-   Override de @~/.claude/rules/brevedad-output.md § Brevedad: este
-   proyecto exige docstrings extendidos por compliance regulatorio.
-   ```
-
-### Anti-patrón: "lo dejo por claridad"
-
-La regla global YA es visible — se carga automáticamente. Duplicarla
-no aumenta su prioridad ni su claridad; solo crea deuda. Si el WARN
-del auditor incomoda, la respuesta correcta es **resolver la
-duplicación**, no aceptar el WARN.
+Las reglas de `~/.claude/rules/` se cargan automáticamente en cada sesión;
+duplicarlas inline en un CLAUDE.md de proyecto produce bloat, drift al
+actualizar la global y erosión del contrato (regla
+`reglas/sin-duplicacion-reglas-globales.md`). El auditor lo detecta con el
+catálogo declarativo `scripts/lib/reglas-globales-conocidas.json` (6 reglas en
+v1.7.0); la capa async es `hooks/claudemd-duplicacion-detector.js` (opt-out
+`SWL_CLAUDEMD_DUPLICACION=0`). NO se evalúa user-level ni archivos <20 LOC.
+
+Remediación por hallazgo: **eliminar** (default), **matiz local** ≤3 líneas
+referenciando la global, u **override explícito** documentado. Anti-patrón:
+"lo dejo por claridad" — la global ya es visible; duplicar solo crea deuda.
+
+Detalle completo (patologías, estructura del catálogo, ejemplos de
+remediación): ver
+[duplicacion-reglas-globales](recursos/duplicacion-reglas-globales.md).
 
 ---
 

package/habilidades/swl-claudemd/recursos/contrato-aprender.md

@@ -0,0 +1,83 @@
+# Contrato cruzado con /swl:aprender (y todo comando que escriba a CLAUDE.md)
+
+`/swl:aprender` y `/swl:claudemd` operan sobre el mismo archivo desde
+ángulos opuestos: aprender **muta**, claudemd **prescribe contrato**.
+Sin coordinación explícita, una sesión de aprender puede romper el
+contrato silenciosamente.
+
+## El gap arquitectural que esta interacción cierra
+
+`/swl:aprender` Paso 6 Tipo A agrega reglas a `CLAUDE.md` del proyecto.
+El hook `claudemd-bloat-detector.js` (PostToolUse, async, no bloqueante)
+emite nudge tras Write/Edit/MultiEdit sobre CLAUDE.md, pero **el nudge
+llega después** del comando de aprender. Resultado: aprender termina,
+reporta éxito al usuario, y solo después aparece el nudge — con el
+commit ya hecho.
+
+Origen detectado: sesión 2026-05-22 al evaluar el flujo SIGAF→swl-ses.
+CLAUDE.md SIGAF recibió ~25 líneas inline de "Triangulación schema
+cross-stack" sin validación post-mutación → archivo probablemente
+superó el umbral de 200 LOC sin warning consciente.
+
+## Contrato canónico de interacción
+
+Para cualquier comando SWL que escriba a CLAUDE.md del proyecto
+(`/swl:aprender`, `/swl:adoptar-proyecto`, `/swl:nuevo-proyecto`,
+`/swl:claudemd init-project`, futuros comandos similares):
+
+1. **Antes de escribir**: opcional, pero recomendado — leer el tamaño
+   actual del archivo y estimar el delta.
+2. **Después de escribir**: OBLIGATORIO ejecutar el auditor síncrono:
+
+   ```bash
+   node scripts/auditar-claudemd.js --json
+   # o fallback:
+   npx -y @saulwade/swl-ses@latest audit-claudemd --json
+   ```
+
+3. **Evaluar veredicto**:
+   - `OK` → continuar
+   - `WARN tamano-total` → proponer condensar o extraer a `@docs/lessons-<tema>.md`
+   - `WARN bullet-gigante` → proponer condensar a tabla/lista jerárquica
+   - `WARN secciones-canonicas` / `WARN sin-at-references` / `WARN karpathy-reference` → reportar al usuario, permitir continuar
+   - `ERROR placeholders` → **DETENER** y revertir
+
+4. **Re-ejecutar el auditor** tras la corrección hasta veredicto OK o
+   WARN aceptable.
+
+## Doble red de seguridad
+
+El sistema tiene dos capas de protección complementarias:
+
+| Capa | Mecanismo | Cuándo actúa | Bloqueo |
+|------|-----------|--------------|---------|
+| Síncrona | Paso 6.5 de `/swl:aprender` (y equivalente en otros comandos) | Justo después del Write/Edit, antes del reporte final | Bloquea pasos posteriores hasta resolver |
+| Asíncrona | Hook `claudemd-bloat-detector.js` (PostToolUse) | Tras cualquier Write/Edit/MultiEdit a CLAUDE.md (incluso fuera de comandos SWL) | No bloquea — emite nudge a `.planning/evolution/nudges.jsonl` |
+
+La capa síncrona es proactiva (detiene el comando antes de reportar
+éxito). La asíncrona es retroactiva (cubre escrituras desde fuera de
+comandos SWL, ej. edición manual).
+
+## Por qué NO se duplica al hook
+
+El hook async existente cubre el caso de escrituras desde **cualquier
+fuente** (edición manual del usuario, otros comandos, scripts externos).
+Es la red de seguridad universal. La validación síncrona en aprender es
+específica para el flujo del comando — donde el agente puede actuar
+sobre el WARN antes de continuar.
+
+NO crear un hook nuevo dedicado a aprender — duplicaría el rol del
+existente. La invocación síncrona en el Paso 6.5 es suficiente.
+
+## Reglas duras
+
+- `/swl:aprender` Paso 6.5 es OBLIGATORIO si se aplicó Tipo A.
+- `/swl:adoptar-proyecto` Paso 8 debe ejecutar el auditor tras
+  generar/modificar CLAUDE.md.
+- `/swl:nuevo-proyecto` Paso 6 debe ejecutar el auditor tras generar
+  CLAUDE.md inicial.
+- `/swl:claudemd init-project` debe ejecutar el auditor sobre el
+  archivo recién generado.
+
+Cualquier comando futuro que escriba a CLAUDE.md DEBE seguir este
+contrato.

package/habilidades/swl-claudemd/recursos/duplicacion-reglas-globales.md

@@ -0,0 +1,85 @@
+# Dimensión 8 — Detección de duplicación de reglas globales
+
+## Por qué existe
+
+Las reglas en `~/.claude/rules/` se cargan automáticamente en cada
+sesión SWL. Si un proyecto duplica inline el contenido de esas reglas
+en su `CLAUDE.md`, ocurren tres patologías:
+
+1. **Bloat acumulativo**: 7-15 líneas por regla duplicada × N proyectos
+   = inflación silenciosa que rompe el umbral de 200 LOC.
+2. **Drift al actualizar la global**: si la regla global cambia, las
+   copias en cada CLAUDE.md quedan obsoletas sin alerta.
+3. **Erosión del contrato canónico**: cada CLAUDE.md re-deriva el
+   principio con palabras propias, generando 4 paráfrasis distintas
+   del mismo contenido.
+
+La regla `reglas/sin-duplicacion-reglas-globales.md` (v1.7.0) prohíbe
+esta duplicación. Esta dimensión del auditor la detecta.
+
+## Catálogo declarativo
+
+`scripts/lib/reglas-globales-conocidas.json` lista las reglas globales
+conocidas con sus patrones de detección. Estructura por entrada:
+
+```json
+{
+  "id": "idioma-espanol-mexico",
+  "regla_global": "brevedad-output.md",
+  "seccion_canonica": "Idioma obligatorio: español de México",
+  "referencia_canonica": "@~/.claude/rules/brevedad-output.md § Idioma obligatorio",
+  "patrones": ["\\bespañol\\s+de\\s+M[ée]xico\\b", "..."],
+  "min_matches": 2,
+  "remediacion_sugerida": "Eliminar el bloque local..."
+}
+```
+
+Reglas incluidas en v1.7.0:
+
+- `idioma-espanol-mexico` (brevedad-output.md § Idioma)
+- `brevedad-sin-aiisms` (brevedad-output.md § Brevedad)
+- `git-sin-coautores` (git-coauthor.md)
+- `arreglar-al-detectar` (arreglar-al-detectar.md)
+- `debatir-antes-de-aceptar` (debatir-antes-de-aceptar.md)
+- `usar-context7` (usar-context7.md)
+
+## Cuándo NO se evalúa
+
+- **User-level** (`~/.claude/CLAUDE.md`): ahí sí pueden declararse
+  preferencias personales que parafrasean reglas globales. La opción
+  `esUserLevel: true` skipea la evaluación.
+- **Archivos < 20 LOC**: CLAUDE.md mínimos no acumulan duplicaciones
+  con suficiente densidad para evaluar.
+
+## Capa async — hook
+
+`hooks/claudemd-duplicacion-detector.js` (PostToolUse, no bloquea)
+ejecuta el detector tras cualquier Write/Edit a CLAUDE.md y emite
+nudge a `.planning/evolution/nudges.jsonl` con `kind:
+claudemd-duplicacion-reglas`. Opt-out: `SWL_CLAUDEMD_DUPLICACION=0`.
+
+## Cómo refactorizar duplicaciones detectadas
+
+Tres opciones para cada hallazgo:
+
+1. **Eliminar** (default recomendado): el bloque solo repite la regla
+   global, eliminarlo no pierde información.
+2. **Convertir a matiz local** (≤3 líneas): si el bloque agrega valor
+   local genuino, reescribirlo corto referenciando la regla global:
+   ```markdown
+   Convenciones locales: identificadores técnicos en inglés (rutas,
+   comandos). Ver @~/.claude/rules/brevedad-output.md.
+   ```
+3. **Documentar override explícito** (raro): si el proyecto contradice
+   la regla global por requerimiento documentable:
+   ```markdown
+   Override de @~/.claude/rules/brevedad-output.md § Brevedad: este
+   proyecto exige docstrings extendidos por compliance regulatorio.
+   ```
+
+## Anti-patrón: "lo dejo por claridad"
+
+La regla global YA es visible — se carga automáticamente. Duplicarla
+no aumenta su prioridad ni su claridad; solo crea deuda. Si el WARN
+del auditor incomoda, la respuesta correcta es **resolver la
+duplicación**, no aceptar el WARN.

package/habilidades/swl-claudemd/recursos/plantillas-init.md

@@ -0,0 +1,94 @@
+# Plantillas literales de init-project / init-user
+
+Bloques exactos que `/swl:claudemd init-project` inserta en el CLAUDE.md
+generado. Este recurso es la fuente de verdad de los templates — el SKILL.md
+los referencia sin duplicarlos.
+
+---
+
+## Bloque obligatorio SWL-tooling (init-project)
+
+Toda generación nueva en un proyecto destino incluye esta sub-sección literal
+(empareja el CLAUDE.md con la sección swl-ses del `.gitignore` — gestionada por
+`scripts/lib/gitignore-manifest.js`). Sin ella, un compañero del equipo no sabe
+qué archivos son del proyecto y cuáles son runtime de la herramienta:
+
+```markdown
+## SWL es tooling de desarrollo (frontera de versionado)
+
+Este proyecto usa [swl-ses](https://www.npmjs.com/package/@saulwade/swl-ses) como
+herramienta de desarrollo. Lo que SWL instala y genera **no forma parte del
+proyecto** y está en `.gitignore` (sección `# [swl-ses:inicio]`): `.claude/`
+(framework), `hooks/`, `instintos/`, `usage.db` y el runtime bajo `.planning/`
+(APRENDIZAJES, métricas, sesiones, traces, evolution, loops, locks, feature-list,
+caches del grafo, etc.).
+
+SÍ se versionan (los edita el equipo): `CLAUDE.md`, `.claude/settings.json`, el
+manifest `.swl-ses`, y las plantillas de `.planning/` — `PROYECTO.md`,
+`REQUISITOS.md`, `HOJA-RUTA.md`, `ESTADO.md`, `research/`, `adrs/`, y los
+`fases/0N-{CONTEXTO,PLAN,RESUMEN,VERIFICACION}.md`.
+
+Reinstalar/actualizar el tooling: `npx -y @saulwade/swl-ses@latest install`.
+```
+
+Justificación: la lista de qué se ignora vs qué se commitea es la **fuente de
+verdad** de `gitignore-manifest.js`. Replicarla en prosa en el CLAUDE.md del
+proyecto cierra el gap de "el .gitignore lo sabe pero el humano que lee CLAUDE.md
+no". Mantener ambas en sync: si `ENTRADAS_BASE` cambia, este bloque se actualiza.
+
+---
+
+## Bloque obligatorio Karpathy (init-project)
+
+Toda generación nueva incluye esta sub-sección literal en "Reglas de
+máxima prioridad":
+
+```markdown
+### Cuatro principios de implementación (Karpathy)
+Antes de implementar, refactorizar o corregir bugs: (1) **pensar antes de codificar** (no asumir en silencio), (2) **simplicidad primero** (sin abstracciones especulativas), (3) **cambios quirúrgicos** (leer archivo completo antes de editar, no refactor de oportunidad), (4) **ejecución orientada a metas** (criterios verificables, test que reproduce bugs antes del fix). Detalle + 9 ejemplos MAL→BIEN: `Skill("prevencion-sobreingenieria")` + `recursos/EXAMPLES.md`.
+```
+
+Justificación: el skill `prevencion-sobreingenieria` y su `recursos/EXAMPLES.md`
+se distribuyen con cada instalación SWL, así que la referencia siempre resuelve.
+La sub-sección compacta (5 líneas) ataca los gaps cognitivos más frecuentes
+de cualquier proyecto sin agregar opinión específica.
+
+---
+
+## Check Karpathy en audit
+
+`scripts/auditar-claudemd.js` debe verificar (search regex case-insensitive):
+
+- `/karpathy/i`
+- `/cuatro principios/i` o `/4 principios/i`
+- `/prevencion-sobreingenieria/`
+- `/Skill\(["'`]prevencion-sobreingenieria["'`]\)/`
+
+Si NO encuentra ninguna AND el archivo tiene >50 LOC AND es project-level
+(no `~/.claude/CLAUDE.md`): emitir hallazgo WARN con mensaje:
+
+```
+CLAUDE.md no menciona los cuatro principios Karpathy ni el skill
+prevencion-sobreingenieria. Considerar agregar la sub-sección compacta
+(ver /swl:claudemd init-project § Bloque obligatorio Karpathy).
+```
+
+Esta dimensión es WARN, no ERROR — guía sin imponer. CLAUDE.md user-level
+(`~/.claude/`) NO se evalúa contra este check.
+
+---
+
+## Secciones canónicas: project-level vs user-level (init-user)
+
+| Sección | Project-level | User-level |
+|---|---|---|
+| Stack | Sí — del proyecto | No (varía por proyecto) |
+| Comandos | Sí — del proyecto | No |
+| Code style | Sí — convenciones del equipo | Sí — preferencias personales (indent, naming favorito) |
+| Conventions | Sí — del proyecto | No |
+| Mi rol y stack preferido | No | Sí |
+| Estilo de comunicación | No | Sí |
+| Patrones que aplico siempre | No | Sí — meta-preferencias cross-project |
+
+El template completo de user-level vive en el comando `/swl:claudemd`
+sección `init-user`.

package/habilidades/swl-dashboard/SKILL.md

@@ -11,8 +11,8 @@ user-invocable: false
 version: "1.0.0"
 herramientasPermitidas: [Read, Bash, Glob]
 exclusiones:
-  - "No cargar para ver métricas de la sesión actual en tiempo real — usar `/swl:metricas`; este skill requiere datos históricos de múltiples sesiones en `~/.claude/projects/**/*.jsonl`."
-  - "No cargar si `claude-usage` no está disponible y el objetivo es solo verificar el estado del sistema SWL — usar `/swl:salud` que no depende de la instalación de la herramienta vendor."
+  - "No cargar para ver métricas de la sesión actual en tiempo real — usar `/swl:status metricas`; este skill requiere datos históricos de múltiples sesiones en `~/.claude/projects/**/*.jsonl`."
+  - "No cargar si `claude-usage` no está disponible y el objetivo es solo verificar el estado del sistema SWL — usar `/swl:status salud` que no depende de la instalación de la herramienta vendor."
   - "No cargar para diagnosticar por qué un agente falló — este skill muestra métricas de tokens y costos, no trazas de error de agentes; para eso usar `tracing-processor` o revisar `.planning/traces/`."
   - "No cargar en entornos CI/headless donde no hay browser para abrir el dashboard web — usar el subcomando `stats` o `today` que salen en terminal sin servidor HTTP."
 evolvable: true  # default para skill estandar
@@ -42,7 +42,7 @@ Si Python < 3.8 o no está disponible:
 ```
 ⚠ swl-dashboard requiere Python 3.8+. No se encontró intérprete compatible.
    Instala Python desde https://python.org o usa: winget install Python.Python.3
-   Alternativa: usa /swl:metricas para métricas de la sesión actual.
+   Alternativa: usa /swl:status metricas para métricas de la sesión actual.
 ```
 Detener y mostrar el mensaje anterior.
 
@@ -103,7 +103,7 @@ Si el resultado es `MISSING` después de los cuatro intentos:
    Esto copia claude-usage a ~/.claude/scripts/vendor/claude-usage/ y lo hace
    disponible en todos los proyectos automáticamente.
 
-   Alternativa inmediata: /swl:metricas para métricas de la sesión actual.
+   Alternativa inmediata: /swl:status metricas para métricas de la sesión actual.
 ```
 
 > **Nota**: guardar `CLI_PY` y el directorio padre `VENDOR_DIR=$(dirname "$CLI_PY")` para usarlos en el Paso 2.
@@ -155,7 +155,7 @@ echo "✓ Base de datos actualizada: ~/.claude/usage.db"
 
 `cli.py` detecta automáticamente el primer puerto libre (8888 → 9090 → 9191 …).
 **Nota:** 8080 está excluido intencionalmente — suele estar ocupado por Postgres, IIS u otros servicios.
-Si el usuario especificó un puerto con `/swl:dashboard --port 9090`, pasarlo explícitamente.
+Si el usuario especificó un puerto con `/swl:status dashboard --port 9090`, pasarlo explícitamente.
 
 **IMPORTANTE:** No verificar disponibilidad con `curl http://localhost:8080` — ese puerto puede estar
 ocupado por otro servicio y devolvería un falso positivo. Usar el flujo siguiente:
@@ -331,7 +331,7 @@ const w = obtenerWidget('health-score');
 
 ### Integración futura en la salida del comando
 
-Al generar la salida de `/swl:dashboard`, iterar el layout default del modo detectado
+Al generar la salida de `/swl:status dashboard`, iterar el layout default del modo detectado
 y renderizar cada widget con su categoría como sección:
 
 ```javascript
@@ -350,15 +350,15 @@ comando. El catálogo solo define la estructura — no accede a fuentes de datos
 | Componente SWL | Scope | Complemento |
 |---------------|-------|-------------|
 | `tracking-costos.js` (hook) | Sesión actual, tiempo real | swl-dashboard añade histórico multi-sesión |
-| `/swl:metricas` (comando) | Sesión actual | swl-dashboard añade visualización gráfica |
+| `/swl:status metricas` (comando) | Sesión actual | swl-dashboard añade visualización gráfica |
 | `.planning/METRICAS.md` | Persistencia por proyecto | swl-dashboard agrega consulta SQL cross-project |
 | `resumen-sesion.js` (hook) | Resumen inline al Stop | swl-dashboard añade análisis post-hoc detallado |
 | `guardrail-metrics.js` (lib) | Sesión actual | swl-dashboard `guardrails` muestra activaciones/bloqueos por hook |
 
 ## Cuándo NO cargar
 
-- El usuario quiere ver métricas de la sesión activa actual — usar `/swl:metricas`; este skill procesa el historial persisitido en `~/.claude/projects/`, no el stream en tiempo real de la sesión.
-- `claude-usage` no está instalado y el objetivo es diagnosticar la salud del sistema SWL — usar `/swl:salud`; no tiene sentido cargar este skill si la única acción posible sería indicar que hay que instalar la herramienta vendor.
+- El usuario quiere ver métricas de la sesión activa actual — usar `/swl:status metricas`; este skill procesa el historial persisitido en `~/.claude/projects/`, no el stream en tiempo real de la sesión.
+- `claude-usage` no está instalado y el objetivo es diagnosticar la salud del sistema SWL — usar `/swl:status salud`; no tiene sentido cargar este skill si la única acción posible sería indicar que hay que instalar la herramienta vendor.
 - Se ejecuta en un entorno CI/headless o en un servidor remoto sin browser — los subcomandos `today` y `stats` funcionan en terminal, pero si el objetivo era el dashboard web interactivo, ese entorno no lo soporta.
 - Se busca trazar el motivo de fallo de un agente específico — este skill visualiza consumo de tokens y costos; los detalles de error de agente están en `.planning/traces/` y se analizan con `tracing-processor`.
 

package/habilidades/swl-revisar-impacto/SKILL.md

@@ -213,7 +213,7 @@ Invocar automáticamente este skill en estos momentos:
 
 | Componente       | Scope                          | Complemento                          |
 |------------------|--------------------------------|--------------------------------------|
-| `/swl:metricas`  | Costo/tokens de sesión actual  | revisar-impacto agrega análisis estructural |
+| `/swl:status metricas`  | Costo/tokens de sesión actual  | revisar-impacto agrega análisis estructural |
 | `calidad-pre-commit.js` | Lint + secretos pre-commit | revisar-impacto agrega risk score semántico |
 | `auto-evolucion-swl` | Mejora de agentes         | revisar-impacto prioriza por comunidades |
 | `run-log.js`     | Observabilidad de sesión       | revisar-impacto agrega contexto de código |