@tacuchi/agent-workflow-cli 12.3.0 → 12.5.0

package/skills/w/artifacts/artifacts-research/ANALYSIS-FILE.md

@@ -1,48 +1,35 @@
-# ANALYSIS-FILE.md — research session analysis file
+# ANALYSIS-FILE.md — research analysis scratchpad
 
-> What it is: the working analysis document of a `research` session. Created on-demand by any loop. Not resumable (run-and-close) — the owning `refine/control` session's CHECKPOINT tracks open research sessions.
+> What it is: an **optional** working scratchpad for deeper investigations, written inline into the active session (`refine`/`exec`/`quick`). For light research, writing only `CONCLUSIONS` is fine — skip this file.
 
-# Case (text):
+## Case
 Short title.
 
-## Question (text)
-What needs to be clarified or demonstrated?
+## Question
+What needs to be clarified or demonstrated? Example: why does endpoint X return stale data after the cache refresh?
 
-Example:
-Why does client X appear with a pending balance if they already made the payment?
+## Context
+Optional — one line of scope if useful: system / module + what's in scope.
 
-## Context (text)
-Example:
-- Requester:
-- Area:
-- System / module:
-- Case date:
-- Known impact:
-
-## Initial Hypotheses (text|list)
+## Initial Hypotheses
 - H1:
 - H2:
-- H3:
 
-## Evidences (list|table):
+## Evidences
+Open-ended — add rows for whatever dev-relevant sources you actually used. Seeded with the common ones:
 | ID | Source | Finding | Link / file / query |
 |---|---|---|---|
 | E1 | DB | | |
 | E2 | Code | | |
 | E3 | Logs | | |
-| E4 | Email | | |
-| E5 | File | | |
 
-## Findings (text|list)
+## Findings
 What do the evidences indicate?
 
-- Evidence E1 shows that...
-- Evidence E2 confirms that...
-- Evidence E3 rules out that...
+- E1 shows...
+- E2 confirms...
 
-## Identified Cause (text|list)
+## Identified Cause
 - Technical:
-- Functional:
-- Operational:
 - Data:
 - Undetermined:

package/skills/w/artifacts/artifacts-research/CONCLUSIONS.md

@@ -1,20 +1,17 @@
-# CONCLUSIONS.md — research session conclusions
+# CONCLUSIONS.md — research conclusions
 
-> What it is: the conclusions of a `research` session. Produced when the session closes (success or `inconcluso`). The parent loop reads this to resolve the gap that triggered the research.
+> What it is: the conclusions of an **inline research** activity, written into the active session (`refine`/`exec`/`quick`). Produced when the research concludes (success or `inconcluso`). The parent loop reads this to resolve the gap that triggered the research.
 
-## Conclusion (text|list)
+## Conclusion
 Direct answer to the initial question.
 
-## Recommended Action (text|list)
-
+## Recommended Action
 Example:
-- [ ] Create bugfix
-- [ ] Create requirement
-- [ ] Correct data
-- [ ] Escalate to business
-- [ ] Train user
-- [ ] Close without technical action
-- [ ] Request more information
+- [ ] Fix code
+- [ ] Open follow-up task
+- [ ] Update docs
+- [ ] Defer (insufficient evidence)
+- [ ] No action
 
-## Details (text):
+## Details
 Supporting detail, evidence references, or additional context.

package/skills/w/commands/README.md

@@ -3,7 +3,7 @@
 > This is the **bundle README** for the `/w:` slash-command namespace. Every command listed here is something the **user** invokes directly.
 > Related layers: [`../loops/`](../loops/) (Layer 2, AI-driven) · artifacts live in `.workflow/sessions/` (Layer 3) · permanent deliverables in `docs/`.
 >
-> **Namespace:** all commands are under `w:` (`w` = *workflow*): `/w:spec-new`, `/w:spec-refine`, `/w:plan-new`, `/w:plan-exec`, `/w:quick`, `/w:workspace-init`, `/w:export-*`.
+> **Namespace:** all commands are under `w:` (`w` = *workflow*): `/w:spec-new`, `/w:spec-refine`, `/w:plan-new`, `/w:plan-exec`, `/w:quick`, `/w:workspace-init`, `/w:status` (transversal), `/w:export-*`.
 
 ---
 
@@ -50,20 +50,22 @@
 
 > **Intentional asymmetry:** in SPEC, `spec-new` generates the draft in a **single pass** (no loop) and the loop is in `spec-refine`. In PLANIFICATION, **both** commands start loops. Total: **5 flow commands / 4 loops**.
 
