@tacuchi/agent-workflow-cli 11.0.1 → 12.0.0

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

@@ -1,132 +0,0 @@
-# Template — Plan ejecutable (output de `/agent-workflow:export-plan`)
-
-Plantilla canónica del archivo generado en `docs/planes/NNN-<slug>-YYYY-MM-DD.md`. El skill `export-plan` la aplica reemplazando los placeholders con datos derivados del corpus.
-
-## Estructura
-
-````markdown
----
-state: draft
-sessions: [<NNN1>, <NNN2>, ...]
-created: <YYYY-MM-DD>
-slug: <kebab-slug>
-eta_total: <Nh|Nd>
-state_changes:
-  - {from: null, to: draft, when: <YYYY-MM-DDThh:mm:ssZ>, trigger: 'export-plan create'}
-dependencies_external: []
-risks: []
----
-
-# Plan — <Título derivado del corpus>
-
-## Resumen
-
-<2-3 párrafos. Objetivo común derivado de los OBJECTIVEs de las sesiones fuente. Audiencia. Output esperado del plan. Sin jerga inventada.>
-
-## Fases
-
-### <Fase 1 — nombre>
-
-- **Entrada**: <criterios>
-- **Salida**: <criterios>
-
-### <Fase 2 — nombre>
-
-- **Entrada**: <criterios>
-- **Salida**: <criterios>
-
-<repetir por fase>
-
-## Tasks
-
-| ID  | Task                                    | ETA | Fase     | Depende de | Sesión origen        |
-|-----|-----------------------------------------|-----|----------|------------|----------------------|
-| T1  | <descripción accionable>                | 1h  | planning | —          | session055:T3        |
-| T2  | <descripción accionable>                | 2h  | exec     | T1         | session057:T1        |
-| T3  | <descripción accionable> [done]         | 0.5h| exec     | —          | session061:T2        |
-| ... | ...                                     | ... | ...      | ...        | ...                  |
-
-Total: ≈<N>h en <M> tareas (<M_open> abiertas, <M_done> ya cerradas en sus sesiones origen).
-
-## Dependencias externas
-
-- <Librería/servicio/equipo>: <razón + bloqueante o no>
-- ...
-
-## Riesgos
-
-- **R1 — <descripción corta>**. Mitigación: <acción>. Origen: `<sessionXXX-...>:FINDINGS.md#F-X`.
-- ...
-
-## Refs
-
-- `session055-analyze-docs-from-sessions` — [`OBJECTIVE`](../.workflow/sessions/session055-analyze-docs-from-sessions/OBJECTIVE.md) · [`CONCLUSIONS`](../.workflow/sessions/session055-analyze-docs-from-sessions/CONCLUSIONS.md)
-- `session057-dev-export-func` — [`OBJECTIVE`](../.workflow/sessions/session057-dev-export-func/OBJECTIVE.md) · [`TASKS`](../.workflow/sessions/session057-dev-export-func/TASKS.md)
-- ...
-````
-
-## Reglas de uso
-
-- **Frontmatter obligatorio**: `state`, `sessions`, `created`, `slug`, `state_changes` siempre presentes.
-- **Frontmatter opcional**: `eta_total`, `dependencies_external`, `risks` — incluir si hay datos derivables; omitir si vacío.
-- **Idioma**: ES default (idioma del usuario en el hub). Headers EN canon (`Plan`, `Resumen`, `Fases`, `Tasks`, etc. quedan EN porque son discriminators canónicos).
-- **Tabla Tasks**: usar pipes Markdown estándar. Marcar `[done]` las tareas ya cerradas en sus sesiones origen (sufijo después de la descripción).
-- **Refs**: paths relativos desde `docs/planes/NNN-*.md` (sube `..` para llegar al workspace root, luego baja a `.workflow/sessions/...`).
-- **state_changes[]**: append-only. Cada transición añade un objeto. Nunca borrar entradas previas (auditoría).
-
-## Ejemplo mínimo (smoke test)
-
-````markdown
----
-state: draft
-sessions: [055, 061]
-created: 2026-05-18
-slug: export-plan
-eta_total: 6h
-state_changes:
-  - {from: null, to: draft, when: '2026-05-18T22:00:00Z', trigger: 'export-plan create'}
----
-
-# Plan — Consolidación familia export-* + scripts
-
-## Resumen
-
-Consolidación de la propuesta familia `/agent-workflow:export-*` (session055) y el dev de export-scripts (session061) en un plan ejecutable que cubra los gaps restantes del bundle. Audiencia: equipo runtime agent-workflow. Output esperado: 2-3 sesiones dev secuenciadas que cierren docs/conclusiones/007.
-
-## Fases
-
-### planning
-- **Entrada**: session055 cerrada con CONCLUSIONS graduada.
-- **Salida**: TASKS.md aprobado por usuario.
-
-### exec
-- **Entrada**: planning ok.
-- **Salida**: skills + commands creados, tests verdes.
-
-### closure
-- **Entrada**: exec ok.
-- **Salida**: HISTORY actualizada, CHECKPOINT.md, plan en state `done`.
-
-## Tasks
-
-| ID | Task | ETA | Fase | Depende de | Sesión origen |
-|----|------|-----|------|------------|---------------|
-| T1 | Validar contrato familia export-* en propuesta 007 | 1h | planning | — | session055:T2 |
-| T2 | Implementar skill export-plan | 4.5h | exec | T1 | (nueva) |
-| T3 | Implementar skill export-conclusions | 3h | exec | T1 | (nueva) |
-
-Total: ≈8.5h en 3 tareas (3 abiertas).
-
-## Dependencias externas
-
-- Ninguna externa al runtime agent-workflow.
-
-## Riesgos
-
-- **R1 — Mismatch con propuesta 007 (familia cerrada en 4 comandos)**. Mitigación: actualizar 007 o emitir Propuesta 008. Origen: `session055-analyze-docs-from-sessions:CONCLUSIONS.md#R7`.
-
-## Refs
-
-- `session055-analyze-docs-from-sessions` — [`OBJECTIVE`](../.workflow/sessions/session055-analyze-docs-from-sessions/OBJECTIVE.md) · [`CONCLUSIONS`](../.workflow/sessions/session055-analyze-docs-from-sessions/CONCLUSIONS.md)
-- `session061-dev-export-scripts` — [`OBJECTIVE`](../.workflow/sessions/session061-dev-export-scripts/OBJECTIVE.md)
-````

