@tacuchi/agent-workflow-cli 6.1.0 → 7.0.0

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

@@ -0,0 +1,97 @@
+# Léxico técnico — limpieza mínima de noise para export-tech-manuals
+
+A diferencia de `export-report/references/lexico.md` (que traduce técnico→ejecutivo para audiencia gerencial), este léxico es **mínimo**: la audiencia de `export-tech-manuals` es técnica (operadores/soporte/onboarding) y los términos técnicos son bienvenidos.
+
+Mismo patrón que `export-arq/references/lexico-tecnico.md`: vetar sólo el "noise" interno.
+
+## Lista vetada (V2 — para grep determinista)
+
+Términos / patrones que **no deben aparecer** en el cuerpo del output (excepto en `## Referencias`):
+
+```
+{{
+}}
+<-- TODO
+<-- FIXME
+<-- WIP
+<-- XXX
+{{PRODUCTO}}
+{{FECHA
+{{TITULO
+{{SESIONES
+{{PROPOSITO
+{{PREREQUISITOS
+{{PASO_
+{{PASOS_
+{{VALIDACION
+{{TROUBLESHOOTING
+{{REFERENCIAS
+{{N_MANUALES
+{{N_TEMAS
+{{TABLA_
+{{PROXIMOS_PASOS
+sessionXXX
+sessionYYY
+sessionNNN
+DEC-NNN
+NNN-export-tech-manuals
+YYYY-MM-DD
+/Users/
+~/Git/
+TODO:
+FIXME:
+WIP:
+XXX:
+HACK:
+```
+
+**Qué busca esta lista**:
+- **Placeholders no reemplazados** (`{{...}}`): indica fallo del render.
+- **Fragmentos de plantilla** (`<-- TODO`, etc.): noise residual del template.
+- **Paths absolutos del developer** (`/Users/`, `~/Git/`): filtran info local.
+- **Markers WIP** (TODO/FIXME/HACK con dos puntos): incompletos sin terminar.
+
+**Excepciones autorizadas** (V2 las exime):
+- Sección `## Referencias` puede contener placeholders esperados (ej. `NNN-` en paths tipo).
+- Header del documento puede contener identificadores del producto canónicos.
+- Sección `## Troubleshooting` puede mencionar errores que contienen jerga técnica del dominio (ej. mensaje literal del sistema).
+
+## Cómo validar
+
+```bash
+awk '
+  BEGIN { body=0 }
+  /^## Referencias/ { body=0 }
+  body { print }
+  /^## / && !/Referencias/ { body=1 }
+' output.md > /tmp/body.md
+
+grep -n -F -f lexico-noise-vetado.txt /tmp/body.md
+```
+
+Salida vacía → V2 pasa. Salida con matches → V2 falla.
+
+## Reglas adicionales de redacción
+
+Aplicables al render de cada manual o del INDEX. Heredan de `agent-workflow:redaccion-simple` preset default:
+
+- **Frases cortas**: ≤20 palabras.
+- **Listas sobre prosa**: 3+ items paralelos → bullets.
+- **Una idea por línea en bullets**.
+- **Verbos directos**: "Ejecutar" mejor que "Se procede a ejecutar".
+- **Sin pasos compuestos**: una acción por paso numerado.
+- **Términos técnicos OK**: del dominio (`agent-workflow`, `MCP`, `hook`, `kind`, `session`) están autorizados.
+- **Acrónimos**: glosarlos la primera vez si no son del dominio universal del lector técnico operativo.
+- **Sin nombres del developer** (ni paths absolutos, ni emails, ni handles).
+- **Códigos / comandos en backticks**: `agent-workflow session-create` siempre con backticks; no en prosa cursiva.
+
+## Diferencias con los lexicos hermanos
+
+| Aspecto | `export-tech-manuals/lexico-tecnico.md` | `export-arq/lexico-tecnico.md` | `export-report/lexico.md` |
+|---|---|---|---|
+| Foco | Limpieza noise + render checks | Limpieza noise + render checks | Traducción técnica → ejecutiva |
+| Tamaño | ~30 términos vetados | ~25 términos vetados | ~75 términos vetados |
+| Audiencia | operadores/soporte/onboarding | devs/arquitectos | gerencia/jefatura/comité |
+| Tabla de traducción | ninguna | ninguna | ~45 pares |
+| Términos técnicos del dominio | autorizados | autorizados | vetados (a traducir) |
+| Grep mode | `-F -f` case-sensitive | `-F -f` case-sensitive | `-i -F -f` case-insensitive |