+> **Transversal (no flow):** [`/w:status`](status.md) is a read-only dashboard of the whole workspace — what's done / pending / discarded, with friendly Spanish dates. It leans on `aw status`, writes nothing, and belongs to no flow.
+
 ## Pipeline
 
 ```mermaid
 flowchart LR
     prompt(["user prompt"]) --> sn["/w:spec-new"]
-    sn -->|generates| spec["docs/specs/NNN-spec.md"]
+    sn -->|generates| spec["docs/specs/NNN-spec-<slug>.md"]
     spec -.->|optional manual edit| spec
     spec --> sr["/w:spec-refine"]
     sr -->|starts| srl(["spec-refine-loop"])
-    srl -->|generates| specr["docs/specs/NNN-spec-refined.md"]
+    srl -->|refines IN PLACE| spec
 
-    specr --> pn["/w:plan-new"]
+    spec --> pn["/w:plan-new"]
     pn -->|starts| pnl(["plan-new-loop"])
-    pnl -->|generates| plan["docs/plans/PPP-plan.md"]
+    pnl -->|generates| plan["docs/plans/PPP-plan-<slug>.md"]
 
     plan --> pe["/w:plan-exec"]
     pe -->|starts| pel(["plan-exec-loop"])
@@ -98,7 +100,7 @@ Each `<command>.md` in this bundle uses this frontmatter + body structure:
 3. **Spec and plan are documents** (`docs/`), not artifacts.
 4. **DB scripts-only**: AI **never executes DML/DDL**; migrations live in `SCRIPTS.sql` (type B) and are delivered via `export-scripts`. Only read-only queries via MCP.
 5. **Git-safe**: verify branch before editing; **propose** commits by source; never `push`/`--amend`/`--no-verify`.
-6. **All loops**: gap-driven convergent · `AskUserQuestion` with ≤3 content tabs + 1 `flow` tab (`Compactar`/`Cerrar`) always · compact/resume · `Cerrar` persists `CHECKPOINT`+`BACKLOG`.
+6. **All loops**: gap-driven convergent · one session per run (research inline) · `AskUserQuestion` with ≤3 content tabs + 1 `flow` tab (`Compactar`/`Cerrar`) always · compact/resume · artifacts as a live log (`CHECKPOINT` always; `BACKLOG` only when deferring).
 
 ## Index
 
@@ -110,6 +112,7 @@ Each `<command>.md` in this bundle uses this frontmatter + body structure:
 | `plan-new` | [`plan-new.md`](plan-new.md) | starts `plan-new-loop` |
 | `plan-exec` | [`plan-exec.md`](plan-exec.md) | starts `plan-exec-loop` |
 | `quick` | [`quick.md`](quick.md) | starts `quick-loop` |
+| `status` | [`status.md`](status.md) | single-pass, read-only (transversal) |
 | `export-scripts` | [`export-scripts.md`](export-scripts.md) | single-pass, read-only |
 | `export-manuals` | [`export-manuals.md`](export-manuals.md) | single-pass, read-only |
 | `export-diagrams` | [`export-diagrams.md`](export-diagrams.md) | single-pass, read-only |

package/skills/w/commands/export-diagrams.md

@@ -6,18 +6,14 @@ allowed-tools:
     "Bash",
     "Read",
     "Write",
-    "Skill",
   ]
 ---
 
 # export-diagrams — exportar diagramas
 
-Lee el código de las fuentes del workspace + el plan-doc (secciones `AS-IS`/`TO-BE`) y genera diagramas C4 / mermaid en `docs/diagrams/`. Single-pass, read-only sobre sesiones. Invoca el skill `export-diagrams`.
+Lee el código de las fuentes del workspace + el plan-doc (secciones `AS-IS`/`TO-BE`) y genera diagramas C4 / mermaid en `docs/diagrams/`. Single-pass, read-only sobre sesiones.
 
-```
-Skill: export-diagrams
-args: $ARGUMENTS
-```
+Para ejecutar: **leé** `../exports/export-diagrams/SKILL.md` y **seguí** sus instrucciones con `$ARGUMENTS` como input. No intentes `Skill: export-diagrams` (no está registrada por nombre); el SKILL.md hermano es el cuerpo de este export.
 
 ## Qué produce
 

package/skills/w/commands/export-manuals.md

@@ -6,18 +6,14 @@ allowed-tools:
     "Bash",
     "Read",
     "Write",
-    "Skill",
   ]
 ---
 
 # export-manuals — exportar manuales
 
-Consolida sesiones + artefactos `DECISION` + plan-doc (`Final behavior`) + código fuente y genera documentación de usuario/operación en `docs/manuals/`. Single-pass, read-only sobre sesiones. Invoca el skill `export-manuals`.
+Consolida sesiones + artefactos `DECISION` + plan-doc (`Final behavior`) + código fuente y genera documentación de usuario/operación en `docs/manuals/`. Single-pass, read-only sobre sesiones.
 
-```
-Skill: export-manuals
-args: $ARGUMENTS
-```
+Para ejecutar: **leé** `../exports/export-manuals/SKILL.md` y **seguí** sus instrucciones con `$ARGUMENTS` como input. No intentes `Skill: export-manuals` (no está registrada por nombre); el SKILL.md hermano es el cuerpo de este export.
 
 ## Qué produce
 

package/skills/w/commands/export-reports.md

@@ -6,18 +6,14 @@ allowed-tools:
     "Bash",
     "Read",
     "Write",
-    "Skill",
   ]
 ---
 
 # export-reports — exportar informes
 
-Consolida el corpus completo de sesiones (`CONCLUSIONS`, `DECISION`, spec) + plan-doc (estado) + `docs/` y genera un informe ejecutivo o funcional en `docs/reports/`. Single-pass, read-only sobre sesiones. Invoca el skill `export-reports`.
+Consolida el corpus completo de sesiones (`CONCLUSIONS`, `DECISION`, spec) + plan-doc (estado) + `docs/` y genera un informe ejecutivo o funcional en `docs/reports/`. Single-pass, read-only sobre sesiones.
 
-```
-Skill: export-reports
-args: $ARGUMENTS
-```
+Para ejecutar: **leé** `../exports/export-reports/SKILL.md` y **seguí** sus instrucciones con `$ARGUMENTS` como input. No intentes `Skill: export-reports` (no está registrada por nombre); el SKILL.md hermano es el cuerpo de este export.
 
 ## Qué produce
 

package/skills/w/commands/export-scripts.md

@@ -6,18 +6,14 @@ allowed-tools:
     "Bash",
     "Read",
     "Write",
-    "Skill",
   ]
 ---
 
 # export-scripts — exportar scripts de BD
 
-Promueve los artefactos `SCRIPTS.sql` (tipo B — migraciones) de N sesiones de `.workflow/sessions/` a `docs/scripts/`. Single-pass, read-only sobre sesiones. Invoca el skill `export-scripts`.
+Promueve los artefactos `SCRIPTS.sql` (tipo B — migraciones) de N sesiones de `.workflow/sessions/` a `docs/scripts/`. Single-pass, read-only sobre sesiones.
 
-```
-Skill: export-scripts
-args: $ARGUMENTS
-```
+Para ejecutar: **leé** `../exports/export-scripts/SKILL.md` y **seguí** sus instrucciones con `$ARGUMENTS` como input. No intentes `Skill: export-scripts` (no está registrada por nombre); el SKILL.md hermano es el cuerpo de este export.
 
 ## Qué produce
 

package/skills/w/commands/plan-exec.md

@@ -1,31 +1,32 @@
 ---
 description: Inicia o retoma el loop de ejecución (plan-exec-loop) sobre un plan existente. Aquí ocurre el trabajo real: edición de código, scripts SQL propuestos, herramientas creadas. Git-safe.
-argument-hint: <docs/plans/PPP-plan.md>
+argument-hint: <docs/plans/PPP-plan-<slug>.md>
 allowed-tools:
   [
     "Bash",
     "Read",
     "Write",
     "Edit",
-    "Skill",
   ]
 ---
 
 # plan-exec — trampolín al loop de ejecución
 
-Arranca o retoma `plan-exec-loop` (Layer 2), que ejecuta el trabajo real fase por fase. El plan (`docs/plans/PPP-plan.md`) es un documento vivo que el loop mantiene actualizado (estado de fases y tareas).
+Arranca o retoma `plan-exec-loop` (Layer 2), que ejecuta el trabajo real fase por fase. El plan (`docs/plans/PPP-plan-<slug>.md`) es un documento vivo que el loop mantiene actualizado (estado de fases y tareas).
 
-Invocar el skill:
+## Ejecutar el loop
 
-```
-Skill: plan-exec-loop
-args: $ARGUMENTS
-```
+`plan-exec-loop` **no** es una skill invocable por nombre — es el manual de operación de este comando (un doc hermano del bundle). **Cargalo y ejecutalo de punta a punta**:
+
+1. **Leé** `../loops/plan-exec-loop/SKILL.md` (ruta relativa a este archivo).
+2. **Seguí** sus instrucciones tomando `$ARGUMENTS` como input: detecta CHECKPOINT/resume, ejecuta fase por fase (git-safe, BD solo-scripts), mantiene el plan vivo y reporta.
+
+> No intentes `Skill: plan-exec-loop` — no está registrada como skill. El comando **es** la entrada; el loop es su cuerpo.
 
 ## Qué hace el loop (resumen)
 
-- Lee y actualiza `docs/plans/PPP-plan.md` (living doc: estado de fases/tareas).
-- Edita código en las fuentes del workspace (una sesión por fase).
+- Lee y actualiza `docs/plans/PPP-plan-<slug>.md` (living doc: estado de fases/tareas).
+- Edita código en las fuentes del workspace (una sola sesión de ejecución para el run; la ejecución sigue siendo fase por fase, solo que no hay sesión por fase).
 - Escribe herramientas/utilidades reutilizables en `docs/tools/`.
 - Propone commits por fuente (git-safe: verifica rama, propone, nunca push/--amend/--no-verify).
 - Genera artefactos de sesión (`DECISION`, `SCRIPTS.sql`) en `.workflow/sessions/`.

package/skills/w/commands/plan-new.md

@@ -1,13 +1,12 @@
 ---
-description: Inicia o retoma el loop de planificación (plan-new-loop) a partir de un spec refinado. Convierte el "qué" (spec) en el "cómo" (plan). Input ideal: docs/specs/NNN-spec-refined.md.
-argument-hint: <docs/specs/NNN-spec-refined.md | docs/specs/NNN-spec.md | prompt>
+description: Inicia o retoma el loop de planificación (plan-new-loop) a partir de un spec. Convierte el "qué" (spec) en el "cómo" (plan). Input ideal: docs/specs/NNN-spec-<slug>.md ya refinado.
+argument-hint: <docs/specs/NNN-spec-<slug>.md | prompt>
 allowed-tools:
   [
     "Bash",
     "Read",
     "Write",
     "Edit",
-    "Skill",
   ]
 ---
 
@@ -17,22 +16,26 @@ Puente SPEC → PLANIFICATION. Convierte el "qué" (spec refinado) en el "cómo"
 
 ## Resolución de input
 
-El skill evalúa `$ARGUMENTS`:
+El skill evalúa `$ARGUMENTS` (los specs viven in place — `docs/specs/NNN-spec-<slug>.md`; localizar vía glob `docs/specs/NNN-spec-*.md` o la ruta exacta):
 
-1. **`docs/specs/NNN-spec-refined.md`** → ideal. Procede directamente a `plan-new-loop`.
-2. **`docs/specs/NNN-spec.md`** (borrador sin refinar) → propone correr `/w:spec-refine` primero; planificar sobre un spec sólido produce mejores planes.
+1. **Spec refinado** (`docs/specs/NNN-spec-<slug>.md` que **ya tiene** `## Refinement decisions` / `## Q&A traceability`) → ideal. Procede directamente a `plan-new-loop`.
+2. **Spec borrador** (mismo archivo, pero **sin** esas dos secciones) → **soft-suggest** correr `/w:spec-refine` primero; planificar sobre un spec sólido produce mejores planes (el usuario puede proceder igual).
 3. **prompt** (sin spec referenciado) → propone usar el flujo SPEC; **por default lanza `/w:spec-new`** con ese prompt para crear el borrador, y desde ahí continúa el flujo natural.
 
