@saulwade/swl-ses 2.1.0 → 2.2.1

package/habilidades/postgresql-experto/SKILL.md

@@ -2,11 +2,6 @@
 name: postgresql-experto
 description: PostgreSQL avanzado. JSONB, arrays, tipos personalizados, búsqueda de texto completo, window functions, CTEs recursivos, Row Level Security y funciones almacenadas.
 version: "1.2.0"
-evolved: true
-evolved-from: "1.1.0"
-evolved-at: "2026-05-20"
-evolved-by: "aprender"
-evolved-note: "4 gotchas nuevos consolidados SIGM L-152/L-153/L-156 + SIGAF 2026-05-15: race condition SELECT-then-write fuera de transaction (CONFIRMADO x4), UPDATE WHERE col1 sin dimensiones de scoping, drift triple Literal↔validator↔ENUM, partial unique index con WHERE requiere predicado puro (no subqueries)"
 herramientasPermitidas: [Read, Grep]
 exclusiones:
   - "No cargar para optimización de queries SQL (EXPLAIN ANALYZE, índices, partitioning) — para optimización cargar `sql-optimizacion`."

package/habilidades/prevencion-sobreingenieria/SKILL.md

@@ -8,11 +8,6 @@ description: >
   cuando el agente tiende a agregar abstracciones especulativas o tocar código
   fuera del alcance solicitado.
 version: "1.2.0"
-evolved: true
-evolved-from: "1.1.0"
-evolved-at: "2026-05-22"
-evolved-by: "absorcion-temp-karpathy"
-evolved-note: "Recurso nuevo: recursos/EXAMPLES.md con 9 ejemplos MAL→BIEN adaptados del repo andrej-karpathy-skills (MIT). Cierra gap de regla skills-estandar.md § Convención EXAMPLES.md."
 herramientasPermitidas: [Read, Grep]
 toolsRequeridos: Read, Grep, Glob
 exclusiones:

package/habilidades/protocolo-revision-swl/SKILL.md

@@ -10,11 +10,6 @@ description: >
   ejecutar-fase corre en modo --iterative (task por task) o cuando se solicita
   revisión acotada a un commit / patch específico.
 version: "1.0.1"
-evolved: true
-evolved-from: "1.0.0"
-evolved-at: "2026-05-16"
-evolved-by: "aprender"
-evolved-note: "v1.0.1: sección 'Validación de afirmaciones de existencia/no-existencia' formaliza regla `verificar-citas-normativas § Familia 2` aplicada a revisores. Origen: 2 falsos positivos del revisor externo en PR #28 v1.5.2."
 herramientasPermitidas: [Read, Grep, Glob, Bash]
 exclusiones:
   - "No cargar para revisión de fase completa multi-archivo — usar el flujo estándar del revisor con `/swl:revisar` y `/swl:verificar`."

package/habilidades/react-experto/SKILL.md

@@ -2,11 +2,6 @@
 name: react-experto
 description: React + Next.js mejores prácticas modernas. Cubre Server Components vs Client Components, data fetching patterns (RSC, React Query, SWR, Server Actions), state management (useState, Zustand, Jotai), performance (memo, lazy, Suspense, streaming) y Next.js App Router patterns.
 version: "1.2.0"
-evolved: true
-evolved-from: "1.1.1"
-evolved-at: "2026-05-12"
-evolved-by: "aprender"
-evolved-note: "Backport L-138 SIGM: Sidebar/menu con RBAC debe ocultar secciones cuyos items quedan todos filtrados; previo L-105 setState in useEffect"
 herramientasPermitidas: [Read]
 exclusiones:
   - "No cargar para optimización de rendimiento React (memo, useMemo, useCallback, virtualización, code splitting) — para rendimiento cargar `react-optimizacion`."

package/habilidades/release-semver/SKILL.md

@@ -2,11 +2,6 @@
 name: release-semver
 description: Versionado semántico (SemVer). Cuándo bumpar major/minor/patch, changelogs convencionales, estrategia de tags y proceso de release completo.
 version: "1.0.2"
-evolved: true
-evolved-from: "1.0.1"
-evolved-at: "2026-05-02"
-evolved-by: "aprender"
-evolved-note: "Sección nueva: publish a múltiples registries (npmjs + GitHub Packages) — republish-only pattern y auth GitHub Packages no soporta npm login"
 herramientasPermitidas: [Read, Bash]
 exclusiones:
   - "No cargar para versionar el sistema SWL — el bump de versión de swl-ses sigue el checklist de 15 ubicaciones documentado en `/swl:release`; este skill cubre SemVer general para proyectos de usuario, no el proceso interno de release del sistema."

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."
@@ -9,11 +9,6 @@ exclusiones:
   - "No cargar para validar otros archivos (.md de docs, READMEs) — solo CLAUDE.md tiene contrato canónico."
   - "No cargar para generar el bloque del installer en CLAUDE.md de proyectos destino — eso lo hace scripts/lib/transformadores/claude.js."
 evolvable: true
-evolved: true
-evolved-from: "1.1.0"
-evolved-at: "2026-05-22"
-evolved-by: "aprender"
-evolved-note: "Dimensión 8 — detección de duplicación de reglas globales (catálogo declarativo en scripts/lib/reglas-globales-conocidas.json). Refactor propone reemplazo canónico. Hook claudemd-duplicacion-detector.js complementa la capa async. Aplica regla nueva reglas/sin-duplicacion-reglas-globales.md (v1.7.0)."
 ---
 
 # Habilidad: Tratamiento profesional de CLAUDE.md
@@ -58,12 +53,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 +70,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 +166,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