@tacuchi/agent-workflow-cli 6.2.0 → 7.0.1

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

@@ -0,0 +1,255 @@
+# Validations — V1-V6 para `/agent-workflow:export-report`
+
+Checks post-render que se aplican antes de escribir el `.md` al filesystem. Heredan de `docs/especificaciones/001-export-report-format/DELIVERY.md §"Validation criteria"`.
+
+Niveles de severidad:
+- **Hard-fail**: aborta la escritura, devuelve `ok: false` con error report. No se crea el archivo.
+- **Warning**: emite mensaje, pide confirmación del usuario para continuar. Si confirma → escribe.
+
+## V1 — Cota de palabras
+
+**Severidad**: hard-fail si excede +20% de la cota; warning si excede ±10%.
+
+**Cotas por variante** (v1.1: B y C subieron por Componentes impactados; A sin cambio; v1.4 session079: tolerancia condicional en C):
+
+| Variante | Cota nominal | Warning fuera de | Hard fail |
+|---|---|---|---|
+| A — Compacta | 400w | 360-440w | >480w o <320w |
+| B — Media (default v1.1) | 760w | 684-836w | >912w o <608w |
+| C — Extensa (v1.1) | 1620w | 1458-1782w | >1944w o <1296w |
+
+**Tolerancia condicional en C (v1.4 — DEC-005 session079)**: cuando V4 omite "Oportunidades de mejora" en C (corpus sin items abiertos), la ventana efectiva de warning se desplaza a **1323-1617w** (1470w nominal ±10%). Razón: los pesos C sin Op suman 1470w (no 1620w); la ventana original generaba warnings de borde sin valor. La cota de hard fail sigue siendo 1296w (low) — la tolerancia condicional solo afecta el rango warning. A y B mantienen ventana fija (sus deltas con/sin Op son menores).
+
+**Cómo contar**:
+
+Word count canónico = `wc -w` sobre el `.md` puro tras stripear:
+- Bloque de Referencias (no cuenta).
+- Front-matter YAML si existe (no cuenta).
+- Comentarios HTML `<!-- ... -->` (no cuentan).
+- Code fences ```...``` (no cuentan, salvo que el diagrama opt-in incluido se considere texto representativo — decisión del render).
+
+Comando referencial:
+```bash
+awk '
+  /^# Referencias/ { skip=1 }
+  /^---$/ { yaml = !yaml; next }
+  /^<!--/ { hc=1 }
+  /-->$/ { hc=0; next }
+  /^```/ { cf = !cf; next }
+  !skip && !yaml && !hc && !cf { print }
+' output.md | wc -w
+```
+
+**Error report (hard-fail)**:
+```
+V1 FAILED: cota excedida
+  variante: B
+  cota nominal: 760w (±10% warning, ±20% hard fail)
+  cota actual: 951w
+  excedente: +191w (+25%)
+  acción: comprimir secciones {{LOGROS}}, {{OBJETIVO}} o {{ALCANCES}}
+```
+
+## V2 — Léxico vetado
+
+**Severidad**: hard-fail si hay ≥1 ocurrencia en el **cuerpo** (header y Referencias exentos).
+
+**Lista vetada**: ver `lexico.md` §"Lista vetada (V2 — para grep determinista)".
+
+**Scope de V2**: desde la línea inmediatamente siguiente al primer header `# ` hasta la línea inmediatamente anterior a `# Referencias`. Quedan **fuera del scope**:
+- Header del documento (líneas antes del primer `# `): contiene el nombre del producto provisto por AW-PROJECT, que puede legítimamente incluir identificadores del equipo (ej. "RUNTIME QTC-*"). El nombre del producto no es jerga — es el título.
+- Sección `# Referencias`: contiene paths a `docs/<categoria>/` que son ineludibles.
+
+**Cómo validar**:
+
+```bash
+# Strippear header (antes del primer #) y sección Referencias
+awk '
+  BEGIN { body=0 }
+  /^# Referencias/ { body=0 }
+  body { print }
+  /^# / && !/Referencias/ { body=1 }
+' output.md > /tmp/body.md
+
+# grep contra cada término de la lista vetada (fixed strings, case-insensitive).
+# -F (fixed strings) captura compuestos como `flow=dev` y `<mcp-cert>` que
+# `-w` (word boundary) descartaría por contener caracteres no-palabra.
+grep -i -n -F -f lexico-vetado.txt /tmp/body.md
+```
+
+Salida vacía → V2 pasa. Salida con matches → V2 falla.
+
+**Nota de implementación**: `lexico-vetado.txt` es un archivo de una palabra/término por línea derivado de la "Lista vetada (V2)" de `lexico.md`. Como es fixed-string match, los términos genéricos cortos (≤3 caracteres) se descartan de la lista para evitar falsos positivos; los términos vetados elegidos son distintivos técnicos (`commits`, `skill`, `<mcp-cert>`, `flow=dev`, `Codex`, etc.) que no aparecen naturalmente en español ejecutivo.
+
+**Excepción adicional**: el patrón fijo `\bN sesiones trabajadas\b` en el header (cuando se cuela en cuerpo por alguna razón) NO cuenta como violación.
+
+**Error report (hard-fail)**:
+```
+V2 FAILED: léxico vetado detectado en cuerpo
+  ocurrencias:
+    línea 12: "...commits aplicados..."  → reemplazar por "cambios aplicados"
+    línea 28: "...flow=dev..."           → reemplazar por "trabajo de implementación"
+    línea 41: "...skill..."              → reemplazar por "componente del sistema"
+  total: 3 ocurrencias
+  acción: aplicar tabla de traducción de lexico.md y re-renderizar
+```
+
+## V3 — Secciones obligatorias presentes en orden + motor del diagrama
+
+**Severidad**: hard-fail si falta alguna sección obligatoria; hard-fail si el orden está mal. Warning si el motor del diagrama no es Mermaid en B/C (v1.2 default).
+
+**Secciones obligatorias por variante** (v1.1: B y C extendidas con Objetivo (reubicado desde Finalidades), Componentes impactados y Diagrama de flujo; rename Recomendaciones→Oportunidades de mejora):
+
+| Variante | Secciones obligatorias (orden) |
+|---|---|
+| A | `# Resumen`, `# Cambios`, `# Riesgos`, `# Referencias` (4 — más `# Oportunidades de mejora` condicional) |
+| B (default v1.1) | `# Resumen ejecutivo`, `# Período cubierto`, `# Objetivo`, `# Logros del período`, `# Componentes impactados`, `# Diagrama de flujo`, `# Alcances / Límites`, `# Riesgos y deuda`, `# Referencias` (9 — más `# Oportunidades de mejora` condicional) |
+| C (v1.1) | `# Resumen ejecutivo`, `# Contexto del período`, `# Objetivo`, `# Cambios por capacidad`, `# Componentes impactados`, `# Diagrama de flujo`, `# Alcances`, `# Límites`, `# Riesgos y deuda`, `# Referencias` (10 obligatorias — más `# Oportunidades de mejora` condicional) |
+
+**Motor del diagrama (v1.2)**: dentro de `# Diagrama de flujo` (B/C), el code fence debe ser ` ```mermaid ` con contenido `flowchart` o `graph` por default. Si es plain code fence con ASCII, se emite warning (`engine: ascii (fallback)`) en lugar de hard-fail — ASCII es válido como fallback opt-in.
+
+**Link de visualización (v1.3 — session078)**: cuando engine=mermaid, inmediatamente después del fence de cierre debe aparecer un blockquote con `> Ver diagrama renderizado: <https://mermaid.ink/img/BASE64>`. Si falta → warning `render_link: absent` (no hard-fail; corpus pre-v1.3 no lo tenía). Si engine=ascii → skip el check (ASCII no lleva link).
+
+**Cómo validar**: extraer todos los `^# ` headers del output, verificar que la lista incluye los obligatorios en el orden esperado. Dentro de la sección `# Diagrama de flujo`, parsear el primer code fence: si abre con ` ```mermaid ` → engine=mermaid (pass); si abre con ` ``` ` plano → engine=ascii (warning). Si engine=mermaid, buscar el blockquote `> Ver diagrama renderizado:` en la línea siguiente al fence de cierre — si presente, `render_link: present`; si ausente, `render_link: absent` (warning).
+
+**Error report**:
+```
+V3 FAILED: estructura de secciones inválida
+  variante: B
+  esperado: Resumen ejecutivo → Período cubierto → Objetivo → Logros del período → Componentes impactados → Diagrama de flujo → Alcances / Límites → Riesgos y deuda → [Oportunidades de mejora?] → Referencias
+  encontrado: Resumen ejecutivo → Logros del período → Objetivo → Alcances / Límites → Riesgos y deuda → Referencias
+  faltantes: Período cubierto, Componentes impactados, Diagrama de flujo
+  orden incorrecto: Objetivo debe ir antes de Logros del período
+  acción: regenerar incluyendo todas las secciones obligatorias en el orden correcto
+```
+
+## V4 — "Oportunidades de mejora" condicional honored
+
+**Severidad**: hard-fail si la sección aparece sin justificación en el corpus, o si falta cuando el corpus la justifica.
+
+v1.1 (session076): renombrada desde "Recomendaciones / próximos pasos" para alinear con el formato ejecutivo. La lógica de detección NO cambia — los corpus existentes mantienen `## Recommendations` / `## Recomendaciones` como header en CONCLUSIONS.md (sin migración forzada).
+
+**Condiciones de aparición** (al menos UNA debe matchear en el corpus filtrado):
+
+- ≥1 item en sección `## Open (gaps)` de algún `CONCLUSIONS.md` del corpus.
+- ≥1 item en sección `## Recommendations` / `## Recomendaciones` de algún `CONCLUSIONS.md`.
+- ≥1 decision con texto "pendiente" / "diferido" / "TODO" en `DECISIONS.md` del corpus.
+- ≥1 mención a "próximos pasos" / "futuras mejoras" / "oportunidades" / "queda pendiente" en `CHECKPOINT.md` o `CONCLUSIONS.md` del corpus.
+
+**Cómo validar**: pre-render — count de matches en el corpus filtrado.
+- `count > 0` → render debe incluir `# Oportunidades de mejora`.
+- `count == 0` → render debe NO incluir ese encabezado.
+
+Post-render: verificar consistencia.
+
+**Error report (caso A — sección presente sin justificación)**:
+```
+V4 FAILED: sección "Oportunidades de mejora" presente pero corpus filtrado no tiene items abiertos
+  corpus inspeccionado: 12 sesiones (período: last-month)
+  open gaps detectados: 0
+  recommendations detectadas: 0
+  decisions pendientes: 0
+  menciones "próximos pasos / oportunidades": 0
+  acción: omitir sección o ajustar detector
+```
+
+**Error report (caso B — sección omitida pero corpus la justifica)**:
+```
+V4 FAILED: corpus filtrado tiene items abiertos pero sección "Oportunidades de mejora" omitida
+  corpus inspeccionado: 12 sesiones (período: last-month)
+  open gaps detectados: 3 (en sessionXXX, sessionYYY, sessionZZZ)
+  decisions pendientes: 1 (DEC-014 en sessionWWW)
+  acción: incluir sección con los items detectados
+```
+
+## V5 — Header bien formado
+
+**Severidad**: warning (no bloquea — el usuario puede aceptar).
+
+**Checks**:
+- Línea 1 contiene `{{PRODUCTO}} — Informe ejecutivo` con `{{PRODUCTO}}` reemplazado por valor real (no literal).
+- Línea 2 contiene `Período: Del <DD> de <mes> al <DD> de <mes> de <YYYY>. <N> sesiones trabajadas.`
+- Fecha en formato natural ES (no `2026-05-18`).
+- Si variante C: línea 3 contiene `Audiencia: Comité de seguimiento`.
+
+**Error report (warning)**:
+```
+V5 WARNING: header incompleto o mal formado
+  línea 1: OK
+  línea 2: "Período: 2026-05-08 a 2026-05-18 (55 sesiones)"
+           → formato esperado: "Del 8 de mayo al 18 de mayo de 2026. 55 sesiones trabajadas."
+  acción sugerida: re-renderizar header con formato natural ES
+  ¿continuar de todas formas? (s/n)
+```
+
+## V6 — Referencias resolubles
+
+**Severidad**: warning (no bloquea).
+
+**Checks**: cada link en la sección `# Referencias` apunta a un path existente en filesystem al momento de la generación.
+
+**Cómo validar**:
+```bash
+grep -E '^- [A-Za-z]+:' references-section.md | \
+  sed -E 's/^- [A-Za-z]+: //' | \
+  while read p; do
+    if [ ! -e "$p" ]; then echo "MISSING: $p"; fi
+  done
+```
+
+**Error report (warning)**:
+```
+V6 WARNING: 2 referencias apuntan a paths inexistentes
+  - docs/arquitectura/NNN-export-arq-YYYY-MM-DD/  → no existe (export-arq aún no generado)
+  - docs/manuales/NNN-export-mt-YYYY-MM-DD/       → no existe (export-mt aún no generado)
+  acción sugerida: omitir referencias placeholder o regenerar tras producir export-arq y export-mt
+  ¿continuar de todas formas? (s/n)
+```
+
+## Orden de aplicación
+
+1. V1 (cota) — primero, barato (word count).
+2. V2 (léxico) — segundo, barato (grep).
+3. V3 (secciones) — tercero, barato (regex headers).
+4. V4 (oportunidades de mejora condicional) — cuarto, requiere consultar corpus.
+5. V5 (header) — quinto.
+6. V6 (referencias resolubles) — último.
+
+Si V1, V3 o V4 fallan → abortar inmediatamente. No correr el resto.
+Si V2 falla → abortar (no warning).
+Si V5 o V6 emiten warning → mostrar al usuario y pedir confirmación.
+
+## Reporte consolidado
+
+Al final del flujo, el skill devuelve:
+
+```json
+{
+  "ok": true | false,
+  "variant": "A" | "B" | "C",
+  "output_path": "docs/funcional/NNN-export-report-YYYY-MM-DD.md",
+  "word_count": 681,
+  "word_target": 700,
+  "validations": {
+    "V1": { "status": "pass", "actual": 681, "target": 700, "tolerance_pct": 10 },
+    "V2": { "status": "pass", "vetoed_hits": 0 },
+    "V3": { "status": "pass", "sections_found": ["Resumen ejecutivo","Período cubierto","Objetivo","Logros del período","Componentes impactados","Diagrama de flujo","Alcances / Límites","Riesgos y deuda","Oportunidades de mejora","Referencias"], "diagram_engine": "mermaid", "render_link": "present" },
+    "V4": { "status": "pass", "section_included": true, "trigger_count": 7 },
+    "V5": { "status": "warning", "issues": ["línea 2 con formato no-natural"] },
+    "V6": { "status": "warning", "missing_refs": ["docs/arquitectura/..."] }
+  },
+  "summary": "Output escrito. 2 warnings (V5/V6) aceptados por el usuario."
+}
+```
+
+Si algún hard-fail:
+
+```json
+{
+  "ok": false,
+  "stage": "validation",
+  "failed_at": "V2",
+  "details": "léxico vetado detectado en cuerpo: 3 ocurrencias (commits, flow=dev, skill)",
+  "no_file_written": true
+}
+```

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