package/skills/agent-workflow/exports/export-tech-manuals/references/template-index.md

@@ -0,0 +1,123 @@
+# Plantilla canónica — INDEX.md (modo `complementar`)
+
+Plantilla para el archivo único `docs/manuales/INDEX.md` que el skill sobrescribe en modo `complementar`. Es re-generable, sin numeración NNN — siempre vive en el mismo path.
+
+---
+
+```markdown
+# Manuales técnicos — {{PRODUCTO}}
+
+Índice consolidado actualizado al {{FECHA_GENERACION}}.
+Total: {{N_MANUALES_GRADUADOS}} manuales graduados · {{N_TEMAS_NO_GRADUADOS}} temas sin graduar detectables.
+
+## Manuales graduados
+
+<!-- Tabla de manuales graduados (`kind=manual`) presentes en docs/manuales/NNN-*.md.
+     Una fila por manual. Columna "Sesiones de origen" si el manual está vinculado
+     a sesiones específicas (extraído de YAML frontmatter o primer párrafo). -->
+
+| Slug | Manual | Sesiones de origen |
+|---|---|---|
+{{TABLA_MANUALES_GRADUADOS}}
+
+## Temas sin graduar detectables
+
+<!-- Tabla de temas con potencial de ser manuales pero aún no graduados.
+     Detección por `## Topics`/`## Temas` en OBJECTIVE.md del corpus + heurística por
+     keywords operativos. Confidence: alta (declarado) / media (inferido). -->
+
+| Tema | Slug | Sesiones de origen | Confidence |
+|---|---|---|---|
+{{TABLA_TEMAS_NO_GRADUADOS}}
+
+## Próximos pasos sugeridos
+
+<!-- Sólo aparece si hay ≥1 tema no graduado. Lista de bullets con sugerencias para
+     materializar los temas en manuales formales graduados. -->
+
+{{PROXIMOS_PASOS_OR_OMIT}}
+
+## Cómo refrescar este índice
+
+Este archivo se re-genera ejecutando:
+
+```
+/agent-workflow:export-tech-manuals
+```
+
+(modo `complementar` es el default). El comando sobrescribe `INDEX.md` con el estado actual del workspace; no requiere borrar manualmente. Cada invocación es idempotente sobre el mismo corpus.
+
+Para producir un dossier consolidado de manuales (paquete onboarding, por ej):
+
+```
+/agent-workflow:export-tech-manuals --mode regenerar
+```
+
+Esto crea un dossier dentro de `docs/manuales/` con número secuencial y fecha en el nombre, conteniendo un manual por tema detectado.
+```
+
+---
+
+## Placeholders detallados
+
+### `{{PRODUCTO}}`
+
+Nombre del workspace/producto. Mismo patrón que en `template-c4.md` de export-arq.
+
+### `{{FECHA_GENERACION}}`
+
+Formato natural ES: `18 de mayo de 2026`.
+
+### `{{N_MANUALES_GRADUADOS}}`
+
+Count de archivos `docs/manuales/NNN-*.md` (excluyendo `INDEX.md` y dossiers `NNN-export-tech-manuals-*/`).
+
+### `{{N_TEMAS_NO_GRADUADOS}}`
+
+Count de temas detectables del corpus que no tienen un manual graduado correspondiente.
+
+### `{{TABLA_MANUALES_GRADUADOS}}`
+
+Filas con:
+- Slug (extraído del filename `NNN-<slug>.md`).
+- Manual (link al path, ej. `[Configurar MCP](007-configurar-mcp.md)`).
+- Sesiones de origen (lista coma-separada, si extraíble del manual).
+
+Si 0 manuales graduados:
+```
+| _Sin manuales graduados en este workspace todavía._ | — | — |
+```
+
+Una sola fila informativa, no múltiples.
+
+### `{{TABLA_TEMAS_NO_GRADUADOS}}`
+
+Filas con:
+- Tema (descripción humana corta).
+- Slug (kebab-case).
+- Sesiones de origen.
+- Confidence: `alta` (declarado en `## Topics`/`## Temas`) o `media` (inferido por keywords).
+
+Si 0 temas detectables: omitir la sección entera (no aparece encabezado vacío).
+
+### `{{PROXIMOS_PASOS_OR_OMIT}}`
+
+**A. Si N_TEMAS_NO_GRADUADOS > 0** → bullets:
+
+```
+- Crear sesión dev `flow=dev` para materializar el tema "{{tema_1}}" como manual graduado.
+- Crear sesión dev para "{{tema_2}}".
+- (...)
+- Para cada manual nuevo: `agent-workflow graduate --kind manual --session <CODE> --slug <kebab>`.
+- Tras graduar: re-correr `/agent-workflow:export-tech-manuals` para actualizar este índice.
+```
+
+**B. Si N_TEMAS_NO_GRADUADOS == 0** → cadena vacía. La sección no aparece.
+
+## Reglas de render
+
+1. **Idempotente conceptual**: misma invocación sobre mismo corpus produce mismo `INDEX.md`.
+2. **Sin numeración NNN para INDEX**: el INDEX vive en `docs/manuales/INDEX.md` siempre, sobrescribible.
+3. **Cero placeholders sin reemplazar**: V2 grep determinístico atrapa fallas del render.
+4. **Tablas vacías → fila informativa, no eliminadas**: comunica al lector que la sección fue evaluada.
+5. **Sección "Próximos pasos" condicional**: V4 honored; ausencia significa "no hay nada que sugerir".

