@tacuchi/agent-workflow-cli 10.4.0 → 10.5.0

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

@@ -1,289 +1,49 @@
-# Plantilla — README del bundle export-scripts (v4.0.0)
+# Plantilla — README del bundle export-scripts
 
-Plantilla canónica del `README.md` único del bundle. Reemplaza `manifest.md` + `ORDER.md` legacy desde v4.0.0 (session093). Reemplazar `[entre corchetes]` con valores reales al momento de generar.
-
-> **Heredada y consolidada de**: `manifest-template.md` v3.x (informe) + `readme-template.md` v3.x (índice). v4.0.0 unifica ambos en una sola plantilla siguiendo la doctrina "un solo punto de verdad" del usuario.
+README mínimo del bundle. Reemplaza `[entre corchetes]` con valores reales. Sin resumen ejecutivo, sin tabla de sesiones, sin plantillas de correo, sin acciones manuales narradas, sin checklist de producción.
 
 ---
 
 ```markdown
 # Bundle export-scripts NNN — [YYYY-MM-DD]
 
-- **Rama actual:** `[nombre-rama]`
-- **Rama destino:** `certificacion`
-- **Sesiones incluidas:** [N]
-- **Readiness:** [🟢 verde | 🟡 amarillo | 🔴 rojo]
-- **Generado por:** agent-workflow · skill `export-scripts` v4.0.0
-
-## Contenido del bundle (layout v4.0.0)
-
-| Archivo | Propósito | Condicional |
-|---|---|---|
-| `00-ROLLBACK.sql` | Único rollback cross-session — encadenado 04→01 dentro de un `BEGIN; ... COMMIT;` único. Bloque "Fase 5 — Cleanup irreversible" al final fuera de la transacción. | Siempre (si hay sentencias) |
-| `01-DDL-TABLES.sql` | `CREATE TABLE` / `ALTER TABLE` / `CREATE INDEX` / `CREATE SEQUENCE` cross-session. | Skip si categoría vacía |
-| `02-DDL-FUNCTIONS.sql` | `CREATE OR REPLACE FUNCTION` / `PROCEDURE` cross-session. | Skip si categoría vacía |
-| `03-DML.sql` | `UPDATE` / `DELETE` / migración de datos cross-session (con backup en `esq_audit` cuando aplica). | Skip si categoría vacía |
-| `04-INSERTS.sql` | `INSERT` / seed de datos maestros cross-session. | Skip si categoría vacía |
-| `README.md` | Este archivo — único informe + índice + how-to-execute. | Siempre |
-| `_queries/sessionXXX/` | Queries de consulta de soporte por sesión (no ejecución). | Solo si alguna sesión tenía `queries/` |
-| `por-tema/<slug>/` | Capa adicional opt-in con consolidado per-tema (sin rollback duplicado). | Solo si `--themes` activado o `## Temas` declarado |
-
----
-
-## 1. Resumen ejecutivo
-
-[1-2 párrafos sintetizando qué entra en este bundle: módulos tocados, tipo de cambios predominantes (features, fixes, migración de datos), y el juicio general de readiness con 1-2 motivos principales.]
-
-**Motivos del color de readiness:**
-- [motivo 1]
-- [motivo 2]
-
----
-
-## 2. Sesiones incluidas
-
-| # | Sesión | Estado | Fase | Fechas | Resumen | Refs |
-|---|---|---|---|---|---|---|
-| 1 | session001-nombre | closed | 5 | YYYY-MM-DD → YYYY-MM-DD | [resumen 1 línea] | [DEC](../decisiones/001-*.md) |
-| 2 | session002-nombre | ⚠ active | 3 | YYYY-MM-DD → — | [resumen 1 línea] + motivo de apertura | — |
-
-**Sesiones abiertas:** destacadas con ⚠. Cada una baja la readiness del bundle. Motivo y próxima acción debe quedar explícito en el resumen.
+## Archivos
 
