@saulwade/swl-ses 2.4.2 → 2.5.1

package/habilidades/meta-reglas-extendido/SKILL.md

@@ -0,0 +1,92 @@
+---
+name: meta-reglas-extendido
+description: >
+  Contenido extendido de las reglas base más pesadas del sistema (dieta de
+  contexto, Fase D): protocolos completos, ejemplos MAL/BIEN, casos de origen
+  y checklists que se extrajeron del núcleo de cada regla para reducir el
+  contexto fijo por sesión. Cargar cuando el núcleo de una regla base
+  (17 reglas: las 5 del piloto — verificar-citas-normativas, arquitectura,
+  seguridad-agentes, api-diseno, skills-estandar — y las 12 de la ola 2, de
+  gobernanza a usar-code-review-graph) remita a su detalle extendido, o cuando se necesite el
+  procedimiento paso a paso, un ejemplo de código o el caso histórico que el
+  núcleo solo resume.
+version: "1.1.0"
+herramientasPermitidas: [Read]
+evolvable: true  # default para skill estandar
+exclusiones:
+  - "No cargar para aplicar el día a día de una regla — el núcleo en reglas/ (instalado en ~/.claude/rules/) es autosuficiente para el 90% de las decisiones."
+  - "No cargar para editar o crear reglas nuevas — eso es Edit directo sobre reglas/ (fuente) siguiendo el patrón núcleo/extendido de esta Fase D."
+  - "No cargar para el estándar de skills — el detalle avanzado de skills vive en meta-skills-estandar (precedente de este patrón)."
+---
+# Reglas base — contenido extendido (dieta de contexto, Fase D)
+
+Las reglas base se cargan en TODAS las sesiones; su costo fijo de contexto se
+paga siempre. La Fase D (ROADMAP-EVOLUCION) partió las más pesadas en:
+
+- **Núcleo** (`reglas/<nombre>.md`, instalado en `~/.claude/rules/`): principio,
+  reglas duras y anti-patrones — lo que decide el 90% de los casos. ≤50 líneas.
+- **Extendido** (`recursos/<nombre>.md` de este skill): protocolos completos,
+  ejemplos MAL/BIEN, casos de origen, checklists — se carga solo cuando hace falta.
+
+Precedente validado: split de `skills-estandar` v1→v2 (core + `meta-skills-estandar`),
+ahorro declarado ~18 KB/sesión.
+
+## Cuándo cargar
+
+- El núcleo de una regla remite a su extendido y necesitas el detalle
+  (procedimiento paso a paso, ejemplo de código, protocolo de verificación).
+- Auditorías que exigen citar el caso de origen o el checklist completo de
+  una regla base.
+- Dudas sobre la aplicación fina de una regla que el núcleo solo resume.
+
+## Cuándo NO cargar
+
+- Aplicación cotidiana de la regla — el núcleo instalado basta.
+- Autoría de skills (→ `Skill("meta-skills-estandar")`).
+- Reglas que no están en este catálogo (siguen completas en `reglas/`).
+
+## Recursos (extendido por regla)
+
+| Regla (núcleo en reglas/) | Extendido |
+|---|---|
+| verificar-citas-normativas | [recursos/verificar-citas-normativas.md](recursos/verificar-citas-normativas.md) |
+| arquitectura | [recursos/arquitectura.md](recursos/arquitectura.md) |
+| seguridad-agentes | [recursos/seguridad-agentes.md](recursos/seguridad-agentes.md) |
+| api-diseno | [recursos/api-diseno.md](recursos/api-diseno.md) |
+| skills-estandar | [recursos/skills-estandar.md](recursos/skills-estandar.md) |
+| gobernanza | [recursos/gobernanza.md](recursos/gobernanza.md) |
+| arreglar-al-detectar | [recursos/arreglar-al-detectar.md](recursos/arreglar-al-detectar.md) |
+| usar-sistema-swl | [recursos/usar-sistema-swl.md](recursos/usar-sistema-swl.md) |
+| memoria-consolidada | [recursos/memoria-consolidada.md](recursos/memoria-consolidada.md) |
+| git-workflow | [recursos/git-workflow.md](recursos/git-workflow.md) |
+| analizar-directorios-antes-de-escribir | [recursos/analizar-directorios-antes-de-escribir.md](recursos/analizar-directorios-antes-de-escribir.md) |
+| usar-context7 | [recursos/usar-context7.md](recursos/usar-context7.md) |
+| sin-duplicacion-reglas-globales | [recursos/sin-duplicacion-reglas-globales.md](recursos/sin-duplicacion-reglas-globales.md) |
+| sesiones-paralelas | [recursos/sesiones-paralelas.md](recursos/sesiones-paralelas.md) |
+| analisis-previo-tareas-grandes | [recursos/analisis-previo-tareas-grandes.md](recursos/analisis-previo-tareas-grandes.md) |
+| debatir-antes-de-aceptar | [recursos/debatir-antes-de-aceptar.md](recursos/debatir-antes-de-aceptar.md) |
+| usar-code-review-graph | [recursos/usar-code-review-graph.md](recursos/usar-code-review-graph.md) |
+
+## Reglas de mantenimiento (obligatorias)
+
+1. **Cero pérdida de información**: todo lo que sale de un núcleo DEBE existir
+   en su extendido. La densidad viene de estructura, no de omisión.
+2. **El núcleo manda**: si núcleo y extendido divergen, el núcleo es la norma
+   vigente y el extendido se corrige (mismo contrato que regla→skill en
+   `skills-estandar`).
+3. **Ediciones nuevas**: gotchas y casos nuevos entran al extendido; el núcleo
+   solo cambia si la NORMA cambia. Ambos con el mismo commit.
+4. **Migrar otra regla al patrón**: crear `recursos/<nombre>.md`, dejar núcleo
+   ≤50 líneas con la línea de referencia estándar, actualizar la tabla de
+   arriba y registrar en modulos.json/plugin.json (regla
+   registro-componentes-nuevos).
+
+## Gotchas / Errores comunes no obvios
+
+- **Poner el extendido dentro de `reglas/` o `~/.claude/rules/`**: los archivos
+  del directorio de reglas se cargan automáticamente — el "extendido" se
+  cargaría siempre y el ahorro sería cero. Por eso vive en un skill (carga
+  solo bajo demanda), siguiendo el precedente de meta-skills-estandar.
+- **Recortar el núcleo omitiendo reglas duras**: el núcleo no es un resumen —
+  es la norma operativa completa en forma densa. Lo que se va al extendido es
+  el POR QUÉ y el CÓMO detallado, nunca el QUÉ obligatorio.

