@tacuchi/agent-workflow-cli 11.0.1 → 12.0.0

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

@@ -1,255 +0,0 @@
-# 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

@@ -1,31 +0,0 @@
----
-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

@@ -1,211 +0,0 @@
----
-name: export-scripts
-description: "Consolida los SQL pendientes del workspace en un único paquete `docs/scripts/NNN-export-scripts-YYYY-MM-DD/` con numeración continua: `00-ROLLBACK.sql` + `01-…`, `02-…`, etc. en orden ascendente. Lee SQL desde dos fuentes: `.workflow/sessions/<folder>/SCRIPTS.sql` de cada sesión Y archivos `docs/scripts/*.sql` standalone (excluyendo bundles previos `docs/scripts/NNN-export-scripts-*/`). Headers SQL mínimos (1 línea), README minimal (solo índice + cómo aplicar + cómo revertir). Genera `00-ROLLBACK.sql` AL FINAL leyendo los forwards consolidados. Read-only/reporte — no ejecuta SQL ni commits. Invocado vía `/agent-workflow:export-scripts`."
-version: 5.0.0
----
-
-# Export Scripts — Bundle SQL consolidado, simple y directo
-
-Consolida SQL pendientes de N sesiones + archivos standalone en un único bundle `docs/scripts/NNN-export-scripts-YYYY-MM-DD/` con numeración continua tras `00-ROLLBACK.sql`. Solo lectura/reporte: el usuario aplica los scripts manualmente.
-
-> v5.0.0 (session103) — simplificación radical del v4.0.0: numeración continua, headers SQL de 1 línea, README minimal (3 secciones), búsqueda extendida a `docs/scripts/*.sql` standalone, rollback derivado de forwards.
-
-## Excepción session-aware
-
-Requiere conocimiento del lifecycle. **No crea ni modifica sesiones**. Si el workspace no tiene SQL pendientes (ni en sesiones cerradas ni en `docs/scripts/`) → abortar.
-
-**Consumo de CLI `agent-workflow`** (no leer paths hardcodeados):
-
-- `agent-workflow release-data [--since sessionNNN] [--source alias] [--include-graduated]` — dump consolidado de sesiones.
-- `agent-workflow session-artifacts --code <NNN>` — lectura lazy de artefactos por sesión.
-- `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", "preparar paso a prod", "consolidar SQLs pendientes".
-- Antes de promover a `certificacion` o `main`.
-
-## Qué hace
-
-1. Recolecta SQL del workspace desde **dos fuentes** (Paso 1):
-   - `.workflow/sessions/<folder>/SCRIPTS.sql` de cada sesión del corpus.
-   - `docs/scripts/*.sql` standalone (top-level), **excluyendo** cualquier `docs/scripts/NNN-export-scripts-*/` (bundles previos de este mismo skill).
-2. Clasifica sentencias por categoría (DDL-TABLES / DDL-FUNCTIONS / DML / INSERTS).
-3. Consolida cross-source por categoría en archivos al root del bundle con **numeración continua** tras `00-ROLLBACK.sql` (Paso 4).
-4. Escribe los forwards consolidados.
-5. Genera `00-ROLLBACK.sql` **al final**, leyendo los forwards ya escritos (Paso 6).
-6. Escribe `README.md` minimal con índice de archivos + cómo aplicar + cómo revertir (Paso 7).
-
-## Qué NO hace
-
-- Ejecutar SQL, commits, merges, push.
-- Tocar `.workflow/sessions/` ni archivos standalone de `docs/scripts/*.sql` (lectura only).
-- Migrar bundles previos (`docs/scripts/00X-export-scripts-*` quedan como histórico).
-- Generar plantillas de correo, checklists de producción, listados de commits, listados de sesiones, ACT-NNN, resúmenes ejecutivos.
-
-## Sandbox read-only
-
-`../session/references/sandbox-readonly-rules.md`. Plan describe NNN, fuentes detectadas, archivos esperados al root y contenido aproximado del README.
-
-## Entrada
-
-```
-/agent-workflow:export-scripts [--sessions NNN[,NNN]] [--since sessionNNN] [--source <alias>]
-                               [--skip-standalone] [--dry-run]
-```
-
-| Flag | Comportamiento |
-|---|---|
-| `--sessions NNN[,NNN]` | Filtro discreto por código (precedencia sobre `--since`) |
-| `--since sessionNNN` | Incluye sólo sesiones posteriores a NNN (inclusive) |
-| `--source <alias>` | Limita a una fuente específica (hub mode) |
-| `--skip-standalone` | Omite la lectura de `docs/scripts/*.sql` standalone |
-| `--dry-run` | Reporte propositivo sin escribir archivos |
-
-Sin args: incluye todas las sesiones cerradas + todos los `.sql` standalone de `docs/scripts/` (excluyendo bundles previos).
-
-## Flujo
-
-### Paso 1 — Recolección de fuentes SQL
-
-**Fuente A — sesiones**:
-
-```
-agent-workflow release-data [--sessions NNN[,NNN]] [--since sessionNNN] [--source <alias>]
-```
-
-Por cada sesión del corpus, leer `.workflow/sessions/<folder>/SCRIPTS.sql` si existe. Si no existe → skip silencioso (no es error). Markers esperados: `-- @category: <01-04>` + `-- @stmt: NNN-verbo-objetivo` (spec en `agent-workflow/skills/sql-script-organizer/references/scripts-sql-format.md`).
-
-**Fuente B — standalone en `docs/scripts/`** (a menos que `--skip-standalone`):
-
-Listar `docs/scripts/*.sql` (sólo top-level). **Excluir explícitamente** cualquier archivo dentro de directorios `docs/scripts/NNN-export-scripts-*/` (son outputs previos de este skill, no fuente). Por cada archivo:
-- Inferir categoría desde el contenido: `CREATE TABLE`/`ALTER TABLE`/`CREATE INDEX` → `01`; `CREATE OR REPLACE FUNCTION` → `02`; `UPDATE`/`DELETE` → `03`; `INSERT INTO ... VALUES` → `04`.
-- Si el archivo tiene markers `@category` explícitos, respetar el declarado.
-- Si el filename contiene `rollback` (caso `*-rollback.sql` legacy): skip — no se incluye en forward, se asume que el operador ya tiene su propio rollback.
-
-Si la unión de Fuentes A + B está vacía → abortar con mensaje "No hay SQL pendientes en el workspace".
-
-### Paso 2 — Numeración del output dir
-
-```
-agent-workflow next-number docs/scripts
-```
-
-Output: `<docs>/scripts/NNN-export-scripts-YYYY-MM-DD/` (hub-aware vía CLI).
-
-### Paso 3 — Clasificación y orden interno
-
-Agrupar todas las sentencias recolectadas por categoría canónica:
-
-1. `DDL-TABLES` — `CREATE TABLE`, `ALTER TABLE`, `CREATE INDEX`, `CREATE SEQUENCE`.
-2. `DDL-FUNCTIONS` — `CREATE OR REPLACE FUNCTION`, `PROCEDURE`.
-3. `DML` — `UPDATE`, `DELETE`, migraciones de datos.
-4. `INSERTS` — `INSERT INTO ... VALUES`, seeds.
-
-Orden interno dentro de cada categoría: cronológico por origen — sesionXXX ascendente → stmt ascendente dentro de cada una; archivos standalone se intercalan por su orden léxico (`001-…`, `002-…`).
-
-### Paso 4 — Numeración continua
-
-Asignar números **secuenciales** a las categorías **con contenido**, en el orden canónico arriba:
-
-| Categorías presentes | Archivos generados al root |
-|---|---|
-| Sólo DML | `00-ROLLBACK.sql`, `01-DML.sql` |
-| DDL-TABLES + DML | `00-ROLLBACK.sql`, `01-DDL-TABLES.sql`, `02-DML.sql` |
-| DDL-TABLES + DDL-FUNCTIONS + INSERTS | `00-ROLLBACK.sql`, `01-DDL-TABLES.sql`, `02-DDL-FUNCTIONS.sql`, `03-INSERTS.sql` |
-| Las 4 | `00-ROLLBACK.sql`, `01-DDL-TABLES.sql`, `02-DDL-FUNCTIONS.sql`, `03-DML.sql`, `04-INSERTS.sql` |
-
-**Sin gaps**: categorías vacías no ocupan número. El primer forward siempre es `01-…`.
-
-### Paso 5 — Escribir forwards
-
-Por cada categoría con contenido, escribir un archivo con:
-
-**Header del archivo** (3 líneas máx):
-
-```sql
--- 0N-<CATEGORIA>.sql — bundle NNN-export-scripts-YYYY-MM-DD
--- Generado por agent-workflow export-scripts v5.0.0
-```
-
-**Cuerpo**: las sentencias consolidadas en orden cronológico. Por cada sentencia, **un comentario de una línea** identificando su origen, seguido del SQL:
-
-```sql
--- sessionXXX / NNN-verbo-objetivo
-BEGIN;
-<SQL del SCRIPTS.sql original>
-COMMIT;
-```
-
-**Reglas de header SQL**:
-- No replicar la motivación / impacto / idempotencia que ya está en el SCRIPTS.sql origen (se copia tal cual lo que escribió el developer).
-- No agregar índice de sentencias al inicio del archivo.
-- No agregar SELECTs de verificación post-write — si el developer los puso en SCRIPTS.sql, quedan; si no, no se inventan.
-- El header de bloque per-sentencia es UNA línea: `-- sessionXXX / stmt-id` o `-- docs/scripts/001-filename.sql` (para fuente standalone).
-
-### Paso 6 — Generar `00-ROLLBACK.sql` (al final)
-
-Delegar a `sql-rollback-generator` v3.0.0+ **leyendo los forwards ya escritos** (no el SCRIPTS.sql original). Produce un archivo único al root del bundle con:
-
-- Header mínimo (2 líneas: bundle + fecha).
-- Sentencias inversas en orden inverso al de los forwards (último → primero).
-- Bloque `BEGIN; … COMMIT;` único.
-- Bloque "Fase 5 — Cleanup irreversible" al final fuera de la transacción (solo si hay irreversibles).
-
-### Paso 7 — Escribir `README.md`
-
-Usar `references/readme-template.md`. Sólo 3 secciones:
-
-1. `## Archivos` — tabla con archivos generados (1 fila por archivo presente).
-2. `## Aplicar` — bloque `bash` con `psql -f` por archivo, en orden ascendente.
-3. `## Revertir` — `psql -f 00-ROLLBACK.sql` + nota sobre Fase 5 si aplica.
-
-**Vetado** en el README: resumen ejecutivo, tabla de sesiones, plantillas de correo, ACT-NNN, listado de commits, checklist de producción, documentación graduada.
-
-### Paso 8 — Validaciones V1-V2
-
-Aplicar `references/validations.md`:
-
-- **V1**: estructura del bundle (archivos obligatorios + numeración continua sin gaps + vetados ausentes).
-- **V2**: ausencia de placeholders en `README.md` y `.sql`.
-
-Ambas hard-fail. Si fallan → abortar antes de finalizar.
-
-### Paso 9 — Resumen al usuario
-
-Una línea por archivo escrito + ruta del bundle. No replicar el contenido del README en el resumen. Ejemplo:
-
-```
-Bundle escrito: docs/scripts/004-export-scripts-2026-05-28/
-  00-ROLLBACK.sql  (12 líneas)
-  01-DML.sql       (28 líneas)
-  README.md        (18 líneas)
-```
-
-## Composición con otras skills
-
-- **`sql-script-organizer`** — clasificación de categorías 01-04 cross-session.
-- **`sql-rollback-generator`** v3.0.0+ — `00-ROLLBACK.sql` derivado de forwards.
-- **`session`** — este skill NO invoca graduación ni cierre.
-- **`agent-workflow:redaccion-simple`** — preset default aplicado en prosa del `README.md`.
-
-## Re-ejecución
-
-Idempotente funcional pero NO sobrescribe bundles previos. Cada ejecución toma siguiente NNN. Para regenerar: borrar el directorio manualmente y re-invocar.
-
-## Recursos adicionales
-
-- **`references/readme-template.md`** — plantilla del README minimal.
-- **`references/validations.md`** — V1-V2 hard-fail.
-- **`references/lexico-tecnico.md`** — lista de placeholders vetados (V2).
-- **`references/code-scan-recommendations.md`** — catálogo opcional si se requiere escaneo de código adicional (NO se ejecuta por default en v5.0.0; el flujo del bundle no requiere code-scan).
-- **`references/theme-handling.md`** — DEPRECATED en v5.0.0 (capa `por-tema/` removida del default; ver histórico si se requiere reactivar).
-- **`references/manifest-template.md`** — DEPRECATED desde v4.0.0 (absorbido por README).
-- **`references/deprecation-plan.md`** — plan de fases legacy `release`/`release-scripts`.
-
-## Histórico de versiones
-
-- **v5.0.0** (session103, 2026-05-28) — simplificación: numeración continua, headers SQL minimal, README de 3 secciones, búsqueda extendida a `docs/scripts/*.sql` standalone, rollback derivado de forwards. Sin code-scan ni theme handling por default.
-- **v4.0.0** (session093) — layout plano cross-session (`00-ROLLBACK.sql` + `01-04` por categoría). Histórico — bundles previos no se migran.
-- **v3.x y anteriores** — layout `por-sesion/` + `manifest.md` + `ORDER.md` + companions. Histórico.

