@saulwade/swl-ses 2.4.2 → 2.5.1

package/reglas/usar-context7.md

@@ -1,226 +1,48 @@
 # Regla: Consultar Context7 antes de generar código con dependencias externas
 
-Esta regla es OBLIGATORIA para todo agente o skill del sistema SWL que
-genere código que use librerías, frameworks, SDKs o APIs externas. La regla
-se carga automáticamente para los agentes de stack (`backend-*-swl`,
-`frontend-*-swl`, `mobile-*-swl`, `implementador-swl`, `llm-apps-swl`,
-`pagos-swl`, `datos-swl`) y para skills de implementación.
-
----
-
-## Por qué existe esta regla
-
-El conocimiento del modelo sobre librerías de terceros tiene fecha de
-corte. Una librería que en el corte estaba en la versión X y era la
-recomendación, hoy puede estar:
-
-- En una versión Y mayor con cambios incompatibles
-- Deprecada y reemplazada por otra librería
-- Con vulnerabilidades conocidas que requieren un parche
-- Renombrada o migrada a otra organización
-
-Generar código sin verificar la versión actual genera tres clases de
-defectos en producción:
-
-1. **Imports a APIs deprecadas** que arrastran warnings o se eliminan
-   en próximas versiones (ejemplo histórico: `@xenova/transformers`
-   migrado a `@huggingface/transformers`).
-2. **Dependencias transitivas obsoletas** que el usuario ve como
-   warnings al instalar (ejemplo: `prebuild-install@7.1.3` arrastrada
-   por una librería que el sistema eligió sin verificar la salud).
-3. **Vulnerabilidades CVE conocidas** que están parchadas en versiones
-   más nuevas que el modelo no conoce.
-
-Context7 (MCP `mcp__claude_ai_Context7__query-docs` y
-`mcp__claude_ai_Context7__resolve-library-id`) provee documentación
-actualizada de librerías y frameworks. Su uso es la primera línea de
-defensa contra estos tres problemas.
-
----
-
-## Cuándo consultar Context7 (OBLIGATORIO)
-
-Antes de:
-
-1. **Agregar una nueva dependencia** a `package.json`, `requirements.txt`,
-   `pom.xml`, `Cargo.toml`, `go.mod`, `composer.json`, `Package.swift` o
-   equivalente.
-2. **Generar código que importe o use una librería externa** que no
-   estaba ya en uso en el proyecto, aunque la librería ya esté
-   instalada.
+Regla OBLIGATORIA para todo agente o skill SWL que genere código con librerías,
+frameworks, SDKs o APIs externas — se carga automáticamente para los agentes de stack
+(`backend-*-swl`, `frontend-*-swl`, `mobile-*-swl`, `implementador-swl`, `llm-apps-swl`,
+`pagos-swl`, `datos-swl`) y skills de implementación. El conocimiento del modelo tiene
+fecha de corte: generar código sin verificar produce imports a APIs deprecadas,
+dependencias transitivas obsoletas y CVEs ya parchados en versiones que el modelo no
+conoce. Context7 (MCP `resolve-library-id` + `query-docs`) es la primera línea de defensa.
+
+## Cuándo consultar (OBLIGATORIO) — antes de:
+
+1. **Agregar una dependencia nueva** a `package.json`, `requirements.txt`, `pom.xml`, `Cargo.toml`, `go.mod`, `composer.json`, `Package.swift` o equivalente.
+2. **Generar código que importe una librería externa** no usada aún en el proyecto, aunque ya esté instalada.
 3. **Actualizar la versión** de una dependencia existente.
-4. **Migrar de una librería a otra** alternativa (ej.
-   `axios` → `fetch`, `moment` → `date-fns`, `jest` → `vitest`).
-5. **Resolver un warning de deprecación** de una dependencia
-   transitiva.
-6. **Implementar un patrón nuevo** del framework (ej. Server Actions
-   en Next.js, Signals en Angular, Suspense en React) — la API
-   correcta cambia rápido.
+4. **Migrar de una librería a otra** alternativa (ej. `axios` → `fetch`, `moment` → `date-fns`, `jest` → `vitest`).
+5. **Resolver un warning de deprecación** de una dependencia transitiva.
+6. **Implementar un patrón nuevo del framework** (Server Actions, Signals, Suspense) — la API correcta cambia rápido.
 
