@tacuchi/agent-workflow-cli 9.3.0 → 10.1.0

package/skills/agent-workflow/commands/export-scripts.md

@@ -1,6 +1,6 @@
 ---
-description: Consolida N sesiones del workspace + `docs/scripts/` ya graduados en un paquete de paso a producción bajo `docs/scripts/NNN-export-scripts-YYYY-MM-DD/`. Genera manifest.md (informe + checklist + acciones manuales + git state + code-scan), por-sesion/ (bundle SQL organizado), por-tema/ (vista opt-in), rollback-global.sql y ORDER.md. Read-only. Refactor de /agent-workflow:release + /agent-workflow:release-scripts.
-argument-hint: (opcional) --since sessionNNN | --source <alias> | --themes slug1,slug2|infer | --keep-parts | --skip-code-scan | --dry-run
+description: Consolida N sesiones del workspace + `docs/scripts/` ya graduados en un paquete de paso a producción bajo `docs/scripts/NNN-export-scripts-YYYY-MM-DD/` (v4.0.0 — session093). Layout plano cross-session al root del bundle: 00-ROLLBACK.sql + 01-DDL-TABLES.sql + 02-DDL-FUNCTIONS.sql + 03-DML.sql + 04-INSERTS.sql + README.md único. Sin por-sesion/, sin companions .rollback.sql, sin per-sesión rollback. `--themes` opt-in genera por-tema/ como capa adicional. Read-only. Reemplaza /agent-workflow:release + /agent-workflow:release-scripts (deprecation Fase 1).
+argument-hint: (opcional) --sessions NNN[,NNN] | --since sessionNNN | --source <alias> | --themes slug1,slug2|infer | --keep-parts | --skip-code-scan | --dry-run
 allowed-tools:
   [
     "Read",
@@ -15,19 +15,34 @@ allowed-tools:
 
 Consolida N sesiones cerradas (más opcionalmente activas) en un paquete único de paso a producción. Delega al skill `export-scripts` (`agent-workflow/skills/export-scripts/SKILL.md`).
 
-El skill **nunca** ejecuta commits, merges, push, SQL ni envía correos. Solo produce:
+El skill **nunca** ejecuta commits, merges, push, SQL ni envía correos. Layout v4.0.0 del bundle (cross-session al root):
 
-- `<docs>/scripts/NNN-export-scripts-YYYY-MM-DD/manifest.md` — informe consolidado (sesiones, acciones manuales, BD, hallazgos code-scan, git, checklist).
-- `<docs>/scripts/NNN-export-scripts-YYYY-MM-DD/README.md` — índice + mapeo sesión↔tema↔scripts.
-- `<docs>/scripts/NNN-export-scripts-YYYY-MM-DD/ORDER.md` — secuencia ejecutable.
-- `<docs>/scripts/NNN-export-scripts-YYYY-MM-DD/rollback-global.sql` — rollback encadenado inverso.
-- `<docs>/scripts/NNN-export-scripts-YYYY-MM-DD/por-sesion/` — bundle SQL por sesión (organizado 01→04).
-- `<docs>/scripts/NNN-export-scripts-YYYY-MM-DD/por-tema/` — bundle consolidado por tema (opt-in).
+```
+<docs>/scripts/NNN-export-scripts-YYYY-MM-DD/
+├── 00-ROLLBACK.sql              # único rollback cross-session (encadenado 04→01)
+├── 01-DDL-TABLES.sql            # CREATE/ALTER TABLE cross-session (skip si vacío)
+├── 02-DDL-FUNCTIONS.sql         # CREATE OR REPLACE FUNCTION cross-session (skip si vacío)
+├── 03-DML.sql                   # UPDATE/DELETE/migración cross-session (skip si vacío)
+├── 04-INSERTS.sql               # INSERT/seed cross-session (skip si vacío)
+├── README.md                    # único informe + índice + how-to-execute
+├── _queries/                    # opcional: queries de soporte por sesión
+│   └── sessionXXX/...
+└── por-tema/                    # opt-in (capa adicional encima del root plano)
+    ├── tema-<slug>/
+    │   ├── 01-DDL-TABLES.sql
+    │   ├── 02-DDL-FUNCTIONS.sql
+    │   ├── 03-DML.sql
+    │   ├── 04-INSERTS.sql
+    │   └── parts/               # si --keep-parts
+    └── tema-<otro>/...
+```
 
 Donde `<docs>` es:
 - `Path.cwd() / docs` por default (project mode o hub workspace base).
 - `<source.path>/docs` si se pasa `--source <alias>` en hub mode.
 
+**No se generan** (eliminados desde v4.0.0): `manifest.md` separado, `ORDER.md`, `rollback-global.sql`, `por-sesion/`, `<file>.rollback.sql` companions, `<session>/rollback/`. El histórico v3.x (`docs/scripts/001-002-003-*` ya generados) queda como histórico — no se migra.
+
 Último comando de la familia `/agent-workflow:export-*` definida en `docs/conclusiones/007-export-commands-family.md`. Refactor que consolida `/agent-workflow:release` v2.0.0 + `/agent-workflow:release-scripts` v2.0.0.
 
 ## Excepción session-aware
@@ -40,34 +55,35 @@ Este skill (junto con `release`, `release-scripts`, `export-report`, `export-arq
 
 ### Argumentos soportados
 
-- `--since sessionNNN` — incluye sólo sesiones posteriores a NNN (inclusive).
+- `--sessions NNN[,NNN]` — filtro discreto por código. Toma precedencia sobre `--since` (warning si ambos).
+- `--since sessionNNN` — incluye sólo sesiones posteriores a NNN (inclusive). Ignorado si `--sessions` presente.
 - `--source <alias>` — en hub mode, limita a una fuente específica.
-- `--themes slug1,slug2` — genera `por-tema/` con los slugs declarados.
+- `--themes slug1,slug2` — genera `por-tema/<slug>/` (capa adicional encima del root plano).
 - `--themes infer` — inferencia LLM de temas (mismo flujo que release-scripts legacy).
 - `--keep-parts` — preserva `por-tema/<slug>/parts/<categoria>/*.sql`.
 - `--skip-code-scan` — omite el escaneo de código fuente.
 - `--dry-run` — reporte propositivo sin escribir archivos.
 
-Sin args: incluye todas las sesiones cerradas, sin vista `por-tema/`, escanea todo el código.
+Sin args: incluye todas las sesiones cerradas, sin capa `por-tema/`, escanea todo el código.
 
 ## Flujo
 
 Antes de generar, el skill llama al CLI `agent-workflow`:
 
 ```
-agent-workflow release-data --include-graduated [--since sessionNNN] [--source <alias>]
+agent-workflow release-data --include-graduated [--sessions NNN[,NNN]] [--since sessionNNN] [--source <alias>]
 agent-workflow code-scan                          # con built-in patterns + override
 agent-workflow next-number docs/scripts           # numeración determinística
 agent-workflow session-artifacts --code <CODE>    # lazy read de OBJECTIVE/TASKS/DECISIONS/scripts
 ```
 
-Luego delega a `sql-script-organizer` (clasificación 01→04 cross-session) y `sql-rollback-generator` (rollback acoplado + global). Si hay temas declarados o `--themes infer`: aplica algoritmo de consolidación por tema (port adaptado de release-scripts legacy).
+Luego consolida cross-session por categoría al root del bundle (`01-DDL-TABLES.sql`, `02-DDL-FUNCTIONS.sql`, `03-DML.sql`, `04-INSERTS.sql`) y delega a `sql-rollback-generator` v2.0.0+ para generar el `00-ROLLBACK.sql` único. Si `--themes` declarado o inferido: agrega capa `por-tema/<slug>/` sin duplicar rollback.
 
 Valida V1-V6 (`references/validations.md`) antes de escribir el bundle al filesystem.
 
 ## Plan mode
 
-Reglas generales en `skills/session/references/sandbox-readonly-rules.md`. Describir en el plan file: NNN resuelto + sesiones incluidas + scripts por sesión, vista `por-tema/` activación (lectura de `## Temas` o flag), hallazgos esperados del code-scan, acciones manuales detectadas, advertencias bloqueantes (sesiones abiertas, rollback ausente, irreversibles).
+Reglas generales en `skills/session/references/sandbox-readonly-rules.md`. Describir en el plan file: NNN resuelto + sesiones incluidas + sentencias cross-session por categoría, capa `por-tema/` (activación + slugs), hallazgos esperados del code-scan, acciones manuales detectadas, advertencias bloqueantes (sesiones abiertas, rollback ausente, irreversibles).
 
 ## Relación con `/agent-workflow:release` y `/agent-workflow:release-scripts`
 
@@ -80,13 +96,14 @@ Detalle del plan: `skills/export-scripts/references/deprecation-plan.md`.
 
 ## Recursos
 
-- `skills/export-scripts/SKILL.md` v1.0.0 — orquestador del comando.
-- `skills/export-scripts/references/manifest-template.md` — plantilla canónica del informe consolidado.
-- `skills/export-scripts/references/readme-template.md` — plantilla del README del bundle.
+- `skills/export-scripts/SKILL.md` v4.0.0 — orquestador del comando (layout plano cross-session).
+- `skills/export-scripts/references/readme-template.md` — plantilla canónica del README único.
+- `skills/export-scripts/references/manifest-template.md` — **DEPRECATED** desde v4.0.0 (histórico).
 - `skills/export-scripts/references/lexico-tecnico.md` — léxico vetado V2.
-- `skills/export-scripts/references/validations.md` — V1-V6 detalladas.
+- `skills/export-scripts/references/validations.md` — V1-V6 detalladas (anti-redundancia v4.0.0).
 - `skills/export-scripts/references/code-scan-recommendations.md` — catálogo extendido de patrones.
 - `skills/export-scripts/references/theme-handling.md` — algoritmo de detección/consolidación por tema.
 - `skills/export-scripts/references/deprecation-plan.md` — plan de fases 1-2.
+- `skills/sql-rollback-generator/SKILL.md` v2.0.0 — `00-ROLLBACK.sql` único cross-session.
 - `docs/conclusiones/007-export-commands-family.md` — Propuesta original de la familia `/agent-workflow:export-*`.
 - `agent-workflow/skills/release/SKILL.md`, `release-scripts/SKILL.md` — legacy en deprecation Fase 1.

package/skills/agent-workflow/commands/patch.md

@@ -0,0 +1,49 @@
+---
+description: Comando ligero para tareas pequeñas y directas (fixes, ajustes, chores acotados). Micro-lifecycle en modo --lite de flow=dev — ceremonia mínima (OBJECTIVE condensado, sin TASKS/DESIGN, closure condensado). Escala in-place a sesión completa si la tarea crece.
+argument-hint: (<descripción-tarea> | sessionXXX | XXX | close)
+allowed-tools:
+  [
+    "Bash",
+    "Read",
+    "Write",
+    "Edit",
+    "Glob",
+    "Grep",
+  ]
+---
+
+# Patch — micro-lifecycle para tareas pequeñas
+
+Azúcar sobre el lifecycle universal: invoca el skill `session` (canónico de agent-workflow) en **modo lite** con `$ARGUMENTS`. Para fixes, ajustes y chores acotados que no justifican la ceremonia de una sesión completa, pero sí merecen trazabilidad mínima (HISTORY + DECISIONS lazy + commit M1).
+
+No es un flow nuevo ni un motor paralelo: `/patch "<qué>"` = `session-create --lite --flow dev "<qué>"`.
+
+## Resolución de intención
+
+El skill evalúa `$ARGUMENTS`:
+
+1. `close` → cerrar el patch activo (closure condensado).
+2. Matchea `sessionXXX` o `XXX` (3 dígitos) → retomar ese patch/sesión.
+3. Texto descriptivo → crear micro-sesión lite (este es el caso común).
+
+## Qué hace el modo lite (al crear)
+
+1. `agent-workflow session-create --lite --flow dev --name <slug> --objetivo "<texto>"` — crea la micro-sesión.
+   - OBJECTIVE condensado (solo `## Type` + `## Requirement`).
+   - `## Type` default `bugfix` (o `chore` si la heurística lo detecta). No admite `feature|refactor`.
+   - Tag `kind:patch` en la fila de HISTORY.
+2. **Salta la ceremonia de planning**: sin auto-plan prompt, sin TASKS.md, sin DESIGN.md/S7, sin M10. El Requirement es la única tarea.
+3. **Loop directo**: aplicar el cambio mínimo componiendo `implement` + `coding-standards`. Mostrar diff. Registrar DECISIONS solo si hay algo no obvio (lazy).
+4. **Closure condensado**: commit M1 (propose-then-execute) directo; no gradúa por default.
+
+## Escalado in-place
+
+Si durante el trabajo emerge complejidad (toca >3 archivos, requiere scripts SQL/BD, o el cambio resulta ser feature/refactor): el AI **propone promover** a sesión completa. Promover = quitar el tag `kind:patch`, generar TASKS.md y, si el Type sube a feature/refactor, disparar DESIGN.md + S7 — en la **misma** sesión (no fragmenta).
+
+## Plan mode
+
+El skill resuelve la intención normalmente y describe acciones en el plan file en lugar de ejecutarlas.
+
+## Recursos
+
+Ver `skills/session/SKILL.md` §"Modo lite (/patch)" para el detalle del micro-lifecycle y el escalado.

package/skills/agent-workflow/doctrine/implement/references/rollback-guide.md

@@ -68,9 +68,11 @@ Para minimizar la necesidad de rollback:
 
 Los rollbacks de código (git) descritos arriba **no revierten cambios en base de datos**. Para revertir scripts SQL ejecutados en producción, usar el skill `sql-rollback-generator`.
 
-El skill produce:
-- **Rollback acoplado** por script: `NNN-script.rollback.sql` al lado del forward.
-- **Bundle global**: `rollback/00-rollback-global.sql` que deshace toda la sesión en orden inverso.
+El skill (v2.0.0+) produce:
+- **Un único `00-ROLLBACK.sql`** al root del bundle generado por `/agent-workflow:export-scripts` v4.0.0+. Encadena rollbacks cross-session en orden inverso (última sesión → primera, 04→01 dentro de cada una) dentro de un `BEGIN; ... COMMIT;` único.
+- **Bloque "Fase 5 — Cleanup irreversible"** al final del archivo, fuera de la transacción, listando irreversibles para revisión manual.
+
+> Comportamiento v1.0.0 (companions `.rollback.sql` por sentencia + per-sesión `rollback/`) eliminado en v2.0.0. Bundles ya generados con v1.0.0 quedan como histórico.
 
 Para operaciones irreversibles (TRUNCATE, DROP COLUMN, DROP TABLE sin backup), ver `skills/sql-rollback-generator/references/irreversible-checklist.md`.
 

package/skills/agent-workflow/doctrine/session/SKILL.md

@@ -241,6 +241,53 @@ Artefacto opcional por sesión que captura "lo que queda para otras sesiones": d
 - Append-only en práctica (no borrar entries previas; mover items a `Discarded` con razón).
 - Si el usuario explícitamente dice "no hay backlog para esta sesión", NO crear el archivo.
 
+## Modo lite (/patch) — micro-lifecycle
+
+Perfil de ceremonia reducida sobre el lifecycle, para tareas pequeñas y directas (fixes, ajustes, chores acotados). Expuesto como `/agent-workflow:patch` (azúcar) y activado por el flag `--lite` de `session-create`. **No es un flow nuevo**: es un modo de `flow=dev`. Origen: `docs/conclusiones/010` (session095).
+
+### Cuándo usarlo
+
+- Tarea acotada que no justifica la ceremonia completa (1-3 archivos, sin decisión de arquitectura, sin contrato FE-BE nuevo).
+- Pero sí merece trazabilidad mínima (HISTORY + DECISIONS lazy + commit M1), a diferencia del trabajo ad-hoc sin rastro.
+- Si la tarea es feature/refactor → NO usar lite; abrir sesión completa.
+
+### Crear (qué cambia vs sesión normal)
+
+```
+agent-workflow session-create --lite --flow dev --name <slug> --objetivo "<texto>"
+```
+
+- OBJECTIVE condensado: solo `## Type` + `## Requirement` (template `PATCH_TEMPLATE`).
+- `## Type` default `bugfix`; `chore` si la heurística lo detecta. `--lite` rechaza `feature|refactor`.
+- Tag `kind:patch` en la columna `refs` de la fila HISTORY.
+
+### Las 4 fases en modo lite
+
+- **planning**: SKIP de la ceremonia. Sin auto-plan prompt, sin TASKS.md, sin DESIGN.md/S7, sin M10. El `## Requirement` es la única tarea.
+- **execution**: loop directo. Verificar rama, cambio mínimo, diff, DECISIONS sólo si no es obvio (igual que `implement` flat). La doctrina bugfix (3 pasos) aplica si el cambio lo amerita; para un fix trivial el paso 1 (root-cause) se salta con justificación inline.
+- **validation**: la que aporte el cambio (test puntual si aplica). No formal.
+- **closure**: condensado. Inspección mínima del diff (sin el cleanup-gate elaborado de §1.5). Commit M1 (propose-then-execute) directo. **No gradúa** por default; si surge una decisión que merece persistir → `decision` como en cualquier sesión.
+
+### Escalado
+
+**Upgrade in-place** (lite → completo) — caso principal. Señales de que la tarea creció:
+- Toca >3 archivos o ≥2 fuentes.
+- Requiere scripts SQL / cambios de BD.
+- El cambio resulta ser feature/refactor (no un fix acotado).
+
+Cuando el AI detecta una señal: **proponer** (no auto-escalar) vía `AskUserQuestion` (estilo S2): "Esto creció. ¿Promovemos a sesión dev completa?". Si el usuario acepta, promover **en la misma sesión**:
+1. Quitar el tag `kind:patch` de la fila HISTORY.
+2. Generar TASKS.md (auto-plan).
+3. Si el Type sube a feature/refactor → disparar DESIGN.md + S7 antes de seguir.
+
+No fragmenta (a diferencia de `--from`, que queda como alternativa manual si el usuario prefiere separar en dos sesiones).
+
+**Downgrade** (completo → lite) — preventivo, no a mitad. El valor está en sugerir `--lite` al inicio (heurística / auto-plan) antes de invertir en TASKS/DESIGN, no en des-escalar una sesión ya armada.
+
+### Exports
+
+Los exports (`release-data`) colapsan las sesiones `kind:patch`: se agrupan/resumen (no una entrada completa por patch) para no inflar informes.
+
 ## Cerrar sesión
 
 ### 0. Detección de items abiertos → sugerir BACKLOG.md (F-F)

package/skills/agent-workflow/exports/export-scripts/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: export-scripts
-description: "Consolida N sesiones del workspace + `docs/scripts/` ya graduados en un paquete de paso a producción bajo `docs/scripts/NNN-export-scripts-YYYY-MM-DD/`. v3.0.0 BREAKING (F-D session062): lee `SCRIPTS.sql` único per sesión (uppercase EN, G1), parsea markers `@category`/`@stmt` y separa post-hoc en `por-sesion/sessionXXX/01-04/`. Delega `sql-rollback-generator` v1.0.0+ on-export para generar rollbacks per archivo + global encadenado 04→01. Aborta con sugerencia de `/agent-workflow:migrate --upgrade-topology` si detecta layout legacy `scripts/01-04/*.sql` (G2). Sigue produciendo `manifest.md`, `por-tema/` opt-in, `rollback-global.sql`, `ORDER.md`. Read-only / reporte — no ejecuta commits ni SQL. Invocado sólo vía `/agent-workflow:export-scripts`. v3.1 (session081): corpus extendido a `docs/` además de sesiones (DEC-002) — ver `docs/shared-contract/export-corpus-sources.md`."
-version: 3.1.0
+description: "Consolida N sesiones del workspace + `docs/scripts/` ya graduados en un paquete de paso a producción bajo `docs/scripts/NNN-export-scripts-YYYY-MM-DD/`. v4.0.0 BREAKING (session093): layout plano cross-session al root del bundle — `00-ROLLBACK.sql`, `01-DDL-TABLES.sql`, `02-DDL-FUNCTIONS.sql`, `03-DML.sql`, `04-INSERTS.sql`, `README.md` único. Sin `por-sesion/`, sin `<file>.rollback.sql` companions, sin per-sesión `rollback/`, sin `manifest.md`/`ORDER.md` separados (absorbidos por `README.md`). Lee `SCRIPTS.sql` único per sesión (uppercase EN, G1), parsea markers `@category`/`@stmt` y consolida cross-session. Delega `sql-rollback-generator` v2.0.0+ on-export para generar `00-ROLLBACK.sql` único encadenado 04→01. Aborta con sugerencia de `/agent-workflow:migrate --upgrade-topology` si detecta layout legacy `scripts/01-04/*.sql` (G2). `--themes` opt-in: capa adicional `por-tema/<slug>/` encima del root plano. Read-only / reporte — no ejecuta commits ni SQL. Invocado sólo vía `/agent-workflow:export-scripts`."
+version: 4.0.0
 ---
 
 # Export Scripts — Bundle SQL + informe consolidado desde N sesiones
@@ -31,16 +31,17 @@ Como `release` y `release-scripts` legacy, este skill requiere conocimiento del
 - Re-generar tras agregar nuevas sesiones desde el último export.
 - Antes de go/no-go meeting.
 
-## Qué hace este skill
+## Qué hace este skill (v4.0.0)
 
-1. Lee sesiones (`.workflow/sessions/`) recolectando `scripts/` y `queries/` de **todas** las sesiones del workspace (filtrables por `--since` y `--source`).
+1. Lee sesiones (`.workflow/sessions/`) recolectando `SCRIPTS.sql` (uppercase EN canónico) de **todas** las sesiones del workspace (filtrables por `--since` y `--source`).
 2. Escanea código fuente buscando patrones que no deben llegar a producción.
 3. Consulta git (rama vs `certificacion`, commits pendientes, archivos sin commit).
-4. Delega a `sql-script-organizer` (clasificación 01→04 cross-session) y `sql-rollback-generator` (rollback acoplado + global).
-5. Detecta acciones manuales requeridas (matriz heredada de `release`).
-6. **Theme detection (opt-in)**: si hay `## Temas` en algún OBJECTIVE o `--themes slug1,slug2` declarado, genera vista `por-tema/` consolidada por categoría.
-7. Aplica validations V1-V6 (`references/validations.md`).
-8. Si pasa: escribe el dossier completo bajo `docs/scripts/NNN-export-scripts-YYYY-MM-DD/`.
+4. **Consolida cross-session por categoría al root** del bundle: `01-DDL-TABLES.sql`, `02-DDL-FUNCTIONS.sql`, `03-DML.sql`, `04-INSERTS.sql` (skip silencioso si la categoría está vacía).
+5. Delega a `sql-rollback-generator` v2.0.0+ para generar **`00-ROLLBACK.sql` único** cross-session (encadenado 04→01).
+6. Detecta acciones manuales requeridas (matriz heredada de `release`).
+7. **Theme detection (opt-in)**: si hay `## Temas` en algún OBJECTIVE o `--themes slug1,slug2` declarado, genera `por-tema/<slug>/` como capa adicional encima del root plano (NO duplica rollback).
+8. Aplica validations V1-V6 (`references/validations.md`).
+9. Si pasa: escribe el bundle completo bajo `docs/scripts/NNN-export-scripts-YYYY-MM-DD/` con el layout plano + `README.md` único.
 
 ## Qué NO hace
 
@@ -49,11 +50,17 @@ Como `release` y `release-scripts` legacy, este skill requiere conocimiento del
 - Enviar correos ni crear PRs.
 - Modificar código fuente (los hallazgos del escaneo son recomendaciones).
 - Tocar `.workflow/sessions/` ni artefactos individuales.
-- Migrar histórico de `docs/release/` (workspaces que ya invocaron `release` legacy mantienen ese dir como histórico).
+- Migrar histórico de `docs/release/` ni bundles `docs/scripts/00X-*` generados por export-scripts v3.x (layout previo, no se reescribe).
+- **Escribir `por-sesion/`** (eliminado en v4.0.0): la consolidación es cross-session al root.
+- **Escribir `<file>.rollback.sql` companions** (eliminado en v4.0.0): el rollback canónico es `00-ROLLBACK.sql` único.
+- **Escribir `<session>/rollback/`** (eliminado en v4.0.0): no hay per-sesión rollback.
+- **Escribir `manifest.md` separado** (eliminado en v4.0.0): absorbido por `README.md`.
+- **Escribir `ORDER.md` separado** (eliminado en v4.0.0): absorbido por §4 del `README.md`.
+- **Escribir `rollback-global.sql` separado** (eliminado en v4.0.0): el rollback es `00-ROLLBACK.sql` único.
 
 ## Sandbox read-only
 
-`../session/references/sandbox-readonly-rules.md`. Plan describe NNN, sesiones incluidas, secciones del manifest, hallazgos esperados, contenido del bundle por sesión y (opcionalmente) por tema.
+`../session/references/sandbox-readonly-rules.md`. Plan describe NNN, sesiones incluidas, secciones del `README.md`, hallazgos esperados, contenido del bundle plano cross-session y (opcionalmente) capa `por-tema/`.
 
 ## Estilo de comunicación
 
@@ -97,7 +104,7 @@ Output: `{workspace_mode, is_hub, source_alias, docs_root, sessions, sessions_co
 > Sesiones en formato legacy detectadas: sessionXXX, sessionYYY.
 > Migrar primero con `/agent-workflow:migrate --upgrade-topology`, luego re-correr export-scripts.
 
-### Paso 1.5 — Gate de layout SQL (v3.0.0, G2)
+### Paso 1.5 — Gate de layout SQL (v4.0.0, G2)
 
 Por cada sesión del corpus, verificar el layout SQL:
 
@@ -134,7 +141,7 @@ Built-in patterns: localhost, IP literal, TODO/FIXME/XXX/HACK, hardcoded-secret,
 
 Output: `{matches: [{pattern_id, severity, file, line, snippet, recommendation}], counts, by_severity, total_matches}`.
 
-Si `--skip-code-scan`: marcar la sección 5 del manifest como "escaneo omitido".
+Si `--skip-code-scan`: marcar la sección 6 del `README.md` como "escaneo omitido".
 
 Catálogo extendido (alta/media/baja con recomendaciones detalladas) en `references/code-scan-recommendations.md`.
 
@@ -163,47 +170,63 @@ Output dir resuelto:
 
 Si `docs/scripts/` no existe, crearlo.
 
-### Paso 5 — `por-sesion/` (bundle por sesión, v3.0.0)
+### Paso 5 — Consolidación cross-session por categoría (v4.0.0)
 
-Para cada sesión del corpus que tenga `SCRIPTS.sql` (verificado en Paso 1.5):
+Recolectar markers de todos los `SCRIPTS.sql` del corpus y consolidar al root del bundle:
 
-1. Crear `por-sesion/sessionXXX-<slug>/`.
-2. **Leer y parsear `SCRIPTS.sql`** de la sesión:
+1. **Para cada sesión** con `SCRIPTS.sql` (verificado en Paso 1.5):
+   - Leer y parsear el archivo.
    - Detectar markers `-- @category: <01-04>` + `-- @stmt: NNN-verbo-objetivo`.
-   - Detectar opcionales `@objeto` y `@alcance` para el header canónico de cada archivo separado.
-   - Validar idempotencia básica (presencia de `IF EXISTS`, `OR REPLACE`, `ON CONFLICT`); advertir en manifest si falta.
-3. **Separar en 01-04**:
-   - Por cada par marker → escribir archivo `por-sesion/sessionXXX-<slug>/<categoria>/<stmt>.sql` con header canónico re-derivado (Script / Sesion / Objeto / Alcance) + BEGIN/COMMIT propios.
-   - Orden dentro de cada categoría: cronológico según aparición en SCRIPTS.sql.
+   - Detectar opcionales `@objeto` y `@alcance` para header de cada sentencia.
+   - Validar idempotencia básica (presencia de `IF EXISTS`, `OR REPLACE`, `ON CONFLICT`); advertir en `README.md` §Hallazgos si falta.
    - Spec del SCRIPTS.sql: `agent-workflow/skills/sql-script-organizer/references/scripts-sql-format.md`.
-4. **Delegar a `sql-rollback-generator` v1.0.0** (on-export): genera `<stmt>.rollback.sql` por cada forward separado + `rollback/00-rollback-global.sql` encadenado 04→01.
-5. Copiar `queries/` tal cual si existe (canal aparte para queries de soporte; no se separa).
-6. Si la sesión tenía layout legacy `scripts/01-04/*.sql` (sub-carpetas), el Paso 1.5 ya abortó antes — nunca llegamos acá con layout mixto.
 
-### Paso 6 — `por-tema/` (opt-in)
+2. **Consolidar por categoría al root** — un archivo por categoría con todas las sentencias cross-session. Mapping marker → filename:
+   - `01-DDL-TABLES.sql` ← `@category: 01-ddl-tablas` (CREATE/ALTER TABLE, INDEX, SEQUENCE).
+   - `02-DDL-FUNCTIONS.sql` ← `@category: 02-ddl-funciones` (CREATE OR REPLACE FUNCTION/PROCEDURE).
+   - `03-DML.sql` ← `@category: 03-migracion` (UPDATE/DELETE/INSERT...SELECT sobre datos existentes).
+   - `04-INSERTS.sql` ← `@category: 04-inserts` (INSERT INTO ... VALUES, seeds).
+   - Orden cross-session: sessionXXX cronológica → stmt cronológica dentro de cada una.
+   - Header de cada archivo: bloque inicial con metadata del bundle (corpus + fecha + versión CLI) + tabla de contenidos (sentencias en orden).
+   - Cada bloque de sentencia preserva su header canónico (`Script` / `Sesion` / `Objeto` / `Alcance`) + bloque transaccional `BEGIN; ... COMMIT;` propio.
+   - **Categorías vacías → skip silencioso**: no se escribe el archivo si no hay sentencias del corpus en esa categoría.
+
+3. **Delegar a `sql-rollback-generator` v2.0.0** (on-export): genera `00-ROLLBACK.sql` único cross-session encadenado 04→01 (ver Paso 7).
+
+4. **Queries de soporte**: si alguna sesión tiene `queries/`, copiarlas a `_queries/<sessionXXX>/` (sub-dir aparte; canal de consulta, no de ejecución).
+
+5. Si la sesión tenía layout legacy `scripts/01-04/*.sql` (sub-carpetas), el Paso 1.5 ya abortó — nunca llegamos acá con layout mixto.
+
+**Nota explícita**: NO se crea `por-sesion/`. NO se crea `<file>.rollback.sql` companion por sentencia. NO se crea sub-carpeta `rollback/` per-sesión. Esos artefactos del v3.x quedan eliminados del default.
+
+### Paso 6 — `por-tema/` (opt-in, capa adicional encima del root plano)
 
 Activación:
 - `--themes slug1,slug2` declarado, **o**
 - Al menos una sesión tiene `## Temas` en su OBJECTIVE, **o**
 - `--themes infer` declarado (inferencia LLM).
 
-Si activado, aplicar `references/theme-handling.md` (port adaptado de release-scripts legacy):
+Si activado, generar `por-tema/<slug>/` como **capa adicional** encima del root plano — NO reemplaza los archivos `0X-*.sql` del root. Aplicar `references/theme-handling.md`:
 
 1. Resolver temas por sesión (lectura declarativa + inferencia + confirmación).
-2. Asignar cada script a su tema (header `-- Temas:`, nombre, contenido, fallback `tema-general`).
-3. Consolidar por categoría dentro de cada tema en un único `.sql` ejecutable (4 forwards + 4 rollbacks + 1 rollback de tema = ~9 archivos/tema).
-4. Generar `ORDER.md` cross-tema con secuencia fase 1→4.
-5. Si `--keep-parts`: preservar `por-tema/<slug>/parts/<categoria>/*.sql`.
+2. Asignar cada sentencia a su tema (header `-- Temas:`, nombre, contenido, fallback `tema-general`).
+3. Consolidar por categoría dentro de cada tema en un único `.sql` ejecutable: `por-tema/<slug>/01-DDL-TABLES.sql`, `02-DDL-FUNCTIONS.sql`, `03-DML.sql`, `04-INSERTS.sql`.
+4. **Rollback per-tema**: NO se genera. El rollback canónico es siempre `00-ROLLBACK.sql` al root — un solo punto de verdad para reversa. Esto evita estado inconsistente si el operador ejecuta rollback de un tema y deja otros aplicados.
+5. Si `--keep-parts`: preservar `por-tema/<slug>/parts/<categoria>/*.sql` con sentencias individuales.
+6. README §Mapping: agregar tabla "Sesión ↔ Tema ↔ Scripts" cuando `por-tema/` activado.
 
 Si no activado, **skip** este paso completo (sin sub-carpeta `por-tema/` vacía).
 
-### Paso 7 — `rollback-global.sql` + `ORDER.md`
+### Paso 7 — `00-ROLLBACK.sql` cross-session (rollback único)
+
+Delegar a **`sql-rollback-generator` v2.0.0** para generar un único archivo `00-ROLLBACK.sql` al root del bundle:
 
-**`rollback-global.sql`**: encadena rollbacks en orden inverso al `ORDER.md`. Si `por-tema/` existe, el global encadena rollbacks por-tema; si no, encadena rollbacks por-sesion. Operaciones irreversibles → "Fase 5 — Cleanup irreversible" al final con header WARNING.
+- Encadena rollbacks en orden inverso: última sesión → primera, dentro de cada una 04→03→02→01.
+- Header del archivo lista las sesiones cubiertas + corpus + fecha de generación.
+- Cuerpo: `BEGIN; ... COMMIT;` único con bloques agrupados por sesión + categoría inversa.
+- **Irreversibles**: bloque "Fase 5 — Cleanup irreversible" **después** del `COMMIT;` con header `-- WARNING: IRREVERSIBLE` y referencia a `DECISIONS.md` de la sesión origen. El operador decide ejecutar este bloque manualmente.
 
-**`ORDER.md`**: secuencia ejecutable cross-bundle:
-- Sin `por-tema/`: orden por sesión cronológica, dentro de cada una 01→04.
-- Con `por-tema/`: intercalado por fase (Fase 1 DDL tablas cross-tema, Fase 2 DDL funciones cross-tema, etc.) — algoritmo en `references/theme-handling.md`.
+**No se genera** `ORDER.md`: la secuencia ejecutable vive en §4 del `README.md` (única fuente de verdad).
 
 ### Paso 8 — Detección de acciones manuales
 
@@ -212,37 +235,38 @@ Cruzar contra `release/references/manual-actions-catalog.md` (reference cruzada
 | Condición | Acción manual |
 |---|---|
 | Tokens/api-key/credenciales mencionados sin valor | Solicitar a admin de prod (plantilla de correo) |
-| Scripts en `03-migracion/` | Respaldar tablas afectadas |
+| Sentencias categorizadas `03-migracion` (consolidadas en `03-DML.sql`) | Respaldar tablas afectadas |
 | `ALTER TABLE ... DROP` o `DROP TABLE` | Validar ventana de downtime |
 | Escaneo: `localhost` / staging URL | Reemplazar por env var |
 | Escaneo: credenciales hardcodeadas (alta) | Rotar + gestor de secretos |
 | Rama distinta de `certificacion` con commits | Crear PR a `certificacion` |
 | Sesión activa con `.sql` sin bundle | Cerrar o aislar antes del export |
 
-Cada acción incluye `id` (ACT-001, …) para referenciar desde el checklist final del manifest.
+Cada acción incluye `id` (ACT-001, …) para referenciar desde el checklist final del `README.md` (§9).
 
-### Paso 9 — `manifest.md` + `README.md` + validaciones
+### Paso 9 — `README.md` único + validaciones
+
+**`README.md`** (único informe + índice + how-to-execute): usar `references/readme-template.md`. Secciones canónicas v4.0.0:
 
-**`manifest.md`** (informe consolidado): usar `references/manifest-template.md`. Secciones canónicas:
 1. Resumen ejecutivo + readiness.
 2. Sesiones incluidas.
 3. Acciones manuales (ACT-NNN).
-4. Base de datos (secuencia, rollback, impacto, vista por-tema si aplica).
-5. Hallazgos del code-scan.
-6. Git y ramas.
-7. Documentación graduada.
-8. Checklist final de producción.
-9. Advertencias.
-10. Metadata.
+4. Secuencia de ejecución 01→04 + invocaciones psql.
+5. Rollback (`00-ROLLBACK.sql` — cómo, cuándo, irreversibles).
+6. Hallazgos del code-scan.
+7. Git y ramas.
+8. Documentación graduada (decisiones / manuales / etc.).
+9. Checklist final de producción.
+10. Metadata (corpus + fecha + versión CLI).
 
-**`README.md`**: índice del directorio + mapeo sesión↔tema↔scripts + how-to-execute. Usar `references/readme-template.md`.
+**NO se genera `manifest.md`** (absorbido por README §1-§10). **NO se genera `ORDER.md`** (absorbido por §4 del README). El template `manifest-template.md` queda marcado `## Status: DEPRECATED` como histórico.
 
 **Validaciones V1-V6** (`references/validations.md`):
-- V1 estructura del manifest.
-- V2 noise vetado (placeholders, paths absolutos, `NNN` sin reemplazar).
-- V3 secciones obligatorias del manifest.
-- V4 conditionals (vista por-tema honored, dry-run, código scan skip).
-- V5 header del manifest bien formado.
+- V1 estructura del bundle: archivos `00-ROLLBACK.sql`, `01..04-*.sql`, `README.md` al root. Falla si aparece `por-sesion/`, `<file>.rollback.sql`, `<session>/rollback/`, `manifest.md`, `ORDER.md` o `rollback-global.sql`.
+- V2 noise vetado (placeholders, paths absolutos, `NNN` sin reemplazar) + anti-redundancia (sin patrones del layout v3.x).
+- V3 secciones obligatorias del README único (las 10).
+- V4 conditionals (`por-tema/` honored si activo, dry-run, code-scan skip).
+- V5 header del README bien formado.
 - V6 referencias resolubles (paths a `docs/`).
 
 Si V1, V3 o V4 fallan → abortar con error report. V2, V5, V6 → warning.
@@ -251,33 +275,30 @@ Si V1, V3 o V4 fallan → abortar con error report. V2, V5, V6 → warning.
 
 Si `--dry-run`: imprimir reporte (count sesiones incluidas, hallazgos por severidad, acciones manuales, V4 outcome). No escribir.
 
-Si pasa: escribir directorio completo:
+Si pasa: escribir directorio completo (layout plano cross-session):
 
 ```
 docs/scripts/NNN-export-scripts-YYYY-MM-DD/
-├── manifest.md                 # informe consolidado
-├── README.md                   # índice + mapeo
-├── ORDER.md                    # secuencia ejecutable
-├── rollback-global.sql         # rollback encadenado inverso
-├── por-sesion/
-│   ├── sessionXXX-<slug>/
-│   │   ├── 01-ddl-tablas/
-│   │   ├── 02-ddl-funciones/
-│   │   ├── 03-migracion/
-│   │   ├── 04-inserts/
-│   │   └── rollback/
-│   └── ...
-└── por-tema/                   # opt-in
+├── 00-ROLLBACK.sql              # único rollback cross-session (encadenado 04→01)
+├── 01-DDL-TABLES.sql            # CREATE/ALTER TABLE cross-session (skip si vacío)
+├── 02-DDL-FUNCTIONS.sql         # CREATE OR REPLACE FUNCTION cross-session (skip si vacío)
+├── 03-DML.sql                   # UPDATE/DELETE/migración cross-session (skip si vacío)
+├── 04-INSERTS.sql               # INSERT/seed cross-session (skip si vacío)
+├── README.md                    # único informe + índice + how-to-execute
+├── _queries/                    # opcional: queries de soporte por sesión (canal de consulta)
+│   └── sessionXXX/...
+└── por-tema/                    # opt-in (capa adicional encima del root plano)
     ├── tema-<slug>/
-    │   ├── 01-ddl-tablas.sql   # consolidado cross-session
-    │   ├── 02-ddl-funciones.sql
-    │   ├── 03-migracion.sql
-    │   ├── 04-inserts.sql
-    │   ├── rollback-tema-<slug>.sql
-    │   └── parts/              # si --keep-parts
+    │   ├── 01-DDL-TABLES.sql    # consolidado cross-session del tema
+    │   ├── 02-DDL-FUNCTIONS.sql
+    │   ├── 03-DML.sql
+    │   ├── 04-INSERTS.sql
+    │   └── parts/               # si --keep-parts (sentencias individuales por categoría)
     └── tema-<otro>/...
 ```
 
+**No se escriben** (eliminados desde v4.0.0): `por-sesion/`, `<file>.rollback.sql` companions, `<session>/rollback/`, `rollback-global.sql` separado, `manifest.md` separado, `ORDER.md`. El histórico (`docs/scripts/001-002-003-*` generados por v3.x) queda como histórico — no se migra.
+
 ### Paso 11 — Resumen al usuario
 
 - Ruta del bundle (`docs/scripts/NNN-export-scripts-YYYY-MM-DD/`).
@@ -288,10 +309,10 @@ docs/scripts/NNN-export-scripts-YYYY-MM-DD/
 ## Composición con otras skills
 
 - **`sql-script-organizer`** — clasificación 01→04 cross-session (paso 5 y consolidación por tema paso 6).
-- **`sql-rollback-generator`** — rollback acoplado por archivo y rollback global encadenado.
+- **`sql-rollback-generator`** v2.0.0+ — `00-ROLLBACK.sql` único cross-session (sin companions ni per-sesión).
 - **`session`** — este skill NO invoca graduación ni cierre.
 - **`coding-standards`** — patrones de escaneo derivan de reglas de seguridad.
-- **`agent-workflow:redaccion-simple`** — preset default aplicado en prosa del manifest.
+- **`agent-workflow:redaccion-simple`** — preset default aplicado en prosa del `README.md`.
 
 ## Re-ejecución
 
@@ -312,7 +333,7 @@ Detalle completo: `references/deprecation-plan.md`.
 
 ## Recursos adicionales
 
-- **`references/manifest-template.md`** — plantilla canónica del informe consolidado (port adaptado de `release/references/report-template.md` con nuevos paths).
+- **`references/manifest-template.md`** — **DEPRECATED** desde v4.0.0. El informe consolidado se redacta directamente en `README.md` siguiendo `references/readme-template.md`. Archivo se conserva como histórico — no usar para bundles nuevos.
 - **`references/readme-template.md`** — plantilla del README del bundle.
 - **`references/lexico-tecnico.md`** — lista mínima de noise vetado para V2.
 - **`references/validations.md`** — V1-V6 con condiciones de hard-fail.

package/skills/agent-workflow/exports/export-scripts/references/lexico-tecnico.md

@@ -1,10 +1,10 @@
-# Léxico técnico — limpieza mínima de noise para export-scripts
+# Léxico técnico — limpieza mínima de noise para export-scripts (v4.0.0)
 
-A diferencia de `export-report/references/lexico.md` (que traduce técnico→ejecutivo para audiencia gerencial), este léxico es **mínimo**: la audiencia de `export-scripts` es técnica (devs / DBAs / release managers) y los términos técnicos son bienvenidos. Sólo se veta el noise interno: placeholders sin reemplazar, paths del developer, restos de plantilla.
+A diferencia de `export-report/references/lexico.md` (que traduce técnico→ejecutivo para audiencia gerencial), este léxico es **mínimo**: la audiencia de `export-scripts` es técnica (devs / DBAs / release managers) y los términos técnicos son bienvenidos. Sólo se veta el noise interno: placeholders sin reemplazar, paths del developer, restos de plantilla, y referencias residuales al layout v3.x (`por-sesion/`, `manifest.md` separado, `ORDER.md`, `rollback-global.sql`).
 
 ## Lista vetada (V2 — para grep determinista)
 
-Términos / patrones que **no deben aparecer** en el cuerpo del `manifest.md` rendered (excepto en `## 10. Metadata`):
+Términos / patrones que **no deben aparecer** en el cuerpo del `README.md` rendered (excepto en `## 10. Metadata`):
 
 ```
 {{
@@ -70,11 +70,25 @@ El validator de V2 (descrito en `validations.md` §V2) procesa este `.md` extray
 
 ```bash
 awk '/^```$/{flag=!flag; next} flag' lexico-tecnico.md > /tmp/lexico-vetado.txt
-grep -n -F -f /tmp/lexico-vetado.txt /tmp/manifest-body.md
+grep -n -F -f /tmp/lexico-vetado.txt /tmp/readme-body.md
 ```
 
 El primer awk toggle-extrae las líneas entre triple-backticks (alterna `flag` cada `\`\`\`` solitario); el segundo grep matchea como fixed strings.
 
-## Total ≈ 50 términos vetados
+## Anti-redundancia v4.0.0 (regex aparte)
 
-Mantenimiento: revisar tras cada change major del template; los términos derivan 1:1 de los placeholders activos en `manifest-template.md`.
+Patrones del layout v3.x que NO deben aparecer en prosa del README (V2 los rechaza vía regex, no fixed-string):
+
+```regex
+por-sesion/
+manifest\.md
+ORDER\.md
+rollback-global\.sql
+\.rollback\.sql
+```
+
+Estos patrones son válidos sólo dentro de bloques que declaran explícitamente "v3.x histórico" / "DEPRECATED" / "eliminado". V2 valida el contexto (presencia de palabra "deprecated"/"histórico" cercana).
+
+## Total ≈ 50 términos vetados (fixed-string) + 5 patrones v3.x (regex)
+
+Mantenimiento: revisar tras cada change major del `readme-template.md`; los términos derivan 1:1 de los placeholders activos en la plantilla.

package/skills/agent-workflow/exports/export-scripts/references/manifest-template.md

@@ -1,6 +1,18 @@
 # Plantilla — Informe del bundle export-scripts
 
-Plantilla exacta que usa el skill `export-scripts` para generar `manifest.md` dentro del output dir. Reemplazar los placeholders `[entre corchetes]` con valores reales al momento de generar.
+## Status: DEPRECATED (desde v4.0.0 — session093)
+
+Este template ya **no se usa** para bundles nuevos. Desde `export-scripts` v4.0.0 el informe consolidado vive en `README.md` único al root del bundle (ver `readme-template.md`). El layout plano cross-session reemplazó `manifest.md` + `ORDER.md` + `rollback-global.sql` separados.
+
+**Si estás generando un bundle nuevo**: usar `references/readme-template.md` (plantilla canónica).
+
+**Si estás leyendo un bundle histórico** (`docs/scripts/001-002-003-export-scripts-*` generado por v3.x): este template describe el formato que tenía. No se reescriben los bundles ya generados.
+
+---
+
+## Plantilla original (export-scripts v3.x — histórico)
+
+Plantilla exacta que usaba el skill `export-scripts` v3.x para generar `manifest.md` dentro del output dir. Reemplazar los placeholders `[entre corchetes]` con valores reales al momento de generar.
 
 > **Heredada de `release/references/report-template.md` v2.0.0**. Cambios respecto al original: (1) paths actualizados al nuevo output dir único; (2) sección 4.4 "Vista por tema" condicional (V4.a); (3) header con readiness color emoji; (4) sección 10 cita `export-scripts v1.0.0`.