@tacuchi/agent-workflow-cli 6.1.0 → 7.0.0

package/skills/agent-workflow/commands/agent-workflow-export-conclusions.md

@@ -0,0 +1,78 @@
+---
+description: Consolida N sesiones del workspace (con CONCLUSIONS.md presente) + `docs/conclusiones/` ya graduadas en un documento curado bajo `docs/conclusiones/NNN-export-conclusions-YYYY-MM-DD.md`. Sintetiza Resumen ejecutivo + C-items por sesión + R-items deduplicados cross-session + Roadmap derivado opcional. Aplica dedup por slug + cross-slug similarity opcional + conflict resolution. Complementa graduate --kind conclusion (single-session). Read-only. Séptimo comando de la familia /agent-workflow:export-*.
+argument-hint: (opcional) --sessions NNN[,NNN] | --since sessionNNN | --source <alias> | --slug <kebab> | --dry-run
+allowed-tools:
+  [
+    "Read",
+    "Write",
+    "Bash",
+    "Grep",
+    "Glob",
+  ]
+---
+
+# Export Conclusions
+
+Consolida N sesiones que tengan `CONCLUSIONS.md` presente en un documento curado bajo `docs/conclusiones/NNN-export-conclusions-YYYY-MM-DD.md`. Delega al skill `export-conclusions` (`agent-workflow/skills/export-conclusions/SKILL.md`).
+
+El skill **nunca** ejecuta commits, merges, push, SQL ni envía correos. Solo produce:
+
+- `<docs>/conclusiones/NNN-<slug>-YYYY-MM-DD.md` — documento único MD con Resumen ejecutivo + Sesiones consolidadas + C-items por sesión + R-items deduplicados + Roadmap derivado opcional + Refs.
+
+Donde `<docs>` es:
+- `Path.cwd() / docs` por default (project mode o hub workspace base).
+- `<source.path>/docs` si se pasa `--source <alias>` en hub mode.
+
+Séptimo comando de la familia `/agent-workflow:export-*` definida en `docs/conclusiones/008-roadmap-export-plan-lifecycle.md` (F-B). Bundle plugin v2.10.0 junto con `/agent-workflow:export-plan` (F-A).
+
+## Excepción session-aware
+
+Este skill requiere conocimiento del lifecycle pero lo consume sólo vía CLI `agent-workflow`. No lee paths hardcodeados.
+
+**Audiencia**: PMs / leads / arquitectos. Términos del dominio (`CONCLUSIONS`, `R-items`, `roadmap`, `dedup`, `NNN`, `hub`) autorizados.
+
+**Argumentos:** $ARGUMENTS
+
+### Argumentos soportados
+
+- `--sessions NNN[,NNN]` — filtro discreto por código. Precede a `--since`.
+- `--since sessionNNN` — incluye sólo sesiones posteriores a NNN (inclusive). Ignorado si `--sessions` presente.
+- `--source <alias>` — en hub mode, limita a una fuente específica.
+- `--slug <kebab>` — override del slug del filename (default: `export-conclusions`).
+- `--dry-run` — reporte propositivo sin escribir.
+
+Sin args: incluye todas las sesiones del workspace con `CONCLUSIONS.md` presente.
+
+Ejemplo: `/agent-workflow:export-conclusions --sessions 049,051,062 --slug runtime-evolution-roadmap`.
+
+## Flujo
+
+Antes de generar, el skill llama al CLI `agent-workflow`:
+
+```
+agent-workflow release-data --include-graduated [--sessions NNN[,NNN]] [--since sessionNNN] [--source <alias>]
+agent-workflow session-artifacts --code <CODE>    # verificar CONCLUSIONS.md presence
+agent-workflow next-number docs/conclusiones      # numeración (coexiste con graduate)
+```
+
+Filtra el corpus descartando sesiones sin `CONCLUSIONS.md`. Si el filtro queda vacío → abortar con mensaje claro.
+
+Luego aplica el algoritmo de dedup (`references/dedup-rules.md`) sobre R-items y sintetiza Roadmap derivado si hay ≥3 R-items consolidados.
+
+## Plan mode
+
+Reglas generales en `skills/session/references/sandbox-readonly-rules.md`. Describir en el plan file: NNN resuelto + sesiones del corpus (post-filtro) + R-items consolidados esperados + conflicts detectados + estructura final del MD.
+
+## Relación con `graduate --kind conclusion`
+
+`graduate --kind conclusion --session NNN` sigue siendo el path canónico para **promover una sesión single al canon** (copia `CONCLUSIONS.md` tal cual a `docs/conclusiones/NNN-<slug>.md`).
+
+`export-conclusions` es **complementario**: aplica cuando hay valor en consolidación cross-session (dedup + roadmap + trazabilidad multi-origen). Coexisten bajo el mismo counter `next-number docs/conclusiones`.
+
+## Recursos
+
+- `skills/export-conclusions/SKILL.md` v1.0.0 — orquestador del comando.
+- `skills/export-conclusions/references/template-conclusions.md` — plantilla canónica + ejemplo single-session.
+- `skills/export-conclusions/references/dedup-rules.md` — algoritmo de dedup R-NNN + casos edge.
+- `docs/conclusiones/008-roadmap-export-plan-lifecycle.md` — diseño F-B.
+- Siblings: `commands/export-plan.md` (F-A), `commands/export-scripts.md`, `commands/export-arq.md`, `commands/export-tech-manuals.md`, `commands/export-report.md`.