----
-
-## 3. Acciones manuales previas a producción
-
-Checklist ordenado. Marcar cada ítem antes del despliegue.
-
-- [ ] **ACT-001** — [Título corto]
-  - **Motivo:** [por qué es necesaria]
-  - **Quién:** [rol/persona sugerida]
-  - **Detalle:** [qué hacer, con qué entrada/salida esperada]
+| Archivo | Contiene |
+|---|---|
+| `00-ROLLBACK.sql` | Reversa de todo el bundle. |
+| `01-[CATEGORIA].sql` | [Primera categoría con contenido] |
+| `02-[CATEGORIA].sql` | [Segunda categoría con contenido — si aplica] |
+| ... | ... |
 
-- [ ] **ACT-002** — Solicitar API keys de producción
-  - **Motivo:** REQUIREMENTS de session003 menciona integración con servicio externo pero no hay claves concretas.
-  - **Quién:** Administrador de infraestructura
-  - **Detalle:** enviar correo con plantilla en §3.1.
+> La numeración es continua tras `00-ROLLBACK.sql`. Las categorías sin contenido no ocupan número.
 
-### 3.1 Plantillas de correo
-
-Copiar, personalizar y enviar manualmente. **Este plugin no envía correos.**
-
-```
-Para: [correo-destino]
-CC: [correo-cc]
-Asunto: [Bundle NNN] Solicitud de API keys de producción
-
-Buen día,
-
-Para el bundle NNN-[nombre] que se despliega el [fecha objetivo] requerimos las siguientes credenciales de producción:
-
-- [servicio 1] — URL y token de acceso
-- [servicio 2] — usuario/clave técnica
-
-Adjunto el bundle: docs/scripts/NNN-export-scripts-[YYYY-MM-DD]/README.md
-
-Quedamos atentos.
-Saludos.
-```
-
----
-
-## 4. Secuencia de ejecución (01 → 04)
-
-Orden obligatorio. Categorías vacías se omiten (no aparece el archivo).
+## Aplicar
 
 ```bash
-# 1. DDL de tablas (CREATE/ALTER TABLE, INDEX, SEQUENCE)
-psql -h <host> -U <user> -d <db> -f 01-DDL-TABLES.sql
-
-# 2. DDL de funciones (CREATE OR REPLACE FUNCTION/PROCEDURE)
-psql -h <host> -U <user> -d <db> -f 02-DDL-FUNCTIONS.sql
-
-# 3. DML / migración (UPDATE, DELETE, backup en esq_audit)
-psql -h <host> -U <user> -d <db> -f 03-DML.sql
-
-# 4. Inserts / seed maestros
-psql -h <host> -U <user> -d <db> -f 04-INSERTS.sql
+psql -h <host> -U <user> -d <db> -f 01-[CATEGORIA].sql
+psql -h <host> -U <user> -d <db> -f 02-[CATEGORIA].sql
+# ...
 ```
 
-> **Importante**: este plugin NO ejecuta SQL. El usuario aplica los scripts manualmente.
-
-### 4.1 Mapping sesión ↔ tema ↔ scripts
-
-> **Condicional**: incluir esta sub-sección **sólo si** `--themes` activado y `por-tema/` se generó. Si no, omitir entera la 4.1.
-
-| Sesión | Tema | Sentencias (categoría:NNN-stmt) |
-|---|---|---|
-| session001 | `tema-rbac` | 01:001-rol-permiso, 02:001-fn-validacion, 03:001-mig-roles |
-| session002 | `tema-rbac` | 01:001-asignacion-default |
-| session003 | `tema-lista-negra-blanca` | 01:001-listas-table, 04:001-inserts-iniciales |
-
----
-
-## 5. Rollback (`00-ROLLBACK.sql`)
+Orden estricto: ascendente por número (01 → 02 → …). El plugin no ejecuta nada — el operador aplica.
 
-Un solo archivo cross-session al root del bundle. Orden interno inverso absoluto: última sesión → primera; dentro de cada una 04 → 03 → 02 → 01.
+## Revertir
 
 ```bash
-# Ejecutar el rollback completo en una sola transacción:
 psql -h <host> -U <user> -d <db> -f 00-ROLLBACK.sql
 ```
 
