@saulwade/swl-ses 1.3.3 → 1.3.4

package/CLAUDE.md

@@ -1,4 +1,4 @@
-# CLAUDE.md — @saulwade/swl-ses v1.3.3
+# CLAUDE.md — @saulwade/swl-ses v1.3.4
 
 ## Reglas de máxima prioridad (aplican SIEMPRE, sin excepción)
 

package/README.md

@@ -1,4 +1,4 @@
-# swl-ses v1.3.3
+# swl-ses v1.3.4
 
 > El paquete anterior `@saulwadeleon/swl-software-engineering-system` está deprecado. Migrar a `@saulwade/swl-ses` (npmjs.org canónico) o `@saul-wade/swl-ses` (mirror en GitHub Packages) — el CLI `swl-ses` no cambia.
 

package/habilidades/swl-claudemd/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: swl-claudemd
-description: Tratamiento profesional de CLAUDE.md según best practices Anthropic (ADR-0016). Cubre auditoría (líneas totales, bullets gigantes, secciones canónicas, @references, placeholders), refactor (extracción a archivos referenciados con @), generación de templates (init-user para preferencias personales transversales en ~/.claude/CLAUDE.md, init-project para CLAUDE.md raíz del proyecto detectando stack). Cargar cuando se invoque /swl:claudemd o cuando el hook claudemd-bloat-detector sugiera intervención.
-version: "1.0.0"
+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.0.1"
 herramientasPermitidas: [Read, Write, Edit, Bash, Glob, Grep]
 exclusiones:
   - "No cargar para editar reglas globales en ~/.claude/rules/ — usar Edit directo."

package/hooks/extraccion-aprendizajes.js

@@ -623,6 +623,17 @@ const PATRONES_ARCHIVO_SWL_EXCLUIDO = [
   /[\\/]INSTALACION\.md$/i,
   /[\\/]INVENTARIO\.md$/i,
   /[\\/]SALUD\.md$/i,
+  // Artefactos meta del flujo de release/planning. Su contenido suele
+  // ser narrativa de proceso (estructura, headings, listas) que el hook
+  // confunde con aprendizajes genuinos. Ver L-NN (2026-05-11) en
+  // APRENDIZAJES.md sobre el bug recurrente del placeholder generado.
+  /[\\/]RELEASE-NOTES[-_].*\.md$/i,
+  /[\\/]RELEASE_NOTES\.md$/i,
+  /[\\/]RESUMEN\.md$/i,
+  /[\\/]PLAN\.md$/i,
+  /[\\/]CONTEXTO\.md$/i,
+  /[\\/]ROADMAP.*\.md$/i,
+  /[\\/]MAPEO[_-].*\.md$/i,
   /[\\/]package\.json$/,
   /[\\/]plugin\.json$/,
   /[\\/]package-lock\.json$/,
@@ -672,6 +683,19 @@ function pareceContenidoEstructuralSwl(contexto) {
     return true;
   }
 
+  // Contexto compuesto mayoritariamente de headings sin cuerpo. Detecta
+  // placeholders auto-generados al hacer Write de archivos meta (RELEASE-NOTES,
+  // RESUMEN, PLAN) cuya estructura es solo `## Sección 1`, `## Sección 2`...
+  // sin párrafos sustantivos. Acepta tanto headings desnudos (`## Titulo`)
+  // como indentados como blockquote (`> ## Titulo`) porque el hook envuelve
+  // el contexto con `> ` antes de evaluar el resultado.
+  if (noVacias.length >= 3) {
+    const headings = noVacias.filter(l => /^(>\s*)?#{1,6}\s+\S/.test(l));
+    if (headings.length / noVacias.length > 0.6) {
+      return true;
+    }
+  }
+
   return false;
 }