package/skills/agent-workflow/exports/export-scripts/references/code-scan-recommendations.md

@@ -1,83 +0,0 @@
-# Catálogo de patrones de code-scan + recomendaciones
-
-> **Port directo** de `agent-workflow/skills/release/references/code-scan-patterns.md` v2.0.0. DEC-004 de session061: el contenido es idéntico al original. Si Fase 2 remueve `release`, este archivo queda como canónico.
-
-## Patrones built-in del CLI `agent-workflow code-scan`
-
-| ID | Severidad | Patrón | Recomendación |
-|---|---|---|---|
-| `LOCALHOST` | media | `http://localhost`, `127.0.0.1`, `0.0.0.0` literal | Reemplazar por env var o configuración por ambiente. |
-| `IP_LITERAL` | media | IP estática IPv4 en código (excepto `127.0.0.1` ya capturado) | Mover a configuración externa. |
-| `TODO` | baja | `TODO`, `FIXME`, `XXX`, `HACK` en comentarios | Resolver antes de release o documentar deuda técnica. |
-| `HARDCODED_SECRET` | alta | strings con `password=`, `api_key=`, `secret=`, tokens base64 largos | Mover a env var o gestor de secretos. Si fue commiteado: **rotar la credencial**. |
-| `CONSOLE_LOG` | baja | `console.log`, `console.debug`, `print()`, `System.out.println` en código de producción | Eliminar o reemplazar por logger por nivel. |
-
-## Patrones extendidos (opt-in vía `--pattern`)
-
-| ID | Severidad | Patrón | Recomendación |
-|---|---|---|---|
-| `SQL_INJECTION` | alta | string concatenation en construcción de SQL | Usar prepared statements / query parameters. |
-| `DEPRECATED_API` | baja | uso de APIs marcadas deprecated en deps actuales | Migrar antes del próximo upgrade mayor. |
-| `MAGIC_NUMBER` | baja | literal numérico sin constante con nombre | Extraer a constante con nombre descriptivo. |
-| `TODO_FECHADO` | media | `TODO(YYYY-MM-DD)` con fecha pasada | Resolver — la deuda venció. |
-
-## Override de patrones
-
-Pasar al CLI:
-
-```bash
-agent-workflow code-scan --pattern "SQL_INJECTION:string\.format.*SELECT:high" \
-                         --pattern "DEPRECATED_API:@Deprecated:low"
-```
-
-O archivo de patterns:
-
-```json
-{
-  "patterns": [
-    { "id": "CUSTOM_RULE", "regex": "...", "severity": "medium", "recommendation": "..." }
-  ]
-}
-```
-
-## Excludes y extensiones
-
-Default excludes: `node_modules/`, `target/`, `dist/`, `build/`, `.workflow/`, `docs/`, `tests/`, `test/`, `.git/`, `__pycache__/`, `.idea/`, `.vscode/`.
-
-Default extensions: `.java`, `.ts`, `.js`, `.py`, `.go`, `.rb`, `.php`, `.cs`, `.kt`, `.scala`, `.vue`, `.tsx`, `.jsx`, `.properties`, `.yml`, `.yaml`, `.json`, `.xml`, `.sql`.
-
-Override:
-
-```bash
-agent-workflow code-scan --exclude vendor/,third_party/ --ext .java,.ts,.kt
-```
-
-## Output del CLI
-
-```json
-{
-  "matches": [
-    {
-      "pattern_id": "HARDCODED_SECRET",
-      "severity": "high",
-      "file": "src/main/java/com/example/Config.java",
-      "line": 42,
-      "snippet": "password = \"...\"",
-      "recommendation": "Mover a variable de entorno o gestor de secretos. Rotar la credencial si fue commiteada."
-    }
-  ],
-  "counts": { "high": 1, "medium": 3, "low": 12 },
-  "by_severity": { ... },
-  "total_matches": 16
-}
-```
-
-## Integración con el manifest
-
-El skill `export-scripts` consume este output y lo presenta en §5 del `manifest.md`:
-- §5.1 — severidad alta (tabla completa).
-- §5.2 — severidad media (tabla completa).
-- §5.3 — severidad baja (top 10 + conteo si >20).
-- §5.4 — alcance del escaneo (excludes + extensiones efectivas).
-
-Si `--skip-code-scan` se usó, §5 se reemplaza por nota inline `_(Escaneo omitido por --skip-code-scan)_` (V4.b de `validations.md`).

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