-NO es necesario consultar Context7 cuando:
+NO es necesario cuando:
 
-- La librería es interna al proyecto SWL (`scripts/lib/*`,
-  `hooks/lib/*`).
-- Es la biblioteca estándar del lenguaje (Node `fs`, Python `os`).
-- Es código que no usa dependencias externas (algoritmos, lógica de
-  negocio sin librerías de terceros).
+- La librería es interna al proyecto SWL (`scripts/lib/*`, `hooks/lib/*`).
+- Es biblioteca estándar del lenguaje (Node `fs`, Python `os`).
+- Es código sin dependencias externas (algoritmos, lógica de negocio pura).
 - El cambio es trivial (renombrar variable, formatear).
 
----
-
-## Cómo consultar Context7
-
-El MCP de Context7 expone dos herramientas principales:
-
-```
-mcp__claude_ai_Context7__resolve-library-id(libraryName)
-  → Resuelve un nombre de librería (ej. "react", "next.js") al ID
-    canónico que Context7 usa internamente.
-
-mcp__claude_ai_Context7__query-docs(library, topic, version?)
-  → Devuelve documentación actualizada de la librería sobre el
-    topic específico. Acepta versión opcional.
-```
+## Flujo mínimo
 
-Flujo típico:
-
-1. Resolver el ID de la librería:
-   ```
-   const id = mcp__claude_ai_Context7__resolve-library-id({
-     libraryName: "next.js"
-   });
-   ```
-
-2. Consultar el tema específico:
-   ```
-   const docs = mcp__claude_ai_Context7__query-docs({
-     library: id,
-     topic: "Server Actions",
-     version: "16"
-   });
-   ```
-
-3. Verificar:
-   - ¿La librería sigue siendo la recomendada o está deprecada?
-   - ¿Hay una alternativa migrada que deberíamos usar?
-   - ¿La API que voy a generar es la actual o cambió?
-   - ¿La versión que recomienda Context7 coincide con la del
-     `package.json` del proyecto?
-
----
+1. `resolve-library-id(libraryName)` → ID canónico; luego `query-docs(library, topic, version?)`.
+2. Verificar: ¿sigue recomendada o está deprecada? ¿hay alternativa migrada? ¿la API que voy a generar es la actual? ¿la versión coincide con la del proyecto?
 
 ## Reglas estrictas
 
-### NUNCA agregar dependencia sin verificar
-
-Antes de escribir `npm install <paquete>`, `pip install <paquete>`,
-`go get <paquete>` o equivalente:
-
-- Consultar Context7 para confirmar que la librería sigue activa.
-- Confirmar la versión más reciente compatible con el resto del
-  stack del proyecto.
-- Si Context7 reporta deprecación, **NO la uses**. Buscar la
-  alternativa migrada.
-
-### NUNCA generar código con API obsoleta
-
-Si el usuario pide implementar X usando librería Y:
-
-- Consultar Context7 sobre cómo se hace X en la versión actual de Y.
-- Si la API que aparece en el contexto del modelo difiere de la que
-  Context7 reporta como actual, **usar la de Context7**.
-- Documentar en un comentario corto la versión consultada y la
-  fecha si la API es notable.
-
-### NUNCA copiar ejemplos de la web sin verificar versión
-
-Stack Overflow, blogs y tutoriales tienen alta probabilidad de
-mostrar código deprecado. Si el agente consulta una web (vía
-WebSearch o WebFetch) y obtiene un ejemplo, ese ejemplo debe
-validarse contra Context7 antes de incorporarlo.
-
----
+- **NUNCA agregar dependencia sin verificar**: confirmar que sigue activa y la versión más reciente compatible con el stack; si Context7 reporta deprecación, NO usarla — buscar la alternativa migrada.
+- **NUNCA generar código con API obsoleta**: si el contexto del modelo difiere de lo que Context7 reporta como actual, usar lo de Context7 (documentar en comentario corto la versión consultada si la API es notable).
+- **NUNCA copiar ejemplos de la web sin verificar versión**: todo ejemplo obtenido vía WebSearch/WebFetch (Stack Overflow, blogs, tutoriales) se valida contra Context7 antes de incorporarlo.
 
 ## Excepción: Context7 no responde o no tiene la librería
 
