@tacuchi/agent-workflow-cli 11.0.0 → 12.0.0

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

@@ -1,281 +0,0 @@
----
-name: migrate
-description: "Migra artefactos legacy del workspace al formato actual — sesiones de .claude/.codex a .workflow, REQUIREMENTS y artefactos ES (OBJETIVO/DECISIONES/HALLAZGOS/CONCLUSIONES/PROBLEMA/EVIDENCIA/ENTREGA) a EN canon (OBJECTIVE/DECISIONS/FINDINGS/CONCLUSIONS/PROBLEM/EVIDENCE/DELIVERY), QTC-WORKFLOW a AW-PROJECT, fases v3.x al lifecycle universal de 4 fases con CHECKPOINT.md inicial, hub mode promotion, bloque 'Reglas transversales qtc-*' (post-session052), AGENTS.md/CLAUDE.md por fuente (post-session053), wire-up de hooks PreToolUse post-v5.18 (sql-mutation-guard + git-commit-advisor), y consolidación de scripts SQL legacy `scripts/01-04/*.sql` → SCRIPTS.sql único (F-D session062 / sql-script-organizer v1.0.0). Invocado solo vía /agent-workflow:migrate."
-version: 1.4.0
----
-
-> **Profile parametrization**: lee `migrate_legacy_rules[]` 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.
-
-# Migrate (agent-workflow)
-
-Migrar artefactos del workspace desde rutas y formatos legacy hacia la topología actual (v0.8+, lifecycle universal v4.0+, infraestructura de reglas transversales post-session052/053). Vive en agent-workflow (Fase B; antes en qtc-core v3.0+, consolidando los `migrate` que vivían duplicados en qtc-dev/design/analyze).
-
-## Capacidades
-
-1. **Migración de sesiones legacy**: mover sesiones de `.claude/sessions/` y `.codex/sessions/` a `.workflow/sessions/`.
-2. **Migración de project-config**: copiar project-config legacy a `.workflow/project-config.md` (transitorio; en v0.8+ el bloque AW-PROJECT vive en CLAUDE.md/AGENTS.md).
-3. **Upgrade de topología al formato actual (v0.8+)**:
-   - Reemplazar bloque `<!-- QTC-WORKFLOW -->` por `<!-- AW-PROJECT -->` (también acepta `<!-- WORKFLOW-PROJECT -->` como variante actual del marker).
-   - Rename completo de artefactos legacy ES → canon EN (post-R3, ver §"Artefactos R3 EN/ES" abajo):
-     - `REQUIREMENTS.md` / `OBJETIVO.md` → `OBJECTIVE.md`
-     - `DECISIONES.md` → `DECISIONS.md`
-     - `HALLAZGOS.md` → `FINDINGS.md`
-     - `CONCLUSIONES.md` → `CONCLUSIONS.md`
-     - `PROBLEMA.md` → `PROBLEM.md`
-     - `EVIDENCIA.md` → `EVIDENCE.md`
-     - `ENTREGA.md` → `DELIVERY.md`
-   - Rename de tokens embebidos: `## Tipo` → `## Type`, `## Modalidad` → `## Modality` con valores ES→EN (`tecnica`→`technical`, `incidente`→`incident`, `datos`→`data`; `feature|refactor|bugfix|chore` ya en EN).
-   - Absorber `STATUS.md` en `AW-PROJECT.Status`.
-   - Archivar obsoletos (`SCENARIOS`, `CHANGELOG`, `TEST_LOG`, `TEST_STRATEGY`, `CONSULTASSQL`) a `_archived/`.
-   - Rename `assets/` por sesión → `referencias/` (DEC-004).
-4. **Upgrade v0.11.x → v0.12 (rename a qtc-*)**: renombrar carpetas de sesión `sessionNNN-<slug>` → `sessionNNN-<flow>-<slug>`, actualizar HISTORY.md a 7 columnas, mover `~/.developer-workflow/` → `~/.workflow/dev/`.
-5. **Actualización/rebuild de HISTORY.md**.
-6. **Upgrade v3.x → v4.0 (lifecycle universal)**: mapea fases en AW-PROJECT (`requerimiento|plan|implementacion|validacion|cierre` → `planning|execution|validation|closure`) y escribe `CHECKPOINT.md` inicial para sesiones activas.
-7. **Upgrade hub-mode (v3.0+)**: detecta workspaces con ≥2 fuentes sin marcador `Mode:` declarado y promueve a `Mode: hub`. Idempotente. Delega a `agent-workflow upgrade-hub-mode`.
-8. **Upgrade transversal-rules block (post-session052, extendido post-session090)**: detecta workspaces sin la sección `## Reglas transversales qtc-*` en CLAUDE.md/AGENTS.md y propone agregarla (8 anchors canónicos + puntero a `Skill(agent-workflow:rules)`). Aplica a hub workspaces principalmente; también a project workspaces qtc-* que usen el lifecycle qtc-*.
-9. **Upgrade per-fuente anchors (post-session053)**: detecta repos qtc-* fuente (declarados en AW-PROJECT.Fuentes) que no tienen `AGENTS.md` o `CLAUDE.md` en su raíz y propone crearlos con preludio repo-específico ≤2 líneas + bloque transversal.
-10. **Upgrade hooks PreToolUse post-v5.18 (agent-workflow como workspace)**: aplica solo si el workspace ES el repo `agent-workflow` (workspace de desarrollo del plugin). Detecta `hooks/hooks.json` y `codex-hooks/hooks.json` sin matchers `mcp__.*__execute_sql` ni `Bash` en `PreToolUse[]` y propone agregarlos.
-
-11. **Upgrade scripts SQL: layout legacy → SCRIPTS.sql consolidado (F-D session062, v1.3.0)**: detecta sesiones que tienen carpeta `scripts/` con sub-carpetas `01-ddl-tablas/`, `02-ddl-funciones/`, `03-migracion/`, `04-inserts/` (layout v0.x de `sql-script-organizer`) y produce `SCRIPTS.sql` único en la raíz de la sesión consolidando todas las sentencias.
-
-    **Algoritmo**:
-    1. Por cada sesión candidata: leer `scripts/01-*/`*.sql, `scripts/02-*/`*.sql, `scripts/03-*/`*.sql, `scripts/04-*/`*.sql en orden ascendente por filename.
-    2. Concatenar en `SCRIPTS.sql` (uppercase EN canon) en la raíz de la sesión:
-       - Header global `-- ============... SCRIPTS.sql — sessionXXX-...` (ver `agent-workflow/skills/sql-script-organizer/references/scripts-sql-format.md`).
-       - `BEGIN;`.
-       - Para cada archivo legacy: marker `-- @category: <carpeta>` + `-- @stmt: <filename-sin-ext>` antes del cuerpo. Preservar el cuerpo SQL tal cual (idempotencia ya estaba).
-       - `COMMIT;` al final.
-    3. Eliminar archivos `.rollback.sql` durante la migración (la nueva política es on-export; sus rollbacks se regenerarán al correr `/agent-workflow:export-scripts`).
-    4. **Opcional (prompt al usuario)**: borrar las carpetas legacy `scripts/01-04/` post-consolidación. Default: mover a `.workflow/sessions/<folder>/_archived/scripts-legacy/` para reversibilidad.
-    5. **Idempotente**: si ya existe `SCRIPTS.sql` y no hay sub-carpetas legacy → no-op silencioso.
-    6. **Conflict**: si existen AMBOS (SCRIPTS.sql + scripts/01-04/) → reportar y pedir decisión al usuario (puede ser que la migración haya quedado a medias).
-
-    **Indicadores de detección**:
-    - Existe `.workflow/sessions/<folder>/scripts/01-ddl-tablas/` o equivalentes Y NO existe `SCRIPTS.sql` en raíz.
-    - Filename de archivos en sub-carpetas: `^\d{2,3}-[a-z0-9-]+\.sql$`.
-
-    **Trigger desde `/agent-workflow:export-scripts`**: si export-scripts detecta layout legacy y aborta (G2), el mensaje sugiere `/agent-workflow:migrate --upgrade-topology`. Ejecutar la migración hace que la próxima corrida de export-scripts proceda.
-
-12. **Upgrade referencias globales (DEC-004 v2, session080, v1.4.0)**: detecta sesiones con carpeta `.workflow/sessions/<folder>/referencias/` (DEC-004 v1, scope por-sesión) y consolida el contenido a `<workspace-root>/docs/referencias/` (DEC-004 v2, scope transversal). Opt-in vía `--upgrade-referencias-globales`. Default: no toca contenido legacy.
-
-    **Por qué**: a partir de DEC-004 v2, el AI ya no lee la carpeta `referencias/` por-sesión. Si el contenido viejo aporta valor (mockups reutilizables, glosarios, exports), esta migración es la única vía soportada para rescatarlo al path canónico.
-
-    **Algoritmo**:
-    1. Por cada sesión con `referencias/` no vacía (legacy v1): listar archivos.
-    2. Resolver `<workspace-root>/docs/referencias/` (en hub mode = hub root; en single-repo = cwd).
-    3. Si no existe, crear `docs/referencias/` + `docs/referencias/README.md` (template canónico — ver `agent-workflow/skills/session/SKILL.md` §"`docs/referencias/` transversal (DEC-004 v2)").
-    4. Por cada archivo legacy:
-       - Renombrar con prefijo `<sessionNNN>-` para evitar colisiones (ej. `referencias/A-mockup.png` → `docs/referencias/session023-A-mockup.png`).
-       - Si el archivo ya existe en destino con mismo prefijo: reportar conflicto y pedir resolución manual (no sobrescribir).
-       - Mover con `git mv` si el repo está versionado; `mv` plano si no.
-    5. Mover la carpeta legacy completa a `.workflow/sessions/<folder>/_archived/referencias-legacy/` para reversibilidad. NO eliminar.
-    6. **Idempotente**: si una sesión ya tiene `_archived/referencias-legacy/` y `referencias/` vacía o ausente → skip.
-
-    **Indicadores de detección**:
-    - Existe `.workflow/sessions/<folder>/referencias/` con ≥1 archivo (excluir `.gitkeep` puro).
-    - El archivo no es link simbólico ni gitignored.
-
-    **Conflict resolution**:
-    - Si dos sesiones distintas tienen `referencias/A-mockup.png` con contenido distinto: ambas se preservan como `session023-A-mockup.png` y `session041-A-mockup.png`.
-    - Si dos sesiones tienen el mismo file pero contenido idéntico (sha-1 match): consolidar a 1 con prefijo de la primera sesión y registrar las otras como duplicados en el log.
-
-## Parámetros
-
-- `--flow dev|design|analyze` — enfoca el upgrade al flow específico (afecta rename de slugs legacy y destino de scripts cache `~/.workflow/<flow>/`).
-- `--rebuild-history` — solo regenerar HISTORY.md, sin mover archivos.
-- `--upgrade-topology` — solo upgrade al formato 0.8+ (incluye rename de artefactos R3 y tokens).
-- `--upgrade-v4` — solo upgrade v3.x → v4.0.
-- `--upgrade-hub-mode` — solo upgrade hub-mode.
-- `--upgrade-referencias-globales` — solo upgrade DEC-004 v2 (consolida `referencias/` por-sesión legacy a `docs/referencias/` transversal). Opt-in.
-- Sin flags: detección completa con confirmación por bloque (NO incluye `--upgrade-referencias-globales` por default; mover contenido del usuario sin pedirlo viola la regla "AI no escribe en `referencias/` salvo solicitud explícita").
-
-> **TODO(migrate)**: considerar flags adicionales `--upgrade-transversal-rules`, `--upgrade-per-fuente-anchors`, `--upgrade-hooks-post-v5.18` con CLI delegation para cada uno. Hoy estos 3 escenarios se ejecutan dentro de la detección completa.
-
-## Indicadores de detección
-
-### Pre-0.9 (topología)
-
-- Bloque `<!-- QTC-WORKFLOW-START -->` en `CLAUDE.md` o `AGENTS.md` (sin el reemplazo a `<!-- AW-PROJECT-START -->` o `<!-- WORKFLOW-PROJECT-START -->`).
-- Sesiones con `REQUIREMENTS.md` y sin `OBJECTIVE.md`/`OBJETIVO.md`.
-- Sesiones con `STATUS.md` (archivo ya no usado en 0.8+).
-- Existe `.workflow/project-config.md`.
-- `~/.workflow/user-config.md` con sección `## Workflow profile` (formato pre-0.9).
-
-### Pre-R3 (artefactos ES legacy)
-
-- Sesiones con artefactos `OBJETIVO.md` / `DECISIONES.md` / `HALLAZGOS.md` / `CONCLUSIONES.md` / `PROBLEMA.md` / `EVIDENCIA.md` / `ENTREGA.md` sin sus contrapartes EN canon.
-- Tokens embebidos `## Tipo: <valor>` y/o `## Modalidad: <valor>` con valores ES (`tecnica` / `incidente` / `datos`).
-- Carpetas `assets/` dentro de sesiones (DEC-004 v1 las reemplaza por `referencias/`; DEC-004 v2 las desactiva a favor de `docs/referencias/` transversal — ver indicador siguiente).
-
-### Pre-DEC-004 v2 (referencias por-sesión legacy → docs/referencias/ transversal)
-
-- Sesiones con `.workflow/sessions/<folder>/referencias/` no vacía. La carpeta sigue existiendo pero el AI ya no la lee (DEC-004 v2). Aplicar `--upgrade-referencias-globales` para consolidar al path canónico.
-
-### Pre-v0.12 (rename a qtc-*)
-
-- Existe `~/.developer-workflow/`.
-- Sesiones con slug `sessionNNN-<slug>` sin marcador de flujo.
-- HISTORY.md de 6 columnas.
-
-### Pre-v4.0 (lifecycle 5 fases)
-
-- Sesiones activas con fase `requerimiento|plan|implementacion|validacion|cierre`.
-- Manifest del plugin con `qtcContractVersion < 4.0` (raro post-v6.3 ya que el CLI se actualiza independiente).
-
-### Pre-v4.5 (hub mode)
-
-- Bloque AW-PROJECT con ≥2 fuentes pero sin línea `Mode: hub|project` declarada.
-
-### Pre-session052 (bloque transversal en workspace)
-
-- `CLAUDE.md` y/o `AGENTS.md` del workspace tiene `<!-- WORKFLOW-PROJECT-START -->` pero NO tiene la sección `## Reglas transversales qtc-*` después del `<!-- WORKFLOW-PROJECT-END -->`.
-- Detector específico (regex): el archivo NO contiene la string `## Reglas transversales qtc-*` después del marker de cierre.
-- Si la sección existe pero con menos de 8 anchors canónicos (lista esperada: `agent-workflow:commits-policy`, `agent-workflow:sandbox-readonly`, `agent-workflow:mcp-readonly`, `agent-workflow:redaccion-simple`, `agent-workflow:coding-standards`, `agent-workflow:graduacion-routing`, `agent-workflow:branch-verification`, `agent-workflow:closure-cleanup`), se considera incompleta y se ofrece actualización.
-
-### Pre-session053 (repos qtc-* fuente sin anchors)
-
-- Workspace que se identifica como repo qtc-* fuente del runtime: su path coincide con alguna entrada de AW-PROJECT.Fuentes de OTRO workspace (típicamente el hub que coordina los 3 repos del runtime).
-- Detector específico: la raíz del repo NO tiene `AGENTS.md` ni `CLAUDE.md`.
-- Aplica a los 3 repos canónicos: `agent-workflow-cli`, `agent-workflow`, `qtc-plugins-marketplace`. Generalizable a otros repos qtc-* fuente declarados como tales.
-
-### Pre-v5.18 (hooks PreToolUse incompletos)
-
-- Aplica SOLO si el workspace es el repo `agent-workflow` (workspace de desarrollo del plugin).
-- Detector: `hooks/hooks.json` y/o `codex-hooks/hooks.json` no incluye matchers `mcp__.*__execute_sql` ni `Bash` en `PreToolUse[]`.
-- Específicamente:
-  - Falta entry con `matcher: "mcp__.*__execute_sql"` → `agent-workflow hook sql-mutation-guard`.
-  - Falta entry con `matcher: "Bash"` → `agent-workflow hook git-commit-advisor`.
-- El matcher original `Edit|Write|MultiEdit|NotebookEdit` debe existir; si falta, es un escenario más serio (Pre-v0.9 hook layout) y migrate debe reportar antes de ofrecer wire-up nuevo.
-
-## Procesos
-
-Detalle por upgrade abajo. Los procesos idempotentes; cada uno verifica el estado actual antes de mutar. Las delegaciones al CLI runtime son la vía canónica para mutaciones; el AI confirma con el usuario antes de ejecutar cada bloque.
-
-### Upgrade hub-mode (delegado al CLI)
-
-```
-agent-workflow upgrade-hub-mode [--dry-run]
-```
-
-`--dry-run` reporta elegibilidad sin mutar. Sin `--dry-run`, aplica el cambio (escribe `Mode: hub` en CLAUDE.md/AGENTS.md). Idempotente.
-
-### Upgrade transversal-rules block (post-session052, manual guidado por AI)
-
-1. Detector: leer `CLAUDE.md` y `AGENTS.md` del workspace; verificar ausencia de la sección `## Reglas transversales qtc-*` o presencia incompleta (menos de 8 anchors canónicos).
-2. Si falta o está incompleto, el AI propone al usuario agregar/completar el bloque con la plantilla canónica (8 anchors + puntero a `Skill(agent-workflow:rules)`).
-3. Mutación: edit incremental en ambos archivos (`CLAUDE.md` y `AGENTS.md`) insertando el bloque después del `<!-- WORKFLOW-PROJECT-END -->`.
-4. Idempotencia: si la sección ya existe completa (8 anchors), skip silent. Si está incompleta, ofrece reemplazo con confirmación.
-5. **Sin CLI delegation hoy** (TODO: futuro `agent-workflow upgrade-transversal-rules`).
-
-### Upgrade per-fuente anchors (post-session053, manual guidado por AI)
-
-1. Detector: workspace ES un repo qtc-* fuente (path coincide con AW-PROJECT.Fuentes de algún hub) y no tiene `AGENTS.md` ni `CLAUDE.md` en raíz.
-2. Si falta, el AI propone crear los 2 archivos con preludio repo-específico ≤2 líneas + bloque "Reglas transversales qtc-*" idéntico al del hub.
-3. Mutación: crear `AGENTS.md` y `CLAUDE.md` con contenido idéntico salvo el preludio (repo-específico).
-4. Idempotencia: si ambos archivos existen y tienen el bloque transversal, skip silent. Si uno existe pero está incompleto, ofrece actualización.
-5. **Sin CLI delegation hoy** (TODO: futuro `agent-workflow upgrade-per-fuente-anchors`).
-
-### Upgrade hooks PreToolUse post-v5.18 (agent-workflow workspace, manual)
-
-1. Detector: workspace es `agent-workflow` (heurística: existe `skills/session/SKILL.md` Y `hooks/hooks.json` en raíz).
-2. Verificar entries en `PreToolUse[]` de `hooks/hooks.json` y `codex-hooks/hooks.json`:
-   - ¿Existe `matcher: "mcp__.*__execute_sql"` → `agent-workflow hook sql-mutation-guard`?
-   - ¿Existe `matcher: "Bash"` → `agent-workflow hook git-commit-advisor`?
-3. Si falta cualquiera de los 2, el AI propone agregarlos como entries nuevas en `PreToolUse[]`, coexistiendo con el entry original `Edit|Write|MultiEdit|NotebookEdit`.
-4. Mutación: edit JSON preservando formato (indentación 2 espacios, llave de cierre ordenada).
-5. Validación: ejecutar `python3 -c "import json; json.load(open(p))"` sobre ambos archivos tras la mutación.
-6. Idempotencia: si los 2 matchers nuevos ya están registrados, skip silent.
-7. **Sin CLI delegation hoy** (TODO: futuro `agent-workflow upgrade-hooks`).
-
-### Rename de artefactos R3 EN/ES (durante upgrade-topology)
-
-Tabla canónica de renames (legacy ES → EN canon):
-
-| Legacy ES | EN canon |
-|---|---|
-| `OBJETIVO.md` | `OBJECTIVE.md` |
-| `DECISIONES.md` | `DECISIONS.md` |
-| `HALLAZGOS.md` | `FINDINGS.md` |
-| `CONCLUSIONES.md` | `CONCLUSIONS.md` |
-| `PROBLEMA.md` | `PROBLEM.md` |
-| `EVIDENCIA.md` | `EVIDENCE.md` |
-| `ENTREGA.md` | `DELIVERY.md` |
-
-Tokens embebidos:
-
-| Legacy ES | EN canon |
-|---|---|
-| `## Tipo` | `## Type` |
-| `## Modalidad` | `## Modality` |
-| `tecnica` | `technical` |
-| `incidente` | `incident` |
-| `datos` | `data` |
-| `feature|refactor|bugfix|chore` | (sin cambio — ya EN) |
-
-Procedimiento:
-1. Por cada sesión legacy, identificar artefactos con nombre ES.
-2. Si NO existe la contraparte EN, renombrar (`git mv` si la sesión está bajo control de versión).
-3. Si AMBOS coexisten (raro), reportar conflicto y pedir resolución manual al usuario.
-4. Buscar tokens embebidos en cada `.md` y reemplazar (manteniendo el contenido del cuerpo). Idempotente.
-5. Aliases bilingües siguen aceptándose por readers R1 — el rename es una mejora de canonización, no una ruptura.
-
-### Rename `assets/` → `referencias/` por sesión (DEC-004 v1, histórico)
-
-1. Por cada sesión con carpeta `assets/` en su raíz, renombrar a `referencias/`.
-2. Si ambas existen, mover contenido de `assets/` a `referencias/` y reportar; preferir no sobrescribir.
-3. Idempotente: si `referencias/` ya existe y `assets/` no, skip.
-
-> **Nota DEC-004 v2 (session080, v1.4.0)**: la operación `referencias/` por-sesión existió hasta DEC-004 v1. A partir de DEC-004 v2 las nuevas sesiones no usan `referencias/` por-sesión; el contenido va a `<workspace-root>/docs/referencias/` (transversal). Para consolidar contenido viejo, ver §"Consolidar `referencias/` por-sesión → `docs/referencias/` (DEC-004 v2, opt-in)" abajo.
-
-### Consolidar `referencias/` por-sesión → `docs/referencias/` (DEC-004 v2, opt-in)
-
-Activado por `--upgrade-referencias-globales`. Mueve contenido de carpetas legacy a la carpeta transversal. Procedimiento completo en la capacidad #12 arriba (algoritmo, indicadores, conflict resolution).
-
-1. Por cada sesión con `.workflow/sessions/<folder>/referencias/` no vacía: listar archivos.
-2. Resolver destino: `<workspace-root>/docs/referencias/` (hub root en hub mode, cwd en single-repo).
-3. Crear `docs/referencias/` + README.md si no existe.
-4. Mover cada archivo con prefijo `<sessionNNN>-` para evitar colisiones (`git mv` si versionado).
-5. Mover la carpeta legacy completa a `_archived/referencias-legacy/` (reversible). NO eliminar.
-6. Reportar conflictos (mismo prefijo + contenido distinto) y dejar resolución al usuario.
-7. Idempotente: si la sesión ya tiene `_archived/referencias-legacy/` → skip.
-
-## Reglas
-
-- **Nunca sobreescribir sesiones**: si una carpeta ya existe en `.workflow/sessions/`, no moverla desde legacy.
-- **Nunca borrar** `.claude/` ni `.codex/`: solo mover contenido del plugin.
-- **Nunca borrar automáticamente** archivos durante el upgrade; siempre mover a `_archived/`.
-- **Siempre confirmar** antes de escribir.
-- **Preservar manuales existentes** en `docs/manuales/` (Manual Técnico, Manual Funcional, etc.).
-- **Idempotencia universal**: cada proceso verifica estado actual antes de mutar. Skip silent si ya aplicado.
-- **No modificar el código del CLI** desde migrate; migrate edita workspace files y delega al CLI ya instalado para mutaciones específicas (hub-mode).
-
-## Política — sin fallback al CLI
-
-Si `agent-workflow upgrade-hub-mode` (u otros sub-comandos) 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
-
-Canon universal en `../session/references/sandbox-readonly-rules.md`. Read-only por construcción cuando se invoca en plan mode — el migrate no muta nada sin confirmación explícita del usuario, y el CLI delega (hub-mode) se llama solo después de aprobación.
-
-En plan mode describir:
-- Sesiones a mover de legacy (paths origen → destino).
-- Artefactos R3 a renombrar (legacy ES → EN canon, lista cerrada de archivos por sesión).
-- Tokens embebidos a renombrar (`## Tipo`/`## Modalidad` con valores ES).
-- Bloque AW-PROJECT a escribir o normalizar.
-- Bloque "Reglas transversales qtc-*" a insertar/completar (post-session052).
-- AGENTS.md/CLAUDE.md por fuente a crear (post-session053).
-- Entries `PreToolUse[]` a agregar en hooks.json (post-v5.18).
-- Filas de HISTORY.md a actualizar.
-- Rename `assets/` → `referencias/` por sesión (DEC-004 v1, histórico).
-- Consolidar `referencias/` por-sesión → `<workspace-root>/docs/referencias/` (DEC-004 v2, opt-in — sólo si `--upgrade-referencias-globales`).
-
-NO ejecutar mutaciones. NO invocar `agent-workflow upgrade-hub-mode` sin `--dry-run` en plan mode.
-
-## Recursos
-
-- `../session/references/sandbox-readonly-rules.md` — canon plan mode.
-- `../session/references/commits-policy.md` — política de commits del closure (aplicable también fuera de sesión vía bloque transversal).
-- `../session/SKILL.md` §"Graduar artefactos (6 kinds — DEC-003)" — kinds + routing hub-vs-fuente.
-- `../rules/SKILL.md` (skill agregadora `agent-workflow:rules`, post-session052; 8º anchor agregado post-session090) — bundle invokable de las 8 reglas transversales.
-- CLI runtime `@tacuchi/agent-workflow-cli` ≥5.18.0 — subcomandos relevantes: `upgrade-hub-mode`, `project-md-upsert`, `sources`, `hook git-commit-advisor`, `hook sql-mutation-guard`, `hook branch-check`.
-- Histórico: session051 (analyze reglas transversales) → session052 (quick-wins) → session053 (anchors por fuente + Bash hook) → session054 (este migrate update).

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

