create-quiver 0.5.0 → 0.7.0

package/specs/quiver-v14-tiered-context-pack/STATUS.md

@@ -0,0 +1,35 @@
+# Quiver v0.14 Spec Status
+
+**Spec:** quiver-v14-tiered-context-pack
+**Last updated:** 2026-04-23
+
+Slice numbering is local to this spec. The first slice is `slice-01`.
+
+## Status
+
+| Slice | Title | Status | PR | Estimated hours | Actual hours |
+|-------|-------|--------|----|-----------------|--------------|
+| slice-01 | Tiered Context Pack | Completed | - | 4 | 4 |
+| slice-02 | AGENTS.md Router | Completed | #38 | 3 | 3 |
+| slice-03 | Active Slice Lifecycle | Completed | - | 4 | 4 |
+| slice-04 | Dedup and Front-Matter | Completed | - | 4 | 5 |
+| slice-05 | Doctor and Smokes for Tiered Pack | Completed | - | 4 | 5 |
+
+## Progress
+
+- Completed slices: 5 / 5
+- Estimated hours: 23
+- Actual hours: 21
+
+## Blockers
+
+| Slice | Blocker | Since | Action needed |
+|-------|---------|-------|---------------|
+| - | - | - | - |
+
+## Dependencies
+
+- slice-02 depends on slice-01 (AGENTS.md routes to the tiers created in slice-01)
+- slice-03 depends on slice-02 (ACTIVE_SLICE is referenced from AGENTS.md)
+- slice-04 depends on slice-01 (front-matter is applied to the tiered files)
+- slice-05 depends on slices 01-04 (validates the full pack)

package/specs/quiver-v14-tiered-context-pack/slices/slice-01-tiered-context-pack/slice.json

