create-quiver 0.10.0 → 0.12.0

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
+}

package/specs/quiver-v24-dx-onboarding-hardening/EVIDENCE_REPORT.md

@@ -0,0 +1,55 @@
+# Evidence Report - Quiver v24
+
+## Status
+
+All v24 slices are completed. Package publication is intentionally outside this spec.
+
+## Required Final Evidence
+
+- `git diff --check`
+- `node --test tests/**/*.test.js`
+- `npm run smoke:create-quiver`
+- `npm run smoke:guided-workflow`
+- `npm run smoke:tiered-pack`
+- `npm pack --dry-run`
+- Generated-project smoke covering `init`, `flow`, `prepare --dry-run`, `analyze`, `doctor`, `check-slice --local`, `plan --include-completed`, `graph --include-completed`, `ai prepare-context --dry-run`, `evidence run`, and `demo create spec-viewer --dry-run`
+
+## Evidence Log
+
+| Slice | Evidence | Result | Notes |
+|---|---|---|---|
+| slice-00 | `git diff --check` | Pass | No whitespace errors. |
+| slice-00 | `find specs/quiver-v24-dx-onboarding-hardening -name "slice.json" -print -exec node -e "JSON.parse(require('fs').readFileSync(process.argv[1], 'utf8'))" {} \;` | Pass | All 11 slice definitions parse. |
+| slice-00 | `node bin/create-quiver.js plan --spec quiver-v24-dx-onboarding-hardening` | Pass with observation | Shows 10 planned implementation slices and a critical path. Ticket values rendered as `-`; captured under `slice-06`. |
+| slice-00 | `node bin/create-quiver.js graph --spec quiver-v24-dx-onboarding-hardening` | Observed issue | Output included an unrelated v20 slice; captured under `slice-06` scope for spec-filter hardening. |
+| slice-01 | `node --test tests/lib/init-docs.test.js tests/lib/init-layout.test.js tests/commands/init-profiles.test.js` | Pass | 30 tests passed, covering `.gitignore`, package name, profile-aware index, and generated script command targets. |
+| slice-01 | `npm run smoke:create-quiver` | Pass | Generated-project smoke passed after aligning full-profile index expectations with actual generated extras. |
+| slice-02 | `node --test tests/commands/init-profiles.test.js tests/commands/doctor.test.js tests/commands/flow.test.js` | Pass | 29 tests passed, covering unsupported command routing, legacy `--name`, doctor script mismatch warnings, and flow regressions. |
+| slice-03 | `node --test tests/lib/doctor.test.js tests/commands/doctor.test.js tests/commands/prepare.test.js` | Pass | 15 tests passed, covering fix dry-run, idempotent fixes, local docs link warnings, and prepare regressions. |
+| slice-04 | `node --test tests/commands/prepare.test.js tests/commands/ai-onboard.test.js tests/lib/ai-context-packs.test.js tests/commands/doctor.test.js tests/lib/init-layout.test.js` | Pass | 32 tests passed, covering prepare wording, `ai prepare-context` dry-run/write mode, approved docs-only targets, generated scripts, and doctor support for the new AI command. |
+| slice-04 | `node bin/create-quiver.js ai prepare-context --dry-run` | Pass | Dry-run reported proposed docs, files considered, assumptions, risks, omitted paths, and uncertainty markers without writing files. |
+| slice-04 | `npm run smoke:create-quiver` | Pass | Generated-project smoke passed with `quiver:ai:prepare-context` in the script contract. |
+| slice-05 | `node --test tests/lib/check-slice.test.js tests/commands/flow.test.js` | Pass | 18 tests passed, covering `check-slice --local`, omitted-check reporting, missing-base guidance, explicit base branch, and flow regressions. |
+| slice-06 | `node --test tests/commands/plan.test.js tests/commands/graph.test.js tests/commands/next.test.js tests/lib/slice-graph.test.js` | Pass | 30 tests passed, covering `--include-completed`, spec filtering, JSON output, next history behavior, and ticket propagation. |
+| slice-06 | `node bin/create-quiver.js plan --spec quiver-v24-dx-onboarding-hardening --include-completed` | Pass | Plan history view shows completed v24 slices and preserves `QUIVER-24-*` ticket values. |
+| slice-06 | `node bin/create-quiver.js graph --spec quiver-v24-dx-onboarding-hardening --include-completed` | Pass | Graph history view is restricted to v24 and no longer leaks unrelated specs. |
+| slice-06 | `node bin/create-quiver.js next --spec quiver-v24-dx-onboarding-hardening --include-completed` | Pass | Next output keeps an actionable planned slice and appends completed history separately. |
+| slice-07 | `node --test tests/commands/analyze.test.js tests/lib/project-scan.test.js` | Pass | 6 tests passed, covering plain Node/JavaScript analysis, language dedupe, useful script surfacing, and scan artifact helpers. |
+| slice-08 | `node --test tests/commands/evidence.test.js tests/lib/evidence.test.js` | Pass | 9 tests passed, covering success/failure exit codes, output truncation, default paths, output path display, and secret redaction across command/stdout/stderr. |
+| slice-08 | `node --test tests/lib/init-layout.test.js tests/commands/doctor.test.js tests/lib/quiver-internal-layout.test.js tests/lib/doctor.test.js` | Pass | 22 tests passed, covering supported script surfacing, `.quiver/.gitignore` evidence defaults, and doctor regression coverage. |
+| slice-08 | `node --test tests/commands/init-profiles.test.js tests/lib/init-docs.test.js tests/lib/doctor.test.js tests/commands/prepare.test.js` | Pass | 30 tests passed, covering generated init profiles, docs initialization, doctor layout checks, and prepare regressions. |
+| slice-08 | `node bin/create-quiver.js evidence run --output /private/tmp/quiver-v24-slice08-evidence.md --max-output 200 -- node --version` | Pass | Smoke verified direct command execution, exit code preservation, and explicit output path display. |
+| slice-08 | `npm run smoke:create-quiver` | Pass | Generated package smoke passed after adding `quiver:evidence` to generated scripts. |
+| slice-09 | `node --test tests/commands/demo.test.js tests/lib/package-safety.test.js` | Pass | 9 tests passed, covering dry-run, default nested target, real scaffold, file preservation, unsupported demo errors, and package safety for local demo output. |
+| slice-09 | `node bin/create-quiver.js demo create spec-viewer --dir /private/tmp/quiver-spec-viewer-smoke --dry-run` | Pass | Dry-run listed 17 files and wrote nothing. |
+| slice-09 | `node bin/create-quiver.js demo create spec-viewer --dir /private/tmp/quiver-spec-viewer-smoke-real` | Pass | Created static demo app, spec/slices, handoffs, PR body, and validation script. |
+| slice-09 | `npm run validate` from `/private/tmp/quiver-spec-viewer-smoke-real` | Pass | Generated demo validation passed. |
+| slice-09 | `npm run smoke:create-quiver` | Pass | Smoke now covers demo dry-run, real scaffold, demo validation, and evidence capture from the generated demo. |
+| slice-10 | `git diff --check` | Pass | No whitespace errors. |
+| slice-10 | `node --test tests/**/*.test.js` | Pass | 255 tests passed. |
+| slice-10 | `npm pack --dry-run` | Local environment issue | Default npm cache had root-owned files under `~/.npm`; not a package failure. Re-ran with isolated cache. |
+| slice-10 | `npm --cache /private/tmp/quiver-npm-cache pack --dry-run` | Pass | npm dry-run generated `create-quiver-0.10.0.tgz` with 401 files. |
+| slice-10 | `npm run smoke:create-quiver` | Pass | Generated-project smoke passed, including v24 demo/evidence paths. |
+| slice-10 | `npm run smoke:guided-workflow` | Pass | Guided workflow smoke and package smoke passed. |
+| slice-10 | `npm run smoke:tiered-pack` | Pass | Tiered context smoke passed after updating expected doctor link warnings. |
+| slice-10 | `npm run package:quiver` | Pass | Package safety smoke passed for `create-quiver-0.10.0.tgz`. |

