create-quiver 0.10.0 → 0.12.1

package/specs/quiver-v26-0121-smoke-hardening/slices/slice-00-docs-foundation/slice.json

@@ -0,0 +1,73 @@
+{
+  "slice_id": "slice-00-docs-foundation",
+  "ticket": "QUIVER-26-00",
+  "type": "docs",
+  "title": "Docs foundation and source-of-truth sync",
+  "objective": "Create the v26 hotfix planning package and align source-of-truth docs with the actual v25 and 0.12.0 release state.",
+  "description": "Publish the v26 spec, status, evidence report, execution plan, PR body, slice definitions, execution briefs, closure briefs, and source-of-truth documentation sync before product implementation starts.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "v26-0121-smoke-hardening-docs-foundation",
+    "branch_name": "feature/QUIVER-26-00-v26-0121-smoke-hardening-docs-foundation"
+  },
+  "files": [
+    "README_FOR_AI.md",
+    "ROADMAP.md",
+    "CHANGELOG.md",
+    "specs/quiver-v25-ai-first-lifecycle-orchestrator/STATUS.md",
+    "specs/quiver-v26-0121-smoke-hardening/**"
+  ],
+  "expected_read_paths": [
+    "README_FOR_AI.md",
+    "ROADMAP.md",
+    "CHANGELOG.md",
+    "specs/quiver-v25-ai-first-lifecycle-orchestrator/STATUS.md",
+    "specs/quiver-v25-ai-first-lifecycle-orchestrator/**"
+  ],
+  "allowed_write_paths": [
+    "README_FOR_AI.md",
+    "ROADMAP.md",
+    "CHANGELOG.md",
+    "specs/quiver-v25-ai-first-lifecycle-orchestrator/STATUS.md",
+    "specs/quiver-v26-0121-smoke-hardening/**"
+  ],
+  "depends_on": [],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "slice-00 must land before every implementation slice.",
+  "must": [
+    "Create the v26 planning artifacts.",
+    "Create slice.json, EXECUTION_BRIEF.md, and CLOSURE_BRIEF.md for every slice.",
+    "Sync source-of-truth docs with v25 implemented/published and v26 planned.",
+    "Avoid product code changes."
+  ],
+  "not_included": [
+    "Implementing CLI behavior.",
+    "Changing package behavior.",
+    "Running AI providers.",
+    "Publishing a package.",
+    "Opening a PR."
+  ],
+  "acceptance": [
+    "Spec folder exists under specs/quiver-v26-0121-smoke-hardening.",
+    "Mandatory slice-00 exists.",
+    "Every slice has slice.json, EXECUTION_BRIEF.md, and CLOSURE_BRIEF.md.",
+    "Every slice.json parses successfully.",
+    "README_FOR_AI.md, ROADMAP.md, CHANGELOG.md, and v25 status do not contradict the published 0.12.0 state.",
+    "No product code is modified."
+  ],
+  "tests": [
+    "git diff --check",
+    "find specs/quiver-v26-0121-smoke-hardening -name \"slice.json\" -print -exec node -e \"JSON.parse(require('fs').readFileSync(process.argv[1], 'utf8'))\" {} \\;"
+  ],
+  "validation_hints": [
+    "Use git diff to confirm only docs/spec files changed.",
+    "Check source-of-truth docs for stale v25 planned/pending wording."
+  ],
+  "estimated_hours": 2,
+  "status": "completed",
+  "blocked_reason": null,
+  "actual_hours": 2,
+  "completed_at": "2026-05-23T00:00:00-0300"
+}
+

package/specs/quiver-v26-0121-smoke-hardening/slices/slice-01-cli-help-version-contract/CLOSURE_BRIEF.md

@@ -0,0 +1,38 @@
+# CLOSURE BRIEF - slice-01: CLI help and version contract
+
+## Summary of Work
+
+- Added grouped command descriptions to `--help`.
+- Added `npx create-quiver help` as an alias for complete help.
+- Preserved top-level version output and AI draft-version approval behavior.
+- Added tests for help coverage, local alias metadata, and command discovery.
+- Updated README and generated command reference docs.
+
+## Validation Against Acceptance Criteria
+
+- [x] Version commands verified.
+- [x] AI draft version behavior verified.
+- [x] Help output verified.
+- [x] Help drift coverage added.
+
+## Relevant Changes
+
+- `src/create-quiver/index.js`
+- `tests/commands/cli-contract.test.js`
+- `README.md`
+- `docs/COMMANDS.md.template`
+- `specs/quiver-v26-0121-smoke-hardening/EVIDENCE_REPORT.md`
+- `specs/quiver-v26-0121-smoke-hardening/STATUS.md`
+- `specs/quiver-v26-0121-smoke-hardening/slices/slice-01-cli-help-version-contract/slice.json`
+
+## Pending
+
+- None.
+
+## Remaining Risks
+
+- Help output is still maintained in code, but coverage now checks important public commands.
+
+## Future Recommendations
+
+- Consider moving command help metadata into a shared command registry in a future non-hotfix slice.