@@ -0,0 +1,31 @@
+---
+name: export-requirement
+description: "[STUB] Genera un Requerimiento Funcional (`.md`) consolidando el corpus de sesiones del workspace y `docs/`. Stub vacío sin lógica activa — implementación diferida a una sesión futura. Output previsto: `docs/funcional/NNN-export-requirement-YYYY-MM-DD.md`. Read-only sobre el corpus. Invocado sólo vía `/agent-workflow:export-requirement`. Creado en session081-dev-extend-export-family con `version: 0.1.0`."
+version: 0.1.0
+---
+
+# Export Requirement — Stub vacío (sin lógica activa)
+
+> **STUB**. Este skill **no genera output útil aún**. Existe como placeholder discoverable para que el catálogo `/agent-workflow:export-*` lo registre. La implementación se difiere a una sesión futura (`flow=design` o `flow=dev`).
+
+## Alcance previsto
+
+Generar un único `.md` con el **Requerimiento Funcional** consolidado del workspace, dirigido a stakeholders de negocio/producto (no técnico). Audiencias típicas: PO, líder de área, auditoría funcional.
+
+- **Input canónico**: corpus = sesiones del workflow + `docs/`. Ver `agent-workflow/docs/shared-contract/export-corpus-sources.md` (DEC-002 session081).
+- **Subcarpetas de `docs/` que consumirá** (previstas): `docs/especificaciones/`, `docs/decisiones/`, `docs/funcional/`.
+- **Output previsto**: `<docs>/funcional/NNN-export-requirement-YYYY-MM-DD.md`.
+
+## Estado
+
+- Creado: session081-dev-extend-export-family (2026-05-21).
+- Implementación: **diferida**. Cuando se aborde, abrir sesión `flow=design` para spec primero (siguiendo el patrón session056 → session057 que sí funcionó para `export-report`).
+
+## Plan mode
+
+Reglas generales en `skills/session/references/sandbox-readonly-rules.md`. Como el skill es un stub, en plan mode reportar `ok: false` con `reason: "stub not implemented yet"` y referenciar esta sesión.
+
+## Recursos
+
+- `agent-workflow/docs/shared-contract/export-corpus-sources.md` — contrato corpus canónico (DEC-002 session081).
+- `.workflow/sessions/session081-dev-extend-export-family/OBJECTIVE.md` — alcance de la sesión que creó el stub.

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

