@tacuchi/agent-workflow-cli 11.0.0 → 12.0.0

package/skills/agent-workflow/exports/export-conclusions/references/dedup-rules.md

@@ -1,154 +0,0 @@
-# Dedup rules — R-items consolidados en `export-conclusions`
-
-Algoritmo canónico de deduplicación de Recommendations (R-NNN) al consolidar N CONCLUSIONS.md en un documento curado.
-
-## Por qué dedup solo R-items
-
-- **C-items** (Conclusions) son específicos del análisis original — preservar 1-a-1 mantiene trazabilidad clínica.
-- **R-items** (Recommendations) son acciones — la redundancia entre análisis indica consenso, y consolidar mejora la accionabilidad.
-
-## Algoritmo paso a paso
-
-### Paso 1 — Extracción de slug por R-item
-
-Para cada `R-NNN` en una CONCLUSIONS.md fuente:
-
-1. Leer la primera línea del header: `- **R1 — bundle plugin v2.10.0 + CLI v6.1.0** · Responsable: ...`
-2. Extraer el **título del R-item**: texto entre `** — ` y `**` (ej. `bundle plugin v2.10.0 + CLI v6.1.0`).
-3. Aplicar normalización para derivar el slug:
-   - Lowercase.
-   - Remover puntuación (`,`, `.`, `+`, `(`, `)`, `:`, `;`).
-   - Reemplazar whitespace por `-`.
-   - Truncar a primeras **5 palabras** post-normalización.
-   - Collapse `--` repetidos.
-
-   Ejemplo: `"bundle plugin v2.10.0 + CLI v6.1.0"` → `bundle-plugin-v2-10-0-cli-v6-1-0` → truncado a 5 palabras → `bundle-plugin-v2-10-0-cli`.
-
-4. Slug resultante = clave de agrupación.
-
-### Paso 2 — Agrupación por slug exacto
-
-Construir un mapa `slug → R-items[]`:
-
-```
-{
-  "bundle-plugin-v2-10-0-cli": [
-    {session: "055", id: "R3", text: "..."},
-    {session: "062", id: "R1", text: "..."}
-  ],
-  "release-plugin-v3-0-0-breaking": [
-    {session: "062", id: "R2", text: "..."}
-  ],
-  ...
-}
-```
-
-Cada bucket con ≥2 entries → R-item consolidado. Cada bucket con 1 entry → R-item single-origin (preservar tal cual con `origins: [session:R]` igual).
-
-### Paso 3 — Cross-slug similarity (opcional, threshold ≥0.7)
-
-Para slugs que **no matchean exacto** pero son semánticamente cercanos:
-
-1. Computar cosine similarity entre embeddings de los slugs (o substring-overlap si no hay embedding model disponible).
-2. Si similarity ≥ 0.7 → emitir **sugerencia de merge** al AI:
-   - Output intermedio: bloque `<!-- DEDUP-SUGGESTION: merge {slug-A} with {slug-B}? -->` al final del documento.
-   - El AI decide si aplicar el merge basándose en el contenido completo de los R-items.
-3. Si el AI mergea: tratar como bucket único con `origins[]` combinado.
-
-**Fallback sin embeddings**: usar substring overlap ≥60% como heurística simple.
-
-### Paso 4 — Conflict resolution (`## R-Conflict`)
-
-Para R-items en el **mismo bucket** (slug exacto) pero con acciones contradictorias:
-
-1. Detectar contradicción por keywords (heurística):
-   - `mantener` vs `reemplazar`.
-   - `agregar` vs `eliminar`.
-   - `migrar a X` vs `migrar a Y`.
-   - `aceptar` vs `rechazar`.
-2. Si detectado → NO consolidar. Mover ambos R-items a sección dedicada `## R-Conflicts detectados`.
-3. Estructura del conflict block:
-
-   ```markdown
-   ### R-Conflict#N — <slug compartido>
-   - **Origen A**: sessionXXX:R3 → "...".
-   - **Origen B**: sessionYYY:R5 → "...".
-   - **Decisión sugerida**: <propuesta del AI o "queda al usuario">.
-   ```
-
-### Paso 5 — Síntesis del R-item consolidado
-
-Para cada bucket consolidado (post-dedup, post-conflict):
-
-```markdown
-### R<N>-consolidado — <slug>
-
-- **Origen**: sessionAAA:RX + sessionBBB:RY + sessionCCC:RZ
-- **Síntesis**: <párrafo unificador 2-4 líneas que destila la acción común>.
-- **Acción sugerida**: <accionable concreto derivado del consenso>.
-- **Responsable sugerido**: <rol/equipo>, si los origins coinciden en `Responsable:`.
-```
-
-Renumerar `R1-consolidado, R2-consolidado, ...` globalmente en el documento.
-
-## Trazabilidad — matriz origen→consolidado
-
-Después del dedup, el skill puede emitir opcionalmente una matriz en el bloque `## Sesiones consolidadas` o al final:
-
-```markdown
-| Sesión | R original | R consolidado |
-|--------|-----------|---------------|
-| 055    | R3        | R1-consolidado |
-| 055    | R5        | R2-consolidado |
-| 062    | R1        | R1-consolidado |
-| 062    | R2        | (single-origin → preservado como R3-consolidado) |
-```
-
-Útil para revisión de la curación.
-
-## Reglas absolutas
-
-- **Nunca borrar trazabilidad**: cada R consolidado debe listar TODOS los `origins[]`.
-- **Nunca inventar R-items**: si un bucket tiene 1 entry, queda single-origin con `origins: [session:R]`.
-- **Conflicts no se resuelven en silencio**: siempre bloque dedicado para revisión.
-- **Cross-slug merges requieren confirmación**: nunca aplicar automático sin pasar por el AI.
-
-## Casos edge
-
-### 1. Bucket con 2 R-items idénticos textualmente
-
-→ Consolidar trivial. `origins: [A, B]`, síntesis = texto original.
-
-### 2. R-item con `Responsable:` distinto en cada origen
-
-→ Síntesis menciona los 2 responsables; el `Responsable sugerido` del consolidado queda como "ambos" o "consensuar".
-
-### 3. R-item con `Cuándo:` (timeline) distinto
-
-→ Síntesis menciona los 2 timelines; el del consolidado toma el más conservador (más lejano) o se omite.
-
-### 4. R-item con `(Recomendado)` en uno de los origins
-
-→ Preservar la flag `(Recomendado)` en el consolidado.
-
-### 5. 1 sola sesión input (single-session export)
-
-→ Skip Paso 2 (no hay agrupación). Cada R-item del input queda como `R<N>-consolidado` con `origins: [SOLA:R<N>]`. Sin conflicts. Sin cross-slug merge.
-
-## Resumen operacional
-
-```
-input: N sesiones con CONCLUSIONS.md
-  ↓
-extract slugs from each R-NNN
-  ↓
-group by slug (exact match)
-  ↓
-if N>1 cross-slug similarity → suggest merges to AI
-  ↓
-detect conflicts within each bucket
-  ↓
-output: { consolidated_R[], conflicts[] }
-  ↓
-render via template-conclusions.md
-```