@@ -0,0 +1,77 @@
+{
+  "slice_id": "slice-01-tiered-context-pack",
+  "ticket": "QUIVER-01",
+  "type": "feat",
+  "title": "Tiered Context Pack (QUICK, STANDARD, DEEP)",
+  "objective": "Generate a three-tier AI context pack so execution models load a minimal QUICK brief, default tasks load a bounded STANDARD brief, and planning models can opt into unbounded DEEP context on demand.",
+  "description": "Today the generated AI context is flat: agents that only need to act on an active slice still load several hundred lines of project-wide documentation. This slice introduces three bounded tiers under `docs/ai/` with distinct purposes and generation rules, distributing content that currently lives in AI_CONTEXT.md, CONTEXTO.md, and WORKFLOW.md without losing information. The tiers are additive: QUICK is the minimum viable briefing, STANDARD is the default, DEEP is the archive.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "tiered-context-pack",
+    "branch_name": "feature/QUIVER-01-tiered-context-pack"
+  },
+  "must": [
+    "Create `docs/QUICK.md.template` with a 50-line upper bound covering stack, primary commands, hard rules, and pointer to STANDARD/DEEP",
+    "Create `docs/STANDARD.md.template` with a 300-line upper bound covering conventions, workflow overview, testing expectations, and v13 mode guidance",
+    "Create `docs/DEEP.md.template` without a line bound, intended for project history, decisions, and cultural context",
+    "Update `src/create-quiver/lib/init-docs.js` to render the three tier templates into `docs/ai/QUICK.md`, `docs/ai/STANDARD.md`, and `docs/ai/DEEP.md` on init and on migrate",
+    "Populate QUICK with deterministic content from the existing analyzer scan (stack, package manager, primary commands, slice workflow commands)",
+    "Reference the tiers explicitly from `docs/INDEX.md.template` so the project index lists them"
+  ],
+  "not_included": [
+    "Creating AGENTS.md (handled in slice-02)",
+    "Generating ACTIVE_SLICE.md (handled in slice-03)",
+    "Adding YAML front-matter (handled in slice-04)",
+    "Doctor warnings for tier size (handled in slice-05)",
+    "Deleting AI_CONTEXT.md, CONTEXTO.md, or WORKFLOW.md"
+  ],
+  "acceptance": [
+    "A freshly initialized project contains `docs/ai/QUICK.md`, `docs/ai/STANDARD.md`, and `docs/ai/DEEP.md`",
+    "QUICK.md has 50 or fewer non-empty content lines",
+    "STANDARD.md has 300 or fewer non-empty content lines",
+    "QUICK.md includes at least: project name, detected stack, primary install/dev/test commands, slice start command, and a pointer line to STANDARD.md and DEEP.md",
+    "Running `migrate` on a project generated before v14 creates the three tier files without overwriting existing content",
+    "`docs/INDEX.md` links to all three tier files"
+  ],
+  "files": [
+    "docs/QUICK.md.template",
+    "docs/STANDARD.md.template",
+    "docs/DEEP.md.template",
+    "docs/INDEX.md.template",
+    "src/create-quiver/lib/init-docs.js",
+    "scripts/init-docs.sh",
+    "specs/quiver-v14-tiered-context-pack/SPEC.md",
+    "specs/quiver-v14-tiered-context-pack/STATUS.md",
+    "specs/quiver-v14-tiered-context-pack/EVIDENCE_REPORT.md",
+    "specs/quiver-v14-tiered-context-pack/slices/slice-01-tiered-context-pack/slice.json"
+  ],
+  "tests": [
+    "node bin/create-quiver.js --name \"Scratch\" --dir /tmp/quiver-v14-slice-01-smoke",
+    "test -f /tmp/quiver-v14-slice-01-smoke/docs/ai/QUICK.md",
+    "test -f /tmp/quiver-v14-slice-01-smoke/docs/ai/STANDARD.md",
+    "test -f /tmp/quiver-v14-slice-01-smoke/docs/ai/DEEP.md",
+    "awk 'NF' /tmp/quiver-v14-slice-01-smoke/docs/ai/QUICK.md | wc -l | awk '{ if ($1 > 50) exit 1 }'",
+    "awk 'NF' /tmp/quiver-v14-slice-01-smoke/docs/ai/STANDARD.md | wc -l | awk '{ if ($1 > 300) exit 1 }'",
+    "git diff --check"
+  ],
+  "documentation": [
+    "docs/QUICK.md.template",
+    "docs/STANDARD.md.template",
+    "docs/DEEP.md.template",
+    "docs/INDEX.md.template"
+  ],
+  "dependencies": [],
+  "assumptions": [
+    "Three tiers are sufficient granularity; no project needs a fourth level",
+    "A 50-line cap on QUICK is tight enough to force selection and loose enough to stay useful",
+    "Execution models benefit more from a short, deterministic briefing than from a rich but long one"
+  ],
+  "estimated_hours": 4,
+  "actual_hours": 4,
+  "status": "completed",
+  "blocked_reason": null,
+  "ready_at": null,
+  "started_at": null,
+  "completed_at": "2026-04-23"
+}

package/specs/quiver-v14-tiered-context-pack/slices/slice-02-agents-md-router/slice.json