package/skills/agent-workflow/commands/agent-workflow-export-plan.md

@@ -0,0 +1,74 @@
+---
+description: Consolida N sesiones del workspace + `docs/planes/` ya graduados + `docs/decisiones/` / `docs/conclusiones/` para referencias en un plan ejecutable bajo `docs/planes/NNN-export-plan-YYYY-MM-DD.md`. Lee OBJECTIVE/TASKS/CONCLUSIONS de las sesiones fuente y deriva Resumen + Fases + Tasks (con dependencias) + Riesgos + Refs. Frontmatter YAML con state (draft/active/done/archived). Read-only. Sexto comando de la familia /agent-workflow:export-*.
+argument-hint: (opcional) --sessions NNN[,NNN] | --since sessionNNN | --source <alias> | --slug <kebab> | --dry-run
+allowed-tools:
+  [
+    "Read",
+    "Write",
+    "Bash",
+    "Grep",
+    "Glob",
+  ]
+---
+
+# Export Plan
+
+Consolida N sesiones (cerradas o activas con artefactos completos) en un plan ejecutable bajo `docs/planes/NNN-export-plan-YYYY-MM-DD.md`. Delega al skill `export-plan` (`agent-workflow/skills/export-plan/SKILL.md`).
+
+El skill **nunca** ejecuta commits, merges, push, SQL ni envía correos. Solo produce:
+
+- `<docs>/planes/NNN-<slug>-YYYY-MM-DD.md` — plan único MD con frontmatter YAML (`state: draft`).
+
+Donde `<docs>` es:
+- `Path.cwd() / docs` por default (project mode o hub workspace base).
+- `<source.path>/docs` si se pasa `--source <alias>` en hub mode.
+
+Sexto comando de la familia `/agent-workflow:export-*` definida en `docs/conclusiones/008-roadmap-export-plan-lifecycle.md` (F-A). Bundle plugin v2.10.0.
+
+## Excepción session-aware
+
+Este skill (junto con `release`, `release-scripts`, `export-scripts`, `export-report`, `export-arq`, `export-tech-manuals`) requiere conocimiento del lifecycle pero lo consume sólo vía CLI `agent-workflow`. No lee paths hardcodeados.
+
+**Audiencia**: devs / PMs / leads. Términos técnicos del dominio (`OBJECTIVE`, `TASKS`, `flow`, `phase`, `NNN`, `hub`) autorizados.
+
+**Argumentos:** $ARGUMENTS
+
+### Argumentos soportados
+
+- `--sessions NNN[,NNN]` — filtro discreto por código. Precede a `--since`.
+- `--since sessionNNN` — incluye sólo sesiones posteriores a NNN (inclusive). Ignorado si `--sessions` presente.
+- `--source <alias>` — en hub mode, limita a una fuente específica.
+- `--slug <kebab>` — override del slug del filename (default: `export-plan`).
+- `--dry-run` — reporte propositivo sin escribir el plan.
+
+Sin args: incluye todas las sesiones cerradas + activas con artefactos completos.
+
+Ejemplo: `/agent-workflow:export-plan --sessions 055,061 --slug runtime-evolution`.
+
+## Flujo
+
+Antes de generar, el skill llama al CLI `agent-workflow`:
+
+```
+agent-workflow release-data --include-graduated [--sessions NNN[,NNN]] [--since sessionNNN] [--source <alias>]
+agent-workflow session-artifacts --code <CODE>    # lazy read por sesión
+agent-workflow next-number docs/planes            # numeración determinística
+```
+
+Luego sintetiza Resumen + Fases + Tasks + Dependencias + Riesgos + Refs siguiendo la plantilla `references/template-plan.md`. Estado inicial: `draft`. Transiciones futuras: ver `references/state-transitions.md`.
+
+## Plan mode
+
+Reglas generales en `skills/session/references/sandbox-readonly-rules.md`. Describir en el plan file: NNN resuelto + sesiones incluidas + sección por sección del plan generado + frontmatter YAML preview.
+
+## Relación con `/agent-workflow:session --from-plan`
+
+Cuando F-E.3 esté operativo (Sprint 4 del roadmap), `agent-workflow session-create --from-plan <NNN>` consumirá el plan generado por este comando y transicionará `state: draft → active`. Hoy: F-E.3 no está implementado todavía; el plan queda en `draft` hasta que el usuario inicie la sesión manualmente.
+
+## Recursos
+
+- `skills/export-plan/SKILL.md` v1.0.0 — orquestador del comando.
+- `skills/export-plan/references/template-plan.md` — plantilla canónica del plan.
+- `skills/export-plan/references/state-transitions.md` — árbol de decisión G3 + spec `AskUserQuestion plan-state`.
+- `docs/conclusiones/008-roadmap-export-plan-lifecycle.md` — diseño F-A.
+- Siblings: `commands/export-scripts.md`, `commands/export-arq.md`, `commands/export-tech-manuals.md`, `commands/export-report.md`.

