@saulwade/swl-ses 1.6.7 → 1.7.0

package/agentes/orquestador-swl.md

@@ -15,7 +15,7 @@ modeloAlterno: claude-haiku-4-5-20251001
 ventanaContexto: 200k
 permissionMode: plan
 color: white
-version: 1.1.0
+version: 1.2.0
 nivelRiesgo: BAJO
 skillsInvocables: [compactacion-contexto, checkpoints-verificacion, aprendizaje-continuo, discutir-fase, ejecutar-fase, planear-fase, nuevo-proyecto, brainstorming, control-profundidad, prevencion-racionalizacion, estructura-proyecto-claude, workflow-claude-code, git-worktrees-paralelo, swl-dashboard, instalar-sistema, mapear-codebase, orquestacion-async, context-builder]
 skillsRestringidos: [fastapi-python, angular-component, angular-forms, postgresql-table-design]
@@ -124,6 +124,42 @@ paralelismo:
 La regla de paralelización del Nivel 3 sigue aplicando, pero ahora el
 orquestador DEBE invocarla explícitamente en el prompt del sub-agente.
 
+### 4. Tamaño máximo del prompt al sub-agente
+
+Los sub-agentes pueden entrar en **autocompact thrashing** cuando reciben
+prompts mayores a ~30k tokens. Síntoma observado (caso real SIGAF
+2026-05-22): tras 4 tool uses sin escribir un solo archivo, el sub-agente
+aborta con "Autocompact is thrashing: the context refilled to the limit
+within 3 turns of the previous compact, 3 times in a row".
+
+Cota dura: **prompt al sub-agente ≤ 30k tokens** (intent + constraints +
+acceptance criteria + file locations + dependencies).
+
+| Tamaño estimado del prompt | Acción |
+|----------------------------|--------|
+| < 10k tokens | Delegar normalmente |
+| 10k–30k tokens | Delegar pero monitorear; si el sub-agente tarda más de 3 turnos sin output, abortar y dividir |
+| > 30k tokens | NO delegar — dividir en sub-tareas <10k tokens cada una, o ejecutar directamente sin delegar |
+
+### Cuándo hacer el trabajo directo en lugar de delegar
+
+Cuando la spec ya está completamente clara para el orquestador, delegar
+solo agrega overhead de contexto sin valor:
+
+- **Scope < 5 archivos** con código boilerplate similar → trabajo directo.
+- **Scope ≥ 5 archivos no relacionados** con lógica específica por
+  archivo → delegar.
+- **Prompt requeriría >30k tokens** de specs/ejemplos → trabajo directo
+  (delegar es contraproducente).
+
+Regla práctica: si te encuentras escribiendo specs por más de 5 minutos
+para preparar la delegación, es señal de que el trabajo directo es más
+eficiente que la delegación.
+
+Origen del patrón: documentado en skill global `harness-claude-code`
+gotcha "Sub-agente entra en autocompact thrashing con prompts >30k tokens"
+(SIGAF 2026-05-22).
+
 ## Routing por fase + dominio (lookup tabular determinístico)
 
 Antes de delegar, **clasifica la petición** por dos ejes mecánicos en lugar de

package/comandos/swl/adoptar-proyecto.md

@@ -2,6 +2,11 @@
 name: swl:adoptar-proyecto
 description: Incorpora un proyecto existente al sistema SWL. Analiza automáticamente el codebase (stack, arquitectura, dependencias, estado git) y combina los hallazgos con una entrevista corta al usuario para generar los 9 archivos de .planning/ con información real del proyecto — no plantillas vacías.
 allowed_tools: ["Read", "Write", "Edit", "Bash", "Glob", "Grep", "Agent"]
+evolved: true
+evolved-from: "1.6.8"
+evolved-at: "2026-05-22"
+evolved-by: "aprender"
+evolved-note: "Paso 8 — validación síncrona del auditor tras modificar CLAUDE.md (contrato cruzado con /swl:claudemd)"
 ---
 
 # /swl:adoptar-proyecto — Incorporar un proyecto existente al sistema SWL
@@ -187,6 +192,29 @@ Verificar el estado de `CLAUDE.md` en la raíz del proyecto:
 Esta referencia carga la matriz operacional del sistema SWL al inicio de cada
 sesión y es el contrato base de uso del sistema para el proyecto adoptado.
 