@@ -1,100 +0,0 @@
----
-name: project-init
-description: Inicializa el bloque AW-PROJECT en CLAUDE.md y AGENTS.md del workspace con las 4 secciones gestionadas (Proyecto, Fuentes, Stack, Status). Para workspaces que coordinan múltiples repos pares, ver hub-init. Invocado sólo vía /agent-workflow:project-init.
-version: 1.0.0
----
-
-> **Profile parametrization**: lee `claude_md_block` 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.
-
-# Project Init
-
-Bootstrap del bloque AW-PROJECT para un workspace **single-repo** (project mode). El bloque es la memoria permanente del proyecto y lo lee toda la familia agent-workflow (sessions, doctor, hooks).
-
-## Cuándo usar
-
-- El workspace coordina **un solo repo** (proyecto típico de servicio Java/Spring, frontend Angular, etc.).
-- El bloque AW-PROJECT no existe aún o quedó dañado.
-
-Para workspaces con ≥2 repos pares (ej. `qtc-plugin-marketplace` que coordina 4 plugins), usar **`/agent-workflow:hub-init`** — valida cross-fuente y persiste `Mode: hub` que activa heurísticas hub-aware en el resto de skills.
-
-## Flujo
-
-### 1. Detectar bloque existente
-
-```
-agent-workflow project-md-upsert --read
-```
-
-Casos:
-- **Bloque válido y `Mode: project` (o sin Mode)**: mostrar al usuario y preguntar si reiniciar o abortar.
-- **Bloque con `Mode: hub`**: avisar que el workspace está en modo hub. Sugerir `/agent-workflow:hub-init` para administrar fuentes. Abortar.
-- **Sin bloque**: continuar al paso 2.
-- **Bloque legacy `<!-- QTC-WORKFLOW-START -->`**: recomendar `/agent-workflow:migrate --upgrade-topology` antes de seguir. No tocar el bloque legacy automáticamente.
-
-### 2. Capturar descripción
-
-Pedir al usuario:
-
-> "Describí el proyecto en 1-3 líneas: qué es y por qué existe."
-
-Usar `AskUserQuestion` o campo libre. La descripción va a la sección `## Proyecto` del bloque.
-
-### 3. Capturar fuente
-
-Pedir:
-- **Alias**: kebab-case corto (ej. `creditos`, `equipos`, `frontend`).
-- **Path absoluto** al repo (ej. `C:/Source/mscore-creditos-spring`).
-
-Validar:
-- Path existe (`os.path.isdir`).
-- Path es repo git (`<path>/.git/` existe o `git -C <path> rev-parse` no falla).
-
-La **rama principal** default es `certificacion` (constante interna del CLI). Override con `--main-branch <rama>` solo en casos atípicos.
-
-Si el usuario quiere declarar ≥2 fuentes, sugerir cambiar a `/agent-workflow:hub-init`. Permitir continuar si insiste, pero advertir que perderá la heurística hub.
-
-### 4. Auto-detectar stack
-
-```
-agent-workflow stack
-```
-
-Output: `{build, wrapper, framework, language, db}`. Mostrar al usuario y confirmar antes de escribir. Si no se puede detectar (no hay `pom.xml`/`package.json`/etc.), escribir `_Stack sin detectar. Edita manualmente si aplica._`.
-
-### 5. Persistir el bloque
-
-```
-agent-workflow project-md-upsert --init \
-    --mode project \
-    --proyecto "<descripción>" \
-    --fuente "alias:path:certificacion"
-```
-
-El comando escribe `CLAUDE.md` y `AGENTS.md` del CWD (ambos archivos para soportar Claude Code y Codex). Cache se invalida automáticamente.
-
-### 6. Reportar
-
-Mostrar al usuario:
-- Archivos creados/modificados (CLAUDE.md, AGENTS.md).
-- Bloque persistido (sección Proyecto, Fuentes, Stack, Status).
-- Próximos pasos sugeridos: `/agent-workflow:session "<objetivo>"` para crear la primera sesión.
-
-## Reglas
-
-- **Idempotente**: re-ejecución con bloque ya válido y datos idénticos es no-op.
-- **No borrar sesiones activas**: si el bloque existente tiene sesiones en Status, preservarlas.
-- **No tocar legacy**: bloques `<!-- QTC-WORKFLOW-START -->` se preservan; el usuario los migra con `/agent-workflow:migrate`.
-- **Plan mode**: en plan mode describir qué archivos se crearían/modificarían (CLAUDE.md, AGENTS.md) y el bloque que se escribiría. NO ejecutar `project-md-upsert --init`.
-
-## Política — sin fallback al CLI
-
-Si `agent-workflow project-md-upsert|stack` 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`. En plan mode, este skill solo describe:
-
-- Archivos a crear/modificar: `CLAUDE.md`, `AGENTS.md` del CWD.
-- Bloque AW-PROJECT a escribir: resumen de las 4 secciones (Proyecto, Fuentes, Stack, Status).
-- Si reemplaza un bloque existente, indicar diff conceptual.
-- Si detecta legacy QTC-WORKFLOW, advertir y sugerir `/agent-workflow:migrate` antes de re-ejecutar fuera de plan mode.

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

@@ -1,208 +0,0 @@
----
-name: refactor
-description: "Orquesta el rebuild de un feature existente al estándar nuevo (Sparse DTO unificado, PATCH, sin fallbacks, phased Phase 0-5) usando migración Strangler Fig. Activado automáticamente cuando una sesión flow=dev declara `## Type: refactor` en OBJECTIVE.md (alias legacy `## Tipo`). Compone con agent-workflow:analyze-investigate (discovery legacy) y agent-workflow:implement (ejecución phased). Produce REFACTOR.md como artefacto canónico. v1.1+ alinea el TASKS.md generado a las 6 phases del modelo extendido."
-version: 1.3.1
----
-
-> **Profile parametrization**: lee `examples_path` 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.
-
-# Refactor — qtc v2.8+
-
-Skill de especialidad **dev**: orquesta refactors feature-completos siguiendo Strangler Fig (Fowler) — análisis legacy → rebuild paralelo desde cero → cleanup.
-
-> **Modelo de artefactos (DEC-003)**: REFACTOR.md vive en la sesión (`.workflow/sessions/<folder>/REFACTOR.md`) y **no se gradúa con kind dedicado** — los kinds graduables son `decision|manual|script|especificacion|conclusion|release`. Si el REFACTOR.md amerita preservarse fuera de la sesión, el camino es:
->
-> - Curarlo manualmente como `manual` (`docs/manuales/`) si describe cómo se reorganiza el módulo.
-> - O como `especificacion` (`docs/especificaciones/`) si describe el contrato del módulo nuevo.
-> - O dejarlo en la sesión cerrada (consultable vía `.workflow/sessions/<folder>/REFACTOR.md`).
-
-## Cuándo se invoca
-
-- **Composición desde `agent-workflow:session`** (lo más común): cuando una sesión `flow=dev` declara `## Type: refactor` en OBJECTIVE.md y entra a `execution`.
-- **NL del usuario**: "refactorizá X al nuevo estándar", "rebuild de Y siguiendo phased", "migrá Z a Sparse DTO".
-- **Standalone vía `/agent-workflow:use`**: produce REFACTOR.md exploratorio sin tocar paths (modo `status: discovery` permanente).
-
-NO se activa automáticamente fuera de `## Type: refactor`. Para refactors triviales (1 archivo) seguir flat mode con `## Type: chore`.
-
-## Pre-requisitos
-
-1. **Sesión activa** con `## Type: refactor` en OBJECTIVE.md (excepto modo standalone).
-2. **Feature target identificable**: path o nombre del módulo legacy en el Brief del OBJECTIVE.
-3. **Ramas verificadas**: `agent-workflow sources` consistente; aplicar `branch-verification.md` si difiere.
-4. **Stack detectado**: `agent-workflow stack` para conocer convenciones de la fuente.
-
-## Loop (overview)
-
-```
-[discovery]                                       (paso 1, T2.1)
-  ↓ compone agent-workflow:analyze-investigate
-[REFACTOR.md draft]                               (paso 2)
-  ↓ user review
-[M7 — refactor-legacy-detected]                   (paso 3)
-  ↓ rename Strangler
-[<feature>-legacy/ + <feature>/ vacía]            (paso 4)
-  ↓
-[generar TASKS.md phased]                         (paso 5)
-  ↓
-[hand off → agent-workflow:implement (Phase 0/1/2)]      (paso 6)
-  ↓ con S7 (pre-Phase 0, design review desde planning closure) y M6 (entre phases)
-[validación e2e usuario]                          (paso 7)
-  ↓
-[M8 — refactor-cleanup]                           (paso 8)
-  ↓ delete <feature>-legacy/
-[REFACTOR.md ## Estado: completed]
-```
-
-## Composición
-
-| Skill | Cuándo | Rol |
-|---|---|---|
-| `agent-workflow:analyze-investigate` | paso 1 | Lee paths legacy, traza endpoints, valida contra BD (read-only via MCP <mcp-cert>), produce evidencia para REFACTOR.md "Análisis legacy". |
-| `agent-workflow:implement` | paso 6 | Toma TASKS.md phased y ejecuta el loop con gate M6 entre phases. S7 design-review fue disparado antes desde planning closure. |
-| `agent-workflow:coding-standards` | transversal | Reglas FE-BE, fail-fast, no fallbacks ocultos. |
-| `agent-workflow:sql-script-organizer` + `sql-rollback-generator` | paso 6 | Cuando el rebuild incluye DDL/funciones/migraciones de BD. |
-
-## Loop detallado (8 pasos)
-
-> Detalle paso a paso en `references/strangler-checklist.md`. Esta sección resume las acciones del AI por paso.
-
-### Paso 1 — Discovery
-
-- **Input**: OBJECTIVE.md con Brief que identifica feature target (path o nombre).
-- **Acción del AI**:
-  1. Compone `agent-workflow:analyze-investigate` con scope = paths legacy.
-  2. Lee módulos FE, paquetes BE, funciones BD relacionadas (read-only).
-  3. Identifica endpoints actuales, DTOs, validaciones, reglas de negocio, accesos.
-  4. Detecta smells (DTOs duplicados Create/Update, PUT en lugar de PATCH, fallbacks que ocultan errores, lógica replicada FE+BE).
-- **Output**: Evidencia parcial en memoria; aún no escribe archivos.
-
-### Paso 2 — REFACTOR.md draft
-
-- **Acción del AI**:
-  1. Crea `.workflow/sessions/<folder>/REFACTOR.md` siguiendo `references/refactor-md-template.md`.
-  2. Rellena "Análisis legacy" con la evidencia del paso 1.
-  3. Rellena "Diseño nuevo" aplicando reglas FE-BE (Sparse DTO unificado, PATCH, no fallbacks).
-  4. Rellena "Plan de migración" (12 pasos) y "Estado" inicial (`status: discovery`).
-- **Espera review del usuario**. Si pide cambios, itera. Si aprueba → paso 3.
-
-### Paso 3 — M7 (refactor-legacy-detected)
-
-- **Acción del AI**:
-  1. Dispara `AskUserQuestion` con spec de M7 (`agent-workflow:prompts-catalog#M7`): rename + AI imports / rename + IDE imports / solo análisis / Other custom.
-  2. Si "solo análisis" o cancela → REFACTOR.md queda en `status: discovery`. La sesión puede cerrar acá como artefacto exploratorio.
-  3. Si elige rename → paso 4.
-
-### Paso 4 — Rename Strangler
-
-- **Acción del AI** (con confirmación por archivo si la opción A "AI actualiza imports"):
-  1. `git mv <fe-path>/<feature>/ <fe-path>/<feature>-legacy/` (vía Bash).
-  2. Si BE: rename de paquete `<feature>` → `<feature>_legacy` (en stack Java/Spring esto es `git mv` + actualización de declaraciones `package`).
-  3. Si opción A: la AI escanea `*.ts`/`*.java` con grep y actualiza `import`/`package` en lote, mostrando diff por archivo antes de aplicar.
-  4. Si opción B: la AI deja imports rotos para que el usuario migre vía IDE refactor.
-  5. **NO renombra funciones/SP de BD**: la BD es estado; las funciones nuevas se crean en paralelo durante Phase 0/1/2.
-- **Output**: REFACTOR.md → `status: legacy-marked`.
-
-### Paso 5 — Crear `<feature>/` vacía
-
-- **Acción del AI**:
-  1. FE: crea `src/.../<feature>/` con `*.module.ts`, `*.routing.module.ts`, service stub, component stub. Solo skeleton.
-  2. BE: crea paquete `<feature>` con `<Feature>Controller`, `<Feature>Service`, `<Feature>SaveRequest` (record con campos nullable, sin lógica).
-- **Output**: paths nuevos vacíos listos para Phase 0 stub.
-
-### Paso 6 — Generar TASKS.md phased + hand off a `implement`
-
-- **Acción del AI**:
-  1. Genera `TASKS.md` con las 6 secciones canónicas (modelo v2.7+):
-     - `## Phase 0 — Mapeo + Contrato`: stubs FE, DTOs BE Sparse, endpoints 501, funciones BD mock, **routing FE↔BE conectado a mocks**.
-     - `## Phase 1 — Lecturas`: GET, listados, combos, filtros con datos reales.
-     - `## Phase 2 — Escritura`: POST/PATCH/DELETE funcionales sin Bean Validation; scripts SQL DDL/DML.
-     - `## Phase 3 — Validaciones / Correcciones`: Bean Validation con groups, handler global, validaciones FE inline, reglas de negocio, cleanup smells.
-     - `## Phase 4 — Seguridad`: placeholder con `## Estado: pendiente-spec` por default; agregar tareas concretas si la sesión analyze de seguridad ya produjo CONCLUSIONS.md (legacy: CONCLUSIONES.md) de modalidad=technical.
-     - `## Phase 5 — Optimizaciones`: típicamente **sí se incluye en refactors** porque suelen tocar performance (queries con joins, listados grandes, índices). Skip sólo si el alcance del refactor es puramente de doctrina (cambio de DTO, rename, etc.).
-  2. Hand-off a `agent-workflow:implement` que toma el control del loop con gate M6 entre phases (skip silencioso para Phase 4 vacía y Phase 5 opt-in). S7 design-review fue disparado antes desde planning closure (v2.8+ — reemplazó a M9).
-  3. REFACTOR.md → `status: implementing`, `phase: 0`. Se actualiza al cerrar cada phase (`phase: 1`, `phase: 2`, `phase: 3`, `phase: 4` si aplica, `phase: 5` si aplica, `phase: done`).
-- **Output**: implement asume el control. `refactor` queda en hold hasta paso 7.
-
-### Paso 7 — Validación e2e por usuario
-
-- **Trigger**: `implement` cierra la última phase declarada del refactor (típicamente Phase 5; Phase 3 si optimizaciones no aplica) sin más tasks abiertas.
-- **Acción del AI**: marca REFACTOR.md → `status: validating`. Notifica al usuario.
-- **Acción del usuario**:
-  1. Levanta FE + BE en local.
-  2. Aplica scripts SQL contra cert (manual; el AI no los ejecuta).
-  3. Prueba: create, list, filter, edit (sparse), delete.
-  4. Verifica que validaciones (Phase 3) responden 400 estructurado ante input malformado.
-  5. **Si Phase 3 incluyó cleanup smells**: confirmar que los smells canónicos del análisis legacy quedaron resueltos.
-  6. Compara contra el comportamiento legacy si está disponible.
-  7. Confirma: "validado, todo funciona" → REFACTOR.md `status: completed` (legacy_purged: false aún).
-
-### Paso 8 — M8 (refactor-cleanup)
-
-- **Acción del AI**:
-  1. Verifica que `status: completed`. Si no, error informativo y aborta.
-  2. Dispara `AskUserQuestion` con spec de M8 (`agent-workflow:prompts-catalog#M8`): eliminar / mantener temporalmente / cancelar / Other.
-  3. Si "eliminar":
-     - `git rm -r <fe-path>/<feature>-legacy/`.
-     - `git rm -r <be-path>/<feature>_legacy/` si aplica al stack.
-     - BD: si hay funciones legacy paralelas, **genera script SQL** bajo `.workflow/sessions/<sessionNNN>/scripts/cleanup-<feature>.sql` con `DROP FUNCTION IF EXISTS ...`. El bundle final se arma vía `/agent-workflow:release` (kind=`script` → `docs/scripts/`). **NO ejecuta el script**; el usuario lo aplica.
-     - REFACTOR.md → `legacy_purged: true`.
-  4. Si "mantener": REFACTOR.md → `legacy_purged: false` con TODO en sección Estado. Cleanup queda para sesión follow-up.
-  5. Si "cancelar": no toca nada. Closure no completa hasta resolver.
-
-## Política de commits
-
-Política canónica: ver `agent-workflow:commits-policy` (Regla 3 propose-then-execute universal). Cualquier commit durante el refactor — closure auto-disparado o solicitud explícita del usuario — pasa por el flujo M1.
-
-Excepción específica de `refactor`: el rename del paso 4 (`git mv`) se ejecuta porque es una mutación de filesystem que altera el árbol antes de que las edits fluyan. El AI lo reporta inmediatamente al usuario y deja el `git status` visible.
-
-## Política de SQL
-
-Igual que el resto de agent-workflow: **scripts versionados, no ejecución directa**. Los scripts BD (forwards en Phase 1/2 y cleanup en paso 8) se materializan bajo `docs/scripts/<sessionNNN>/` siguiendo `agent-workflow:sql-script-organizer`. El usuario los aplica manualmente contra cert/prod.
-
-## Standalone mode
-
-Cuando el usuario invoca `/agent-workflow:use` y describe un refactor sin sesión activa:
-
-1. El skill `refactor` se activa con `status: discovery` permanente.
-2. Produce `REFACTOR.md` en el CWD (no en `.workflow/sessions/`).
-3. **No ejecuta paso 3-8**: solo análisis y diseño. M7/M8 quedan deshabilitados.
-4. El usuario puede usar el REFACTOR.md como input para una sesión `/agent-workflow:session create` con `## Type: refactor` posteriormente.
-
-## Errores y rollback
-
-| Situación | Acción |
-|---|---|
-| Phase 1 falla (lecturas no funcionan) | Re-iterar Phase 1 con M6 opción 3. Legacy sigue intacto. |
-| Phase 2 falla (mutaciones rompen) | Re-iterar Phase 2 con DECISIÓN nueva en DECISIONS.md (legacy: DECISIONES.md). Legacy sigue intacto. |
-| Validación e2e descubre regresión | Pausar, registrar DECISIÓN, decidir: seguir o rollback. NO disparar M8. |
-| Usuario abandona el refactor | REFACTOR.md mantiene `status: implementing|validating`. Legacy sigue intacto. La sesión se puede retomar más tarde. |
-| `git mv` falla (paths con conflictos) | Reportar al usuario, abortar paso 4. NO continuar con paso 5. |
-
-**Nunca** se borra el legacy hasta que M8 se confirme con `## Estado: completed` + validación e2e explícita del usuario. Garantía Strangler Fig: rollback siempre posible.
-
-## Reglas
-
-- **No commits autónomos**: ver §"Política de commits" arriba.
-- **No SQL contra BD**: el rebuild materializa scripts en `docs/scripts/` del workspace de la fuente. El usuario los aplica manualmente.
-- **No tocar paths fuera de la fuente declarada**: si el rebuild requiere otra fuente, agregarla primero a `## Fuentes` del AW-PROJECT.
-- **Validación e2e es mandatoria**: M8 (cleanup) NO se dispara hasta que el usuario confirme `status: validating → validated`.
-
-## Sandbox read-only
-
-Reglas universales en `../session/references/sandbox-readonly-rules.md`. En plan mode esta skill describe en el plan file:
-
-- **Discovery target**: paths legacy, endpoints actuales, stack detectado.
-- **Plan de rename**: paths antes/después, archivos con imports a migrar.
-- **TASKS.md phased que se generaría**: secciones Phase 0/1/2 sin ejecutar.
-- **Rama esperada**: `git branch --show-current` (read-only).
-
-NO ejecuta: `git mv`, `Edit`, `Write`, `Bash` con efectos, ni hand-off a `implement`.
-
-## Recursos
-
-- `references/refactor-md-template.md` — Template REFACTOR.md (estructura canónica).
-- `references/strangler-checklist.md` — 12 pasos de migración con checkboxes.
-- `agent-workflow:prompts-catalog` M7 (refactor-legacy-detected), M8 (refactor-cleanup).
-- `agent-workflow:commits-policy` — política controlada de commits.
-- `agent-workflow:coding-standards/references/fe-be-integration.md` — reglas Sparse DTO/PATCH/no-fallbacks.
-- `agent-workflow:analyze-investigate` — skill de discovery read-only invocada en paso 1.