@tacuchi/agent-workflow-cli 11.0.1 → 12.0.0

package/skills/agent-workflow/doctrine/session/references/prompts/M1-closure-commit-prompt.md

@@ -1,104 +0,0 @@
-# M1 — commit-prompt universal (CASO ANCLA)
-
-Spec literal del prompt M1. Index: [`../prompts-catalog.md#m1--commit-prompt-universal--caso-ancla`](../prompts-catalog.md#m1--commit-prompt-universal--caso-ancla).
-
-> **Nota de filename**: el archivo se llama `M1-closure-commit-prompt.md` por origen histórico (M1 nació en closure de `/agent-workflow:session`). El alcance canónico **ya no es exclusivo del closure**: ver `commits-policy.md` Regla 3 (universal). El nombre se conserva para no romper anchors ni cross-refs (DD-2 de session075).
-
-## Cuándo se dispara
-
-El AI invoca M1 ante **cualquiera** de estos 3 disparadores canónicos. La condición común: el usuario quiere/menciona un commit como acción a ejecutar y no aporta el mensaje literal en la solicitud (si lo aporta, ver Edge cases — Regla 5 bypass).
-
-1. **Closure de `/agent-workflow:session`** (auto): antes de `session-close`, el skill `session` ejecuta `agent-workflow sources --session <CODE>` y dispara M1 si hay 1+ fuentes `dirty=true`. Documentado en `skills/session/SKILL.md` §"Cerrar sesión — 2. Proponer commits".
-2. **Solicitud explícita con sesión activa** (planning/execution): el usuario dice "commitea esto", "guardá los cambios", "subí lo nuevo" sin mensaje literal. El AI ejecuta `agent-workflow sources --session <CODE>` y dispara M1 igual que en closure. El mensaje sugerido incluye tag `session<NNN>`.
-3. **Solicitud explícita sin sesión activa**: el usuario pide commit en una fuente agent-workflow (hub o project) que no tiene sesión registrada en `AW-PROJECT.Status.Sesiones activas`. El AI ejecuta `agent-workflow sources` (sin `--session`) y dispara M1. El mensaje sugerido **omite** el tag `session<NNN>`.
-
-## Forma
-
-- **1 invocación** con N questions tab-por-fuente (N = #fuentes-dirty, max 4 simultáneas).
-- En project mode con 1 fuente → N=1 question.
-- En hub mode con N fuentes dirty (típico 1-3) → N questions tab-por-fuente.
-- Por question:
-  - `header`: `<alias>` puro (ej. `core`, `dev`, `design`, `analyze`, `marketplace`).
-  - `question`: "¿Cómo commiteás los cambios en `<alias>`?"
-  - `multiSelect`: false.
-  - `options`:
-    1. `label`: "Aprobar sugerido (Recomendado)" — `description`: el mensaje canónico siguiendo `commits-policy.md` Regla 2 (1 línea, ≤72 chars, tag `session<CODE>` si hay sesión activa, sin co-author).
-    2. `label`: "Saltar esta fuente" — `description`: "No commitear ahora; los archivos quedan dirty para una decisión posterior."
-  - **Other auto-inyectado** = el usuario escribe el mensaje custom. Se ejecuta el commit con ese mensaje (validando Regla 2 — ver Edge cases).
-- **Si N > 4 fuentes dirty** (caso excepcional): ejecutar en tandas. Primera tanda cubre fuentes 1-4, segunda 5+. Registrar parcial en `CHECKPOINT.md` (si hay sesión activa) o avisar al usuario por chat entre tandas.
-- **Si fuente tiene `match=false`**: omitir esa fuente del prompt (abortar commit ahí, avisar al usuario y dejar que alinee la rama primero — coherente con `commits-policy.md` Regla 3 paso 4).
-- **Si N=0** (todas las fuentes limpias): skip silencioso, no invocar `AskUserQuestion`. Avisar al usuario: "No hay nada que commitear; todas las fuentes están limpias."
-
-## Edge cases
-
-### Bypass por mensaje literal (Regla 5 de commits-policy)
-
-Si el usuario aporta el mensaje exacto en la solicitud (`"commitea con mensaje 'X'"`, `"commit -m 'X'"`, `"--message <X>"`), el AI ejecuta `git commit -m "<X>"` directo, sin invocar M1. El bypass aplica por fuente (el usuario puede aportar mensaje literal sólo para 1 fuente; las demás dirty siguen el flujo M1 normal).
-
-Si el mensaje literal viola Regla 2 (multi-línea, co-author, etc.), el AI avisa antes de ejecutar y pide confirmación. No reescribe silenciosamente.
-
-### Workspace no agent-workflow (sin AW-PROJECT)
-
-`agent-workflow sources` falla → no hay fuentes que enumerar. El AI cae al flujo simple: sugiere 1-line msg en chat, espera confirmación, ejecuta. No invoca M1.
-
-### Workspace hub con cambios en el workspace mismo (no en fuentes declaradas)
-
-El AI **no** los commitea por iniciativa. M1 sólo opera sobre las fuentes declaradas en `AW-PROJECT.Fuentes`. Cambios en `.workflow/HISTORY.md`, `CLAUDE.md`, `AGENTS.md` o sesiones del hub workspace no entran al prompt salvo solicitud explícita del usuario.
-
-### Single source en hub mode (caso transitorio)
-
-Aunque el workspace sea hub, si sólo 1 fuente tiene `dirty=true` el prompt es N=1 question. Sigue siendo M1 (la spec no asume "≥2 questions"). Reduce ruido visual y mantiene la UX consistente con project mode.
-
-## Ejemplo concreto — closure con 2 fuentes dirty
-
-```
-AskUserQuestion({
-  questions: [
-    {
-      header: "core",
-      question: "¿Cómo commiteás los cambios en `core`?",
-      multiSelect: false,
-      options: [
-        { label: "Aprobar sugerido (Recomendado)",
-          description: "session010: agrega prompts-catalog y refactor closure tab-por-fuente" },
-        { label: "Saltar esta fuente",
-          description: "No commitear ahora; los archivos quedan dirty para una decisión posterior." }
-      ]
-    },
-    {
-      header: "analyze",
-      question: "¿Cómo commiteás los cambios en `analyze`?",
-      multiSelect: false,
-      options: [
-        { label: "Aprobar sugerido (Recomendado)",
-          description: "session010: M5 modalidad analyze con AskUserQuestion explícito" },
-        { label: "Saltar esta fuente",
-          description: "No commitear ahora; los archivos quedan dirty para una decisión posterior." }
-      ]
-    }
-  ]
-})
-```
-
-## Ejemplo concreto — solicitud explícita sin sesión activa
-
-Usuario: "commitea los cambios que hay en agent-workflow".
-
-```
-AskUserQuestion({
-  questions: [
-    {
-      header: "agent-workflow",
-      question: "¿Cómo commiteás los cambios en `agent-workflow`?",
-      multiSelect: false,
-      options: [
-        { label: "Aprobar sugerido (Recomendado)",
-          description: "fix: drift en hooks.json del CLI"  // sin tag session<NNN>
-        },
-        { label: "Saltar esta fuente",
-          description: "No commitear ahora; los archivos quedan dirty para una decisión posterior." }
-      ]
-    }
-  ]
-})
-```

package/skills/agent-workflow/doctrine/session/references/prompts/M10-next-step.md

@@ -1,17 +0,0 @@
-# M10 — next-step (cierre de planning)
-
-Spec literal del prompt M10. Index: [`../prompts-catalog.md#m10--next-step-cierre-de-planning`](../prompts-catalog.md#m10--next-step-cierre-de-planning).
-
-- **Cuándo**: en `skills/session/SKILL.md`, al cierre de la fase `planning` después de TASKS.md producido y antes de iniciar `execution`. Solo si TASKS.md tiene ≥1 task abierta.
-- **Forma**: 1 question.
-  - `header`: `next-step`.
-  - `question`: "Plan listo. ¿Cómo arrancamos execution?"
-  - `multiSelect`: false.
-  - `options`:
-    1. "Ejecutar todo end-to-end" — "Loop sobre tasks; pausa solo si M6 phase-gate u otro must se dispara."
-    2. "T1+T2 en paralelo" — "Dispara las 2 primeras tareas independientes en agentes paralelos; consolida outputs antes de seguir."
-    3. "Una task por vez, confirmá cada cierre" — "Loop con pausa explícita post-task."
-  - **Other auto** = instrucción custom (ej. "primero T3, después el resto").
-- **Recomendación dinámica**: el AI marca `(Recomendado)` en opción 1 si `tasks_count ≤5 ∧ eta_total ≤4h` (estima por TASKS.md: S=0.5h, M=2h, L=4h). Caso contrario, marca opción 2.
-- **Si TASKS.md está vacío o ausente**: skip M10 con error informativo ("Plan ausente; arrancá execution con `agent-workflow phase-next` o regenerá TASKS.md").
-- **Refina**: nueva sección "Cierre de planning" en `skills/session/SKILL.md`.

package/skills/agent-workflow/doctrine/session/references/prompts/M11-context.md

@@ -1,16 +0,0 @@
-# M11 — context (auto-trigger por carga de contexto)
-
-Spec literal del prompt M11. Index: [`../prompts-catalog.md#m11--context-auto-trigger-por-carga-de-contexto`](../prompts-catalog.md#m11--context-auto-trigger-por-carga-de-contexto).
-
-- **Cuándo**: en `skills/compact/SKILL.md`, cuando el AI estima carga de contexto >75% del modelo activo (heurística manual; no medición exacta de tokens). Early warning antes de truncamiento de tool calls.
-- **Forma**: 1 question.
-  - `header`: `context`.
-  - `question`: "El contexto está al ~`<%>%`. ¿Compact ahora o seguimos?"
-  - `multiSelect`: false.
-  - `options`:
-    1. "Compact ahora (Recomendado)" — "Persiste estado en CHECKPOINT.md y dispara `/compact`. El loop continúa post-compact con la sesión retomada."
-    2. "Seguir, compact después" — "Continúa la tarea actual; intenta compact en próxima pausa natural (entre tasks)."
-    3. "Cerrar sesión" — "Pasa a `closure`; útil si la tarea actual ya cumplió el OBJECTIVE."
-  - **Other auto** = instrucción custom (ej. "compact + cerrá sesión").
-- **Si la sesión está en `closure` activa**: skip M11 (closure ya dispara su propio compact opcional).
-- **Refina**: nueva sección "Auto-trigger por contexto" en `skills/compact/SKILL.md`.

package/skills/agent-workflow/doctrine/session/references/prompts/M13-closure-cleanup.md

@@ -1,61 +0,0 @@
-# M13 — closure-cleanup (gate de calidad pre-commit en closure)
-
-Spec literal del prompt M13. Index: [`../prompts-catalog.md#m13--closure-cleanup-gate-de-calidad-pre-commit-en-closure`](../prompts-catalog.md#m13--closure-cleanup-gate-de-calidad-pre-commit-en-closure).
-
-- **Cuándo**: en `skills/session/SKILL.md` §1.5 "Inspección y limpieza pre-commit", tras graduate (paso 1) y antes de propose commits (M1 / paso 2). Auto-disparado por closure cuando se cumple **ambas** condiciones:
-  - ≥1 fuente declarada en la sesión tiene `dirty=true` (`agent-workflow sources --session <CODE>`).
-  - La inspección del diff produce ≥1 hallazgo en alguna de las 5 categorías canónicas.
-- **Skip silencioso**:
-  - Todas las fuentes `dirty=false` (nada que limpiar).
-  - Inspección no encuentra hallazgos en ninguna fuente (working tree ya limpio).
-  - Plan mode activo (el gate describe hallazgos en el plan file sin disparar prompt).
-- **Forma**: 1 invocación `AskUserQuestion` con **N questions tab-por-fuente** (max 4 simultáneas; tandas si N>4).
-  - Por cada fuente dirty con hallazgos:
-    - `header`: `<alias>` (ej. `core`, `dev`, `design`, `analyze`).
-    - `question`: "Cleanup en `<alias>` — `<N>` hallazgos (`<categorías>`). ¿Aplico?"
-    - `multiSelect`: false.
-    - `options`:
-      1. "Aprobar fixes sugeridos (Recomendado)" — "El AI aplica los edits acotados al working tree (`Edit`/`MultiEdit` por archivo, diff visible). Cada fix local y reversible."
-      2. "Sólo reportar (no tocar)" — "Deja los hallazgos en `CHECKPOINT.md` como 'Hallazgos pendientes' sin modificar working tree."
-      3. "Saltar esta fuente" — "Ignora los hallazgos para esta closure. No se registra."
-    - **Other auto** = nota custom del usuario (ej. "fixeo manual después", "ignorá X específico", "aplicá sólo categoría comentarios"). El AI interpreta y actúa en consecuencia.
-- **Preview (opcional pero recomendado)**: cuando hallazgos > 5 por fuente, incluir preview ASCII con resumen:
-
-  ```
-  Cleanup report — <alias>
-  ────────────────────────
-  Comentarios redundantes:  3 hallazgos
-  Complejidad cognitiva:    1 hallazgo
-  Antipatrones:             2 hallazgos
-  Code smells:              0
-  Código muerto:            1 hallazgo
-
-  Top fixes sugeridos:
-    1. src/foo.ts:42 — quitar `// TODO obvio` huérfano
-    2. src/bar.ts:88 — extraer helper de método 80-líneas
-    3. src/baz.ts:15 — reemplazar magic number 86400 con const
-  ```
-
-- **Aplicación de los fixes (opción 1)**:
-  - Por archivo: leer (`Read`), aplicar `Edit` o `MultiEdit` con cambios acotados. Mostrar diff antes/después al usuario.
-  - Refactor estructural mayor (mover archivos, renombrar packages, cambios cross-paquete): NO aplica aquí — aplazar a sesión `## Type: refactor` con Strangler Fig.
-  - Tras aplicar todos los fixes de una fuente: re-ejecutar `agent-workflow sources --session <CODE> --scope <alias>` para validar consistencia.
-- **Sin auto-confirmación**: aunque opción 1 esté marcada `(Recomendado)`, requiere selección explícita del usuario por fuente. NO se asume auto-correct.
-- **Sandbox plan-mode**:
-  - Describir hallazgos por categoría en el plan file (paths + razones). 
-  - NO ejecuta `Edit`/`Write`/`Bash` mutante.
-  - M13 no se dispara; el reporte queda en plan file para que el usuario decida fuera de plan mode.
-- **Categorías canónicas** (referencia, detalles en `session/SKILL.md` §1.5):
-  1. **Comentarios redundantes** — qué obvio, código muerto comentado, TODO sin owner/fecha, headers decorativos.
-  2. **Complejidad cognitiva** — métodos largos (>50 líneas), nesting profundo (>3), early-return ausente, condicionales anidados.
-  3. **Antipatrones** — `catchError(() => of([]))`, magic numbers, side effects no declarados, god class/method, lógica replicada FE+BE.
-  4. **Code smells** — DRY violado, naming oscuro, duplicación con `shared/`/`common/`, validación post-uso, mutación de parámetros.
-  5. **Código muerto** — imports sin usar, branches inalcanzables, variables huérfanas, funciones no llamadas.
-- **Composición**:
-  - `agent-workflow:coding-standards` — fuente de verdad de qué es "bien" por stack (anchor #5 del bundle /rules).
-  - `agent-workflow:redaccion-simple` — formato del reporte breve (anchor #4 del bundle /rules).
-- **Anti-narración**: NUNCA narrar la pregunta en texto plano ("¿quieres que aplique los fixes en agent-workflow?" en chat es un anti-patrón). Siempre vía `AskUserQuestion`.
-- **Refs**:
-  - `skills/session/SKILL.md` §1.5 — pipeline canónica del gate.
-  - `skills/rules/SKILL.md` §8 (`agent-workflow:closure-cleanup`) — anchor en bundle /rules.
-  - `skills/coding-standards/SKILL.md` — reglas por stack que el gate consulta.

package/skills/agent-workflow/doctrine/session/references/prompts/M2-branch-caso-A.md

@@ -1,14 +0,0 @@
-# M2 — branch-caso-A (rama distinta, repo limpio)
-
-Spec literal del prompt M2. Index: [`../prompts-catalog.md#m2--branch-caso-a-rama-distinta-repo-limpio`](../prompts-catalog.md#m2--branch-caso-a-rama-distinta-repo-limpio).
-
-- **Cuándo**: una fuente tiene `match=false` y `dirty=false`.
-- **Forma**: 1 question.
-  - `header`: `branch:<alias>` (ej. `branch:core`).
-  - `question`: "La fuente `<alias>` está en `<current>` pero esperaba `<expected>`. ¿Qué hago?"
-  - `multiSelect`: false.
-  - `options`:
-    1. "Hacer checkout (Recomendado)" — "Ejecuta `git -C <path> checkout <expected>` y reintenta la acción."
-    2. "Mantener current" — "Actualiza la sesión con `project-md-upsert --update-phase --branches <alias>:<current>` para que `<current>` sea la rama esperada."
-    3. "Cancelar" — "Aborta la acción que disparó el check."
-- **Detalles operacionales** en `branch-verification.md` Caso A.

package/skills/agent-workflow/doctrine/session/references/prompts/M3-branch-caso-C.md

@@ -1,33 +0,0 @@
-# M3 — branch-caso-C (analyze pasa a editar)
-
-Spec literal del prompt M3. Index: [`../prompts-catalog.md#m3--branch-caso-c-analyze-pasa-a-editar`](../prompts-catalog.md#m3--branch-caso-c-analyze-pasa-a-editar).
-
-- **Cuándo**: durante `execution` de una sesión `flow=analyze`, el usuario decide editar código.
-- **Forma**: 2 prompts encadenados.
-
-**Prompt 1 — nombre de rama de trabajo**:
-- `header`: `work-branch`.
-- `question`: "¿Cómo se llama la rama de trabajo para `<alias>`?"
-- `multiSelect`: false.
-- `options`:
-  1. "Usar `feature/session<NNN>-<slug>` (Recomendado)" — "Sugerencia por convención."
-  2. "Otra (escribir abajo)" — "Use el campo libre debajo para especificar otro nombre."
-- **Other auto** = el usuario escribe el nombre alternativo de la rama.
-
-**Prompt 2 — checkout o create**:
-
-Si `git -C <path> rev-parse --verify <work_branch>` exit 0 (rama existe):
-- `header`: `checkout`.
-- `question`: "La rama `<work_branch>` existe en `<alias>`. ¿Hago `git checkout`?"
-- `options`:
-  1. "Sí, checkout (Recomendado)".
-  2. "Cancelar".
-
-Si exit ≠ 0 (no existe):
-- `header`: `branch-new`.
-- `question`: "La rama `<work_branch>` no existe en `<alias>`. ¿La creo desde `<main_branch>`?"
-- `options`:
-  1. "Sí, `checkout -b <work_branch> <main_branch>` (Recomendado)".
-  2. "Cancelar".
-
-Tras el checkout/create, registrar en AW-PROJECT.Status vía `project-md-upsert --update-phase <folder> --branches <alias>:<work_branch>`. Detalles en `branch-verification.md` Caso C.

package/skills/agent-workflow/doctrine/session/references/prompts/M4-cross-source-hard-gate.md

@@ -1,33 +0,0 @@
-# M4 — cross-source-hard-gate (hub mode con divergencia)
-
-Spec literal del prompt M4. Index: [`../prompts-catalog.md#m4--cross-source-hard-gate-hub-mode-con-divergencia`](../prompts-catalog.md#m4--cross-source-hard-gate-hub-mode-con-divergencia).
-
-- **Cuándo**: workspace `Mode: hub` y `cross_source_consistent=false` reportado por `agent-workflow sources`.
-- **Forma**: 1 question + (si elige alinear) prompt encadenado.
-
-**Prompt 1**:
-- `header`: `cross-branch`.
-- `question`: "Las fuentes apuntan a ramas distintas. ¿Cómo resolvés?"
-- `multiSelect`: false.
-- `options`:
-  1. "Alinear todas a una misma rama (Recomendado)" — "Preguntará cuál rama y aplicará Caso A por fuente divergente."
-  2. "Declarar divergencia explícita" — "Re-crea la sesión con `--branches alias:rama` distintos, o actualiza con `project-md-upsert --update-phase`."
-  3. "Cancelar" — "Aborta y deja al usuario decidir manualmente."
-- **`preview`** opcional (ASCII): tabla `alias → current → expected` de `divergent_sources`. Ej:
-
-  ```
-  alias       current             expected
-  ─────────   ───────────────     ─────────────
-  core        certificacion       certificacion
-  dev         feature/foo         certificacion
-  analyze     feature/foo         certificacion
-  ```
-
-**Prompt 2** (solo si elige "Alinear todas"):
-- `header`: `target-branch`.
-- `question`: "¿A qué rama alineamos las fuentes divergentes?"
-- `options` (≤4):
-  1. "Current consensus" — la rama con más fuentes apuntando.
-  2. "Expected (de la sesión)" — la rama declarada en `Status → Sesiones activas`.
-  3. Otras candidates concretas si las hay.
-- **Other auto** = nombre de rama custom.

package/skills/agent-workflow/doctrine/session/references/prompts/M5-modality-analyze.md

@@ -1,15 +0,0 @@
-# M5 — modality-analyze (standalone o sesión nueva sin modality)
-
-Spec literal del prompt M5. Index: [`../prompts-catalog.md#m5--modality-analyze-standalone-o-sesión-nueva-sin-modality`](../prompts-catalog.md#m5--modality-analyze-standalone-o-sesión-nueva-sin-modality).
-
-- **Cuándo**: `/agent-workflow:session` con flow=analyze pero sin `## Modality` declarada en el OBJECTIVE (legacy: `## Modalidad` en OBJETIVO.md).
-- **Forma**: 1 question.
-  - `header`: `modality`.
-  - `question`: "¿Qué modalidad de análisis usás?"
-  - `multiSelect`: false.
-  - `options`:
-    1. "Technical (propuesta)" — "Pregunta arquitectónica/diseño; produce `CONCLUSIONS.md` con `## Modality: technical` (legacy: `tecnica`)."
-    2. "Data" — "Análisis cuantitativo; produce `CONCLUSIONS.md` con `## Modality: data` (legacy: `datos`)."
-    3. "Incident (Post-mortem)" — "Retrospectiva de falla; produce `CONCLUSIONS.md` con `## Modality: incident` (legacy: `incidente`)."
-- **Valor persistido**: el AI siempre escribe el valor canónico EN (`technical`/`data`/`incident`) en el OBJECTIVE.md. Los valores ES legacy se aceptan sólo en lectura (sesiones pre-R3).
-- **Reemplaza**: prosa en `qtc-analyze/skills/analyze-workflow/SKILL.md` paso 2 del modo standalone. CONCLUSIONS.md vive en la sesión por default; gradúa opt-in con `kind=conclusion` a `docs/conclusiones/`.

package/skills/agent-workflow/doctrine/session/references/prompts/M6-phase-gate.md

@@ -1,31 +0,0 @@
-# M6 — phase-gate (transición entre phases en implement)
-
-Spec literal del prompt M6. Index: [`../prompts-catalog.md#m6--phase-gate-transición-entre-phases-en-implement`](../prompts-catalog.md#m6--phase-gate-transición-entre-phases-en-implement).
-
-- **Cuándo**: en `qtc-dev/skills/implement` ejecutando una sesión `flow=dev` con `## Tipo: feature|refactor`, después de cerrar todas las tareas de una sección `## (Phase|Fase|Sprint|Etapa) X — Y` en TASKS.md y antes de abrir tasks de la siguiente. Las 4 variantes son sinónimos sin diferencia funcional — ver apéndice "Convención de naming phased".
-- **Forma**: 1 question + preview opcional cuando current_phase=0 (cableado).
-  - `header`: `phase-gate`.
-  - `question`: "Phase `<X>` (`<title-actual>`) cerrada. ¿Avanzamos a Phase `<X+1>` (`<title-siguiente>`)?"
-  - `multiSelect`: false.
-  - `options`:
-    1. "Avanzar a Phase `<X+1>` (Recomendado)" — "Continúa el loop con tareas de la siguiente phase."
-    2. "Pausar — quiero probar el cableado antes" — "Detiene el loop. El usuario testea (FE/BE/DB según corresponda) y avisa cuando retomar."
-    3. "Re-iterar Phase `<X>`" — "Re-abre tareas de la phase actual; útil si surgió algo que falta antes de avanzar."
-  - **Other auto** = nota informativa libre (no avanza ni retrocede; queda registrada como contexto en DECISIONS si aporta).
-- **Preview opcional** (cuando `current_phase=0`): tabla compacta de endpoints/interfaces declarados en Phase 0, ej:
-
-  ```
-  Layer       Item
-  ─────────   ──────────────────────────────────
-  FE service  CategoriasService.list/save/delete
-  FE iface    CategoriaSaveRequest (sparse)
-  BE Ctrl     CategoriasController @PatchMapping
-  BE DTO      CategoriaSaveRequest record (nullable)
-  DB fn       fn_categorias_listar (mock devuelve fila vacía)
-  ```
-
-- **Si todas las tasks de la phase quedan cerradas y no hay siguiente phase declarada en TASKS.md**: skip M6 y propagar a `validation` directamente.
-- **Hasta 5 invocaciones por sesión phased completa (v2.7+)**: con el modelo extendido Phase 0-5 las transiciones posibles son 0→1, 1→2, 2→3, 3→4, 4→5. M6 puede dispararse en cada una. **Skip silencioso** cuando:
-  - La phase siguiente está **vacía** (ej. Phase 4 — Seguridad placeholder sin tasks abiertas; Phase 3→Phase 5 directo si Phase 4 omitida).
-  - La phase siguiente **no está declarada en TASKS.md** (ej. Phase 5 opt-in ausente; Phase 3→validation directo).
-- **Refina**: nueva sección "Phased mode" en `qtc-dev/skills/implement/SKILL.md` (v2.7+ — 6 phases).

package/skills/agent-workflow/doctrine/session/references/prompts/M7-refactor-legacy-detected.md

@@ -1,28 +0,0 @@
-# M7 — refactor-legacy-detected (rename Strangler en skill `refactor`)
-
-Spec literal del prompt M7. Index: [`../prompts-catalog.md#m7--refactor-legacy-detected-rename-strangler-en-skill-refactor`](../prompts-catalog.md#m7--refactor-legacy-detected-rename-strangler-en-skill-refactor).
-
-- **Cuándo**: en `qtc-dev/skills/refactor` después de completar la sección "Análisis legacy" de REFACTOR.md y antes de tocar paths.
-- **Forma**: 1 question + preview con file tree antes/después.
-  - `header`: `legacy`.
-  - `question`: "Detecté feature `<nombre>` en `<path>`. ¿Cómo procedemos con el rename Strangler?"
-  - `multiSelect`: false.
-  - `options`:
-    1. "Rename + AI actualiza imports (Recomendado)" — "`git mv <path> <path>-legacy/` y la AI actualiza imports/módulos automáticamente. Diff por archivo antes de aplicar."
-    2. "Solo rename, yo actualizo imports vía IDE" — "Ejecuta `git mv` y deja imports rotos para que los resuelvas con refactor del IDE; la build fallará hasta que migrés. Más seguro en codebases grandes."
-    3. "Solo análisis, no tocar paths" — "REFACTOR.md queda como artefacto exploratorio (`status: discovery`); útil si querés decidir el rename después o si el refactor se promovió desde un análisis."
-  - **Other auto** = path/nombre custom para el legacy (ej. `<path>-v0` en lugar de `<path>-legacy`).
-- **Preview** (sugerido): file tree ASCII before → after, recortado a 10 líneas:
-
-  ```
-  src/app/admin/                src/app/admin/
-  ├── categorias/         →     ├── categorias/         (vacía, Phase 0 stub)
-  │   ├── *.module.ts           ├── categorias-legacy/
-  │   ├── *.service.ts          │   ├── *.module.ts
-  │   └── *.component.ts        │   ├── *.service.ts
-  └── ...                       │   └── *.component.ts
-                                └── ...
-  ```
-
-- **Si match=false en alguna fuente afectada**: omitir el rename y pedir alinear ramas primero (coherente con `branch-verification.md`).
-- **Refina**: paso "Marcar legacy" en `qtc-dev/skills/refactor/SKILL.md`.

package/skills/agent-workflow/doctrine/session/references/prompts/M8-refactor-cleanup.md

@@ -1,16 +0,0 @@
-# M8 — refactor-cleanup (eliminación de paths legacy)
-
-Spec literal del prompt M8. Index: [`../prompts-catalog.md#m8--refactor-cleanup-eliminación-de-paths-legacy`](../prompts-catalog.md#m8--refactor-cleanup-eliminación-de-paths-legacy).
-
-- **Cuándo**: en `qtc-dev/skills/refactor` después de Phase 2 cerrada y validación e2e confirmada por el usuario (`status: validating` → `completed`).
-- **Forma**: 1 question.
-  - `header`: `cleanup`.
-  - `question`: "Refactor de `<feature>` validado e2e. ¿Elimino `<path>-legacy/` definitivamente?"
-  - `multiSelect`: false.
-  - `options`:
-    1. "Sí, eliminar legacy (Recomendado)" — "Ejecuta `git rm -r <path>-legacy/`. REFACTOR.md actualiza `legacy_purged: true` y queda en la sesión (no se gradúa con kind dedicado — DEC-003)."
-    2. "Mantener temporalmente" — "Deja legacy en disco; REFACTOR.md marca `legacy_purged: false` con TODO. Cleanup queda para sesión follow-up."
-    3. "Cancelar" — "No toca nada. El closure no completa hasta resolver."
-  - **Other auto** = motivo del retraso del cleanup (se registra en REFACTOR.md como nota).
-- **Si `status` no es `validating`**: skip M8 con error informativo ("Cleanup requiere validación e2e previa; estado actual: `<status>`").
-- **Refina**: paso "Cleanup" en `qtc-dev/skills/refactor/SKILL.md`.

package/skills/agent-workflow/doctrine/session/references/prompts/M9-contract-review.md

@@ -1,39 +0,0 @@
-# M9 — contract-review (RETIRADO)
-
-> **RETIRADO** por DEC-002 de `session049-analyze-mejoras-flujos-qtc-runtime` (graduada como `docs/conclusiones/005-mejoras-flujos-qtc-runtime.md`). Implementado en `session050-dev-design-md-and-s7-gate`.
->
-> **Reemplazo**: el gate de design review se movió de post-stub (M9, al cerrar Phase 0) a pre-stub (S7, antes de Phase 0). Ver `S7-design-review.md`.
->
-> **Razón**: el usuario rechazó la doble-review en un mismo ciclo de desarrollo. La revisión post-implementación se delega al skill futuro `agent-workflow:review <sessionNNN>` (placeholder DEC-002 / R5 de CONCLUSIONS session049), que opera sobre sesiones cerradas en lugar de dentro de la misma sesión.
->
-> **Patrón equivalente**: mismo mecanismo que M12 (eliminado por DEC-002 del catálogo). Este archivo se conserva como referencia histórica; las refs a M9 en doctrina activa fueron migradas a S7.
-
----
-
-## Spec original (referencia histórica)
-
-Index: [`../prompts-catalog.md#m9--contract-review-validación-opcional-al-cerrar-phase-0`](../prompts-catalog.md#m9--contract-review-validación-opcional-al-cerrar-phase-0).
-
-- **Cuándo (legacy)**: en `qtc-dev/skills/implement` exclusivamente al cerrar la primera phase (Contrato) de una sesión `## Tipo: feature|refactor` — sección `## Phase 0 — Contrato` o sus sinónimos `## Fase 0`/`## Sprint 0`/`## Etapa 0`. Se disparaba **antes** de M6 si el spec del cableado tenía ≥1 endpoint o ≥1 interface no triviales.
-- **Forma (legacy)**: 1 question + preview ASCII rico.
-  - `header`: `contract`.
-  - `question`: "Cableado FE↔BE↔DB listo (Phase 0). ¿Validás el contrato visualmente antes de Phase 1?"
-  - `multiSelect`: false.
-  - `options`:
-    1. "Sí, lo pruebo (Recomendado)" — "Pausa el loop antes de M6. Vos abrís FE/BE/cliente HTTP y verificás que el skeleton responde con mocks. Cuando confirmes, dispara M6."
-    2. "Saltar, confío en el spec" — "Va directo a M6 phase-gate."
-  - **Other auto (legacy)** = nota libre (ej. "lo probaré al cerrar Phase 1, sigamos") — equivalente a saltar pero registra contexto.
-- **Preview obligatorio (legacy)**: tabla del cableado declarado + fila Routing (v2.7+):
-
-  ```
-  Capa      Símbolo                           Estado
-  ───────   ──────────────────────────────    ───────
-  FE        CategoriasService.list()          mock []
-  FE        CategoriasService.save(req)       throw new Error('not impl')
-  BE        GET /api/categorias               501
-  BE        PATCH /api/categorias/{id}        501
-  DB        fn_categorias_listar              RETURN '[]'::jsonb
-  Routing   FE → BE (navegación e2e)          /login → /home consume mock OK
-  ```
-
-- **Sesiones legacy** que referencian M9 en sus HISTORY refs siguen siendo legibles — ningún parser falla por una mención histórica. La doctrina activa ya no contiene refs a M9.

package/skills/agent-workflow/doctrine/session/references/prompts/S1-type-design.md

@@ -1,15 +0,0 @@
-# S1 — type-design (standalone o brief ambiguo)
-
-Spec literal del prompt S1. Index: [`../prompts-catalog.md#s1--type-design-standalone-o-brief-ambiguo`](../prompts-catalog.md#s1--type-design-standalone-o-brief-ambiguo).
-
-- **Cuándo**: `/agent-workflow:session` con flow=design y `design-brief` no define `## Type` en el OBJECTIVE (legacy: `## Tipo` en OBJETIVO.md).
-- **Forma**: 1 question.
-  - `header`: `design-type`.
-  - `question`: "¿Qué tipo de sesión de diseño es?"
-  - `multiSelect`: false.
-  - `options`:
-    1. "Project (pantalla/feature concreta)" — "Produce DELIVERY.md en `.workflow/sessions/<folder>/`. Al graduar va a `docs/especificaciones/<NNN>-<slug>/` (kind=`especificacion`)."
-    2. "System (tokens/componentes compartidos)" — "Produce DELIVERY.md describiendo cambios al design system. Al graduar va a `docs/especificaciones/<NNN>-<slug>/` (mismo kind, distinto contenido)."
-- **Tratamiento del Other auto-inyectado**: cancelación + apertura de conversación libre ("necesito más contexto"). El AI **no infiere** project/system desde el texto libre — pide al usuario que lo defina explícitamente. La sesión queda **sin type** hasta que el usuario lo declare.
-- **Valor persistido**: el AI siempre escribe el valor canónico EN (`project`/`system`) en el OBJECTIVE.md. Los valores ES legacy (`proyecto`/`sistema`) se aceptan sólo en lectura (sesiones pre-R3).
-- **Reemplaza**: prosa en `qtc-design/skills/design-workflow/SKILL.md` paso 2 + `qtc-design/skills/design-brief/SKILL.md` sección "Si el usuario no puede deducir el Type".

package/skills/agent-workflow/doctrine/session/references/prompts/S2-topic-change-detection.md

@@ -1,14 +0,0 @@
-# S2 — topic-change-detection
-
-Spec literal del prompt S2. Index: [`../prompts-catalog.md#s2--topic-change-detection`](../prompts-catalog.md#s2--topic-change-detection).
-
-- **Cuándo**: durante `execution`, `agent-workflow topic-change-check` retorna `changed=true`.
-- **Forma**: 1 question.
-  - `header`: `topic-change`.
-  - `question`: "El pedido nuevo se desvía del OBJECTIVE actual. ¿Cómo seguimos?"
-  - `multiSelect`: false.
-  - `options`:
-    1. "Cerrar esta y abrir nueva (Recomendado si la divergencia es grande)" — "Cierra session<NNN>, crea nueva con el pedido como OBJECTIVE."
-    2. "Extender el OBJECTIVE de la sesión actual" — "Suma el pedido a los criterios; mantiene 1 sola sesión."
-    3. "Ignorar (no cambiar nada)" — "Mantiene OBJECTIVE original; el pedido se trata como nota informal."
-- **Reemplaza**: prosa en `skills/session/SKILL.md` sección "Topic-change detection".

package/skills/agent-workflow/doctrine/session/references/prompts/S3-flow-detection.md

@@ -1,28 +0,0 @@
-# S3 — flow-detection
-
-Spec literal del prompt S3. Index: [`../prompts-catalog.md#s3--flow-detection`](../prompts-catalog.md#s3--flow-detection).
-
-- **Cuándo**: usuario invoca `/agent-workflow:session "<texto>"` y la heurística no determina flow (no hay alias específico ni keywords claras).
-- **Forma**: 1 question principal + (si elige opción 4) sub-prompt encadenado.
-
-**Prompt 1**:
-- `header`: `flow`.
-- `question`: "¿Qué flow usás para esta sesión?"
-- `multiSelect`: false.
-- `options`:
-  1. "Dev (implementación de código)" — "Edits con coding-standards, SQL, tests."
-  2. "Design (UX/UI specs)" — "Brief, discovery, develop, deliver. Spec-only."
-  3. "Analyze (investigación read-only / propuesta)" — "Investigate, synthesize, propuesta/datos/post-mortem."
-  4. "No estoy seguro" — "Disparo 1-2 preguntas más para clasificar."
-
-**Prompt 2** (solo si elige opción 4):
-- `header`: `clasificar`.
-- `question`: "Para clasificar la sesión, ¿qué planeás hacer?"
-- `multiSelect`: false.
-- `options`:
-  1. "Editar código directamente" → flow = dev.
-  2. "Producir un spec UX/UI sin código" → flow = design.
-  3. "Investigar sin editar código ni BD" → flow = analyze.
-  4. "Mezcla — empezar investigando y después decidir" → flow = analyze (con posible Caso C después).
-
-- **Reemplaza**: heurística silenciosa en `skills/session/SKILL.md` "Detectar flow".

package/skills/agent-workflow/doctrine/session/references/prompts/S4-resume.md

@@ -1,27 +0,0 @@
-# S4 — resume (sesión sin args + ≥2 sesiones activas)
-
-Spec literal del prompt S4. Index: [`../prompts-catalog.md#s4--resume-sesión-sin-args--2-sesiones-activas`](../prompts-catalog.md#s4--resume-sesión-sin-args--2-sesiones-activas).
-
-- **Cuándo**: en `skills/session/SKILL.md`, el usuario invoca `/agent-workflow:session` sin args y `agent-workflow resume-summary` retorna `active_sessions.length ≥ 2`. Reemplaza la heurística silenciosa de "elegir la última".
-- **Forma**: 1 question + preview opcional.
-  - `header`: `resume`.
-  - `question`: "Hay `<N>` sesiones activas. ¿Cuál retomamos?"
-  - `multiSelect`: false.
-  - `options` (≤4):
-    1. "<sessionXXX-flow-slug> (Recomendado por última actividad)" — "<phase> · <last-activity>."
-    2. "<sessionYYY-flow-slug>" — "<phase> · <last-activity>."
-    3. "<sessionZZZ-flow-slug>" — "<phase> · <last-activity>."
-    4. "Abrir nueva sesión" — "Dispara el flujo de creación con prompt de OBJECTIVE."
-  - **Other auto** = nombre de sesión custom (folder slug exacto).
-- **Preview opcional** (multi-sesión): tabla compacta `code · phase · last-activity · open-tasks` de las 3 más recientes. Ej:
-
-  ```
-  code      phase       last-activity       open-tasks
-  ───────   ─────────   ─────────────────   ──────────
-  002-dev   execution   2026-05-06 10:23    4/7
-  003-dev   planning    2026-05-05 18:11    7/7
-  001-ana   closure     2026-05-06 01:08    0/7 (graduada)
-  ```
-
-- **Si `active_sessions.length = 1`**: skip S4 silencioso, retomar directo. **Si = 0**: skip y abrir nueva sin preguntar.
-- **Refina**: paso "Detectar sesión activa" en `skills/session/SKILL.md` flujo "retomar".

package/skills/agent-workflow/doctrine/session/references/prompts/S5-post-compact.md

@@ -1,17 +0,0 @@
-# S5 — post-compact (PostCompact hook)
-
-Spec literal del prompt S5. Index: [`../prompts-catalog.md#s5--post-compact-postcompact-hook`](../prompts-catalog.md#s5--post-compact-postcompact-hook).
-
-- **Cuándo**: el PostCompact hook dispara tras `/compact` o `/agent-workflow:compact`. La SKILL `compact` (o `resume` si el hook delega) ya leyó CHECKPOINT.md y va a presentar resumen al usuario antes de proseguir.
-- **Forma**: 1 question.
-  - `header`: `post-compact`.
-  - `question`: "Compact aplicado. ¿Cómo seguimos?"
-  - `multiSelect`: false.
-  - `options`:
-    1. "Retomar misma sesión" — "Continúa el loop sobre la próxima task abierta del TASKS.md."
-    2. "Abrir nueva sesión" — "Cierra esta como `paused` (graduación postergada) y dispara `/agent-workflow:session "<texto>"`."
-    3. "Solo recapitular, después decido" — "Imprime resumen del CHECKPOINT y pausa el loop."
-  - **Other auto** = instrucción custom (ej. "retomá pero salteá a la T5").
-- **Recomendación dinámica**: el AI marca `(Recomendado)` en opción 1 si CHECKPOINT.md indica `tasks_open ≥ 1`; caso contrario marca opción 2.
-- **Si CHECKPOINT.md ausente o ilegible**: skip S5 con error informativo y fallback a `session-resume` base.
-- **Refina**: paso "Tras compact" en `skills/compact/SKILL.md` y/o sección "PostCompact hook" en `skills/resume/SKILL.md`.

package/skills/agent-workflow/doctrine/session/references/prompts/S6-scope.md

@@ -1,16 +0,0 @@
-# S6 — scope (auto-plan-decide retorna `full` con ETA >4h)
-
-Spec literal del prompt S6. Index: [`../prompts-catalog.md#s6--scope-auto-plan-decide-retorna-full-con-eta-4h`](../prompts-catalog.md#s6--scope-auto-plan-decide-retorna-full-con-eta-4h).
-
-- **Cuándo**: en `skills/session/SKILL.md` durante planning, `agent-workflow auto-plan-decide` retorna `decision=full` y la AI estima `eta_total > 4h` agregando estimas de TASKS.md (S=0.5h, M=2h, L=4h). Aviso anticipado de scope demasiado grande para una sola sesión.
-- **Forma**: 1 question.
-  - `header`: `scope`.
-  - `question`: "Scope estimado: `<N>` tasks · ETA `<X>h`. ¿Cómo procedemos?"
-  - `multiSelect`: false.
-  - `options`:
-    1. "Lite primero (3 tasks core) (Recomendado)" — "Reduce TASKS.md a las 3 más críticas; el resto queda parking. Cerramos rápido y abrimos sesión 2 si hace falta."
-    2. "Full (proceder con TASKS.md actual)" — "Mantiene el plan completo; la sesión queda larga pero coherente."
-    3. "Split en 2 sesiones" — "Divide TASKS.md en sessionA (T1-T<k>) + sessionB (T<k+1>-Tn) con dependencia explícita; descomposición por dependencias del DAG."
-  - **Other auto** = instrucción custom (ej. "lite con T1, T3, T5").
-- **Si `tasks_count ≤ 3`**: skip S6 (scope ya es lite por construcción, sin importar ETA).
-- **Refina**: paso "Auto-plan output" en `skills/session/SKILL.md` planning phase.

package/skills/agent-workflow/doctrine/session/references/prompts/S7-design-review.md

@@ -1,37 +0,0 @@
-# S7 — design-review (gate de aprobación del DESIGN.md antes de Phase 0)
-
-Spec literal del prompt S7. Index: [`../prompts-catalog.md#s7--design-review-gate-de-aprobación-del-designmd-antes-de-phase-0`](../prompts-catalog.md#s7--design-review-gate-de-aprobación-del-designmd-antes-de-phase-0).
-
-- **Cuándo**: en `skills/session/SKILL.md` al cerrar planning, tras producir `DESIGN.md`, antes de M10. Aplica a `flow=dev` con `## Type: feature|refactor` (resuelto vía Capa 1/2/3 — ver `skills/dev-workflow/SKILL.md` §"Resolución del `## Type`"). Always-on para esos tipos; confirmación explícita obligatoria.
-- **Skip silencioso**: `## Type: bugfix|chore` (en esos casos DESIGN.md no se produce y este gate no aplica).
-- **Forma**: 1 question + preview ASCII opcional (resumen 1-pantalla del DESIGN.md).
-  - `header`: `design-review`.
-  - `question`: "DESIGN.md listo. ¿Lo revisás antes de que arranque a codear?"
-  - `multiSelect`: false.
-  - `options`:
-    1. "Sí, lo reviso (Recomendado)" — "Pausa el loop. Abrí `DESIGN.md`, editá o comentá. Cuando decís 'listo / sigamos / ok / approved', arranca Phase 0."
-    2. "Approve as-is" — "Aprobás el diseño tal cual sin editarlo. Va directo a Phase 0."
-    3. "Refinar antes" — "El AI pregunta qué sección/decisión ajustar (sub-prompt libre, no estructurado), itera `DESIGN.md` y vuelve a disparar S7 con el doc actualizado."
-  - **Other auto** = feedback puntual aplicado al `DESIGN.md` con re-disparo de S7. Ej: "renombrá `PdfRenderer` a `HtmlToPdfRenderer` y seguí" → el AI aplica al doc, dispara S7 nuevamente, el usuario confirma con opción 1 o 2.
-- **Preview ASCII (opcional pero recomendado)**:
-
-  ```
-  Design summary — session<NNN>
-  ─────────────────────────────
-  Sections: Context · Goals · Non-goals · Current/Target ·
-            New interfaces · Wiring · <N> decisions · <M> open questions
-
-  Top 3 decisions:
-    1. <decisión 1 título>
-    2. <decisión 2 título>
-    3. <decisión 3 título>
-
-  Open questions:
-    - <pregunta 1>
-    - <pregunta 2>
-    (si M=0, mostrar "None")
-  ```
-
-- **Confirmación obligatoria**: el gate no avanza a Phase 0 hasta señal explícita del usuario. Sin timeout ni silent skip. Las opciones 1/2 cuentan como confirmación; la opción 3 + Other son loops de iteración que terminan en confirmación 1 o 2 eventualmente.
-- **Refina**: paso "Cierre de planning" en `skills/session/SKILL.md` (producir DESIGN.md antes de M10 si flow=dev y type feature|refactor).
-- **Reemplaza**: M9 (contract-review). M9 disparaba al CIERRE de Phase 0 (post-stub). S7 dispara ANTES de Phase 0 (pre-stub). La validación post-implementación se delega al skill futuro `agent-workflow:review <sessionNNN>` (placeholder DEC-002 de session049-analyze-mejoras-flujos-qtc-runtime, R5 de CONCLUSIONS).