@tacuchi/agent-workflow-cli 11.0.0 → 12.0.0

package/skills/agent-workflow/SKILL.md

@@ -1,112 +0,0 @@
----
-name: agent-workflow
-description: Universal skill for the @tacuchi/agent-workflow-cli CLI. Teach Claude Code how to drive session-lifecycle workflows (planning → execution → validation → closure), history bookkeeping, source/branch checks, checkpoints, doctor, hooks, and self-management. Use whenever the user works with session-based development inside a workspace that hosts an `.agent-workflow/`, `.workflow/`, or equivalent namespace artifact tree.
-version: 1.2.0
----
-
-# agent-workflow — universal CLI skill
-
-`@tacuchi/agent-workflow-cli` is a generic, namespace-aware CLI that runs the canonical session-lifecycle workflow used by any plugin that opts into the same artifact contract.
-
-This skill teaches Claude Code:
-
-- when to invoke the CLI vs. handing the work to a slash command,
-- the 43 top-level subcommands grouped by family,
-- the namespace contract that lets the same binary serve multiple plugin ecosystems without forks.
-
-For each command family there is a dedicated reference under `references/`. Read the matching reference *before* invoking commands you have not used in the current conversation — flags and contracts evolve.
-
-## Invocation contract
-
-```
-agent-workflow [--namespace <name>] [--flow <core|dev|design|analyze>]
-               [--plugin-root <path>] [--plugin-version <semver>] [--compat <range>]
-               <command> [args...]
-```
-
-Short alias: `aw`.
-
-### Namespace resolution (highest precedence first)
-
-1. CLI flag `--namespace <name>`
-2. Env var `AW_NAMESPACE` (or `AGENT_WORKFLOW_NAMESPACE`)
-3. User config `~/.config/agent-workflow/namespace`
-4. Workspace auto-detect: `.<ns>/sessions/` directory in CWD
-5. Default literal: `agent-workflow`
-
-Plugins may reclaim a namespace from their SessionStart hook by writing it to `~/.config/agent-workflow/namespace`; the CLI then reads/writes `.<namespace>/`, `.<namespace>/sessions/`, and the `<NS>-PROJECT` block in `CLAUDE.md` / `AGENTS.md`.
-
-When you invoke the CLI from a fresh shell where no plugin has set the user-config, use `--namespace <name>` explicitly or run from inside a workspace whose `.<ns>/sessions/` dir is autodetected. The binary will otherwise operate on the default `agent-workflow` namespace.
-
-### Output contract
-
-Every command returns JSON on stdout (no decoration), exit code 0 on success and non-zero on error with a structured error envelope. Pipe to `jq` to extract fields.
-
-```bash
-agent-workflow sessions | jq '.next_number'
-agent-workflow objetivo-data --code session035 | jq '.criterios_aceptacion'
-```
-
-## When to invoke this CLI
-
-Invoke `agent-workflow` (directly or via the registered slash commands) whenever:
-
-- the user asks to **create / resume / close / list** sessions,
-- the user asks to **read or update** an artifact (`OBJETIVO.md`, `TASKS.md`, `DECISIONES.md`, `HISTORY.md`, `CHECKPOINT.md`),
-- you need to **detect workspace state** (sources, branches, mode, stack, harness),
-- a host hook (`PreToolUse`, `SessionEnd`, `PostCompact`) routes to the binary,
-- the user wants to **manage the CLI itself** (doctor / update / install-skill / namespace).
-
-Do *not* invoke the CLI for ad-hoc file edits, code refactors, business validation, or anything outside the session-lifecycle contract.
-
-## Command families
-
-The 43 top-level subcommands group into 11 families. Open the matching reference before composing a command.
-
-| Family | Reference | What lives there |
-|---|---|---|
-| Session management | [references/session-mgmt.md](references/session-mgmt.md) | sessions, session-create, session-resume, session-close, session-artifacts |
-| Objetivo / Tasks | [references/objetivo-tasks.md](references/objetivo-tasks.md) | objetivo-data, tasks-data, decisiones-list, dependencias-list |
-| History | [references/history.md](references/history.md) | history-data, history-update |
-| Checkpoint | [references/checkpoint.md](references/checkpoint.md) | checkpoint-read, checkpoint-write, compress-checkpoint, resume-summary, auto-compact-on-close |
-| Sources / branches | [references/sources.md](references/sources.md) | sources, check-branch, workspace-mode, project-md-upsert, upgrade-hub-mode, attach-multiroot, detach-multiroot |
-| Orchestration | [references/orchestration.md](references/orchestration.md) | auto-plan-decide, topic-change-check, specialty-choose, phase-detect, phase-next, stack, workflows, skill-index |
-| Doctor / release | [references/doctor.md](references/doctor.md) | plugin-doctor, code-scan, release-data, graduate |
-| Hooks | [references/hooks.md](references/hooks.md) | hook branch-check, hook sql-mutation-guard |
-| MCP / DSN | [references/mcp.md](references/mcp.md) | mcp dbhub, bootstrap-dsn |
-| Dev-only | [references/dev-only.md](references/dev-only.md) | harness, profiles, logs, next-number |
-| Self | [references/self.md](references/self.md) | self namespace, self doctor, self update, self install-skill |
-
-## Quick start cheatsheet
-
-```bash
-# Discover state
-agent-workflow sessions
-agent-workflow workspace-mode
-agent-workflow sources
-
-# Create + drive a session
-agent-workflow session-create --flow dev --name fix-login --objetivo "Bug: login redirect loop"
-agent-workflow session-resume --code session042
-agent-workflow tasks-data --code session042 --only-open
-agent-workflow checkpoint-write --code session042
-agent-workflow session-close --code session042
-
-# Diagnostics
-agent-workflow self doctor
-agent-workflow self namespace
-agent-workflow plugin-doctor --plugin-root /path/to/plugin
-```
-
-## Discovery rules
-
-1. If unsure which family a command belongs to, run `agent-workflow --help` (top-level) and pick the family from the table above.
-2. If unsure about flags, read the corresponding `references/*.md`. The references list every supported flag with example payloads.
-3. If a command returns `error.code = "NOT_IN_WORKSPACE"`, the namespace points at a filesystem tree that does not exist — re-check `--namespace` / env, or run `self namespace` to see the resolved value.
-
-## Cross-references
-
-- CLI repo: <https://github.com/Tacuchi/agent-workflow-cli>
-- npm: <https://www.npmjs.com/package/@tacuchi/agent-workflow-cli>
-- This skill is bundled in the CLI tarball — no standalone repo. `agent-workflow self install-skill` copies it from the bundled location to `~/.claude/skills/agent-workflow/`.
-- Install: `npm i -g @tacuchi/agent-workflow-cli && agent-workflow self install-skill`

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