-Si Context7 no tiene documentación disponible para una librería
-específica:
-
-1. **Documentar en el código** que Context7 no respondió y la API se
-   tomó de la fuente oficial (npm registry, docs del repo).
-2. **Verificar al menos**: la librería existe, no está deprecada en
-   npm/PyPI, su última publicación es reciente (≤ 12 meses).
-3. **NO bloquear** el flujo del usuario por este caso — proceder con
-   diligencia razonable.
-
----
+Documentar en el código que la API se tomó de la fuente oficial (npm registry, docs del repo);
+verificar al menos que la librería existe, no está deprecada en npm/PyPI y su última
+publicación es reciente (≤ 12 meses). NO bloquear el flujo del usuario — diligencia razonable.
 
 ## Auditoría retroactiva
 
-Esta regla aplica también al código existente del proyecto SWL:
-
-- Si durante un refactor se detecta una dependencia que arrastra
-  warnings de deprecación, abrir un ticket para auditarla con
-  Context7 y migrar si hay alternativa actual.
-- El comando `/swl:auditar-deps` (cuando esté disponible) debe
-  cruzar las dependencias del proyecto contra Context7 para
-  detectar deprecaciones silenciosas.
-
----
-
-## Aplicabilidad por agente
-
-| Agente | Aplica | Cuándo |
-|---|---|---|
-| `backend-python-swl` | SÍ | Al generar código FastAPI/Django/SQLAlchemy |
-| `backend-node-swl` | SÍ | Al generar código Express/Fastify/NestJS |
-| `backend-java-swl` | SÍ | Al generar código Spring Boot/JPA |
-| `backend-go-swl` | SÍ | Al generar código Go con frameworks |
-| `backend-rust-swl` | SÍ | Al generar código Axum/Actix |
-| `backend-csharp-swl` | SÍ | Al generar código ASP.NET Core |
-| `frontend-react-swl` | SÍ | Al generar código React/Next.js |
-| `frontend-angular-swl` | SÍ | Al generar código Angular |
-| `frontend-css-swl` | SÍ | Al usar PostCSS/Tailwind plugins |
-| `frontend-tailwind-swl` | SÍ | Al usar Tailwind v4+ APIs |
-| `frontend-swl` | SÍ | Al usar Vue/Svelte/Lit |
-| `mobile-android-swl` | SÍ | Al usar Jetpack Compose libs |
-| `mobile-ios-swl` | SÍ | Al usar SwiftUI/Combine |
-| `mobile-cross-swl` | SÍ | Al usar React Native/Flutter |
-| `implementador-swl` | SÍ | Generalista — siempre |
-| `llm-apps-swl` | SÍ | LangChain, OpenAI SDK, Anthropic SDK |
-| `pagos-swl` | SÍ | Stripe SDK actualizado |
-| `datos-swl` | SÍ | ORMs y drivers de BD |
-| `arquitecto-swl` | RECOMENDADO | Al evaluar tradeoffs entre librerías |
-| `revisor-codigo-swl` | RECOMENDADO | Al detectar deps deprecadas en review |
-| `revisor-seguridad-swl` | OBLIGATORIO | Al verificar CVEs de dependencias |
-| Resto de agentes | NO | No generan código con dependencias externas |
-
----
-
-## Checklist de consulta Context7
-
-Antes de marcar una tarea como completa:
-
-- [ ] ¿Las dependencias agregadas/usadas se verificaron contra Context7?
-- [ ] ¿La versión usada está alineada con la que Context7 reporta como actual?
-- [ ] ¿No hay imports de APIs deprecadas según Context7?
-- [ ] ¿Las dependencias transitivas conocidas no son warnings de
-      deprecación al instalar?
-- [ ] Si Context7 no tenía la librería, ¿se documentó el motivo?
-
----
-
-## Origen de esta regla
-
-Esta regla se formalizó tras observar en la primera instalación pública
-de `@saulwade/swl-ses@1.0.0` (2026-04-30) un warning de
-`prebuild-install@7.1.3 deprecated` arrastrado por
-`@xenova/transformers` que estaba en `optionalDependencies`. La
-dependencia se eligió en una iteración anterior sin verificar Context7;
-la migración oficial era `@huggingface/transformers`. El warning se vio
-en cada `npm install` del paquete distribuido. Resuelto en v1.0.1
-eliminando la dependencia opcional y elevando esta regla a obligatoria
-para que no se repita.
+Aplica también al código existente: dependencia con warnings de deprecación detectada en refactor → ticket para auditarla con Context7 y migrar si hay alternativa actual (`/swl:auditar-deps` cruza dependencias contra Context7).
 