-Invocar el skill:
+> **Refinado vs borrador** se distingue por la **presencia** de `## Refinement decisions` / `## Q&A traceability` en el spec, no por el nombre del archivo (ya no hay `-refined`).
 
-```
-Skill: plan-new-loop
-args: $ARGUMENTS
-```
+## Ejecutar el loop
+
+`plan-new-loop` **no** es una skill invocable por nombre — es el manual de operación de este comando (un doc hermano del bundle). **Cargalo y ejecutalo de punta a punta**:
+
+1. **Leé** `../loops/plan-new-loop/SKILL.md` (ruta relativa a este archivo).
+2. **Seguí** sus instrucciones tomando `$ARGUMENTS` como input (resuelto según las 3 reglas de arriba): detecta estado/resume, corre el motor gap-driven, crea y maneja sessions, converge y reporta.
+
+> No intentes `Skill: plan-new-loop` — no está registrada como skill. El comando **es** la entrada; el loop es su cuerpo.
 
 ## Notas de numeración
 
-El plan toma su propio número `PPP` en `docs/plans/`. **No hereda el `NNN` del spec**. El vínculo al spec se establece por referencia (`## Origin` / "Derivado de") en el plan, no por número.
+El plan se nombra `docs/plans/PPP-plan-<slug>.md`. El CLI solo devuelve el número `PPP`; el loop arma el nombre completo (slug = kebab-case corto del Requirement: `[a-z0-9-]`, ≤ ~5 palabras / ≤ 40 chars). **No hereda el `NNN` del spec**. El vínculo al spec se establece por referencia (`## Origin` / "Derivado de") en el plan, no por número.
 
 ## Plan mode
 

