create-quiver 0.10.0 → 0.12.1

package/specs/quiver-v23-guided-flow-productization/slices/slice-06-production-plan-review/CLOSURE_BRIEF.md

@@ -0,0 +1,33 @@
+# CLOSURE BRIEF - slice-06: Production plan review
+
+## Resumen de lo realizado
+
+Se agrego la fase `ai review-plan` para revisar el draft del plan tecnico antes de aprobarlo y antes de generar specs. El review usa el perfil `reviewer`, imprime metadata en dry-run, persiste el resultado en `.quiver/approvals/plan-review/` y bloquea la generacion de spec si el plan tecnico no esta revisado y aprobado.
+
+## Validacion contra criterios de aceptacion
+
+- [x] Review generado.
+- [x] Review persistido.
+- [x] Bloqueos aplicados.
+- [x] Tests pasan.
+
+## Cambios relevantes
+
+- Nuevo modulo `src/create-quiver/lib/ai/plan-review.js`.
+- Nuevo subcomando `npx create-quiver ai review-plan`.
+- `flow` ahora guia al usuario a revisar el plan tecnico antes de aprobarlo.
+- `ai approvals` muestra el estado `plan-review`.
+- La generacion de spec exige plan tecnico revisado y aprobado.
+- README, templates, generated docs y smokes quedaron alineados con el nuevo paso.
+
+## Pendientes
+
+- La UX futura podria simplificar `--version <n>` para el plan tecnico revisado, pero no bloquea este slice.
+
+## Riesgos remanentes
+
+- El comando usa CLIs locales de proveedores; en automatizacion se debe seguir usando `--dry-run` o mocks para evitar llamadas pagas.
+
+## Recomendaciones futuras
+
+- En `slice-07`, hacer que la experiencia de creacion de spec explique claramente que la entrada valida es el plan tecnico revisado y aprobado.

package/specs/quiver-v23-guided-flow-productization/slices/slice-06-production-plan-review/EXECUTION_BRIEF.md

@@ -0,0 +1,30 @@
+# EXECUTION BRIEF - slice-06: Production plan review
+
+## Objetivo
+
+Formalizar el prompt de revision del plan como una fase antes de crear specs.
+
+## Alcance
+
+- Nuevo comando o fase de review.
+- Prompt mantenido por Quiver.
+- Persistencia de resultado.
+- Bloqueo opcional/obligatorio para spec creation.
+
+## Criterios de aceptacion
+
+- Detecta supuestos fragiles, huecos, ambiguedades y riesgos.
+- No cuestiona el alcance aprobado.
+- No modifica codigo.
+- Tests pasan.
+
+## Restricciones
+
+- No implementar fixes.
+- No abrir nuevas preguntas si la ambiguedad no bloquea; documentar supuestos.
+
+## Checklist de finalizacion
+
+- [ ] Review command probado.
+- [ ] Estado persistido.
+- [ ] Tests pasan.

package/specs/quiver-v23-guided-flow-productization/slices/slice-06-production-plan-review/slice.json

@@ -0,0 +1,54 @@
+{
+  "slice_id": "slice-06-production-plan-review",
+  "ticket": "QUIVER-23-06",
+  "type": "feature",
+  "title": "Production-readiness plan review phase",
+  "objective": "Add a review phase that checks the technical plan for fragile assumptions, missing cases, and ambiguity before spec creation.",
+  "description": "Productize the user's plan-review prompt as a Quiver command and persisted review artifact.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "production-plan-review",
+    "branch_name": "feature/QUIVER-23-06-production-plan-review"
+  },
+  "files": [
+    "src/create-quiver/commands/ai.js",
+    "src/create-quiver/lib/ai/**",
+    "src/create-quiver/lib/**",
+    "docs/COMMANDS.md.template",
+    "tests/commands/*.test.js",
+    "tests/lib/*.test.js"
+  ],
+  "depends_on": [
+    "slice-05-planner-iteration-history"
+  ],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "Adds a new planner gate consumed by spec generation.",
+  "must": [
+    "Review technical-plan drafts before plan approval and spec generation.",
+    "Report fragile assumptions, uncovered cases, ambiguous criteria, risks, and recommended fixes.",
+    "Do not question approved scope.",
+    "Persist the review result.",
+    "Block spec creation if required review is missing when configured as mandatory."
+  ],
+  "not_included": [
+    "Implementing the plan.",
+    "Creating specs directly.",
+    "Changing provider API integration."
+  ],
+  "acceptance": [
+    "Dry-run prints review prompt metadata.",
+    "Review output is stored as a draft/review artifact.",
+    "The command never modifies product code.",
+    "Spec generation requires reviewed and approved plan state.",
+    "Tests cover missing plan, dry-run, provider failure, and persisted review."
+  ],
+  "tests": [
+    "node --test tests/commands/ai-plan*.test.js tests/lib/approvals.test.js",
+    "git diff --check"
+  ],
+  "estimated_hours": 8,
+  "status": "completed",
+  "completed_at": "2026-05-21",
+  "blocked_reason": null
+}

