@tacuchi/agent-workflow-cli 11.0.0 → 12.0.0

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

@@ -1,214 +0,0 @@
----
-name: export-tech-manuals
-description: "Genera y mantiene manuales técnicos del workspace en `docs/manuales/` consolidando sesiones + `docs/` (manuales/, decisiones/, especificaciones/ como referencias técnicas). Dos modos: `complementar` (default, sobrescribe `INDEX.md` apuntando a manuales graduados + detectables del corpus) y `regenerar` (produce dossier `NNN-export-tech-manuals-YYYY-MM-DD/` con 1 manual por tema detectado). Audiencia: operadores / soporte / onboarding. Read-only sobre corpus + `docs/manuales/` existente; sin commits autónomos. Invocado sólo vía `/agent-workflow:export-tech-manuals`. v1.1 (session081): corpus extendido formalmente a `docs/` además de sesiones (DEC-002) — ver `docs/shared-contract/export-corpus-sources.md`."
-version: 1.1.0
----
-
-# Export Tech Manuals — Manuales técnicos desde corpus + graduados
-
-Tercer comando de la familia `/agent-workflow:export-*`. Genera un índice consolidado de manuales (modo default `complementar`) o un dossier completo con manuales sintetizados (modo `regenerar`). **Read-only / reporte** — no commitea, no muta nada del corpus.
-
-> Propuesta original: `docs/conclusiones/007-export-commands-family.md` §1.3. Pattern hermano: `agent-workflow/skills/export-arq/`.
-
-## Excepción session-aware
-
-Este skill requiere conocimiento del lifecycle. **No crea ni modifica sesiones**. Si el workspace no tiene AW-PROJECT con fuentes declaradas → abortar con `ok: false`.
-
-**Consumo de CLI `agent-workflow`** (no leer paths hardcodeados):
-- `agent-workflow project-md-upsert --read` — `workspace_mode`, fuentes.
-- `agent-workflow history-data` — sesiones cerradas para detectar temas/manuales no graduados.
-- `agent-workflow session-artifacts --code <NNN>` — OBJECTIVE + CHECKPOINT + (MANUAL.md si existe) por sesión.
-- `agent-workflow next-number docs/manuales` — sólo modo `regenerar`.
-
-**Lectura del filesystem**:
-- `docs/manuales/*.md` — manuales ya graduados (`kind=manual`).
-- `docs/manuales/INDEX.md` — sobrescribible (re-generable) en modo `complementar`.
-
-## When to use
-
-- "Manual operativo", "índice de manuales", "consolidar guías técnicas".
-- Tras agregar manuales nuevos via `agent-workflow graduate --kind manual`, refrescar el índice.
-- Paquete de onboarding técnico para nuevos miembros del equipo.
-- Auditoría de cobertura documental.
-
-## Qué hace este skill
-
-1. Lee AW-PROJECT (fuentes + mode).
-2. Lee `docs/manuales/*.md` (manuales graduados).
-3. Escanea corpus de sesiones cerradas detectando temas / manuales no graduados.
-4. Resuelve modo (`complementar` o `regenerar`).
-5. Aplica filtros `--since`, `--source`, `--temas` si están presentes.
-6. Carga plantilla (`template-index.md` o `template-manual.md`).
-7. Renderiza output aplicando léxico técnico mínimo.
-8. Valida V1-V6 (`references/validations.md`).
-9. Si pasa:
-   - `complementar`: sobrescribe `docs/manuales/INDEX.md`.
-   - `regenerar`: escribe `docs/manuales/NNN-export-tech-manuals-YYYY-MM-DD/` con 1 manual por tema.
-
-## Qué NO hace
-
-- Ejecutar commits, merges, push, SQL ni envío de correos.
-- Mutar manuales ya graduados (sólo los lee).
-- Mutar corpus de sesiones.
-- Sobrescribir un dossier `regenerar` previo (siempre next-number).
-- Renderizar visualmente diagramas (los manuales son texto; Mermaid embebido si aporta, pero no es obligatorio).
-- Inventar manuales: si no hay tema detectable, abortar con error claro en modo `regenerar`; en modo `complementar` produce INDEX vacío con nota inline.
-
-## Sandbox read-only
-
-`../session/references/sandbox-readonly-rules.md`. En plan mode esta skill describe:
-- Modo resuelto + plantilla a cargar.
-- Manuales graduados detectados (lista).
-- Temas detectables del corpus (lista + confidence).
-- Modo `regenerar`: count de manuales que se generarían.
-- Modo `complementar`: estructura del INDEX que se sobrescribiría.
-
-NO ejecuta: `Write` del INDEX o de los manuales, `agent-workflow next-number` con efecto, mutaciones.
-
-## Estilo de comunicación
-
-`../session/references/communication-style.md`. La audiencia es técnica — sin léxico ejecutivo. `agent-workflow:redaccion-simple` aplica con preset default. Foco en accionabilidad: cada manual debe permitir al operador completar la tarea sin invocar al equipo de desarrollo.
-
-## Entrada
-
-```
-/agent-workflow:export-tech-manuals [--sessions NNN[,NNN]] [--since sessionNNN] [--source <alias>]
-                          [--mode complementar|regenerar]
-                          [--temas slug1,slug2]
-                          [--dry-run]
-```
-
-### Defaults
-
-- `--mode complementar`.
-- Sin `--sessions` (todo el corpus).
-- Sin `--since` (todo el corpus). Ignorado si `--sessions` presente.
-- Sin `--source` (hub completo).
-- Sin `--temas` (todos los temas detectables).
-
-Ejemplo: `/agent-workflow:export-tech-manuals --sessions 055,057,061` consolida sólo esas 3 sesiones.
-
-### Resolución de `--mode`
-
-| Modo | Output | Cuándo usar |
-|---|---|---|
-| `complementar` (default) | `docs/manuales/INDEX.md` (sobrescribe) | Refresh del índice tras agregar manuales graduados |
-| `regenerar` | `docs/manuales/NNN-export-tech-manuals-YYYY-MM-DD/` (next-number) | Paquete consolidado de manuales (ej. onboarding) |
-
-### Detección de temas
-
-- **Fuente primaria**: `## Topics` o `## Temas` en OBJECTIVE.md de las sesiones del corpus.
-- **Fuente secundaria**: inferencia por keywords en OBJECTIVE/CHECKPOINT (confidence > 0.6).
-- **Override explícito**: `--temas slug1,slug2` limita a los slugs declarados.
-
-## Flujo
-
-### Paso 1 — Resolver contexto
-
-```
-agent-workflow project-md-upsert --read
-```
-
-Extrae `workspace_mode`, `fuentes[]`, `mode`. Determina root del workspace + path destino:
-- `hub` → `<hub>/docs/manuales/`.
-- `project` → `<cwd>/docs/manuales/`.
-
-### Paso 2 — Inspeccionar manuales graduados
-
-Listar `docs/manuales/*.md` (excluyendo `INDEX.md` y subdirectorios `NNN-export-tech-manuals-*/`).
-
-Para cada manual graduado, extraer:
-- Slug (del filename `NNN-<slug>.md`).
-- Título (primer `# ` header).
-- Resumen breve (primer párrafo, ≤200 caracteres).
-- Path canónico.
-
-### Paso 3 — Detectar temas/manuales no graduados
-
-```
-agent-workflow history-data
-```
-
-Para cada sesión cerrada del corpus filtrado por `--since` / `--source`:
-
-```
-agent-workflow session-artifacts --code <CODE>
-```
-
-Buscar:
-- Sección `## Topics` / `## Temas` en OBJECTIVE.md → slug declarado.
-- Archivo `MANUAL.md` dentro de la sesión (si existe).
-- Keywords operativos en OBJECTIVE/CHECKPOINT que sugieran un manual: "configurar", "instalar", "wizard", "paso a paso", "cómo hacer", etc.
-
-Listar temas detectados con (slug, confidence, sesiones de origen).
-
-Filtrar por `--temas slug1,slug2` si está presente.
-
-### Paso 4 — Resolver modo
-
-| Modo | Acción |
-|---|---|
-| `complementar` | Cargar `references/template-index.md` |
-| `regenerar` | Cargar `references/template-manual.md` |
-
-### Paso 5 — Renderizar
-
-**Modo `complementar`**:
-- Cabecera: título + count de manuales totales (graduados + detectables).
-- Tabla principal con columnas: Tema · Slug · Manual graduado (path o `[no graduado]`) · Sesiones de origen.
-- Sección "Próximos pasos sugeridos" si hay temas con `[no graduado]`.
-
-**Modo `regenerar`**:
-- 1 archivo `.md` por tema en el dossier.
-- Cada archivo sigue `template-manual.md`: Propósito · Pre-requisitos · Pasos numerados · Validación post-uso · Troubleshooting · Referencias.
-- `README.md` del dossier con índice de manuales generados.
-
-Aplicar `references/lexico-tecnico.md` durante el render (limpieza de noise).
-
-### Paso 6 — Validar (V1-V6)
-
-`references/validations.md`. Reglas adaptadas a los 2 modos:
-- V1 estructura por modo (INDEX con tabla principal vs dossier con N manuales completos).
-- V2 noise vetado.
-- V3 secciones de `template-manual.md` (sólo modo `regenerar`).
-- V4 condicionales (modo `regenerar` con 0 temas → abort; modo `complementar` con 0 manuales → INDEX con nota).
-- V5 header.
-- V6 referencias resolubles (paths a manuales graduados).
-
-Si V1, V3 o V4 fallan → abortar.
-
-### Paso 7 — Escribir output
-
-Si `--dry-run`: imprimir reporte. No escribir.
-
-Si pasa:
-- `complementar`: `Write` sobre `docs/manuales/INDEX.md` (sobrescribe).
-- `regenerar`: `agent-workflow next-number docs/manuales` → crear directorio + N archivos.
-
-### Paso 8 — Resumen al usuario
-
-- Modo + paths escritos.
-- Counts: manuales graduados detectados, temas no graduados detectables, manuales generados (modo `regenerar`).
-- Warnings: V5/V6 si emitieron.
-- Sugerencia: si hay temas detectables sin graduar, sugerir abrir sesiones dedicadas para producirlos formalmente.
-
-## Composición con otras skills
-
-- **`agent-workflow:redaccion-simple`** — preset default aplicado durante el render.
-- **`agent-workflow:rules`** — anchors transversales consultables.
-- **`session`** — este skill NO invoca graduación ni cierre. Una sesión activa puede consumirlo durante validation/closure para refrescar INDEX tras graduar un nuevo manual.
-
-## Re-ejecución
-
-- Modo `complementar`: idempotente — sobrescribe `INDEX.md`; dos invocaciones consecutivas con mismo corpus producen el mismo archivo.
-- Modo `regenerar`: cada invocación toma siguiente NNN. No sobrescribe dossiers previos.
-
-## Recursos adicionales
-
-- **`references/template-manual.md`** — estructura uniforme por manual (modo `regenerar`).
-- **`references/template-index.md`** — estructura del `INDEX.md` consolidado (modo `complementar`).
-- **`references/lexico-tecnico.md`** — noise mínimo vetado (idéntico patrón que export-arq).
-- **`references/validations.md`** — V1-V6 con reglas por modo.
-- **`docs/conclusiones/007-export-commands-family.md`** — Propuesta original (familia `/agent-workflow:export-*`).
-- **`agent-workflow/skills/export-arq/SKILL.md`** — hermano (arquitectura técnica).
-- **`agent-workflow/skills/export-report/SKILL.md`** — hermano (informe ejecutivo).

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

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

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

@@ -1,143 +0,0 @@
-# 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 agent-workflow 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.