package/skills/agent-workflow/exports/export-qa-note/SKILL.md

@@ -1,31 +0,0 @@
----
-name: export-qa-note
-description: "[STUB] Genera una Nota de Entrega a QA (`.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-qa-note-YYYY-MM-DD.md`. Read-only sobre el corpus. Invocado sólo vía `/agent-workflow:export-qa-note`. Creado en session081-dev-extend-export-family con `version: 0.1.0`."
-version: 0.1.0
----
-
-# Export QA Note — 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 la **Nota de Entrega a QA**, dirigida al equipo de QA para enmarcar el alcance del testing de un release/feature. Suele acompañar a `/agent-workflow:export-scripts` con la diferencia que QA necesita criterios de aceptación + casos de prueba + golden paths, no el bundle SQL.
-
-- **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/scripts/`, `docs/especificaciones/`, `docs/conclusiones/`.
-- **Output previsto**: `<docs>/funcional/NNN-export-qa-note-YYYY-MM-DD.md` (sub-decisión a tomar en la sesión de implementación: ¿funcional/ o nueva subcarpeta `qa/`?).
-
-## Estado
-
-- Creado: session081-dev-extend-export-family (2026-05-21).
-- Implementación: **diferida**. Cuando se aborde, abrir sesión `flow=design` para spec primero.
-
-## 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"`.
-
-## 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-report/SKILL.md