package/specs/quiver-v23-guided-flow-productization/slices/slice-07-spec-create-experience/CLOSURE_BRIEF.md

@@ -0,0 +1,33 @@
+# CLOSURE BRIEF - slice-07: Spec create experience
+
+## Resumen de lo realizado
+
+Se agrego `npx create-quiver spec create` como paso explicito para crear specs reales desde el plan tecnico revisado y aprobado. El comando soporta `--dry-run`, valida colisiones antes de escribir, crea todos los artefactos esperados y muestra los proximos comandos seguros.
+
+## Validacion contra criterios de aceptacion
+
+- [x] Inputs aprobados/revisados usados.
+- [x] Artefactos generados.
+- [x] `slice-00` generado.
+- [x] Tests pasan.
+
+## Cambios relevantes
+
+- Nuevo modulo `src/create-quiver/commands/spec.js`.
+- Nuevo subcomando `spec create`.
+- Nuevo script `quiver:spec:create` en paquetes generados.
+- `flow` ahora recomienda `spec create --dry-run` cuando el plan esta revisado y aprobado.
+- README, templates y docs generadas usan `spec create` como flujo principal.
+- Tests agregados en `tests/commands/spec-create.test.js`.
+
+## Pendientes
+
+- `ai plan --phase spec` sigue existiendo por compatibilidad; en la documentacion principal queda desplazado por `spec create`.
+
+## Riesgos remanentes
+
+- La UX todavia requiere que el usuario conozca o revise el numero de version aprobado del plan tecnico.
+
+## Recomendaciones futuras
+
+- En `slice-08`, usar el spec generado por `spec create` como fuente para prompts minimos de executor.

package/specs/quiver-v23-guided-flow-productization/slices/slice-07-spec-create-experience/EXECUTION_BRIEF.md

@@ -0,0 +1,30 @@
+# EXECUTION BRIEF - slice-07: Spec create experience
+
+## Objetivo
+
+Hacer que la creacion de specs sea un paso claro despues de plan revisado y aprobado.
+
+## Alcance
+
+- UX del comando.
+- Validaciones de inputs aprobados.
+- Generacion de artefactos.
+- Proximo paso sugerido.
+
+## Criterios de aceptacion
+
+- Bloquea si falta aprobacion/review.
+- Crea todos los artefactos esperados.
+- `slice-00` es obligatorio.
+- Tests pasan.
+
+## Restricciones
+
+- No ejecutar slices.
+- No abrir PR.
+
+## Checklist de finalizacion
+
+- [ ] Spec generation validado.
+- [ ] JSON validado.
+- [ ] Tests pasan.

package/specs/quiver-v23-guided-flow-productization/slices/slice-07-spec-create-experience/slice.json