package/skills/w/commands/quick.md

@@ -7,7 +7,6 @@ allowed-tools:
     "Read",
     "Write",
     "Edit",
-    "Skill",
   ]
 ---
 
@@ -15,12 +14,14 @@ allowed-tools:
 
 Para tareas acotadas y directas que no justifican pasar por SPEC ni PLANIFICATION. Siempre crea una sesión ligera (trazabilidad + resume). Delega a `quick-loop` (Layer 2).
 
-Invocar el skill:
+## Ejecutar el loop
 
-```
-Skill: quick-loop
-args: $ARGUMENTS
-```
+`quick-loop` **no** es una skill invocable por nombre — es el manual de operación de este comando (un doc hermano del bundle). **Cargalo y ejecutalo de punta a punta**:
+
+1. **Leé** `../loops/quick-loop/SKILL.md` (ruta relativa a este archivo).
+2. **Seguí** sus instrucciones tomando `$ARGUMENTS` como la tarea: crea la session ligera, trabaja con ceremonia mínima (git-safe), escala a SPEC/PLAN si crece, y reporta.
+
+> No intentes `Skill: quick-loop` — no está registrada como skill. El comando **es** la entrada; el loop es su cuerpo.
 
 ## Qué hace el loop
 

package/skills/w/commands/spec-new.md

