@tacuchi/agent-workflow-cli 11.0.0 → 12.0.0

package/skills/agent-workflow/docs/TEST-PLAN.md

@@ -1,163 +0,0 @@
-# Test plan — Workflow universal (CLI agent-workflow + skill agent-workflow)
-
-Specs (no implementación). Validan los 3 contratos arquitecturales.
-
-Generable a `skills/agent-workflow/docs/TEST-PLAN.md` para que cualquier consumidor del workflow tenga la batería de aceptación.
-
-## Convenciones
-
-- Cada test tiene: id, contrato, precondición, pasos, criterio de éxito, frontera (lo que NO valida).
-- Estados esperados expresados como JSON observable o efectos de filesystem.
-- Implementación recomendada: vitest (unit/golden) para Contract A; bash/CI smoke para Contract B; bash + namespace alterno para Contract C.
-
-## Contract A — CLI ↔ skill
-
-Cada comando que el skill referencia ejecuta y devuelve la forma JSON declarada por la reference.
-
-### A1 — Surface match
-
-- **Precondición**: CLI instalado globalmente, skill instalado en `~/.claude/skills/agent-workflow`.
-- **Pasos**:
-  1. Listar comandos del CLI (`agent-workflow --help`).
-  2. Para cada comando: parse top-level del SKILL.md y de las 11 references; verificar que aparece exactamente en 1 reference.
-- **Criterio**: 43 comandos listados, 43 menciones en exactamente 1 reference cada uno. 0 huérfanos.
-- **Frontera**: no valida la forma del JSON ni la implementación de cada comando.
-
-### A2 — JSON contract por comando
-
-- **Precondición**: workspace de prueba con bloque `<NS>-PROJECT` y al menos una sesión.
-- **Pasos** (por cada comando read-only):
-  1. Ejecutar `agent-workflow <cmd> [flags] | jq '.'`.
-  2. Validar que `jq` retorna 0 (JSON parseable).
-  3. Validar que las claves top-level matchean lo declarado en la reference.
-- **Criterio**: 100% de comandos read-only retornan JSON parseable con shape declarado.
-- **Frontera**: no valida correctness semántica de los valores (solo shape).
-
-### A3 — Error envelope
-
-- **Precondición**: workspace donde el namespace activo no existe.
-- **Pasos**:
-  1. Correr `agent-workflow --namespace invalid sessions`.
-  2. Capturar stdout + stderr + exit code.
-- **Criterio**: exit code ≠ 0, stderr o stdout incluye `error.code = "NOT_IN_WORKSPACE"` (o equivalente declarado).
-- **Frontera**: no valida cobertura exhaustiva de error codes.
-
-## Contract B — Skill ↔ usuario externo
-
-Una empresa nueva instala skill + CLI y completa un workflow E2E sin tocar plugins.
-
-### B1 — Install path
-
-- **Precondición**: máquina sin `agent-workflow` ni skill instalado.
-- **Pasos**:
-  1. `npm install -g @tacuchi/agent-workflow-cli`.
-  2. `agent-workflow self install-skill`.
-  3. `agent-workflow self doctor`.
-- **Criterio**: doctor reporta `cli_version >= 1.2.0`, `skill.installed = true`, `skill.path` apunta al directorio correcto.
-- **Frontera**: no valida ediciones de `~/.claude/settings.json` ni hook registration.
-
-### B2 — Workflow E2E (fresh namespace)
-
-- **Precondición**: directorio `/tmp/acme-test` vacío, `git init` ejecutado.
-- **Pasos**:
-  1. `cd /tmp/acme-test && agent-workflow --namespace acme project-md-upsert --init`.
-  2. `agent-workflow --namespace acme session-create --flow dev --name first-feature --objetivo "Implementar lo que sea"`.
-  3. `agent-workflow --namespace acme tasks-data --code session001`.
-  4. `agent-workflow --namespace acme checkpoint-write --code session001`.
-  5. `agent-workflow --namespace acme checkpoint-read --code session001`.
-  6. `agent-workflow --namespace acme session-close --code session001`.
-- **Criterio**:
-  - Tras paso 1: `CLAUDE.md` (o `AGENTS.md`) contiene bloque `<!-- ACME-PROJECT-START -->`.
-  - Tras paso 2: directorio `.acme/sessions/session001-dev-first-feature/` con `OBJETIVO.md`.
-  - Tras paso 6: `HISTORY.md` muestra fila con state = closed.
-- **Frontera**: no valida invocación desde Claude Code real (eso es B3).
-
-### B3 — Skill consumption en Claude Code (manual)
-
-- **Precondición**: B1 + B2 ejecutados; Claude Code abierto en `/tmp/acme-test`.
-- **Pasos**:
-  1. Pedirle al modelo: "create a session for fixing the login bug".
-  2. Observar si el modelo invoca el skill `agent-workflow`.
-  3. Observar comandos ejecutados por el modelo.
-- **Criterio**: el modelo lee SKILL.md, identifica `session-create`, lo ejecuta con namespace correcto.
-- **Frontera**: depende de que la SessionStart del entorno setee `AW_NAMESPACE` o el modelo use `--namespace`.
-
-## Contract C — Plugins downstream sin lógica universal
-
-El workflow universal opera con namespaces alternativos y produce resultados equivalentes.
-
-### C1 — Equivalencia operacional
-
-- **Precondición**: workspace con plugins instalados + workspace alternativo "vanilla" (sin plugins, con bloque `<NS>-PROJECT` propio).
-- **Pasos**: ejecutar la misma secuencia (`session-create → tasks-data → checkpoint-write → session-close`) en ambos workspaces, con namespaces respectivos.
-- **Criterio**: ambos generan estructuras isomorfas (`.<ns>/sessions/sessionNNN-dev-<slug>/OBJETIVO.md` + fila en `HISTORY.md` + bloque `<NS>-PROJECT` actualizado). Diferencias permitidas: contenido de `OBJETIVO.md` (texto), header del bloque project (`WORKFLOW-PROJECT` vs `ACME-PROJECT`).
-- **Frontera**: no valida los skills de negocio downstream — esos son específicos del namespace.
-
-### C2 — Plugins downstream no implementan lifecycle
-
-- **Precondición**: repos del plugin downstream accesibles.
-- **Pasos**:
-  1. `grep -rn "def session_create\|function sessionCreate\|create_session" <plugin-root>/skills/` (debe retornar 0 hits).
-  2. `find <plugin-root> -name "*.py"` (debe retornar 0 archivos si el plugin es sólo skills/hooks declarativos).
-  3. Para cada hook en `hooks.json`: validar que invoca `agent-workflow ...` (no script local).
-- **Criterio**: 0 funciones de lifecycle, 0 archivos Python, 100% de hooks invocan al CLI.
-- **Frontera**: no valida que los skills de negocio sean correctos — solo que no duplican lógica universal.
-
-### C3 — `AW_NAMESPACE` propagation
-
-- **Precondición**: nuevo Claude Code session en workspace del plugin.
-- **Pasos**:
-  1. Esperar SessionStart hook.
-  2. Verificar `cat ~/.config/agent-workflow/namespace`.
-  3. Correr `agent-workflow self namespace`.
-- **Criterio**: archivo contiene el namespace esperado, comando reporta `{ namespace: "<namespace>", source: "user-config" }` (o "workspace" si detectó bloque local).
-- **Frontera**: no valida cómo plugins no instalados propagan su namespace.
-
-## Contract D — Hooks (cobertura faltante en tests del CLI)
-
-Estos tests cierran H4 (gap de tests existentes en agent-workflow/tests/).
-
-### D1 — `hook branch-check`
-
-- **Precondición**: workspace con sesión que declara `expected_work_branch = main`; checkout en `feature/x`.
-- **Pasos**: `echo '{"tool_input":{"file_path":"src/foo.ts"}}' | agent-workflow hook branch-check`.
-- **Criterio**: exit 2 (block), stdout JSON con `{ match: false, expected: "main", current: "feature/x" }`.
-- **Frontera**: no valida MultiEdit/NotebookEdit (covered por Anthropic harness).
-
-### D2 — `hook sql-mutation-guard`
-
-- **Precondición**: payload de MCP con SQL DML.
-- **Pasos**: `echo '{"tool_input":{"sql":"UPDATE foo SET x=1"}}' | agent-workflow hook sql-mutation-guard`.
-- **Criterio**: exit 2, stdout JSON con `{ blocked: true, reason: "DML detected" }` (o equivalente).
-- **Frontera**: no valida SELECT/EXPLAIN (deben pasar — cubrir en D2.b).
-
-### D3 — `mcp dbhub` smoke
-
-- **Precondición**: DSN persistido vía `bootstrap-dsn`.
-- **Pasos**: `agent-workflow mcp dbhub cert` con stdin/stdout MCP frame de `initialize`.
-- **Criterio**: el binario lanza `@bytebase/dbhub` vía npx y devuelve respuesta MCP válida.
-- **Frontera**: no valida queries ejecutadas (las hace dbhub).
-
-### D4 — `plugin-doctor`
-
-- **Precondición**: plugin root válido.
-- **Pasos**: `agent-workflow plugin-doctor --plugin-root /Users/tacuchi/Git/core-workflow-plugin`.
-- **Criterio**: JSON con `status: "ok"` o `findings: []`. Si manifests no declaran `exportedSkills`, dejar warning explícito (no error).
-- **Frontera**: no valida correctness de los skills exportados — solo presencia.
-
-## Resumen
-
-| Contract | Tests | Severidad |
-|---|---|---|
-| A — CLI ↔ skill | 3 (A1, A2, A3) | crítica |
-| B — Skill ↔ usuario externo | 3 (B1, B2, B3) | alta |
-| C — Plugins downstream sin lógica universal | 3 (C1, C2, C3) | alta |
-| D — Hooks gap | 4 (D1, D2, D3, D4) | media |
-| **Total** | **13 specs** | |
-
-Implementación recomendada (no en alcance):
-- A1, A2, A3 → vitest unit en `agent-workflow/tests/unit/`.
-- B1, B2 → bash + golden fixtures en `agent-workflow/tests/golden/external-namespace.test.ts`.
-- B3 → manual + grabado en `skills/agent-workflow/MANUAL-FUNCIONAL.md`.
-- C1, C2, C3 → bash + workspace fixture comparativo.
-- D1..D4 → vitest unit con stdin mock + spawn snapshot.

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