+### Validación síncrona post-modificación (contrato cruzado con /swl:claudemd)
+
+Tras generar o modificar `CLAUDE.md` en este paso, ejecutar el auditor
+síncrono para verificar que respeta el contrato canónico:
+
+```bash
+node scripts/auditar-claudemd.js --json
+# Fallback si el script no está en el proyecto destino:
+npx -y @saulwade/swl-ses@latest audit-claudemd --json
+```
+
+Evaluar `veredicto`:
+
+- `OK` → continuar al Paso 9.
+- `WARN tamano-total` → el CLAUDE.md preexistente más la modificación
+  excedió el umbral. Reportar al usuario y proponer extracción a
+  `@docs/lessons-<tema>.md` antes de cerrar.
+- `WARN bullet-gigante` → revisar y condensar el bullet detectado.
+- `WARN` otras reglas → reportar al usuario pero permitir continuar.
+- `ERROR placeholders` → **DETENER**, revertir la modificación y reportar.
+
+Detalle del contrato cruzado en `@docs/contrato-aprender-claudemd.md`.
+
 ## Paso 9 — Reporte final
 
 ```

package/comandos/swl/aprender.md

@@ -3,10 +3,10 @@ name: swl:aprender
 description: Extrae aprendizajes de la sesión de trabajo actual. Analiza patrones de errores, decisiones y soluciones para generar nuevas reglas y habilidades que mejoran el sistema. Actualiza CLAUDE.md del proyecto y propone nuevas habilidades al sistema SWL.
 allowed_tools: ["Read", "Write", "Edit", "Bash", "Glob", "Grep"]
 evolved: true
-evolved-from: "5.12.3"
-evolved-at: "2026-04-25"
+evolved-from: "1.6.9"
+evolved-at: "2026-05-22"
 evolved-by: "aprender"
-evolved-note: "Paso 2 — filtro crítico obligatorio sobre reportes de sub-agentes Explore para evitar sobre-ingeniería al analizar papers académicos"
+evolved-note: "Paso 6.5 § Protocolo 4.5 — detección de duplicación de reglas globales tras Tipo A (regla sin-duplicacion-reglas-globales.md, v1.7.0)"
 ---
 
 # /swl:aprender — Extracción de aprendizajes y mejora del sistema
@@ -392,6 +392,145 @@ Resultado: 0/2 OK, 2 con fallos
 
 Si el verificador reporta fallo, corregir el archivo puntual (agregar bump o ejecutar `markAsEvolved()`), NO saltarse la verificación. El gap que esta verificación cierra es exactamente el que el usuario detectó al auditar la sesión de aprender del 2026-04-20: `markAsEvolved` ejecutado sin bump de `version` → cambio invisible al resto del sistema pese a que el archivo quedó protegido contra reinstalación.
 
+## Paso 6.5 — Validación de CLAUDE.md tras aplicar Tipo A (auditor síncrono)
+
+> Este paso es **OBLIGATORIO** si en Paso 6 se aplicó al menos un aprendizaje
+> Tipo A (regla agregada a `CLAUDE.md` del proyecto). El hook
+> `claudemd-bloat-detector.js` ya emite nudge async cuando se modifica
+> `CLAUDE.md`, pero el nudge llega DESPUÉS del Paso 7 — y el comando
+> habría seguido sin saber que el contrato canónico se rompió.
+>
+> Este Paso 6.5 invoca el auditor SÍNCRONAMENTE, antes de pasar a Paso 7.
+
+### Por qué existe este paso
+
+`/swl:aprender` y `/swl:claudemd` operan sobre el mismo archivo desde
+ángulos distintos: aprender **muta**, claudemd **prescribe contrato**. Sin
+validación cruzada, una sesión de aprender puede agregar 25 líneas inline
+a un CLAUDE.md que estaba en 195 LOC → resultado 220 LOC, WARN líneas,
+contrato roto silenciosamente.
+
+Origen del gap: detectado en 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).
+
+### Procedimiento
+
+Solo si en Paso 6 se aplicó al menos un Tipo A:
+
+1. **Ejecutar el auditor síncrono**:
+
+   ```bash
+   node scripts/auditar-claudemd.js --json
+   ```
+
+   Si el script no está disponible en el proyecto destino (instalación
+   global vía npm), invocar:
+
+   ```bash
+   npx -y @saulwade/swl-ses@latest audit-claudemd --json
+   ```
+
+2. **Leer el JSON de respuesta** y evaluar `veredicto`:
+
+   | Veredicto | Acción |
+   |-----------|--------|
+   | `OK` | Continuar a Paso 7. El Tipo A se aplicó respetando el contrato. |
+   | `WARN` con regla `tamano-total` (líneas > umbral) | Aplicar protocolo de extracción (sub-paso 3) |
+   | `WARN` con regla `bullet-gigante` | Aplicar protocolo de condensación (sub-paso 4) |
+   | `WARN` con regla `duplicacion-reglas-globales` | **DETENER y reformular** — el Tipo A duplica regla global. Aplicar protocolo de duplicación (sub-paso 4.5) |
+   | `WARN` con otra regla (secciones, @references, karpathy) | Reportar al usuario pero permitir continuar |
+   | `ERROR` con regla `placeholders` | **DETENER** — revertir Tipo A y reportar al usuario |
+
+3. **Protocolo de extracción** (WARN líneas excedidas):
+
+   ```
+   El Tipo A aplicado dejó CLAUDE.md en [N] líneas (umbral: 200).
+
+   Opciones:
+   [A] Condensar la regla agregada a ≤3 líneas y re-escribir en CLAUDE.md
+   [B] Extraer el cuerpo a @docs/lessons-<tema-kebab>.md y dejar 1 línea
+       en CLAUDE.md: "- **<título>**: [resumen 1 línea]. Detalle en
+       @docs/lessons-<tema>.md"
+   [C] Aceptar el WARN y continuar (ajustar SWL_CLAUDEMD_MAX_LINES en
+       caso de que el límite real del proyecto sea mayor)
+
+   ¿Qué prefieres?
+   ```
+
+   Por defecto, recomendar **[B] Extraer** cuando el aprendizaje requiere
+   más de 5 líneas o incluye ejemplos de código. Recomendar **[A] Condensar**
+   cuando el aprendizaje cabe en 1-3 líneas sin perder accionabilidad.
+
+4. **Protocolo de condensación** (WARN bullet-gigante):
+
+   Un bullet/párrafo >1000 chars es ilegible. Convertir a tabla, lista
+   jerárquica o extraer a `@docs/`. NO dejar el bullet gigante aunque el
+   usuario lo apruebe — viola el contrato canónico de CLAUDE.md.
+
+4.5. **Protocolo de duplicación de reglas globales** (WARN `duplicacion-reglas-globales`):
+
+   Esto significa que el Tipo A aplicado **parafrasea una regla que ya
+   vive en `~/.claude/rules/`** y se carga globalmente. Duplicarla
+   inline en CLAUDE.md de proyecto viola la regla
+   `reglas/sin-duplicacion-reglas-globales.md`.
+
+   El auditor reporta cuál regla global se duplica y la línea
+   aproximada. Ejemplo de hallazgo:
+
+   ```
+   [WARN] Bloque duplica regla global `~/.claude/rules/brevedad-output.md`
+          (línea ~14)
+   ```
+
+   Acción obligatoria:
+
+   ```
+   El Tipo A que se acaba de agregar parafrasea la regla global
+   `~/.claude/rules/<archivo>.md` § <sección> (línea ~N).
+
+   Opciones:
+   [A] Eliminar el bloque local — la regla global YA aplica
+       automáticamente en cada sesión SWL.
+   [B] Reescribir el bloque como matiz local (≤3 líneas) que
+       nombra explícitamente la regla global:
+       "Convenciones locales del proyecto: <matiz>.
+        Ver @~/.claude/rules/<archivo>.md."
+   [C] Documentar override explícito con justificación:
+       "Override de ~/.claude/rules/<archivo>.md por <razón>."
+
+   ¿Qué prefieres?
+   ```
+
+   Por defecto, **recomendar [A] Eliminar** salvo que el bloque agregue
+   matiz local genuino del proyecto. NUNCA aceptar el WARN sin
+   resolución — eso convierte el comando en cómplice de la duplicación
+   que la regla prohíbe.
+
+5. **Re-ejecutar el auditor** tras la corrección hasta veredicto OK o
+   WARN consultivo aceptable (con confirmación explícita del usuario para
+   los WARN no resueltos).
+
+### Reglas duras
+
+- NUNCA pasar al Paso 7 con veredicto `ERROR placeholders`. Revertir el Tipo
+  A primero.
+- NUNCA aceptar `WARN tamano-total` o `WARN bullet-gigante` sin proponer al
+  menos una de las opciones [A]/[B]. El usuario debe decidir conscientemente
+  si vivir con el WARN.
+- Si el aprendizaje Tipo A genera 2+ secciones nuevas, evaluar si el
+  contenido pertenece a un archivo `@docs/lessons-<tema>.md` desde el inicio
+  en lugar de inline.
+
+### Anti-patrón explícito
+
+❌ Aplicar Tipo A inline sin Paso 6.5 → CLAUDE.md crece descontroladamente →
+contrato canónico violado silenciosamente → próxima ejecución de
+`/swl:claudemd audit` reporta WARN, pero el daño ya está en el commit.
+
+✅ Aplicar Tipo A → ejecutar auditor sync en Paso 6.5 → si hay drift,
+condensar o extraer → CLAUDE.md permanece dentro del contrato.
+
 ## Paso 7 — APRENDIZAJES.md y reporte
 
 Crea o actualiza `.planning/APRENDIZAJES.md` con registro de la sesión: título, categoría, contexto, aprendizaje, acción tomada, métricas.

package/comandos/swl/claudemd.md

@@ -2,6 +2,11 @@
 name: swl:claudemd
 description: Audita, refactoriza, valida o inicializa archivos CLAUDE.md según best practices Anthropic (ADR-0016). Subcomandos audit (analiza calidad), refactor (sugiere extracciones), check (verifica secciones canónicas), init-user (crea ~/.claude/CLAUDE.md template), init-project (genera CLAUDE.md raíz del proyecto).
 allowed_tools: ["Read", "Write", "Edit", "Bash", "Glob", "Grep"]
+evolved: true
+evolved-from: "1.6.9"
+evolved-at: "2026-05-22"
+evolved-by: "aprender"
+evolved-note: "Audit dimensión 7 — duplicación de reglas globales (cataloga 6 reglas de ~/.claude/rules/ que NO deben duplicarse inline). Refactor propone reemplazo canónico. Aplica regla nueva sin-duplicacion-reglas-globales.md."
 ---
 
 # /swl:claudemd — Tratamiento profesional de CLAUDE.md
@@ -128,6 +133,14 @@ y genera `./CLAUDE.md` mínimo con:
   operacional de uso del sistema SWL al inicio de cada sesión. Si el proyecto
   tiene otras reglas locales (`@reglas/seguridad.md`, `@reglas/arquitectura.md`,
   etc.), agregarlas debajo.
+- Sección **Reglas de máxima prioridad** con sub-sección obligatoria
+  **Cuatro principios de implementación (Karpathy)**:
+  ```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`.
+  ```
+  Esta sub-sección es estándar SWL y cubre los gaps cognitivos más
+  frecuentes del agente sin agregar reglas específicas del proyecto.
 - Sección **Stack** poblada (lenguaje, framework, ORM, package manager)
 - Sección **Comandos** poblada (npm scripts detectados o comandos típicos)
 - Sección **Code style** vacía con placeholders