@@ -1,5 +1,5 @@
 ---
-description: Genera un borrador de especificación (docs/specs/NNN-spec.md) a partir de un prompt, en una sola pasada. Paso 1 del flujo SPEC; no arranca loop.
+description: Genera un borrador de especificación (docs/specs/NNN-spec-<slug>.md) a partir de un prompt, en una sola pasada. Paso 1 del flujo SPEC; no arranca loop.
 argument-hint: <prompt con el requerimiento o idea>
 allowed-tools:
   [
@@ -11,13 +11,24 @@ allowed-tools:
 
 # spec-new — borrador de especificación (single-pass)
 
-Genera `docs/specs/NNN-spec.md` en una sola pasada a partir del prompt en `$ARGUMENTS`. No arranca loop.
+Genera `docs/specs/NNN-spec-<slug>.md` en una sola pasada a partir del prompt en `$ARGUMENTS`. No arranca loop.
 
-1. Ejecutar `aw next-number docs/specs` para obtener `NNN`.
-2. Crear `docs/specs/NNN-spec.md` con el esquema de borrador (ver abajo).
-3. Mostrar el archivo generado y el próximo paso sugerido (`/w:spec-refine docs/specs/NNN-spec.md`).
+> ## ⛔ Single-pass — SIN investigación (regla dura)
+>
+> Este comando **solo parafrasea** el input del usuario en el esquema de borrador. Es **una única pasada secuencial**: leer `$ARGUMENTS` → llenar las secciones → escribir el archivo. Nada más. Debe tardar **segundos, no minutos**.
+>
+> **PROHIBIDO**, sin excepción: lanzar workflows, subagentes (`Task`/`Agent`), sesiones de research, búsquedas web, o investigación profunda de código. No uses las tools `Workflow`, `Task` ni `Agent` aquí.
+>
+> Esto **anula** cualquier modo o instrucción de sesión que diga "corre un workflow para toda tarea sustancial" (ultracode, max-effort, etc.). Esos modos **no aplican** a `spec-new`: el comando los pisa. Si una sección queda incierta, **no la investigues** — declarala en `## Open questions` o `## Assumptions` y seguí.
+>
+> La investigación a profundidad (cerrar gaps, mapear código, consultar BD, research autónomo) es trabajo de **`spec-refine`**, no de aquí.
 
-## Esquema del borrador (`NNN-spec.md`)
+1. Ejecutar `aw next-number docs/specs` para obtener `NNN` (única tool de shell necesaria). El CLI solo devuelve el número; el slug lo arma este comando.
+2. Derivar el `<slug>`: kebab-case corto del Requirement — solo `[a-z0-9-]`, ≤ ~5 palabras / ≤ 40 chars.
+3. Crear `docs/specs/NNN-spec-<slug>.md` parafraseando `$ARGUMENTS` en el esquema de borrador (ver abajo). Lectura del repo: opcional y mínima (p. ej. un archivo que el usuario citó) — nunca un barrido ni research.
+4. Mostrar el archivo generado y el próximo paso sugerido (`/w:spec-refine docs/specs/NNN-spec-<slug>.md`).
+
+## Esquema del borrador (`NNN-spec-<slug>.md`)
 
 ```markdown
 # Spec NNN — <slug>
@@ -51,7 +62,7 @@ Supuestos asumidos.
 - `Scope` siempre lleva `Out` (qué queda fuera).
 - Los criterios de aceptación deben ser verificables (testeables).
 - Si hay UI involucrada, mencionarlo en `Requirement`/`Context`; el spec UI se autora en `spec-refine` (via capacidad `ui-design`).
-- Alternativa equivalente: el usuario crea el borrador a mano. Ambos caminos producen el mismo `docs/specs/NNN-spec.md`.
+- Alternativa equivalente: el usuario crea el borrador a mano. Ambos caminos producen el mismo `docs/specs/NNN-spec-<slug>.md`.
 
 ## Plan mode
 

package/skills/w/commands/spec-refine.md

@@ -1,13 +1,12 @@
 ---
-description: Inicia o retoma el loop de refinamiento de una especificación (spec-refine-loop). Input: docs/specs/NNN-spec.md (borrador). Output: docs/specs/NNN-spec-refined.md.
-argument-hint: <docs/specs/NNN-spec.md>
+description: Inicia o retoma el loop de refinamiento de una especificación (spec-refine-loop). Input: docs/specs/NNN-spec-<slug>.md (borrador). Actualiza docs/specs/NNN-spec-<slug>.md in place.
+argument-hint: <docs/specs/NNN-spec-<slug>.md>
 allowed-tools:
   [
     "Bash",
     "Read",
     "Write",
     "Edit",
-    "Skill",
   ]
 ---
 
@@ -15,21 +14,25 @@ allowed-tools:
 
 Este comando no refina el spec él mismo: delega al loop `spec-refine-loop` (Layer 2), que es quien itera, cierra gaps y produce el spec refinado.
 
-Invocar el skill:
+## Ejecutar el loop
 
-```
-Skill: spec-refine-loop
-args: $ARGUMENTS
-```
+`spec-refine-loop` **no** es una skill invocable por nombre — es el manual de operación de este comando (un doc hermano del bundle). **Cargalo y ejecutalo de punta a punta**:
+
+1. **Leé** `../loops/spec-refine-loop/SKILL.md` (ruta relativa a este archivo).
+2. **Seguí** sus instrucciones tomando `$ARGUMENTS` como input: detecta estado/resume, corre el motor gap-driven, crea y maneja sessions, converge y reporta.
+
+> No intentes `Skill: spec-refine-loop` — no está registrada como skill. El comando **es** la entrada; el loop es su cuerpo.
 
 ## Resolución de estado (resumable)
 
-El skill detecta el estado previo antes de arrancar:
+El skill detecta el estado previo antes de arrancar, **keyando off el `CHECKPOINT`** (no la existencia de un archivo "refined"):
 
 1. Busca la sesión de refinamiento del spec en `.workflow/sessions/` y su `CHECKPOINT.md`.
 2. **En curso** (existe CHECKPOINT) → continúa desde el avance previo (gaps resueltos, Q&A).
-3. **Sin avance** (sin CHECKPOINT ni refined) → arranca desde cero leyendo `NNN-spec.md`.
-4. **Ya completado** (existe `NNN-spec-refined.md`, sin CHECKPOINT abierto) → re-refinamiento incremental: lee el **refined** como input (NO el borrador stale); al `Guardar`, sobrescribe con confirmación.
+3. **Sin avance** (sin CHECKPOINT y el spec **no** tiene `## Refinement decisions`/`## Q&A traceability`) → arranca desde cero leyendo el spec (`NNN-spec*.md`).
+4. **Ya refinado** (sin CHECKPOINT abierto pero el spec **ya tiene** `## Refinement decisions`/`## Q&A traceability`) → re-refinamiento incremental leyendo el **spec mismo**; al `Guardar`, edita in place con confirmación.
+
+> **Compat (legacy):** el glob `NNN-spec*.md` también captura specs viejos `NNN-spec.md` / `NNN-spec-refined.md`. Re-correr spec-refine los edita in place de ahí en adelante.
 
 ## Plan mode
 

package/skills/w/commands/status.md

@@ -0,0 +1,50 @@
+---
+description: Dashboard read-only del workspace — qué se hizo / qué falta / qué se descartó, con fechas en español (hace 2 días, ayer en la mañana). Se apoya en `aw status`. Comando transversal (no es un flow); no escribe nada.
+argument-hint: (sin argumentos)
+allowed-tools:
+  [
+    "Bash",
+    "Read",
+  ]
+---
+
+# status — estado del workspace (read-only)
+
+Muestra, simple y directo, el estado del workspace agrupado en **Hecho / Falta / Descartó**. Single-pass, read-only: no abre loop, no crea sesiones, no escribe en `docs/` ni en `.workflow/`. Comando **transversal** (no pertenece a ningún flow).
+
+## Ejecutar
+
+1. Corré `aw status` (devuelve JSON; se apoya en `status-service`).
+2. Renderizá un resumen legible a partir del JSON — **no** muestres el JSON crudo. Usá el campo `relative` tal cual (ya viene humanizado en español). Encabezá con `workspace.name`.
+3. Agrupá en tres bloques:
+   - **▸ HECHO** — specs con `refined: true`; plans con su progreso (`tasks_done`/`tasks_total`, `progress_pct`); sesiones `closed`.
+   - **▸ FALTA** — sesiones `active`; plans con tareas pendientes (`tasks_total − tasks_done`); specs con `open_questions > 0`.
+   - **▸ DESCARTÓ** — cada item de `discarded[]` (`kind: deferred` = diferido en BACKLOG; `kind: excluded` = excluido en CHECKPOINT), con su `text`.
+4. Cada línea termina con su fecha relativa tras ` · ` (ej. `· ayer en la mañana`). Si una sección queda vacía, mostrá `— (nada)`. No inventes datos que no estén en el JSON.
+5. Si `workspace.initialized` es `false` y todo está vacío → decí "No es un workspace de agent-workflow (no hay `.workflow/`)" y sugerí `/w:workspace-init`.
+
+Formato sugerido (texto plano):
+
+```
+Workspace: <name>
+
+▸ HECHO
+  • plan <slug> — <done>/<total> tareas (<pct>%) · <relative>
+  • spec <slug> — refinado · <relative>
+  • <folder> (<type>) — cerrada · <relative>
+
+▸ FALTA
+  • <folder> (<type>) — activa · <relative>
+  • plan <slug> — <pendientes> tareas pendientes
+  • spec <slug> — <n> preguntas abiertas
+
+▸ DESCARTÓ
+  • <text> (<kind>) · <relative>
+```
+
+## Plan mode
+Igual que en ejecución: corré `aw status` (read-only) y mostrá el resumen. No hay cambios que aplicar.
+
+## Resources
+- CLI: `aw status` (servicio `status-service`; fechas vía `humanize-es`)
+- Design reference: `docs/referencias/workflow-commands/status.md`

package/skills/w/loops/README.md

@@ -8,12 +8,12 @@
 
 ## What a loop is
 
-Un loop es una **skill** que le enseña a la IA *cómo iterar* hasta producir un entregable. Se invoca por su `name:` con el tool `Skill`. La IA lo ejecuta de punta a punta: detecta huecos, los resuelve (preguntando al humano o investigando), integra y repite hasta converger.
+Un loop es una **skill** que le enseña a la IA *cómo iterar* hasta producir un entregable. **No es invocable por nombre** con el tool `Skill` (no se registra como skill suelta): es el cuerpo de su comando `/w:…`, que lo **carga leyendo `<loop>/SKILL.md`** y lo ejecuta inline. La IA lo corre de punta a punta: detecta huecos, los resuelve (preguntando al humano o investigando), integra y repite hasta converger.
 
 Propiedades comunes a **los 4 loops**:
 
 1. **Gap-driven convergente** — cada ciclo: `detect_gaps` → resolver (humano o research) → integrar → repetir hasta que no queden gaps materiales. Los gaps "agotados" (límite `MAX` de intentos) no se re-disparan → garantiza convergencia.
-2. **Puede crear sessions internas** — si refinar/planificar/ejecutar requiere trabajo profundo (ej. investigar el código), el loop crea una session en `.workflow/sessions/` que maneja **sus** artefactos, la cierra y reporta de vuelta. **El usuario nunca crea esas sessions.**
+2. **Una sola session por run + research inline** — el loop crea **una** session en `.workflow/sessions/` (la dueña del run) y maneja **sus** artefactos. La **investigación es inline**: una actividad dentro de esa misma session que escribe `ANALYSIS-FILE`/`CONCLUSIONS` (+ `SCRIPTS.sql` read-only si consulta BD) en su propia carpeta — ya no es una session aparte. **El usuario nunca crea sessions.** Los artefactos son el **registro vivo** del run — **ciclo artifact-first**: sembrar `CHECKPOINT.Pending/Next` (la intención) antes de ejecutar, llevar a `Completed`/DECISION después; CHECKPOINT actualizado en cada límite de gap/fase, BACKLOG solo si difiere. El spec/plan es la base guía.
 3. **AskUserQuestion con dos tipos de tab** (límite host: 4 preguntas/llamada):
    - **tab(s) de contenido** (≤3) — la(s) pregunta(s) real(es) del momento (resolver una duda, elegir MCP, o en convergencia: `Guardar` / `Preguntar algo más`).
    - **tab `flow`** (1, SIEMPRE presente) — control de ciclo de vida por un canal lateral. Así el contenido lo maneja la IA y el ciclo de vida lo dirige el humano.
@@ -26,15 +26,15 @@ El tab `flow` es **fijo**: `Compactar` / `Cerrar`, presente en los 4 loops. Resp
 | Option | What it does |
 |---|---|
 | `Compactar` | Escribe `CHECKPOINT` (session dueña del run) + dispara `/compact` del host y reanuda sin perder el hilo. |
-| `Cerrar` | `finalize`: persiste lo pendiente (`CHECKPOINT` + `BACKLOG`), cierra sessions internas y termina el loop. |
+| `Cerrar` | `finalize`: persiste lo pendiente (`CHECKPOINT` siempre; `BACKLOG` solo si hay algo diferido), cierra la session y termina el loop. |
 
 ## Loops and their flow
 
 | Loop (`name:`) | Flow | Started by | Reads | Writes |
 |---|---|---|---|---|
-| [`spec-refine-loop`](spec-refine-loop/SKILL.md) | SPEC | `/w:spec-refine` | `docs/specs/NNN-spec.md` (o `…-spec-refined.md` si ya existe) | `docs/specs/NNN-spec-refined.md` |
-| [`plan-new-loop`](plan-new-loop/SKILL.md) | PLANIFICATION | `/w:plan-new` | `docs/specs/NNN-spec-refined.md` | `docs/plans/PPP-plan.md` |
-| [`plan-exec-loop`](plan-exec-loop/SKILL.md) | PLANIFICATION | `/w:plan-exec` | `docs/plans/PPP-plan.md` | `docs/plans/PPP-plan.md` (update) + `docs/tools`; resto vía `export-*` |
+| [`spec-refine-loop`](spec-refine-loop/SKILL.md) | SPEC | `/w:spec-refine` | `docs/specs/NNN-spec*.md` (el spec mismo) | `docs/specs/NNN-spec-<slug>.md` (in place) |
+| [`plan-new-loop`](plan-new-loop/SKILL.md) | PLANIFICATION | `/w:plan-new` | `docs/specs/NNN-spec-*.md` | `docs/plans/PPP-plan-<slug>.md` |
+| [`plan-exec-loop`](plan-exec-loop/SKILL.md) | PLANIFICATION | `/w:plan-exec` | `docs/plans/PPP-plan-*.md` | `docs/plans/PPP-plan-<slug>.md` (update) + `docs/tools`; resto vía `export-*` |
 | [`quick-loop`](quick-loop/SKILL.md) | QUICK | `/w:quick` | — (prompt) | edita código + session ligera; **no** `docs/` |
 
 > `/w:spec-new` no tiene loop (es single-pass). Por eso hay **5 comandos / 4 loops**.
@@ -80,12 +80,13 @@ Los **heirs** (`plan-new-loop`, `plan-exec-loop`, `quick-loop`) usan `## Inherit
 ## Chassis / heirs
 
 ```
-spec-refine-loop  ── CHASIS (patrón de referencia: motor gap-driven, sessions,
-        │            AskUserQuestion + tab flow, research autónomo + regla BD,
-        │            compact/resume, Cerrar persiste CHECKPOINT+BACKLOG)
+spec-refine-loop  ── CHASIS (patrón de referencia: motor gap-driven, sesión única,
+        │            AskUserQuestion + tab flow, research autónomo INLINE + regla BD,
+        │            compact/resume, artefactos como log vivo: CHECKPOINT siempre,
+        │            BACKLOG solo si difiere)
         ├── plan-new-loop   (heir)  → deltas: plan rico, gap taxonomy de plan
         ├── plan-exec-loop  (heir)  → deltas: ejecución real (código/BD/git),
-        │                              session por fase, sin auto-export
+        │                              una sola session por run, sin auto-export
         └── quick-loop      (heir)  → deltas: ceremonia mínima, 1 session,
                                        hereda git/BD/no-export de plan-exec
 ```
@@ -103,7 +104,7 @@ Los loops componen **capacidades por su rol**, no skills concretas; la skill que
 | `git` | `git` | `plan-exec-loop` · `quick-loop` |
 | `coding-standards` | `coding-standards` | `plan-exec-loop` · `quick-loop` |
 | `writing` | `writing` | todos los loops |
-| `research` | `research` | todos los loops (research on-demand) |
+| `research` | `research` | todos los loops (research inline) |
 | `testing` | `testing` | `plan-exec-loop` · `quick-loop` |
 | `tools` | `tools` | `plan-exec-loop` |
 | `overview` | `workflow` | cualquiera (orientación) |