@@ -1,80 +0,0 @@
-# Plan de deprecación — `release` + `release-scripts` → `export-scripts`
-
-Plan canónico definido en Propuesta 007 R2 y materializado en session061.
-
-## Estado (plugin v2.8.0 — Fase 1)
-
-### `release` v2.0.0 → v2.0.1
-
-- **SKILL.md**: banner deprecation en la primera línea del body.
-- **commands/release.md**: banner equivalente.
-- Comportamiento: **idéntico al v2.0.0**. Output sigue siendo `docs/release/NNN-informe-release.md` + `docs/scripts/NNN-sessionXXX-<slug>/`.
-- Invocaciones automatizadas (CI, makefiles, scripts internos) NO se rompen.
-
-### `release-scripts` v2.0.0 → v2.0.1
-
-- Mismo tratamiento: banner pasivo, comportamiento sin cambios.
-- Output sigue siendo `docs/release/NNN-release-*/scripts-por-tema/`.
-
-### Banner canónico (texto literal)
-
-```markdown
-> ⚠️ **DEPRECATED desde plugin v2.8.0**: usar `/agent-workflow:export-scripts` (refactor que consolida release + release-scripts en un único output dir). Este comando se mantiene por compatibilidad; remoción prevista en plugin v3.0.0. Detalles: `docs/conclusiones/007-export-commands-family.md` §R2.
-```
-
-## Estado (plugin v3.0.0 — Fase 2 — futuro)
-
-**Sin compromiso de fecha**. Disparadores que activarían Fase 2:
-
-1. Telemetría / encuesta confirma que ≥80% de workspaces migraron a `/agent-workflow:export-scripts`.
-2. Ningún PR en los últimos 3 meses depende de output legacy (`docs/release/`).
-3. Equipo runtime confirma que el plan deprecation Fase 1 cubrió todos los edge cases.
-
-Cuando se active:
-- Remover `skills/release/` y `commands/release.md`.
-- Remover `skills/release-scripts/` y `commands/release-scripts.md`.
-- Decisión sobre `docs/release/` legacy en cada workspace: **NO** se migra. Queda como histórico fijo (workspaces de producto los preservan; el AI los lee si el usuario pregunta).
-- Bump plugin a v3.0.0 (BREAKING).
-
-## Compatibilidad cross-skill
-
-### Skills/refs que aún apuntan a `release` o `release-scripts`
-
-Lista a verificar al cerrar Fase 1:
-
-| Skill / archivo | Referencia | Acción Fase 1 | Acción Fase 2 |
-|---|---|---|---|
-| `agent-workflow:session/SKILL.md` §"Cerrar sesión" tabla de kinds | `/agent-workflow:release` como único disparador de kind `script` y `release` | Mantener — `release` legacy sigue funcionando | Reemplazar por `/agent-workflow:export-scripts` |
-| `agent-workflow:dev-workflow/SKILL.md` | Referencia release como punto de entrada | Mantener | Actualizar |
-| `agent-workflow:release/SKILL.md` | Banner deprecation | Banner agregado | Skill removido |
-| `agent-workflow:release-scripts/SKILL.md` | Banner deprecation | Banner agregado | Skill removido |
-| `qtc-plugins-marketplace/.claude-plugin/marketplace.json` | Descripción del plugin | v2.8.0 con texto nuevo + deprecation note | v3.0.0 sin mención de release legacy |
-| `agent-workflow/README.md` | Header de versión | v2.8.0 + 13 commands | v3.0.0 + 11 commands |
-
-### Reusos cross-skill durante Fase 1
-
-`export-scripts` referencia (no porta) algunos archivos de release/release-scripts:
-
-| Skill | Archivo referenciado | Por qué reference y no port |
-|---|---|---|
-| `release` | `references/manual-actions-catalog.md` | Contenido invariante (matriz acción↔condición). Deduplicar. |
-
-Cuando Fase 2 remueva `release`/`release-scripts`: este archivo se **colapsa** al port (mover a `export-scripts/references/manual-actions-catalog.md`). Es parte del checklist de Fase 2.
-
-## Comunicación a usuarios
-
-Al cargar `release` o `release-scripts` legacy (v2.0.1):
-
-```
-> ⚠️  Comando deprecated desde plugin v2.8.0
-> Migrar a: /agent-workflow:export-scripts
-> Detalles: docs/conclusiones/007-export-commands-family.md §R2
-```
-
-El banner se imprime una vez por sesión (no spammea). El skill continúa ejecutando normalmente.
-
-## Decisiones de no-acción
-
-- **NO** redirigir `/agent-workflow:release` a `/agent-workflow:export-scripts` internamente. El refactor no es semánticamente idéntico (output dir + estructura cambian). Un redirect silencioso confundiría a workspaces con CI que asume `docs/release/`.
-- **NO** migrar `docs/release/` histórico de workspaces de producto. Cada workspace lo decide cuando active export-scripts.
-- **NO** crear `--legacy-output` flag en export-scripts. Romper la simetría del patrón export-* por compat sería deuda futura.