@@ -137,9 +150,76 @@ y genera `./CLAUDE.md` mínimo con:
 
 Si CLAUDE.md ya existe, **NO lo sobreescribe**. Sugiere correr
 `/swl:claudemd refactor` para mejorar el actual. Si detecta que el CLAUDE.md
-existente NO incluye `@reglas/usar-sistema-swl.md`, emitir hallazgo WARN
+existente NO incluye `@reglas/usar-sistema-swl.md` o NO menciona los cuatro
+principios Karpathy (o `prevencion-sobreingenieria`), emitir hallazgo WARN
 recomendando agregarlo manualmente.
 
+### Validación síncrona post-generación
+
+Tras `init-project` generar el archivo nuevo, ejecutar inmediatamente
+`audit` sobre el resultado:
+
+```bash
+node scripts/auditar-claudemd.js --json
+```
+
+Veredicto esperado: `OK` (el template debe respetar el contrato por
+construcción). Cualquier WARN/ERROR es bug del template — reportar al
+usuario y abrir issue para corrección. Este check es parte del contrato
+cruzado con `/swl:aprender` documentado en `@docs/contrato-aprender-claudemd.md`.
+
+### audit — checks específicos sobre Karpathy
+
+El subcomando `audit` verifica además de las dimensiones estándar:
+
+- ¿El CLAUDE.md menciona los cuatro principios Karpathy (texto literal
+  "Karpathy" o nombres de los 4 principios) o referencia
+  `prevencion-sobreingenieria` con `Skill(...)` o `@reglas/`?
+
+Si NO los menciona y el archivo tiene >50 líneas: emitir hallazgo WARN
+recomendando agregar la sub-sección compacta (4 líneas) como guía de
+implementación. NO emite WARN para CLAUDE.md mínimos (<50 LOC) ni para
+archivos `~/.claude/CLAUDE.md` user-level (esos siguen otro contrato).
+
+### audit — checks específicos sobre duplicación de reglas globales
+
+El subcomando `audit` también detecta (dimensión 7) si CLAUDE.md duplica
+reglas que ya viven en `~/.claude/rules/` y se cargan globalmente.
+Consume el catálogo declarativo
+`scripts/lib/reglas-globales-conocidas.json` que cataloga 6 reglas
+conocidas:
+
+- `brevedad-output.md` § Idioma obligatorio: español de México
+- `brevedad-output.md` § Brevedad y eficiencia de output
+- `git-coauthor.md` § Sin co-autores en commits
+- `arreglar-al-detectar.md` § Detectar → Informar → Arreglar
+- `debatir-antes-de-aceptar.md`
+- `usar-context7.md`
+
+Si detecta duplicación: emite hallazgo `duplicacion-reglas-globales`
+severidad WARN con línea aproximada y remediación específica. NO bloquea
+el comando — sirve como nudge para limpiar el CLAUDE.md.
+
+NO aplica a `~/.claude/CLAUDE.md` user-level (ahí sí pueden declararse
+preferencias personales que parafrasean reglas globales).
+
+Aplica regla `reglas/sin-duplicacion-reglas-globales.md`.
+
+### refactor — propuestas para duplicaciones de reglas globales
+
+Cuando `audit` detecta duplicaciones, el subcomando `refactor` propone
+el reemplazo concreto usando `construirSugerenciaRefactor()` del
+detector. Cada propuesta incluye:
+
+- **Bloque a eliminar** (línea aproximada en CLAUDE.md)
+- **Regla global afectada** (archivo + sección canónica)
+- **Reemplazo sugerido** (3 opciones):
+  1. Eliminar el bloque — la regla global YA aplica automáticamente
+  2. Reescribir como matiz local en ≤3 líneas referenciando la regla
+  3. Documentar override explícito con justificación
+
+El refactor SOLO imprime el diff propuesto. El usuario decide aplicar.
+
 ## Variables de entorno
 
 Ver `@docs/variables-entorno.md` sección "Calidad de CLAUDE.md":