package/specs/quiver-v26-0121-smoke-hardening/slices/slice-01-cli-help-version-contract/EXECUTION_BRIEF.md

@@ -0,0 +1,51 @@
+# EXECUTION BRIEF - slice-01: CLI help and version contract
+
+## Context
+
+The npm smoke test showed that `npx create-quiver@0.12.0 --version` fails because the top-level parser treats `--version` as an option requiring a draft version. Help output also needs to become a stronger onboarding surface.
+
+## Objective
+
+Fix version/help behavior and add coverage that keeps command descriptions from drifting.
+
+## Scope
+
+- CLI entrypoint and command router.
+- Help output and command descriptions.
+- Command docs and tests.
+
+## Acceptance Criteria
+
+- `npx create-quiver --version` and `-V` print package version and exit `0`.
+- `ai approve --phase technical-plan --version <n>` still uses draft version semantics.
+- `--help`, `help`, and local `quiver --help` show grouped commands with descriptions.
+- Help drift is covered by automated tests.
+
+## Technical Plan Summary
+
+Route top-level version flags before command-specific option parsing. Centralize or test the public command help surface. Preserve subcommand option ownership.
+
+## Suggested Execution Steps
+
+1. Read the CLI router and current help implementation.
+2. Add top-level version handling only for commandless version requests.
+3. Improve help output and command descriptions.
+4. Add focused CLI tests.
+5. Update docs and evidence.
+
+## Restrictions
+
+- Do not change AI phase state in this slice.
+- Do not remove existing command aliases.
+
+## Risks
+
+- Over-broad `--version` handling could break planner draft approvals.
+
+## Completion Checklist
+
+- [ ] Version tests added.
+- [ ] Help output tests added.
+- [ ] AI approve version behavior preserved.
+- [ ] Docs updated.
+

package/specs/quiver-v26-0121-smoke-hardening/slices/slice-01-cli-help-version-contract/slice.json

@@ -0,0 +1,76 @@
+{
+  "slice_id": "slice-01-cli-help-version-contract",
+  "ticket": "QUIVER-26-01",
+  "type": "fix",
+  "title": "CLI help and version contract",
+  "objective": "Make top-level version and help output reliable, complete, and test-covered without breaking AI draft version approvals.",
+  "description": "Fix top-level --version handling, improve grouped help output, add help drift coverage, and preserve subcommand-specific --version semantics for AI approvals.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "cli-help-version-contract",
+    "branch_name": "feature/QUIVER-26-01-cli-help-version-contract"
+  },
+  "files": [
+    "bin/create-quiver.js",
+    "src/create-quiver/index.js",
+    "src/create-quiver/**",
+    "README.md",
+    "docs/COMMANDS.md.template",
+    "tests/**",
+    "specs/quiver-v26-0121-smoke-hardening/**"
+  ],
+  "expected_read_paths": [
+    "bin/create-quiver.js",
+    "src/create-quiver/index.js",
+    "package.json",
+    "tests/commands/**",
+    "README.md",
+    "docs/COMMANDS.md.template"
+  ],
+  "allowed_write_paths": [
+    "src/create-quiver/**",
+    "README.md",
+    "docs/COMMANDS.md.template",
+    "tests/**",
+    "specs/quiver-v26-0121-smoke-hardening/**"
+  ],
+  "depends_on": [
+    "slice-00-docs-foundation"
+  ],
+  "parallel_safe": "no",
+  "parallel_safe_reason": "This slice owns shared CLI routing and help output used by later slices.",
+  "must": [
+    "Support top-level --version and -V as package version output.",
+    "Preserve ai approve --version <n> draft-version behavior.",
+    "Support npx create-quiver --help, npx create-quiver help, and local quiver --help.",
+    "Group public commands with descriptions and examples.",
+    "Add tests that prevent important commands from missing help descriptions."
+  ],
+  "not_included": [
+    "Changing AI lifecycle state behavior.",
+    "Changing generated docs beyond command references.",
+    "Publishing npm."
+  ],
+  "acceptance": [
+    "Top-level version commands exit 0 and print the package version.",
+    "AI approval version commands still work with draft versions.",
+    "Help output lists public commands with descriptions grouped by purpose.",
+    "Tests fail if important public commands are missing from help.",
+    "Unknown command behavior remains clear and actionable."
+  ],
+  "tests": [
+    "node --test tests/commands/cli-contract.test.js",
+    "node --test tests/commands/ai-plan.test.js tests/lib/approvals.test.js",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "Exercise both top-level --version and ai approve --version <n>.",
+    "Validate local alias through package bin metadata or installed fixture when practical."
+  ],
+  "estimated_hours": 4,
+  "status": "completed",
+  "blocked_reason": null,
+  "actual_hours": 2,
+  "completed_at": "2026-05-23T00:00:00-0300"
+}