package/skills/agent-workflow/exports/export-tech-manuals/references/template-manual.md

@@ -0,0 +1,143 @@
+# Plantilla canónica — Manual técnico (modo `regenerar`)
+
+Plantilla para un manual técnico individual. Cada archivo del dossier `docs/manuales/NNN-export-tech-manuals-YYYY-MM-DD/` sigue esta estructura.
+
+**Audiencia**: operadores / soporte / nuevos miembros del equipo que necesitan ejecutar la tarea descrita sin invocar al equipo de desarrollo.
+
+---
+
+```markdown
+# {{TITULO_MANUAL}}
+
+> Manual técnico generado desde {{SESIONES_ORIGEN}} el {{FECHA_GENERACION}}.
+> Audiencia: operadores / soporte / onboarding.
+
+## Propósito
+
+<!-- 1-2 oraciones. Qué problema operativo resuelve este manual. -->
+
+{{PROPOSITO}}
+
+## Pre-requisitos
+
+<!-- Bullets cortos. Conocimientos previos, accesos requeridos, herramientas instaladas. -->
+
+{{PREREQUISITOS}}
+
+## Pasos
+
+<!-- Numeración secuencial. Cada paso ≤2 frases. Si un paso requiere validar algo,
+     incluir la verificación inline ("ejecutar X; confirmar que retorna Y"). -->
+
+1. {{PASO_1}}
+2. {{PASO_2}}
+3. {{PASO_3}}
+{{PASOS_RESTO}}
+
+## Validación post-uso
+
+<!-- Cómo el operador confirma que el procedimiento se completó correctamente.
+     Bullets con resultados esperados verificables. -->
+
+{{VALIDACION}}
+
+## Troubleshooting
+
+<!-- Errores típicos + cómo resolverlos. Tabla o bullets. Si no se identifican
+     errores típicos, escribir "Sin errores típicos identificados al momento de
+     generar este manual." -->
+
+{{TROUBLESHOOTING}}
+
+## Referencias
+
+<!-- Links a sesiones de origen, decisiones relacionadas, documentación adicional. -->
+
+{{REFERENCIAS}}
+```
+
+---
+
+## Placeholders detallados
+
+### `{{TITULO_MANUAL}}`
+
+Título descriptivo en oración (no en infinitivo de comando). Ejemplos:
+- "Configurar un servidor MCP de consulta a base de datos"
+- "Crear y cerrar una sesión qtc-* desde cero"
+- "Migrar sesiones legacy al formato común"
+
+### `{{SESIONES_ORIGEN}}`
+
+Lista coma-separada de las sesiones del corpus que aportaron contenido al manual.
+
+Ejemplo: `session031-analyze-revisar-mcp-bd, session032-dev-configurar-mcp-manual, session033-dev-fix-mcp-claude-target`
+
+### `{{FECHA_GENERACION}}`
+
+Fecha en formato natural ES: `18 de mayo de 2026`.
+
+### `{{PROPOSITO}}` (1-2 oraciones)
+
+Qué problema operativo resuelve. Sin marketing. Verbos directos.
+
+### `{{PREREQUISITOS}}` (bullets cortos)
+
+- Conocimientos previos asumidos (ej. "Familiaridad con línea de comandos").
+- Accesos requeridos (ej. "Cuenta en npm registry para publicar el CLI").
+- Herramientas instaladas (ej. "Node.js ≥ 18, git ≥ 2.20").
+- Configuración previa necesaria.
+
+### `{{PASOS}}` (numerados)
+
+Secuencia operativa concreta. Cada paso ejecutable y verificable. Evitar pasos compuestos ("hacer A y B"); separarlos.
+
+Formato sugerido:
+```
+1. **Ejecutar comando X**: `agent-workflow session-create --flow dev --name foo`. Verificar que retorna `ok: true`.
+2. **Abrir archivo Y**: `.workflow/sessions/sessionNNN-dev-foo/OBJECTIVE.md` aparece con headers EN canon.
+```
+
+### `{{VALIDACION}}` (bullets)
+
+Resultados verificables que confirman éxito.
+
+```
+- El comando devolvió código de salida 0.
+- El archivo X existe en el path Y.
+- La consulta Z retorna N filas (donde N matchea el conteo previo).
+```
+
+### `{{TROUBLESHOOTING}}` (tabla o bullets)
+
+Tabla preferida cuando hay 3+ errores típicos:
+
+```
+| Error | Causa probable | Resolución |
+|---|---|---|
+| "ENOENT: no such file" | Sesión no creada | Ejecutar paso 1 primero |
+| "branch mismatch" | Rama incorrecta | `git checkout feature/last` |
+```
+
+Si no se identifican: `_Sin errores típicos identificados al momento de generar este manual._`
+
+### `{{REFERENCIAS}}`
+
+Bullets con paths/links:
+
+```
+- Sesión origen: `.workflow/sessions/session031-analyze-revisar-mcp-bd/CONCLUSIONS.md`
+- Decisiones: `.workflow/sessions/session032-dev-configurar-mcp-manual/DECISIONS.md`
+- Propuesta relevante: `docs/conclusiones/004-audit-test.md`
+- Comando del CLI: `agent-workflow mcp configure`
+```
+
+## Reglas de render
+
+1. **Audiencia operativa**: cada paso debe ser ejecutable por alguien que NO participó en el desarrollo. Sin "obvio", "trivial", "como se sabe".
+2. **Léxico técnico OK**: términos del dominio (`agent-workflow`, `session`, `MCP`, `hook`) están autorizados. Los acrónimos no obvios sí glosarse la primera vez.
+3. **Verbos directos**: "Ejecutar X", "Verificar Y", "Crear Z". No infinitivos perifrásticos ("Se debe ejecutar X").
+4. **Sin pasos compuestos**: una acción por paso. Si la tarea es "A y B", separar en pasos.
+5. **Validación inline cuando posible**: cada paso que produce un side-effect debe declarar cómo verificarlo, además de la sección §Validación.
+6. **Sin diagramas obligatorios**: si un flow es complejo, opt-in a un Mermaid `flowchart` simple. Default: cero diagramas.
+7. **Sin cota dura de palabras**: la longitud la dicta el tema. Manuales de 200w (configuración simple) y de 1500w (procedimiento multi-paso) son ambos válidos.

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

