@tacuchi/agent-workflow-cli 11.0.1 → 12.0.0

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

@@ -1,211 +0,0 @@
-# Validations — V1-V6 para `/agent-workflow:export-tech-manuals`
-
-Checks post-render que se aplican antes de escribir output al filesystem. Reglas adaptadas a los **2 modos** del comando (`complementar` y `regenerar`).
-
-Niveles de severidad:
-- **Hard-fail**: aborta la escritura, devuelve `ok: false` con error report. No se crea el archivo.
-- **Warning**: emite mensaje, pide confirmación del usuario.
-
-## V1 — Estructura por modo
-
-**Severidad**: hard-fail si faltan secciones obligatorias del modo activo.
-
-**Modo `complementar`** (output = `INDEX.md`):
-Secciones obligatorias en orden:
-1. `# Manuales técnicos — <PRODUCTO>` (header con título)
-2. `## Manuales graduados`
-3. `## Temas sin graduar detectables` (condicional — V4)
-4. `## Próximos pasos sugeridos` (condicional — V4)
-5. `## Cómo refrescar este índice`
-
-**Modo `regenerar`** (output = N archivos en dossier):
-Cada archivo `.md` del dossier debe tener:
-1. `# <TITULO_MANUAL>` (header)
-2. `## Propósito`
-3. `## Pre-requisitos`
-4. `## Pasos`
-5. `## Validación post-uso`
-6. `## Troubleshooting`
-7. `## Referencias`
-
-Adicionalmente, el dossier debe tener un `README.md` con índice de los manuales generados.
-
-**Error report (hard-fail)**:
-```
-V1 FAILED: estructura inválida
-  modo: regenerar
-  archivo: 01-configurar-mcp.md
-  esperado: Propósito, Pre-requisitos, Pasos, Validación post-uso, Troubleshooting, Referencias
-  encontrado: Propósito, Pre-requisitos, Pasos, Referencias
-  faltantes: Validación post-uso, Troubleshooting
-  acción: regenerar el manual incluyendo las secciones faltantes
-```
-
-## V2 — Noise vetado
-
-**Severidad**: hard-fail si hay ≥1 ocurrencia en el cuerpo (header y `## Referencias` exentos).
-
-**Scope**: body-only (después del primer `## ` y antes de `## Referencias`).
-
-**Lista vetada**: ver `lexico-tecnico.md` §"Lista vetada".
-
-**Cómo validar**:
-```bash
-awk '
-  BEGIN { body=0 }
-  /^## Referencias/ { body=0 }
-  body { print }
-  /^## / && !/Referencias/ { body=1 }
-' output.md > /tmp/body.md
-grep -n -F -f lexico-noise-vetado.txt /tmp/body.md
-```
-
-**Error report (hard-fail)**:
-```
-V2 FAILED: noise vetado detectado
-  archivo: 02-crear-sesion.md
-  ocurrencias:
-    línea 12: "{{PASO_1}}"       → placeholder sin reemplazar
-    línea 19: "/Users/tacuchi/"  → path absoluto del developer
-    línea 28: "TODO:"            → marker WIP no resuelto
-  total: 3 ocurrencias
-  acción: completar render y stripear paths absolutos
-```
-
-## V3 — Secciones de `template-manual.md` (sólo modo regenerar)
-
-**Severidad**: hard-fail si un archivo del dossier no tiene las 6 secciones obligatorias del template-manual.
-
-**No aplica en modo complementar** (V1 ya cubre las secciones del INDEX).
-
-**Cómo validar**: por cada archivo `.md` del dossier (excluyendo `README.md`), extraer `^## ` headers; verificar Propósito + Pre-requisitos + Pasos + Validación post-uso + Troubleshooting + Referencias presentes.
-
-**Error report**:
-```
-V3 FAILED: archivo del dossier sin secciones obligatorias
-  archivo: docs/manuales/NNN-export-tech-manuals-YYYY-MM-DD/01-configurar-mcp.md
-  faltantes: ## Validación post-uso, ## Troubleshooting
-  acción: regenerar el manual
-```
-
-## V4 — Condicionales por modo
-
-**Severidad**: hard-fail si no se honra la condición.
-
-### V4.a — Modo complementar + 0 manuales graduados
-
-- **Comportamiento esperado**: tabla "Manuales graduados" presente con una fila informativa `_Sin manuales graduados en este workspace todavía._`. No fila vacía, no encabezado solo.
-- **Comportamiento esperado para "Temas sin graduar"**: si 0 temas detectables → omitir la sección completa.
-- **Comportamiento esperado para "Próximos pasos"**: omitido si 0 temas no graduados.
-
-### V4.b — Modo regenerar + 0 temas detectables
-
-- **Comportamiento esperado**: abortar con `ok: false`. No producir dossier vacío.
-- **Error report**:
-```
-V4.b FAILED: modo regenerar sin temas detectables
-  filtros aplicados: --temas <ninguno>, --source <ninguno>, --since <ninguno>
-  corpus: 12 sesiones cerradas
-  temas detectados: 0
-  acción: ajustar filtros o pasar `--temas slug1` explícito; o pasar a modo `complementar` para reflejar el estado vacío
-```
-
-### V4.c — Modo regenerar + dossier con ≥1 manual
-
-- **Comportamiento esperado**: el dossier `NNN-export-tech-manuals-YYYY-MM-DD/` contiene un `README.md` + ≥1 archivo `.md` adicional (un manual). Si solo hay README → fail.
-
-## V5 — Header bien formado
-
-**Severidad**: warning.
-
-**Checks**:
-- Modo `complementar`: línea 1 contiene `# Manuales técnicos — <PRODUCTO>` con producto resuelto.
-- Modo `regenerar`: cada archivo del dossier tiene línea 1 con `# <TITULO_MANUAL>` (no literal `{{TITULO_MANUAL}}`).
-
-**Error report (warning)**:
-```
-V5 WARNING: header de un manual incompleto
-  archivo: 03-migrar-legacy.md
-  línea 1: "# {{TITULO_MANUAL}}"
-  acción sugerida: completar el placeholder
-```
-
-## V6 — Referencias resolubles
-
-**Severidad**: warning.
-
-**Checks**: cada link en `## Referencias` de cada manual / del INDEX apunta a un path existente.
-
-**Cómo validar**:
-```bash
-grep -oE '`[^`]+\.md`|`[^`]+\.json`|`docs/[^`]+`' output.md | tr -d '`' | \
-  while read p; do
-    if [ ! -e "$p" ]; then echo "MISSING: $p"; fi
-  done
-```
-
-**Error report (warning)**:
-```
-V6 WARNING: 1 referencia apunta a path inexistente
-  archivo: 01-configurar-mcp.md
-  - docs/conclusiones/004-audit-test.md → no existe en filesystem
-  acción sugerida: revisar el link o eliminar la referencia
-```
-
-## Orden de aplicación
-
-1. V1 (estructura) — primero, barato.
-2. V2 (noise) — segundo, barato.
-3. V3 (secciones de template-manual, sólo regenerar) — tercero.
-4. V4 (condicionales) — cuarto.
-5. V5 (header) — quinto.
-6. V6 (referencias resolubles) — último.
-
-Si V1, V3 o V4 fallan → abortar inmediatamente.
-Si V2 falla → abortar.
-Si V5 o V6 emiten warning → pedir confirmación al usuario.
-
-## Reporte consolidado
-
-```json
-{
-  "ok": true | false,
-  "mode": "complementar" | "regenerar",
-  "output_paths": ["docs/manuales/INDEX.md"]  // o ["docs/manuales/NNN-.../README.md", "...01-...md", ...]
-  "manuales_graduados_count": 3,
-  "temas_no_graduados_count": 5,
-  "manuales_generados_count": 0,  // sólo aplica a regenerar
-  "validations": {
-    "V1": { "status": "pass", "sections_found_per_file": {...} },
-    "V2": { "status": "pass", "noise_hits": 0 },
-    "V3": { "status": "pass" | "n/a", "details": "..." },
-    "V4": { "status": "pass", "conditionals": { "manuales_graduados": "fila informativa OK", "temas_no_graduados": "sección presente con 5 temas", "proximos_pasos": "presente (5 temas)" } },
-    "V5": { "status": "warning", "issues": [...] },
-    "V6": { "status": "warning", "missing_refs": [...] }
-  },
-  "summary": "INDEX.md sobrescrito; 3 graduados + 5 temas no-graduados detectables."
-}
-```
-
-Si hard-fail:
-
-```json
-{
-  "ok": false,
-  "stage": "validation",
-  "failed_at": "V4.b",
-  "details": "modo regenerar sin temas detectables",
-  "no_files_written": true
-}
-```
-
-## Diferencias con los validations hermanos
-
-| Validación | `export-tech-manuals` | `export-arq` | `export-report` |
-|---|---|---|---|
-| V1 | estructura por modo (INDEX vs dossier) | estructura de secciones por scope | cota dura de palabras |
-| V2 | noise mínimo (~30) | noise mínimo (~25) | léxico ejecutivo (~75) |
-| V3 | secciones por manual (sólo regenerar) | diagrama C4 presente | secciones obligatorias en orden |
-| V4 | condicionales por modo (3 sub-casos) | condicionales (2 sub-casos) | "Recomendaciones" condicional (1 caso) |
-| V5 | header del INDEX o del manual | header arq con snapshot+fuentes+diagrams | header con período natural |
-| V6 | referencias resolubles | referencias resolubles | referencias resolubles |

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

@@ -1,31 +0,0 @@
----
-name: export-tech-note
-description: "[STUB] Genera una Nota Técnica (`.md`) consolidando el corpus de sesiones del workspace y `docs/`. Stub vacío sin lógica activa — implementación diferida a una sesión futura. Output previsto: `docs/manuales/NNN-export-tech-note-YYYY-MM-DD.md` o `docs/funcional/`. Read-only sobre el corpus. Invocado sólo vía `/agent-workflow:export-tech-note`. Creado en session081-dev-extend-export-family con `version: 0.1.0`."
-version: 0.1.0
----
-
-# Export Tech Note — Stub vacío (sin lógica activa)
-
-> **STUB**. Este skill **no genera output útil aún**. Existe como placeholder discoverable para que el catálogo `/agent-workflow:export-*` lo registre. La implementación se difiere a una sesión futura (`flow=design` o `flow=dev`).
-
-## Alcance previsto
-
-Generar un único `.md` con una **Nota Técnica** consolidada del workspace, dirigida a stakeholders técnicos (devs, líderes técnicos, soporte). Más compacta que `export-tech-manuals` (que es un manual completo); más profunda que `export-report` (que es ejecutivo no técnico).
-
-- **Input canónico**: corpus = sesiones del workflow + `docs/`. Ver `agent-workflow/docs/shared-contract/export-corpus-sources.md` (DEC-002 session081).
-- **Subcarpetas de `docs/` que consumirá** (previstas): `docs/manuales/`, `docs/decisiones/`, `docs/conclusiones/`, `docs/arq/`.
-- **Output previsto**: `<docs>/manuales/NNN-export-tech-note-YYYY-MM-DD.md` (sub-decisión a tomar en la sesión de implementación: ¿manuales/ o funcional/ técnica?).
-
-## Estado
-
-- Creado: session081-dev-extend-export-family (2026-05-21).
-- Implementación: **diferida**. Cuando se aborde, abrir sesión `flow=design` para spec primero.
-
-## Plan mode
-
-Reglas generales en `skills/session/references/sandbox-readonly-rules.md`. Como el skill es un stub, en plan mode reportar `ok: false` con `reason: "stub not implemented yet"`.
-
-## Recursos
-
-- `agent-workflow/docs/shared-contract/export-corpus-sources.md` — contrato corpus canónico (DEC-002 session081).
-- `.workflow/sessions/session081-dev-extend-export-family/OBJECTIVE.md` — alcance de la sesión que creó el stub.

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

@@ -1,15 +0,0 @@
-# hooks/
-
-Hooks que el host ejecuta automáticamente durante el ciclo de vida de una sesión. Distribuídos como templates; el CLI `agent-workflow self install --target <host>` los materializa con adapters por host (ver `src/application/self/install-hooks.ts`).
-
-Contenido esperado (T2 PR2):
-
-- `SessionStart.template.json` — carga `profile.json`, registra namespace, auto-copy profile si aplica.
-- `PreCompact.template.json` — checkpoint-write antes de compactar contexto.
-- `PostCompact.template.json` — resume-summary tras compactar.
-- `sql-mutation-guard.template.json` — bloquea SQL no parametrizado / DDL en flujos de runtime.
-- `branch-check.template.json` — gate de rama al entrar a execution.
-- `git-commit-advisor.template.json` — recordatorio M1 ante intención de commit.
-- `commit-prompt-universal.template.json` — disparo del prompt de cierre universal.
-
-Cada template es agnóstico de host; los adapters lo traducen a `~/.claude/settings.json`, `~/.codex/config.toml`, etc.

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

@@ -1,12 +0,0 @@
-# references/
-
-Documentación de referencia consumida por skills universal y por la AI. Ya existente desde v6.x; se mantiene como anclaje canónico para `[[name]]` linking.
-
-Contenido (existing + esperado T2):
-
-- `*-cheatsheet.md` — atajos por familia de comandos.
-- `flow-*.md` — guías por flow (dev/design/analyze).
-- `phase-*.md` — guías por fase (planning/execution/validation/closure).
-- `lifecycle-state-machine.md` — diagrama oficial de transiciones.
-
-A diferencia de `doctrine/` (reglas activas), `references/` es documentación leída a demanda. Linkear desde doctrine/* con `[[name]]`.

package/skills/agent-workflow/references/checkpoint.md

@@ -1,59 +0,0 @@
-# Checkpoint
-
-CHECKPOINT.md is the single artifact that lets a fresh conversation resume work without re-exploring the codebase. It is written before `/compact` (PreCompact hook) or at session end (SessionEnd hook), and read on resume.
-
-## checkpoint-read
-
-Read `CHECKPOINT.md` of the active (or specified) session.
-
-```bash
-agent-workflow checkpoint-read
-agent-workflow checkpoint-read --code session035
-```
-
-Returns the raw markdown payload plus parsed metadata (phase, last-updated, refs).
-
-## checkpoint-write
-
-Write a CHECKPOINT.md draft for the active (or specified) session. Includes the canonical sections (Lo último que hice / Próximo paso / Decisiones recientes / Archivos tocados / Contexto crítico / Refs).
-
-```bash
-agent-workflow checkpoint-write
-agent-workflow checkpoint-write --code session035
-agent-workflow checkpoint-write --force          # overwrite even if recent
-```
-
-Flags: `--code <sessionNNN>`, `--force`.
-
-The output is intentionally a *draft*: the AI typically fills in the placeholder sections (`_[AI: ...]_`) with the real content before the file is committed.
-
-## compress-checkpoint
-
-Identify long artifacts that should be compressed before checkpoint generation (HALLAZGOS.md, EVIDENCIA.md, DISCOVERY.md, etc.). Returns a list of files exceeding the threshold so you can summarize them in place.
-
-```bash
-agent-workflow compress-checkpoint --code session035
-agent-workflow compress-checkpoint --code session035 --threshold 12000   # bytes
-```
-
-Flags: `--code <sessionNNN>`, `--threshold <bytes>` (default ~10000).
-
-## resume-summary
-
-Compact resume payload for the PostCompact hook. Returns the minimal information needed to greet the user with "Resumen — sesión activa: ..." right after `/compact`.
-
-```bash
-agent-workflow resume-summary
-```
-
-No flags. Reads the active session and its CHECKPOINT.md (if present).
-
-## auto-compact-on-close
-
-SessionEnd hook target. Walks every active session and writes a checkpoint for each.
-
-```bash
-agent-workflow auto-compact-on-close
-```
-
-You should rarely call this manually; it is wired into the host harness via the SessionEnd hook configured by the plugin's installer.

package/skills/agent-workflow/references/dev-only.md

@@ -1,50 +0,0 @@
-# Dev-only utilities
-
-Operational helpers for plugin authors and harness diagnostics. Not part of the everyday session flow.
-
-## harness
-
-Detect which host harness is running the CLI: `claude-code`, `codex`, or `unknown`.
-
-```bash
-agent-workflow harness
-```
-
-Output:
-
-```json
-{ "harness": "claude-code", "evidence": ["env:CLAUDE_PROJECT_DIR"] }
-```
-
-## profiles
-
-Resolve user preferences from the namespace's `user-config.md`.
-
-```bash
-agent-workflow profiles
-```
-
-Returns the parsed key-value preferences (e.g. `delegate_to_subagent`, `compact_threshold`).
-
-## logs
-
-View or clear the CLI log file.
-
-```bash
-agent-workflow logs                # dump full log
-agent-workflow logs --tail 50      # last 50 lines
-agent-workflow logs --clear        # truncate
-```
-
-The log file lives at `~/.<namespace>/lib/logs/agent-workflow.log` (or equivalent for the resolved namespace).
-
-## next-number
-
-Compute the next NNN correlative for a directory. Used by `session-create` and the SQL release tooling, but available standalone for plugin authors building their own correlatives.
-
-```bash
-agent-workflow next-number /path/to/sessions
-agent-workflow next-number .workflow/sessions
-```
-
-The directory argument is positional (not a flag).

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

@@ -1,61 +0,0 @@
-# Doctor / release / scan / graduate
-
-Diagnostics and release-prep commands. Read-only by default (`graduate` writes documentation, not code).
-
-## plugin-doctor
-
-Health check for a plugin: validates frontmatter, manifest version, hooks, MCP entries, and exported skills.
-
-```bash
-agent-workflow plugin-doctor --plugin-root /Users/me/Git/core-workflow-plugin
-agent-workflow plugin-doctor --plugin-root /path --plugin-name acme-core --plugin-version 3.24.0
-agent-workflow plugin-doctor --plugin-root /path --compat-range "^3.0.0"
-agent-workflow plugin-doctor --plugin-root /path --exports-file plugin.json
-```
-
-Exits 1 when validation fails; 0 when clean.
-
-## code-scan
-
-Scan files for release-critical patterns: hardcoded `localhost`, exposed secrets, TODO/FIXME markers, debug prints, etc. Used by the release skill.
-
-```bash
-agent-workflow code-scan
-agent-workflow code-scan --since 2026-04-01            # only files changed since date
-agent-workflow code-scan --source core                 # restrict to one declared source
-```
-
-## release-data
-
-Consolidated dump for the release / release-scripts skills: which sessions are graduated, which scripts ship, etc.
-
-```bash
-agent-workflow release-data
-agent-workflow release-data --since 2026-04-01
-agent-workflow release-data --source core
-agent-workflow release-data --include-graduated
-agent-workflow release-data --no-open --no-closed --skip-content   # narrow scope
-agent-workflow release-data --verbose
-```
-
-## graduate
-
-Promote a session-local artifact (DEC-NNN, TASKS, Propuesta, design entrega) into a workspace-level `docs/` location.
-
-```bash
-# Graduate a decision DEC-005 from session023
-agent-workflow graduate --kind decision --session session023 --id DEC-005 --slug auto-plan-thresholds
-
-# Graduate the full plan
-agent-workflow graduate --kind plan --session session023 --slug cli-npm-agent-workflow
-
-# Graduate an analyze conclusion (unifica las modalidades technical / data / incident)
-agent-workflow graduate --kind conclusion --session session022 --slug cli-npm-agent-workflow
-agent-workflow graduate --kind data --session session004 --slug precarga-objetos-bd
-agent-workflow graduate --kind postmortem --session sessionNNN --slug incident-foo
-
-# Graduate a design entrega
-agent-workflow graduate --kind design --session sessionNNN --slug system-foo
-```
-
-Required: `--kind`, `--session`, plus `--id` (decisions) or `--slug` (everything else).

package/skills/agent-workflow/references/history.md

@@ -1,40 +0,0 @@
-# History
-
-`<workspace>/.<namespace>/HISTORY.md` is a markdown table that lists every session in the workspace. Two CLI commands maintain it.
-
-## history-data
-
-Read-only aggregator. Walks the `.<namespace>/sessions/` tree and returns the data you would need to (re)build `HISTORY.md` from scratch, plus optional graduated-doc references.
-
-```bash
-agent-workflow history-data
-agent-workflow history-data --verbose
-agent-workflow history-data --include-docs   # also enumerate docs/scripts, docs/propuestas, etc.
-```
-
-Use this to detect drift between `HISTORY.md` and the on-disk session folders, or when you need to regenerate the table.
-
-## history-update
-
-Upsert a row in `HISTORY.md`. Used by `session-create` and `session-close` internally; you typically only invoke it directly to repair a row.
-
-```bash
-agent-workflow history-update \
-  --code session035 \
-  --state active \
-  --sesion "aw-skill-repo" \
-  --date 2026-05-05 \
-  --summary "Sub-proyecto 2 del spec ..." \
-  --refs "[OBJETIVO](.workflow/sessions/session035-dev-aw-skill-repo/OBJETIVO.md)"
-```
-
-Flags:
-
-| Flag | Notes |
-|---|---|
-| `--code <sessionNNN>` | Required. |
-| `--state <active\|closed>` | Required. |
-| `--sesion <slug>` | Visible session slug (without `sessionNNN-flow-` prefix). |
-| `--date <YYYY-MM-DD>` | Defaults to today if omitted in some callers; pass explicitly to be safe. |
-| `--summary <text>` | Replaces the Resumen cell. |
-| `--refs <markdown>` | Replaces the Refs cell. |

package/skills/agent-workflow/references/hooks.md

@@ -1,35 +0,0 @@
-# Hooks
-
-Hook targets the host harness invokes via `PreToolUse` / `SessionEnd` / `PostCompact` events. Each hook reads JSON on stdin, may print a message on stderr, and returns a meaningful exit code.
-
-You rarely call these by hand — they are wired into `hooks.json` by the plugin installer. Document them here so the AI knows what to expect when a hook fires.
-
-## hook branch-check
-
-PreToolUse guard for `Edit` / `Write`. Reads the tool input from stdin, resolves the target file, finds the owning source by path, and verifies the current branch matches the declared work branch.
-
-```bash
-echo '{"tool":"Edit","tool_input":{"file_path":"/path/to/file"}}' \
-  | agent-workflow hook branch-check
-```
-
-Exit codes:
-
-| Code | Meaning |
-|---|---|
-| 0 | Branch matches expected (silent). |
-| 0 + stderr | Warning logged, but proceed. |
-| Non-zero | Block the tool call. |
-
-## hook sql-mutation-guard
-
-PreToolUse guard for MCP SQL execution tools. Reads the tool input, matches against the runtime config's `mcpGuards.sqlMutation` patterns, and blocks `INSERT`/`UPDATE`/`DELETE`/DDL against the configured "no-mutate" servers.
-
-```bash
-echo '{"tool":"mcp__plugin_acme-dev_cert__execute_sql","tool_input":{"sql":"UPDATE x SET ..."}}' \
-  | agent-workflow hook sql-mutation-guard
-```
-
-The patterns live in `~/.<namespace>/lib/config/<namespace>-runtime.json`. Configure them with the MCP server names that must be read-only, such as `cert` and `prod`.
-
-Exit codes: same conventions as `branch-check`.

package/skills/agent-workflow/references/legacy-anchors.md

@@ -1,50 +0,0 @@
-# Legacy anchors — alias permanentes `qtc:<topic>` → `agent-workflow:<topic>`
-
-Política definida en `docs/especificaciones/003-migracion-lifecycle-a-aw/MAPPING.md` §"Política de anchors": el SKILL universal expone anchors `agent-workflow:<topic>` como nombre canónico. Los anchors `qtc:<topic>` se mantienen como **aliases permanentes** dentro del SKILL universal para que CLAUDE.md / AGENTS.md / READMEs / docs históricos que referencien `qtc:*` no rompan.
-
-## Tabla de aliases
-
-| Legacy anchor | Anchor canónico | Razón |
-|---|---|---|
-| `qtc:commits-policy` | `agent-workflow:commits-policy` | doctrina universal de commit messages |
-| `qtc:sandbox-readonly` | `agent-workflow:sandbox-readonly` | plan mode read-only |
-| `qtc:mcp-readonly` | `agent-workflow:mcp-readonly` | MCP SELECT/EXPLAIN/\d only |
-| `qtc:redaccion-simple` | `agent-workflow:redaccion-simple` | estilo de prosa |
-| `qtc:coding-standards` | `agent-workflow:coding-standards` | estándares por stack |
-| `qtc:graduacion-routing` | `agent-workflow:graduacion-routing` | routing kind por hub/fuente |
-| `qtc:branch-verification` | `agent-workflow:branch-verification` | gate de rama por fuente |
-
-## Anchors de skills (agent-workflow:*)
-
-Los nombres de skill también funcionan como anchors:
-
-| Legacy | Canónico |
-|---|---|
-| `qtc:session` | `agent-workflow:session` |
-| `qtc:resume` | `agent-workflow:resume` |
-| `qtc:compact` | `agent-workflow:compact` |
-| `qtc:rules` | `agent-workflow:rules` |
-| `qtc:doctor` | `agent-workflow:doctor` |
-| `qtc:migrate` | `agent-workflow:migrate` |
-| `qtc:project-init` | `agent-workflow:project-init` |
-| `qtc:hub-init` | `agent-workflow:hub-init` |
-| `qtc:export-*` (9 commands) | `agent-workflow:export-*` |
-| `qtc:dev-workflow` / `qtc:design-workflow` / `qtc:analyze-workflow` | `agent-workflow:dev-workflow` / etc. |
-
-## Empresas que quieran shadow propios
-
-Cualquier empresa puede inyectar sus propios anchors `<empresa>:<topic>` via `profile.custom_anchors[]`:
-
-```json
-{
-  "custom_anchors": [
-    { "anchor": "acme:special-rule", "target": "profiles/anchors/acme-special-rule.md" }
-  ]
-}
-```
-
-El skill `agent-workflow:rules` los renderiza al final del bundle bajo "## Anchors específicos del profile".
-
-## Política de retiro
-
-Los aliases `qtc:*` documentados aquí son **permanentes**. No hay ventana de retiro planeada. El skill `agent-workflow:rules` los expone automáticamente cuando el profile QTC está activo (detectado via `profile.namespace === "qtc"` o cuando `profile.mcp_databases[]` contiene los nombres legacy).

package/skills/agent-workflow/references/mcp.md

@@ -1,34 +0,0 @@
-# MCP / DSN
-
-CLI helpers for MCP server lifecycle and DSN bootstrap.
-
-## mcp dbhub <instance>
-
-Launch the `@bytebase/dbhub` MCP server pre-wired with the namespace's DSN file. The CLI resolves the DSN, sets up environment, and execs `npx @bytebase/dbhub` with the right transport.
-
-```bash
-agent-workflow mcp dbhub cert
-agent-workflow mcp dbhub prod
-```
-
-Connection names map to environment variables in `~/.<namespace>/dev/dsn.env` by default:
-
-| Instance | Reads | Default behavior on missing DSN |
-|---|---|---|
-| `cert` | `DB_CERT_DSN` | stderr message, exit 1 |
-| `prod` | `DB_PROD_DSN` | stderr message, exit 1 |
-
-Custom host entries can set `DBHUB_DSN_VAR` to read an arbitrary DSN variable.
-
-The launcher is the entry point referenced by the plugin's `.mcp.json`. You usually do not invoke it manually — Claude Code / Codex starts it.
-
-## bootstrap-dsn
-
-Persist `DB_CERT_DSN` and `DB_PROD_DSN` from the current shell into the namespace's `dsn.env` file (so subsequent CLI / hook invocations have them).
-
-```bash
-DB_CERT_DSN=postgres://... DB_PROD_DSN=postgres://... agent-workflow bootstrap-dsn
-agent-workflow self mcp
-```
-
-Exit code 2 + `MISSING_DSN` error when neither DSN is set. Writes to `~/.<namespace>/dev/dsn.env`.

package/skills/agent-workflow/references/objetivo-tasks.md

@@ -1,64 +0,0 @@
-# Objetivo / Tasks / Decisions
-
-Read-only parsers for the four canonical session artifacts.
-
-| Artifact | Reader | Purpose |
-|---|---|---|
-| `OBJETIVO.md` | `objetivo-data` | requirement, type, modalidad, criterios |
-| `TASKS.md` | `tasks-data` | open/closed counts, item list, optional verbose body |
-| `DECISIONES.md` | `decisiones-list` | DEC-NNN headers + previews |
-| `DEPENDENCIAS.md` | `dependencias-list` | dependency table rows |
-
-All four accept `--code <sessionNNN>`. Without it, the active session is used (errors if there are 0 or >1 active sessions).
-
-## objetivo-data
-
-Parses `OBJETIVO.md` into structured JSON: requirement, contexto, criterios de aceptación (with checked/unchecked state), tipo (`feature`/`refactor`/`bugfix`), modalidad (`tecnica`/`datos`/`incidente`), temas.
-
-```bash
-agent-workflow objetivo-data --code session035 | jq '.criterios_aceptacion'
-agent-workflow objetivo-data --code session035 | jq '.tipo'
-```
-
-## tasks-data
-
-Parses `TASKS.md` into open/closed counts plus the full item list. Supports phased plans (`## Phase X — Title` sections) and surfaces them as task groups.
-
-```bash
-agent-workflow tasks-data --code session035
-agent-workflow tasks-data --code session035 --only-open    # filter completed items
-agent-workflow tasks-data --code session035 --verbose      # include raw markdown body
-```
-
-Output:
-
-```json
-{
-  "code": "session035",
-  "counts": { "total": 22, "open": 22, "closed": 0 },
-  "phases": [
-    { "name": "Phase 0 — Mapeo+Contrato", "open": 4, "closed": 0 },
-    ...
-  ],
-  "items": [
-    { "id": "T0.1", "phase": "Phase 0", "text": "...", "done": false }
-  ]
-}
-```
-
-## decisiones-list
-
-Lists `DECISIONES.md` entries — DEC-NNN headers with short previews. Pass `--full` to include the full body of each decision.
-
-```bash
-agent-workflow decisiones-list --code session023
-agent-workflow decisiones-list --code session023 --full
-```
-
-## dependencias-list
-
-Lists `DEPENDENCIAS.md` rows as JSON — useful when a session declares cross-source dependencies.
-
-```bash
-agent-workflow dependencias-list --code session035
-```