package/specs/quiver-v26-0121-smoke-hardening/slices/slice-02-init-doc-links-and-flow-guidance/CLOSURE_BRIEF.md

@@ -0,0 +1,37 @@
+# CLOSURE BRIEF - slice-02: Init doc links and flow guidance
+
+## Summary of Work
+
+- Replaced default command doc links to optional examples with inline commands.
+- Removed the generated status link to a placeholder slice that does not exist in default init.
+- Added doctor regression coverage for missing generated local docs links.
+- Added flow regression coverage for `init -> analyze -> flow`.
+
+## Validation Against Acceptance Criteria
+
+- [x] Default init docs verified.
+- [x] Doctor warnings resolved.
+- [x] Flow guidance verified.
+- [x] Tests run.
+
+## Relevant Changes
+
+- `docs/COMMANDS.md.template`
+- `docs/STATUS.md.template`
+- `tests/commands/doctor.test.js`
+- `tests/commands/flow.test.js`
+- `specs/quiver-v26-0121-smoke-hardening/EVIDENCE_REPORT.md`
+- `specs/quiver-v26-0121-smoke-hardening/STATUS.md`
+- `specs/quiver-v26-0121-smoke-hardening/slices/slice-02-init-doc-links-and-flow-guidance/slice.json`
+
+## Pending
+
+- None.
+
+## Remaining Risks
+
+- Optional docs must not be referenced by default docs unless generated.
+
+## Future Recommendations
+
+- Keep generated doc link checks in smoke coverage.

package/specs/quiver-v26-0121-smoke-hardening/slices/slice-02-init-doc-links-and-flow-guidance/EXECUTION_BRIEF.md

@@ -0,0 +1,52 @@
+# EXECUTION BRIEF - slice-02: Init doc links and flow guidance
+
+## Context
+
+The clean npm smoke test showed `doctor` warnings for links generated by default init and a temporary stale `flow` state when analyze had not completed yet.
+
+## Objective
+
+Make generated docs internally consistent and make `flow` guidance match the actual project state.
+
+## Scope
+
+- Default init templates and template selection.
+- Doctor link checks.
+- Flow next-step guidance.
+- Tests and evidence.
+
+## Acceptance Criteria
+
+- Default init docs do not contain broken links created by Quiver.
+- `doctor` does not warn about Quiver-generated default links.
+- `flow` shows correct next steps after analyze.
+- Tests cover default init and flow state.
+
+## Technical Plan Summary
+
+Audit links in default init templates, remove or generate referenced optional files consistently, and update flow state checks to avoid stale blockers.
+
+## Suggested Execution Steps
+
+1. Reproduce default init + doctor warnings in a fixture.
+2. Fix template references or generated file set.
+3. Verify `flow` before and after analyze.
+4. Add focused tests.
+5. Update evidence.
+
+## Restrictions
+
+- Do not widen default init to legacy/full assets unless necessary.
+- Do not touch AI approval state in this slice.
+
+## Risks
+
+- Removing useful links could reduce onboarding quality; prefer valid links over deletion when the target should exist.
+
+## Completion Checklist
+
+- [ ] Template links audited.
+- [ ] Doctor warnings resolved.
+- [ ] Flow state tests added.
+- [ ] Smoke coverage updated if needed.
+

package/specs/quiver-v26-0121-smoke-hardening/slices/slice-02-init-doc-links-and-flow-guidance/slice.json