@@ -0,0 +1,211 @@
+# Validations — V1-V6 para `/agent-workflow:export-tech-manuals`
+
+Checks post-render que se aplican antes de escribir output al filesystem. Reglas adaptadas a los **2 modos** del comando (`complementar` y `regenerar`).
+
+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.
+
+## V1 — Estructura por modo
+
+**Severidad**: hard-fail si faltan secciones obligatorias del modo activo.
+
+**Modo `complementar`** (output = `INDEX.md`):
+Secciones obligatorias en orden:
+1. `# Manuales técnicos — <PRODUCTO>` (header con título)
+2. `## Manuales graduados`
+3. `## Temas sin graduar detectables` (condicional — V4)
+4. `## Próximos pasos sugeridos` (condicional — V4)
+5. `## Cómo refrescar este índice`
+
+**Modo `regenerar`** (output = N archivos en dossier):
+Cada archivo `.md` del dossier debe tener:
+1. `# <TITULO_MANUAL>` (header)
+2. `## Propósito`
+3. `## Pre-requisitos`
+4. `## Pasos`
+5. `## Validación post-uso`
+6. `## Troubleshooting`
+7. `## Referencias`
+
+Adicionalmente, el dossier debe tener un `README.md` con índice de los manuales generados.
+
+**Error report (hard-fail)**:
+```
+V1 FAILED: estructura inválida
+  modo: regenerar
+  archivo: 01-configurar-mcp.md
+  esperado: Propósito, Pre-requisitos, Pasos, Validación post-uso, Troubleshooting, Referencias
+  encontrado: Propósito, Pre-requisitos, Pasos, Referencias
+  faltantes: Validación post-uso, Troubleshooting
+  acción: regenerar el manual incluyendo las secciones faltantes
+```
+
+## V2 — Noise vetado
+
+**Severidad**: hard-fail si hay ≥1 ocurrencia en el cuerpo (header y `## Referencias` exentos).
+
+**Scope**: body-only (después del primer `## ` y antes de `## Referencias`).
+
+**Lista vetada**: ver `lexico-tecnico.md` §"Lista vetada".
+
+**Cómo validar**:
+```bash
+awk '
+  BEGIN { body=0 }
+  /^## Referencias/ { body=0 }
+  body { print }
+  /^## / && !/Referencias/ { body=1 }
+' output.md > /tmp/body.md
+grep -n -F -f lexico-noise-vetado.txt /tmp/body.md
+```
+
+**Error report (hard-fail)**:
+```
+V2 FAILED: noise vetado detectado
+  archivo: 02-crear-sesion.md
+  ocurrencias:
+    línea 12: "{{PASO_1}}"       → placeholder sin reemplazar
+    línea 19: "/Users/tacuchi/"  → path absoluto del developer
+    línea 28: "TODO:"            → marker WIP no resuelto
+  total: 3 ocurrencias
+  acción: completar render y stripear paths absolutos
+```
+
+## V3 — Secciones de `template-manual.md` (sólo modo regenerar)
+
+**Severidad**: hard-fail si un archivo del dossier no tiene las 6 secciones obligatorias del template-manual.
+
+**No aplica en modo complementar** (V1 ya cubre las secciones del INDEX).
+
+**Cómo validar**: por cada archivo `.md` del dossier (excluyendo `README.md`), extraer `^## ` headers; verificar Propósito + Pre-requisitos + Pasos + Validación post-uso + Troubleshooting + Referencias presentes.
+
+**Error report**:
+```
+V3 FAILED: archivo del dossier sin secciones obligatorias
+  archivo: docs/manuales/NNN-export-tech-manuals-YYYY-MM-DD/01-configurar-mcp.md
+  faltantes: ## Validación post-uso, ## Troubleshooting
+  acción: regenerar el manual
+```
+
+## V4 — Condicionales por modo
+
+**Severidad**: hard-fail si no se honra la condición.
+
+### V4.a — Modo complementar + 0 manuales graduados
+
+- **Comportamiento esperado**: tabla "Manuales graduados" presente con una fila informativa `_Sin manuales graduados en este workspace todavía._`. No fila vacía, no encabezado solo.
+- **Comportamiento esperado para "Temas sin graduar"**: si 0 temas detectables → omitir la sección completa.
+- **Comportamiento esperado para "Próximos pasos"**: omitido si 0 temas no graduados.
+
+### V4.b — Modo regenerar + 0 temas detectables
+
+- **Comportamiento esperado**: abortar con `ok: false`. No producir dossier vacío.
+- **Error report**:
+```
+V4.b FAILED: modo regenerar sin temas detectables
+  filtros aplicados: --temas <ninguno>, --source <ninguno>, --since <ninguno>
+  corpus: 12 sesiones cerradas
+  temas detectados: 0
+  acción: ajustar filtros o pasar `--temas slug1` explícito; o pasar a modo `complementar` para reflejar el estado vacío
+```
+
+### V4.c — Modo regenerar + dossier con ≥1 manual
+
+- **Comportamiento esperado**: el dossier `NNN-export-tech-manuals-YYYY-MM-DD/` contiene un `README.md` + ≥1 archivo `.md` adicional (un manual). Si solo hay README → fail.
+
+## V5 — Header bien formado
+
+**Severidad**: warning.
+
+**Checks**:
+- Modo `complementar`: línea 1 contiene `# Manuales técnicos — <PRODUCTO>` con producto resuelto.
+- Modo `regenerar`: cada archivo del dossier tiene línea 1 con `# <TITULO_MANUAL>` (no literal `{{TITULO_MANUAL}}`).
+
+**Error report (warning)**:
+```
+V5 WARNING: header de un manual incompleto
+  archivo: 03-migrar-legacy.md
+  línea 1: "# {{TITULO_MANUAL}}"
+  acción sugerida: completar el placeholder
+```
+
+## V6 — Referencias resolubles
+
+**Severidad**: warning.
+
+**Checks**: cada link en `## Referencias` de cada manual / del INDEX apunta a un path existente.
+
+**Cómo validar**:
+```bash
+grep -oE '`[^`]+\.md`|`[^`]+\.json`|`docs/[^`]+`' output.md | tr -d '`' | \
+  while read p; do
+    if [ ! -e "$p" ]; then echo "MISSING: $p"; fi
+  done
+```
+
+**Error report (warning)**:
+```
+V6 WARNING: 1 referencia apunta a path inexistente
+  archivo: 01-configurar-mcp.md
+  - docs/conclusiones/004-audit-test.md → no existe en filesystem
+  acción sugerida: revisar el link o eliminar la referencia
+```
+
+## Orden de aplicación
+
+1. V1 (estructura) — primero, barato.
+2. V2 (noise) — segundo, barato.
+3. V3 (secciones de template-manual, sólo regenerar) — tercero.
+4. V4 (condicionales) — cuarto.
+5. V5 (header) — quinto.
+6. V6 (referencias resolubles) — último.
+
+Si V1, V3 o V4 fallan → abortar inmediatamente.
+Si V2 falla → abortar.
+Si V5 o V6 emiten warning → pedir confirmación al usuario.
+
+## Reporte consolidado
+
+```json
+{
+  "ok": true | false,
+  "mode": "complementar" | "regenerar",
+  "output_paths": ["docs/manuales/INDEX.md"]  // o ["docs/manuales/NNN-.../README.md", "...01-...md", ...]
+  "manuales_graduados_count": 3,
+  "temas_no_graduados_count": 5,
+  "manuales_generados_count": 0,  // sólo aplica a regenerar
+  "validations": {
+    "V1": { "status": "pass", "sections_found_per_file": {...} },
+    "V2": { "status": "pass", "noise_hits": 0 },
+    "V3": { "status": "pass" | "n/a", "details": "..." },
+    "V4": { "status": "pass", "conditionals": { "manuales_graduados": "fila informativa OK", "temas_no_graduados": "sección presente con 5 temas", "proximos_pasos": "presente (5 temas)" } },
+    "V5": { "status": "warning", "issues": [...] },
+    "V6": { "status": "warning", "missing_refs": [...] }
+  },
+  "summary": "INDEX.md sobrescrito; 3 graduados + 5 temas no-graduados detectables."
+}
+```
+
+Si hard-fail:
+
+```json
+{
+  "ok": false,
+  "stage": "validation",
+  "failed_at": "V4.b",
+  "details": "modo regenerar sin temas detectables",
+  "no_files_written": true
+}
+```
+
+## Diferencias con los validations hermanos
+
+| Validación | `export-tech-manuals` | `export-arq` | `export-report` |
+|---|---|---|---|
+| V1 | estructura por modo (INDEX vs dossier) | estructura de secciones por scope | cota dura de palabras |
+| V2 | noise mínimo (~30) | noise mínimo (~25) | léxico ejecutivo (~75) |
+| V3 | secciones por manual (sólo regenerar) | diagrama C4 presente | secciones obligatorias en orden |
+| V4 | condicionales por modo (3 sub-casos) | condicionales (2 sub-casos) | "Recomendaciones" condicional (1 caso) |
+| V5 | header del INDEX o del manual | header arq con snapshot+fuentes+diagrams | header con período natural |
+| V6 | referencias resolubles | referencias resolubles | referencias resolubles |

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

@@ -0,0 +1,31 @@
+---
+name: export-tech-note
+description: "[STUB] Genera una Nota Técnica (`.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/manuales/NNN-export-tech-note-YYYY-MM-DD.md` o `docs/funcional/`. Read-only sobre el corpus. Invocado sólo vía `/agent-workflow:export-tech-note`. Creado en session081-dev-extend-export-family con `version: 0.1.0`."
+version: 0.1.0
+---
+
+# Export Tech 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 una **Nota Técnica** consolidada del workspace, dirigida a stakeholders técnicos (devs, líderes técnicos, soporte). Más compacta que `export-tech-manuals` (que es un manual completo); más profunda que `export-report` (que es ejecutivo no técnico).
+
+- **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/manuales/`, `docs/decisiones/`, `docs/conclusiones/`, `docs/arq/`.
+- **Output previsto**: `<docs>/manuales/NNN-export-tech-note-YYYY-MM-DD.md` (sub-decisión a tomar en la sesión de implementación: ¿manuales/ o funcional/ técnica?).
+
+## 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/hooks/README.md

@@ -0,0 +1,15 @@
+# hooks/
+
+Hooks que el host ejecuta automáticamente durante el ciclo de vida de una sesión. Distribuídos como templates; el CLI `agent-workflow self install --target <host>` los materializa con adapters por host (ver `src/application/self/install-hooks.ts`).
+
+Contenido esperado (T2 PR2):
+
+- `SessionStart.template.json` — carga `profile.json`, registra namespace, auto-copy profile si aplica.
+- `PreCompact.template.json` — checkpoint-write antes de compactar contexto.
+- `PostCompact.template.json` — resume-summary tras compactar.
+- `sql-mutation-guard.template.json` — bloquea SQL no parametrizado / DDL en flujos de runtime.
+- `branch-check.template.json` — gate de rama al entrar a execution.
+- `git-commit-advisor.template.json` — recordatorio M1 ante intención de commit.
+- `commit-prompt-universal.template.json` — disparo del prompt de cierre universal.
+
+Cada template es agnóstico de host; los adapters lo traducen a `~/.claude/settings.json`, `~/.codex/config.toml`, etc.