-### 5.1 Operaciones irreversibles
-
-**Detectadas en el bundle:**
-
-| Sesión origen | Operación | Mitigación disponible |
-|---|---|---|
-| session003 | `DROP COLUMN col_legacy` | Respaldo previo en `esq_audit.tb_bkp_session003` (incluido en `03-DML.sql`) |
-| session005 | `TRUNCATE esq_x.tb_z` | Sin backup automático — pérdida total de datos |
-
-Si no hay irreversibles: incluir un placeholder con "Sin operaciones irreversibles en este bundle." (el AI debe reemplazar la tabla por esta frase única).
-
-**Bloque "Fase 5" del `00-ROLLBACK.sql`**: las operaciones irreversibles aparecen al final del archivo **fuera de la transacción** principal, con header `-- WARNING: IRREVERSIBLE` y referencia a la DECISION de la sesión origen. El operador decide ejecutar este bloque manualmente.
-
-### 5.2 Impacto
-
-- **Tablas creadas:** [lista]
-- **Tablas modificadas:** [lista, indicando tipo de ALTER]
-- **Funciones creadas/modificadas:** [lista]
-- **Filas afectadas por migración:** [estimación si hay count en sesiones]
-
----
-
-## 6. Código fuente — hallazgos del escaneo
-
-> **Condicional V4.b**: si `--skip-code-scan` fue usado, esta sección contiene **sólo** una nota inline `_(Escaneo omitido por --skip-code-scan)_` y nada más.
-
-**Resumen:** [X] críticos · [Y] medios · [Z] bajos
-
-### 6.1 Severidad alta (bloqueantes para producción)
-
-| # | Patrón | Archivo:línea | Snippet | Recomendación |
-|---|---|---|---|---|
-| H1 | Credencial hardcodeada | `src/.../Config.java:42` | `password = "..."` | Mover a variable de entorno o gestor de secretos. Rotar la credencial si fue commiteada. |
-
-Si vacío: incluir un placeholder con "Sin hallazgos de severidad alta." (frase única que reemplaza la tabla).
-
-### 6.2 Severidad media
-
-| # | Patrón | Archivo:línea | Snippet | Recomendación |
-|---|---|---|---|---|
-| M1 | URL localhost | `src/.../api.service.ts:18` | `http://localhost:8080` | Reemplazar por `environment.apiUrl` u otro mecanismo de configuración. |
-
-### 6.3 Severidad baja
-
-Agrupados por patrón, con conteo.
-
-| Patrón | Conteo | Ejemplos |
-|---|---|---|
-| `TODO` | 7 | `UserService.java:88`, `OrderService.java:42`, ... |
-| `FIXME` | 2 | `validator.ts:15`, `payment.ts:103` |
-
-### 6.4 Alcance del escaneo
-
-- **Directorios incluidos:** [lista]
-- **Directorios excluidos:** `node_modules/`, `target/`, `dist/`, `build/`, `.workflow/`, `docs/`, `tests/`, `test/`, `.git/`
-- **Extensiones:** [lista]
-
----
-
-## 7. Git y ramas
-
-- **Rama actual:** `[nombre]`
-- **Rama destino:** `certificacion`
-- **Commits pendientes de merge (rama actual → certificacion):** [N]
-
-### 7.1 Commits pendientes
-
-```
-[sha corto] [mensaje]
-[sha corto] [mensaje]
-```
-
-### 7.2 Archivos modificados (git diff --stat)
-
-```
-[salida de git diff certificacion --stat]
-```
-
-### 7.3 Cambios sin commitear
-
-Si `git status` muestra archivos modificados/untracked:
-
-```
-[salida de git status --porcelain]
-```
-
-**Acción recomendada:** el usuario decide si esos cambios entran al bundle (commit) o no (stash/descartar).
-
-### 7.4 PR sugerido (texto — no se crea)
-
-```
-Título: [feat/fix/chore]: [resumen del bundle]
-Rama origen: [rama actual]
-Rama destino: certificacion
-Descripción:
-- Bundle NNN consolidando las siguientes sesiones:
-  - session001 — [título]
-  - session002 — [título]
-- Bundle completo: docs/scripts/NNN-export-scripts-[YYYY-MM-DD]/
+Si hay bloque `Fase 5 — Cleanup irreversible` al final del rollback, leerlo antes de ejecutar — son operaciones manuales (sin reversa automática).
 ```
 
 ---
 
