@saulwade/swl-ses 2.6.0 → 2.8.0

package/comandos/swl/cron.md

@@ -1,194 +1,194 @@
----
-name: swl:cron
-description: Gestiona tareas programadas del sistema SWL. Crear, listar, pausar, reanudar y eliminar jobs recurrentes. Soporta 4 formatos de schedule (duración, intervalo, cron, timestamp ISO). Los jobs se almacenan en .planning/cron/jobs.json.
-allowed_tools: ["Read", "Write", "Edit", "Bash", "Glob", "Grep"]
-user-invocable: true
-version: "1.0.0"
----
-
-# /swl:cron — Gestión de tareas programadas
-
-Eres el gestor de tareas programadas del sistema SWL. Administras jobs que se ejecutan automáticamente según un schedule definido.
-
-## Subcomandos
-
-| Subcomando | Descripción |
-|-----------|-------------|
-| `list` | Lista todos los jobs con estado, schedule y próxima ejecución |
-| `add` | Crear un nuevo job (guía interactiva) |
-| `remove <id>` | Eliminar un job |
-| `pause <id>` | Pausar un job sin eliminarlo |
-| `resume <id>` | Reanudar un job pausado |
-| `log [N]` | Mostrar últimas N ejecuciones |
-| `start` | Iniciar el scheduler daemon |
-| `run <id>` | Ejecutar un job manualmente (una vez, sin afectar schedule) |
-
-## Formatos de schedule soportados
-
-| Formato | Ejemplo | Descripción |
-|---------|---------|-------------|
-| Duración única | `30m`, `2h`, `1d` | Ejecutar una vez en N minutos/horas/días |
-| Intervalo recurrente | `every 30m`, `every 2h` | Ejecutar cada N periódicamente |
-| Expresión cron | `0 9 * * 1-5` | Cron estándar de 5 campos |
-| Timestamp ISO | `2026-04-15T09:00` | Una vez a hora exacta |
-| **Lenguaje natural (es-MX)** | `cada lunes a las 9am` | El comando lo traduce al formato técnico |
-
-### Traducción de lenguaje natural
-
-Si el usuario describe el schedule con una frase en español, tradúcela a cron
-o a los formatos técnicos ANTES de guardar. Ejemplos de traducción:
-
-| Frase del usuario | Traducción |
-|---|---|
-| "cada lunes a las 9am" / "todos los lunes 9 de la mañana" | `0 9 * * 1` |
-| "cada día a las 8:30" | `30 8 * * *` |
-| "cada hora" | `every 1h` |
-| "cada 30 minutos" | `every 30m` |
-| "de lunes a viernes a las 9am" | `0 9 * * 1-5` |
-| "cada primer día del mes" / "el 1 de cada mes a medianoche" | `0 0 1 * *` |
-| "cada domingo a las 23:00" | `0 23 * * 0` |
-| "cada 2 horas en horario laboral" | `0 9-18/2 * * 1-5` |
-| "en 30 minutos" (one-shot) | `30m` |
-| "mañana a las 10am" (one-shot) | `<timestamp ISO calculado>` |
-| "dentro de una semana" (one-shot) | `7d` |
-
-**Reglas de traducción:**
-
-1. **Días de la semana**: lunes=1, martes=2, …, sábado=6, domingo=0 (estándar cron).
-2. **Horas**: interpretar "de la mañana"/"am" = 0-11; "de la tarde"/"pm" = 12-23.
-3. **Zona horaria**: asumir la local del sistema salvo que el usuario especifique una.
-4. **Ambigüedad**: si la frase es ambigua ("a veces", "pronto", "seguido"), pregunta
-   al usuario antes de guardar. Nunca inventes un valor por "parecerse".
-5. **Validación obligatoria**: después de traducir, MOSTRAR al usuario la expresión
-   técnica resultante y la próxima ejecución estimada, y pedir confirmación:
-
-   ```
-   Traduje "cada lunes a las 9am" → `0 9 * * 1`
-   Próxima ejecución: lunes 21 de abril 2026, 09:00:00 (hora local)
-   ¿Confirmas? (sí / no / corrige la frase)
-   ```
-
-6. **No guardar** hasta confirmación explícita.
-
-## Subcomando: list
-
-```bash
-node -e "const s=require('./gateway/cron/store'); const jobs=s.loadJobs(process.cwd()); console.log(JSON.stringify(jobs,null,2))"
-```
-
-Mostrar como tabla formateada:
-```
-=== Jobs programados ===
-
-| ID | Nombre | Schedule | Estado | Próxima ejecución | Última |
-|----|--------|----------|--------|-------------------|--------|
-```
-
-Si no hay jobs: "No hay tareas programadas. Usa `/swl:cron add` para crear una."
-
-## Subcomando: add
-
-Preguntar al usuario:
-1. **Nombre**: descripción breve del job
-2. **Comando**: qué ejecutar (ej: `node bin/swl-ses.js doctor --json`)
-3. **Schedule**: puede ser en lenguaje natural (ej: "cada lunes a las 9am") o
-   en formato técnico. Si es lenguaje natural, traducir según la tabla de la
-   sección **Traducción de lenguaje natural** y CONFIRMAR con el usuario la
-   expresión técnica resultante antes de continuar.
-4. **Entrega**: dónde entregar el resultado (`local`, `telegram`, `discord`)
-
-Crear el job:
-```javascript
-const store = require('./gateway/cron/store');
-store.addJob(process.cwd(), {
-  name: '[nombre]',
-  schedule: '[schedule]',
-  command: '[comando]',
-  deliver: '[destino]',
-});
-```
-
-Jobs sugeridos para el sistema SWL:
-- **Salud diaria**: `node bin/swl-ses.js doctor` — schedule `0 9 * * 1-5`
-- **Auditoría de deps semanal**: `npm audit --json` — schedule `0 10 * * 1`
-- **Backup de instintos**: `cp instintos/proyecto.yaml .planning/backups/` — schedule `every 1d`
-
-## Subcomando: remove <id>
-
-```javascript
-const store = require('./gateway/cron/store');
-store.removeJob(process.cwd(), '[id]');
-```
-
-Confirmar antes de eliminar.
-
-## Subcomando: pause / resume
-
-```javascript
-store.pauseJob(process.cwd(), '[id]');
-store.resumeJob(process.cwd(), '[id]');
-```
-
-## Subcomando: log
-
-```javascript
-const store = require('./gateway/cron/store');
-const log = store.readLog(process.cwd(), N);
-```
-
-Mostrar como tabla con fecha, job, status y output resumido.
-
-## Subcomando: start
-
-```bash
-node gateway/cron/scheduler.js
-```
-
-Inicia el scheduler. Muestra PID y confirma que el lock fue adquirido.
-
-## Subcomando: run <id>
-
-Ejecuta un job manualmente sin afectar su schedule normal:
-```javascript
-const { executeJob, deliverResult } = require('./gateway/cron/scheduler');
-const store = require('./gateway/cron/store');
-const jobs = store.loadJobs(process.cwd());
-const job = jobs.find(j => j.id === '[id]');
-const result = executeJob(job, process.cwd());
-deliverResult(job, result, process.cwd());
-```
-
-## Parser de lenguaje natural programático (experimental)
-
-El subcomando `swl-ses schedule-parse` parsea frases en inglés a expresiones
-cron (resuelve cross-scope; ver `docs/invocacion-cli-cross-scope.md`). No
-requiere dependencias externas.
-
-```bash
-# "every morning at 9am" → { "cron": "0 9 * * *", "descripcion": "Diariamente a las 9 AM" }
-swl-ses schedule-parse "every morning at 9am"
-# fallback: npx -y @saulwade/swl-ses@latest schedule-parse "every morning at 9am"
-```
-
-La verificación de si un cron debe ejecutarse ahora (`isCronDue`) la usa el
-motor de scheduling internamente; no se expone como subcomando.
-
-Frases reconocidas:
-- `"hourly"` → `0 * * * *`
-- `"daily"` / `"every day"` → `0 9 * * *`
-- `"weekly"` → `0 9 * * 1`
-- `"every N minutes"` (1-59) → `*/N * * * *`
-- `"every N hours"` (1-23) → `0 */N * * *`
-- `"every morning at 9am"` / `"daily at 14:30"` → expresión con hora específica
-- `"every monday at 9am"` / `"weekly on friday"` → expresión con día de semana
-- Expresión cron cruda de 5 campos → passthrough sin modificar
-
-Para frases en español, la traducción manual (tabla de la sección anterior)
-sigue siendo el método principal — el parser solo opera en inglés.
-
-## Reglas de comportamiento
-
-- SIEMPRE confirmar antes de eliminar un job
-- SIEMPRE mostrar el schedule en formato legible junto al formato técnico
-- Los jobs con `deliver: telegram/discord` requieren que el gateway esté configurado
-- El scheduler usa file lock exclusivo — solo una instancia puede correr a la vez
+---
+name: swl:cron
+description: Gestiona tareas programadas del sistema SWL. Crear, listar, pausar, reanudar y eliminar jobs recurrentes. Soporta 4 formatos de schedule (duración, intervalo, cron, timestamp ISO). Los jobs se almacenan en .planning/cron/jobs.json.
+allowed_tools: ["Read", "Write", "Edit", "Bash", "Glob", "Grep"]
+user-invocable: true
+version: "1.0.0"
+---
+
+# /swl:cron — Gestión de tareas programadas
+
+Eres el gestor de tareas programadas del sistema SWL. Administras jobs que se ejecutan automáticamente según un schedule definido.
+
+## Subcomandos
+
+| Subcomando | Descripción |
+|-----------|-------------|
+| `list` | Lista todos los jobs con estado, schedule y próxima ejecución |
+| `add` | Crear un nuevo job (guía interactiva) |
+| `remove <id>` | Eliminar un job |
+| `pause <id>` | Pausar un job sin eliminarlo |
+| `resume <id>` | Reanudar un job pausado |
+| `log [N]` | Mostrar últimas N ejecuciones |
+| `start` | Iniciar el scheduler daemon |
+| `run <id>` | Ejecutar un job manualmente (una vez, sin afectar schedule) |
+
+## Formatos de schedule soportados
+
+| Formato | Ejemplo | Descripción |
+|---------|---------|-------------|
+| Duración única | `30m`, `2h`, `1d` | Ejecutar una vez en N minutos/horas/días |
+| Intervalo recurrente | `every 30m`, `every 2h` | Ejecutar cada N periódicamente |
+| Expresión cron | `0 9 * * 1-5` | Cron estándar de 5 campos |
+| Timestamp ISO | `2026-04-15T09:00` | Una vez a hora exacta |
+| **Lenguaje natural (es-MX)** | `cada lunes a las 9am` | El comando lo traduce al formato técnico |
+
+### Traducción de lenguaje natural
+
+Si el usuario describe el schedule con una frase en español, tradúcela a cron
+o a los formatos técnicos ANTES de guardar. Ejemplos de traducción:
+
+| Frase del usuario | Traducción |
+|---|---|
+| "cada lunes a las 9am" / "todos los lunes 9 de la mañana" | `0 9 * * 1` |
+| "cada día a las 8:30" | `30 8 * * *` |
+| "cada hora" | `every 1h` |
+| "cada 30 minutos" | `every 30m` |
+| "de lunes a viernes a las 9am" | `0 9 * * 1-5` |
+| "cada primer día del mes" / "el 1 de cada mes a medianoche" | `0 0 1 * *` |
+| "cada domingo a las 23:00" | `0 23 * * 0` |
+| "cada 2 horas en horario laboral" | `0 9-18/2 * * 1-5` |
+| "en 30 minutos" (one-shot) | `30m` |
+| "mañana a las 10am" (one-shot) | `<timestamp ISO calculado>` |
+| "dentro de una semana" (one-shot) | `7d` |
+
+**Reglas de traducción:**
+
+1. **Días de la semana**: lunes=1, martes=2, …, sábado=6, domingo=0 (estándar cron).
+2. **Horas**: interpretar "de la mañana"/"am" = 0-11; "de la tarde"/"pm" = 12-23.
+3. **Zona horaria**: asumir la local del sistema salvo que el usuario especifique una.
+4. **Ambigüedad**: si la frase es ambigua ("a veces", "pronto", "seguido"), pregunta
+   al usuario antes de guardar. Nunca inventes un valor por "parecerse".
+5. **Validación obligatoria**: después de traducir, MOSTRAR al usuario la expresión
+   técnica resultante y la próxima ejecución estimada, y pedir confirmación:
+
+   ```
+   Traduje "cada lunes a las 9am" → `0 9 * * 1`
+   Próxima ejecución: lunes 21 de abril 2026, 09:00:00 (hora local)
+   ¿Confirmas? (sí / no / corrige la frase)
+   ```
+
+6. **No guardar** hasta confirmación explícita.
+
+## Subcomando: list
+
+```bash
+node -e "const s=require('./gateway/cron/store'); const jobs=s.loadJobs(process.cwd()); console.log(JSON.stringify(jobs,null,2))"
+```
+
+Mostrar como tabla formateada:
+```
+=== Jobs programados ===
+
+| ID | Nombre | Schedule | Estado | Próxima ejecución | Última |
+|----|--------|----------|--------|-------------------|--------|
+```
+
+Si no hay jobs: "No hay tareas programadas. Usa `/swl:cron add` para crear una."
+
+## Subcomando: add
+
+Preguntar al usuario:
+1. **Nombre**: descripción breve del job
+2. **Comando**: qué ejecutar (ej: `node bin/swl-ses.js doctor --json`)
+3. **Schedule**: puede ser en lenguaje natural (ej: "cada lunes a las 9am") o
+   en formato técnico. Si es lenguaje natural, traducir según la tabla de la
+   sección **Traducción de lenguaje natural** y CONFIRMAR con el usuario la
+   expresión técnica resultante antes de continuar.
+4. **Entrega**: dónde entregar el resultado (`local`, `telegram`, `discord`)
+
+Crear el job:
+```javascript
+const store = require('./gateway/cron/store');
+store.addJob(process.cwd(), {
+  name: '[nombre]',
+  schedule: '[schedule]',
+  command: '[comando]',
+  deliver: '[destino]',
+});
+```
+
+Jobs sugeridos para el sistema SWL:
+- **Salud diaria**: `node bin/swl-ses.js doctor` — schedule `0 9 * * 1-5`
+- **Auditoría de deps semanal**: `npm audit --json` — schedule `0 10 * * 1`
+- **Backup de instintos**: `cp instintos/proyecto.yaml .planning/backups/` — schedule `every 1d`
+
+## Subcomando: remove <id>
+
+```javascript
+const store = require('./gateway/cron/store');
+store.removeJob(process.cwd(), '[id]');
+```
+
+Confirmar antes de eliminar.
+
+## Subcomando: pause / resume
+
+```javascript
+store.pauseJob(process.cwd(), '[id]');
+store.resumeJob(process.cwd(), '[id]');
+```
+
+## Subcomando: log
+
+```javascript
+const store = require('./gateway/cron/store');
+const log = store.readLog(process.cwd(), N);
+```
+
+Mostrar como tabla con fecha, job, status y output resumido.
+
+## Subcomando: start
+
+```bash
+node gateway/cron/scheduler.js
+```
+
+Inicia el scheduler. Muestra PID y confirma que el lock fue adquirido.
+
+## Subcomando: run <id>
+
+Ejecuta un job manualmente sin afectar su schedule normal:
+```javascript
+const { executeJob, deliverResult } = require('./gateway/cron/scheduler');
+const store = require('./gateway/cron/store');
+const jobs = store.loadJobs(process.cwd());
+const job = jobs.find(j => j.id === '[id]');
+const result = executeJob(job, process.cwd());
+deliverResult(job, result, process.cwd());
+```
+
+## Parser de lenguaje natural programático (experimental)
+
+El subcomando `swl-ses schedule-parse` parsea frases en inglés a expresiones
+cron (resuelve cross-scope; ver `docs/invocacion-cli-cross-scope.md`). No
+requiere dependencias externas.
+
+```bash
+# "every morning at 9am" → { "cron": "0 9 * * *", "descripcion": "Diariamente a las 9 AM" }
+swl-ses schedule-parse "every morning at 9am"
+# fallback: npx -y @saulwade/swl-ses@latest schedule-parse "every morning at 9am"
+```
+
+La verificación de si un cron debe ejecutarse ahora (`isCronDue`) la usa el
+motor de scheduling internamente; no se expone como subcomando.
+
+Frases reconocidas:
+- `"hourly"` → `0 * * * *`
+- `"daily"` / `"every day"` → `0 9 * * *`
+- `"weekly"` → `0 9 * * 1`
+- `"every N minutes"` (1-59) → `*/N * * * *`
+- `"every N hours"` (1-23) → `0 */N * * *`
+- `"every morning at 9am"` / `"daily at 14:30"` → expresión con hora específica
+- `"every monday at 9am"` / `"weekly on friday"` → expresión con día de semana
+- Expresión cron cruda de 5 campos → passthrough sin modificar
+
+Para frases en español, la traducción manual (tabla de la sección anterior)
+sigue siendo el método principal — el parser solo opera en inglés.
+
+## Reglas de comportamiento
+
+- SIEMPRE confirmar antes de eliminar un job
+- SIEMPRE mostrar el schedule en formato legible junto al formato técnico
+- Los jobs con `deliver: telegram/discord` requieren que el gateway esté configurado
+- El scheduler usa file lock exclusivo — solo una instancia puede correr a la vez