package/comandos/swl/ejecutar-fase.md

@@ -2,6 +2,11 @@
 name: swl:ejecutar-fase
 description: Recibe el número de una fase y la implementa siguiendo el PLAN.md. Delega al agente implementador-swl, hace commits atómicos por slice, produce RESUMEN.md y actualiza ESTADO.md y HOJA-RUTA.md al terminar.
 allowed_tools: ["Read", "Write", "Edit", "Bash", "Glob", "Grep"]
+evolved: true
+evolved-from: "1.6.8"
+evolved-at: "2026-05-22"
+evolved-by: "aprender"
+evolved-note: "Paso 4.2 — cota dura 30k tokens al prompt del sub-agente para prevenir autocompact thrashing (origen SIGAF 2026-05-22)"
 ---
 
 # /swl:ejecutar-fase <n> [--iterative] — Ejecutar implementación de una fase
@@ -109,6 +114,15 @@ Anuncia inicio del slice (nombre, tipo AFK/HITL, número de tareas). Si es HITL
 ### 4.2 — Delegación al implementador-swl
 Delega con instrucción precisa: contexto a leer (PROYECTO.md, PLAN.md, CONTEXTO.md, CLAUDE.md), tareas del slice, criterio de verificación. El skill define las reglas de commit atómico y formato.
 