-## 8. Documentación graduada
-
-| Sesión | Decisiones | Manuales | Especificaciones | Conclusiones |
-|---|---|---|---|---|
-| session001 | `001-*.md`, `002-*.md` | — | — | — |
-| session002 | — | `003-*.md` | — | — |
-| session003 | `004-*.md` | — | `001-*/` | — |
-
-Nota: el modelo nuevo gradua 6 kinds (`decision`, `manual`, `script`, `especificacion`, `conclusion`, `release`). Este README enlaza los 4 primeros; `release` queda implícito en este mismo dossier; `script` queda implícito en los archivos `0X-*.sql` del root.
-
----
-
-## 9. Checklist final de producción
-
-Lista única consolidada. Todos los ítems deben marcarse antes del "go":
-
-- [ ] **BD:** respaldo completo del esquema afectado tomado y verificado
-- [ ] **BD:** scripts ejecutados en orden (`01-DDL-TABLES.sql` → `02-DDL-FUNCTIONS.sql` → `03-DML.sql` → `04-INSERTS.sql`)
-- [ ] **BD:** `00-ROLLBACK.sql` probado en staging/certificación
-- [ ] **Infra:** variables de entorno actualizadas (ver §3)
-- [ ] **Infra:** API keys de producción solicitadas y configuradas
-- [ ] **Código:** hallazgos de severidad alta resueltos (§6.1)
-- [ ] **Git:** rama mergeada a `certificacion` (o PR aprobado)
-- [ ] **Git:** tag/release creado en el repositorio
-- [ ] **Stakeholders:** notificación enviada antes y después del despliegue
-- [ ] **Acciones manuales:** todos los ACT-XXX de §3 completados
-
-### 9.1 Advertencias
+## Notas para el AI generador
 
-Cosas que el skill detectó pero no pudo validar automáticamente. Leer antes de marcar el checklist como completo.
-
-Si no hay advertencias: incluir un placeholder con "Sin advertencias pendientes." (frase única).
-
----
-
-## 10. Metadata
-
-- **Generado:** YYYY-MM-DD HH:MM
-- **Versión del skill:** export-scripts v4.0.0 (layout plano cross-session)
-- **Sub-skill rollback:** sql-rollback-generator v2.0.0
-- **Argumentos usados:** `[sin argumentos | --sessions NNN[,NNN] | --since sessionNNN | --themes slug1,slug2 | --dry-run | --skip-code-scan]`
-- **Comando original:** `/agent-workflow:export-scripts [args]`
-- **Reemplaza:** `/agent-workflow:release` v2.0.0 + `/agent-workflow:release-scripts` v2.0.0 (ambos en deprecation Fase 1 desde plugin v2.8.0)
-
-## Re-generación
-
-Para regenerar este bundle:
-
-```
-/agent-workflow:export-scripts [--sessions NNN[,NNN]] [--since sessionNNN] [--themes slug1,slug2]
-```
-
-Cada invocación toma siguiente NNN. NO sobrescribe bundles previos. Bundles generados con export-scripts v3.x (layout `por-sesion/` + `manifest.md` + `ORDER.md` + `rollback-global.sql`) quedan como histórico y no se migran.
-```
+- **No agregar** secciones más allá de `## Archivos`, `## Aplicar`, `## Revertir`.
+- **No incluir** resumen ejecutivo, sesiones origen, commits, ramas, code-scan, plantillas de correo, ACT-NNN, ni checklist de producción.
+- **Tabla de archivos**: una fila por archivo presente. Categorías vacías no aparecen.
+- **Cómo aplicar**: un `psql -f` por archivo presente, en orden ascendente.
+- **Cómo revertir**: una sola línea `psql -f 00-ROLLBACK.sql` + nota opcional si hay `Fase 5`.
+- Si el bundle es trivial (sólo 1 forward + rollback), basta con la tabla y los dos bloques `bash`. Cualquier prosa adicional es ruido.

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

@@ -1,290 +1,69 @@
-# Validations — V1-V6 para `/agent-workflow:export-scripts` (v4.0.0)
+# Validations — export-scripts
 
-Checks post-render que se aplican antes de escribir el bundle al filesystem. Adaptados del canon de la familia export-* (export-arq + export-report) con foco en bundle SQL + informe único.
+Checks mínimos antes de escribir el bundle. Solo lo esencial: estructura básica y ausencia de placeholders.
 