@@ -1,262 +0,0 @@
----
-name: export-report
-description: "Genera un informe funcional ejecutivo (`.md`) consolidando el corpus de sesiones del workspace y `docs/`, dirigido a gerencia/jefatura/comité. Variante B default (≤760 palabras), A (400w compacto) y C (1620w extenso) derivadas vía `--audiencia`. Estructura: Objetivo, Componentes impactados, Diagrama de flujo Mermaid (`flowchart LR` con link `mermaid.ink` para preview), Oportunidades de mejora. Output en `docs/funcional/NNN-export-report-YYYY-MM-DD.md`. Read-only sobre el corpus; sin commits autónomos. Aplica tabla determinista de traducción técnico→ejecutiva y valida cota + léxico vetado post-generación. Invocado sólo vía `/agent-workflow:export-report`. Historial de versiones en CHANGELOG del CLI bundleado."
-version: 1.7.0
----
-
-> **Profile parametrization**: lee `lexicon_path` de `profile.json` (resuelto vía cascade 5 capas). Ver [`references/profile-parametrization.md`](../../references/profile-parametrization.md) para el contrato completo y comportamiento por defecto cuando el profile está vacío.
-
-# Export Report — Informe ejecutivo desde corpus de sesiones + `docs/`
-
-Genera un único `.md` ejecutivo agregando las sesiones cerradas del workspace, para gerencia/jefatura/comité. **Read-only / reporte** — no commitea, no muta nada del corpus.
-
-> Primer comando de la familia `/agent-workflow:export-*` definida en `docs/conclusiones/007-export-commands-family.md`. Spec autoritativa: `docs/especificaciones/001-export-report-format/DELIVERY.md`.
-
-## Excepción session-aware
-
-Este skill requiere conocimiento del lifecycle. **No crea ni modifica sesiones**. Si el workspace no tiene sesiones cerradas en el rango filtrado por `--period`, abortar con `ok: false` y mensaje explícito.
-
-**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 project-md-upsert --read` — `workspace_mode`, fuentes, working branches.
-- `agent-workflow history-data` — lista de sesiones con metadata + filtro temporal.
-- `agent-workflow session-artifacts --code <NNN>` — resumen lazy de OBJECTIVE/TASKS/DECISIONS/CONCLUSIONS (bilingual EN/ES).
-- `agent-workflow objetivo-data --code <NNN>` — tipo, modalidad, criterios, fuentes mencionadas.
-- `agent-workflow decisiones-list --code <NNN>` — DEC-NNN headers + previews.
-- `agent-workflow next-number docs/funcional` — numeración determinística.
-
-## When to use
-
-- "Informe ejecutivo", "documento funcional", "qué se hizo este trimestre para gerencia".
-- Sesiones cerradas a sintetizar para reporting de gestión.
-- Re-generar tras un nuevo período (mes/trimestre).
-- Antes de comité de seguimiento.
-
-## Qué hace este skill
-
-1. Lee corpus (`.workflow/sessions/`) filtrando por `--since`, `--source`, `--period`.
-2. Resuelve variante (A/B/C) por matriz `--audiencia` × `--mode` (default = B).
-3. Carga plantilla `references/template-<variante>.md`.
-4. Detecta condición "Oportunidades de mejora" (V4) escaneando corpus por items abiertos.
-5. Renderiza prosa aplicando `references/lexico.md` (traducción técnico→ejecutiva), incluyendo tabla de Componentes impactados y Diagrama de flujo en B/C (v1.1).
-6. Valida V1-V6 (`references/validations.md`).
-7. Si pasa: escribe `docs/funcional/NNN-export-report-YYYY-MM-DD.md`.
-8. Si falla V1/V3/V4: aborta con error report; no escribe.
-
-## Qué NO hace
-
-- Ejecutar commits, merges ni push (ver `agent-workflow:commits-policy`).
-- Mutar el corpus de sesiones ni artefactos individuales.
-- Enviar correos ni crear PRs.
-- Generar diagramas Mermaid avanzados (`C4Container`, `sequenceDiagram` extenso, `erDiagram`) — esos viven en `export-arq`. El `{{DIAGRAMA_FLUJO}}` aquí es siempre `flowchart LR` (o `graph LR`) simple.
-- Generar diagramas opt-in adicionales en B/C más allá del Diagrama de flujo obligatorio (máx 1 extra a pedido del usuario).
-- Inferir métricas cuantitativas (sección "Métricas" no existe en ninguna variante).
-- Inventar oportunidades de mejora (sólo aparecen si el corpus tiene items abiertos detectables — ver V4).
-
-## Sandbox read-only
-
-`../session/references/sandbox-readonly-rules.md`. En plan mode esta skill describe:
-- Variante resuelta + plantilla a cargar.
-- Sesiones del corpus que entrarían tras filtros.
-- Length estimada + secciones que aparecerían.
-- Hallazgos de V4 (sección Oportunidades de mejora presente/omitida).
-
-NO ejecuta: `Write` del `.md` output, `agent-workflow next-number` con efecto, mutaciones de cualquier tipo.
-
-## Estilo de comunicación
-
-`../session/references/communication-style.md`. Aplica también `agent-workflow:redaccion-simple` con preset "ejecutivo" — más estricto: cota dura, léxico tabla, traducción técnico→ejecutivo obligatoria.
-
-## Entrada
-
-```
-/agent-workflow:export-report [--sessions NNN[,NNN]] [--since sessionNNN] [--source <alias>]
-                 [--period last-quarter|last-month|YYYY-MM..YYYY-MM]
-                 [--audiencia gerencia|jefatura|comite]
-                 [--mode resumen|analisis|draft]
-                 [--dry-run]
-```
-
-Sin flags: usa defaults `--audiencia jefatura --mode analisis` → variante B (760w).
-
-Ejemplo con override explícito: `/agent-workflow:export-report --sessions 055,057 --audiencia jefatura --mode analisis`. `--sessions` toma precedencia sobre `--since` y `--period` (warning si discrepan).
-
-### Matriz `--audiencia` × `--mode`
-
-| × | `resumen` | `analisis` (default) | `draft` |
-|---|---|---|---|
-| `gerencia` | A (400w) | A (400w) | A (400w) |
-| `jefatura` (default) | A (400w) | **B (760w)** | C (1620w) |
-| `comite` | A (400w) | C (1620w) | C (1620w) |
-
-**Conflicto entre flags**: `--mode` gana; warning informativo si discrepa con `--audiencia`.
-
-**Racional de las celdas borde (DEC-003 session079)**: `--mode` modula el peso del informe. Celdas como `comite × resumen → A` o `gerencia × draft → A` colapsan a A por intención compacta — no hay variante B-mini ni C-mini. Si la audiencia comité necesita más profundidad que A, usar default `--mode analisis` → C (1620w). Si gerencia necesita más que A, usar `--mode draft` → A (no escala, por diseño de la matriz).
-
-### Resolución de `--period`
-
-- `last-month` / `last-quarter`: ventana calculada contra fecha actual del sistema (`date +%Y-%m-%d`).
-- `YYYY-MM..YYYY-MM`: rango cerrado entre dos meses (inclusive ambos).
-- Sin `--period`: incluye todas las sesiones cerradas.
-
-### Resolución de `--source` (hub mode)
-
-- Sin flag: agrega corpus de todas las fuentes declaradas en AW-PROJECT.
-- Con alias: limita a una fuente. Útil para reporting por equipo en organizaciones multi-fuente.
-
-## Flujo
-
-### Paso 1 — Resolver contexto
-
-```
-agent-workflow project-md-upsert --read
-```
-
-Extrae `workspace_mode`, `fuentes[]`, `mode` (`hub`/`project`). Determina root del workspace y path destino:
-- `hub` → `<hub>/docs/funcional/NNN-export-report-YYYY-MM-DD.md`.
-- `project` → `<cwd>/docs/funcional/NNN-export-report-YYYY-MM-DD.md`.
-
-### Paso 2 — Filtrar corpus
-
-```
-agent-workflow history-data
-```
-
-Output: lista de sesiones. Aplicar filtros:
-- `--since sessionNNN`: descartar sesiones con `code < NNN`.
-- `--source <alias>`: descartar sesiones que no tocan la fuente.
-- `--period <window>`: descartar sesiones fuera del rango.
-
-Si el conjunto resultante está vacío → **abortar** con:
-```
-{ "ok": false, "error": "No hay sesiones cerradas en el período declarado: <period>" }
-```
-
-### Paso 3 — Resolver variante
-
-Combinar `--audiencia` + `--mode` con la matriz de arriba. Default: `B`. Cargar plantilla:
-
-```
-references/template-<variante>.md
-```
-
-Las 3 plantillas A/B/C existen en `references/template-{a,b,c}.md`. Sin fallback automático — si por algún motivo el archivo no se encuentra, abortar con `ok: false` y mensaje explícito.
-
-### Paso 4 — Recolectar inputs por sesión + componentes
-
-Para cada sesión del corpus filtrado:
-
-```
-agent-workflow session-artifacts --code <CODE>
-agent-workflow objetivo-data --code <CODE>
-agent-workflow decisiones-list --code <CODE>
-```
-
-Materiales relevantes para el render:
-- OBJECTIVE / requisito / brief: qué se planteó.
-- TASKS resumen (counts cerradas vs abiertas): qué se entregó.
-- DECISIONS (DEC-NNN): qué se decidió.
-- CONCLUSIONS (cuando exista): cierre técnico (insumo para Logros + Objetivo).
-- CHECKPOINT (cuando exista): último estado conocido — fuente para "Riesgos / deuda" y "Oportunidades de mejora".
-
-**Componentes impactados (B/C — v1.1)**: para construir la tabla `{{COMPONENTES_IMPACTADOS}}`:
-
-1. **Listado base de componentes**: leer `project-md-upsert --read.fuentes[]`. Cada fuente declarada en el workspace es un candidato a componente. En hub mode, todas las fuentes; en project mode, una sola.
-2. **Filtrar por impacto**: incluir sólo fuentes que aparecen en `objetivo-data.fuentes` o en branches declaradas por al menos 1 sesión del corpus filtrado. Las fuentes sin actividad en el período se omiten.
-3. **Clasificar tipo** (heurística determinista en orden):
-   - Path/alias del componente contiene `front`, `web`, `ui`, `app/src`, `angular`, `react` → **FrontEnd**.
-   - Path/alias contiene `back`, `api`, `service`, `controller`, `spring`, `node-server`, `core` → **BackEnd**.
-   - Path/alias o sesiones asociadas referencian `*.sql`, `esquema`, `migración`, `procedure`, `tabla` predominantemente → **Base de datos**.
-   - Sin match único → derivar del corpus: si DECISIONS/CONCLUSIONS del corpus dominan en endpoints/services → BackEnd; en pantallas/componentes → FrontEnd; en scripts/tablas → Base de datos. Empate → preguntar al usuario antes de inventar.
-4. **Resolver estado** por componente:
-   - Todas las sesiones cerradas con tasks completas + sin items abiertos en CONCLUSIONS → **Completo**.
-   - ≥1 sesión con tasks abiertas, items abiertos en CONCLUSIONS, o sesión `active` en `history-data` → **Cambios pendientes**.
-5. Render: tabla markdown 3 columnas en orden de tipo (FrontEnd → BackEnd → Base de datos) y luego nombre alfabético.
-
-**Diagrama de flujo (B/C — v1.2)**: para construir `{{DIAGRAMA_FLUJO}}`:
-
-1. **Reuso preferente**: si existe `<docs>/arquitectura/NNN-export-arq-*/arquitectura.md` (o equivalente) en el workspace, extraer la idea del diagrama de containers/contexto y traducirla a `flowchart LR` simplificado (3-6 nodos en B; 4-8 en C). NO copiar literal el Mermaid técnico C4Container — esa notación es para `export-arq` (audiencia técnica). Aquí se sintetiza la integración entre los componentes ejecutivos.
-2. **Fallback inferido**: si no hay arquitectura graduada, generar diagrama mínimo a partir de la tabla de Componentes:
-   - `flowchart LR\n  FE[FrontEnd] --> BE[BackEnd] --> BD[(Base de datos)]` para flujos lineales.
-   - Aristas etiquetadas (`FE -- "consulta" --> BE`) cuando DECISIONS lo justifican.
-   - Si hay >1 componente del mismo tipo, separarlos por nombre legible (`FE_PA[Portal Admin]`, `FE_VE[Portal Vendedor]`).
-3. Render: code fence ```` ```mermaid ```` ... ```` ``` ```` (exento de V1). Máx 15 líneas en B, 20 en C. **Default Mermaid** (DEC-002 session077; audiencia ejecutiva consume mejor el render visual del viewer); ASCII en plain code fence permanece como **fallback opt-in** cuando Mermaid no aporta claridad (1-2 nodos triviales o flujo no representable como grafo).
-
-### Paso 5 — Detectar condición de "Oportunidades de mejora" (V4)
-
-Recolectar de cada sesión filtrada:
-- Items en `## Open (gaps)` de CONCLUSIONS.md.
-- Items en `## Recommendations` / `## Recomendaciones` de CONCLUSIONS.md.
-- Decisions marcadas como "pendiente" / "diferido" en DECISIONS.md.
-- Menciones a "próximos pasos" / "futuras mejoras" / "oportunidades" en CHECKPOINT.md.
-
-Si `count > 0` → incluir sección "Oportunidades de mejora" en el render. Si `count == 0` → **omitir sección completa** (sin encabezado, sin placeholder). Nunca inventar.
-
-### Paso 6 — Renderizar prosa
-
-Llenar la plantilla aplicando:
-
-1. **Léxico técnico→ejecutivo** (ver `references/lexico.md`): cada placeholder recibe prosa sin acrónimos sin glosar, sin nombres internos, con verbos directos. La tabla de Componentes impactados también aplica léxico: tipo se escribe como "BackEnd"/"FrontEnd"/"Base de datos" (no "BE"/"FE"/"DB"), estado como "Completo"/"Cambios pendientes" (no "OK"/"WIP").
-2. **Agrupación por capacidad** (no por sesión): los Logros se agrupan en 4-8 capacidades de negocio, no listan sesiones individuales.
-3. **Cota dura por sección**: respetar `±15%` por sección (`±10%` total).
-4. **`agent-workflow:redaccion-simple` preset ejecutivo**: frases cortas, listas sobre prosa, una idea por línea, sin relleno.
-5. **Componentes impactados (v1.1)**: tabla 3 columnas en B (3-7 filas) o C (4-10 filas). Una fila por componente con tipo + estado determinados en Paso 4.
-6. **Diagrama de flujo (v1.2)**: bloque ```` ```mermaid ```` en B/C por default — `flowchart LR` con 3-6 nodos en B, 4-8 en C. Aristas etiquetadas cuando aporten contexto ejecutivo. Si Paso 4 extrajo el diagrama desde `docs/arquitectura/`, sintetizarlo (no copiar literal el C4Container técnico) y citar el origen como nota inline al final del fence. ASCII en plain code fence es fallback opt-in cuando Mermaid no aporta claridad.
-7. **Link de visualización (v1.3 — session078)**: cuando el fence sea ```` ```mermaid ````, inmediatamente después del fence de cierre, agregar una línea en blanco + blockquote con el link al render PNG: `> Ver diagrama renderizado: <https://mermaid.ink/img/BASE64>`. El BASE64 es el código Mermaid plano codificado en base64 URL-safe (RFC 4648 §5; alfabeto `A-Z a-z 0-9 - _`). El ASCII fallback (plain code fence) NO lleva link. Texto fijo "Ver diagrama renderizado" en español ejecutivo. NUNCA usar `mermaid.live/edit` (descartado por DEC-001).
-
-### Paso 7 — Validar (V1-V6)
-
-Aplicar checks de `references/validations.md`:
-- V1 cota de palabras por variante (warning ±10%, hard fail ±20%).
-- V2 léxico vetado: grep determinístico, 0 ocurrencias en cuerpo (Referencias exentas).
-- V3 secciones obligatorias presentes en orden.
-- V4 Oportunidades de mejora honored (presente si corpus lo justifica; omitida si no).
-- V5 header bien formado (placeholders reemplazados).
-- V6 referencias resolubles (paths a `docs/...` existen en filesystem).
-
-Si V1, V3 o V4 fallan → abortar con error report estructurado. Si V2, V5 o V6 fallan → warning + opción de continuar (decisión del host AI con confirmación del usuario).
-
-### Paso 8 — Escribir output
-
-Si `--dry-run`: imprimir reporte (count palabras estimado, secciones que aparecerían, V4 outcome). No escribir.
-
-Si no dry-run y validations pasan:
-```
-agent-workflow next-number docs/funcional
-```
-
-Escribir `docs/funcional/NNN-export-report-YYYY-MM-DD.md` con el render final. La fecha es la del sistema al momento de escritura.
-
-### Paso 9 — Resumen al usuario
-
-- Ruta del archivo.
-- Variante usada (A/B/C).
-- Conteo final de palabras (vs cota).
-- Sesiones cubiertas (count + rango temporal).
-- Si V4 omitió Oportunidades de mejora: nota explícita.
-- Si V3 detectó `engine: ascii (fallback)` en Diagrama de flujo: nota explícita (sin warning de link, porque ASCII no lo lleva).
-- Si V3 detectó Mermaid sin link mermaid.ink: warning explícito (v1.3 espera link debajo del fence).
-- Warnings emitidos (V2/V5/V6).
-
-## Composición con otras skills
-
-- **`agent-workflow:redaccion-simple`** — preset ejecutivo aplicado durante el render (paso 6).
-- **`agent-workflow:rules`** — anchors transversales (sandbox-readonly, commits-policy) consultables on-demand.
-- **`session`** — este skill NO invoca graduación ni cierre. La sesión activa puede consumirlo durante validation o closure para producir un snapshot ejecutivo.
-
-## Re-ejecución
-
-Idempotente funcional: cada invocación toma siguiente NNN. No sobrescribe outputs previos.
-
-Para regenerar el último output: borrar el archivo manualmente y re-invocar (decisión consciente del usuario; el skill no fuerza overwrites).
-
-## Recursos adicionales
-
-- **`references/template-b.md`** — plantilla canónica Variante B (default).
-- **`references/template-a.md`** — plantilla compacta Variante A (rebalance de pesos v1.4: 90w Resumen + 120w Cambios + 70w Riesgos + 60w Op cond + ~100w Refs).
-- **`references/template-c.md`** — plantilla extensa Variante C (tolerancia condicional V1 v1.4: ventana 1323-1617w cuando Op omitida).
-- **`references/lexico.md`** — tabla determinista técnico→ejecutivo + lista vetada para V2.
-- **`references/validations.md`** — V1-V6 detalladas con condiciones de hard-fail.
-- **`docs/especificaciones/001-export-report-format/DELIVERY.md`** — spec autoritativa de la familia (session056).
-- **`docs/conclusiones/007-export-commands-family.md`** — Propuesta original de la familia `/agent-workflow:export-*` (session055).

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