+**Cota dura del prompt al sub-agente**: ≤30k tokens (intent + constraints + acceptance criteria + file locations). Por encima de esa cifra el sub-agente puede entrar en autocompact thrashing y abortar sin escribir archivos (caso real SIGAF 2026-05-22). Si el prompt necesario excede 30k tokens:
+
+- Dividir el slice en sub-slices más pequeños (<10k tokens de spec cada uno).
+- O ejecutar directamente sin delegar si la spec está clara para ti (scope <5 archivos boilerplate similar).
+
+Indicador para optar por trabajo directo: si pasas más de 5 minutos escribiendo specs para preparar la delegación, el costo de delegar supera el ahorro.
+
+Detalle del patrón anti-thrashing en `agentes/orquestador-swl.md` sección "4. Tamaño máximo del prompt al sub-agente".
+
 ### 4.3 — Verificación del slice
 Ejecuta comandos de verificación del PLAN.md, verifica archivos, revisa commits (`git log --oneline -5`), corre tests. Si falla: máximo 2 reintentos antes de escalar al usuario.
 

package/comandos/swl/nuevo-proyecto.md

@@ -2,6 +2,11 @@
 name: swl:nuevo-proyecto
 description: Inicializa un proyecto nuevo desde cero. Hace preguntas al usuario, investiga el stack tecnológico y produce la estructura de planeación completa en .planning/.
 allowed_tools: ["Read", "Write", "Edit", "Bash", "Glob", "Grep"]