@@ -0,0 +1,55 @@
+{
+  "slice_id": "slice-07-spec-create-experience",
+  "ticket": "QUIVER-23-07",
+  "type": "feature",
+  "title": "Spec creation experience from approved plans",
+  "objective": "Make spec generation feel like an explicit product step after reviewed approved plans.",
+  "description": "Add a higher-level spec create command or wrapper that consumes approved/reviewed inputs and creates spec artifacts predictably.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "spec-create-experience",
+    "branch_name": "feature/QUIVER-23-07-spec-create-experience"
+  },
+  "files": [
+    "src/create-quiver/commands/ai.js",
+    "src/create-quiver/commands/spec.js",
+    "src/create-quiver/lib/ai/spec-generator.js",
+    "src/create-quiver/lib/ai/spec-templates.js",
+    "docs/WORKFLOW.md.template",
+    "tests/commands/*.test.js",
+    "tests/lib/*.test.js"
+  ],
+  "depends_on": [
+    "slice-06-production-plan-review"
+  ],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "Touches spec generation and command routing.",
+  "must": [
+    "Consume approved and reviewed plan input by default.",
+    "Generate `SPEC.md`, `STATUS.md`, `EVIDENCE_REPORT.md`, `EXECUTION_PLAN.md`, `pr.md`, `slice-00`, and slice handoffs.",
+    "Fail safely if target spec exists.",
+    "Keep `slice-00` mandatory.",
+    "Print next commands after generation."
+  ],
+  "not_included": [
+    "Executing slices.",
+    "Opening PRs.",
+    "Delegating agents."
+  ],
+  "acceptance": [
+    "Spec creation blocks on missing approved/reviewed plan.",
+    "Generated spec includes mandatory slice-00.",
+    "Generated `pr.md` exists.",
+    "Generated JSON parses.",
+    "Next safe commands are printed."
+  ],
+  "tests": [
+    "node --test tests/commands/spec-create.test.js tests/commands/ai-plan-spec-phase.test.js tests/lib/ai-spec-generator.test.js",
+    "git diff --check"
+  ],
+  "estimated_hours": 7,
+  "status": "completed",
+  "completed_at": "2026-05-21",
+  "blocked_reason": null
+}

package/specs/quiver-v23-guided-flow-productization/slices/slice-08-executor-prompt-generation/CLOSURE_BRIEF.md

@@ -0,0 +1,32 @@
+# CLOSURE BRIEF - slice-08: Executor prompt generation
+
+## Resumen de lo realizado
+
+Se agrego `npx create-quiver ai prompt-slice` como comando de salida manual para asignar un slice a un agente executor con contexto minimo. El prompt se arma desde `slice.json`, `EXECUTION_BRIEF.md`, `CLOSURE_BRIEF.md` y un extracto breve de `SPEC.md`, sin incluir el spec completo por defecto.
+
+## Validacion contra criterios de aceptacion
+
+- [x] Prompt minimo.
+- [x] Sin SPEC completo por defecto.
+- [x] Formato final incluido.
+- [x] Tests pasan.
+
+## Cambios relevantes
+
+- Nuevo builder `buildManualExecutorPrompt` en `src/create-quiver/lib/ai/executor.js`.
+- Nuevo subcomando `ai prompt-slice`, con alias `ai executor-prompt`.
+- Nuevo script generado `quiver:ai:prompt-slice`.
+- README, `README_FOR_AI.md`, templates y docs generadas actualizadas con el flujo manual.
+- Tests de CLI y libreria para contexto minimo, path del slice y faltantes de briefs.
+
+## Pendientes
+
+Sin pendientes del slice.
+
+## Riesgos remanentes
+
+El prompt manual no ejecuta ni valida al proveedor; la calidad final sigue dependiendo del agente executor elegido por el usuario.
+
+## Recomendaciones futuras
+
+En `slice-09`, reutilizar este prompt como base de contexto para ejecucion delegada y mantener la salida manual como fallback de bajo riesgo.

package/specs/quiver-v23-guided-flow-productization/slices/slice-08-executor-prompt-generation/EXECUTION_BRIEF.md

@@ -0,0 +1,30 @@
+# EXECUTION BRIEF - slice-08: Executor prompt generation
+
+## Objetivo
+
+Generar prompts minimos para agentes ejecutores a partir de artefactos de un slice.
+
+## Alcance
+
+- Leer `slice.json`, `EXECUTION_BRIEF.md`, `CLOSURE_BRIEF.md`.
+- Incluir contexto minimo y restricciones.
+- Imprimir prompt listo para pegar.
+
+## Criterios de aceptacion
+
+- No incluye el SPEC completo por defecto.
+- Incluye archivos permitidos, criterios y validaciones.
+- Tiene formato de reporte final.
+- Tests pasan.
+
+## Restricciones
+
+- No ejecutar provider.
+- No ejecutar el prompt generado contra proveedores dentro de este slice.
+- Mantener la implementacion dentro de los archivos declarados en `slice.json`.
+
+## Checklist de finalizacion
+
+- [x] Prompt generado.
+- [x] Contexto minimizado.
+- [x] Tests pasan.

package/specs/quiver-v23-guided-flow-productization/slices/slice-08-executor-prompt-generation/slice.json