-Memoria asociada: `feedback_usar_context7.md` (preferencia previa del
-usuario, formalizada como regla).
+Detalle extendido (los 3 tipos de defectos con casos, flujo con ejemplos de tools, tabla de aplicabilidad por agente, checklist, caso de origen `prebuild-install`): `Skill("meta-reglas-extendido")` → `recursos/usar-context7.md`.

package/reglas/usar-sistema-swl.md

@@ -1,251 +1,56 @@
 # Regla: Uso obligatorio del sistema SWL
 
-Esta regla es **OBLIGATORIA** y aplica a todo trabajo de Claude dentro de
-cualquier proyecto donde el sistema SWL esté instalado (presencia de
-`agentes/`, `habilidades/`, `comandos/swl/`, `reglas/` o `plugin.json` con
-`name: "@saulwade/swl-ses"`).
-
-Tiene prioridad sobre la inercia natural del modelo a hacer trabajo directo
-con Read/Write/Edit/Bash cuando existe un agente, skill o comando SWL
-específico para la tarea.
-
----
-
-## Por qué existe esta regla
-
-El sistema SWL se instaló específicamente para que Claude **no haga trabajo
-directo cuando hay un componente especializado**. El patrón recurrente que
-esta regla cierra es:
-
-- Implementar con Read/Write/Edit en vez de invocar `implementador-swl` o el
-  agente de stack (`backend-python-swl`, `frontend-react-swl`, etc.).
-- Hacer commits sin invocar `revisor-codigo-swl` ni `revisor-seguridad-swl`.
-- Escribir código sin cargar el skill de stack correspondiente
-  (`fastapi-experto`, `react-experto`, `angular-moderno`).
-- Implementar features sin pasar por `/swl:discutir-fase` → `/swl:planear-fase`
-  → `/swl:ejecutar-fase` cuando el alcance lo justifica.
-- Diferir scope (entregar read-only cuando el plan decía CRUD) sin invocar al
-  planificador ni crear DA formal — viola `arreglar-al-detectar.md`.
-
-El patrón es costoso y reproducible. La regla `arreglar-al-detectar.md`
-prohíbe la deuda silenciosa; esta regla cierra la causa raíz: saltarse el
-flujo SWL desde el inicio.
-
----
+Regla **OBLIGATORIA** en todo proyecto con SWL instalado (presencia de `agentes/`, `habilidades/`, `comandos/swl/`, `reglas/` o `plugin.json` con `name: "@saulwade/swl-ses"`). Tiene prioridad sobre la inercia de hacer trabajo directo con Read/Write/Edit/Bash cuando existe un componente SWL específico para la tarea.
 
 ## Principio
 
-> Cuando exista un agente, skill o comando SWL aplicable a la tarea actual,
-> **usarlo es obligatorio**. Hacer trabajo directo con herramientas básicas
-> (Read/Write/Edit/Bash/Grep/Glob) cuando un componente especializado lo
-> cubre mejor es violación de esta regla.
-
-El sistema SWL es la herramienta del usuario — saltársela sin justificación
-es decisión que la regla `debatir-antes-de-aceptar.md` exige debatir antes
-de ejecutar.
+> Cuando exista un agente, skill o comando SWL aplicable a la tarea actual, **usarlo es obligatorio**. El trabajo directo con herramientas básicas solo procede dentro de las excepciones legítimas; saltarse SWL sin justificación es decisión que `debatir-antes-de-aceptar.md` exige debatir antes de ejecutar.
 