package/comandos/swl/deuda-codigo.md

@@ -1,97 +1,97 @@
----
-name: swl:deuda-codigo
-description: Cosecha los marcadores `simplificado:` del código (simplificaciones deliberadas con techo y trigger de upgrade) hacia un ledger visible, detecta marcadores sin trigger (riesgo de rot) y sincroniza opcionalmente con .planning/DEUDA-TECNICA.md. Cargar cuando el usuario pida "qué simplificamos", "deuda de código", "cosecha los marcadores", o tras una fase que dejó marcadores simplificado:.
-allowed_tools: ["Grep", "Read", "Edit", "Bash"]
----
-
-# /swl:deuda-codigo — Cosecha de simplificaciones deliberadas
-
-Todo atajo intencional marcado con `simplificado: <techo>, <trigger>` (convención
-de `Skill("prevencion-sobreingenieria")`, adaptada del patrón `ponytail:` de
-ponytail, MIT) se cosecha aquí en un ledger — para que un "después" no se
-convierta en "nunca" (regla `arreglar-al-detectar.md`).
-
-## Uso
-
-```
-/swl:deuda-codigo              — Reporte en pantalla (no escribe nada)
-/swl:deuda-codigo --sync       — Además sincroniza a .planning/DEUDA-TECNICA.md
-/swl:deuda-codigo --owners     — Agrega autor por marcador (git blame)
-/swl:deuda-codigo <directorio> — Limita la cosecha a un subárbol
-```
-
-## Paso 1 — Cosechar los marcadores
-
-Buscar con Grep (herramienta, no shell) el patrón sobre el árbol del proyecto,
-excluyendo `node_modules`, `.git`, `dist`, `build`, `temp`, `respositorios-git`:
-
-```
-Grep(pattern: "(#|//|--|<!--|/\\*)\\s?simplificado:", output_mode: "content", -n: true)
-```
-
-Cada hit es una fila del ledger. El prefijo de comentario evita capturar prosa
-que solo menciona la convención (como este archivo o el SKILL.md).
-
-## Paso 2 — Parsear techo y trigger
-
-La convención es `simplificado: <techo>, <trigger de upgrade>`:
-
-- **techo**: el límite conocido del atajo (lock global, O(n²), heurística naive).
-- **trigger**: la condición observable que obliga el upgrade ("si throughput > X",
-  "cuando haya un segundo consumidor", "antes del primer deploy productivo").
-
-Si el texto tras `simplificado:` no contiene una condición observable,
-etiquetar la fila `sin-trigger` — esos son los que rotan en silencio.
-
-## Paso 3 — Reporte
-
-Una fila por marcador, agrupado por archivo:
-
-```
-## Ledger de simplificaciones — [fecha]
-
-| Ubicación | Qué se simplificó | Techo | Trigger de upgrade | Estado |
-|---|---|---|---|---|
-| src/locks.py:42 | lock global | contención con N workers | throughput > 500 rps | ok |
-| api/cache.js:17 | TTL fijo 5 min | staleness | (ninguno) | sin-trigger |
-
-Total: N marcadores, M sin trigger.
-```
-
-Con `--owners`: agregar columna con `git blame -L<línea>,<línea> --porcelain <archivo>`
-(solo el autor, una llamada por fila).
-
-Si no hay marcadores: `Sin deuda simplificado:. Ledger limpio.` — y terminar.
-
-## Paso 4 — Sincronizar al ledger formal (solo con --sync)
-
-Para cada marcador `sin-trigger` o de techo relevante que no exista ya en
-`.planning/DEUDA-TECNICA.md`:
-
-1. Leer el ledger actual y verificar duplicados por ubicación (`archivo:línea`).
-2. Agregar entrada `### DT-SIMPLIFICADO-<n>` con: ubicación, techo, trigger
-   (o `PENDIENTE DE TRIGGER` marcado como acción requerida), fecha de cosecha.
-3. Los `sin-trigger` NO se sincronizan como DT válidas hasta tener trigger:
-   reportarlos al usuario como acción inmediata — una DT sin trigger verificable
-   viola `arreglar-al-detectar.md § DT formal`.
-
-NUNCA borrar ni editar los marcadores del código durante la cosecha: el
-comando lee y reporta; el código solo cambia cuando el trigger se cumple y
-el upgrade se implementa.
-
-## Cuándo usarlo
-
-- Cierre de fase (`/swl:verificar` lo puede invocar como pasada complementaria).
-- Antes de un release: los `sin-trigger` son bloqueo blando (reportar en el gate).
-- Auditorías de deuda: junto con la sección "Sobre-ingeniería" de `/swl:revisar`.
-
-## Gotchas
-
-- **Marcadores en fixtures o docs**: los hits dentro de `tests/fixtures/`,
-  ejemplos de skills o este propio comando son material de referencia, no deuda
-  — excluirlos del conteo y decir cuántos se excluyeron (sin caps silenciosos).
-- **Prefijos de comentario por stack**: el patrón cubre `#` (Python/shell),
-  `//` (JS/TS/Go/Rust/C#/Java), `--` (SQL/Lua), `<!--` (HTML/MD) y `/*` (CSS/C).
-  Si el proyecto usa otro prefijo, agregarlo al patrón y decirlo en el reporte.
-- **`git blame` sobre archivos renombrados**: usar `git blame -M -C` si el
-  autor aparece como el commit del rename.
+---
+name: swl:deuda-codigo
+description: Cosecha los marcadores `simplificado:` del código (simplificaciones deliberadas con techo y trigger de upgrade) hacia un ledger visible, detecta marcadores sin trigger (riesgo de rot) y sincroniza opcionalmente con .planning/DEUDA-TECNICA.md. Cargar cuando el usuario pida "qué simplificamos", "deuda de código", "cosecha los marcadores", o tras una fase que dejó marcadores simplificado:.
+allowed_tools: ["Grep", "Read", "Edit", "Bash"]
+---
+
+# /swl:deuda-codigo — Cosecha de simplificaciones deliberadas
+
+Todo atajo intencional marcado con `simplificado: <techo>, <trigger>` (convención
+de `Skill("prevencion-sobreingenieria")`, adaptada del patrón `ponytail:` de
+ponytail, MIT) se cosecha aquí en un ledger — para que un "después" no se
+convierta en "nunca" (regla `arreglar-al-detectar.md`).
+
+## Uso
+
+```
+/swl:deuda-codigo              — Reporte en pantalla (no escribe nada)
+/swl:deuda-codigo --sync       — Además sincroniza a .planning/DEUDA-TECNICA.md
+/swl:deuda-codigo --owners     — Agrega autor por marcador (git blame)
+/swl:deuda-codigo <directorio> — Limita la cosecha a un subárbol
+```
+
+## Paso 1 — Cosechar los marcadores
+
+Buscar con Grep (herramienta, no shell) el patrón sobre el árbol del proyecto,
+excluyendo `node_modules`, `.git`, `dist`, `build`, `temp`, `respositorios-git`:
+
+```
+Grep(pattern: "(#|//|--|<!--|/\\*)\\s?simplificado:", output_mode: "content", -n: true)
+```
+
+Cada hit es una fila del ledger. El prefijo de comentario evita capturar prosa
+que solo menciona la convención (como este archivo o el SKILL.md).
+
+## Paso 2 — Parsear techo y trigger
+
+La convención es `simplificado: <techo>, <trigger de upgrade>`:
+
+- **techo**: el límite conocido del atajo (lock global, O(n²), heurística naive).
+- **trigger**: la condición observable que obliga el upgrade ("si throughput > X",
+  "cuando haya un segundo consumidor", "antes del primer deploy productivo").
+
+Si el texto tras `simplificado:` no contiene una condición observable,
+etiquetar la fila `sin-trigger` — esos son los que rotan en silencio.
+
+## Paso 3 — Reporte
+
+Una fila por marcador, agrupado por archivo:
+
+```
+## Ledger de simplificaciones — [fecha]
+
+| Ubicación | Qué se simplificó | Techo | Trigger de upgrade | Estado |
+|---|---|---|---|---|
+| src/locks.py:42 | lock global | contención con N workers | throughput > 500 rps | ok |
+| api/cache.js:17 | TTL fijo 5 min | staleness | (ninguno) | sin-trigger |
+
+Total: N marcadores, M sin trigger.
+```
+
+Con `--owners`: agregar columna con `git blame -L<línea>,<línea> --porcelain <archivo>`
+(solo el autor, una llamada por fila).
+
+Si no hay marcadores: `Sin deuda simplificado:. Ledger limpio.` — y terminar.
+
+## Paso 4 — Sincronizar al ledger formal (solo con --sync)
+
+Para cada marcador `sin-trigger` o de techo relevante que no exista ya en
+`.planning/DEUDA-TECNICA.md`:
+
+1. Leer el ledger actual y verificar duplicados por ubicación (`archivo:línea`).
+2. Agregar entrada `### DT-SIMPLIFICADO-<n>` con: ubicación, techo, trigger
+   (o `PENDIENTE DE TRIGGER` marcado como acción requerida), fecha de cosecha.
+3. Los `sin-trigger` NO se sincronizan como DT válidas hasta tener trigger:
+   reportarlos al usuario como acción inmediata — una DT sin trigger verificable
+   viola `arreglar-al-detectar.md § DT formal`.
+
+NUNCA borrar ni editar los marcadores del código durante la cosecha: el
+comando lee y reporta; el código solo cambia cuando el trigger se cumple y
+el upgrade se implementa.
+
+## Cuándo usarlo
+
+- Cierre de fase (`/swl:verificar` lo puede invocar como pasada complementaria).
+- Antes de un release: los `sin-trigger` son bloqueo blando (reportar en el gate).
+- Auditorías de deuda: junto con la sección "Sobre-ingeniería" de `/swl:revisar`.
+
+## Gotchas
+
+- **Marcadores en fixtures o docs**: los hits dentro de `tests/fixtures/`,
+  ejemplos de skills o este propio comando son material de referencia, no deuda
+  — excluirlos del conteo y decir cuántos se excluyeron (sin caps silenciosos).
+- **Prefijos de comentario por stack**: el patrón cubre `#` (Python/shell),
+  `//` (JS/TS/Go/Rust/C#/Java), `--` (SQL/Lua), `<!--` (HTML/MD) y `/*` (CSS/C).
+  Si el proyecto usa otro prefijo, agregarlo al patrón y decirlo en el reporte.
+- **`git blame` sobre archivos renombrados**: usar `git blame -M -C` si el
+  autor aparece como el commit del rename.