@@ -1,26 +0,0 @@
-# commands/
-
-Slash commands `/agent-workflow:*` registrables por el host (Claude Code, Codex, Warp, OZ).
-
-Contenido esperado (T2 PR2):
-
-- `session.md` — entry point unificado: create / resume / close / list.
-- `resume.md` — atajo a session resume.
-- `export-plan.md` … `export-diagrams.md` — 7 comandos export-*.
-- `rules.md` — carga doctrine/* on-demand.
-- `migrate.md` — migración inter-empresa via `profile.migrate_legacy_rules[]`.
-- `doctor.md` — diagnóstico end-to-end.
-- `project-init.md` / `hub-init.md` — inicializadores de workspace.
-
-Naming final: `/agent-workflow:<comando>` (decidido en D1 session082). Los aliases legacy de empresas existentes (e.g., `/qtc:*` en el caso de QTC) viven en el plugin hijo de la empresa correspondiente bajo `legacy-aliases/` por 2 sprints después del cutover (T5 del plan migración).
-
-Estado post-v7.0.1 (T7 hotfix): 17 commands con nombre canónico sin prefijo (el namespace del plugin "agent-workflow" lo provee). Invocación: `/agent-workflow:<filename>` (ej. `/agent-workflow:session`). Lista actual:
-
-- `session.md`, `compact.md`, `resume.md`
-- `export-plan.md`, `export-scripts.md`, `export-conclusions.md`
-- `export-report.md`, `export-arq.md`, `export-tech-manuals.md`
-- `export-qa-note.md`, `export-requirement.md`, `export-tech-note.md`
-- `project-init.md`, `hub-init.md`, `doctor.md`
-- `migrate.md`, `rules.md`
-
-**Distribución como slash commands**: el repo `agent-workflow-cli` expone `.claude-plugin/plugin.json` en la raíz declarando este directorio como `commands` slot. El plugin se publica via `qtc-plugins-marketplace` (entry `agent-workflow`). `self install --target <host>` instala el SKILL pero NO registra los slash commands — el plugin debe instalarse por separado via `/plugin install agent-workflow@<marketplace>`.

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

@@ -1,24 +0,0 @@
----
-description: Persiste estado de la sesión activa en CHECKPOINT.md y dispara /compact host. Combina auto-extracción + síntesis del AI para preservar contexto antes de liberar tokens.
-argument-hint: (sin args)
-allowed-tools:
-  [
-    "Bash",
-    "Read",
-    "Write",
-    "Edit",
-  ]
----
-
-# Compact — agent-workflow
-
-Invoca el skill `compact` (canónico de agent-workflow).
-
-## Acción
-
-1. Detectar sesión activa via `project-md-upsert --read`.
-2. Escribir draft auto-extraído con `checkpoint-write`.
-3. Completar placeholders sintéticos editando CHECKPOINT.md.
-4. Disparar `/compact` host (excepto si el trigger fue SessionEnd hook).
-
-Ver `skills/compact/SKILL.md` para detalles.

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

@@ -1,100 +0,0 @@
----
-description: Health check de plugins agent-workflow-* (core/dev/design/analyze). Solo lectura. Default scope=all en hub mode; cwd en single-repo.
-argument-hint: (opcional) --scope <core|dev|design|analyze|all> [--plugin-root PATH]
-allowed-tools:
-  [
-    "Bash",
-    "Read",
-  ]
----
-
-# Doctor — agent-workflow-* Health Check (orchestrator desde core)
-
-Diagnostica el estado de uno o varios plugins de la familia `agent-workflow-*`. El runtime CLI (`@tacuchi/agent-workflow-cli`) corre los checks por plugin; este comando los orquesta.
-
-## Argumentos
-
-- `--scope <alias|all>` (default: `all` en hub mode; `cwd` en single-repo) — qué plugin chequear.
-  - `core` → `core-workflow-plugin`.
-  - `dev` → `developer-workflow-plugin`.
-  - `design` → `design-workflow-plugin`.
-  - `analyze` → `analyze-workflow-plugin`.
-  - `all` → los 4 plugins de la familia (resueltos desde `agent-workflow sources`).
-- `--plugin-root PATH` (opcional, sin `--scope`) — checkear el plugin en `PATH` directamente. Útil para single-repo.
-
-Default: si `agent-workflow workspace-mode` retorna `hub` → `--scope all`. Sino → `--scope cwd` (alias del plugin del cwd).
-
-## Qué verifica (por plugin, vía `agent-workflow plugin-doctor --plugin-root <path>`)
-
-1. **CLI presente**: `agent-workflow --version` responde correctamente.
-2. **Manifests**: `.claude-plugin/plugin.json` y `.codex-plugin/plugin.json` existen y la versión coincide entre ambos.
-3. **Hooks**: `hooks/hooks.json` y `codex-hooks/hooks.json` parsean como JSON válido y los `command` apuntan al CLI (`agent-workflow ...`) — no a scripts Python locales.
-4. **Skills**: el directorio `skills/` existe; cada subdir tiene un `SKILL.md` con frontmatter completo (`name`, `description`, `version` semver) y `name` coincide con directorio.
-5. **MCP config** (si aplica): `.mcp.json` válido y env vars del DSN seteadas (solo si el profile activo define `mcp_databases[]`).
-6. **runtime.json instalado** (agent-workflow only): `~/.workflow/agent-workflow/runtime.json` existe y matchea `config/agent-workflow-runtime.json`.
-
-## Qué NO verifica (post-v6.3)
-
-- Versiones del CLI vs plugin: el CLI se actualiza independiente.
-- Existencia de scripts Python o `qtc_core/`: la familia migró a single-path npm en session032.
-
-## Ejecución por scope
-
-### `--scope all` (hub mode)
-
-1. `agent-workflow sources` → leer `sources[]`.
-2. Filtrar por alias que termine en `-workflow-plugin` (los 4 plugins de la familia).
-3. Por cada uno: `agent-workflow plugin-doctor --plugin-root <path>`. Capturar `status`, `plugin_version`, `manifests`, `errors`/`warnings` (si los expone).
-4. Agregar resultados en una tabla compacta:
-
-   ```
-   plugin                       version    status   findings
-   ──────────────────────────   ────────   ──────   ────────
-   core-workflow-plugin         3.29.0     ok       —
-   developer-workflow-plugin    2.7.0      ok       —
-   design-workflow-plugin       1.4.0      ok       —
-   analyze-workflow-plugin      1.5.0      warn     SKILL.md sin version
-   ```
-
-5. Resumen final: `<N>/4 plugins ok` o lista de los con findings.
-
-**Si `agent-workflow` aparece en sources** (post-Fase B de la Propuesta 002): incluirlo también, mapping `qtc` → `agent-workflow`. Hasta que tenga manifest, el plugin-doctor reportará error informativo y queda flaggeado en la tabla.
-
-### `--scope <alias>`
-
-1. Resolver alias → path:
-   - Si hub mode: leer `agent-workflow sources` y matchear el alias correspondiente al `<alias>-workflow-plugin` (excepto `dev` → `developer-workflow-plugin`).
-   - Si single-repo: error con mensaje claro ("scope `<alias>` requiere hub mode; usá `--plugin-root PATH` o cambia al cwd del plugin").
-2. `agent-workflow plugin-doctor --plugin-root <path>`.
-3. Mostrar resultado completo (todos los campos del JSON de plugin-doctor).
-
-### Sin `--scope`, sin `--plugin-root` (default)
-
-1. `agent-workflow workspace-mode` → si `hub` → comportarse como `--scope all`.
-2. Sino → comportarse como `--plugin-root <cwd>` (single-repo, plugin actual).
-
-### `--plugin-root PATH` (sin `--scope`)
-
-1. `agent-workflow plugin-doctor --plugin-root <PATH>`.
-2. Mostrar resultado completo.
-
-## Interpretación
-
-1. **Resumen por plugin** según `status`:
-   - `ok` → "saludable" + versión del manifest.
-   - `warn` → resumen de findings (ej. SKILL.md sin frontmatter).
-   - `error` → resumen de findings críticos (ej. CLI no encontrado, manifest corrupto).
-2. **Resumen global** (scope=all):
-   - "Familia agent-workflow-* saludable" si todos `ok`.
-   - "<N> plugin(s) con findings: <lista>" si alguno warn/error.
-
-## Accionables típicos
-
-- `agent-workflow CLI not found in PATH` → `npm install -g @tacuchi/agent-workflow-cli`.
-- `manifest version mismatch claude vs codex` → editar el plugin.json y bump coordinado.
-- `runtime.json missing` (agent-workflow) → reload Claude Code/Codex (SessionStart hook lo escribe).
-- `<plugin> sin manifest` (post-Fase A pre-B en `agent-workflow`) → esperar Fase B (migración de skeletons) antes de incluir en checks.
-
-## Plan mode
-
-Read-only. En plan mode el comando solo describe los checks que correría sin invocar `agent-workflow plugin-doctor` ni `agent-workflow sources`.

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

@@ -1,77 +0,0 @@
----
-description: Genera documentación técnica de arquitectura (`.md` con diagramas C4 embebidos) consolidando sesiones del workspace + `docs/` (arq, especificaciones, decisiones): contexto, contenedores, componentes, integraciones, modelo de datos (si MCP), decisiones arquitectónicas y riesgos. Structurizr default; Mermaid y PlantUML opt-in. Read-only.
-argument-hint: (opcional) --since sessionNNN | --source <alias> | --diagrams mermaid|structurizr|plantuml | --scope c4|integraciones|datos|decisiones|riesgos|todo | --dry-run
-allowed-tools:
-  [
-    "Read",
-    "Write",
-    "Bash",
-    "Grep",
-    "Glob",
-  ]
----
-
-# Export Arq
-
-Genera documentación técnica de arquitectura del workspace agregando fuentes declaradas + corpus de sesiones + MCP read-only cuando aplique. Delega al skill `export-arq` (`agent-workflow/skills/export-arq/SKILL.md`).
-
-El skill **nunca** ejecuta commits, merges, push, SQL ni envía correos. Solo produce:
-
-- `<docs>/arquitectura/NNN-export-arq-YYYY-MM-DD/arquitectura.md` — documento principal con Mermaid embebido.
-- `<docs>/arquitectura/NNN-export-arq-YYYY-MM-DD/workspace.dsl` — opcional (`--diagrams structurizr`).
-- `<docs>/arquitectura/NNN-export-arq-YYYY-MM-DD/arquitectura.puml` — opcional (`--diagrams plantuml`).
-- `<docs>/arquitectura/NNN-export-arq-YYYY-MM-DD/README.md` — índice del dossier.
-
-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.
-
-Segundo 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-func`) requiere conocimiento del lifecycle pero las consume solo via CLI `agent-workflow`. No lee paths hardcodeados.
-
-**Audiencia**: devs/arquitectos. Sin léxico ejecutivo (a diferencia de `/agent-workflow:export-func`). Términos técnicos del dominio (propuesta, MCP, C4, hook, skill) están autorizados.
-
-**Argumentos:** $ARGUMENTS
-
-### Argumentos soportados
-
-- `--since sessionNNN` — filtra **sólo** la sección "Decisiones arquitectónicas". El snapshot del sistema vigente no se filtra.
-- `--source <alias>` — en hub mode, limita el output a una sola fuente y sus integraciones internas.
-- `--diagrams mermaid|structurizr|plantuml` — motor del render de C4 (default: `mermaid`).
-- `--scope c4|integraciones|datos|decisiones|riesgos|todo` — qué secciones aparecen (default: `todo`).
-- `--dry-run` — no escribir; reportar lo que se generaría.
-
-Matriz completa y reglas en `skills/export-arq/SKILL.md` §"Entrada".
-
-## Flujo
-
-Antes de generar, el skill llama al CLI `agent-workflow`:
-
-```
-agent-workflow project-md-upsert --read           # workspace_mode, fuentes, integraciones declaradas
-agent-workflow history-data                       # sesiones cerradas
-agent-workflow decisiones-list --code <CODE>      # DEC-NNN cronológicas
-agent-workflow next-number docs/arquitectura      # numeración determinística
-```
-
-Si `--scope` incluye `datos` y MCP `<mcp-cert>`/`<mcp-prod>` está configurado: consulta esquemas BD (`SELECT count(*)`, `\d`, `EXPLAIN`) respetando cost guard. Si MCP no disponible: sección "Modelo de datos" aparece con nota inline explícita (Patrón B de V4.a).
-
-Luego renderiza `references/template-c4.md` aplicando léxico técnico mínimo + Mermaid C4 embebido (o Structurizr/PlantUML opt-in). Valida 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 de diagrama + scope resuelto, fuentes a inspeccionar + integraciones declaradas, MCP queries propuestas (si `--scope datos`), hallazgos de V4 (Modelo de datos presente/omitido por MCP, Decisiones presente/omitido por count), warnings esperados (V5/V6).
-
-## Recursos
-
-- `skills/export-arq/SKILL.md` v1.0.0 — orquestador del comando.
-- `skills/export-arq/references/template-c4.md` — plantilla canónica (Mermaid).
-- `skills/export-arq/references/template-structurizr.dsl` — variante DSL opt-in.
-- `skills/export-arq/references/template-plantuml.puml` — variante PUML opt-in.
-- `skills/export-arq/references/lexico-tecnico.md` — léxico técnico mínimo + lista vetada V2.
-- `skills/export-arq/references/validations.md` — V1-V6 detalladas (3 patrones de V4.a).
-- `docs/conclusiones/007-export-commands-family.md` — Propuesta original de la familia `/agent-workflow:export-*`.
-- `agent-workflow/skills/export-func/SKILL.md` — hermano (informe ejecutivo).

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

@@ -1,78 +0,0 @@
----
-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/export-plan.md

@@ -1,74 +0,0 @@
----
-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/export-qa-note.md

@@ -1,30 +0,0 @@
----
-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/export-report.md

@@ -1,78 +0,0 @@
----
-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/export-requirement.md

@@ -1,30 +0,0 @@
----
-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).