-Niveles de severidad:
-- **Hard-fail**: aborta la escritura, devuelve `ok: false` con error report. No se crea el directorio.
-- **Warning**: emite mensaje, pide confirmación del usuario para continuar.
+## V1 — Estructura del bundle
 
-## V1 — Estructura del bundle (layout plano cross-session)
+**Severidad**: hard-fail.
 
-**Severidad**: hard-fail si falta archivo obligatorio O aparece archivo/sub-dir vetado.
+Requeridos al root del bundle:
 
-### Archivos obligatorios siempre
+- `README.md`.
+- `00-ROLLBACK.sql` (si hay al menos un forward).
+- Al menos un `NN-*.sql` con `NN >= 01`.
 
-- `README.md` — único informe + índice + how-to-execute.
-- `00-ROLLBACK.sql` — sólo si al menos una categoría 01-04 tiene contenido (si todo el corpus está vacío, no se escribe el bundle).
+Numeración continua tras `00-ROLLBACK.sql`: el primer forward presente es `01-…`, el segundo `02-…`, etc. No hay gaps por categorías vacías.
 
-### Archivos por categoría (skip silencioso si vacío)
+Vetados (presencia → hard-fail):
 
-- `01-DDL-TABLES.sql` — sólo si hay sentencias `@category: 01` en el corpus.
-- `02-DDL-FUNCTIONS.sql` — sólo si hay sentencias `@category: 02`.
-- `03-DML.sql` — sólo si hay sentencias `@category: 03`.
-- `04-INSERTS.sql` — sólo si hay sentencias `@category: 04`.
+- `manifest.md`, `ORDER.md`, `rollback-global.sql`, `por-sesion/`, `<file>.rollback.sql` (layout v3.x deprecado).
+- Archivos `NN-*.sql` con saltos en la numeración (`01-…`, `03-…` sin `02-…`).
 
-### Archivos condicionales
+## V2 — Sin placeholders
 
-- `_queries/<sessionXXX>/` — sólo si la sesión origen tenía `queries/`.
-- `por-tema/<slug>/` — sólo si `--themes` activado, `## Temas` declarado, o `--themes infer`.
+**Severidad**: hard-fail.
 
-### Archivos VETADOS (presencia → hard-fail)
+El `README.md` y los `.sql` no deben contener:
 