@@ -0,0 +1,55 @@
+{
+  "slice_id": "slice-08-executor-prompt-generation",
+  "ticket": "QUIVER-23-08",
+  "type": "feature",
+  "title": "Executor prompt generation for manual slice assignment",
+  "objective": "Generate minimal executor prompts from slice artifacts so users can assign slices without pasting long custom prompts.",
+  "description": "Productize the user's executor prompt as a generated, slice-specific prompt with minimal context and strict output contract.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "executor-prompt-generation",
+    "branch_name": "feature/QUIVER-23-08-executor-prompt-generation"
+  },
+  "files": [
+    "src/create-quiver/commands/ai.js",
+    "src/create-quiver/lib/ai/executor.js",
+    "src/create-quiver/lib/**",
+    "docs/AI_ONBOARDING_PROMPT.md.template",
+    "docs/COMMANDS.md.template",
+    "tests/commands/*.test.js",
+    "tests/lib/*.test.js"
+  ],
+  "depends_on": [
+    "slice-07-spec-create-experience"
+  ],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "Depends on final generated slice artifact shape.",
+  "must": [
+    "Generate a prompt for one slice from `slice.json`, `EXECUTION_BRIEF.md`, and `CLOSURE_BRIEF.md`.",
+    "Include minimal SPEC excerpts only when needed.",
+    "Include allowed files, restrictions, acceptance criteria, validation commands, and output format.",
+    "Support dry-run output to console.",
+    "Avoid exposing secrets or full repo context."
+  ],
+  "not_included": [
+    "Executing the provider.",
+    "Delegating multiple slices.",
+    "Opening PRs."
+  ],
+  "acceptance": [
+    "Prompt generation works for a valid slice path.",
+    "Missing brief files fail clearly.",
+    "Output does not include full SPEC by default.",
+    "Prompt includes final report format.",
+    "Tests cover minimal context and path handling."
+  ],
+  "tests": [
+    "node --test tests/commands/ai-execute-slice.test.js tests/lib/ai-executor.test.js",
+    "git diff --check"
+  ],
+  "estimated_hours": 6,
+  "status": "completed",
+  "completed_at": "2026-05-21",
+  "blocked_reason": null
+}

package/specs/quiver-v23-guided-flow-productization/slices/slice-09-delegated-slice-execution/CLOSURE_BRIEF.md

@@ -0,0 +1,33 @@
+# CLOSURE BRIEF - slice-09: Delegated slice execution
+
+## Resumen de lo realizado
+
+Se agrego ejecucion por modo para `ai execute-plan`: `auto` conserva la compatibilidad secuencial, `manual` imprime comandos `prompt-slice` sin ejecutar proveedores y `delegated` usa worktrees temporales para olas paralelas con scopes seguros. Las olas con conflictos o scope desconocido siguen cayendo a ejecucion secuencial.
+
+## Validacion contra criterios de aceptacion
+
+- [x] Modo manual/delegado.
+- [x] Paralelo seguro.
+- [x] Un commit por slice.
+- [x] Tests pasan.
+
+## Cambios relevantes
+
+- Nuevo flag `--mode <auto|manual|delegated>` para `ai execute-plan`.
+- Dry-run muestra comandos `ai prompt-slice` y, salvo en modo manual, comandos `ai execute-slice`.
+- Modo delegado crea worktrees temporales para grupos paralelos, ejecuta cada slice con `commit: true` e integra los commits con `cherry-pick` en orden estable.
+- Fallback secuencial cuando hay conflictos, scope desconocido o un solo slice.
+- Tests agregados para modo manual, modo delegado con worktrees temporales e integracion de commits.
+- README, `README_FOR_AI.md`, templates y docs generadas actualizadas con los modos.
+
+## Pendientes
+
+Sin pendientes del slice.
+
+## Riesgos remanentes
+
+Si falla un provider o un `cherry-pick`, Quiver deja los worktrees temporales para inspeccion y no intenta ocultar cambios. La recuperacion queda en manos del usuario para evitar borrar evidencia util.
+
+## Recomendaciones futuras
+
+En `slice-10`, cubrir el flujo completo con smokes finales y revisar que la documentacion principal no duplique rutas equivalentes.

package/specs/quiver-v23-guided-flow-productization/slices/slice-09-delegated-slice-execution/EXECUTION_BRIEF.md