@@ -0,0 +1,74 @@
+{
+  "slice_id": "slice-02-agents-md-router",
+  "ticket": "QUIVER-02",
+  "type": "feat",
+  "title": "AGENTS.md Router",
+  "objective": "Generate a single root `AGENTS.md` that tells any AI agent which tier to load, how many tokens to spend, and how to respond concisely.",
+  "description": "AGENTS.md is the universal entry point that Claude Code, Cursor, Aider, Continue, and other agent runtimes discover automatically. This slice adds a template for it and wires init-docs and migrate to render it at the project root. The content is deliberately narrow: it declares a reading budget per task mode, points to QUICK.md first, and sets an output policy that discourages restating tasks and summarizing diffs.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "agents-md-router",
+    "branch_name": "feature/QUIVER-02-agents-md-router"
+  },
+  "must": [
+    "Create `AGENTS.md.template` at repository root with sections: Purpose, Reading Budget, Reading Order, Output Policy, Slice Execution Rules, and Links",
+    "Reading Budget section declares explicit per-mode budgets: planning up to 10000 tokens, execution under 2000 tokens before first action, debug under 1000 tokens before proposing a hypothesis",
+    "Reading Order section instructs agents to read QUICK first, STANDARD only if QUICK is insufficient, DEEP only when history or past decisions are requested",
+    "Output Policy section forbids restating the task before acting, forbids post-edit summaries of diffs, and caps confirmations at one sentence",
+    "Slice Execution Rules section instructs agents to treat `docs/ai/ACTIVE_SLICE.md` as the single source of truth when it exists and to avoid reading SPEC.md unless ACTIVE_SLICE.md references it",
+    "Update `src/create-quiver/lib/init-docs.js` and `scripts/init-docs.sh` to render AGENTS.md on init and on migrate, preserving existing AGENTS.md if the project already has one"
+  ],
+  "not_included": [
+    "Generating model-specific adapters (CLAUDE.md, .cursorrules, copilot-instructions.md)",
+    "Any runtime enforcement of the reading budget",
+    "Deleting existing AI guidance files"
+  ],
+  "acceptance": [
+    "A freshly initialized project contains `AGENTS.md` at the repository root",
+    "AGENTS.md contains all six required sections named verbatim",
+    "Reading Budget section contains explicit numeric budgets for planning, execution, and debug",
+    "Reading Order section names QUICK, STANDARD, and DEEP in that order",
+    "Output Policy section contains at minimum: no task restatement, no post-edit diff summary, one-sentence confirmation",
+    "Migrating a project that already has `AGENTS.md` preserves the existing content and logs a skip message"
+  ],
+  "files": [
+    "AGENTS.md.template",
+    "src/create-quiver/lib/init-docs.js",
+    "scripts/init-docs.sh",
+    "specs/quiver-v14-tiered-context-pack/SPEC.md",
+    "specs/quiver-v14-tiered-context-pack/STATUS.md",
+    "specs/quiver-v14-tiered-context-pack/EVIDENCE_REPORT.md",
+    "specs/quiver-v14-tiered-context-pack/slices/slice-02-agents-md-router/slice.json"
+  ],
+  "tests": [
+    "node bin/create-quiver.js --name \"Scratch\" --dir /tmp/quiver-v14-slice-02-smoke",
+    "test -f /tmp/quiver-v14-slice-02-smoke/AGENTS.md",
+    "grep -q '^## Reading Budget' /tmp/quiver-v14-slice-02-smoke/AGENTS.md",
+    "grep -q '^## Reading Order' /tmp/quiver-v14-slice-02-smoke/AGENTS.md",
+    "grep -q '^## Output Policy' /tmp/quiver-v14-slice-02-smoke/AGENTS.md",
+    "grep -q '^## Slice Execution Rules' /tmp/quiver-v14-slice-02-smoke/AGENTS.md",
+    "grep -q 'QUICK' /tmp/quiver-v14-slice-02-smoke/AGENTS.md",
+    "git diff --check"
+  ],
+  "documentation": [
+    "AGENTS.md.template",
+    "README.md",
+    "README_FOR_AI.md"
+  ],
+  "dependencies": [
+    "slice-01-tiered-context-pack"
+  ],
+  "assumptions": [
+    "AGENTS.md is discoverable by Claude Code, Cursor, Aider, and Continue without additional configuration",
+    "A single router is better than multiple model-specific adapters until a user asks for one",
+    "Agents respect explicit numeric budgets better than vague guidance"
+  ],
+  "estimated_hours": 3,
+  "actual_hours": null,
+  "status": "completed",
+  "blocked_reason": null,
+  "ready_at": null,
+  "started_at": "2026-04-23",
+  "completed_at": "2026-04-23"
+}

package/specs/quiver-v14-tiered-context-pack/slices/slice-03-active-slice-lifecycle/slice.json