-Layout v3.x eliminado desde v4.0.0:
-- `manifest.md` (absorbido por `README.md`).
-- `ORDER.md` (absorbido por §4 del `README.md`).
-- `rollback-global.sql` separado (reemplazado por `00-ROLLBACK.sql`).
-- `por-sesion/` y todo su contenido (consolidación es cross-session al root).
-- `<file>.rollback.sql` companions por sentencia (eliminado en sql-rollback-generator v2.0.0).
-- `<session>/rollback/` sub-carpetas per-sesión (eliminado en sql-rollback-generator v2.0.0).
-
-**Cómo validar**: listar el output dir antes de escribir el bundle final; verificar que (a) archivos obligatorios están presentes y (b) no aparece nada del set vetado.
-
-**Error report (hard-fail)**:
-```
-V1 FAILED: estructura del bundle incompatible con v4.0.0
-  esperado al root: README.md + 0X-*.sql (categorías con contenido)
-  encontrado vetado: por-sesion/ (4 sub-carpetas), manifest.md, rollback-global.sql
-  acción: el generador está produciendo layout v3.x — revisar export-scripts v4.0.0 + sql-rollback-generator v2.0.0
-```
-
-## V2 — Noise vetado + anti-redundancia v4.0.0
-
-**Severidad**: hard-fail si hay ≥1 ocurrencia.
-
-**Scope**: body-only del `README.md` — líneas después de `# Bundle export-scripts NNN` (h1 inicial) y antes de `## 10. Metadata`.
-
-**Patrones vetados** (catálogo en `references/lexico-tecnico.md` + reglas anti-redundancia v4.0.0):
-
-1. Placeholders sin reemplazar: `NNN`, `YYYY-MM-DD`, `[entre corchetes]`, `<placeholder>`.
-2. Paths absolutos del developer: `/Users/`, `/home/`, `C:\\`.
-3. Referencias residuales al layout v3.x dentro de prosa generada (no en bloques deprecation explicit):
-   - `por-sesion/` en `## 4. Secuencia de ejecución` o `## 5. Rollback` (esos paths fueron eliminados).
-   - `manifest.md` como recurso vigente del bundle (sólo válido si se cita el template DEPRECATED).
-   - `ORDER.md` como archivo del bundle (eliminado).
-   - `rollback-global.sql` como path activo (renombrado a `00-ROLLBACK.sql`).
-   - `<file>.rollback.sql` companions.
-
-**Cómo validar**:
-```bash
-awk '
-  BEGIN { body=0 }
-  /^## 10\. Metadata/ { body=0 }
-  body { print }
-  /^# / && !/Metadata/ { body=1 }
-' README.md > /tmp/body.md
-grep -n -F -f references/lexico-tecnico.md /tmp/body.md
-# Plus anti-redundancia v4.0.0:
-grep -nE 'por-sesion/|rollback-global\.sql|\.rollback\.sql|ORDER\.md|manifest\.md' /tmp/body.md
-```
-
-**Error report (hard-fail)**:
-```
-V2 FAILED: noise vetado / redundancia v3.x detectados en README.md
-  ocurrencias:
-    línea 12: "NNN-export-scripts-YYYY-MM-DD"  → placeholder sin reemplazar
-    línea 28: "/Users/tacuchi/"                → path absoluto del developer
-    línea 65: "por-sesion/session001-*/"       → layout v3.x deprecated
-  total: 3 ocurrencias
-  acción: completar render con paths v4.0.0 y stripear referencias legacy
-```
-
-## V3 — Secciones obligatorias del README único
-
-**Severidad**: hard-fail si falta una sección obligatoria.
-
-**Secciones obligatorias** (todas siempre presentes en `README.md`):
-
-1. `## 1. Resumen ejecutivo`
-2. `## 2. Sesiones incluidas`
-3. `## 3. Acciones manuales previas a producción`
-4. `## 4. Secuencia de ejecución (01 → 04)`
-5. `## 5. Rollback (\`00-ROLLBACK.sql\`)`
-6. `## 6. Código fuente — hallazgos del escaneo`
-7. `## 7. Git y ramas`
-8. `## 8. Documentación graduada`
-9. `## 9. Checklist final de producción`
-10. `## 10. Metadata`
+- `NNN`, `YYYY-MM-DD`, `[entre corchetes]`, `<placeholder>`, `[CATEGORIA]`.
+- Paths absolutos del developer (`/Users/`, `/home/`, `C:\\`).
+- Referencias al layout v3.x deprecado (`por-sesion/`, `manifest.md`, `ORDER.md`, `rollback-global.sql`, `.rollback.sql` companions) — excepto en bloques explícitos de "deprecated"/"histórico".
 
 **Cómo validar**:
-```bash
-grep -c '^## [0-9]\+\. ' README.md  # debe dar exactamente 10
-```
-
-**Error report (hard-fail)**:
-```
-V3 FAILED: secciones obligatorias faltantes
-  esperadas: 10
-  encontradas: 8
-  faltantes: "## 5. Rollback (`00-ROLLBACK.sql`)", "## 9. Checklist final de producción"
-  acción: regenerar README con secciones completas
-```
-
-## V4 — Secciones condicionales honored
-
-**Severidad**: hard-fail si una sub-sección condicional aparece sin justificación o falta cuando debería estar.
-
-### V4.a — Mapping por tema (`## 4.1 Mapping sesión ↔ tema ↔ scripts`)
-
-- **Patrón A — `--themes` activado**: sub-sección `## 4.1 Mapping sesión ↔ tema ↔ scripts` presente con tabla de mapping.
-- **Patrón B — sin temas**: sub-sección `## 4.1` **ausente** (no aparece header ni placeholder).
-
-**Error report (Patrón B esperado pero sección presente sin contenido)**:
-```
-V4.a FAILED: sin temas declarados pero sección "## 4.1 Mapping" presente
-  themes: []
-  acción: omitir sección cuando no hay temas (no dejar placeholder)
-```
 