@@ -0,0 +1,324 @@
+---
+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
+---
+
+# Export Scripts — Bundle SQL + informe consolidado desde N sesiones
+
+Consolida N sesiones cerradas (más opcionalmente activas) en un único output dir `docs/scripts/NNN-export-scripts-YYYY-MM-DD/`. Es **solo lectura/reporte**: el usuario sigue ejecutando scripts, correos, merges y commits manualmente.
+
+> Último comando de la familia `/agent-workflow:export-*`. Refactor que consolida `/agent-workflow:release` v2.0.0 + `/agent-workflow:release-scripts` v2.0.0. Propuesta del modelo: `docs/conclusiones/007-export-commands-family.md`. Plan de deprecación: ver `references/deprecation-plan.md`.
+
+## Excepción session-aware
+
+Como `release` y `release-scripts` legacy, este skill requiere conocimiento del lifecycle. **No crea ni modifica sesiones**. Si el workspace no tiene sesiones cerradas → abortar y sugerir `/agent-workflow:session create`.
+
+**Solo formato actual (v0.9+)**: sesiones legacy abortan; migrar con `/agent-workflow:migrate --upgrade-topology`.
+
+**Consumo de CLI `agent-workflow`** (no leer paths hardcodeados):
+
+- `agent-workflow release-data [--since sessionNNN] [--source alias] [--include-graduated]` — dump consolidado de sesiones + bundles graduados.
+- `agent-workflow session-artifacts --code <NNN>` — lectura lazy de OBJECTIVE/TASKS/DECISIONS/scripts (con fallback bilingual a OBJETIVO/TASKS/DECISIONES legacy).
+- `agent-workflow code-scan` — escaneo determinístico (built-in + opcionalmente `--patterns-file`).
+- `agent-workflow next-number docs/scripts` — numeración determinística del output dir.
+- Resolución hub-aware de `docs/scripts/` la maneja el CLI internamente.
+
+## When to use
+
+- "Bundle SQL del release", "informe de release", "qué falta para producción", "preparar paso a prod".
+- Sesiones cerradas a consolidar para promover a `certificacion` o `main`.
+- Re-generar tras agregar nuevas sesiones desde el último export.
+- Antes de go/no-go meeting.
+
+## Qué hace este skill
+
+1. Lee sesiones (`.workflow/sessions/`) recolectando `scripts/` y `queries/` 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/`.
+
+## Qué NO hace
+
+- Ejecutar commits, merges, push (ver `agent-workflow:commits-policy`).
+- Ejecutar scripts SQL contra BD.
+- 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).
+
+## 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.
+
+## Estilo de comunicación
+
+`../session/references/communication-style.md`. Confirmación antes de crear el bundle SQL consolidado; si declina, ejecutar como `--dry-run` (sólo reporte propositivo).
+
+## Entrada
+
+```
+/agent-workflow:export-scripts [--sessions NNN[,NNN]] [--since sessionNNN] [--source <alias>]
+                    [--themes slug1,slug2|infer] [--keep-parts]
+                    [--skip-code-scan] [--dry-run]
+```
+
+| Flag | Comportamiento |
+|---|---|
+| `--sessions NNN[,NNN]` | Filtro discreto por código. Toma precedencia sobre `--since` (si ambos se pasan, `--since` se ignora con warning) |
+| `--since sessionNNN` | Incluye sólo sesiones posteriores a NNN (inclusive). Ignorado si `--sessions` presente |
+| `--source <alias>` | Limita a una fuente específica (hub mode) |
+| `--themes slug1,slug2` | Genera `por-tema/` con los slugs declarados |
+| `--themes infer` | Inferencia LLM de temas (mismo flujo que release-scripts legacy) |
+| `--keep-parts` | Preserva `por-tema/<slug>/parts/<categoria>/*.sql` con scripts individuales |
+| `--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.
+
+Ejemplo: `/agent-workflow:export-scripts --sessions 055,057,061` consolida sólo esas 3 sesiones.
+
+## Flujo
+
+### Paso 1 — Descubrimiento de sesiones
+
+```
+agent-workflow release-data --include-graduated [--sessions NNN[,NNN]] [--since sessionNNN] [--source <alias>]
+```
+
+Output: `{workspace_mode, is_hub, source_alias, docs_root, sessions, sessions_count, legacy_sessions, graduated_bundles}`.
+
+**Sesiones legacy v0.x (REQUIREMENTS.md)**: si `legacy_sessions` no vacío → abortar:
+
+> 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)
+
+Por cada sesión del corpus, verificar el layout SQL:
+
+```
+agent-workflow session-artifacts --code <CODE>
+```
+
+Lógica:
+1. Si `scripts_sql_present: true` → OK, usar `SCRIPTS.sql` (path: `.workflow/sessions/<folder>/SCRIPTS.sql`).
+2. Si `scripts_sql_present: false` Y existe carpeta `.workflow/sessions/<folder>/scripts/` con sub-carpetas `01-ddl-tablas/`, `02-ddl-funciones/`, `03-migracion/` o `04-inserts/` → **ABORTAR**:
+
+   > Layout SQL legacy detectado en sessionXXX-<slug>:
+   > - scripts/01-ddl-tablas/...
+   > - scripts/02-ddl-funciones/...
+   > Migrar primero con `/agent-workflow:migrate --upgrade-topology` (consolida en SCRIPTS.sql) y luego re-correr export-scripts.
+
+3. Si ninguno de los dos: la sesión no tiene cambios SQL → skipear esa sesión silenciosamente (no es error).
+
+**Nunca consumir sesiones mixtas**: el bundle final debe ser coherente, sin mezclar layouts.
+
+Para artefactos por sesión: el `session-artifacts` ya incluye flags de presencia (`scripts_sql_present`, `conclusiones_present`, etc.).
+
+### Paso 2 — Escaneo de código fuente (delegado a `code-scan`)
+
+```
+agent-workflow code-scan
+```
+
+Built-in patterns: localhost, IP literal, TODO/FIXME/XXX/HACK, hardcoded-secret, console-log. Override con `--patterns-file references/code-scan-recommendations.md` (catálogo extendido) o `--pattern ID:REGEX:SEV` repetible.
+
+**Excludes** por default: `node_modules/`, `target/`, `dist/`, `build/`, `.workflow/`, `docs/`, `tests/`, `test/`, `.git/`, `__pycache__/`, `.idea/`, `.vscode/`. Override: `--exclude DIR1,DIR2`.
+
+**Extensiones** por default: `.java`, `.ts`, `.js`, `.py`, `.go`, `.rb`, `.php`, `.cs`, `.kt`, `.scala`, `.vue`, `.tsx`, `.jsx`, `.properties`, `.yml`, `.yaml`, `.json`, `.xml`, `.sql`. Override: `--ext`.
+
+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".
+
+Catálogo extendido (alta/media/baja con recomendaciones detalladas) en `references/code-scan-recommendations.md`.
+
+### Paso 3 — Estado de git
+
+```
+git rev-parse --abbrev-ref HEAD
+git log certificacion..HEAD --oneline
+git log HEAD..certificacion --oneline
+git status --porcelain
+git diff certificacion --stat
+git branch -a --list
+```
+
+Interpretar: rama actual, commits no mergeados, cambios sin commit, archivos modificados. Si `certificacion`: marcar "ya integrada". Si git falla: registrar advertencia, no abortar.
+
+### Paso 4 — Numeración del output dir
+
+```
+agent-workflow next-number docs/scripts
+```
+
+Output dir resuelto:
+- **hub mode** → `<hub>/docs/scripts/NNN-export-scripts-YYYY-MM-DD/`.
+- **project mode** → `<cwd>/docs/scripts/NNN-export-scripts-YYYY-MM-DD/`.
+
+Si `docs/scripts/` no existe, crearlo.
+
+### Paso 5 — `por-sesion/` (bundle por sesión, v3.0.0)
+
+Para cada sesión del corpus que tenga `SCRIPTS.sql` (verificado en Paso 1.5):
+
+1. Crear `por-sesion/sessionXXX-<slug>/`.
+2. **Leer y parsear `SCRIPTS.sql`** de la sesión:
+   - 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.
+   - 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)
+
+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):
+
+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`.
+
+Si no activado, **skip** este paso completo (sin sub-carpeta `por-tema/` vacía).
+
+### Paso 7 — `rollback-global.sql` + `ORDER.md`
+
+**`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.
+
+**`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`.
+
+### Paso 8 — Detección de acciones manuales
+
+Cruzar contra `release/references/manual-actions-catalog.md` (reference cruzada — DEC-004 session061). Reglas resumidas:
+
+| 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 |
+| `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.
+
+### Paso 9 — `manifest.md` + `README.md` + validaciones
+
+**`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.
+
+**`README.md`**: índice del directorio + mapeo sesión↔tema↔scripts + how-to-execute. Usar `references/readme-template.md`.
+
+**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.
+- V6 referencias resolubles (paths a `docs/`).
+
+Si V1, V3 o V4 fallan → abortar con error report. V2, V5, V6 → warning.
+
+### Paso 10 — Escribir output
+
+Si `--dry-run`: imprimir reporte (count sesiones incluidas, hallazgos por severidad, acciones manuales, V4 outcome). No escribir.
+
+Si pasa: escribir directorio completo:
+
+```
+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
+    ├── 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
+    └── tema-<otro>/...
+```
+
+### Paso 11 — Resumen al usuario
+
+- Ruta del bundle (`docs/scripts/NNN-export-scripts-YYYY-MM-DD/`).
+- Counts: sesiones incluidas, scripts totales, hallazgos por severidad, acciones manuales pendientes.
+- Si `por-tema/` activado: temas resueltos + scripts por tema.
+- Advertencias bloqueantes: sesiones abiertas, rollback ausente, irreversibles sin respaldo.
+
+## 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.
+- **`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.
+
+## Re-ejecución
+
+Idempotente funcional pero NO sobreescribe bundles previos. Cada ejecución toma siguiente NNN. Para regenerar: borrar el directorio manualmente y re-invocar.
+
+## Relación con `release` / `release-scripts` legacy
+
+Plan de deprecación Fase 1 (plugin v2.8.0):
+- `/agent-workflow:release` y `/agent-workflow:release-scripts` siguen funcionando idénticos. Output legacy (`docs/release/NNN-informe-release.md` + `docs/scripts/NNN-sessionXXX-<slug>/` + `scripts-por-tema/`) sin cambios.
+- Banner deprecation visible al cargar SKILL.md y commands/*.md de ambos.
+- Workspaces que ya invocaron `release` mantienen `docs/release/` como histórico. Nuevas invocaciones se hacen vía `/agent-workflow:export-scripts`.
+
+Plan de deprecación Fase 2 (plugin v3.0.0 — futuro, sin compromiso de fecha):
+- Remoción de skills + commands legacy.
+- Decisión final cuando se confirme migración cross-workspace.
+
+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/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.
+- **`references/code-scan-recommendations.md`** — catálogo extendido de patrones (port directo de `release/references/code-scan-patterns.md`).
+- **`references/theme-handling.md`** — algoritmo de detección/consolidación por tema (port adaptado de `release-scripts/references/theme-detection.md` + `order-generation.md`).
+- **`references/deprecation-plan.md`** — plan de fases 1-2.
+- **`release/references/manual-actions-catalog.md`** — catálogo de acciones manuales (reference cruzada — DEC-004 session061).
+- **`docs/conclusiones/007-export-commands-family.md`** — Propuesta original de la familia `/agent-workflow:export-*`.
+- **`agent-workflow/skills/export-report/SKILL.md`**, **`export-arq/SKILL.md`**, **`export-tech-manuals/SKILL.md`** — hermanos de la familia.