@@ -0,0 +1,34 @@
+# EXECUTION BRIEF - slice-09: Delegated slice execution
+
+## Objetivo
+
+Permitir ejecucion delegada de slices con seguridad de scopes, workspaces y commits.
+
+## Alcance
+
+- Modo manual y delegado.
+- Uso de perfil executor.
+- Workspaces seguros para paralelismo.
+- Un commit por slice.
+- Reportes de fallo recuperables.
+
+## Criterios de aceptacion
+
+- Dry-run muestra olas.
+- Ejecucion real requiere flags explicitos.
+- Paralelo solo con scopes seguros.
+- Falla sin ocultar cambios.
+- Tests pasan.
+
+## Restricciones
+
+- No mergear PR.
+- No instalar proveedores.
+- No correr providers reales en CI.
+
+## Checklist de finalizacion
+
+- [x] Dry-run validado.
+- [x] Ejecucion con mocks validada.
+- [x] Fallos recuperables.
+- [x] Tests pasan.

package/specs/quiver-v23-guided-flow-productization/slices/slice-09-delegated-slice-execution/slice.json

@@ -0,0 +1,57 @@
+{
+  "slice_id": "slice-09-delegated-slice-execution",
+  "ticket": "QUIVER-23-09",
+  "type": "feature",
+  "title": "Delegated slice execution with safe workspaces",
+  "objective": "Support delegated slice execution while preserving one commit per slice and avoiding overlapping writes.",
+  "description": "Add a higher-level execution mode that can run or print safe delegated slice execution using executor profiles, waves, and isolated workspaces.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "delegated-slice-execution",
+    "branch_name": "feature/QUIVER-23-09-delegated-slice-execution"
+  },
+  "files": [
+    "src/create-quiver/commands/ai.js",
+    "src/create-quiver/lib/ai/execution-plan.js",
+    "src/create-quiver/lib/ai/executor.js",
+    "src/create-quiver/lib/spec-worktrees.js",
+    "src/create-quiver/lib/**",
+    "docs/WORKFLOW.md.template",
+    "tests/commands/*.test.js",
+    "tests/lib/*.test.js"
+  ],
+  "depends_on": [
+    "slice-08-executor-prompt-generation"
+  ],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "Highest-risk orchestration slice; must integrate after prompts, profiles, and flow state are stable.",
+  "must": [
+    "Support manual and delegated modes.",
+    "Use executor profile by default.",
+    "Preserve one commit per slice.",
+    "Fall back to sequential execution on conflicts or unknown scopes.",
+    "Use isolated workspaces for parallel execution.",
+    "Stop on validation failure without hiding local changes."
+  ],
+  "not_included": [
+    "Autonomous PR merge.",
+    "Silent provider installation.",
+    "Real provider calls in CI."
+  ],
+  "acceptance": [
+    "Dry-run prints execution waves and executor prompts/commands.",
+    "Real execution requires explicit flags and commit opt-in.",
+    "Parallel mode only runs when scopes are disjoint and workspaces are safe.",
+    "Each successful slice creates exactly one commit.",
+    "Failures report retry/abort guidance."
+  ],
+  "tests": [
+    "node --test tests/lib/ai-execution-plan.test.js tests/commands/ai-execute-plan.test.js tests/commands/ai-execute-slice.test.js",
+    "git diff --check"
+  ],
+  "estimated_hours": 12,
+  "status": "completed",
+  "completed_at": "2026-05-21",
+  "blocked_reason": null
+}

package/specs/quiver-v23-guided-flow-productization/slices/slice-10-docs-smokes-release-readiness/CLOSURE_BRIEF.md

@@ -0,0 +1,33 @@
+# CLOSURE BRIEF - slice-10: Final docs, smokes, and release readiness
+
+## Resumen de lo realizado
+
+Se cerro la productizacion del flujo guiado actualizando documentacion publica, fuente de verdad para IA, changelog, roadmap, backlog, templates generados, smokes y evidencia de release readiness. No se publico npm.
+
+## Validacion contra criterios de aceptacion
+
+- [x] Docs finales listas.
+- [x] Smokes listas.
+- [x] STATUS/EVIDENCE actualizados.
+- [x] No se publico npm.
+
+## Cambios relevantes
+
+- `README.md` presenta checklist de release y flujo guiado AI-first.
+- `README_FOR_AI.md` mantiene sincronizado el modo manual/delegated de `ai execute-plan`.
+- `CHANGELOG.md`, `ROADMAP.md` y `BACKLOG.md` reflejan v23 como completado y listo para el proximo release.
+- `scripts/ci/smoke-guided-workflow.sh` cubre flow, perfiles, onboarding, review-plan, spec create, executor prompt, delegated execution, PR, cleanup y package safety.
+- `scripts/ci/smoke-create-quiver.sh` valida los scripts generados nuevos.
+- `EVIDENCE_REPORT.md` registra smokes, pack dry-run y checklist de release.
+
+## Pendientes
+
+Sin pendientes del slice.
+
+## Riesgos remanentes
+
+El primer `npm pack --dry-run` fallo por permisos del cache global de npm del usuario; se valido correctamente repitiendo con `--cache /private/tmp/quiver-npm-cache`.
+
+## Recomendaciones futuras
+
+Antes de publicar, ejecutar el checklist del README y decidir el bump de version npm para incluir v22/v23.