@@ -1,15 +0,0 @@
-# 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`.

package/skills/agent-workflow/doctrine/compact/SKILL.md

@@ -1,145 +0,0 @@
----
-name: compact
-description: Persiste estado de la sesión activa en CHECKPOINT.md y dispara /compact host. Invocado vía /agent-workflow:compact, NL como compactá/guardá estado/checkpoint, automáticamente desde el SessionEnd hook al cerrar el cliente, o como último paso del cierre de sesión.
-version: 2.4.0
----
-
-# Compact — qtc v2.2
-
-Persiste el estado de la sesión activa antes de un compact del contexto. Combina:
-
-1. **Auto-extracción** (CLI `agent-workflow checkpoint-write`): phase, TASKS counts, decisiones recientes, archivos tocados, branches.
-2. **Síntesis del AI**: "Last action", "Next step", "Critical context to resume" (legacy ES: "Lo último que hice", "Próximo paso", "Contexto crítico para retomar").
-3. **Hand-off al host**: `/compact` nativo de Claude Code/Codex.
-
-El resultado: `.workflow/sessions/<folder>/CHECKPOINT.md` escrito + contexto liberado.
-
-## Dos caminos al compact
-
-Hay dos formas de compactar contexto en CC/Codex y producen calidad de síntesis distinta:
-
-| Camino | Cuándo usar | Síntesis | Calidad |
-|---|---|---|---|
-| `/agent-workflow:compact` (skill) | Antes de un compact planeado, cuando querés cierre limpio. | **Pre-compact con contexto vivo**: el AI rellena placeholders mirando la conversación entera + diffs + decisiones. | Alta — el AI tiene todo. |
-| `/compact` directo (host) | Compact ad-hoc o automático por umbral de contexto. | **Post-compact con `resume-summary`**: el AI rellena placeholders después del compact, leyendo el JSON del hook + CHECKPOINT.md draft + TASKS.md + DECISIONS.md de disco. | Reducida — el AI ya no ve la conversación previa, solo lo que quedó persistido en disco. |
-
-**Regla**: si para algún placeholder en el camino post-compact no tenés info suficiente, escribí `_(sin info — completar al retomar)_` en lugar de inventar. El usuario completa al hacer `/agent-workflow:resume` si necesita.
-
-El camino post-compact lo coordinan los hooks `PreCompact` y `PostCompact` del plugin (ver `hooks/hooks.json`). Importante: por bug del host ([anthropics/claude-code#13572](https://github.com/anthropics/claude-code/issues/13572)) el `PreCompact` puede no disparar en `/compact` manual. El `PostCompact` mitiga este caso: si `checkpoint_status == "missing"` el AI regenera el draft via `checkpoint-write` y luego rellena.
-
-## Triggers
-
-- **Slash explícito**: `/agent-workflow:compact`.
-- **NL del usuario**: "compactá", "guardá estado", "checkpoint", "vamos a compactar".
-- **Automático en SessionEnd hook**: al cerrar Claude Code/Codex, el hook escribe CHECKPOINT.md (no dispara `/compact` host porque la sesión ya termina).
-- **Automático en cierre de sesión**: el último paso de la skill `session` (closure) invoca `compact`.
-- **AI auto-trigger por contexto >75%**: cuando el AI estima carga de contexto >75% del modelo activo (heurística manual, no medición exacta), disparar `AskUserQuestion` con spec de M11 (`../session/references/prompts-catalog.md#M11`). Header `context`, 3 opciones (Compact ahora / Seguir, compact después / Cerrar sesión). Si elige "Compact ahora" → continuar con los pasos 1-5 abajo. Si elige otra → respetar la elección y dejar nota informal en CHECKPOINT.md cuando corresponda. **Si la sesión está en `closure`**: skip M11 (closure ya dispara compact opcional). NO narrar la pregunta en texto plano.
-
-## Acción
-
-### 1. Detectar sesión activa
-
-```
-agent-workflow project-md-upsert --read
-```
-
-Si no hay activa → mensaje "no hay sesión activa para checkpointar" y stop.
-
-Si hay UNA → continuar.
-
-Si hay VARIAS → preguntar al usuario cuál (o hacer una por una).
-
-### 2. Escribir draft auto-extraído
-
-```
-agent-workflow checkpoint-write --code <CODE> --force
-```
-
-`--force` asegura draft fresco aunque exista un CHECKPOINT.md sintetizado previo (su síntesis estaría desactualizada respecto al estado actual de la sesión).
-
-Esto crea `.workflow/sessions/<folder>/CHECKPOINT.md` con:
-
-- Header con timestamp, fase, avance %.
-- Decisión más reciente (si hay).
-- Archivos tocados (git diff vs HEAD).
-- Refs (origen, ramas, artefactos presentes).
-
-Y deja **placeholders** `_[AI: …]_` en los campos que requieren juicio:
-
-- "Last action"
-- "Next step"
-- "Critical context to resume"
-- Propósito de cada archivo tocado
-- Skills usadas en la sesión
-
-### 3. Completar los placeholders
-
-El AI lee el CHECKPOINT.md draft y reemplaza CADA placeholder con texto sintetizado de la conversación reciente:
-
-- **Last action** (legacy ES: "Lo último que hice"): 1-3 oraciones del último avance concreto. Mirá los últimos diffs aplicados, la última entrada de DECISIONS.md.
-- **Next step** (legacy ES: "Próximo paso"): 1-2 oraciones de qué falta. Mirá el primer item abierto de TASKS.md y cualquier blocker mencionado.
-- **Critical context to resume** (legacy ES: "Contexto crítico para retomar"): 2-3 párrafos con info mínima para continuar sin re-explorar. Qué descubriste, qué decisiones tomadas, qué tener presente.
-- **Propósito de archivos**: 1 línea por archivo tocado.
-- **Skills usadas**: lista de skills invocadas durante la sesión (implement, coding-standards, sql-script-organizer, etc.).
-
-Editá el archivo con `Edit` tool — preservá la estructura, sólo cambiá el placeholder por el contenido real.
-
-### 4. Disparar /compact host
-
-Tras editar el CHECKPOINT.md:
-
-> Decir al usuario: "Estado guardado en `.workflow/sessions/<folder>/CHECKPOINT.md`. Ahora corro `/compact` para liberar contexto."
-
-Y ejecutar `/compact` (comando nativo).
-
-Si el trigger fue **SessionEnd hook**, **NO disparar /compact** — la sesión ya termina; sólo escribir y salir.
-
-### 5. Resumir al usuario
-
-1-2 líneas. Path del CHECKPOINT, fase actual, próximo paso. Útil si está por cerrar la PC.
-
-## Ejemplo de invocación
-
-Usuario: "compactá"
-
-AI:
-1. Detecta `session046-dev-jobs-async` activa.
-2. Corre `agent-workflow checkpoint-write --code 046`. Output:
-   ```json
-   {
-     "session": "session046-dev-jobs-async",
-     "checkpoint_path": ".workflow/sessions/session046-dev-jobs-async/CHECKPOINT.md",
-     "phase": "execution",
-     "progress_pct": 60,
-     "tasks_open": 2,
-     "tasks_closed": 3,
-     "files_touched_count": 4
-   }
-   ```
-3. Lee el CHECKPOINT.md draft, edita los placeholders con síntesis.
-4. Confirma al usuario: "Estado guardado. Disparo `/compact`."
-5. Corre `/compact`.
-
-## Política — sin fallback al CLI
-
-Si `agent-workflow checkpoint-write` o `agent-workflow project-md-upsert` falla (no está en PATH, comando no reconocido, exit code != 0), **cortá la acción y reportá al usuario**: pedile que verifique `npm install -g @tacuchi/agent-workflow-cli`. No hay flujo alternativo Python.
-
-## Sandbox read-only
-
-Reglas universales en `../session/references/sandbox-readonly-rules.md` (canon agent-workflow).
-
-En plan mode esta skill **no ejecuta** `agent-workflow checkpoint-write`, ni `Edit` sobre CHECKPOINT.md, ni `/compact`. Describe en el plan file:
-
-- `.workflow/sessions/<folder>/CHECKPOINT.md` — crearía/sobrescribiría con formato §17 shared-contract. Resumir: timestamp, fase, avance %, lo último (sintetizado por AI), próximo paso, contexto crítico, refs.
-- Síntesis del AI a aplicar a placeholders: enumerar campos (`Last action`, `Next step`, `Critical context to resume`, propósito de archivos tocados, skills usadas).
-- Confirmación de que se dispararía `/compact` host (o NO si el trigger es SessionEnd hook).
-
-No invocar el sub-comando `checkpoint-write` ni siquiera con `--dry-run` salvo que el comando expusiera ese flag explícitamente — hoy no lo expone, así que abstenerse.
-
-## Recursos
-
-- `agent-workflow checkpoint-{read,write}` — comandos CLI que leen/escriben el CHECKPOINT.md.
-- shared-contract.md §17 — formato canónico de CHECKPOINT.md.
-- shared-contract.md §18 — close-triggers-compact convention.
-- **`agent-workflow:redaccion-simple`** — guía de redacción para los placeholders `_[AI: ...]_` de CHECKPOINT.md. Aplicar al rellenar (frases cortas, sin párrafos, sin relleno).
-- **`../session/references/commits-policy.md`** — el `compact` **no commitea** CHECKPOINT.md por iniciativa propia; el commit (si aplica) lo dispara el closure de `session` o el usuario explícitamente.

package/skills/agent-workflow/doctrine/doctor/SKILL.md

@@ -1,86 +0,0 @@
----
-name: doctor
-description: "Health check read-only de la familia agent-workflow. Orquesta `agent-workflow plugin-doctor` por fuente declarada en `agent-workflow sources` (hub mode) o sobre el cwd (single-repo). Default scope = all en hub, cwd en single-repo. Reporta versión del manifest, integridad de hooks, presencia de SKILL.md con frontmatter completo, runtime.json instalado y MCP config si aplica. Sin acciones ni mutaciones — sólo diagnóstico."
-version: 1.0.0
----
-
-> **Profile parametrization**: lee `mcp_databases[]` de `profile.json` (resuelto vía cascade 5 capas). Ver [`references/profile-parametrization.md`](../../references/profile-parametrization.md) para el contrato completo y comportamiento por defecto cuando el profile está vacío.
-
-# Doctor — agent-workflow health check (orquestador)
-
-Skill canónica del comando `/agent-workflow:doctor`. Orquesta diagnósticos read-only sobre los plugins agent-workflow declarados en el workspace. El trabajo pesado lo hace el CLI runtime (`@tacuchi/agent-workflow-cli`); esta skill resuelve el scope, llama al CLI por plugin y agrega los resultados.
-
-## Cuándo se invoca
-
-- Comando `/agent-workflow:doctor` (tanto Claude Code como Codex).
-- NL: "¿está sano el plugin?", "diagnóstico de qtc", "doctor de plugins", "health check del hub".
-- Pre-release: antes de publicar el plugin se chequea con `--scope <plugin>`.
-
-## Scope resolution
-
-1. Leer args:
-   - `--scope <alias|all>` explícito.
-   - `--plugin-root PATH` directo (single-repo o testing).
-2. Si no hay args: `agent-workflow workspace-mode`. Si retorna `hub` → `--scope all`. Si `project` → `--plugin-root <cwd>`.
-3. `--scope all` (hub): `agent-workflow sources` → filtrar fuentes con manifest `.claude-plugin/plugin.json` o `.codex-plugin/plugin.json` y aplicar `plugin-doctor` a cada path.
-
-## Ejecución por plugin
-
-```
-agent-workflow plugin-doctor --plugin-root <path>
-```
-
-Output esperado (por plugin):
-
-- `status` ∈ `ok` | `warn` | `error`.
-- `plugin_version` desde el manifest.
-- `manifests` = comparación claude vs codex (versiones coincidentes).
-- `hooks` = parseo de `hooks/hooks.json` y `codex-hooks/hooks.json`.
-- `skills` = barrer `skills/*/SKILL.md`, validar frontmatter (`name`, `description`, `version` semver) y matching `name == dirname`.
-- `runtime` = presencia de `~/.workflow/agent-workflow/runtime.json` (agent-workflow only).
-- `mcp_config` = `.mcp.json` si aplica.
-- `errors[]` y `warnings[]`.
-
-## Salida
-
-### Tabla compacta (scope=all)
-
-```
-plugin                       version    status   findings
-──────────────────────────   ────────   ──────   ────────
-agent-workflow          2.2.2      ok       —
-otro-plugin                  1.0.0      warn     SKILL.md sin version
-```
-
-Resumen final: `<N>/M plugins ok` o lista de findings.
-
-### Detallado (scope=<alias> o --plugin-root)
-
-Mostrar el JSON completo de `plugin-doctor` + interpretación humana.
-
-## Accionables típicos
-
-- `agent-workflow CLI not found in PATH` → `npm install -g @tacuchi/agent-workflow-cli`.
-- `manifest version mismatch claude vs codex` → editar y bumpear coordinado.
-- `runtime.json missing` → reload del cliente (SessionStart hook lo escribe).
-- `SKILL.md sin frontmatter completo` → ver `agent-workflow:redaccion-simple` para canon.
-
-## Sandbox read-only
-
-Canon universal en `../session/references/sandbox-readonly-rules.md`. Read-only por construcción — el subcomando CLI `agent-workflow plugin-doctor` sólo consulta estado (versiones, namespaces, paths, fuentes registradas) sin mutar plugins ni fuentes.
-
-En plan mode: describir en el plan file los checks que correrían (per-fuente, scope `all`/`hub`/`single-repo`) sin invocar el CLI. NO ejecuta `Write`, `Edit`, ni comandos que muten estado de plugins/fuentes/workspace.
-
-Compatible con plan mode sin restricciones adicionales.
-
-## Composición
-
-| Skill | Cuándo |
-|---|---|
-| `agent-workflow` (CLI skill) | Ejecuta el `plugin-doctor` por fuente. |
-| `agent-workflow:hub-init` / `agent-workflow:project-init` | Si `workspace-mode` no detecta el bloque AW-PROJECT. |
-
-## Referencias
-
-- `commands/doctor.md` — entry point del slash command (Claude Code y Codex).
-- `agent-workflow plugin-doctor --help` — flags disponibles del CLI runtime.

package/skills/agent-workflow/doctrine/hub-init/SKILL.md

@@ -1,77 +0,0 @@
----
-name: hub-init
-description: Inicializa workspace Hub multi-repo — escribe el bloque AW-PROJECT en modo hub (≥2 fuentes con rutas y ramas) y SIEMPRE configura la visibilidad multi-root (settings.local.json + config.toml, gitignored), reconciliando fuentes agregadas/removidas. Sin prompt. La forma interactiva vive en el TUI (tab Project → Initialize as hub). Invocado vía /agent-workflow:hub-init.
-version: 2.1.0
----
-
-> **Profile parametrization**: lee `claude_md_block` de `profile.json` (cascade 5 capas). Ver [`references/profile-parametrization.md`](../../references/profile-parametrization.md).
-
-# Hub Init
-
-Escribe el bloque AW-PROJECT para un workspace **multi-repo** (hub mode). El marcador `Mode: hub` activa heurísticas hub-aware en el resto de la familia. Además del bloque, **siempre** configura la visibilidad multi-root para que los hosts (Claude Code / Codex) vean los repos fuente — sin preguntar, en cada run.
-
-## La vía fácil: el TUI
-
-Lo más simple es el form interactivo: `agent-workflow` → tab **Project** → **Initialize as hub**. Pide nombre + paths de fuentes (alias inferido de la carpeta) + rama base, todo dentro del TUI. No hay que recordar flags.
-
-## Cuándo usar la vía CLI/host
-
-- Workspace que coordina ≥2 repos pares.
-- Promover un workspace `project` que creció a multi-repo.
-- Agregar o remover una fuente de un hub existente (re-correr con el set nuevo).
-
-## Flujo (host) — mínimo
-
-No sobre-validar ni preguntar de más. El comando persiste lo declarado y sincroniza la visibilidad solo.
-
-1. **Detectar bloque** (rápido): `agent-workflow workspace-mode` → `{mode, is_hub, ...}`. Si ya es hub → preguntar si agregar/reiniciar. Si es `project` con fuentes → ofrecer promover. Bloque legacy `<!-- QTC-WORKFLOW-START -->` → delegar a `/agent-workflow:migrate`.
-2. **Reunir datos**: descripción (1 línea), ≥2 fuentes (alias + path), rama base (default `certificacion`) y **rama de trabajo** (la feature branch donde se trabajará). El alias se infiere del nombre de la carpeta si no se da. La rama de trabajo **siempre se solicita**: si el usuario no la declaró en el mensaje, preguntala vía `AskUserQuestion` antes de ejecutar — no la asumas ni la omitas en silencio.
-3. **Escribir + sincronizar** (un solo comando):
-
-   ```
-   agent-workflow hub-init \
-     --proyecto "<descripción>" \
-     --fuente "alias1:path1" --fuente "alias2:path2" \
-     [--working-branch "alias1:rama1" ...] \
-     [--main-branch <rama>]
-   ```
-
-   Rutas Windows (`C:\Source\...`) van directo — el parser respeta el colon de unidad. Escribe `CLAUDE.md` + `AGENTS.md` (`## Proyecto` Mode: hub + `## Fuentes` + `## Stack` + `## Status`) **y** configura la visibilidad multi-root (ver abajo). No hace falta un paso aparte.
-4. **Reportar**: fuentes registradas, paths con visibilidad, y próximo paso (`/agent-workflow:session "<objetivo>"`).
-
-## Visibilidad multi-root (automática, siempre)
-
-`hub-init` configura la visibilidad en **cada** run, sin prompt:
-
-- **Target gitignored**: `<hub>/.claude/settings.local.json` (`permissions.additionalDirectories`) + `<hub>/.codex/config.toml` (`additional_writable_roots` + `[projects.'<path>'] trust_level`). Las rutas son absolutas/machine-specific, así que van en archivos per-máquina; `hub-init` también asegura el `.gitignore`.
-- **Reconcile**: attachea las fuentes actuales y detachea las que estaban en el bloque previo y ya no (agregar/remover quedan sincronizados).
-- Diagnóstico: `agent-workflow visibility doctor --workspace .` (lee `settings.json` **y** `settings.local.json`). Legacy global contaminado: `visibility doctor --global` + `detach-multiroot --global --from-sources`.
-
-## Flags
-
-- `--working-branch <alias:rama>` — rama de trabajo por fuente (repetible). Solicitala siempre (ver Reglas).
-- `--main-branch <rama>` — override del default `certificacion`.
-- `--workspace <DIR>` — override si el CWD no es la raíz del hub.
-- `--dry-run` — previsualizar sin escribir (bloque + paths que se attachearían).
-
-## Reglas
-
-- **Mínimo 2 fuentes**. Si quiere 1 → `/agent-workflow:project-init`.
-- **Rama de trabajo siempre solicitada**: el flujo debe pedir la rama de trabajo (la feature branch) tanto al iniciar como al modificar fuentes. Si no viene en el mensaje, preguntala (`AskUserQuestion`); nunca la omitas en silencio. Se pasa con `--working-branch alias:rama` (repetible; aplicá la misma rama a todas las fuentes si el usuario así lo indica). Si explícitamente no quiere una, queda solo la rama base.
-- **Set autoritativo**: el `--fuente` declarado **reemplaza** el bloque (no merge). Para agregar/remover fuentes, pasá el set completo deseado (el form del TUI ya lo hace; por CLI, leé las fuentes actuales con `workspace-mode` y pasá el set final). `hub-init` reconcilia la visibilidad: detacha las removidas, attacha las actuales.
-- **Visibilidad siempre**: se configura sola, sin preguntar, en init y en cualquier cambio de fuentes. No hay opt-out (salvo `--dry-run`, que no escribe nada).
-- **Idempotente**: re-ejecución con datos idénticos es no-op (attach ya presente, sin cambios).
-- **No tocar legacy QTC-WORKFLOW**: avisar y delegar a migrate.
-
-## Política — sin fallback al CLI
-
-Si `agent-workflow workspace-mode|hub-init|attach-multiroot|visibility` falla (no está en PATH, exit ≠ 0), **cortá la acción y reportá**: pedí verificar `npm install -g @tacuchi/agent-workflow-cli`. No hay flujo Python alterno.
-
-## Sandbox read-only
-
-`../session/references/sandbox-readonly-rules.md`. En plan mode describí: archivos a crear (`CLAUDE.md`, `AGENTS.md`, `.claude/settings.local.json`, `.codex/config.toml`, `.gitignore`) y el bloque AW-PROJECT (fuentes + ramas + `Mode: hub`). NO ejecutar `hub-init` / `attach-multiroot` en plan mode.
-
-## Recursos
-
-- **`references/multiroot-manual.md`** — detalle de la visibility / formato de cada archivo.
-- **`/agent-workflow:project-init`** — equivalente single-repo.

package/skills/agent-workflow/doctrine/hub-init/references/multiroot-manual.md

@@ -1,51 +0,0 @@
-# Multi-root manual — snippets de referencia
-
-Si el usuario declina la automatización de `attach-multiroot`, o si solo usa uno de los dos clientes, mostrarle estos snippets para configurar manualmente.
-
-## Claude Code (`<workspace>/.claude/settings.json` o `~/.claude/settings.json`)
-
-```json
-{
-  "permissions": {
-    "additionalDirectories": [
-      "C:/Source/repo-1",
-      "C:/Source/repo-2"
-    ]
-  }
-}
-```
-
-Alternativa por sesión: `/add-dir <path>` por fuente.
-
-## Codex CLI (`<workspace>/.codex/config.toml` o `~/.codex/config.toml`)
-
-```toml
-additional_writable_roots = [
-  "C:/Source/repo-1",
-  "C:/Source/repo-2"
-]
-
-[projects."C:/Source/repo-1"]
-trust_level = "trusted"
-
-[projects."C:/Source/repo-2"]
-trust_level = "trusted"
-```
-
-## Recomendación
-
-- **Per-workspace** es preferible (`<workspace>/...`) para no contaminar la config global con paths específicos del hub.
-- **Global** sólo si todos tus workspaces comparten el mismo set de repos.
-
-## Comandos automáticos equivalentes
-
-```
-# Per-workspace (default desde v3.3.4):
-agent-workflow attach-multiroot --from-sources
-
-# Global (legacy):
-agent-workflow attach-multiroot --from-sources --global
-
-# Revertir global:
-agent-workflow detach-multiroot --from-sources --global
-```