@@ -0,0 +1,75 @@
+{
+  "slice_id": "slice-02-init-doc-links-and-flow-guidance",
+  "ticket": "QUIVER-26-02",
+  "type": "fix",
+  "title": "Init doc links and flow guidance",
+  "objective": "Remove broken links from default generated docs and make flow guidance reflect the current project state after analyze and doctor.",
+  "description": "Fix default init template references, doctor link warnings, and guided flow next-step messaging for clean projects.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "init-doc-links-flow-guidance",
+    "branch_name": "feature/QUIVER-26-02-init-doc-links-flow-guidance"
+  },
+  "files": [
+    "src/create-quiver/lib/init-docs.js",
+    "src/create-quiver/lib/init-layout.js",
+    "src/create-quiver/lib/doctor.js",
+    "src/create-quiver/commands/flow.js",
+    "docs/**/*.template",
+    "tests/**",
+    "specs/quiver-v26-0121-smoke-hardening/**"
+  ],
+  "expected_read_paths": [
+    "docs/COMMANDS.md.template",
+    "docs/STATUS.md.template",
+    "src/create-quiver/lib/doctor.js",
+    "src/create-quiver/commands/flow.js",
+    "tests/commands/flow.test.js",
+    "tests/commands/doctor.test.js"
+  ],
+  "allowed_write_paths": [
+    "src/create-quiver/lib/init-docs.js",
+    "src/create-quiver/lib/init-layout.js",
+    "src/create-quiver/lib/doctor.js",
+    "src/create-quiver/commands/flow.js",
+    "docs/**/*.template",
+    "tests/**",
+    "specs/quiver-v26-0121-smoke-hardening/**"
+  ],
+  "depends_on": [
+    "slice-01-cli-help-version-contract"
+  ],
+  "parallel_safe": "maybe",
+  "parallel_safe_reason": "Can run beside slice-03 only if shared flow/help files do not overlap.",
+  "must": [
+    "Default init docs must not reference files absent from the default profile.",
+    "doctor must not warn about links Quiver itself generated incorrectly.",
+    "flow must show the correct next step after analyze creates PROJECT_MAP.md.",
+    "Errors and warnings must remain actionable."
+  ],
+  "not_included": [
+    "Changing AI approval persistence.",
+    "Changing demo scaffold behavior."
+  ],
+  "acceptance": [
+    "Default init followed by doctor has no generated-doc broken-link warnings.",
+    "After analyze, flow no longer reports PROJECT_MAP.md as missing.",
+    "Generated docs still point users to valid examples or omit optional references.",
+    "Focused tests cover default init docs and flow state."
+  ],
+  "tests": [
+    "node --test tests/commands/flow.test.js tests/commands/doctor.test.js tests/lib/init-layout.test.js",
+    "npm run smoke:create-quiver",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "Use a clean temp directory for init/analyze/doctor/flow.",
+    "Check both before and after analyze state."
+  ],
+  "estimated_hours": 4,
+  "status": "completed",
+  "blocked_reason": null,
+  "actual_hours": 2,
+  "completed_at": "2026-05-23T00:00:00-0300"
+}

package/specs/quiver-v26-0121-smoke-hardening/slices/slice-03-ai-approval-review-consistency/CLOSURE_BRIEF.md

@@ -0,0 +1,37 @@
+# CLOSURE BRIEF - slice-03: AI approval and review consistency
+
+## Summary of Work
+
+- Clarified spec generation blockers when review state is missing or stale.
+- Ensured flow does not suggest re-approving an already approved technical plan before review.
+- Added regression coverage for approved-but-unreviewed technical plan guidance.
+- Updated tests for actionable review-plan next commands.
+
+## Validation Against Acceptance Criteria
+
+- [x] Unsupported phase suggestions removed.
+- [x] Spec-create blockers verified.
+- [x] Reviewed approval path verified.
+- [x] Tests run.
+
+## Relevant Changes
+
+- `src/create-quiver/lib/ai/plan-review.js`
+- `src/create-quiver/commands/flow.js`
+- `tests/commands/flow.test.js`
+- `tests/commands/ai-review-plan.test.js`
+- `specs/quiver-v26-0121-smoke-hardening/EVIDENCE_REPORT.md`
+- `specs/quiver-v26-0121-smoke-hardening/STATUS.md`
+- `specs/quiver-v26-0121-smoke-hardening/slices/slice-03-ai-approval-review-consistency/slice.json`
+
+## Pending
+
+- None.
+
+## Remaining Risks
+
+- Existing approval artifacts remain compatible; only user-facing guidance changed.
+
+## Future Recommendations
+
+- Keep every printed next command covered by a CLI acceptance test.