-### V4.b — Code scan skip (`## 6`)
-
-- **Patrón A — escaneo ejecutado**: sección 6 contiene resumen con counts (`X críticos · Y medios · Z bajos`).
-- **Patrón B — `--skip-code-scan`**: sección 6 contiene **nota inline explícita** `_(Escaneo omitido por --skip-code-scan)_` y no hay tabla de hallazgos.
-
-**Error report (Patrón B esperado pero tabla presente)**:
-```
-V4.b FAILED: --skip-code-scan declarado pero sección 6 tiene tabla de hallazgos
-  args: --skip-code-scan
-  acción: reemplazar tabla por nota inline
-```
-
-### V4.c — Sesiones abiertas
-
-- **Patrón A — sesiones cerradas**: tabla "## 2. Sesiones incluidas" sin warnings ⚠.
-- **Patrón B — sesiones activas incluidas**: cada sesión activa marcada con ⚠ + motivo de apertura en la columna "Resumen".
-
-**Error report (Patrón B sin ⚠)**:
-```
-V4.c FAILED: sesiones activas detectadas pero no marcadas con ⚠
-  sesiones activas: session061
-  acción: marcar con ⚠ en tabla y documentar motivo en columna Resumen
-```
-
-### V4.d — Categorías SQL vacías
-
-- **Patrón A — categoría con contenido**: archivo `0X-*.sql` presente al root + referencia en §4 del README.
-- **Patrón B — categoría vacía**: archivo `0X-*.sql` **ausente** + comando psql correspondiente **omitido** del bloque de §4 (no aparece línea con archivo inexistente).
-
-**Error report (Patrón B con referencia)**:
-```
-V4.d FAILED: categoría 03-DML vacía pero referenciada en §4
-  corpus_dml_count: 0
-  archivo presente: false
-  referencia README: línea 88 → "psql ... -f 03-DML.sql"
-  acción: omitir comando psql cuando la categoría está vacía
-```
-
-## V5 — Header del README bien formado
-
-**Severidad**: warning.
-
-**Checks** (líneas 1-7 del `README.md`):
-
-- Línea 1: `# Bundle export-scripts NNN — <YYYY-MM-DD>` con NNN reemplazado.
-- Línea 3: `- **Rama actual:** \`<nombre-rama>\``
-- Línea 4: `- **Rama destino:** \`certificacion\``
-- Línea 5: `- **Sesiones incluidas:** <N>`
-- Línea 6: `- **Readiness:** 🟢 verde | 🟡 amarillo | 🔴 rojo` (una sola opción seleccionada).
-- Línea 7: `- **Generado por:** agent-workflow · skill \`export-scripts\` v4.0.0`
-
-**Error report (warning)**:
-```
-V5 WARNING: header incompleto o malformado
-  línea 1: OK
-  línea 3: "- **Rama actual:** `<nombre-rama>`" → placeholder sin reemplazar
-  acción: re-renderizar header con valores reales
-  ¿continuar de todas formas? (s/n)
-```
-
-## V6 — Referencias resolubles
-
-**Severidad**: warning.
-
-**Checks**: cada link en cualquier sección del README apunta a un path existente en filesystem al momento de generar.
-
-**Cómo validar**:
 ```bash
-grep -Eo '`[^`]+\.(md|sql)`|\[.+?\]\([^)]+\)' README.md | \
-  sed -E 's/^`(.+)`$/\1/; s/^\[.+?\]\((.+)\)$/\1/' | \
-  while read p; do
-    if [ ! -e "$p" ] && [ ! -e "<output_dir>/$p" ]; then echo "MISSING: $p"; fi
-  done
+grep -nE 'NNN|YYYY-MM-DD|\[entre corchetes\]|<placeholder>|\[CATEGORIA\]|/Users/|/home/|C:\\' README.md *.sql
+grep -nE 'por-sesion/|manifest\.md|ORDER\.md|rollback-global\.sql|\.rollback\.sql' README.md
 ```
 
-**Excepción**: links a `docs/decisiones/`, `docs/manuales/`, etc. **fuera** del output dir son válidos si existen en el workspace; si no, warning suave (no aborta).
-
-**Error report (warning)**:
-```
-V6 WARNING: 2 referencias apuntan a paths inexistentes
-  - docs/decisiones/005-tipos-cobranza.md → no existe en workspace
-  - 03-DML.sql                            → no existe en output dir (categoría vacía)
-  acción sugerida: corregir paths u omitir referencias a categorías vacías
-  ¿continuar de todas formas? (s/n)
-```
+Ambos deben devolver vacío.
 
 ## Orden de aplicación
 
-1. V1 (estructura del bundle, anti-redundancia layout) — primero, barato.
-2. V3 (secciones del README) — segundo, barato.
-3. V2 (noise vetado + redundancia v3.x en prosa) — tercero, requiere lectura del body.
-4. V4 (condicionales) — cuarto, requiere reconstruir contexto de flags + corpus.
-5. V5 (header) — quinto.
-6. V6 (referencias resolubles) — último.
-
-Si V1, V3 o V4 fallan → abortar inmediatamente.
-Si V2 falla → abortar (no warning, igual que en export-arq y export-report).
-Si V5 o V6 emiten warning → pedir confirmación al usuario.
+1. V1 (estructura + numeración continua).
+2. V2 (placeholders + redundancia v3.x).
 
-## Reporte consolidado
+Ambas hard-fail. Si fallan, abortar antes de escribir.
 
-Al final del flujo, el skill devuelve:
+## Reporte final
 
 ```json
 {
   "ok": true,
   "output_dir": "docs/scripts/NNN-export-scripts-YYYY-MM-DD/",
-  "files_written": [
-    "README.md",
-    "00-ROLLBACK.sql",
-    "01-DDL-TABLES.sql",
-    "02-DDL-FUNCTIONS.sql",
-    "04-INSERTS.sql",
-    "por-tema/tema-rbac/01-DDL-TABLES.sql",
-    "..."
-  ],
-  "categories_empty": ["03-DML"],
-  "themes_resolved": ["rbac", "lista-negra-blanca"],
-  "sessions_included": ["057", "058", "059", "060"],
-  "validations": {
-    "V1": { "status": "pass", "forbidden_artifacts": 0 },
-    "V2": { "status": "pass", "noise_hits": 0, "v3_legacy_refs": 0 },
-    "V3": { "status": "pass", "sections_found": 10 },
-    "V4": { "status": "pass", "conditionals": { "mapping_tema": "presente (2 temas)", "code_scan": "ejecutado", "sesiones_abiertas": "0", "categorias_vacias": "1 (03-DML)" } },
-    "V5": { "status": "pass" },
-    "V6": { "status": "warning", "missing_refs": ["docs/decisiones/005-...md"] }
-  },
-  "summary": "Bundle escrito (layout v4.0.0). 1 warning (V6) aceptado."
+  "files_written": ["README.md", "00-ROLLBACK.sql", "01-DML.sql", "02-INSERTS.sql"],
+  "validations": { "V1": "pass", "V2": "pass" }
 }
 ```
 
-Si hard-fail:
+Hard-fail:
 
 ```json
 {
   "ok": false,
   "stage": "validation",
   "failed_at": "V1",
-  "details": "estructura v3.x detectada: por-sesion/ presente. El generador no debería emitir ese sub-dir desde v4.0.0.",
+  "details": "numeración con gaps: 01-DML.sql + 03-INSERTS.sql sin 02",
   "no_files_written": true
 }
 ```
-
-## Diferencias con `export-arq/references/validations.md`
-
-| Validación | export-arq | export-scripts |
-|---|---|---|
-| V1 | estructura de secciones por `--scope` | estructura del bundle (archivos al root + sub-dirs opt-in) + anti-redundancia v4.0.0 |
-| V2 | noise interno (~25 términos) | noise + placeholders + referencias residuales al layout v3.x |
-| V3 | secciones por scope | 10 secciones fijas del README único |
-| V4 | Modelo de datos + Decisiones condicionales | Mapping tema + code-scan skip + sesiones abiertas + categorías vacías |
-| V5 | header con snapshot + fuentes + diagrams engine | header con rama + readiness + counts + versión skill |
-| V6 | referencias resolubles | referencias resolubles (incl. archivos de categoría skipped) |