package/specs/quiver-v24-dx-onboarding-hardening/EXECUTION_PLAN.md

@@ -0,0 +1,43 @@
+# Execution Plan - Quiver v24
+
+## Wave 0 - Required Foundation
+
+1. `slice-00-spec-foundation`
+   - Must land before implementation.
+   - Publishes spec, slices, handoffs, execution plan, PR body, and source-of-truth sync.
+
+## Wave 1 - Low-Level Contract Fixes
+
+These can run after `slice-00` and can be parallel if write scopes stay separate:
+
+1. `slice-01-init-template-hygiene`
+2. `slice-02-cli-command-routing-version-errors`
+3. `slice-07-analyzer-command-map-hardening`
+
+## Wave 2 - Validation and Context Commands
+
+These depend on Wave 1 contracts:
+
+1. `slice-03-doctor-fix-doc-link-checks`
+2. `slice-04-prepare-output-ai-context-drafts`
+3. `slice-05-local-slice-validation-base-guidance`
+
+## Wave 3 - Planning History and Evidence
+
+1. `slice-06-plan-graph-next-history-views`
+2. `slice-08-evidence-run-command`
+
+## Wave 4 - Demo Experience
+
+1. `slice-09-spec-viewer-demo-scaffolding`
+
+## Wave 5 - Release Readiness
+
+1. `slice-10-docs-smokes-release-readiness`
+
+## Parallel Safety Notes
+
+- Do not run two slices in parallel if both modify `src/create-quiver/index.js`.
+- Prefer one commit per slice.
+- Run `node --test` for touched command/lib areas before marking a slice complete.
+- Run package safety and smoke tests only in the final slice unless an earlier slice changes packaging behavior.