----
+**PASO 0 obligatorio** antes de la primera tool call sustantiva: consultar memoria previa (`Skill("memoria-busqueda")`, APRENDIZAJES.md, `.planning/adrs/`, vault Obsidian si aplica) — empezar sin consultar es reabrir decisiones cerradas. Después: ¿la tarea cabe en la matriz? → identificar el componente → cargar el skill ANTES de implementar → revisar antes de commit.
 
 ## Matriz operacional: cuándo usar qué
 
-### Para tareas de desarrollo
-
-| Tarea | Componente SWL obligatorio | Componente directo NO basta porque |
-|---|---|---|
-| Feature nueva > 50 LOC o multi-archivo | `/swl:discutir-fase` → `/swl:planear-fase` → `/swl:ejecutar-fase` o `orquestador-swl` | Sin discovery el scope queda implícito y diverge en ejecución |
-| Implementación backend Python/Node/Java/Go/Rust/C# | `backend-python-swl` / `backend-node-swl` / etc. + `Skill("<framework>-experto")` | El skill carga gotchas críticos (ej: MissingGreenlet en SQLAlchemy async) |
-| Implementación frontend React/Angular/Vue/Svelte | `frontend-react-swl` / `frontend-angular-swl` / `frontend-swl` + skill correspondiente | Los skills traen patrones modernos (signals, RSC, Suspense) que el modelo no actualiza solo |
-| Implementación mobile Android/iOS/RN/Flutter | `mobile-android-swl` / `mobile-ios-swl` / `mobile-cross-swl` | Casos edge de plataforma (Core Data, baseline profiles) |
-| Bug con stack trace o reproducible | `depurador-swl` con método científico | Saltar al fix sin hipótesis aislada falla con frecuencia |
-| Refactor masivo o migración schema | `migrador-swl` | Exige plan de rollback + expand-contract, no improvisar |
-
-### Para tareas de calidad
-
-| Tarea | Componente SWL obligatorio |
-|---|---|
-| Pre-merge a main | `/swl:revisar` o `revisor-codigo-swl` + `revisor-seguridad-swl` |
-| Verificación post-fase | `/swl:verificar` con `Skill("verificar-trabajo")` (goal-backward 4 niveles) |
-| Auditoría de calidad | `Skill("checklist-calidad")` con score ≥9.0 |
-| Tests nuevos | `tdd-qa-swl` (ciclo RED→GREEN→REFACTOR) |
-| Auditoría de seguridad | `Skill("checklist-seguridad")` (OWASP Top 10 + A11) |
-| Detectar funcionalidad duplicada | `Skill("swl-revisar-impacto")` o `revisor-codigo-swl` con veto DRY mayor |
-
-### Para tareas de proceso
-
-| Tarea | Componente SWL obligatorio |
-|---|---|
-| Cierre de sesión productiva | `/swl:compactar` + `/swl:aprender` |
-| Capturar aprendizaje recurrente | `/swl:aprender` → APRENDIZAJES.md → posible promoción a regla/skill |
-| Release con bump de versión | `/swl:release` (sincronización de ubicaciones de versión) |
-| Documentación viva post-feature | `documentador-swl` |
-| Diagnóstico del sistema | `/swl:status salud` |
-
-### Para tareas de búsqueda y contexto
-
-| Tarea | Componente SWL obligatorio |
-|---|---|
-| Contexto de dominio previo | `Skill("memoria-busqueda")` sobre `.planning/sessions/` y APRENDIZAJES.md |
-| Investigación tecnológica | `investigador-swl` con WebSearch/WebFetch + `Skill("agent-browser")` |
-| Verificar dependencia externa | Consultar Context7 (regla `usar-context7.md`) |
-| Decisiones repetibles del proyecto | Revisar `.planning/adrs/`, APRENDIZAJES.md, `instintos/proyecto.yaml` ANTES de proponer solución |
-
----
-
-## Excepciones legítimas
-
-NO aplicar esta regla cuando:
-
-1. **Tarea trivial de 1-2 archivos**: rename, fix de typo, ajuste de comentario,
-   formato. El overhead de invocar agente supera el valor.
-2. **Pregunta de lectura pura**: "¿qué hace este archivo?", "¿dónde se define
-   X?". Usar Read/Grep directos.
-3. **Comando de shell puro**: `git status`, `npm install`, `gh pr list`.
-4. **Sesión exploratoria explícita**: el usuario pidió "explora", "echa un
-   vistazo", "investiga sin tocar nada".
-5. **Override explícito del usuario**: "no uses agentes, hazlo directo".
-   Respetar la instrucción explícita; registrar la excepción si tiene impacto
-   en flujo posterior.
-6. **Fix urgente de producción** con incidente activo: aplicar fix mínimo,
-   el agente puede esperar al post-mortem.
-7. **Proyecto sin SWL instalado**: si no hay `plugin.json` ni `agentes/` en
-   el proyecto, la regla no aplica.
-
----
-
-## Anti-patrones explícitos
-
-### Anti-patrón 1: implementar feature compleja con Read+Write directo
-
-❌ **MAL**: el usuario pide "agrega CRUD para entidad X", Claude empieza a
-escribir el modelo + endpoint + frontend + tests con Read+Write secuenciales,
-sin pasar por `/swl:planear-fase` ni invocar `backend-python-swl`.
-
-✅ **BIEN**: invocar `/swl:discutir-fase` para extraer decisiones,
-`/swl:planear-fase` para descomponer en tareas atómicas, `/swl:ejecutar-fase`
-que delega a `implementador-swl` o agente de stack con skill cargado.
-
-### Anti-patrón 2: commit sin revisión
-
-❌ **MAL**: terminar implementación y hacer `git add . && git commit` sin
-pasar por `revisor-codigo-swl` ni `revisor-seguridad-swl`.
-
-✅ **BIEN**: `/swl:revisar` antes del commit. Score ≥ 9.0 obligatorio. Si
-hay veto items, corregir antes de mergear.
-
-### Anti-patrón 3: divergir del plan sin reconfirmar scope
-
-❌ **MAL**: plan decía "CRUD completo", entregar read-only documentando en
-commit "la edición se agrega en iteración posterior". Es deuda silenciosa
-prohibida por `arreglar-al-detectar.md`.
-
-✅ **BIEN**: si durante ejecución se detecta que el scope original es muy
-grande, pausar, invocar `planificador-swl` para re-planificar, o crear DA
-formal con trigger verificable. NUNCA diferir scope en commit silencioso.
-
-### Anti-patrón 4: implementar con framework sin cargar el skill correspondiente
-
-❌ **MAL**: escribir FastAPI con SQLAlchemy async sin cargar
-`Skill("fastapi-experto")` — alta probabilidad de incurrir en MissingGreenlet
-por lazy loading.
-
-✅ **BIEN**: cargar el skill ANTES de la primera línea. El skill trae los
-gotchas específicos que el modelo no recuerda solo.
-
-### Anti-patrón 5: detectar funcionalidad duplicada y commitearla igual
-
-❌ **MAL**: durante implementación detectar que `/catalogos` ya tiene lo
-mismo que se está agregando en `/catalogos-contratacion` pero commitearlo
-porque "el plan decía implementarlo aquí". Pérdida de DRY.
-
-✅ **BIEN**: pausar, invocar `revisor-codigo-swl` o `Skill("swl-revisar-impacto")`,
-reportar la duplicación al usuario, esperar decisión de scope.
-
-### Anti-patrón 6: usar agente especializado como "etiqueta cosmética"
-
-❌ **MAL**: decir "estoy invocando implementador-swl" pero seguir trabajando
-con Read+Write+Edit personalmente sin lanzar el Agent tool.
-
-✅ **BIEN**: invocación real con el tool Agent. El sub-agente recibe contexto
-acotado, opera con sus permisos declarados y devuelve resultado.
-
----
-
-## Checklist antes de empezar cualquier tarea
-
-Antes de la primera tool call sustantiva:
-
-- [ ] **PASO 0 — Consultar memoria previa** (`Skill("memoria-busqueda")`,
-      APRENDIZAJES.md, `.planning/adrs/`, vault Obsidian si aplica). El
-      proyecto tiene decisiones ya tomadas y patrones validados que se
-      repiten. Empezar sin consultar es reabrir decisiones cerradas.
-- [ ] ¿La tarea cabe en alguna fila de la **matriz operacional**?
-- [ ] Si sí: ¿identifiqué el agente, skill o comando SWL correspondiente?
-- [ ] ¿Cargué el skill relevante con `Skill("nombre")` antes de implementar?
-- [ ] Si la tarea es no trivial: ¿pasó por el flujo discutir → planear → ejecutar?
-- [ ] Si voy a hacer trabajo directo: ¿estoy dentro de las **excepciones
-      legítimas**? Si no, esta regla me obliga a usar el componente SWL.
-- [ ] Antes de commit: ¿pasé por revisor de código + seguridad?
-
----
-
-## Cómo recuperarse si ya empecé directo
-
-Si avancé con trabajo directo y al revisar esta regla detecto que debí usar
-un componente SWL:
-
-1. **Trabajo trivial y reversible**: aceptar el atajo, registrar la
-   excepción mentalmente, terminar.
-2. **Trabajo sustantivo pero sin commit**: invocar el componente SWL ahora
-   (revisor / verificar / planificador retrospectivo) antes del commit. Aún
-   se gana cobertura.
-3. **Ya se commiteó**: ejecutar `/swl:verificar` post-hoc. Si encuentra
-   hallazgos, corregir en commit siguiente bajo `arreglar-al-detectar.md`.
-4. **El patrón se repite en la sesión**: invocar `/swl:aprender` para
-   capturar el feedback explícitamente y reforzar el comportamiento futuro.
-
----
-
-## Aplicabilidad
-
-Aplica a:
-
-- Claude Code (CLI, Desktop, IDE) operando dentro de proyectos con SWL
-  instalado.
-- Sesiones de implementación, debugging, refactor, revisión, planning.
-- Cualquier ciclo GSD (Goal-Seeking Development).
-
-NO aplica a:
-
-- Proyectos sin SWL instalado.
-- Repos de terceros, exploración de código ajeno (`temp/`, dependencias
-  npm/pip).
-- Tareas administrativas puras del sistema (instalar SWL, configurar Claude
-  Code).
-
----
-
-## Relación con otras reglas
-
-- `arreglar-al-detectar.md` — la deuda silenciosa de scope (anti-patrón 3
-  aquí) es exactamente lo que prohíbe esa regla.
-- `debatir-antes-de-aceptar.md` — saltarse SWL sin justificación es decisión
-  que choca con regla documentada → exige debate, no ejecución silenciosa.
-- `brevedad-output.md` — cubre idioma y eficiencia de tokens; esta regla
-  cubre flujo de trabajo.
-- `skills-estandar.md` — cubre cómo escribir skills (autor); esta regla
-  cubre cómo usarlos (consumidor).
-- `usar-context7.md` — regla hermana: consultar documentación de librerías
-  externas antes de implementar.
-
----
-
-## Checklist de auto-verificación al final del turno
-
-Al cerrar un turno con trabajo sustantivo:
-
-- [ ] ¿Invoqué los agentes/skills/comandos SWL aplicables o estuve dentro
-      de las excepciones legítimas?
-- [ ] Si hice trabajo directo: ¿la decisión está justificada por una
-      excepción concreta, no por inercia?
-- [ ] Si detecto que omití un componente que debí usar: ¿lo invoco
-      retrospectivamente antes del commit final?
+**Desarrollo**
+- Feature nueva >50 LOC o multi-archivo → `/swl:discutir-fase` → `/swl:planear-fase` → `/swl:ejecutar-fase` u `orquestador-swl` (sin discovery el scope queda implícito y diverge).
+- Implementación por stack (backend Python/Node/Java/Go/Rust/C#; frontend React/Angular/Vue/Svelte; mobile Android/iOS/RN/Flutter) → agente `backend-*` / `frontend-*` / `mobile-*-swl` + `Skill("<framework>-experto")` (los skills traen gotchas y patrones modernos que el modelo no actualiza solo).
+- Bug con stack trace o reproducible → `depurador-swl` (método científico; saltar al fix sin hipótesis aislada falla con frecuencia).
+- Refactor masivo o migración de schema → `migrador-swl` (plan de rollback + expand-contract, no improvisar).
+
+**Calidad**
+- Pre-merge a main → `/swl:revisar` o `revisor-codigo-swl` + `revisor-seguridad-swl`.
+- Verificación post-fase → `/swl:verificar` con `Skill("verificar-trabajo")` (goal-backward 4 niveles).
+- Auditoría de calidad → `Skill("checklist-calidad")` score ≥9.0; de seguridad → `Skill("checklist-seguridad")` (OWASP Top 10 + A11).
+- Tests nuevos → `tdd-qa-swl` (ciclo RED→GREEN→REFACTOR).
+- Funcionalidad duplicada → `Skill("swl-revisar-impacto")` o `revisor-codigo-swl` con veto DRY mayor.
+
+**Proceso**
+- Cierre de sesión productiva → `/swl:compactar` + `/swl:aprender`; aprendizaje recurrente → `/swl:aprender` → APRENDIZAJES.md → posible promoción a regla/skill.
+- Release con bump → `/swl:release`; documentación viva post-feature → `documentador-swl`; diagnóstico del sistema → `/swl:status salud`.
+
+**Búsqueda y contexto**
+- Contexto de dominio previo → `Skill("memoria-busqueda")` sobre `.planning/sessions/` y APRENDIZAJES.md.
+- Investigación tecnológica → `investigador-swl` (WebSearch/WebFetch + `Skill("agent-browser")`); dependencia externa → Context7 (`usar-context7.md`).
+- Decisiones repetibles del proyecto → revisar `.planning/adrs/`, APRENDIZAJES.md, `instintos/proyecto.yaml` ANTES de proponer solución.
+
+## Excepciones legítimas (las únicas)
+
+1. Tarea trivial de 1-2 archivos (rename, typo, comentario, formato) — el overhead de invocar agente supera el valor.
+2. Pregunta de lectura pura ("¿qué hace este archivo?", "¿dónde se define X?") — Read/Grep directos.
+3. Comando de shell puro (`git status`, `npm install`, `gh pr list`).
+4. Sesión exploratoria explícita ("explora", "echa un vistazo", "investiga sin tocar nada").
+5. Override explícito del usuario ("no uses agentes, hazlo directo") — respetar; registrar la excepción si impacta el flujo posterior.
+6. Fix urgente de producción con incidente activo — fix mínimo; el agente puede esperar al post-mortem.
+7. Proyecto sin SWL instalado (sin `plugin.json` ni `agentes/`) — la regla no aplica.
+
+## Anti-patrones (prohibidos)
+
+- Implementar feature compleja con Read+Write directo sin pasar por discutir → planear → ejecutar.
+- Commit sin revisor de código + seguridad (score ≥9.0 obligatorio; veto items corregidos antes de mergear).
+- Divergir del plan sin re-planificar ni DA formal con trigger verificable — deuda silenciosa (`arreglar-al-detectar.md`).
+- Implementar con framework sin cargar su skill ANTES de la primera línea.
+- Detectar funcionalidad duplicada y commitearla igual "porque el plan decía implementarlo aquí".
+- "Etiqueta cosmética": decir que invocas un agente sin lanzar el Agent tool real — la invocación debe ser efectiva, con contexto acotado y permisos declarados.
+
+Si ya empezaste directo: invocar el componente retrospectivamente antes del commit (revisor / verificar / planificador); si ya se commiteó, `/swl:verificar` post-hoc y corregir hallazgos en el commit siguiente.
+
+Detalle extendido (por qué existe, matriz con justificaciones, anti-patrones MAL/BIEN, recuperación completa, checklists, aplicabilidad, relación con otras reglas): `Skill("meta-reglas-extendido")` → `recursos/usar-sistema-swl.md`.