package/specs/quiver-v26-0121-smoke-hardening/slices/slice-03-ai-approval-review-consistency/EXECUTION_BRIEF.md

@@ -0,0 +1,53 @@
+# EXECUTION BRIEF - slice-03: AI approval and review consistency
+
+## Context
+
+The smoke test showed that Quiver correctly blocks spec generation without reviewed plan state, but the recovery path can be confusing. A suggested `plan-review` approval phase is not supported by `ai approve`.
+
+## Objective
+
+Make review/approval/spec-create gates coherent, testable, and actionable.
+
+## Scope
+
+- `ai review-plan` guidance.
+- `ai approve` phase guidance.
+- `spec create` blockers.
+- `flow` next-step messages for plan review.
+- Tests and docs.
+
+## Acceptance Criteria
+
+- No unsupported approval phase is suggested.
+- Missing review state blocks spec creation with the exact next command.
+- Reviewed technical-plan drafts can be approved through a supported path.
+- Tests cover review/approval/spec-create edge cases.
+
+## Technical Plan Summary
+
+Audit approval state transitions and user-facing messages. Clarify status labels and block conditions without weakening review gates.
+
+## Suggested Execution Steps
+
+1. Reproduce the approved-but-unreviewed state.
+2. Audit `flow`, `review-plan`, `approve`, and `spec create` messages.
+3. Fix unsupported phase suggestions.
+4. Add focused tests for state transitions.
+5. Update docs and evidence.
+
+## Restrictions
+
+- Do not allow spec generation from unreviewed technical plans.
+- Do not introduce a new phase unless it is fully wired and tested.
+
+## Risks
+
+- Changing approval labels can break existing tests or stored state expectations.
+
+## Completion Checklist
+
+- [ ] Blocker messages are actionable.
+- [ ] Supported command path verified.
+- [ ] Tests added.
+- [ ] Docs updated.
+

package/specs/quiver-v26-0121-smoke-hardening/slices/slice-03-ai-approval-review-consistency/slice.json

@@ -0,0 +1,77 @@
+{
+  "slice_id": "slice-03-ai-approval-review-consistency",
+  "ticket": "QUIVER-26-03",
+  "type": "fix",
+  "title": "AI approval and review consistency",
+  "objective": "Make review-plan, approval, and spec-create gates consistent and actionable.",
+  "description": "Align the AI lifecycle guidance so approved-but-unreviewed technical plans are clearly blocked, reviewed drafts are approvable, and suggested commands exist.",
+  "git": {
+    "branch_type": "feature",
+    "base_branch": "main",
+    "branch_slug": "ai-approval-review-consistency",
+    "branch_name": "feature/QUIVER-26-03-ai-approval-review-consistency"
+  },
+  "files": [
+    "src/create-quiver/commands/ai.js",
+    "src/create-quiver/commands/spec.js",
+    "src/create-quiver/commands/flow.js",
+    "src/create-quiver/lib/approvals.js",
+    "src/create-quiver/lib/ai/**",
+    "tests/**",
+    "specs/quiver-v26-0121-smoke-hardening/**"
+  ],
+  "expected_read_paths": [
+    "src/create-quiver/commands/ai.js",
+    "src/create-quiver/commands/spec.js",
+    "src/create-quiver/lib/approvals.js",
+    "src/create-quiver/lib/ai/plan-review.js",
+    "tests/commands/ai-review-plan.test.js",
+    "tests/commands/ai-plan-spec-phase.test.js"
+  ],
+  "allowed_write_paths": [
+    "src/create-quiver/commands/ai.js",
+    "src/create-quiver/commands/spec.js",
+    "src/create-quiver/commands/flow.js",
+    "src/create-quiver/lib/approvals.js",
+    "src/create-quiver/lib/ai/**",
+    "tests/**",
+    "README.md",
+    "docs/COMMANDS.md.template",
+    "specs/quiver-v26-0121-smoke-hardening/**"
+  ],
+  "depends_on": [
+    "slice-01-cli-help-version-contract"
+  ],
+  "parallel_safe": "maybe",
+  "parallel_safe_reason": "Can run beside slice-02 only if flow/help files do not overlap.",
+  "must": [
+    "Remove or avoid any suggestion to approve unsupported phase plan-review.",
+    "Make spec-create blockers explain reviewed technical-plan requirements.",
+    "Ensure flow suggests commands that exist and can be completed.",
+    "Preserve versioned approval gates."
+  ],
+  "not_included": [
+    "Changing provider invocation behavior.",
+    "Generating specs from unreviewed plans."
+  ],
+  "acceptance": [
+    "Approved-but-unreviewed technical plans are blocked with an exact next command.",
+    "Reviewed technical-plan drafts can be approved through the supported command path.",
+    "flow does not suggest unsupported phases.",
+    "Tests cover missing review, stale review, reviewed approval, and spec-create gating."
+  ],
+  "tests": [
+    "node --test tests/commands/ai-review-plan.test.js tests/commands/ai-plan-spec-phase.test.js tests/lib/approvals.test.js tests/commands/flow.test.js",
+    "npm run smoke:guided-workflow",
+    "git diff --check"
+  ],
+  "validation_hints": [
+    "Simulate approval from input and versioned approval paths if both still exist.",
+    "Verify every printed next command is accepted by the CLI."
+  ],
+  "estimated_hours": 5,
+  "status": "completed",
+  "blocked_reason": null,
+  "actual_hours": 2,
+  "completed_at": "2026-05-23T00:00:00-0300"
+}