@@ -0,0 +1,74 @@
+{
+  "slice_id": "slice-03-active-slice-lifecycle",
+  "ticket": "QUIVER-03",
+  "type": "feat",
+  "title": "Active Slice Lifecycle (ACTIVE_SLICE.md)",
+  "objective": "Generate `docs/ai/ACTIVE_SLICE.md` on `start-slice` so execution agents get a self-contained slice brief, and remove it on `cleanup-slice` so the signal stays accurate.",
+  "description": "Execution models currently waste tokens navigating SPEC.md, STATUS.md, and WORKFLOW.md even when the information they need fits in 30 lines of one file. This slice introduces an auto-generated active slice brief that is the single source of truth for execution while a slice is in progress. The file is ephemeral by design: it is born with `start-slice` and dies with `cleanup-slice`, so its presence is a reliable signal that a slice is active.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "active-slice-lifecycle",
+    "branch_name": "feature/QUIVER-03-active-slice-lifecycle"
+  },
+  "must": [
+    "Update `src/create-quiver/lib/lifecycle.js` so `startSlice` writes `docs/ai/ACTIVE_SLICE.md` after the worktree and branch are created",
+    "`ACTIVE_SLICE.md` content is rendered from the slice.json being started and contains, in order: slice id, title, objective (one line), `allowed_files` list, validation commands from `tests`, Definition of Done checklist derived from `acceptance`, and an explicit prohibition line against editing files outside `allowed_files`",
+    "Update `src/create-quiver/lib/lifecycle.js` so `cleanupSlice` removes `docs/ai/ACTIVE_SLICE.md` when cleanup succeeds",
+    "Update `scripts/start-slice.sh` and `scripts/cleanup-slice.sh` to call the Node lifecycle entrypoint so legacy Bash users get the same behavior",
+    "Record `ACTIVE_SLICE.md` path in `WORKTREE_CONTEXT.md` so developers see the link when they attach to a worktree"
+  ],
+  "not_included": [
+    "Enforcing `allowed_files` at commit time (out of scope for v14)",
+    "Front-matter on ACTIVE_SLICE.md (handled in slice-04)",
+    "Doctor warnings for orphaned ACTIVE_SLICE.md (handled in slice-05)",
+    "Changing the slice.json schema"
+  ],
+  "acceptance": [
+    "Running `start-slice` on a valid slice.json creates `docs/ai/ACTIVE_SLICE.md`",
+    "The file contains the slice id, the title, a one-line objective, the `allowed_files` list, the validation commands, the DoD checklist, and the prohibition line",
+    "Running `cleanup-slice` on the same slice removes `docs/ai/ACTIVE_SLICE.md`",
+    "Running `cleanup-slice` when `ACTIVE_SLICE.md` is already missing succeeds without error",
+    "Running `start-slice` when `ACTIVE_SLICE.md` exists from a previous slice overwrites it and logs a replacement message",
+    "`WORKTREE_CONTEXT.md` generated by `start-slice` references `docs/ai/ACTIVE_SLICE.md`"
+  ],
+  "files": [
+    "src/create-quiver/lib/lifecycle.js",
+    "src/create-quiver/lib/slice.js",
+    "scripts/start-slice.sh",
+    "scripts/cleanup-slice.sh",
+    "specs/quiver-v14-tiered-context-pack/SPEC.md",
+    "specs/quiver-v14-tiered-context-pack/STATUS.md",
+    "specs/quiver-v14-tiered-context-pack/EVIDENCE_REPORT.md",
+    "specs/quiver-v14-tiered-context-pack/slices/slice-03-active-slice-lifecycle/slice.json"
+  ],
+  "tests": [
+    "node bin/create-quiver.js --name \"Scratch\" --dir /tmp/quiver-v14-slice-03-smoke",
+    "node bin/create-quiver.js start-slice --dir /tmp/quiver-v14-slice-03-smoke /tmp/quiver-v14-slice-03-smoke/specs/scratch/slices/slice-template/slice.json --allow-draft",
+    "test -f /tmp/quiver-v14-slice-03-smoke/docs/ai/ACTIVE_SLICE.md",
+    "grep -q 'allowed_files' /tmp/quiver-v14-slice-03-smoke/docs/ai/ACTIVE_SLICE.md",
+    "grep -q 'Definition of Done' /tmp/quiver-v14-slice-03-smoke/docs/ai/ACTIVE_SLICE.md",
+    "node bin/create-quiver.js cleanup-slice --dir /tmp/quiver-v14-slice-03-smoke /tmp/quiver-v14-slice-03-smoke/specs/scratch/slices/slice-template/slice.json --discard",
+    "test ! -f /tmp/quiver-v14-slice-03-smoke/docs/ai/ACTIVE_SLICE.md",
+    "git diff --check"
+  ],
+  "documentation": [
+    "docs/WORKFLOW.md.template",
+    "README_FOR_AI.md"
+  ],
+  "dependencies": [
+    "slice-02-agents-md-router"
+  ],
+  "assumptions": [
+    "A single active slice file per project is sufficient; parallel worktrees can read from their own working tree copy",
+    "Overwriting an existing ACTIVE_SLICE.md is safer than refusing to start, because the previous slice should have been cleaned up first",
+    "A short, deterministic file is more reliable than asking agents to synthesize the same information from SPEC.md"
+  ],
+  "estimated_hours": 4,
+  "actual_hours": null,
+  "status": "completed",
+  "blocked_reason": null,
+  "ready_at": null,
+  "started_at": "2026-04-23",
+  "completed_at": "2026-04-23"
+}