package/skills/agent-workflow/commands/agent-workflow-export-qa-note.md

@@ -0,0 +1,30 @@
+---
+description: "[STUB] Genera una Nota de Entrega a QA (`.md`) consolidando sesiones del workspace + `docs/`. Stub vacío — implementación diferida."
+argument-hint: (stub — sin argumentos activos aún)
+allowed-tools:
+  [
+    "Read",
+    "Write",
+    "Bash",
+    "Grep",
+    "Glob",
+  ]
+---
+
+# Export QA Note
+
+> **STUB** — sin lógica activa aún. Placeholder discoverable creado en session081-dev-extend-export-family.
+
+Delega al skill `export-qa-note` (`agent-workflow/skills/export-qa-note/SKILL.md`). Cuando se implemente, generará un `.md` con la Nota de Entrega a QA, enmarcando alcance + criterios de aceptación + casos de prueba para acompañar un release/feature.
+
+**Argumentos:** $ARGUMENTS (ignorados por ahora — stub).
+
+## Estado
+
+- Creado: session081 (2026-05-21).
+- Implementación: **diferida**. Invocar este comando hoy reporta "stub not implemented yet".
+
+## Recursos
+
+- `agent-workflow/skills/export-qa-note/SKILL.md` v0.1.0 — orquestador stub.
+- `agent-workflow/docs/shared-contract/export-corpus-sources.md` — contrato corpus canónico (DEC-002 session081).

package/skills/agent-workflow/commands/agent-workflow-export-report.md