package/specs/quiver-v23-guided-flow-productization/slices/slice-10-docs-smokes-release-readiness/EXECUTION_BRIEF.md

@@ -0,0 +1,32 @@
+# EXECUTION BRIEF - slice-10: Final docs, smokes, and release readiness
+
+## Objetivo
+
+Cerrar la feature con docs completas, pruebas y readiness de release sin publicar.
+
+## Alcance
+
+- README y guia IA.
+- Templates/docs generados.
+- Smoke tests.
+- STATUS/EVIDENCE_REPORT.
+- Checklist de release.
+
+## Criterios de aceptacion
+
+- Docs muestran el flujo como disponible.
+- Smokes cubren happy path y fallas principales.
+- Evidencia actualizada.
+- No se publica npm.
+
+## Restricciones
+
+- No publicar npm.
+- No abrir PR si no se pidio.
+
+## Checklist de finalizacion
+
+- [x] Docs finales actualizadas.
+- [x] Templates actualizados.
+- [x] Smokes agregados.
+- [x] Evidencia final registrada.

package/specs/quiver-v23-guided-flow-productization/slices/slice-10-docs-smokes-release-readiness/slice.json

@@ -0,0 +1,63 @@
+{
+  "slice_id": "slice-10-docs-smokes-release-readiness",
+  "ticket": "QUIVER-23-10",
+  "type": "docs-test",
+  "title": "Final docs, smokes, and release readiness",
+  "objective": "Finish the guided flow productization with updated docs, templates, smoke coverage, and release readiness evidence.",
+  "description": "Update public docs and generated project templates, add end-to-end smoke coverage, and confirm the feature is ready for release without publishing.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "guided-flow-release-readiness",
+    "branch_name": "feature/QUIVER-23-10-guided-flow-release-readiness"
+  },
+  "files": [
+    "README.md",
+    "README_FOR_AI.md",
+    "CHANGELOG.md",
+    "ROADMAP.md",
+    "BACKLOG.md",
+    "docs/*.template",
+    "src/create-quiver/lib/init-docs.js",
+    "src/create-quiver/lib/init-layout.js",
+    "scripts/ci/*.sh",
+    "specs/quiver-v23-guided-flow-productization/**"
+  ],
+  "depends_on": [
+    "slice-09-delegated-slice-execution"
+  ],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "Final docs and smokes must run after all behavior slices are complete.",
+  "must": [
+    "Document the finished guided flow in root docs.",
+    "Update generated project docs/templates where users see commands.",
+    "Add smoke coverage for the happy path and major failure paths.",
+    "Update STATUS and EVIDENCE_REPORT.",
+    "Run full relevant test suite.",
+    "Do not publish npm in this slice."
+  ],
+  "not_included": [
+    "Changing behavior after acceptance unless a blocking bug is found.",
+    "Publishing a release.",
+    "Merging PR."
+  ],
+  "acceptance": [
+    "README shows the guided flow as available behavior.",
+    "Generated docs mention flow status, agent profiles, review-plan, executor prompt generation, delegated execution, PR creation, and cleanup.",
+    "Smoke tests cover flow status, profiles, onboarding, iterations, review, spec create, executor prompt dry-run, delegated execution dry-run, PR dry-run, cleanup dry-run, and package safety.",
+    "STATUS and EVIDENCE_REPORT reflect completed slices.",
+    "Release checklist is ready but no npm publish is performed."
+  ],
+  "tests": [
+    "node --test tests/**/*.test.js",
+    "npm run smoke:create-quiver",
+    "npm run smoke:guided-workflow",
+    "npm run smoke:tiered-pack",
+    "npm pack --dry-run",
+    "git diff --check"
+  ],
+  "estimated_hours": 6,
+  "status": "completed",
+  "completed_at": "2026-05-21",
+  "blocked_reason": null
+}