package/skills/agent-workflow/exports/export-conclusions/references/template-conclusions.md

@@ -1,158 +0,0 @@
-# Template — Documento curado (output de `/agent-workflow:export-conclusions`)
-
-Plantilla canónica del archivo generado en `docs/conclusiones/NNN-<slug>-YYYY-MM-DD.md`. El skill `export-conclusions` la aplica reemplazando los placeholders con datos derivados del corpus.
-
-## Estructura
-
-````markdown
----
-sessions: [<NNN1>, <NNN2>, ...]
-created: <YYYY-MM-DD>
-slug: <kebab-slug>
-recommendations_count: <N>
-roadmap_present: <true|false>
-conflicts_count: <N>
----
-
-# Conclusiones consolidadas — <Título derivado del dominio común>
-
-## Resumen ejecutivo
-
-<2-3 párrafos. Dominio común derivado de los Summary/Modality de las CONCLUSIONS.md fuente. Audiencia. Estado del dominio antes/después.>
-
-## Sesiones consolidadas
-
-| Code | Flow | Slug | Modalidad CONCLUSIONS | C-items | R-items |
-|------|------|------|------------------------|---------|---------|
-| 055  | analyze | docs-from-sessions | technical | 8 | 7 |
-| 057  | dev  | export-func        | (n/a)     | — | — |
-| 061  | dev  | export-scripts     | (n/a)     | — | — |
-| 062  | analyze | export-plan-lifecycle | technical | 8 | 8 |
-
-> Sesiones del corpus inicial que no aparecen acá fueron descartadas por **no tener CONCLUSIONS.md**.
-
-## Conclusions (por sesión)
-
-> No se deduplican — son específicos del análisis original. Se preservan con trazabilidad.
-
-### session055-analyze-docs-from-sessions
-
-- **C1** — <texto>. [`origen`](../.workflow/sessions/session055-analyze-docs-from-sessions/CONCLUSIONS.md#c1)
-- **C2** — <texto>.
-- ...
-
-### session062-analyze-export-plan-lifecycle
-
-- **C1** — <texto>.
-- ...
-
-## Recommendations consolidadas (deduplicadas)
-
-> Aplicó dedup por slug (ver `references/dedup-rules.md`). Cada entry preserva `origins[]`.
-
-### R1-consolidado — <slug derivado>
-
-- **Origen**: session055:R3 + session062:R7
-- **Síntesis**: <párrafo unificador de los R-items origen>.
-- **Acción sugerida**: <accionable concreto>.
-- **Responsable sugerido**: <rol/equipo, opcional>.
-
-### R2-consolidado — <slug>
-
-...
-
-## R-Conflicts detectados (si aplica)
-
-> Acciones contradictorias bajo mismo slug. Queda al usuario decidir.
-
-### R-Conflict#1 — <slug>
-
-- **Origen A**: session057:R2 → "Refactorizar X usando estrategia Y".
-- **Origen B**: session061:R4 → "Mantener X como está; migrar Y primero".
-- **Decisión sugerida**: <propuesta del AI o "queda al usuario">.
-
-## Roadmap derivado (opcional)
-
-> Solo se incluye si ≥3 R-items consolidados. Re-secuenciado por dependencias detectadas.
-
-| Sprint | Sesión sugerida                          | R-items que cubre | ETA  | Dependencia |
-|--------|------------------------------------------|-------------------|------|-------------|
-| 1      | sessionNNN-dev-<slug-A>                  | R1, R3            | ≈4h  | —           |
-| 2      | sessionNNN-dev-<slug-B>                  | R2                | ≈3h  | S1 ok       |
-| 3      | sessionNNN-design-<slug-C>               | R4, R5            | ≈2h  | S1 ok       |
-
-Total: ≈9h en 3 sesiones derivadas.
-
-## Refs
-
-- `session055-analyze-docs-from-sessions` — [`CONCLUSIONS`](../.workflow/sessions/session055-analyze-docs-from-sessions/CONCLUSIONS.md)
-- `session062-analyze-export-plan-lifecycle` — [`CONCLUSIONS`](../.workflow/sessions/session062-analyze-export-plan-lifecycle/CONCLUSIONS.md)
-- ...
-
-## Sesiones excluidas del corpus
-
-> Listadas para trazabilidad — no tenían CONCLUSIONS.md al momento del export.
-
-- session057-dev-export-func (`flow=dev`, sin CONCLUSIONS por diseño)
-- session061-dev-export-scripts (`flow=dev`, sin CONCLUSIONS por diseño)
-````
-
-## Reglas de uso
-
-- **Frontmatter obligatorio**: `sessions`, `created`, `slug`, `recommendations_count`, `roadmap_present`, `conflicts_count`.
-- **Idioma**: ES default. Headers EN canon (`Resumen ejecutivo`, `Sesiones consolidadas`, `Conclusions`, `Recommendations consolidadas`, `Refs`).
-- **C-items**: preservar 1-a-1 con sesión origen. No deduplicar.
-- **R-items**: aplicar dedup según `references/dedup-rules.md`. Cada R consolidado lista `origins[]` para trazabilidad.
-- **R-Conflicts**: bloque separado al final del consolidado. Decisión queda al usuario.
-- **Roadmap**: omitir sección entera si `<3 R-items consolidados`.
-- **Sesiones excluidas**: incluir solo si hubo descartes (≥1 sesión sin CONCLUSIONS.md filtrada).
-
-## Ejemplo mínimo (1 sesión input)
-
-Cuando solo hay 1 sesión con CONCLUSIONS.md (caso pesimista), el skill genera igual el documento — sin dedup ni roadmap derivado:
-
-````markdown
----
-sessions: [062]
-created: 2026-05-18
-slug: export-conclusions
-recommendations_count: 8
-roadmap_present: true
-conflicts_count: 0
----
-
-# Conclusiones consolidadas — Roadmap export-plan lifecycle
-
-## Resumen ejecutivo
-
-Single-session consolidation de session062 (analyze del lifecycle post-familia export-*). Sin dedup ni roadmap derivado porque hay 1 sola sesión fuente. El output replica la estructura del input añadiendo trazabilidad explícita.
-
-## Sesiones consolidadas
-
-| Code | Flow | Slug | Modalidad | C-items | R-items |
-|------|------|------|-----------|---------|---------|
-| 062 | analyze | export-plan-lifecycle | technical | 8 | 8 |
-
-## Conclusions (por sesión)
-
-### session062-analyze-export-plan-lifecycle
-- **C1** — `export-plan` cubre un gap real cross-sesión.
-- ... (los 8 C-items del original)
-
-## Recommendations consolidadas (deduplicadas)
-
-### R1-consolidado — bundle-plugin-v2-10-0
-- **Origen**: session062:R1
-- **Síntesis**: Bundle aditivo F-A + F-B + F-C + F-E + F-F como plugin v2.10.0 + CLI v6.1.0.
-- ... (los 8 R-items del original, cada uno como consolidado de 1 origen)
-
-## Roadmap derivado (opcional)
-
-(El roadmap original de session062 se preserva tal cual)
-
-## Refs
-
-- `session062-analyze-export-plan-lifecycle` — [`CONCLUSIONS`](../.workflow/sessions/session062-analyze-export-plan-lifecycle/CONCLUSIONS.md)
-````
-
-Nota: para single-session, considerar primero `graduate --kind conclusion --session 062` (copia tal cual, sin curación). Use `export-conclusions` cuando hay valor en la versión "curada con trazabilidad explícita" incluso single-session, o cuando se anticipan más sesiones del dominio (re-emit posterior agrega trazabilidad).

package/skills/agent-workflow/exports/export-plan/SKILL.md

@@ -1,225 +0,0 @@
----
-name: export-plan
-description: "Consolida N sesiones del workspace + `docs/planes/` ya graduados + `docs/decisiones/` / `docs/conclusiones/` para referencias en un plan ejecutable bajo `docs/planes/NNN-export-plan-YYYY-MM-DD.md`. Lee OBJECTIVE/TASKS/CONCLUSIONS de las sesiones fuente y deriva: Resumen · Fases · Tasks (con dependencias) · Riesgos · Refs. Frontmatter YAML con `state` (draft/active/done/archived) y `state_changes[]`. Read-only / reporte — no commitea ni ejecuta. Sexto comando de la familia `/agent-workflow:export-*` (F-A del roadmap session062). Invocado sólo vía `/agent-workflow:export-plan`. v1.1 (session081): corpus extendido a `docs/` además de sesiones (DEC-002) — ver `docs/shared-contract/export-corpus-sources.md`."
-version: 1.1.0
----
-
-# Export Plan — Consolidación de N sesiones en plan ejecutable
-
-Consolida N sesiones (cerradas y/o activas con artefactos completos) en un único plan ejecutable bajo `docs/planes/NNN-export-plan-YYYY-MM-DD.md`. Es **solo lectura/reporte**: el usuario decide cuándo iniciar la ejecución (vía `/agent-workflow:session --from-plan` cuando F-E.3 esté operativo) y cuándo commitear el plan.
-
-> Sexto comando de la familia `/agent-workflow:export-*`. Definido en `docs/conclusiones/008-roadmap-export-plan-lifecycle.md` (F-A). Bundle plugin v2.10.0 con F-B (export-conclusions), F-C (--sessions, ya operativo), F-E (lifecycle), F-F (BACKLOG.md).
-
-## Excepción session-aware
-
-Como otros export-*, requiere conocimiento del lifecycle. **No crea ni modifica sesiones**. Si el workspace no tiene sesiones con OBJECTIVE+TASKS → abortar y sugerir `/agent-workflow:session create`.
-
-**Solo formato actual (v0.9+)**: sesiones legacy abortan; migrar con `/agent-workflow:migrate --upgrade-topology`.
-
-**Consumo de CLI `agent-workflow`** (no leer paths hardcodeados):
-
-- `agent-workflow release-data --include-graduated [--sessions NNN[,NNN]] [--since sessionNNN] [--source alias]` — dump consolidado del corpus.
-- `agent-workflow session-artifacts --code <NNN>` — lectura lazy de OBJECTIVE/TASKS/DECISIONS/CONCLUSIONS.
-- `agent-workflow next-number docs/planes` — numeración determinística del plan.
-- Resolución hub-aware de `docs/planes/` la maneja el CLI internamente.
-
-## When to use
-
-- "Quiero un plan ejecutable a partir de estas sesiones de análisis".
-- "Tengo N sesiones cerradas (analyze + dev) y necesito consolidar las acciones derivadas".
-- "Diseñé en session050 y session055 — generame el plan para arrancar a ejecutar".
-- "Vamos a planificar el próximo sprint a partir del corpus".
-- Antes de iniciar una sesión `dev` que va a tomar varios sub-temas.
-
-## Qué hace este skill
-
-1. Lee sesiones (`.workflow/sessions/`) filtradas por `--sessions`/`--since`/`--source`.
-2. Para cada sesión: lee OBJECTIVE.md (intent), TASKS.md (acciones), CONCLUSIONS.md (recommendations si analyze), DECISIONS.md (constraints), **BACKLOG.md** (tasks abiertas heredadas — F-F, opcional lazy).
-3. Sintetiza:
-   - **Resumen**: objetivo común derivado del corpus.
-   - **Fases**: heurística por flow (dev → planning/exec/validation/closure; analyze → planning si no hay TASKS).
-   - **Tasks**: unión de TASKS abiertas + recommendations cerradas como tareas pendientes + **items de BACKLOG.md** (`Deferred` y `Followups`) si presente. Reordering por dependencias detectadas. Las entradas heredadas de BACKLOG llevan sufijo `[backlog]` para trazabilidad.
-   - **Dependencias externas**: extraídas de OBJECTIVE/DECISIONS.
-   - **Riesgos**: extraídos de FINDINGS/CONCLUSIONS de sesiones analyze.
-   - **Refs**: `file:line` al OBJECTIVE/TASKS/CONCLUSIONS de cada sesión fuente.
-4. Calcula `eta_total` sumando ETAs declaradas en TASKS.md de cada sesión.
-5. Resuelve el NNN con `agent-workflow next-number docs/planes`.
-6. Aplica la plantilla `references/template-plan.md`.
-7. Si `--dry-run`: imprime el plan a stdout sin escribir.
-8. Si no `--dry-run`: escribe `docs/planes/NNN-<slug>-YYYY-MM-DD.md` con `state: draft`.
-
-## Qué NO hace
-
-- Ejecutar commits, merges, push (ver `agent-workflow:commits-policy`).
-- Iniciar la sesión `dev` que ejecutará el plan (eso lo hace `/agent-workflow:session --from-plan <NNN>` cuando F-E.3 esté operativo).
-- Cambiar estado del plan automáticamente más allá de `null → draft`. El resto de transiciones (draft→active, active→done) las maneja `references/state-transitions.md`.
-- Modificar OBJECTIVE/TASKS/etc. de las sesiones fuente.
-- Tocar `docs/conclusiones/`, `docs/decisiones/`, `docs/scripts/`.
-
-## Sandbox read-only
-
-`../session/references/sandbox-readonly-rules.md`. Plan describe NNN resuelto + sesiones incluidas + secciones del plan + estructura del frontmatter YAML + criterio de aceptación.
-
-## Estilo de comunicación
-
-`../session/references/communication-style.md`. Confirmación antes de escribir el plan; si declina, ejecutar como `--dry-run`. Audiencia técnica/PM — términos del dominio (`OBJECTIVE`, `TASKS`, `flow`, `phase`) autorizados.
-
-## Entrada
-
-```
-/agent-workflow:export-plan [--sessions NNN[,NNN]] [--since sessionNNN] [--source <alias>]
-                 [--slug <kebab>] [--dry-run]
-```
-
-| Flag | Comportamiento |
-|---|---|
-| `--sessions NNN[,NNN]` | Filtro discreto por código. Toma precedencia sobre `--since`. |
-| `--since sessionNNN` | Sesiones posteriores a NNN (inclusive). Ignorado si `--sessions` presente. |
-| `--source <alias>` | Limita a fuente específica (hub mode). |
-| `--slug <kebab>` | Override del slug del filename (default: `export-plan`). |
-| `--dry-run` | Reporte propositivo sin escribir el plan. |
-
-Sin args: incluye todas las sesiones cerradas + activas con artefactos completos.
-
-Ejemplo: `/agent-workflow:export-plan --sessions 055,061 --slug runtime-evolution` genera `docs/planes/NNN-runtime-evolution-YYYY-MM-DD.md`.
-
-## Flujo
-
-### Paso 1 — Resolver contexto
-
-```
-agent-workflow release-data --include-graduated [--sessions NNN[,NNN]] [--since sessionNNN] [--source <alias>]
-```
-
-Output: `{workspace_mode, source_alias, docs_root, sessions[], sessions_count, legacy_sessions}`.
-
-**Sesiones legacy**: si `legacy_sessions` no vacío → abortar:
-
-> Sesiones en formato legacy detectadas: sessionXXX, sessionYYY. Migrar con `/agent-workflow:migrate --upgrade-topology` antes de export-plan.
-
-**Corpus vacío**: si `sessions_count == 0` → abortar con mensaje:
-
-> Sin sesiones que cumplan el filtro. Ajustá `--sessions` o `--since`.
-
-### Paso 2 — Recolectar artefactos por sesión
-
-Por cada sesión del corpus:
-
-```
-agent-workflow session-artifacts --code <NNN>
-```
-
-Recolectar:
-- `OBJECTIVE.md` body (requirement + acceptance criteria + topics).
-- `TASKS.md` (cerradas y abiertas).
-- `CONCLUSIONS.md` si presente (recommendations).
-- `DECISIONS.md` headers (constraints derivadas).
-- `FINDINGS.md` si presente (riesgos derivados).
-- `BACKLOG.md` si presente (Deferred + Followups como tasks heredadas; Discarded para trazabilidad).
-
-### Paso 3 — Síntesis
-
-#### 3.1 Resumen
-
-Síntesis 2-3 párrafos derivada de los OBJECTIVEs de las sesiones fuente. Lenguaje del usuario (ES default). Sin jerga inventada.
-
-#### 3.2 Fases
-
-Heurística por flow predominante del corpus:
-
-| Flow predominante | Fases sugeridas |
-|---|---|
-| `dev` (mayoría) | planning · execution · validation · closure |
-| `analyze` (mayoría) | planning · evidence · synthesis · graduación |
-| `design` (mayoría) | discovery · design · delivery |
-| Mezcla | planning · execution · validation · closure (default genérico) |
-
-Por cada fase: nombre, criterios de entrada, criterios de salida.
-
-#### 3.3 Tasks
-
-Tabla MD con columnas: `ID | Task | ETA | Fase | Depende de | Sesión origen`.
-
-Reglas:
-- Renumerar `T1...TN` globales.
-- Preservar el ID original como sufijo en "Sesión origen" (`session055:T3`).
-- Detectar dependencias por menciones cruzadas en TASKS/DECISIONS.
-- Marcar `[done]` las tareas ya cerradas en sus sesiones origen (mantener trazabilidad).
-
-#### 3.4 Dependencias externas
-
-Lista de bullets: librerías/servicios externos mencionados en DECISIONS o OBJECTIVE.
-
-#### 3.5 Riesgos
-
-De FINDINGS/CONCLUSIONS de sesiones analyze:
-- `R1 — descripción` + `Mitigación: ...`
-
-#### 3.6 Refs
-
-Cada sesión origen como bullet con paths relativos:
-
-```
-- session055-analyze-docs-from-sessions [`OBJECTIVE`](../.workflow/sessions/session055-analyze-docs-from-sessions/OBJECTIVE.md) · [`CONCLUSIONS`](.../CONCLUSIONS.md)
-```
-
-### Paso 4 — Resolver NNN + filename
-
-```
-agent-workflow next-number docs/planes
-```
-
-Output: `next` (NNN). Filename:
-
-```
-docs/planes/<NNN>-<slug>-YYYY-MM-DD.md
-```
-
-Donde `<slug>` = `--slug` arg o default `export-plan`. `YYYY-MM-DD` = fecha del sistema.
-
-### Paso 5 — Aplicar plantilla
-
-Leer `references/template-plan.md` y rellenar campos derivados. Estructura final del MD:
-
-1. Frontmatter YAML (state, sessions, created, slug, state_changes, eta_total, dependencies_external, risks).
-2. `# Plan — <título derivado>`.
-3. `## Resumen`.
-4. `## Fases`.
-5. `## Tasks` (tabla).
-6. `## Dependencias externas`.
-7. `## Riesgos`.
-8. `## Refs`.
-
-### Paso 6 — Escribir o reportar
-
-Si `--dry-run`: print a stdout. Si no: `Write` el archivo.
-
-**NUNCA commitear**. Reportar al usuario:
-
-> Plan escrito en `docs/planes/NNN-<slug>-YYYY-MM-DD.md` con state=draft. Sin commit. Cuando estés listo, podés:
-> - Iniciar ejecución: `/agent-workflow:session --from-plan NNN` (cuando F-E.3 esté operativo).
-> - Refinar el plan editándolo directamente.
-> - Archivar si supersede uno previo: ver `references/state-transitions.md`.
-
-## Estados del plan
-
-Definidos en `references/state-transitions.md`. Resumen:
-
-- `null → draft`: este skill al crear.
-- `draft → active`: `/agent-workflow:session --from-plan` (futuro F-E.3).
-- `active → done`: `AskUserQuestion plan-state` cuando todas las tasks cerradas.
-- `* → archived`: manual o por re-emit.
-
-## Plan mode
-
-Describir en el plan file: NNN del plan, sesiones del corpus, sección por sección lo que se generaría, frontmatter YAML preview. NO escribir el archivo.
-
-## Recursos
-
-- `references/template-plan.md` — plantilla canónica del plan.
-- `references/state-transitions.md` — árbol de decisión G3 + spec `AskUserQuestion plan-state`.
-- `../session/references/sandbox-readonly-rules.md` — reglas de plan mode.
-- `../session/references/communication-style.md` — estilo de prosa.
-- `../redaccion-simple/SKILL.md` — guía transversal de redacción.
-- `docs/conclusiones/008-roadmap-export-plan-lifecycle.md` — diseño F-A.
-- Sibling: `agent-workflow/skills/export-scripts/SKILL.md`, `export-report/SKILL.md`, `export-tech-manuals/SKILL.md`, `export-arq/SKILL.md`.

package/skills/agent-workflow/exports/export-plan/references/state-transitions.md

@@ -1,141 +0,0 @@
-# State transitions — `docs/planes/NNN-*.md`
-
-Reglas canónicas de transición de `state` en el frontmatter YAML del plan. Implementa la decisión G3 de `docs/conclusiones/008-roadmap-export-plan-lifecycle.md` (session062).
-
-## Estados
-
-| State | Significado |
-|---|---|
-| `draft` | Plan creado. Sin sesión vinculada todavía. Editable libremente. |
-| `active` | Una o más sesiones lo están ejecutando vía `--from-plan`. |
-| `done` | Todas las tasks completadas + sesiones vinculadas cerradas sin items abiertos. |
-| `archived` | Reemplazado por nueva versión o cancelado por decisión explícita. |
-
-## Árbol de decisión
-
-```
-null ─[export-plan create]─> draft
-                                │
-                                │ [session-create --from-plan <NNN>] (F-E.3, futuro)
-                                ▼
-                              active
-                                │
-                                │ [todas tasks closed Y sesiones vinculadas closed sin opens]
-                                ▼
-                          AskUserQuestion plan-state
-                                ├─ "Marcar done" ──> done
-                                ├─ "Mantener active porque queda follow-up" ──> (sin cambio)
-                                └─ "Archivar" ──> archived
-
-active|done ─[export-plan re-emit con mismo slug]─> AskUserQuestion plan-state
-                                                       ├─ "Archivar el anterior" ──> archived (previo)
-                                                       └─ "Cancelar re-emit" ──> (sin cambio)
-
-* ─[solicitud explícita del usuario]─> archived
-```
-
-## Transiciones automáticas
-
-### `null → draft`
-
-**Trigger**: `/agent-workflow:export-plan` crea el archivo.
-
-**Sin prompt** — escribir directo y registrar en `state_changes[]`:
-
-```yaml
-state_changes:
-  - {from: null, to: draft, when: '<ISO>', trigger: 'export-plan create'}
-```
-
-### `draft → active`
-
-**Trigger**: `agent-workflow session-create --from-plan <NNN>` (capacidad F-E.3, futuro).
-
-Cuando F-E.3 esté operativo:
-- El CLI o el skill `session` lee el frontmatter del plan.
-- Si `state == draft`: actualizar a `active` y agregar entry en `state_changes`.
-- Si `state == active`: no-op (otra sesión ya lo activó).
-- Si `state == done|archived`: prompt al usuario (`AskUserQuestion plan-state` con opciones "Reactivar / Crear plan nuevo / Cancelar").
-
-**Sin prompt en draft→active**: la activación es implícita al usar `--from-plan`.
-
-## Transiciones con `AskUserQuestion plan-state`
-
-### Spec del prompt
-
-Cuando el skill detecta heurística de transición (active→done) pero hay ambigüedad o cuando se re-emite un plan que supersede uno previo:
-
-```
-header:  plan-state
-question:  ¿Marcar el plan <NNN-slug> como?
-options:
-  1. Marcar done — todas las tasks cerradas y sesiones vinculadas concluidas.
-     (Recomendado si auto-detección retorna 100% clean)
-  2. Mantener active — queda follow-up pendiente.
-  3. Archivar — superseded o ya no aplica.
-multiSelect: false
-preview:  (opcional, ASCII con la tabla de tasks abiertas/cerradas)
-```
-
-**Other auto** = "Otra acción" → registrar como nota informal en `state_changes.trigger`.
-
-### Heurística para disparar `active → done`
-
-Disparar el prompt cuando:
-
-- `tasks_open == 0` Y `tasks_total > 0` en el plan.
-- Para cada sesión en `frontmatter.sessions[]`: la sesión está cerrada en HISTORY (`state == 'closed'`) Y `tasks_data --code <NNN>` retorna `open == 0`.
-
-Si la heurística retorna 100% clean → opción 1 marcada `(Recomendado)`.
-
-Si la heurística detecta sesiones abiertas → opción 2 marcada `(Recomendado)`.
-
-Si el trigger fue "re-emit con mismo slug" → opción 3 marcada `(Recomendado)`.
-
-### Regla absoluta
-
-**Nunca cambiar estado sin confirmación si la heurística no es 100%**. El frontmatter YAML registra cada cambio:
-
-```yaml
-state_changes:
-  - {from: null, to: draft, when: '2026-05-18T22:00:00Z', trigger: 'export-plan create'}
-  - {from: draft, to: active, when: '2026-05-20T10:15:00Z', trigger: 'session-create --from-plan 001'}
-  - {from: active, to: done, when: '2026-05-25T18:00:00Z', trigger: 'AskUserQuestion plan-state opción 1'}
-```
-
-## Transiciones manuales
-
-### `* → archived` por solicitud explícita
-
-Trigger: el usuario pide explícitamente "archivá el plan NNN" (vía slash command no canónico — por ahora, edición manual del frontmatter).
-
-### `archived → draft` (reapertura)
-
-No soportado por design. Si el usuario quiere reabrir: emitir un plan nuevo con `/agent-workflow:export-plan` y referenciar el archivado en el Resumen.
-
-## Skips
-
-- **Plan mode**: NO transicionar nada. Solo describir lo que se haría.
-- **Dry-run del export-plan**: la transición `null → draft` se simula pero no se persiste (no se escribe el archivo).
-
-## Trazabilidad
-
-Cada entry en `state_changes[]` es append-only y debe incluir:
-
-- `from`: estado previo (o `null` para creación).
-- `to`: estado nuevo.
-- `when`: timestamp ISO-8601 UTC.
-- `trigger`: identifica el origen (`export-plan create`, `session-create --from-plan`, `AskUserQuestion plan-state opción N`, `manual`).
-
-Nunca borrar entries previas. La auditoría es parte del valor del artefacto.
-
-## Resumen operacional para el skill
-
-| Situación | Acción |
-|---|---|
-| `export-plan` crea archivo | `null → draft` automático, sin prompt |
-| `session-create --from-plan` (F-E.3) | `draft → active` automático, sin prompt |
-| Re-emit con mismo slug | Disparar `AskUserQuestion plan-state` para archivar previo |
-| `resume` detecta auto-done condición | Disparar `AskUserQuestion plan-state` con opción 1 recomendada |
-| Usuario pide "archivar" | Editar `state: archived` + append `state_changes` |
-| Heurística inconclusa | Disparar `AskUserQuestion plan-state` sin recomendación marcada |