package/specs/quiver-v26-0121-smoke-hardening/slices/slice-04-local-validation-brief-contracts/CLOSURE_BRIEF.md

@@ -0,0 +1,35 @@
+# CLOSURE BRIEF - slice-04: Local validation and brief contracts
+
+## Summary of Work
+
+- Implemented local slice readiness hardening and current brief validation support.
+- `check-slice --local` now falls back to the current directory when Git metadata is unavailable.
+- `depends_on` validation now compares normalized dependency refs, so bare same-spec dependencies resolve consistently.
+- `check-handoff` now validates legacy `HANDOFF.md` files and per-slice `EXECUTION_BRIEF.md` / `CLOSURE_BRIEF.md` files.
+
+## Validation Against Acceptance Criteria
+
+- [x] Local validation works without fatal Git assumption.
+- [x] Completed dependency resolves.
+- [x] Brief validation supported.
+- [x] Handoff compatibility preserved.
+
+## Relevant Changes
+
+- Updated `src/create-quiver/lib/readiness.js`.
+- Updated `src/create-quiver/lib/slice-graph.js`.
+- Updated `src/create-quiver/lib/handoff.js`.
+- Updated CLI help and generated command documentation.
+- Added `tests/lib/handoff.test.js` and new local validation fixtures.
+
+## Pending
+
+- No pending work for this slice.
+
+## Remaining Risks
+
+- Final release smoke still needs normal Git/base validation coverage.
+
+## Future Recommendations
+
+- Keep generated demo slices in validation fixtures to catch regressions.

package/specs/quiver-v26-0121-smoke-hardening/slices/slice-04-local-validation-brief-contracts/EXECUTION_BRIEF.md

@@ -0,0 +1,52 @@
+# EXECUTION BRIEF - slice-04: Local validation and brief contracts
+
+## Context
+
+The npm smoke test found that `check-slice --local` still failed before validation in a non-Git folder and then failed on a valid dependency from `slice-01` to a completed `slice-00-docs-foundation`. It also found that `check-handoff` only accepts the older global `HANDOFF.md` shape.
+
+## Objective
+
+Make local validation useful for new projects and align validation with current slice-local briefs.
+
+## Scope
+
+- `check-slice --local`.
+- Dependency resolution for completed slices.
+- Brief/handoff validators.
+- Fixtures and docs.
+
+## Acceptance Criteria
+
+- Local structural validation does not fatally require Git.
+- Completed documentary slices can satisfy dependencies.
+- `EXECUTION_BRIEF.md` and `CLOSURE_BRIEF.md` validation is supported.
+- Existing `HANDOFF.md` validation remains supported.
+
+## Technical Plan Summary
+
+Separate structural validation from Git/remote validation in local mode, resolve dependencies from the full slice set, and extend validation contracts for slice briefs.
+
+## Suggested Execution Steps
+
+1. Reproduce no-Git local validation failure.
+2. Reproduce completed `slice-00` dependency failure.
+3. Split local structural checks from Git checks.
+4. Add brief validators or route support.
+5. Add regression fixtures and tests.
+
+## Restrictions
+
+- Do not weaken normal PR/base validation outside `--local`.
+- Do not remove global handoff compatibility.
+
+## Risks
+
+- Dependency resolution changes can affect `plan`, `graph`, or `next`; run focused graph tests.
+
+## Completion Checklist
+
+- [ ] No-Git fixture covered.
+- [ ] Completed dependency covered.
+- [ ] Brief validation covered.
+- [ ] Handoff compatibility covered.
+