@@ -0,0 +1,78 @@
+---
+description: Genera un informe 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`. Read-only.
+argument-hint: (opcional) --since sessionNNN | --source <alias> | --period last-quarter|last-month|YYYY-MM..YYYY-MM | --audiencia gerencia|jefatura|comite | --mode resumen|analisis|draft | --dry-run
+allowed-tools:
+  [
+    "Read",
+    "Write",
+    "Bash",
+    "Grep",
+    "Glob",
+  ]
+---
+
+# Export Report
+
+Genera un informe funcional ejecutivo `.md` agregando las sesiones cerradas del workspace **y la documentación graduada en `docs/`**, para gerencia / jefatura / comité de seguimiento. Delega al skill `export-report` (`agent-workflow/skills/export-report/SKILL.md`).
+
+> Renombrado: `export-func` (session057) → `export-functional-specs` (session059) → `export-functional-report` (session060) → `export-report` (session081, **hard rename sin alias legacy** — DEC-003). El nombre corto "report" refleja que el deliverable es un informe ejecutivo, no una especificación técnica. v1.7 (session081) extiende el corpus a `docs/` además de sesiones (DEC-002).
+
+El skill **nunca** ejecuta commits, merges, push, SQL ni envía correos. Solo produce:
+
+- `<docs>/funcional/NNN-export-report-YYYY-MM-DD.md` — informe ejecutivo único.
+
+Donde `<docs>` es:
+- `Path.cwd() / docs` por default (project mode o hub workspace base).
+- `<source.path>/docs` si se pasa `--source <alias>` en hub mode.
+
+Primer comando de la familia `/agent-workflow:export-*` definida en `docs/conclusiones/007-export-commands-family.md`. Spec autoritativa del formato: `docs/especificaciones/001-export-report-format/DELIVERY.md`. Contrato de corpus canónico (sesiones + `docs/`): `agent-workflow/docs/shared-contract/export-corpus-sources.md`.
+
+## Excepción session-aware
+
+Esta skill, junto con `release` y `release-scripts`, requiere conocimiento del lifecycle pero las consume solo via CLI `agent-workflow`. No lee paths hardcodeados.
+
+**Sesiones legacy** abortan con mensaje claro — migrar primero con `/agent-workflow:migrate --upgrade-topology`.
+
+**Argumentos:** $ARGUMENTS
+
+### Argumentos soportados
+
+- `--since sessionNNN` — solo incluir sesiones posteriores a la indicada.
+- `--source <alias>` — en hub mode, limitar el corpus a una sola fuente.
+- `--period last-quarter|last-month|YYYY-MM..YYYY-MM` — ventana temporal del corpus.
+- `--audiencia gerencia|jefatura|comite` — modula variante (gerencia → A, jefatura → B default, comite → C).
+- `--mode resumen|analisis|draft` — modula variante (resumen → A, analisis → B default, draft → C).
+- `--dry-run` — no escribir archivo; reportar lo que se generaría.
+
+Matriz completa `audiencia × mode` y reglas de conflicto en `skills/export-report/SKILL.md` §"Entrada".
+
+## Flujo
+
+Antes de generar, el skill llama al CLI `agent-workflow`:
+
+```
+agent-workflow project-md-upsert --read           # workspace_mode, fuentes
+agent-workflow history-data                       # lista de sesiones
+agent-workflow session-artifacts --code <CODE>    # por sesión filtrada
+agent-workflow objetivo-data --code <CODE>        # tipo, criterios, fuentes
+agent-workflow decisiones-list --code <CODE>      # DEC-NNN
+agent-workflow next-number docs/funcional         # numeración determinística
+```
+
+Luego renderiza la plantilla `references/template-<variante>.md` aplicando la tabla de traducción técnico→ejecutivo `references/lexico.md` y valida con V1-V6 (`references/validations.md`) antes de escribir.
+
+## Plan mode
+
+Reglas generales en `skills/session/references/sandbox-readonly-rules.md`. Describir en el plan file: variante resuelta + plantilla a cargar, sesiones del corpus tras filtros, subcarpetas de `docs/` que se consultarían, length estimada, secciones que aparecerían (incluyendo la condición de "Oportunidades de mejora" — V4), warnings esperados.
+
+## Recursos
+
+- `skills/export-report/SKILL.md` v1.7.0 — orquestador del comando.
+- `skills/export-report/references/template-b.md` — plantilla default Variante B (760w).
+- `skills/export-report/references/template-a.md` — plantilla compacta Variante A (400w).
+- `skills/export-report/references/template-c.md` — plantilla extensa Variante C (1620w).
+- `skills/export-report/references/lexico.md` — tabla técnico→ejecutivo + lista vetada V2.
+- `skills/export-report/references/validations.md` — V1-V6 detalladas.
+- `docs/especificaciones/001-export-report-format/DELIVERY.md` — spec autoritativa del formato.
+- `docs/conclusiones/007-export-commands-family.md` — Propuesta original de la familia `/agent-workflow:export-*`.
+- `docs/shared-contract/export-corpus-sources.md` — contrato canónico de corpus (sesiones + `docs/`).

package/skills/agent-workflow/commands/agent-workflow-export-requirement.md

@@ -0,0 +1,30 @@
+---
+description: "[STUB] Genera un Requerimiento Funcional (`.md`) consolidando sesiones del workspace + `docs/`. Stub vacío — implementación diferida."
+argument-hint: (stub — sin argumentos activos aún)
+allowed-tools:
+  [
+    "Read",
+    "Write",
+    "Bash",
+    "Grep",
+    "Glob",
+  ]
+---
+
+# Export Requirement
+
+> **STUB** — sin lógica activa aún. Placeholder discoverable creado en session081-dev-extend-export-family.
+
+Delega al skill `export-requirement` (`agent-workflow/skills/export-requirement/SKILL.md`). Cuando se implemente, generará un `.md` con un Requerimiento Funcional consolidado del workspace para audiencias de negocio/producto.
+
+**Argumentos:** $ARGUMENTS (ignorados por ahora — stub).
+
+## Estado
+
+- Creado: session081 (2026-05-21).
+- Implementación: **diferida**. Invocar este comando hoy reporta "stub not implemented yet".
+
+## Recursos
+
+- `agent-workflow/skills/export-requirement/SKILL.md` v0.1.0 — orquestador stub.
+- `agent-workflow/docs/shared-contract/export-corpus-sources.md` — contrato corpus canónico (DEC-002 session081).

package/skills/agent-workflow/commands/agent-workflow-export-scripts.md

@@ -0,0 +1,92 @@
+---
+description: Consolida N sesiones del workspace + `docs/scripts/` ya graduados en un paquete de paso a producción bajo `docs/scripts/NNN-export-scripts-YYYY-MM-DD/`. Genera manifest.md (informe + checklist + acciones manuales + git state + code-scan), por-sesion/ (bundle SQL organizado), por-tema/ (vista opt-in), rollback-global.sql y ORDER.md. Read-only. Refactor de /agent-workflow:release + /agent-workflow:release-scripts.
+argument-hint: (opcional) --since sessionNNN | --source <alias> | --themes slug1,slug2|infer | --keep-parts | --skip-code-scan | --dry-run
+allowed-tools:
+  [
+    "Read",
+    "Write",
+    "Bash",
+    "Grep",
+    "Glob",
+  ]
+---
+
+# Export Scripts
+
+Consolida N sesiones cerradas (más opcionalmente activas) en un paquete único de paso a producción. Delega al skill `export-scripts` (`agent-workflow/skills/export-scripts/SKILL.md`).
+
+El skill **nunca** ejecuta commits, merges, push, SQL ni envía correos. Solo produce:
+
+- `<docs>/scripts/NNN-export-scripts-YYYY-MM-DD/manifest.md` — informe consolidado (sesiones, acciones manuales, BD, hallazgos code-scan, git, checklist).
+- `<docs>/scripts/NNN-export-scripts-YYYY-MM-DD/README.md` — índice + mapeo sesión↔tema↔scripts.
+- `<docs>/scripts/NNN-export-scripts-YYYY-MM-DD/ORDER.md` — secuencia ejecutable.
+- `<docs>/scripts/NNN-export-scripts-YYYY-MM-DD/rollback-global.sql` — rollback encadenado inverso.
+- `<docs>/scripts/NNN-export-scripts-YYYY-MM-DD/por-sesion/` — bundle SQL por sesión (organizado 01→04).
+- `<docs>/scripts/NNN-export-scripts-YYYY-MM-DD/por-tema/` — bundle consolidado por tema (opt-in).
+
+Donde `<docs>` es:
+- `Path.cwd() / docs` por default (project mode o hub workspace base).
+- `<source.path>/docs` si se pasa `--source <alias>` en hub mode.
+
+Último comando de la familia `/agent-workflow:export-*` definida en `docs/conclusiones/007-export-commands-family.md`. Refactor que consolida `/agent-workflow:release` v2.0.0 + `/agent-workflow:release-scripts` v2.0.0.
+
+## Excepción session-aware
+
+Este skill (junto con `release`, `release-scripts`, `export-report`, `export-arq`, `export-tech-manuals`) requiere conocimiento del lifecycle pero lo consume solo vía CLI `agent-workflow`. No lee paths hardcodeados.
+
+**Audiencia**: devs / DBAs / release managers. Términos técnicos del dominio (NNN, DDL, DML, rollback, hub, branch) autorizados.
+
+**Argumentos:** $ARGUMENTS
+
+### Argumentos soportados
+
+- `--since sessionNNN` — incluye sólo sesiones posteriores a NNN (inclusive).
+- `--source <alias>` — en hub mode, limita a una fuente específica.
+- `--themes slug1,slug2` — genera `por-tema/` con los slugs declarados.
+- `--themes infer` — inferencia LLM de temas (mismo flujo que release-scripts legacy).
+- `--keep-parts` — preserva `por-tema/<slug>/parts/<categoria>/*.sql`.
+- `--skip-code-scan` — omite el escaneo de código fuente.
+- `--dry-run` — reporte propositivo sin escribir archivos.
+
+Sin args: incluye todas las sesiones cerradas, sin vista `por-tema/`, escanea todo el código.
+
+## Flujo
+
+Antes de generar, el skill llama al CLI `agent-workflow`:
+
+```
+agent-workflow release-data --include-graduated [--since sessionNNN] [--source <alias>]
+agent-workflow code-scan                          # con built-in patterns + override
+agent-workflow next-number docs/scripts           # numeración determinística
+agent-workflow session-artifacts --code <CODE>    # lazy read de OBJECTIVE/TASKS/DECISIONS/scripts
+```
+
+Luego delega a `sql-script-organizer` (clasificación 01→04 cross-session) y `sql-rollback-generator` (rollback acoplado + global). Si hay temas declarados o `--themes infer`: aplica algoritmo de consolidación por tema (port adaptado de release-scripts legacy).
+
+Valida V1-V6 (`references/validations.md`) antes de escribir el bundle al filesystem.
+
+## Plan mode
+
+Reglas generales en `skills/session/references/sandbox-readonly-rules.md`. Describir en el plan file: NNN resuelto + sesiones incluidas + scripts por sesión, vista `por-tema/` activación (lectura de `## Temas` o flag), hallazgos esperados del code-scan, acciones manuales detectadas, advertencias bloqueantes (sesiones abiertas, rollback ausente, irreversibles).
+
+## Relación con `/agent-workflow:release` y `/agent-workflow:release-scripts`
+
+Este comando los reemplaza. Plan de deprecación Fase 1 (plugin v2.8.0):
+- Ambos legacy siguen funcionando sin cambios.
+- Banner deprecation visible al cargar SKILL.md y commands/*.md de cada uno.
+- Workspaces que ya invocaron `release` mantienen `docs/release/` como histórico.
+
+Detalle del plan: `skills/export-scripts/references/deprecation-plan.md`.
+
+## Recursos
+
+- `skills/export-scripts/SKILL.md` v1.0.0 — orquestador del comando.
+- `skills/export-scripts/references/manifest-template.md` — plantilla canónica del informe consolidado.
+- `skills/export-scripts/references/readme-template.md` — plantilla del README del bundle.
+- `skills/export-scripts/references/lexico-tecnico.md` — léxico vetado V2.
+- `skills/export-scripts/references/validations.md` — V1-V6 detalladas.
+- `skills/export-scripts/references/code-scan-recommendations.md` — catálogo extendido de patrones.
+- `skills/export-scripts/references/theme-handling.md` — algoritmo de detección/consolidación por tema.
+- `skills/export-scripts/references/deprecation-plan.md` — plan de fases 1-2.
+- `docs/conclusiones/007-export-commands-family.md` — Propuesta original de la familia `/agent-workflow:export-*`.
+- `agent-workflow/skills/release/SKILL.md`, `release-scripts/SKILL.md` — legacy en deprecation Fase 1.

package/skills/agent-workflow/commands/agent-workflow-export-tech-manuals.md

@@ -0,0 +1,75 @@
+---
+description: Genera o refresca manuales técnicos del workspace en `docs/manuales/` consolidando sesiones + `docs/` (manuales, decisiones, especificaciones). Dos modos: `complementar` (default, sobrescribe `INDEX.md`) y `regenerar` (produce dossier `NNN-export-tech-manuals-YYYY-MM-DD/`). Audiencia: operadores/soporte/onboarding. Read-only.
+argument-hint: (opcional) --since sessionNNN | --source <alias> | --mode complementar|regenerar | --temas slug1,slug2 | --dry-run
+allowed-tools:
+  [
+    "Read",
+    "Write",
+    "Bash",
+    "Grep",
+    "Glob",
+  ]
+---
+
+# Export Tech Manuals
+
+Genera y mantiene manuales técnicos del workspace desde el corpus de sesiones + manuales graduados. Delega al skill `export-tech-manuals` (`agent-workflow/skills/export-tech-manuals/SKILL.md`).
+
+El skill **nunca** ejecuta commits, merges, push, SQL ni envía correos. Solo produce:
+
+- **Modo `complementar`** (default): `<docs>/manuales/INDEX.md` — índice consolidado re-generable.
+- **Modo `regenerar`**: `<docs>/manuales/NNN-export-tech-manuals-YYYY-MM-DD/` — dossier con N manuales sintetizados + README.md.
+
+Donde `<docs>` es:
+- `Path.cwd() / docs` por default (project mode o hub workspace base).
+- `<source.path>/docs` si se pasa `--source <alias>` en hub mode.
+
+Tercer comando de la familia `/agent-workflow:export-*` definida en `docs/conclusiones/007-export-commands-family.md`.
+
+## Excepción session-aware
+
+Esta skill (junto con `release`, `release-scripts`, `export-report`, `export-arq`) requiere conocimiento del lifecycle pero las consume sólo via CLI `agent-workflow`. No lee paths hardcodeados.
+
+**Audiencia**: operadores / soporte / nuevos miembros del equipo. Sin léxico ejecutivo — léxico técnico mínimo (similar a export-arq). Cada manual debe ser ejecutable por alguien que no participó en el desarrollo.
+
+**Argumentos:** $ARGUMENTS
+
+### Argumentos soportados
+
+- `--since sessionNNN` — limita el corpus a sesiones posteriores.
+- `--source <alias>` — en hub mode, limita a una sola fuente.
+- `--mode complementar|regenerar` — default `complementar`.
+- `--temas slug1,slug2` — override explícito de la detección heurística de temas.
+- `--dry-run` — no escribir; reportar lo que se generaría.
+
+Detección de temas y reglas en `skills/export-tech-manuals/SKILL.md` §"Detección de temas".
+
+## Flujo
+
+```
+agent-workflow project-md-upsert --read           # workspace_mode, fuentes
+agent-workflow history-data                       # sesiones cerradas
+agent-workflow session-artifacts --code <CODE>    # OBJECTIVE + CHECKPOINT + MANUAL.md por sesión
+agent-workflow next-number docs/manuales          # sólo modo regenerar
+```
+
+Luego renderiza:
+- Modo `complementar`: `references/template-index.md` → sobrescribe `INDEX.md`.
+- Modo `regenerar`: `references/template-manual.md` por cada tema → escribe dossier.
+
+Valida V1-V6 (`references/validations.md`) antes de escribir.
+
+## Plan mode
+
+Reglas en `skills/session/references/sandbox-readonly-rules.md`. Describir en el plan file: modo + plantilla + manuales graduados detectados + temas no-graduados detectables + estructura del INDEX (o lista de archivos del dossier) + warnings esperados (V5/V6).
+
+## Recursos
+
+- `skills/export-tech-manuals/SKILL.md` v1.0.0 — orquestador.
+- `skills/export-tech-manuals/references/template-index.md` — modo complementar.
+- `skills/export-tech-manuals/references/template-manual.md` — modo regenerar.
+- `skills/export-tech-manuals/references/lexico-tecnico.md` — noise vetado V2.
+- `skills/export-tech-manuals/references/validations.md` — V1-V6 con reglas por modo.
+- `docs/conclusiones/007-export-commands-family.md` — Propuesta familia `/agent-workflow:export-*`.
+- `agent-workflow/skills/export-arq/SKILL.md` — hermano (arquitectura).
+- `agent-workflow/skills/export-report/SKILL.md` — hermano (informe ejecutivo).

package/skills/agent-workflow/commands/agent-workflow-export-tech-note.md

@@ -0,0 +1,30 @@
+---
+description: "[STUB] Genera una Nota Técnica (`.md`) consolidando sesiones del workspace + `docs/`. Stub vacío — implementación diferida."
+argument-hint: (stub — sin argumentos activos aún)
+allowed-tools:
+  [
+    "Read",
+    "Write",
+    "Bash",
+    "Grep",
+    "Glob",
+  ]
+---
+
+# Export Tech Note
+
+> **STUB** — sin lógica activa aún. Placeholder discoverable creado en session081-dev-extend-export-family.
+
+Delega al skill `export-tech-note` (`agent-workflow/skills/export-tech-note/SKILL.md`). Cuando se implemente, generará un `.md` con una Nota Técnica consolidada del workspace para audiencias técnicas (más compacta que un manual completo, más profunda que el informe ejecutivo).
+
+**Argumentos:** $ARGUMENTS (ignorados por ahora — stub).
+
+## Estado
+
+- Creado: session081 (2026-05-21).
+- Implementación: **diferida**. Invocar este comando hoy reporta "stub not implemented yet".
+
+## Recursos
+
+- `agent-workflow/skills/export-tech-note/SKILL.md` v0.1.0 — orquestador stub.
+- `agent-workflow/docs/shared-contract/export-corpus-sources.md` — contrato corpus canónico (DEC-002 session081).

package/skills/agent-workflow/commands/agent-workflow-hub-init.md

@@ -0,0 +1,82 @@
+---
+description: Inicializa un workspace en modo Hub (multi-repo) — bloque AW-PROJECT con Mode hub, captura ≥2 fuentes con sus rutas y ramas de trabajo. La rama principal default es `certificacion` (constante interna del CLI).
+argument-hint: (opcional) --proyecto "descripción" | --fuente alias:path | --working-branch alias:rama | --main-branch <rama>
+allowed-tools:
+  [
+    "Read",
+    "Write",
+    "Bash",
+    "AskUserQuestion",
+  ]
+---
+
+# Hub Init (agent-workflow)
+
+Inicializa un **hub workspace** — un directorio que coordina ≥2 repos pares. Escribe el bloque `<!-- AW-PROJECT-START -->` en `CLAUDE.md` y `AGENTS.md` del directorio actual con el marcador `Mode: hub` y la lista de fuentes (alias / path / rama principal) + ramas de trabajo actuales por fuente.
+
+> Distinto de `/agent-workflow:project-init` (single-repo). Hub mode activa heurísticas en el resto de la familia agent-workflow-*: `session` itera ramas por fuente, `implement` valida paths cross-repo, `release` agrupa por alias, etc.
+
+## Cuándo usar
+
+- Workspace que coordina ≥2 repos pares (ej. `qtc-plugin-marketplace` con 4 plugins, microservicios que cambian juntos, monorepo distribuido).
+- Sesiones cross-cutting que tocan múltiples repos a la vez.
+
+## Flujo
+
+1. **Detectar bloque existente** vía `agent-workflow workspace-mode`.
+   - Si `mode=hub` → mostrar fuentes actuales y preguntar si **agregar fuentes** o **reiniciar**.
+   - Si `mode=project` (o sin `Mode:`) **y ≥1 fuente declarada** → preguntar si **promover a hub** preservando la fuente original.
+   - Si no hay bloque → flujo limpio.
+
+2. **Capturar descripción** (1-3 líneas, debe mencionar que coordina N repos).
+
+3. **Capturar fuentes** (mínimo 2 en flujo limpio; ≥1 nueva en flujo "agregar"). Por cada una pedir solo:
+   - **Alias** kebab-case (único).
+   - **Path absoluto** al repo (validado: existe + es repo git).
+   - **Rama de trabajo actual** (default sugerido: `git -C <path> rev-parse --abbrev-ref HEAD`).
+   - **NO se pregunta la rama principal**: el CLI usa `certificacion` como default interno. Override con `--main-branch`.
+
+4. **Validaciones cross-fuente**:
+   - Aliases únicos.
+   - Paths absolutos y existentes (`os.path.isdir`).
+   - Cada path es repo git (`<path>/.git/` o `git -C <path> rev-parse`).
+   - Si la rama de trabajo declarada no coincide con la rama actual del repo → advertir (no bloquear).
+
+5. **Auto-detectar stack del CWD** (probablemente workspace base sin stack propio). Si no hay stack detectable, escribir `_Workspace base — stack heterogéneo (ver fuentes individuales)._`.
+
+6. **Persistir** vía:
+   ```
+   agent-workflow project-md-upsert --init \
+       --mode hub \
+       --proyecto "<descripción>" \
+       --fuente "alias1:path1" \
+       --fuente "alias2:path2" \
+       --working-branch "alias1:rama1" \
+       --working-branch "alias2:rama2"
+   ```
+
+7. **Reportar** archivos modificados, fuentes registradas, ramas de trabajo capturadas. Sugerir próximos pasos (`/agent-workflow:session "<objetivo>"` o configurar visibilidad multi-root del cliente — ver README de agent-workflow).
+
+## Visibilidad multi-root del cliente
+
+`/agent-workflow:hub-init` solo captura los datos en el bloque AW-PROJECT. Para que Claude Code o Codex CLI vean los paths de las fuentes como writable, configurarlos manualmente:
+
+- **Claude Code**: editar `~/.claude/settings.json` y agregar paths a `permissions.additionalDirectories`. Alternativa por sesión: `/add-dir <path>` por fuente.
+- **Codex CLI**: editar `~/.codex/config.toml` con `additional_writable_roots = [...]` y entradas `[projects."<path>"]` con `trust_level = "trusted"`.
+
+Snippets completos en el README de agent-workflow. Iteración futura podrá automatizarlo vía `/agent-workflow:hub-attach`.
+
+## Argumentos
+
+Sin argumentos: flujo interactivo.
+
+- `--proyecto "<texto>"`
+- `--fuente "alias:path[:rama]"` — repetible.
+- `--working-branch "alias:rama"` — repetible.
+- `--main-branch <rama>` — override del default `certificacion`.
+
+**Argumentos:** $ARGUMENTS
+
+## Skill asociada
+
+Ver `skills/hub-init/SKILL.md` para el detalle del flujo, validaciones cross-fuente y promoción project→hub.

package/skills/agent-workflow/commands/agent-workflow-migrate.md

@@ -0,0 +1,56 @@
+---
+description: Migra sesiones legacy de .claude/.codex/ a .workflow/, convierte proyectos pre-0.9 al formato actual, instalaciones pre-v0.12 al namespacing agent-workflow-*, upgrade v3.x→v4.0 (lifecycle universal) y upgrade hub-mode (≥2 fuentes sin marcador → Mode hub).
+argument-hint: "[--flow dev|design|analyze] [--rebuild-history] [--upgrade-topology] [--upgrade-v4] [--upgrade-hub-mode]"
+allowed-tools:
+  [
+    "Read",
+    "Write",
+    "Bash",
+    "Grep",
+    "Glob",
+  ]
+---
+
+# Migrate (agent-workflow)
+
+Migrar artefactos del workspace desde rutas y formatos legacy hacia la topología actual. Vive en agent-workflow (Fase B; antes en qtc-core v3.0+, previamente duplicado en cada flow plugin).
+
+## Modos
+
+- **Modo normal** (sin flags): detecta sesiones legacy en `.claude/`/`.codex/`, indicadores de topología pre-0.9, indicadores pre-v4.0 (lifecycle 5 fases), y workspace eligible para hub-mode (≥2 fuentes sin marcador). Pide confirmación por cada bloque de cambios.
+- `--flow dev|design|analyze`: enfoca el upgrade a un flow específico (afecta el destino del rename de carpetas legacy).
+- `--rebuild-history`: solo regenera `.workflow/HISTORY.md` leyendo las sesiones existentes y `docs/`.
+- `--upgrade-topology`: solo conversión al formato 0.8+ (OBJETIVO/AW-PROJECT/_archived).
+- `--upgrade-v4`: solo upgrade v3.x → v4.0 (mapeo de fases + CHECKPOINT.md inicial).
+- `--upgrade-hub-mode`: solo upgrade hub-mode (idempotente; delega a `agent-workflow upgrade-hub-mode`).
+
+Ejemplos:
+
+```
+/agent-workflow:migrate                              # detección completa + confirmación
+/agent-workflow:migrate --upgrade-hub-mode           # solo hub-mode
+/agent-workflow:migrate --upgrade-topology           # solo conversión al formato 0.8+
+/agent-workflow:migrate --rebuild-history            # regenera HISTORY.md
+```
+
+## Flujo
+
+Ver detalle completo en `skills/migrate/SKILL.md`. Resumen:
+
+1. **Detectar** — legacy paths, topología pre-0.9, fases v3.x, workspace eligible para hub-mode.
+2. **Informar y confirmar** — bloques de cambios separados, el usuario acepta cada uno.
+3. **Ejecutar** cada bloque aceptado.
+4. **Reportar** — resumen por bloque ejecutado.
+
+## Reglas
+
+- **Idempotente**: re-ejecutar es no-op para upgrades ya aplicados.
+- **Nunca sobreescribir** sesiones existentes.
+- **Nunca borrar automáticamente** `.claude/` ni `.codex/`: solo mover contenido del plugin.
+- **Siempre confirmar** antes de mutar.
+
+**Argumentos:** $ARGUMENTS
+
+## Skill asociada
+
+Ver `skills/migrate/SKILL.md` para el detalle completo (detección, procesos por upgrade, indicators, etc.).