@@ -1,174 +0,0 @@
-# Léxico ejecutivo — traducción técnico → ejecutivo
-
-Tabla determinista que el skill `export-report` aplica durante el render (Paso 6) y validador V2 usa para detectar léxico vetado en el cuerpo del output.
-
-> Excepción: la sección `## Referencias` está **fuera del scope** de V2 (los paths a `docs/<categoria>/` son ineludibles en esa sección).
-
-## Tabla de traducción
-
-| Técnico (corpus) | Ejecutivo (output) |
-|---|---|
-| commit · commits | "cambio aplicado" · "incorporación" · "publicación" |
-| merge · merges | "integración" · "unión de trabajos" |
-| pull request · PR · PRs | "revisión de cambios" · "propuesta de cambio" |
-| sesión · session · sessions · sessionNNN · session<NNN> | "ciclo de trabajo" · "iteración" |
-| flow=dev · flow=analyze · flow=design | "trabajo de implementación" · "análisis" · "diseño" |
-| skill · skills · SKILL.md | "componente del sistema" · "automatización" |
-| hook · hooks · PreToolUse · PostToolUse | "validación automática" · "control automático" |
-| MCP · <mcp-cert> · <mcp-prod> · MCP server | "consulta de datos" · "fuente de datos del sistema" |
-| CLI · agent-workflow CLI · línea de comandos | "línea de comandos del equipo" · "interfaz de comandos" |
-| `agent-workflow:rules` | "reglas comunes" |
-| post-mortem · postmortem | "análisis retrospectivo" |
-| Phase 0 · Phase 1 · Phase 2 · scaffolding · stub | "preparación inicial" · "diseño previo" · "esqueleto base" |
-| graduación · graduate · graduado | "publicación final" · "publicado" |
-| hub mode · hub workspace · workspace hub | "área de trabajo común" · "espacio de coordinación" |
-| Strangler Fig · opt-in · opt-out | (omitir; usar "migración progresiva" / "activación opcional") |
-| harness · runtime · runtime agent-workflow | "entorno de trabajo del equipo" · "sistema" |
-| agent-workflow · agent-workflow:rules · agent-workflow:session · agent-workflow:commits-policy · `/agent-workflow:*` | (omitir; usar "el sistema" · "las reglas comunes" · "el ciclo de trabajo") |
-| Codex · Claude Code · Warp · Oz | "herramientas del equipo" (genérico) salvo que el contexto justifique nombrarlas |
-| DEC-NNN | "decisión documentada N°NNN" · "una decisión" |
-| TUI · CLI · TTY | "interfaz textual" · "interfaz de línea de comandos" |
-| stack · stack técnico | "tecnologías utilizadas" (sin enumerar a menos que sea breve y relevante) |
-| repositorio · repo · repos | "componente del sistema" · "área del sistema" |
-| rama · branch · feature/* | "línea de trabajo" (raramente necesario en ejecutivo) |
-| handoff | "pasaje de trabajo" · "entrega entre fases" |
-| design system · DS · tokens | "sistema visual común" (raramente necesario) |
-| backlog | "lista de pendientes" |
-| feature flag | "interruptor de funcionalidad" |
-| deployment · deploy · staging · prod | "puesta en producción" · "ambiente de prueba" · "producción" |
-| log · logs · logging | "registro de actividad" |
-| dashboard · panel | "panel de control" |
-| api · endpoint · REST | "punto de integración" · "interfaz con otros sistemas" |
-| backend · frontend | "componente del servidor" · "componente del usuario" |
-| stack trace · stacktrace | "detalle técnico del error" |
-| migration · migración SQL · DDL | "ajuste estructural de datos" |
-| rollback | "reversa del cambio" |
-| issue · ticket · JIRA-XXX | "punto pendiente" (sin números de ticket) |
-| OKR · KPI | (omitir salvo que el cliente los use explícitamente) |
-
-## Ejemplos antes / después
-
-### Ejemplo 1 — Resumen ejecutivo
-
-**Antes (técnico)**:
-> El runtime agent-workflow incorporó un nuevo hook PreToolUse que valida el branch antes de cada Edit/Write. Se migraron 36 sesiones legacy al formato canónico y se retiró el M9 contract-review en favor del DESIGN.md + S7 gate.
-
-**Después (ejecutivo)**:
-> El sistema incorporó controles automáticos que validan la línea de trabajo activa antes de cada cambio. Se completó la migración de ciclos de trabajo antiguos al formato común y se reemplazó la revisión técnica intermedia por una revisión de diseño previa.
-
-### Ejemplo 2 — Logros
-
-**Antes**:
-> - Implementado /agent-workflow:export-scripts merge de release + release-scripts.
-> - Hook sql-mutation-guard wired-up en hooks.json.
-> - Phase 0-5 phased model adoptado en TASKS.md para `## Type: feature`.
-
-**Después**:
-> - Comando único de exportación de cambios técnicos disponible (consolida exportaciones previas).
-> - Controles automáticos contra mutaciones no autorizadas en bases de datos.
-> - Estructura por fases adoptada para las implementaciones nuevas (preparación → ejecución → validación).
-
-### Ejemplo 3 — Recomendaciones
-
-**Antes**:
-> - R1: Instrumentar telemetría de adopción con OpenTelemetry traces (responsable: equipo runtime, Q3-2026).
-> - R2: Deprecar /agent-workflow:release con alias durante 1 release cycle.
-
-**Después**:
-> - Próximo trimestre: instrumentar indicadores de adopción y uso real del sistema (responsable: equipo runtime).
-> - Próximo trimestre: deprecar el comando antiguo de release manteniendo alias durante un ciclo, para permitir transición sin disrupciones.
-
-## Lista vetada (V2 — para grep determinista)
-
-Términos que **no deben aparecer** en el cuerpo del output (excepto en `## Referencias`). El validador V2 corre `grep -i -E -w` contra esta lista:
-
-```
-commit
-commits
-merge
-push
-pull
-PR
-PRs
-sesión
-sessions
-sessionXXX
-sessionNNN
-flow=dev
-flow=analyze
-flow=design
-skill
-skills
-SKILL.md
-hook
-hooks
-PreToolUse
-PostToolUse
-MCP
-<mcp-cert>
-<mcp-prod>
-CLI
-agent-workflow
-agent-workflow:rules
-agent-workflow:session
-agent-workflow:commits-policy
-agent-workflow
-agent-workflow:
-/agent-workflow:
-postmortem
-post-mortem
-Phase 0
-Phase 1
-Phase 2
-Phase 3
-Phase 4
-Phase 5
-scaffolding
-stub
-graduación
-graduate
-hub mode
-hub workspace
-Strangler Fig
-opt-in
-opt-out
-harness
-runtime agent-workflow
-Codex
-Claude Code
-Warp
-Oz
-DEC-NNN
-TUI
-TTY
-backlog
-deploy
-staging
-endpoint
-REST
-stack trace
-stacktrace
-DDL
-rollback
-JIRA
-JIRA-
-OKR
-KPI
-```
-
-> Nota: los términos "sesión" / "sesiones" sin sufijo numérico están vetados porque la versión exec es "ciclo de trabajo". Para mantener "sesión" en frases naturales (`N sesiones trabajadas` en el header), V2 excluye el patrón fijo `\bN sesiones trabajadas\b` del scope del grep (la única excepción autorizada).
-
-## Reglas adicionales de léxico
-
-Heredan de `agent-workflow:redaccion-simple` + preset ejecutivo. Resumen:
-
-- **Frases cortas**: ≤15 palabras. Partir si supera 20.
-- **Listas sobre prosa**: 3+ ideas paralelas → bullets.
-- **Una idea por línea**: si el bullet usa "y" o ";" → separar.
-- **"Qué + por qué" en una línea**: `<qué>: <por qué corto>`.
-- **Sin jerga ni abreviaturas raras**: palabras comunes; términos técnicos validados OK; abreviaturas inventadas no.
-- **Sin relleno**: cero "es importante notar que…", "cabe destacar…", "como se mencionó…".
-- **Voz activa**: "el sistema incorporó X" mejor que "fue incorporado X por el sistema".
-- **Verbos directos**: "validar" mejor que "realizar la validación de".
-- **Números siempre con unidad o contexto**: "55 ciclos de trabajo en 10 días", no "55".
-- **Glosa primera vez**: si un acrónimo SE permite (ej. SLA), glosarlo la primera vez: "acuerdo de nivel de servicio (SLA)".