package/specs/quiver-v14-tiered-context-pack/slices/slice-04-dedup-frontmatter/slice.json

@@ -0,0 +1,83 @@
+{
+  "slice_id": "slice-04-dedup-frontmatter",
+  "ticket": "QUIVER-04",
+  "type": "feat",
+  "title": "Deduplication and YAML Front-Matter",
+  "objective": "Add structured YAML front-matter to every generated context file and remove duplication so `PROJECT_MAP.md` is the single source of truth for stack and commands.",
+  "description": "Today stack information, commands, and package manager details are repeated across AI_CONTEXT, CONTEXTO, PROJECT_MAP, STATUS, and WORKFLOW. Agents that load more than one file pay the token cost twice. This slice collapses duplication by making PROJECT_MAP.md authoritative and having other files link to it, and adds a YAML front-matter header on every file in `docs/ai/` so agents can skip irrelevant files without reading the body.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "dedup-frontmatter",
+    "branch_name": "feature/QUIVER-04-dedup-frontmatter"
+  },
+  "must": [
+    "Every file rendered into `docs/ai/` (QUICK.md, STANDARD.md, DEEP.md, ACTIVE_SLICE.md, PRINCIPLES.md, RULES.yaml skipped, LESSONS.md) starts with a YAML front-matter block containing: `purpose`, `applies_when`, `token_cost` (integer heuristic using 4 chars per token), `last_updated` (YYYY-MM-DD), `supersedes` (path or null)",
+    "AI_CONTEXT.md.template no longer restates stack, package manager, or command tables; it links to `docs/PROJECT_MAP.md` for that information",
+    "CONTEXTO.md.template becomes a thin summary that links to AI_CONTEXT.md; existing CONTEXTO.md files in already-generated projects are preserved during migrate",
+    "STATUS.md.template stops restating stack or commands; it references PROJECT_MAP.md when needed",
+    "Implement a `writeFrontMatter(targetPath, fields)` helper in `src/create-quiver/lib/init-docs.js` that prepends or updates front-matter idempotently without duplicating the block",
+    "`supersedes` is populated with the path of the deprecated file when a file replaces another (for example CONTEXTO.md supersedes nothing, but AI_CONTEXT.md stops restating PROJECT_MAP and documents that in a comment)"
+  ],
+  "not_included": [
+    "Deleting AI_CONTEXT.md, CONTEXTO.md, or STATUS.md",
+    "Enforcing front-matter outside `docs/ai/`",
+    "Tokenizer-accurate token counting; the 4 chars per token heuristic is sufficient",
+    "Doctor warnings for missing front-matter (handled in slice-05)"
+  ],
+  "acceptance": [
+    "A freshly initialized project has YAML front-matter on every file directly under `docs/ai/` that is a Markdown file",
+    "Each front-matter block contains `purpose`, `applies_when`, `token_cost`, `last_updated`, `supersedes`",
+    "`grep -c 'Package manager' docs/PROJECT_MAP.md` returns at least 1 and no other generated file under `docs/` contains the phrase `Package manager:` as a content line",
+    "AI_CONTEXT.md contains a link to `docs/PROJECT_MAP.md`",
+    "Running init twice on the same directory does not produce duplicated front-matter blocks",
+    "Migrating a project generated before v14 adds front-matter to existing `docs/ai/` files idempotently"
+  ],
+  "files": [
+    "docs/AI_CONTEXT.md.template",
+    "docs/CONTEXTO.md.template",
+    "docs/STATUS.md.template",
+    "docs/QUICK.md.template",
+    "docs/STANDARD.md.template",
+    "docs/DEEP.md.template",
+    "src/create-quiver/lib/init-docs.js",
+    "scripts/init-docs.sh",
+    "specs/quiver-v14-tiered-context-pack/SPEC.md",
+    "specs/quiver-v14-tiered-context-pack/STATUS.md",
+    "specs/quiver-v14-tiered-context-pack/EVIDENCE_REPORT.md",
+    "specs/quiver-v14-tiered-context-pack/slices/slice-04-dedup-frontmatter/slice.json"
+  ],
+  "tests": [
+    "node bin/create-quiver.js --name \"Scratch\" --dir /tmp/quiver-v14-slice-04-smoke",
+    "head -n 1 /tmp/quiver-v14-slice-04-smoke/docs/ai/QUICK.md | grep -q '^---$'",
+    "head -n 1 /tmp/quiver-v14-slice-04-smoke/docs/ai/STANDARD.md | grep -q '^---$'",
+    "head -n 1 /tmp/quiver-v14-slice-04-smoke/docs/ai/DEEP.md | grep -q '^---$'",
+    "grep -q 'purpose:' /tmp/quiver-v14-slice-04-smoke/docs/ai/QUICK.md",
+    "grep -q 'applies_when:' /tmp/quiver-v14-slice-04-smoke/docs/ai/QUICK.md",
+    "grep -q 'token_cost:' /tmp/quiver-v14-slice-04-smoke/docs/ai/QUICK.md",
+    "node bin/create-quiver.js --name \"Scratch\" --dir /tmp/quiver-v14-slice-04-smoke -y",
+    "test \"$(grep -c '^purpose:' /tmp/quiver-v14-slice-04-smoke/docs/ai/QUICK.md)\" = \"1\"",
+    "test \"$(grep -r 'Package manager:' /tmp/quiver-v14-slice-04-smoke/docs | wc -l | tr -d ' ')\" = \"1\"",
+    "git diff --check"
+  ],
+  "documentation": [
+    "docs/AI_CONTEXT.md.template",
+    "docs/CONTEXTO.md.template",
+    "README_FOR_AI.md"
+  ],
+  "dependencies": [
+    "slice-01-tiered-context-pack"
+  ],
+  "assumptions": [
+    "A 4 chars per token heuristic is accurate enough for budget decisions; exact tokenization is not needed",
+    "Idempotent front-matter is preferable to regenerating the whole file, since users may edit the body",
+    "Linking between generated files is acceptable; agents handle Markdown links well"
+  ],
+  "estimated_hours": 4,
+  "actual_hours": 5,
+  "status": "completed",
+  "blocked_reason": null,
+  "ready_at": null,
+  "started_at": "2026-04-23",
+  "completed_at": "2026-04-23"
+}

