@tacuchi/agent-workflow-cli 6.2.0 → 7.0.0

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.).

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

@@ -0,0 +1,60 @@
+---
+description: Inicializa el bloque AW-PROJECT en CLAUDE.md y AGENTS.md del proyecto con las 4 secciones gestionadas (Proyecto, Fuentes, Stack, Status). Para workspaces multi-repo usar `/agent-workflow:hub-init`.
+argument-hint: (opcional) --proyecto "descripción" | --fuente alias:path[:rama] | --main-branch <rama>
+allowed-tools:
+  [
+    "Read",
+    "Write",
+    "Bash",
+    "AskUserQuestion",
+  ]
+---
+
+# Project Init (agent-workflow)
+
+Inicializa o reinicia el bloque `<!-- AW-PROJECT-START -->` en `CLAUDE.md` y `AGENTS.md` del directorio actual. Ese bloque es la memoria permanente del proyecto: quién es, qué repos tiene, qué stack, qué sesiones hay activas.
+
+**Se ejecuta una vez por proyecto.** Después, `/agent-workflow:session` (en sus variantes: crear, retomar, cerrar) actualiza el bloque automáticamente vía `agent-workflow project-md-upsert`.
+
+> Este comando vive en agent-workflow (Fase B; antes en qtc-core v2.5+, previamente en qtc-dev). Es agnóstico al flow — no requiere tener qtc-dev instalado. Para workspaces que coordinan **múltiples repos** (≥2 fuentes), usar `/agent-workflow:hub-init` que valida cross-fuente y persiste el marcador `Mode: hub`.
+
+## Flujo
+
+1. Ejecutar `agent-workflow project-md-upsert --read` (lee con cache si está disponible).
+2. Si ya existe un bloque AW-PROJECT válido, mostrarlo al usuario y preguntar si quiere **reiniciarlo** (sobreescritura) o **abortar**.
+3. Si no existe:
+   - Pedir al usuario la descripción del proyecto (qué es + por qué existe) con `AskUserQuestion` o campo libre.
+   - Preguntar por la fuente afectada: `alias`, `path` local al repo. La rama principal default es `certificacion` (constante interna del CLI) salvo override con `--main-branch`.
+   - Si el usuario declara ≥2 fuentes en este flujo → sugerir cambiar a `/agent-workflow:hub-init` que está pensado para hub workspaces y captura ramas de trabajo cross-fuente.
+   - Auto-detectar el stack con `agent-workflow stack` — mostrarlo al usuario y confirmar antes de escribirlo.
+   - Invocar:
+     ```
+     agent-workflow project-md-upsert --init \
+         --mode project \
+         --proyecto "<descripción>" \
+         --fuente "alias:path"
+     ```
+4. Si existe bloque `<!-- QTC-WORKFLOW-START -->` legacy en los mismos archivos, avisar al usuario y recomendar ejecutar `/agent-workflow:migrate --upgrade-topology` antes de continuar. No borrar el legacy automáticamente.
+
+## Qué NO hace
+
+- No crea `.workflow/sessions/`. Eso es responsabilidad de `/agent-workflow:session <descripción>`.
+- No escribe en repos fuera del CWD — sólo en `CLAUDE.md` y `AGENTS.md` del directorio actual.
+- No ejecuta `git` ni valida ramas — eso lo hace `/agent-workflow:session` al crear/retomar.
+- No persiste `Mode: hub` (eso lo hace `/agent-workflow:hub-init`).
+
+## Argumentos
+
+Sin argumentos: flujo interactivo (pregunta todo).
+
+Con argumentos: no-interactivo cuando se pasan todos los datos.
+
+- `--proyecto "<texto>"` — descripción del proyecto.
+- `--fuente "alias:path[:rama]"` — declarar la fuente. Repetible (pero ≥2 sugiere `/hub-init`).
+- `--main-branch <rama>` — override del default `certificacion` (raro).
+
+**Argumentos:** $ARGUMENTS
+
+## Skill asociada
+
+Ver `skills/project-init/SKILL.md` para el detalle del flujo, validaciones y manejo de bloques pre-existentes.

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

@@ -0,0 +1,22 @@
+---
+description: Lee CHECKPOINT.md de la sesión activa y presenta resumen para retomar el trabajo. Fallback a session-resume base si no hay checkpoint.
+argument-hint: (sin args)
+allowed-tools:
+  [
+    "Bash",
+    "Read",
+  ]
+---
+
+# Resume — agent-workflow
+
+Invoca el skill `resume` (canónico de agent-workflow).
+
+## Acción
+
+1. Detectar sesión(es) activa(s) via `resume-summary`.
+2. Leer CHECKPOINT.md si existe; fallback a `session-resume`.
+3. Presentar resumen estructurado al usuario.
+4. Preguntar si continúa.
+
+Ver `skills/resume/SKILL.md` para detalles.

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