+evolved: true
+evolved-from: "1.6.8"
+evolved-at: "2026-05-22"
+evolved-by: "aprender"
+evolved-note: "Paso 6 — validación síncrona del auditor tras generar CLAUDE.md inicial (contrato cruzado con /swl:claudemd)"
 ---
 
 # /swl:nuevo-proyecto — Inicializar proyecto nuevo
@@ -156,6 +161,30 @@ Si ya existe `CLAUDE.md` (verificado en Paso 1), revisar que incluya
 `@reglas/usar-sistema-swl.md` en la sección de reglas obligatorias. Si NO
 lo incluye, agregarlo en este paso preservando el resto del contenido.
 
+### Validación síncrona post-generación (contrato cruzado con /swl:claudemd)
+
+Tras generar el `CLAUDE.md` inicial, ejecutar el auditor síncrono para
+verificar el contrato canónico desde el primer commit:
+
+```bash
+node scripts/auditar-claudemd.js --json
+# Fallback:
+npx -y @saulwade/swl-ses@latest audit-claudemd --json
+```
+
+Veredicto esperado en proyecto nuevo: `OK` (el template generado debe
+respetar el contrato por construcción). Si reporta WARN o ERROR:
+
+- `WARN secciones-canonicas` ausentes → bug del template, abrir issue.
+- `ERROR placeholders` → bug del template, reemplazar `[ej.]` con
+  ejemplos reales o HTML comments.
+
+Cualquier otro WARN/ERROR es señal de que el template necesita ajuste —
+reportar al usuario y considerar invocar `/swl:claudemd refactor` antes
+de continuar.
+
+Detalle del contrato cruzado en `@docs/contrato-aprender-claudemd.md`.
+
 ## Paso 7 — Reporte al usuario
 
 Al terminar, reporta:

package/habilidades/prevencion-sobreingenieria/SKILL.md

@@ -7,12 +7,12 @@ description: >
   implementar features, refactorizar código o resolver bugs — especialmente
   cuando el agente tiende a agregar abstracciones especulativas o tocar código
   fuera del alcance solicitado.
-version: "1.1.0"
+version: "1.2.0"
 evolved: true
-evolved-from: "1.0.0"
-evolved-at: "2026-04-24"
-evolved-by: "aprender"
-evolved-note: "Sección nueva: variables residuales post-refactor son code smell (F841 con ruff)"
+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:
@@ -27,6 +27,10 @@ evolvable: true  # default para skill estandar
 Skill derivado de los principios de Andrej Karpathy sobre errores comunes de LLMs
 al generar código, adaptado al ecosistema SWL.
 
+> **Para 9 ejemplos MAL→BIEN lado a lado con código real**, ver
+> [recursos/EXAMPLES.md](recursos/EXAMPLES.md). Cada ejemplo está mapeado a un
+> escenario operativo concreto de SWL (qué agente debe citarlo, en qué flujo).
+
 ## Cuándo cargar
 
 - Antes de implementar cualquier feature nueva con `implementador-swl` o `backend-*-swl`