package/specs/quiver-v14-tiered-context-pack/slices/slice-05-doctor-smokes-tiered-pack/slice.json

@@ -0,0 +1,84 @@
+{
+  "slice_id": "slice-05-doctor-smokes-tiered-pack",
+  "ticket": "QUIVER-05",
+  "type": "test",
+  "title": "Doctor and Smokes for Tiered Pack",
+  "objective": "Teach `doctor` to warn when the tiered pack drifts out of contract, and add CI smokes that cover the pack, AGENTS.md, ACTIVE_SLICE lifecycle, and deduplication.",
+  "description": "Slices 01-04 introduce new artifacts. Without validation, those artifacts silently decay: QUICK grows past 50 lines, front-matter fields disappear, ACTIVE_SLICE is left orphaned after cleanup, or stack duplication creeps back in. This slice adds lightweight checks in `doctor` and cross-platform smokes in CI so the contract stays enforced. This slice also absorbs the doctor and smoke assertions originally planned for v13 slice-04, which was removed during reconciliation.",
+  "git": {
+    "branch_type": "test",
+    "base_branch": "main",
+    "branch_slug": "doctor-smokes-tiered-pack",
+    "branch_name": "test/QUIVER-05-doctor-smokes-tiered-pack"
+  },
+  "must": [
+    "Extend `src/create-quiver/lib/doctor.js` (or the doctor logic in `src/create-quiver/index.js`) to print warnings when: QUICK.md exceeds 50 non-empty lines, STANDARD.md exceeds 300 non-empty lines, AGENTS.md is missing any of the six required sections, any file in `docs/ai/` is missing front-matter, `ACTIVE_SLICE.md` exists without any active worktree, or stack information appears in more than one generated file",
+    "Warnings are non-fatal: doctor still exits 0 when only warnings are present, and exits non-zero only for existing hard failures",
+    "Add a smoke script `scripts/ci/smoke-tiered-pack.sh` that: creates a scratch project, verifies tier files exist and meet size bounds, verifies AGENTS.md sections, runs start-slice and checks ACTIVE_SLICE.md, runs cleanup-slice and checks ACTIVE_SLICE.md is gone, and greps for duplicated stack info",
+    "Wire `scripts/ci/smoke-tiered-pack.sh` into the existing `smoke:create-quiver` package script or add a sibling `smoke:tiered-pack` script",
+    "Update `.github/workflows/ci.yml` so the new smoke runs on macOS, Linux, and Windows matrix entries",
+    "Smoke asserts that docs/DECISIONS.md exists in a freshly generated project",
+    "Smoke asserts that docs/PROJECT_MAP.md contains a Suggested Reading Order section",
+    "Smoke asserts that generated guidance names all four AI modes (onboarding, implementation, review, debug)",
+    "Update specs/[project-name]/EVIDENCE_REPORT.md.template guidance to prefer summarized command evidence (command, exit code, first relevant error, stacktrace, log path) over pasted long logs"
+  ],
+  "not_included": [
+    "New diagnostic commands (token-cost, diff-pack are deferred to v15)",
+    "Blocking doctor on warnings (they stay informational)",
+    "Replacing existing smokes"
+  ],
+  "acceptance": [
+    "Running `doctor` on a healthy v14-generated project prints zero warnings and exits 0",
+    "Running `doctor` on a project where QUICK.md has 60 non-empty lines prints a warning mentioning the 50-line budget",
+    "Running `doctor` on a project where AGENTS.md is missing the Reading Budget section prints a warning naming that section",
+    "Running `doctor` on a project where `docs/ai/STANDARD.md` has no front-matter prints a warning for that file",
+    "`smoke-tiered-pack.sh` exits 0 against a freshly generated project and non-zero when any check fails",
+    "CI matrix entries for macOS, Linux, and Windows execute the new smoke",
+    "Smoke fails if DECISIONS.md is missing after init",
+    "Smoke fails if PROJECT_MAP.md is missing the Suggested Reading Order section",
+    "Smoke fails if any of the four mode names is missing from generated guidance",
+    "Generated EVIDENCE_REPORT.md.template prefers summarized command evidence over long logs"
+  ],
+  "files": [
+    "src/create-quiver/lib/doctor.js",
+    "src/create-quiver/index.js",
+    "scripts/ci/smoke-tiered-pack.sh",
+    "package.json",
+    ".github/workflows/ci.yml",
+    "specs/[project-name]/EVIDENCE_REPORT.md.template",
+    "specs/quiver-v14-tiered-context-pack/SPEC.md",
+    "specs/quiver-v14-tiered-context-pack/STATUS.md",
+    "specs/quiver-v14-tiered-context-pack/EVIDENCE_REPORT.md",
+    "specs/quiver-v14-tiered-context-pack/slices/slice-05-doctor-smokes-tiered-pack/slice.json"
+  ],
+  "tests": [
+    "node bin/create-quiver.js --name \"Scratch\" --dir /tmp/quiver-v14-slice-05-smoke",
+    "node bin/create-quiver.js doctor --dir /tmp/quiver-v14-slice-05-smoke",
+    "bash scripts/ci/smoke-tiered-pack.sh",
+    "awk 'NR==1,/^---$/{next} /^---$/{exit} {print}' /tmp/quiver-v14-slice-05-smoke/docs/ai/QUICK.md > /dev/null",
+    "git diff --check"
+  ],
+  "documentation": [
+    "docs/TESTING_GUIDE_FOR_AI.md.template",
+    "README.md"
+  ],
+  "dependencies": [
+    "slice-01-tiered-context-pack",
+    "slice-02-agents-md-router",
+    "slice-03-active-slice-lifecycle",
+    "slice-04-dedup-frontmatter"
+  ],
+  "assumptions": [
+    "Warnings are more useful than hard failures for stylistic contracts; hard failures belong to migration and file presence checks",
+    "A single smoke script is easier to maintain than spreading the checks across the existing smokes",
+    "Cross-platform shell differences are already handled by the v12 CI matrix; the new smoke follows the same conventions"
+  ],
+  "estimated_hours": 4,
+  "actual_hours": null,
+  "status": "completed",
+  "blocked_reason": null,
+  "ready_at": null,
+  "started_at": "2026-04-23",
+  "completed_at": "2026-04-23",
+  "actual_hours": 5
+}