@@ -0,0 +1,40 @@
+---
+description: Bundle invokable de reglas transversales agent-workflow-* — carga los 7 anchors canónicos (commits, sandbox plan-mode, MCP read-only, redacción, coding-standards, graduación, branch verification) en un solo entry point. No requiere sesión activa.
+argument-hint: (sin args)
+allowed-tools:
+  [
+    "Read",
+  ]
+---
+
+# Rules — Reglas transversales agent-workflow-*
+
+Invoca el skill `rules` (canónico de agent-workflow).
+
+## Cuándo correrlo
+
+- Antes de un commit ad-hoc fuera de `/agent-workflow:session close` (para refrescar política).
+- Antes de editar código en una fuente agent-workflow-* sin sesión activa.
+- Antes de ejecutar una query vía MCP `<mcp-cert>`/`<mcp-prod>` (read-only canon).
+- Durante onboarding de un usuario nuevo a agent-workflow-*.
+- En conversaciones largas donde el contexto qtc se diluyó.
+
+## Qué carga
+
+Los 7 anchors canónicos del runtime agent-workflow-*:
+
+1. `agent-workflow:commits-policy` — formato y prohibiciones de commits.
+2. `agent-workflow:sandbox-readonly` — comportamiento en plan mode.
+3. `agent-workflow:mcp-readonly` — política SELECT-only para MCP.
+4. `agent-workflow:redaccion-simple` — estilo transversal para prosa agent-workflow-*.
+5. `agent-workflow:coding-standards` — estándares por stack + FE-BE R1-R6 + seguridad.
+6. `agent-workflow:graduacion-routing` — 6 kinds graduables + routing hub vs project.
+7. `agent-workflow:branch-verification` — gate de rama por fuente + hard gate cross-fuente.
+
+## Plan mode
+
+Read-only. Skill imprime el bundle sin ejecutar nada.
+
+## Recursos
+
+Ver `skills/rules/SKILL.md` para el contenido extendido de cada anchor.

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

@@ -0,0 +1,35 @@
+---
+description: Lifecycle universal de sesiones agent-workflow-* (4 fases: planning → execution → validation → closure). Crea, retoma, lista o cierra sesiones componiendo skills de especialidad según el OBJECTIVE.
+argument-hint: (sin args | <slug-objetivo> | sessionXXX | XXX | list | close)
+allowed-tools:
+  [
+    "Bash",
+    "Read",
+    "Write",
+    "Edit",
+    "Glob",
+    "Grep",
+  ]
+---
+
+# Session — Lifecycle universal agent-workflow-*
+
+Invoca el skill `session` (canónico de agent-workflow) con `$ARGUMENTS`.
+
+## Resolución de intención
+
+El skill evalúa `$ARGUMENTS` en orden:
+
+1. `close` → flujo de cierre.
+2. `list` → flujo de listado.
+3. Matchea `sessionXXX` o `XXX` (3 dígitos) → flujo de retomar.
+4. Texto descriptivo → flujo de crear (con prompts adicionales para slug + ramas).
+5. Sin args → escanear estado y proponer.
+
+## Plan mode
+
+Skill resuelve la intención normalmente y describe acciones en el plan file en lugar de ejecutarlas.
+
+## Recursos
+
+Ver `skills/session/SKILL.md` para el árbol de decisión completo y los recursos de referencia.

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

@@ -0,0 +1,15 @@
+# doctrine/
+
+Reglas universales del lifecycle que aplican siempre, agnóstico de empresa.
+
+Contenido esperado (T2 PR2):
+
+- `commits-policy.md` — propose-then-execute, M1, sin firmas auto, ≤72 chars.
+- `branch-verification.md` — gate de rama por fuente (casos A/B/C).
+- `redaccion-simple.md` — estilo de prosa para artefactos.
+- `sandbox-readonly-rules.md` — plan mode = sin mutaciones.
+- `mcp-readonly.md` — MCP SELECT/EXPLAIN sí, DDL/DML no.
+- `graduacion-routing.md` — defaults por kind + hub vs fuente.
+- `prompts-catalog.md` — M1/M10/S2/S3/S6/S7 prompts canónicos.
+
+Refs cruzadas (`[[name]]`) entre archivos permitidas. Léxico empresa-específico se inyecta vía `profile.lexicon_path`.