package/habilidades/meta-reglas-extendido/recursos/analisis-previo-tareas-grandes.md

@@ -0,0 +1,186 @@
+# Análisis previo ante tareas grandes — extendido
+
+> Extendido de `reglas/analisis-previo-tareas-grandes.md` (Fase D, dieta de
+> contexto). El núcleo instalado es la norma; aquí viven los formatos completos,
+> los ejemplos y los casos de origen.
+
+## Índice
+
+- [Principio](#principio)
+- [Cómo aplicar](#cómo-aplicar)
+  - [Detección — qué cuenta como "tarea grande"](#detección--qué-cuenta-como-tarea-grande)
+  - [Paso 1 — Auditar lo que ya existe](#paso-1--auditar-lo-que-ya-existe)
+  - [Paso 2 — Tabla comparativa](#paso-2--tabla-comparativa)
+  - [Paso 3 — Tres opciones de alcance](#paso-3--tres-opciones-de-alcance)
+  - [Paso 4 — Recomendación explícita](#paso-4--recomendación-explícita)
+  - [Paso 5 — Esperar confirmación](#paso-5--esperar-confirmación)
+- [Excepciones — cuándo NO aplicar la regla](#excepciones--cuándo-no-aplicar-la-regla)
+- [Cómo presentar la tabla y opciones](#cómo-presentar-la-tabla-y-opciones)
+- [Anti-patrones](#anti-patrones)
+- [Origen de esta regla](#origen-de-esta-regla)
+
+---
+
+## Principio
+
+> Cuando el usuario pide "replicar íntegramente X", "portar todo Y", "implementar
+> el sistema completo Z", **responde primero con análisis comparativo (qué ya
+> existe vs. qué falta) y propón 3 opciones de alcance** (mínima / media /
+> completa) antes de escribir código. Nunca arrancar el porte literal sin
+> confirmación explícita tras presentar opciones.
+
+---
+
+## Cómo aplicar
+
+### Detección — qué cuenta como "tarea grande"
+
+Cualquier solicitud que tenga al menos uno de estos atributos:
+
+- Más de ~10 archivos a crear, mover o reescribir.
+- Más de ~500 LOC estimadas a tocar en un solo turno.
+- Toca más de un dominio (backend + frontend, o varios módulos backend).
+- "Replicar X" donde X es un sistema externo con su propia arquitectura.
+- "Portar todo de Y" donde Y es un repo, framework o lib voluminoso.
+- "Implementar todo Z" donde Z es una fase, un sub-sistema, una capa nueva.
+- Análisis de un repo en `temp/` con la pregunta abierta "¿qué adoptamos?".
+
+Si la solicitud encaja en cualquiera de estas, aplicar la regla.
+
+### Paso 1 — Auditar lo que ya existe
+
+Antes de proponer el porte:
+
+- `Glob` / `Grep` / `Read` para mapear el código actual del usuario.
+- Identificar componentes que ya cubren parte de la solicitud.
+- Verificar versiones, dependencias, convenciones del proyecto.
+- Si es repo externo en `temp/`: aplicar **filtro de dominio** primero
+  (ver `reglas/arquitectura.md` § "Análisis de repositorios externos").
+  Descartar 80-95% del contenido vertical antes de análisis profundo.
+
+### Paso 2 — Tabla comparativa
+
+Producir una tabla con tres columnas:
+
+| Componente del sistema externo | Equivalente actual del usuario | Gap |
+|---|---|---|
+| ... | ya existe / parcial / no existe | qué falta agregar |
+
+Sin la tabla, no se proponen opciones. La tabla es la base objetiva de la decisión.
+
+### Paso 3 — Tres opciones de alcance
+
+Siempre presentar tres opciones:
+
+- **Mínima** — solo cierra los gaps críticos (lo que NO existe). Esfuerzo
+  estimado bajo. Usuario acepta vivir con diferencias menores en lo demás.
+- **Media** — cierra gaps + alinea componentes parciales con el patrón externo.
+  Esfuerzo medio. Convergencia parcial sin reescribir lo que ya funciona.
+- **Completa** — porte literal de todo lo que el usuario pidió, sin reusar
+  componentes existentes. Esfuerzo alto. Justificable solo cuando la
+  arquitectura externa es estrictamente superior.
+
+Cada opción incluye:
+
+- Estimación de esfuerzo (turnos, LOC, archivos afectados).
+- Lista de tareas concretas si se elige.
+- Riesgos / tradeoffs específicos.
+
+### Paso 4 — Recomendación explícita
+
+Tras las tres opciones, **recomendar una** con razonamiento. No dejar la
+decisión "abierta" — el usuario espera tu juicio técnico.
+
+Patrón de recomendación:
+
+> **Recomiendo la opción [N]** porque [razón concreta]. Las opciones [otras]
+> son válidas si [condición específica].
+
+### Paso 5 — Esperar confirmación
+
+Después de presentar tabla + opciones + recomendación: detenerse y esperar.
+
+NO arrancar a escribir código asumiendo aprobación implícita. La autorización
+debe ser literal del usuario ("procede con la opción 2", "adelante con la
+mínima", "hagamos la completa").
+
+---
+
+## Excepciones — cuándo NO aplicar la regla
+
+NO aplicar cuando:
+
+1. **El usuario ya pidió explícitamente la opción**: "implementa la versión
+   mínima de X" o "porta solo el módulo Y" — la elección ya está hecha.
+2. **El alcance es trivial** — menos de 5 archivos, una sola dependencia.
+3. **El usuario pidió análisis y ya decidió**: si ya hubo una sesión previa con
+   la tabla comparativa y el usuario eligió, proceder sin re-presentar.
+4. **Es un fix urgente de producción** — bug crítico, vulnerabilidad activa,
+   incidente. El análisis se reduce a confirmar la causa y aplicar el fix
+   específico.
+
+---
+
+## Cómo presentar la tabla y opciones
+
+### Formato de tabla comparativa (mínimo)
+
+```markdown
+| Componente | Sistema externo | Tu sistema actual | Gap |
+|---|---|---|---|
+| Auth | OAuth2 + PKCE | JWT custom | parcial — falta PKCE |
+| Storage | S3 + presigned | filesystem local | falta — pendiente migración |
+| ... | ... | ... | ... |
+```
+
+### Formato de las tres opciones (mínimo)
+
+```markdown
+**Opción A — Mínima** (~3 turnos, ~15 archivos)
+- Cerrar solo gaps críticos: PKCE, presigned URLs.
+- No tocar lo que ya funciona.
+- Riesgo: leve divergencia con sistema externo en convenciones menores.
+
+**Opción B — Media** (~6 turnos, ~30 archivos)
+- Cerrar gaps + alinear `auth/` con patrón OAuth2 completo.
+- Mantener storage actual con migración planeada en fase futura.
+- Riesgo: refactor en `auth/` puede romper integraciones existentes.
+
+**Opción C — Completa** (~15 turnos, ~80 archivos)
+- Porte literal del sistema externo completo.
+- Reemplaza todo lo equivalente, no importa que ya funcione.
+- Riesgo: regresiones en funcionalidad madura.
+
+**Recomiendo la Opción A**: el sistema actual cubre el 80% del valor;
+los gaps específicos resuelven el caso concreto sin riesgo de regresión.
+```
+
+---
+
+## Anti-patrones
+
+- Arrancar a escribir código tras "replícame X" sin tabla comparativa.
+- Presentar las opciones sin recomendar — pasar la pelota al usuario.
+- Listar 5+ opciones cuando 3 son suficientes (mínima / media / completa).
+- Estimar esfuerzo en términos vagos ("bastante trabajo", "no mucho") sin
+  cuantificar turnos / archivos / LOC.
+- Omitir la auditoría de lo que ya existe y proponer porte literal de todo.
+- Cuando el usuario pide la opción mínima, expandir el alcance "porque
+  conviene" sin pedir confirmación.
+
+---
+
+## Origen de esta regla
+
+Consolidada el 2026-05-04 desde feedback del usuario en sesión 2026-04-18 sobre
+porte de Hermes Agent: tras pedir "replicar íntegramente Hermes Agent" (~960
+archivos Python), aceptó la propuesta de cerrar solo 3 gaps específicos
+(perfil de usuario, cron natural, auto-evolución). Lección: la auditoría previa
++ opciones explícitas evita re-implementar 80% de funcionalidad ya existente.
+
+Reforzada en análisis de repos en `temp/` durante v1.1.0 de swl-ses (2026-04-23):
+filtro de dominio descartó 97% del contenido de 5 repos antes de análisis
+profundo, ahorrando horas de trabajo en arquitectura externa irrelevante.
+
+Memoria nativa local correspondiente (`feedback_analisis_previo.md` en swl-ses):
+redundante tras esta regla; el contenido operativo vive aquí.

package/habilidades/meta-reglas-extendido/recursos/analizar-directorios-antes-de-escribir.md

@@ -0,0 +1,235 @@
+# Analizar directorios antes de escribir — extendido
+
+> Extendido de `reglas/analizar-directorios-antes-de-escribir.md` (Fase D,
+> dieta de contexto). El núcleo instalado es la norma; aquí viven la tabla
+> completa de variantes por dominio, la jerarquía de desempate desarrollada,
+> el eje técnico-runtime con ejemplos swl-ses, los anti-patrones con casos
+> reales y el checklist completo.
+
+## Índice
+
+- [Contexto — el patrón que cierra esta regla](#contexto--el-patrón-que-cierra-esta-regla)
+- [Cuándo aplicar](#cuándo-aplicar)
+- [Cómo aplicar — protocolo de 4 pasos](#cómo-aplicar--protocolo-de-4-pasos)
+- [La tensión es/en — cómo resolverla (no es "español siempre")](#la-tensión-esen--cómo-resolverla-no-es-español-siempre)
+- [Eje técnico-runtime vs vocabulario-de-dominio (refina la jerarquía)](#eje-técnico-runtime-vs-vocabulario-de-dominio-refina-la-jerarquía)
+- [Anti-patrones explícitos](#anti-patrones-explícitos)
+- [Excepciones legítimas](#excepciones-legítimas)
+- [Checklist antes de escribir un MD/reporte o crear un directorio](#checklist-antes-de-escribir-un-mdreporte-o-crear-un-directorio)
+- [Origen de esta regla](#origen-de-esta-regla)
+
+---
+
+## Contexto — el patrón que cierra esta regla
+
+La regla aplica cada vez que Claude va a **crear un directorio nuevo** o
+**escribir un archivo de documentación** (`.md`, `.json` de reporte, informe,
+ADR, plan, análisis, output de auditoría/diseño/research) en cualquier
+proyecto del usuario.
+
+Cierra un patrón conductual recurrente: el agente escribe un documento en un
+directorio nuevo elegido ad-hoc — en idioma o nombre distinto al que el
+proyecto ya usa para ese dominio — y produce **directorios paralelos
+divergentes** que fragmentan la memoria institucional.
+
+El costo de un `ls` antes de escribir es de 1 segundo. El costo de un
+directorio paralelo es: referencias colgadas, búsquedas que fallan, memoria
+institucional partida, y una sesión futura de depuración/unificación.
+
+---
+
+## Cuándo aplicar
+
+OBLIGATORIO antes de:
+
+- Escribir un reporte de auditoría, verificación, nemesis, revisión, análisis.
+- Escribir un documento de diseño/UX (propuesta, tokens, discovery, UI-SPEC).
+- Crear un ADR, plan, spec, runbook, research output.
+- Crear cualquier directorio nuevo bajo `.planning/`, `docs/`, o equivalente.
+- Persistir cualquier `.md`/`.json` que sea memoria del proyecto (no código).
+
+NO aplica cuando:
+
+- El comando/agente/herramienta **fija un path canónico de output** — en ese
+  caso úsalo tal cual, no lo cuestiones (ej: un agente que pinea
+  `.planning/audit/findings/iter-N/`).
+- El archivo es código fuente (sigue las convenciones del lenguaje/framework).
+- El usuario indicó explícitamente la ruta exacta donde escribir.
+- Es un archivo efímero de scratch que se borrará en el mismo turno.
+
+---
+
+## Cómo aplicar — protocolo de 4 pasos
+
+### Paso 1 — Listar la estructura existente
+
+Antes de elegir dónde escribir:
+
+```bash
+ls .planning/          # o el directorio raíz de docs del proyecto
+ls docs/
+```
+
+O con Glob: `**/{audit,auditoria,diseno*,ux,design,research,specs}/`.
+
+### Paso 2 — Buscar si el dominio ya tiene directorio (incluye variantes es/en)
+
+Pregúntate: ¿ya existe un directorio para este tipo de artefacto? Busca
+**variantes en ambos idiomas** y sinónimos:
+
+| Dominio | Variantes a buscar antes de crear |
+|---|---|
+| Auditoría | `audit/`, `auditoria/`, `auditorias/`, `findings/` |
+| Diseño/UX | `diseno/`, `diseno-visual/`, `ux/`, `ui/`, `design/` |
+| Investigación | `research/`, `investigacion/`, `knowledge/` |
+| Decisiones | `adrs/`, `adr/`, `decisiones/` |
+| Sesiones | `sessions/`, `sesiones/` |
+| Deuda | `DEUDAS.md`, `DEUDA-TECNICA.md`, `deuda/`, `debt/` |
+
+### Paso 3 — Decidir el destino
+
+- **Si ya existe un directorio para el dominio** → escribe ahí. Punto. Aunque
+  el nombre existente esté en el "idioma equivocado", reusarlo es superior a
+  crear un paralelo. La consistencia gana sobre la preferencia de idioma.
+- **Si existe un path canónico de la herramienta** (swl-ses pinea
+  `.planning/audit/`, `knowledge/outputs/`, `sessions/`, etc.) → ese path es
+  la fuente de verdad. NO lo dupliques en español.
+- **Si NO existe precedente** → crea uno nuevo siguiendo la convención
+  dominante del proyecto (mira cómo están nombrados los directorios hermanos).
+
+### Paso 4 — Desempate del nombre (solo para directorios genuinamente nuevos)
+
+Cuando creas un nombre nuevo sin precedente ni path canónico:
+
+- Prefiere **español de México** (consistente con
+  `~/.claude/rules/brevedad-output.md § Idioma obligatorio`): `diseno/`,
+  `investigacion/`, `auditoria/` antes que `design/`, `research/`, `audit/`.
+- **PERO**: si el proyecto ya tiene una convención de idioma dominante para
+  sus directorios (ej: swl-ses usa mayormente inglés: `audit/`, `knowledge/`,
+  `sessions/`, `research/`), respeta ESA convención sobre la preferencia
+  general — la coherencia intra-proyecto manda.
+- Identificadores técnicos (nombres que un comando/script consume como string)
+  siguen la convención del consumidor, no la preferencia de idioma.
+
+---
+
+## La tensión es/en — cómo resolverla (no es "español siempre")
+
+"Preferir español" es un **desempate**, no un mandato absoluto. La jerarquía
+de decisión, de mayor a menor prioridad:
+
+1. **Path canónico fijado por la herramienta** (gana siempre, aunque sea inglés).
+2. **Directorio existente para el dominio** (reusar, aunque el idioma "no cuadre").
+3. **Convención de idioma dominante del proyecto** (si el proyecto es es → es;
+   si es en → en).
+4. **Preferencia general español de México** (solo cuando 1-3 no aplican).
+
+Renombrar un path canónico inglés establecido a español **viola** esta regla:
+reintroduce divergencia en vez de eliminarla. El objetivo es UNA convención por
+proyecto, no "todo en español".
+
+---
+
+## Eje técnico-runtime vs vocabulario-de-dominio (refina la jerarquía)
+
+La jerarquía de arriba decide entre español e inglés *cuando todo el árbol usa
+un solo idioma*. Pero muchos proyectos adoptan una convención **mixta por
+categoría**: "identificadores técnicos en inglés, vocabulario de cara al usuario
+en el idioma del proyecto" (caso swl-ses). Ahí, **clasifica el directorio ANTES**
+de aplicar la jerarquía:
+
+- **Path runtime/técnico → inglés.** Telemetría, estado interno, caches, logs
+  archivados, outputs de tooling, índices. No los lee el usuario final; los
+  consume el código como string. Ej. en swl-ses: `.planning/evolution/`,
+  `.planning/auto-evolution/`, `.planning/user-profile/`, `.planning/archive/`,
+  `.planning/traces/`, `.planning/sessions/`, `.planning/audit/`.
+- **Vocabulario de dominio de cara al usuario → idioma del proyecto.** Artefactos
+  acoplados a comandos/UX cuyo nombre el usuario lee y escribe. Ej. en swl-ses:
+  `.planning/fases/` permanece **español** porque su comando es `/swl:planear-fase`
+  (español, intocable). Cambiar el dir sin cambiar el comando crea una
+  inconsistencia comando↔directorio *peor* que la divergencia que se quería evitar.
+
+**Regla de coherencia comando↔directorio:** el nombre del data dir debe espejar
+el idioma del comando que escribe en él. NUNCA partir un par comando↔directorio
+en dos idiomas.
+
+**Consolidar islas runtime SÍ es válido (no viola "no renombrar paths
+establecidos"):** si un proyecto con convención técnico-inglés tiene islas
+runtime en español (`evolucion/`, `archivo/`), alinearlas a inglés *reduce*
+divergencia — es lo opuesto a "renombrar `audit/` a español". La prohibición de
+renombrar aplica a mover *desde* la convención establecida, no *hacia* ella. Las
+islas runtime alineadas requieren shim de migración (renombrar el dir físico en
+proyectos que ya tienen datos) — ver `scripts/instalador.js § 6c-bis` en swl-ses.
+
+---
+
+## Anti-patrones explícitos
+
+- **Crear `ux/` cuando ya existe `diseno-visual/`** (o viceversa) sin haber
+  hecho `ls .planning/` primero. Caso real: SIGM acumuló ambos por sesiones
+  distintas que no verificaron el precedente.
+- **Crear `auditoria/` (es) cuando la herramienta pinea `audit/` (en)** como
+  path canónico. Caso real: `/swl:verificar` y el consolidado de `/swl:nemesis`
+  escribieron en `auditoria/` mientras los reportes por-router iban a
+  `audit/findings/` — misma corrida, dos directorios.
+- **Renombrar `audit/`, `knowledge/`, `sessions/` a español** "porque la
+  preferencia es español". Eso rompe paths canónicos y reintroduce divergencia.
+- **Escribir un reporte en un directorio top-level nuevo** sin revisar los
+  directorios hermanos existentes.
+- **Asumir que no hay precedente sin buscar variantes es/en** del nombre del
+  dominio.
+
+---
+
+## Excepciones legítimas
+
+NO aplicar (o aplicar con criterio reducido) cuando:
+
+1. El comando/agente **pinea el path** — úsalo, no analices.
+2. El usuario dictó la ruta exacta.
+3. Es un archivo de scratch efímero del mismo turno.
+4. Es el **primer** documento del proyecto (no hay estructura que analizar
+   todavía) — ahí creas la convención; hazlo deliberadamente y en español si
+   no hay restricción técnica.
+
+---
+
+## Checklist antes de escribir un MD/reporte o crear un directorio
+
+- [ ] Ejecuté `ls`/`Glob` sobre el directorio raíz de docs (`.planning/`, `docs/`).
+- [ ] Busqué variantes es/en del nombre del dominio (audit/auditoria,
+      diseno/ux/design, research/investigacion).
+- [ ] Si existe directorio para el dominio → escribo ahí (no creo paralelo).
+- [ ] Si la herramienta pinea path canónico → uso ese (aunque sea inglés).
+- [ ] Si creo uno nuevo → sigue la convención de idioma dominante del proyecto;
+      español como desempate solo sin precedente ni path canónico.
+- [ ] No reintroduje divergencia renombrando un path canónico establecido.
+
+---
+
+## Origen de esta regla
+
+Sesión 2026-05-31, proyecto SIGM. Al depurar `.planning/` se detectaron **dos
+pares de directorios divergentes** creados por sesiones distintas para el mismo
+dominio, en idiomas distintos:
+
+- `.planning/audit/` (en, canónico swl-ses) vs `.planning/auditoria/` (es,
+  ad-hoc). La misma corrida de `/swl:nemesis` quedó partida entre ambos; 8
+  documentos con referencias colgadas tras la consolidación.
+- `.planning/ux/` (en, 2026-05-30) vs `.planning/diseno-visual/` (es,
+  2026-05-11). La sesión 05-30 creó `ux/` sin verificar que `diseno-visual/`
+  ya existía.
+
+Causa raíz dual: (a) **conductual** — el agente no analiza la estructura
+existente antes de escribir (esta regla); (b) **de herramienta** — varios
+comandos/agentes de swl-ses no fijan path canónico de output (ticket
+`DT-PLANNING-OUTPUT-PATHS` en swl-ses). Esta regla ataca el lado conductual y
+aplica a todo proyecto del usuario, use o no swl-ses.
+
+Relación con otras reglas:
+- `~/.claude/rules/brevedad-output.md § Idioma obligatorio` — la preferencia
+  español que esta regla usa como desempate.
+- `~/.claude/rules/memoria-consolidada.md § no-duplicación` — un dato vive en
+  un solo canal; esta regla extiende el principio a directorios.
+- `~/.claude/rules/sin-duplicacion-reglas-globales.md` — analogía: no duplicar
+  contenido que ya vive en su lugar canónico.