@jtf19/vibecoding-kit 0.1.0

package/docs/acceptance-checklist.md

@@ -0,0 +1,1226 @@
+# 第一阶段验收清单
+
+## 基础文件验收
+
+源码仓库必须存在：
+
+- `README.md`
+- `CLAUDE.md`
+- `AGENTS.md`
+- `skills/using-vibecoding/SKILL.md`
+- `skills/vibe-brainstorming/SKILL.md`
+- `skills/vibe-product-discovery/SKILL.md`
+- `skills/vibe-product-spec/SKILL.md`
+- `skills/vibe-ui-design/SKILL.md`
+- `skills/vibe-planning/SKILL.md`
+- `skills/vibe-writing-skills/SKILL.md`
+- `skills/vibe-writing-plans/SKILL.md`
+- `skills/vibe-workspace-isolation/SKILL.md`
+- `skills/vibe-subagent-driven-development/SKILL.md`
+- `skills/vibe-dispatching-parallel-work/SKILL.md`
+- `skills/vibe-test-driven-development/SKILL.md`
+- `skills/vibe-executing-plans/SKILL.md`
+- `skills/vibe-debugging/SKILL.md`
+- `skills/vibe-systematic-debugging/SKILL.md`
+- `skills/vibe-implementation/SKILL.md`
+- `skills/vibe-requesting-code-review/SKILL.md`
+- `skills/vibe-review/SKILL.md`
+- `skills/vibe-receiving-code-review/SKILL.md`
+- `skills/vibe-product-acceptance/SKILL.md`
+- `skills/vibe-verification/SKILL.md`
+- `skills/vibe-verification-before-completion/SKILL.md`
+- `skills/vibe-finishing-a-development-branch/SKILL.md`
+- `skills/vibe-context-compact/SKILL.md`
+- `adapters/claude/plugin.json`
+- `adapters/codex/plugin.json`
+- `adapters/cursor/plugin.json`
+- `hooks/session-start/session-start.md`
+- `hooks/session-start/session-start.mjs`
+- `hooks/workflow-handoff/workflow-handoff.md`
+- `hooks/workflow-handoff/README.md`
+- `hooks/post-tool-compact/README.md`
+- `docs/install-claude.md`
+- `docs/install-codex.md`
+- `docs/install-cursor.md`
+- `docs/release-guide.md`
+- `docs/phase-2-roadmap.md`
+- `docs/install-experience-roadmap.md`
+- `docs/submodule-guide.md`
+- `docs/runtime-roadmap.md`
+- `docs/runtime-contract.md`
+- `tools/vibe-runtime-check/index.mjs`
+- `tools/vibe-runtime-check/README.md`
+- `tools/vibe-runtime/index.mjs`
+- `tools/vibe-runtime/README.md`
+- `tools/vibe-compact/index.mjs`
+- `tools/vibe-compact/README.md`
+- `tools/vibe-release-check/index.mjs`
+- `tools/vibe-release-check/README.md`
+- `tools/vibe-init/README.md`
+- `tools/vibe-doctor/README.md`
+- `tools/vibe-lifecycle/index.mjs`
+- `tools/vibe-lifecycle/README.md`
+- `tools/vibe-plugin-pack/index.mjs`
+- `tools/vibe-plugin-pack/README.md`
+- `package.json`
+- `bin/vibe.mjs`
+- `examples/claude-project/README.md`
+- `examples/codex-project/README.md`
+- `examples/cursor-project/README.md`
+- `templates/CLAUDE.md`
+- `templates/AGENTS.md`
+- `templates/product-discovery.md`
+- `templates/product-spec.md`
+- `templates/ui-design-contract.md`
+- `templates/product-acceptance.md`
+- `templates/scenario-acceptance.yaml`
+- `templates/implementation-plan.md`
+- `examples/runtime-fixtures/product-discovery.md`
+- `examples/runtime-fixtures/product-spec.md`
+- `examples/runtime-fixtures/ui-design-contract.md`
+- `examples/runtime-fixtures/product-acceptance.md`
+- `examples/runtime-fixtures/architecture-design.md`
+- `examples/runtime-fixtures/delivery-traceability.yaml`
+- `examples/runtime-fixtures/implementation-plan.md`
+- `examples/runtime-fixtures/test-evidence.json`
+- `examples/runtime-fixtures/diff-coverage.json`
+- `examples/runtime-fixtures/commit-readiness.json`
+- `examples/runtime-fixtures/negative/delivery-traceability-bad-ref.yaml`
+- `examples/runtime-fixtures/negative/test-evidence-missing-output-digest.json`
+- `examples/runtime-fixtures/negative/diff-coverage-unexpected-file.json`
+- `examples/runtime-fixtures/negative/commit-readiness-boundary-escalated.json`
+- `examples/runtime-fixtures/negative/diff-coverage-changed-file-without-task-ref.json`
+- `examples/runtime-fixtures/negative/diff-coverage-required-task-missing.json`
+- `examples/runtime-fixtures/negative/diff-coverage-operation-mismatch.json`
+- `examples/runtime-fixtures/negative/test-evidence-risky-task-missing.json`
+- `examples/runtime-fixtures/scenario-acceptance.yaml`
+- `examples/runtime-fixtures/evidence.json`
+
+## Product / UI Workflow 验收基线
+
+产品和 UI 补齐 stage 独立于 runtime 自动执行路线。验收重点是产品发现、产品规格、UI contract 和产品体验验收能作为显式 workflow handoff 接入既有工程链路，不要求启用 runtime，也不得默认创建 `.vibecoding-state/`。
+
+期望：
+
+- `vibe-product-discovery` 负责产品问题、目标用户、场景、价值假设和成功指标，不写实现计划。
+- `vibe-product-spec` 负责 PRD / capability spec、用户故事、功能要求、非功能要求和产品验收标准，不替代架构规划。
+- `vibe-ui-design` 负责屏幕、用户路径、组件职责、UI 状态、文案、交互、响应式和可访问性 contract，不写前端代码。
+- `vibe-product-acceptance` 负责产品体验验收，区分场景覆盖、用户路径证据、UI 状态证据、可访问性证据、指标准备和体验缺口，不替代工程验证。
+- 四个 skill 都必须包含 frontmatter、`## 下一步调用`、`## Workflow Handoff`、`current_skill:`、`next_skill:`、`handoff:` 和 `stop_condition:`。
+- 产品/UI/交付标准 artifact 模板必须存在：`templates/product-discovery.md`、`templates/product-spec.md`、`templates/ui-design-contract.md`、`templates/product-acceptance.md`、`templates/scenario-acceptance.yaml`、`templates/architecture-design.md`、`templates/delivery-traceability.yaml`、`templates/implementation-plan.md`。
+- `methodology --gate --kind product-spec|ui-design|scenario-acceptance --from-file <fixture> --json` 必须只读通过，并输出 `product_methodology_gate`、`gate_digest`、`writes=false`、`state_directory_created=false`、`command_execution=false`、`skill_execution=false`、`subagent=false`、`mcp=false`、`git=false`。
+- `methodology --gate --kind architecture-design|delivery-traceability --from-file <fixture> --json` 必须只读通过，并输出 `delivery-methodology-gate`、`delivery_methodology_gate`、`gate_digest`、`writes=false`、`state_directory_created=false`、`command_execution=false`、`test_execution=false`、`subagent=false`、`mcp=false`、`git=false`。
+- `methodology --gate --kind implementation-plan --from-file <fixture> --json` 必须只读通过，并输出 `implementation-methodology-gate`、`implementation_task_registry`、`implementation_task_registry_digest`、`writes=false`、`state_directory_created=false`、`command_execution=false`、`test_execution=false`、`subagent=false`、`mcp=false`、`git=false`。
+- `completion --evidence-bundle --from-product-discovery ... --from-architecture ... --from-traceability ... --from-commit-readiness ... --from-evidence ... --json` 必须只读通过，并输出 `product-completion-evidence-bundle`、`requirements_chain`、`architecture_chain`、`traceability_chain`、`implementation_chain`、`implementation_alignment_gate`、`implementation_alignment_ok`、`release_readiness_chain`、`product_readiness`、`ui_readiness`、`engineering_readiness`、`bundle_digest`、`commit_execution_authorized=false`、`git_write=false`、`commit=false`、`push=false`、`pr=false`、`merge=false`。
+- `using-vibecoding`、根入口和 templates 只做轻量路由，不自动执行产品/UI workflow。
+
+## Install UX Stage 验收基线
+
+安装体验 stage 独立于 runtime roadmap。验收重点是项目接入、入口文件安全边界、doctor 复验和未来 `vibe` CLI 生命周期，不要求启用 runtime，也不得默认创建 `.vibecoding-state/`。
+
+当前 UX-1 / 兼容命令 smoke：
+
+```bash
+node tools/vibe-init/index.mjs --target .tmp/install-ux-target --platform all --dry-run
+node tools/vibe-init/index.mjs --target .tmp/install-ux-target --platform all
+node tools/vibe-doctor/index.mjs .tmp/install-ux-target
+node tools/vibe-init/index.mjs --target .tmp/install-ux-target --platform auto --check
+node tools/vibe-init/index.mjs --target .tmp/install-ux-target --platform auto --merge=preview
+```
+
+期望：
+
+- `docs/install-experience-roadmap.md` 明确区分 install lifecycle 和 runtime lifecycle。
+- 默认安装只创建 installed layout：入口文件和 `.vibecoding/`。
+- 默认安装不创建 `.vibecoding-state/`。
+- `vibe-doctor` 对 installed layout 输出 `Result: passed`。
+- `--check` 只读，不写目标项目。
+- `--merge=preview` 只输出建议合并内容，不覆盖已有入口文件；`--merge-preview` 仅作为兼容别名保留。
+
+当前 UX-2 wrapper smoke：
+
+```bash
+node bin/vibe.mjs --help
+node bin/vibe.mjs init --target .tmp/install-ux-cli-target --platform all --dry-run
+node bin/vibe.mjs init --target .tmp/install-ux-cli-target --platform all
+node bin/vibe.mjs doctor --root .tmp/install-ux-cli-target
+```
+
+期望：
+
+- `bin/vibe.mjs` 只做命令路由，不复制 init / doctor 核心逻辑。
+- `node bin/vibe.mjs init` 在未传 `--target` 时默认使用当前目录。
+- `node bin/vibe.mjs doctor --root <path>` 能复用现有 doctor 检查目标项目。
+- 原 `node tools/vibe-init/index.mjs` 和 `node tools/vibe-doctor/index.mjs` 调用保持兼容。
+
+当前 UX-3 managed block smoke：
+
+```bash
+node bin/vibe.mjs init --target .tmp/install-ux-managed-new --platform cursor
+node bin/vibe.mjs doctor --root .tmp/install-ux-managed-new
+node bin/vibe.mjs init --target .tmp/install-ux-managed-existing --platform cursor --merge=preview
+node bin/vibe.mjs init --target .tmp/install-ux-managed-existing --platform cursor --merge=append
+node bin/vibe.mjs doctor --root .tmp/install-ux-managed-existing
+node bin/vibe.mjs init --target .tmp/install-ux-managed-existing --platform cursor --merge=append
+```
+
+期望：
+
+- 新创建的 `CLAUDE.md` / `AGENTS.md` 自带 `<!-- vibecoding:start version=0.2.0 -->` 和 `<!-- vibecoding:end -->`。
+- 已有入口文件没有 managed block 时，默认不覆盖用户内容。
+- `--merge=append` 只追加 managed block，不删除用户非 managed 内容。
+- 已有 managed block 时重复运行只替换 block，不重复追加。
+- doctor 能识别 managed block 缺失、重复或边界不完整。
+
+当前 UX-4 lifecycle config smoke：
+
+```bash
+node bin/vibe.mjs init --target .tmp/install-ux-lifecycle --platform cursor
+node bin/vibe.mjs doctor --root .tmp/install-ux-lifecycle
+node bin/vibe.mjs repair --root .tmp/install-ux-lifecycle --dry-run
+node bin/vibe.mjs uninstall --root .tmp/install-ux-lifecycle --dry-run
+```
+
+期望：
+
+- `vibe init` 生成 `.vibecoding/config.json`。
+- doctor 能校验 lifecycle config 和 managed entry 状态。
+- `update` / `repair` / `uninstall` 默认 dry-run，写入必须传 `--confirm` 或 `--yes`。
+- `repair --dry-run` 能列出缺失资产或 managed block 修复计划。
+- `uninstall --dry-run` 只列出 managed block 和 `.vibecoding/` 删除计划，不触碰 `.vibecoding-state/`。
+- lifecycle 命令不覆盖用户非 managed 内容。
+
+当前 UX-5 session-start bootstrap smoke：
+
+```bash
+node bin/vibe.mjs init --target .tmp/install-ux-bootstrap --platform cursor
+node .tmp/install-ux-bootstrap/.vibecoding/hooks/session-start/session-start.mjs --format text
+node .tmp/install-ux-bootstrap/.vibecoding/hooks/session-start/session-start.mjs --format cursor
+node .tmp/install-ux-bootstrap/.vibecoding/hooks/session-start/session-start.mjs --format codex
+node bin/vibe.mjs doctor --root .tmp/install-ux-bootstrap
+```
+
+期望：
+
+- bootstrap 输出说明项目已安装 Vibecoding、`.vibecoding/config.json` 路径和 `using-vibecoding` 路径。
+- bootstrap 不输出完整 `using-vibecoding` skill 内容。
+- bootstrap 不创建 `.vibecoding-state/`。
+- Cursor / Codex adapter hook 示例引用 `.vibecoding/hooks/session-start/session-start.mjs`。
+- doctor 能校验 session-start bootstrap 文件、adapter 元数据和 hook 示例。
+
+当前 UX-6 platform plugin pack smoke：
+
+```bash
+node bin/vibe.mjs plugin pack --platform all --out .tmp/install-ux-plugins --dry-run
+node bin/vibe.mjs plugin pack --platform all --out .tmp/install-ux-plugins
+node bin/vibe.mjs plugin pack --platform all --out .tmp/install-ux-plugins --check
+node bin/vibe.mjs doctor
+```
+
+期望：
+
+- `plugin pack --dry-run` 输出 `.cursor-plugin` / `.codex-plugin` / `.claude-plugin` 生成计划且不写文件。
+- 写入模式默认生成到 `.tmp/` 下的插件草案目录。
+- `--check` 能确认生成物与 `adapters/` 中的 plugin manifest 和 hook 示例一致。
+- 生成的 plugin manifest 声明 `sessionStartBootstrap`，且不注入完整 skill、不写 `.vibecoding-state/`、不自动执行 `next_skill`。
+- 平台插件草案只负责 session-start bootstrap；项目级 `.vibecoding/` 契约仍由 `vibe init` 负责。
+
+## Stage 38-40 自动化 sidecar 验收
+
+- `subagents --ingest-result` / `subagents --review-gate` 只写 `.vibecoding-state/subagent-results/` 与 `.vibecoding-state/subagent-reviews/`。
+- `hooks --hook-run --max-iterations <n> --confirm` 只写 `.vibecoding-state/hook-runs/` 与 `.vibecoding-state/hook-heartbeats/`。
+- `traces --build --confirm` 能追踪 `hook_runs`、`hook_heartbeats`、`subagent_results`、`subagent_reviews`。
+- `governance --attest` 包含 `automation_artifacts` 与 `automation_policy`。
+- `methodology --gate --kind automation` 可证明 approved + traced + reviewed + bounded。
+- 所有负例必须拒绝 source merge、session create、platform API、long-running worker、daemon、git/worktree 扩权。
+
+## Stage 41 平台能力契约验收
+
+- `platforms --catalog` 只读展示 builtin adapter catalog，不创建 `.vibecoding-state/`。
+- `platforms --probe <platform>` 默认 preview，不调用平台 API、不创建 session、不写文件。
+- `platforms --probe <platform> --confirm` 只写 `.vibecoding-state/platform-capabilities/*.platform-capability.json`。
+- capability artifact 必须绑定 `adapter_digest`、`catalog_digest`、`files.platform_capability` 与 `allowed_followup=['platform-session-approval-only']`。
+- `platforms --verify <platform-capability-file>` 必须拒绝 file alias drift、adapter/catalog drift、`session_create=true`、`platform_api=true`、`model_invocation=true`、`business_source_write=true`、`source_merge=true`、`git=true`、`worktree=true` 或 followup 扩权。
+- `traces --build --confirm` 必须能把 `platform_capabilities` 纳入 source types，并递归验证 Stage 41 artifact。
+
+## Stage 42 平台 session 审批验收
+
+- `subagents --session-approval --from-dispatch <file> --capability <file>` 默认 preview，不写文件、不创建 session。
+- `subagents --session-approval --from-dispatch <file> --capability <file> --confirm` 只写 `.vibecoding-state/platform-session-approvals/*.platform-session-approval.json`。
+- approval artifact 必须绑定 dispatch digest、eligibility digest、scheduler hook plan digest、workflow/task digest、capability digest、adapter digest、catalog digest 和 `files.platform_session_approval`。
+- approval 必须记录 `user_consent_present=true`、`allowed_followup=['platform-session-create-only']`、`budget.max_sessions=1` 与 `budget.timeout_ms=600000`。
+- `subagents --verify <platform-session-approval-file>` 必须拒绝 alias drift、dispatch/capability drift、policy drift、`session_create=true`、`platform_api=true`、`external_network=true`、`source_merge=true`、`git=true`、`worktree=true` 或 followup 扩权。
+- `traces --build --confirm` 必须能把 `platform_session_approvals` 纳入 source types，并递归验证 Stage 42 artifact。
+
+## Stage 43 平台 session 产物验收
+
+- `subagents --create-session --from-approval <file> --confirm` 只写 `.vibecoding-state/platform-sessions/`、`.vibecoding-state/platform-session-leases/` 与 `.vibecoding-state/platform-session-results/`。
+- `subagents --cancel-session <platform-session-file> --confirm` 只写 `.vibecoding-state/platform-session-cancellations/` 取消审计 sidecar，并绑定源 session digest。
+- session artifact 必须绑定 Stage 42 approval digest、prompt digest、transcript digest、adapter operation digest、lease file 与 result file。
+- `session_create=true`、`platform_api=true`、`model_invocation=true` 只允许出现在 Stage 43 session artifact。
+- session result 必须保持 `business_source_write=false`、`source_merge=false`、`git=false`、`worktree=false`，且 `review_required=true`、`review_completed=false`。
+- `subagents --verify <platform-session-file|platform-session-lease-file|platform-session-result-file|platform-session-cancel-file>` 必须拒绝 alias drift、approval drift、session digest drift、lease/result digest drift、payload digest drift、source write / git / worktree 扩权。
+- `traces --build --confirm` 必须能把 `platform_sessions`、`platform_session_leases`、`platform_session_results`、`platform_session_cancellations` 纳入 source types，并递归验证 Stage 43 artifacts。
+
+## Stage 44 平台 session result 审查验收
+
+- `subagents --ingest-session-result <platform-session-result-file> --confirm` 只写 `.vibecoding-state/platform-session-intake/`。
+- `subagents --review-session-result <platform-session-intake-file> --confirm` 只写 `.vibecoding-state/platform-session-reviews/`。
+- intake/review 必须绑定 Stage 43 result digest、session digest、prompt digest、transcript digest、result payload digest、patch digest 与 files touched。
+- review 通过后只允许 `allowed_followup=['source-change-candidate-only']`。
+- Stage 44 必须保持 `business_source_write=false`、`source_merge=false`、`git=false`、`worktree=false`。
+- `traces --build --confirm` 必须能把 `platform_session_intake` 与 `platform_session_reviews` 纳入 source types，并递归验证 Stage 44 artifacts。
+
+## Stage 45 source candidate / sandbox 验收
+
+- `source --candidate --from-session-review <platform-session-review-file> --confirm` 只写 `.vibecoding-state/source-change-candidates/`。
+- `source --apply-sandbox <source-change-candidate-file> --confirm` 只写 `.vibecoding-state/source-sandbox-runs/`。
+- candidate/sandbox 必须绑定 Stage 44 review digest、source result digest、session digest、base sha、patch digest、diff digest、allowed files 与 actual touched files。
+- candidate 只允许 `allowed_followup=['source-sandbox-apply-only']`，sandbox 只允许 `allowed_followup=['source-verification-only']`。
+- Stage 45 必须保持 `business_source_write=false`、`source_merge=false`、`git=false`、`worktree=false`，不得写主工作区。
+- `traces --build --confirm` 必须能把 `source_change_candidates` 与 `source_sandbox_runs` 纳入 source types，并递归验证 Stage 45 artifacts。
+
+## Stage 46 source verification 验收
+
+- `source --verify-change <source-sandbox-run-file> --confirm` 只写 `.vibecoding-state/source-verifications/`。
+- verification 必须绑定 sandbox digest、candidate digest、base sha、diff digest、files touched、evidence digest 与 evidence policy digest。
+- verification 只允许 `allowed_followup=['merge-readiness-only']`。
+- Stage 46 必须保持 `business_source_write=false`、`source_merge=false`、`git=false`、`worktree=false`，不得写主工作区；`command_execution=true` 仅限前台 allowlisted verification commands。
+- 缺失、失败或不在 allowlist 的 evidence 必须阻断 verification。
+- `traces --build --confirm` 必须能把 `source_verifications` 纳入 source types，并递归验证 Stage 46 artifacts。
+
+## Stage 47 merge readiness / approval 验收
+
+- `merge --readiness --from-verification <source-verification-file> --confirm` 只写 `.vibecoding-state/merge-readiness/`。
+- `merge --approve <merge-readiness-file> --confirm` 只写 `.vibecoding-state/merge-approvals/`。
+- readiness 必须绑定 Stage 46 verification digest、sandbox digest、candidate digest、base sha、diff digest、files touched、trace digest、governance digest 与 methodology digest。
+- readiness 只允许 `allowed_followup=['merge-approval-only']`，approval 只允许 `allowed_followup=['controlled-merge-apply-only']`。
+- Stage 47 必须保持 `business_source_write=false`、`source_merge=false`、`git=false`、`worktree=false`、`auto_apply=false`，不得写主工作区或执行 merge。
+- 缺 trace / governance / methodology、digest drift、base sha drift、followup 扩权或 Stage 47 artifact 中出现 source merge / git / worktree / auto apply 语义必须阻断。
+- `traces --build --confirm` 必须能把 `merge_readiness` 与 `merge_approvals` 纳入 source types，并递归验证 Stage 47 artifacts。
+
+## Stage 48 controlled merge apply 验收
+
+- `merge --apply <merge-approval-file> --confirm` 只接受 Stage 47 approval，并写 `.vibecoding-state/merge-applies/`。
+- Stage 48 只允许写 allowlisted 文件 `docs/runtime-auto-merge-ledger.md` 和 merge apply artifact。
+- apply 必须绑定 approval digest、readiness digest、verification digest、base sha、before/after sha、applied files、before/after file digests 与 marker digest。
+- Stage 48 apply artifact 中允许 `business_source_write=true`、`source_merge=true`、`worktree=true`，但必须保持 `git=false`、`commit=false`、`push=false`、`pr=false`、`force=false`。
+- base sha drift、approval digest drift、applied file digest drift、applied file 越界、commit/push/PR/force 扩权必须阻断。
+- `traces --build --confirm` 必须能把 `merge_applies` 纳入 source types，并递归验证 Stage 48 artifact。
+
+## Stage 49 Planner Engine 验收
+
+- `planner --route --from-file <path>` 与 `planner --route --from-hook <hook-intent-file>` 默认 preview，不写文件、不 dispatch、不 create-session。
+- `planner --route ... --confirm` 只写 `.vibecoding-state/planner-routes/*.planner-route.json`。
+- `planner --decompose --from-route <planner-route-file> --confirm` 只写 `.vibecoding-state/planner-plans/*.planner-plan.json`。
+- `planner --briefs --from-plan <planner-plan-file> --confirm` 只写 `.vibecoding-state/planner-briefs/*.planner-briefs.json`。
+- planner route 必须绑定 `selected_workflow`、`workflow_candidates`、`risk_level`、`risk_score`、`blocked_reasons` 与 `allowed_followup=['planner-decompose-only']`。
+- planner plan 必须绑定 route digest、`task_graph`、`dependency_edges`、`conflict_groups`、`subagent_candidates` 与 `allowed_followup=['planner-briefs-only','scheduler-plan-only']`。
+- planner briefs 必须绑定 plan digest、`brief_kind`、`brief_items`、`required_capabilities`、`suggested_platforms`、`token_budget_policy` 与 `allowed_followup=['router-plan-only']`。
+- Stage 49 必须保持 `dispatch=false`、`session_create=false`、`platform_api=false`、`business_source_write=false`、`source_merge=false`、`subagent_dispatch=false`、`git=false`、`worktree=false`。
+- `planner --verify <planner-artifact-file>` 必须拒绝 file identity drift、route/plan digest drift、followup 扩权或任意 dispatch/session/platform/source-write 扩权。
+- `traces --build --confirm` 必须能把 `planner_routes`、`planner_plans` 与 `planner_briefs` 纳入 source types，并递归验证 Stage 49 artifact。
+
+## Stage 50 Router / Orchestrator 验收
+
+- `router --plan --from-briefs <planner-briefs-file>` 默认 preview，不写文件、不 dispatch、不 create-session。
+- `router --plan --from-briefs <planner-briefs-file> --confirm` 只写 `.vibecoding-state/router-plans/*.router-plan.json`。
+- `router --approve <router-plan-file> --confirm` 只写 `.vibecoding-state/router-approvals/*.router-approval.json`。
+- `orchestrator --plan --from-router <router-approval-file> --confirm` 只写 `.vibecoding-state/orchestrator-plans/*.orchestrator-plan.json`。
+- `orchestrator --dispatch-plan <orchestrator-plan-file> --confirm` 只写 `.vibecoding-state/orchestrator-dispatch-plans/*.orchestrator-dispatch-plan.json`。
+- router plan 必须绑定 briefs digest、`brief_routes`、`platform_rankings`、`agent_profiles`、`fallback_routes`、`concurrency_budget` 与 `allowed_followup=['router-approval-only']`。
+- router approval 必须绑定 router plan digest，并且只允许 `allowed_followup=['orchestrator-plan-only']`。
+- orchestrator plan 必须绑定 router approval / router plan digest，并输出 `lanes`、`dispatch_order`、`mutex_groups`、`escalation_rules`、`retry_policy_refs` 与 `session_strategy`。
+- orchestrator dispatch plan 必须绑定 orchestrator plan digest，并且只允许 `allowed_followup=['scheduler-dispatch-plan-only','session-approval-only']`。
+- Stage 50 必须保持 `dispatch=false`、`session_create=false`、`platform_api=false`、`business_source_write=false`、`source_merge=false`、`subagent_dispatch=false`、`git=false`、`worktree=false`。
+- `router --verify <router-artifact-file>` 与 `orchestrator --verify <orchestrator-artifact-file>` 必须拒绝 file identity drift、上游 digest drift、catalog drift、followup 扩权或任意 dispatch/session/platform/source-write 扩权。
+- `traces --build --confirm` 必须能把 `router_plans`、`router_approvals`、`orchestrator_plans` 与 `orchestrator_dispatch_plans` 纳入 source types，并递归验证 Stage 50 artifact。
+- `subagents --eligibility --from-orchestrator <orchestrator-dispatch-plan-file> --task <task-id> --confirm` 必须只写 `.vibecoding-state/subagent-eligibility/*.subagent-eligibility.json`，并将 gate source 记录为 `stage-50-orchestrator-dispatch-plan`。
+- Stage 50 bridge eligibility 必须绑定 `source.kind='orchestrator-dispatch-plan'`、source file/digest、orchestrator plan digest、router plan digest、`next_gate` 与 `strategy`，并保持 `no_subagent_dispatch=true`、`no_session_create=true`、`no_platform_api=true`。
+- `subagents --dispatch --from-orchestrator <orchestrator-dispatch-plan-file> --eligibility <subagent-eligibility-file> --confirm` 必须只写既有 `.vibecoding-state/subagent-dispatches/*.subagent-dispatch.json`，并绑定 `orchestrator_dispatch_plan_file`、`orchestrator_dispatch_plan_digest` 与 `orchestrator_dispatch_plan_artifact_digest`。
+- bridge dispatch 必须仍为 `approved-dispatch-artifact-only`，且能继续被 Stage 42 `subagents --session-approval --from-dispatch` 消费；Stage 42 不得直接消费 `.orchestrator-dispatch-plan.json`。
+
+## Stage 51 Behavioral Eval 验收
+
+- `evals --catalog` 默认只读，不创建 `.vibecoding-state/`。
+- `evals --run-contract <suite>`、`evals --run-scenario <suite>`、`evals --run-behavior <suite>`、`evals --run-adversarial <suite>` 默认 preview，不写文件、不 dispatch、不 create-session。
+- `evals --run-* <suite> --confirm` 只写 `.vibecoding-state/eval-suites/*.eval-suite.json`、`.vibecoding-state/eval-runs/*.eval-run.json` 与 `.vibecoding-state/eval-reports/*.eval-report.json`。
+- suite catalog 必须稳定包含 `contract-core`、`scenario-routing`、`behavior-workflow` 与 `adversarial-guardrails`。
+- eval suite 必须绑定 `suite_id`、`eval_kind`、`cases`、`references`、`catalog_digest`、`fixture_policy` 与 `allowed_followup=['eval-run-only']`。
+- eval run 必须绑定 suite file/digest、`run_status`、`deterministic_judge=true`、`isolated_root_required=true`、`case_results`、`summary`、`planner_feedback`、`router_feedback`、`gate_failures` 与 `allowed_followup=['eval-report-only']`。
+- scenario/adversarial eval run 必须至少包含一个 `transcript-behavioral-judge`，并在 `case_results[].fixture` 中保留 transcript 输入、`expected_workflow_order`、`required_markers`、`forbidden_markers`、`expected_blocked_reasons` 与 `stop_condition`。
+- behavior eval run 必须至少包含一个 `sandbox-replay-judge`，并保留 `replay_trace.trace_type='sandbox-replay'`、有序 replay steps 与每步 digest；replay 必须保持 `writes=false`、`external_network=false`、`model_invocation=false`。
+- `artifact_contract_pass_does_not_imply_behavior_pass=true` 必须出现在 Stage 51 fixture policy 中，用于区分 contract artifact 通过与 behavior judge 通过。
+- eval report 必须绑定 run file/digest、`report_status='behavioral-eval-completed'`、`outcome`、`failing_case_ids`、`planner_feedback`、`router_feedback`、`gate_failures` 与 `allowed_followup=[]`。
+- Stage 51 必须保持 `dispatch=false`、`session_create=false`、`platform_api=false`、`external_network=false`、`model_invocation=false`、`runtime_action=false`、`business_source_write=false`、`source_merge=false`、`subagent_dispatch=false`、`git=false`、`worktree=false`。
+- `evals --verify <eval-artifact-file>` 必须拒绝 file identity drift、suite/run/report digest drift、catalog drift、followup 扩权或任意执行语义扩权。
+- `traces --build --confirm` 必须能把 `eval_suites`、`eval_runs` 与 `eval_reports` 纳入 source types，并递归验证 Stage 51 artifact。
+- release smoke 必须在 `.tmp` 受控根目录下稳定跑通 `evals --catalog`、`evals --run-contract`、`evals --run-scenario`、`evals --run-behavior`、`evals --run-adversarial` 与 `evals --verify`，不得污染主仓库真实工作区。
+
+## 发布前 smoke test
+
+发布前固定执行以下命令序列：
+
+```bash
+node tools/vibe-doctor/index.mjs
+node tools/vibe-runtime-check/index.mjs
+node tools/vibe-init/index.mjs --target .tmp/vibe-init-target --platform all --with-runtime
+node tools/vibe-doctor/index.mjs .tmp/vibe-init-target
+node tools/vibe-runtime/index.mjs status --root .tmp/vibe-runtime-ledger
+node tools/vibe-runtime/index.mjs status --json --root .tmp/vibe-runtime-ledger
+node tools/vibe-runtime/index.mjs validate-handoff --from-file .tmp/json-handoff.md --json --root .tmp/vibe-runtime-ledger
+node tools/vibe-runtime/index.mjs record-handoff --from-file .tmp/json-handoff.md --root .tmp/vibe-runtime-ledger
+node tools/vibe-runtime/index.mjs next --dry-run --root .tmp/vibe-runtime-ledger
+node tools/vibe-runtime/index.mjs next --dry-run --json --root .tmp/vibe-runtime-ledger
+node tools/vibe-runtime/index.mjs next --dry-run --dispatch-intent --json --root .tmp/vibe-runtime-ledger
+node tools/vibe-runtime/index.mjs next --dispatch-intent --root .tmp/vibe-runtime-ledger
+node tools/vibe-runtime/index.mjs next --confirm --dispatch-intent --root .tmp/vibe-runtime-ledger
+node tools/vibe-runtime/index.mjs artifacts --dry-run --root .tmp/vibe-runtime-ledger
+node tools/vibe-runtime/index.mjs artifacts --write --root .tmp/vibe-runtime-ledger
+node tools/vibe-runtime/index.mjs tasks --dry-run --root .tmp/vibe-runtime-ledger
+node tools/vibe-runtime/index.mjs tasks --dry-run --json --root .tmp/vibe-runtime-ledger
+node tools/vibe-runtime/index.mjs tasks --dry-run --task task.alpha_1 --json --root .tmp/vibe-runtime-ledger
+node tools/vibe-runtime/index.mjs tasks --dry-run --task task-2 --json --root .tmp/vibe-runtime-ledger
+node tools/vibe-runtime/index.mjs record-handoff --from-file .tmp/json-handoff.md --json --root .tmp/vibe-runtime-ledger
+node tools/vibe-runtime/index.mjs artifacts --dry-run --json --root .tmp/vibe-runtime-ledger
+node tools/vibe-runtime/index.mjs tasks --write --json --root .tmp/vibe-runtime-ledger
+node tools/vibe-runtime/index.mjs reset --json --confirm --root .tmp/vibe-runtime-ledger
+node tools/vibe-runtime/index.mjs tasks --write --root .tmp/vibe-runtime-ledger
+node tools/vibe-runtime/index.mjs record-handoff --from-file .tmp/legacy-handoff.md --root .tmp/vibe-runtime-ledger
+node tools/vibe-runtime/index.mjs next --dry-run --root .tmp/vibe-runtime-ledger
+node tools/vibe-init/index.mjs --target .tmp/vibe-init-target --platform all --dry-run
+node tools/vibe-init/index.mjs --target .tmp/vibe-init-target --platform all
+node tools/vibe-doctor/index.mjs .tmp/vibe-init-target
+node tools/vibe-init/index.mjs --target .tmp/vibe-init-target --platform all --with-docs
+node tools/vibe-doctor/index.mjs .tmp/vibe-init-target
+```
+
+期望：
+
+- 源码仓库检查通过。
+- runtime contract 只读检查通过。
+- `vibe-runtime` 可只读校验 JSON handoff / fenced JSON handoff / legacy YAML-like handoff，`validate-handoff` 不创建 `.vibecoding-state/` 或写 `workflow.json`。
+- `status --json`、`validate-handoff --json`、`next --dry-run --json` 和 `tasks --dry-run --json` 输出可解析 JSON envelope，包含 `schema_version`、`command`、`mode`、`ok`、`state_present`、`summary`、`tasks`、`quality` 和 `action`。
+- 所有 JSON 输出命令保持只读：`status --json` 和 `validate-handoff --json` 不创建 `.vibecoding-state/` 或 `workflow.json`，`next --dry-run --json` 不执行 `next_skill`，`tasks --dry-run --json` 不写 task artifacts。
+- `tasks --dry-run --task <task-id> --json` 必须保持精确单任务选择，输出 `summary.selected_count=1`、选中 task id、readiness、blocked_by、review_status 和 artifact_paths；输出任务列表只包含选中 task，但 readiness / `blocked_by` 仍按完整 ledger dependency graph 计算。
+- 写入类命令遇到 `--json` 必须明确失败，避免 `tasks --write --json`、`artifacts --json`、`reset --json` 或 `record-handoff --json` 被误认为只读输出；失败分支不得创建 `workflow.json` 或 task artifacts。
+- `vibe-runtime` 可记录 JSON handoff 和 legacy YAML-like handoff。
+- `record-handoff` 成功后输出 handoff quality 提示；warning 不阻止写入、不改变 ledger 结构、不执行 `next_skill`。
+- `status` 可输出当前 ledger 摘要、task dependency readiness 摘要和 review 状态摘要，并保持只读、不创建或修改 workflow state。
+- `next --dry-run` 可输出 ready / blocked / stopped / idle 文本建议，展示任务状态、Task readiness 和 review 状态摘要，并保持不执行 `next_skill`。
+- `next --dry-run --dispatch-intent --json` 输出可解析 Stage 5 intent envelope，包含 `intent`、`gates`、`runtimeBridge`、`platform_hints`、`safety.dispatch_event=false` 和 no auto execution 标记；idle / blocked / needs_fix / waiting dependency 分支不得写 `.vibecoding-state/dispatches/`。
+- `next --dispatch-intent` without `--dry-run` 和 `next --confirm --dispatch-intent` 必须失败，Stage 5 不提供 confirm-dispatch。
+- `next --confirm --dispatch` 是 Stage 6 confirm-dispatch gate；成功只写 `.vibecoding-state/dispatches/<timestamp>.json`，失败 gate 不写 dispatch event，不修改 `workflow.json`。
+- `next --confirm --dispatch --json` 输出可解析执行结果 envelope，包含 `mode: confirm-dispatch`、`dispatch.adapter_ready=true`、`safety.confirmed=true`、`safety.dispatch_event=true`、`review_gate: passed` 和 `task_readiness_gate: passed`。
+- `next --dispatch`、`next --confirm`、`next --dry-run --dispatch`、无 ledger、`next_skill: none`、非 allowed transition、`stop_condition` 非空、`review_status: needs_fix`、waiting / blocked dependency 都必须失败且不写 `.vibecoding-state/dispatches/`。
+- `dispatches --list`、`dispatches --show <event-file>` 和 `dispatches --verify <event-file>` 是 Stage 6.5 read-only dispatch audit；可列出、查看和校验 confirm-dispatch event，`--json` 输出可解析 `dispatch-audit-*` envelope。
+- `dispatches --list` 在无 `.vibecoding-state/`、无 ledger 或无 `dispatches/` 时返回空列表且不创建目录；`dispatches --verify` 对损坏 JSON、非 `confirm-dispatch` event、缺少 forbidden actions、路径穿越或绝对路径输入必须失败且不写文件。
+- `dispatches --claim <event-file> --actor <id>` 是 Stage 7 Dispatch Claim / Ack Gate；合法 event claim 成功后只写 `.vibecoding-state/dispatch-claims/<event-file>.claim.json`，`--json` 输出 `mode: dispatch-claim`、`claim.actor`、`claim.status=claimed` 和 safety no-auto-execution 标记。
+- Stage 7.1 claim input hardening 必须覆盖 verified dispatch event、safe actor id、缺 actor、非法 actor、缺少 event、非法 event、路径越界和重复 active claim；失败不得覆盖原 claim 或创建越界文件。
+- `dispatches --ack <event-file> --actor <id> --status picked|skipped|failed` 只更新 claim state；未 claim、actor mismatch、非法状态（含 `consumed`）必须失败。合法 ack 必须保留 `claim.ack.reason`，并且不得修改原始 dispatch event。
+- Stage 7.2 ack lifecycle hardening 必须保证 ack 只能由原 actor 更新，状态只允许 `picked|skipped|failed`，`consumed` 保持禁止，`ack.reason` 结构稳定保留。
+- `dispatches --claims` 只列出 claim state 摘要；缺少 claim 目录时返回空列表且不创建目录。
+- Stage 7.3 claims audit hardening 必须让 claim 列表可区分 `claimed`、`picked`、`skipped`、`failed`，且损坏 claim 不得被静默当作正常可执行状态。
+- Stage 7 不执行 skill、不调用平台 API、不调用 subagent / MCP / daemon、不触碰 git / worktree 或业务源码。
+- Stage 8.1 pickup package manifest 必须输出 target workflow skill、source workflow skill、platform、entry file、manual instruction、workflow state path、dispatch event path、claim state path、event digest 和 safety boundary；Claude 使用 `CLAUDE.md`，Cursor / Codex 使用 `AGENTS.md`。
+- Stage 8.2 pickup readiness gates 必须显示 event verification 结果；未 claim 时只 warning、不自动 claim；claim 非 `picked` 时不得暗示可以进入 execution。
+- Stage 8.3 pickup read-only audit 必须保证 `dispatches --pickup --json` 输出可解析 envelope，非法 platform、event 路径越界、损坏 event 失败且不写文件；pickup 不写 claim、不写 dispatch、不创建 session、不执行 skill。
+- `execute --from-dispatch <event-file> --dry-run` 只预览 execution plan，不写 `.vibecoding-state/executions/`。
+- `execute --from-dispatch <event-file> --preflight` 只读输出 execution preflight audit，不写 `.vibecoding-state/executions/`。
+- Stage 9.1 dry-run execution plan 必须只预览 execution plan；Stage 9.2 confirm planned envelope 必须只写 planned envelope；Stage 9.3 claim picked gate 必须覆盖 dry-run / preflight / confirm / run；Stage 9.4 no execution boundary 必须保持不执行 workflow skill、不接平台 API、不触碰 git / worktree。
+- Stage 9.5 execution envelope safety 必须记录 no-platform/no-subagent/no-MCP/no-daemon/no-git/no-worktree/no-business-source-write；Stage 9.6 immutability 必须保证成功或失败都不修改 dispatch event 或 claim state；Stage 9.7 execution preflight audit 必须覆盖 dispatch verification、claim exists、actor match、claim picked、target allowlist、stop condition、task readiness、review gate 和 expected write boundary。
+- Stage 9.8 planned envelope verify 必须拒绝 corrupted planned safety；Stage 9.9 execution idempotency key 必须基于 event digest、actor 和 target skill 稳定生成；Stage 9.10 policy snapshot 必须记录 policy name/version、allowlisted skills snapshot 和 forbidden actions；Stage 9.11 execution audit trail 必须记录 expected writes 和 forbidden write boundary。
+- `execute --from-dispatch <event-file> --confirm --actor <id>` 只写 Stage 9 planned execution envelope，保留 `skill_execution=false`、`auto_execution=false` 和 `runtime_action=false`，不执行 workflow skill。
+- 兼容 marker：Stage 9.1 execution preflight gates、Stage 9.2 planned execution envelope、Stage 9.3 immutability guarantees 和 Stage 9.5 idempotency / policy snapshot 仍需保持可检索。
+- `execute --from-dispatch <event-file> --confirm --actor <id> --run` 是 Stage 11 Supervised Real Executor v1；只对 allowlist target skill 执行本地受监管 runtime action，写 `supervised-run` lifecycle record 和 evidence，至少覆盖 `running -> succeeded`。
+- Stage 11.1 要求 `execute --confirm --run` 先持久化同一 execution file 的 `running` record，再原子更新为 terminal status；pre-run gate 失败不得创建 execution file，进入 run 后 crash 时 running/stale record 必须可观测。
+- Stage 11.1 `executions --verify` 必须拒绝缺 lifecycle、缺 running 首态、terminal status mismatch、timestamp 非法或倒序、缺 `evidence.stdout_excerpt`、bad allowlist、bad `runtime_action`、`skill_execution=true`、`platform_api=true`、`git=true` 或 `worktree=true` 的 corrupted `supervised-run` record。
+- Stage 11 失败 gate 覆盖缺少 `--confirm`、未 claim、actor mismatch、claim 未 `picked`、target skill 不在 allowlist、execution file 路径越界；失败不得创建新的 execution lifecycle record，不得修改 dispatch event 或 claim state。
+- `executions --list`、`executions --show <execution-file>` 和 `executions --verify <execution-file>` 是 read-only execution audit；`--json` 输出可解析 `executions-audit-*` envelope，并校验 `platform_api=false`、`subagent=false`、`mcp=false`、`daemon=false`、`git=false`、`worktree=false`、`business_source_write=false`。
+- Stage 11 保持 run 输出 `runtime_action=true`、dry-run / confirm 输出 `runtime_action=false`，并始终保持 `skill_execution=false`、`auto_execution=false`；不调用 Claude / Codex / Cursor API，不创建 session，不调用 subagent / MCP / daemon，不触碰 git / worktree，不写业务源码。
+- Stage 11.2 `--run` record 必须包含与 `--preflight` 一致的 gates、policy 和 write boundary，用于审计 run gate parity。
+- Stage 11.3 `supervised-run` 必须记录唯一 runtime action contract：`generate-supervised-handoff-package`、input summary、output summary、`skill_execution=false` 和 `business_source_write=false`。
+- Stage 11.4/11.5/11.6 必须支持并 verify `failed`、`timed_out`、`cancelled` terminal lifecycle，且都从 `running` 开始，包含 terminal evidence，不修改 dispatch event 或 claim state。
+- Stage 11.7 `executions --list/show/verify` 必须输出 active、terminal、age_ms 和 stale audit 信息，并保持只读。
+- Stage 11.8 同一 event digest、actor 和 target skill 的 active `running` run 必须触发 idempotency guard，新的 `--run` 失败且不创建 execution file。
+- Stage 11.9 `executions --verify` 必须拒绝 corrupted policy name/version、allowlist snapshot、forbidden actions、runtime action name 或 runtime action contract。
+- Stage 11.10 release smoke 必须覆盖成功 run、失败/超时/取消 lifecycle、active duplicate guard、corrupted policy/action contract 和只读 audit。
+- Stage 12.1-12.10 必须覆盖 execution candidate source model、readiness gates、policy intent、risk profile、idempotency preview、history awareness、candidate audit、candidate persistence boundary、candidate verification 和 docs/check/smoke sync；`execute --candidate` 默认 no-write，`--confirm` 只写 `.vibecoding-state/execution-candidates/*.candidate.json`，不执行 runtime action。
+- Stage 13.1-13.10 必须覆盖 simulation input contract、simulated action plan、approval package manifest、recovery preview、evidence completeness preview、simulation policy verification、approval state boundary、replayable dry-run output、simulation audit commands 和 docs/check/smoke sync；approval package 只写 `.vibecoding-state/execution-approvals/*.approval.json`，不执行 runtime action。
+- Stage 14.1-14.10 必须覆盖 explicit auto-run enable gate、auto-run policy contract、approval binding gate、active lock/lease gate、controlled runtime action execution、auto-run lifecycle record、recovery evidence、auto-run audit classification、negative policy smoke 和 release/docs/smoke sync；controlled auto-run 必须绑定 approval digest、candidate digest、idempotency key 和 `.vibecoding-state/auto-run-locks/*.lock.json`，且仍不执行 workflow skill、不接平台 API、不调用 subagent/MCP/daemon、不触碰 git/worktree、不写业务源码。
+- Stage 15.1-15.10 必须覆盖 Auto-run Policy DSL：policy profile model、DSL schema、data-only source boundary、policy evaluation envelope、risk gate、approval requirement、policy snapshot binding、policy audit commands、negative smoke 和 docs/check/smoke sync；`policies --list` / `policies --show <profile>` 必须只读，profile 固定为 `strict`、`controlled-local-runtime`、`review-only`，并输出 `default_enabled=false`、`policy_digest`、approval requirement、limits、forbidden actions、`dynamic_code=false` 和 `remote_config=false`。
+- Stage 15 policy evaluation 必须接入 candidate、approval 和 controlled auto-run：candidate / approval artifact 必须包含 `policy_evaluation` 与 `policy_digest`；policy digest mismatch、unknown profile、forbidden risk、non-allowlisted target 或 runtime action 必须失败且不创建 execution。
+- Stage 16.1-16.10 必须覆盖 Candidate Queue / Scheduler Scan：queue source model、queue item envelope、readiness gates、deterministic priority、scheduler scan contract、optional queue persistence、queue audit commands、promotion preview、negative smoke 和 docs/check/smoke sync；`queue --scan` 默认 no-write，`queue --scan --confirm` 只写 `.vibecoding-state/execution-queue/*.queue.json`，`queue --list/show/verify` 保持只读。
+- Stage 16 queue scan 必须输出 ready / blocked / stale / locked / active history / terminal history / blocked reasons / promotion preview；missing approval、bad policy digest、active lock、active running、corrupted queue snapshot 和 path traversal 必须失败或 blocked，且不得调用 `execute --auto-run`、不得启动 daemon/worker/watcher、不得修改 dispatch/claim/execution。
+- Stage 17.1-17.10 必须覆盖 Approval Lifecycle：approval lifecycle source model、sidecar envelope schema、audit commands、transition preview、confirm persistence boundary、expiration/staleness、auto-run lifecycle gate、consumed evidence、negative smoke 和 docs/check/smoke sync；`approvals --list/show/verify` 只读，`approvals --transition` 默认 no-write，只有 `--confirm` 写 `.vibecoding-state/approval-lifecycle/*.approval-lifecycle.json`，不修改 approval artifact。
+- Stage 17 lifecycle gate 必须让 rejected、expired、revoked、consumed approval 阻断 controlled auto-run；successful controlled auto-run 必须写 consumed sidecar evidence；missing reason、bad lifecycle digest、terminal transition 和 path traversal 必须失败且不执行 runtime action。
+- Stage 18.1-18.10 必须覆盖 Runtime Action Catalog：builtin data-only catalog、catalog schema、audit commands、unknown action default deny、candidate binding、approval binding、policy evaluation integration、queue/auto-run gate、negative smoke 和 docs/check/smoke sync；`actions --list/show/verify` 只读，catalog 必须包含 `catalog_digest`、`default_allow_unknown=false`、required inputs、writes、idempotency、recovery 和 policy profile。
+- Stage 18 catalog gate 必须接入 candidate、approval、policy evaluation、queue scan 和 controlled auto-run；unknown runtime action、catalog digest mismatch 或 corrupted action binding 必须 blocked 或 verify failed，且不得创建 execution。
+- Stage 21.1-21.5 必须覆盖 Scheduler Plan / Dry-run Scheduler：scheduler source model、scheduler plan envelope、plan command、plan audit commands 和 negative smoke；`scheduler --plan` 默认 no-write，`scheduler --plan --confirm` 只写 `.vibecoding-state/scheduler-plans/*.scheduler-plan.json`，`scheduler --list-plans/show-plan/verify-plan` 保持只读。
+- Stage 21 scheduler plan 必须绑定 queue digest、execution policy digest、scheduler policy digest、runtime budget digest 和 action catalog digest；plan verify 必须拒绝 digest mismatch、corrupted plan 和 path traversal，且不得调用 `execute --auto-run`、不得写 execution、不得启动 daemon/worker/watcher。
+- Stage 22.1-22.6 必须覆盖 Scheduler Policy / Runtime Budget：内置 `scheduler-dry-run`、`single-local-auto-run`、`recovery-only` profile、builtin budget、policy/budget digest binding、read-only policy commands 和 negative smoke；默认 `default_enabled=false`、每次最多一个 item、`retry_allowed=false`、`recovery_apply_allowed=false`，不读取远程配置、不动态 eval。
+- Stage 23.1-23.7 必须覆盖 Single-shot Scheduler Worker：`scheduler --once --confirm` gate、revalidation chain、scheduler lease、controlled auto-run delegation、scheduler run audit、idempotency/no duplicate execution 和 negative smoke；无 `--confirm` 必须失败，每次最多执行一个 ready item。
+- Stage 23 single-shot scheduler 必须复用 controlled auto-run gate，重新验证 candidate、approval、lifecycle、policy digest、scheduler policy digest、runtime budget digest、action catalog digest、active lock、scheduler lease 和 idempotency key；执行后写 `.vibecoding-state/scheduler-leases/*.scheduler-lease.json`、`.vibecoding-state/scheduler-runs/*.scheduler-run.json` 和既有 execution record，但不实现 loop/daemon、不自动恢复、不自动 retry、不自动回复、不接平台 API、不调用 subagent/MCP、不触碰 git/worktree。
+- Stage 24.1-24.4 必须覆盖 Recovery Classifier：recovery taxonomy、classifier command、classification artifact 和 classification verification；`recovery --classify` 默认 no-write，`recovery --classify --confirm` 只写 `.vibecoding-state/recovery-classifications/*.recovery-classification.json`，`recovery --list-classifications/show-classification/verify-classification` 保持只读。
+- Stage 24 classification 必须覆盖 `lease_stale`、`execution_failed`、`execution_timed_out`、`execution_running_stale`、`approval_missing`、`approval_blocked`、`policy_mismatch`、`catalog_mismatch`、`readiness_blocked`、`scheduler_lease_active` 和 `unknown`；verify 必须拒绝 path traversal、source digest drift、policy/catalog drift 和 corrupted artifact，且不得执行 recovery apply、释放 lock、删除 execution 或 retry。
+- Stage 25.1-25.4 必须覆盖 Confirmed Auto Recovery：recovery policy/action catalog、apply preview、confirmed single recovery run 和 idempotency/negative gates；`recovery --apply <classification-file>` 默认 no-write，`--confirm` 每次最多处理一个 eligible finding，只写 `.vibecoding-state/recovery-runs/*.recovery-run.json`，必要时写 `.vibecoding-state/retry-packages/*.retry-package.json`。
+- Stage 25 recovery apply 必须绑定 classification digest、finding digest、recovery policy digest、recovery action catalog digest、scheduler policy digest 和 runtime budget digest；unsupported action/category、already applied finding、active scheduler lease conflict、source digest drift、path traversal 和 tampered classification 必须失败；不得修改业务源码、删除/覆盖原 artifact、执行 controlled auto-run、自动 retry 或创建 approval。
+- Stage 26.1-26.4 必须覆盖 Scheduler + Recovery Integration：scheduler plan recovery hints、`scheduler --once --recover --confirm`、at-most-one combined semantics 和 integrated smoke/docs；normal once 与 recovery once 必须互斥，同一次 invocation 最多执行一个 queue item 或 apply 一个 recovery finding，不能混合。
+- Stage 26 scheduler recovery mode 必须复用 confirmed recovery path，写 scheduler run、scheduler lease、recovery classification、recovery run 和必要 retry package audit；不得实现 loop/daemon/watcher、自动清理、自动 retry、平台 API、subagent/MCP、git/worktree。
+- Stage 27 必须覆盖 Bounded Auto Retry：`retry --list-packages/show-package/verify-package` 保持只读，`retry --run <retry-package-file>` 默认 no-write，`retry --run <retry-package-file> --confirm` 最多写一个 `.vibecoding-state/retry-runs/*.retry-run.json`。
+- Stage 27 retry 必须验证 source execution 仍为 `failed` 或 `timed_out`、source digest 未漂移、approval lifecycle 未 rejected/expired/revoked/consumed、candidate/approval/policy/budget/catalog digest 绑定一致、无 active scheduler lease、无 active auto-run lock、无已 retry 记录；non-transient source、重复 retry、digest drift、path traversal 和 terminal approval 必须失败且不修改原 artifact。
+- Stage 28 必须覆盖 Foreground Bounded Loop：`daemon --loop --dry-run` 不写文件，`daemon --loop --confirm --max-iterations <n>` 只写 `.vibecoding-state/daemon-loops/*.daemon-loop.json` 和 heartbeat evidence，`daemon --stop --confirm --reason <text>` 只写 `.vibecoding-state/daemon-stop/stop.json`，`daemon --loops --list/show/verify` 保持只读。
+- Stage 28 loop 必须保持 foreground-only、max iterations bounded、stop file gate、kill switch gate、active scheduler lease gate、heartbeat evidence、no duplicate execution；不得启动后台 worker、不得注册 watcher、不得 fork、不得长驻。
+- Reply A-D 必须覆盖本地自动回复流水线：`reply --draft` 默认 no-write，`--confirm` 写 `.vibecoding-state/reply-drafts/`；`reply --approve <draft-file> --confirm` 写 `.vibecoding-state/reply-approvals/`；`reply --outbox <approval-file> --confirm` 写 `.vibecoding-state/reply-outbox/`；`reply --send <outbox-file> --confirm` 只写 `.vibecoding-state/reply-send-runs/`。
+- Reply D send gate 必须固定 `sent=false`、`send_allowed=false`、`external_delivery=false`；不得调用 Slack/GitHub/Linear/邮箱/IDE API，不得自动回复用户，不得把 draft 当成已发送消息。
+- Stage 29 必须覆盖 Unified Runtime Trace Ledger：`traces --build --dry-run` 不写文件，`traces --build --confirm` 只写 `.vibecoding-state/runtime-traces/*.runtime-trace.json`，`traces --list/show/verify` 保持只读。
+- Stage 29 trace 必须绑定 scheduler plan/run、recovery classification/run、retry package/run、daemon loop/heartbeat、reply draft/approval/outbox/send-run 和 observability snapshot 的文件名与 digest；source digest drift、missing source、path traversal 和 corrupted trace 必须 verify failed，且不得修改源 artifact、不得执行 runtime action。
+- Stage 30 必须覆盖 Readiness / Observability Expansion：`readiness --score` / `observability --summary` 输出 `retry_health`、`loop_health`、`reply_health` 和 `trace_health`；preview 不写文件，`--confirm` 只写 observability snapshot。
+- Stage 30 readiness 必须对 tampered retry/reply/trace 或 stop file / duplicate retry 降分或记录 blocked reason；不得改变 queue gate、不得触发 retry、不得启动 loop、不得发送 reply。
+- Reply E 必须覆盖 Source-bound Local Reply Draft：`reply --draft --source-bound` 默认 no-write，`--confirm` 写 source-bound draft，draft manifest 绑定 workflow、latest execution、scheduler/recovery/retry run、observability snapshot 和 runtime trace 的文件名与 digest。
+- Reply E source manifest drift 必须让 `reply --verify` 或 `reply --approve` 失败；仍固定 `model_invocation=false`、`send_allowed=false`、`external_delivery=false`，不调用模型、不调用平台 API、不自动回复用户。
+- Reply F 必须覆盖 Source-bound Reply Review Gate：`reply --review <draft-file>` 默认 no-write，`--confirm` 只写 `.vibecoding-state/reply-reviews/*.reply-review.json`；source-bound draft 缺 review sidecar 时 `reply --approve` 必须失败。
+- Reply F review sidecar 必须绑定 draft digest、source manifest digest、latest trace/observability digest 和 boundary assertions；review tamper、draft digest drift、source manifest drift 必须让 `reply --verify` / `reply --approve` / downstream outbox-send verify 失败。
+- Stage 31 必须覆盖 Governance Attestation / Boundary Audit：`governance --attest --dry-run` 不写文件，`governance --attest --confirm` 只写 `.vibecoding-state/governance/*.governance-attestation.json`，`governance --list/show/verify` 保持只读。
+- Stage 31 governance attestation 必须绑定 runtime trace、observability snapshot 和 reply review chain digest，并固定 no-platform/no-external-delivery/no-model/no-git/no-worktree/no-subagent/no-MCP/no-business-source-write；tampered trace、observability 或 reply review 必须导致 violations 或 verify failed。
+- Stage 32 必须覆盖 Methodology Gate Ledger：`methodology --catalog` 只读，`methodology --gate --kind <spec|plan|tdd|debug|review|completion>` 默认 no-write，`methodology --gate --kind <kind> --confirm` 只写 `.vibecoding-state/methodology-gates/*.methodology-gate.json`，`methodology --list/show/verify` 保持只读。
+- Stage 32 methodology gate 必须绑定 workflow digest、builtin methodology catalog digest、criteria、blocked_reasons 和 safety boundary；workflow digest drift、catalog digest mismatch、tampered criteria/blocked reasons、safety boundary drift 和 path traversal 必须 verify failed。Stage 32 不执行 workflow skill、不调用 external reference、不派发 subagent、不创建 commit/branch/PR、不调用平台 API、不触碰 git/worktree/业务源码。
+- Stage 32 trace/readiness/governance 可观测面必须能看到 methodology gate artifact，但不得因此改变 scheduler、recovery、retry、reply 或 execution gate。
+- `artifacts --dry-run` 可预览 task brief、review gate 和 evidence skeleton，并保持不写文件；`task-brief.md` 聚焦任务交接，`review-gate.md` 聚焦 review 风险和完成门禁，`evidence.md` 聚焦已有证据和待补验证；产物包含 `goal`、`key_decisions`、`reason`、scope、files、risks、acceptance 和 evidence 上下文，缺失字段显示为 `not recorded` / `- not recorded`。
+- `artifacts --write` 只写 `.vibecoding-state/task-brief.md`、`.vibecoding-state/review-gate.md` 和 `.vibecoding-state/evidence.md`。
+- `tasks --dry-run` 可预览任务级 brief、report、review gate 和 evidence skeleton，并保持不写文件；`--task <task-id>` 只预览一个已记录 task，找不到 task 或 task id 不安全时失败。
+- `tasks --write` 只写 `.vibecoding-state/tasks/<task-id>/brief.md`、`report.md`、`review-gate.md` 和 `evidence.md`，不写业务源码、不执行任务、不调用 subagent；非法 task id（包括路径穿越、Windows 保留设备名、重复 task id 和尾随 `.` / 空格）必须失败且不得创建 `.vibecoding-state/tasks/` 外文件；`depends_on` 引用不存在 task、自依赖或 cyclic task dependency 必须在 `validate-handoff` / `record-handoff` 阶段失败且不写 workflow state；`--task <task-id>` 只写选中 task，不写其他 task artifacts。
+- 任务级 `review_status` 支持 `not_started`、`requested`、`clean`、`needs_fix`、`waived`；`needs_fix` 只提示显式处理 review feedback，`waived` 必须记录 waiver 说明。
+- runtime ledger smoke 不在 repo 根残留 `.vibecoding-state/`。
+- 默认 installed layout 检查通过。
+- `--with-docs` installed layout 检查通过。
+- 临时目录验证后清理。
+
+## 工具链验收
+
+### `vibe-init` 默认安装
+
+命令：
+
+```bash
+node tools/vibe-init/index.mjs --target .tmp/vibe-init-target --platform all --dry-run
+node tools/vibe-init/index.mjs --target .tmp/vibe-init-target --platform all
+node tools/vibe-doctor/index.mjs .tmp/vibe-init-target
+```
+
+期望：
+
+- dry-run 只输出计划，不写入文件。
+- 根目录只生成平台入口文件：`CLAUDE.md`、`AGENTS.md`。
+- `CLAUDE.md` 来自 `templates/CLAUDE.md`，包含 `.vibecoding/skills/` 和 `using-vibecoding`。
+- `AGENTS.md` 来自 `templates/AGENTS.md`，包含 `.vibecoding/skills/`。
+- Vibecoding Kit 资产安装到 `.vibecoding/`。
+- 默认安装包含 `.vibecoding/skills/`、`.vibecoding/adapters/`、`.vibecoding/hooks/`、`.vibecoding/VIBE-CODING.md`。
+- 默认不安装业务根目录 `README.md`、`skills/`、`adapters/`、`hooks/`、`docs/`、`examples/`。
+- doctor 输出 `Layout: installed` 和 `Result: passed`。
+
+### `vibe-init` 单平台安装
+
+命令：
+
+```bash
+node tools/vibe-init/index.mjs --target .tmp/vibe-init-claude --platform claude
+node tools/vibe-doctor/index.mjs .tmp/vibe-init-claude
+node tools/vibe-init/index.mjs --target .tmp/vibe-init-cursor --platform cursor
+node tools/vibe-doctor/index.mjs .tmp/vibe-init-cursor
+node tools/vibe-init/index.mjs --target .tmp/vibe-init-codex --platform codex
+node tools/vibe-doctor/index.mjs .tmp/vibe-init-codex
+```
+
+期望：
+
+- Claude 单平台安装只要求 `CLAUDE.md` 和 `.vibecoding/adapters/claude/`。
+- Cursor 单平台安装只要求 `AGENTS.md` 和 `.vibecoding/adapters/cursor/`。
+- Codex 单平台安装只要求 `AGENTS.md` 和 `.vibecoding/adapters/codex/`。
+- doctor 不要求未安装平台的 adapter。
+- doctor 输出对应 `Platforms:` 和 `Result: passed`。
+
+### `vibe-init` 完整文档安装
+
+命令：
+
+```bash
+node tools/vibe-init/index.mjs --target .tmp/vibe-init-target --platform all --with-docs
+node tools/vibe-doctor/index.mjs .tmp/vibe-init-target
+```
+
+期望：
+
+- `.vibecoding/docs/` 存在。
+- `.vibecoding/examples/` 存在。
+- doctor 输出 `Result: passed`。
+
+### `vibe-init` 不覆盖已有文件
+
+准备：
+
+```text
+.tmp/vibe-init-target/CLAUDE.md 已存在
+```
+
+命令：
+
+```bash
+node tools/vibe-init/index.mjs --target .tmp/vibe-init-target --platform all
+```
+
+期望：
+
+- 输出 `[skip] CLAUDE.md (exists)`。
+- 原 `CLAUDE.md` 内容保持不变。
+- 其余缺失文件正常安装。
+- 如果已有 `CLAUDE.md` 未包含 `.vibecoding/skills/` 或 `using-vibecoding`，doctor 输出 `passed with warnings`，提示需要手动合并 Vibecoding 入口。
+
+## 文档与分发验收
+
+### README 主入口
+
+`README.md` 必须说明：
+
+- 5 分钟快速安装命令。
+- `vibe-doctor` 安装后诊断命令。
+- `claude`、`cursor`、`codex`、`all` 平台安装结果。
+- repo layout 与 installed layout 边界。
+- `docs/acceptance-checklist.md`、`docs/release-guide.md` 和 `docs/submodule-guide.md` 的入口。
+
+### 发布说明
+
+`docs/release-guide.md` 必须说明：
+
+- 发布包应包含的目录和文件。
+- 发布包不应包含 `.tmp/`、`fork/`、缓存或未验证实验产物。
+- repo layout 与 installed layout 的边界。
+- 发布前固定检查命令。
+- 验证后的临时目录清理方式。
+
+### 工具文档
+
+`tools/vibe-init/README.md` 与 `tools/vibe-doctor/README.md` 必须说明：
+
+- 单平台安装和检查语义。
+- Cursor / Codex 共用 `AGENTS.md`。
+- `docs/` 和 `examples/` 只在 `--with-docs` 时安装到 `.vibecoding/`。
+- 入口文件被 skip 后的手动合并方式。
+
+### examples 文档
+
+每个 examples README 必须说明：
+
+- 面向的平台。
+- 对应 `--platform` 参数。
+- 预期根入口文件。
+- 安装后 `vibe-doctor` 命令。
+- 人工 smoke prompt。
+- 示例目录不是业务项目必须复制到根目录的资产。
+
+## 第二阶段首轮验收
+
+Stage 19/20 runtime 增强必须满足：
+
+- `leases --list/show/verify` 只读审计 auto-run locks 和 running executions；缺目录返回空列表，不创建目录。
+- `recovery --preview` 默认 no-write，输出 manual recovery steps、retry candidates 和 `retry_allowed=false`。
+- `recovery --preview --confirm` 只写 `.vibecoding-state/recovery-packages/*.recovery.json`，不释放 lock、不删除 execution、不自动 retry。
+- `observability --summary` / `readiness --score` 默认 no-write，输出 deterministic readiness score、dimension scores、blocked reasons 和 evidence completeness。
+- `readiness --score --confirm` 只写 `.vibecoding-state/observability/*.observability.json`，不改变 queue gate，不触发 runtime action。
+- 损坏 lock、损坏 recovery package、active lock、stale running 和 path traversal 必须失败或降级为 blocked audit，不创建 execution。
+
+## 第二阶段首轮验收
+
+第二阶段首轮新增能力必须满足：
+
+### `vibe-init` 安装体验
+
+命令：
+
+```bash
+node tools/vibe-init/index.mjs --target .tmp/vibe-init-target --platform auto --check
+node tools/vibe-init/index.mjs --target .tmp/vibe-init-target --platform auto --merge-preview
+```
+
+期望：
+
+- `--check` 不写入文件。
+- `--platform auto` 能根据已有 `CLAUDE.md` / `AGENTS.md` 推断平台；没有入口文件时回退到 `all`。
+- `--merge-preview` 对已有入口文件输出建议合并片段，不覆盖文件。
+
+### `vibe-doctor` 诊断增强
+
+期望：
+
+- warn / fail 输出 `fix:` 修复建议。
+- repo layout 检查 `.gitmodules` 和 `fork/distill`、`fork/ECC`、`fork/<external-reference>`、`fork/token-savior`。
+- repo layout 检查 README、release guide、acceptance checklist 的关键入口链接。
+- installed layout 检查 adapter 与入口文件是否一致。
+
+### `vibe-compact` 本地压缩
+
+命令：
+
+```bash
+node tools/vibe-compact/index.mjs --input docs/phase-2-roadmap.md --max-lines 2
+```
+
+期望输出包含：
+
+```text
+目标：
+当前状态：
+关键决策：
+已完成：
+未完成：
+风险：
+下一步：
+关键文件：
+```
+
+### 发布前聚合检查
+
+命令：
+
+```bash
+node tools/vibe-release-check/index.mjs
+node tools/vibe-release-check/index.mjs --quiet
+```
+
+期望：
+
+- 聚合检查输出 `Result: passed`。
+- `--quiet` 输出通过/失败摘要，失败时不吞掉失败命令细节。
+- Cursor / Codex 单平台安装后的 doctor 输出 `Result: passed`，不因共用 `AGENTS.md` 产生缺少另一个平台 adapter 的 warning。
+- 默认清理 `.tmp/`。
+- 不提交、不打 tag、不执行远程发布。
+
+## Runtime Stage 2 本地状态账本验收
+
+Stage 2 ledger 必须满足：
+
+### `vibe-runtime` 显式 ledger 命令
+
+命令：
+
+```bash
+node tools/vibe-runtime/index.mjs status
+node tools/vibe-runtime/index.mjs record-handoff --from-file handoff.md
+node tools/vibe-runtime/index.mjs next --dry-run
+node tools/vibe-runtime/index.mjs reset --confirm
+```
+
+期望：
+
+- `status` 只读，不创建 `.vibecoding-state/`。
+- `record-handoff` 只在已存在 root 下写 `.vibecoding-state/workflow.json`，不会创建 root。
+- `record-handoff` 校验 `current_skill` 和 `next_skill`，并生成 `status: handoff-recorded`。
+- `next --dry-run` 只输出下一步建议，不执行 `next_skill`。
+- `reset --confirm` 只删除 `.vibecoding-state/`。
+- `.gitignore` 忽略 `.vibecoding-state/`。
+- `vibe-runtime-check` 检查 `tools/vibe-runtime/` 和 `.vibecoding-state/` ignore 边界。
+- `vibe-doctor` repo layout 检查 `tools/vibe-runtime/` 和 `.vibecoding-state/` ignore 边界。
+- `vibe-release-check` 包含 runtime ledger smoke，且默认清理 `.tmp/`。
+- 不自动调用 subagent、不创建 worktree、不执行 git 写入、不安装依赖、不启动 MCP / agent graph / daemon。
+
+## 第二阶段第二批验收
+
+第二阶段第二批新增能力必须满足：
+
+### examples 安装后快照
+
+期望：
+
+- `examples/claude-project/README.md` 说明默认只在根目录生成 `CLAUDE.md`。
+- `examples/cursor-project/README.md` 说明默认只在根目录生成 `AGENTS.md`。
+- `examples/codex-project/README.md` 说明默认只在根目录生成 `AGENTS.md`。
+- 三个示例都说明 kit 资产集中在 `.vibecoding/`。
+- 三个示例都说明 `docs/` 和 `examples/` 只有 `--with-docs` 才安装。
+
+### hooks 边界说明
+
+期望：
+
+- `hooks/session-start/` 明确 hook 只是提示边界，不是强制 workflow runtime。
+- `hooks/post-tool-compact/` 明确压缩需要显式进入 `vibe-context-compact` 或显式调用本地工具。
+- 文档不声称存在自动调用链、长期 memory 或跨会话索引。
+
+### `vibe-compact` 输出质量
+
+命令：
+
+```bash
+node tools/vibe-compact/index.mjs --input docs/phase-2-roadmap.md --max-lines 2
+node tools/vibe-compact/index.mjs --input docs/phase-2-roadmap.md --max-lines 2 --format markdown
+```
+
+期望：
+
+- 默认 text 输出保持原结构。
+- markdown 输出包含稳定标题和列表。
+- 空输入返回非 0，并输出 `Error: input is empty.`。
+
+### `vibe-release-check --quiet`
+
+命令：
+
+```bash
+node tools/vibe-release-check/index.mjs --quiet
+```
+
+期望：
+
+- 输出通过/失败摘要。
+- 正常通过时比默认模式更短。
+- 失败时仍输出失败命令的详细信息。
+
+## 第三批验收
+
+第三批人工 smoke 指南增强必须满足：
+
+### 三平台安装后 smoke 流程
+
+期望：
+
+- `docs/install-claude.md` 包含安装后人工 smoke 流程。
+- `docs/install-cursor.md` 包含安装后人工 smoke 流程。
+- `docs/install-codex.md` 包含安装后人工 smoke 流程。
+- 三个平台都说明入口文件、`.vibecoding/skills/`、平台会话和验收 Prompt 的检查顺序。
+- 三个平台都说明期望看到的 workflow 信号。
+
+### 未触发 workflow 的排查入口
+
+期望：
+
+- 三个平台都说明当前打开目录应匹配 `vibe-init --target`。
+- 三个平台都说明入口文件是否存在以及应该包含什么。
+- 三个平台都说明 `.vibecoding/skills/using-vibecoding/SKILL.md` 应存在。
+- 三个平台都说明可以用 `vibe-doctor` 复查安装状态。
+- 三个平台都说明已有入口文件被 skip 时需要手动合并模板内容。
+
+### examples 轻量引用
+
+期望：
+
+- `examples/claude-project/README.md` 指向仓库根目录的 `docs/install-claude.md` 详细 smoke 流程。
+- `examples/cursor-project/README.md` 指向仓库根目录的 `docs/install-cursor.md` 详细 smoke 流程。
+- `examples/codex-project/README.md` 指向仓库根目录的 `docs/install-codex.md` 详细 smoke 流程。
+- examples 不复制大段重复流程。
+
+### 边界
+
+期望：
+
+- 文档只描述人工 smoke，不声称真实 IDE runtime 自动化。
+- 文档不声称存在自动 workflow 调用链、长期 memory 或 codebase index。
+
+## external reference 映射 Skill 验收
+
+第一批对齐 `fork/<external-reference>` 的 skill 粒度增强必须满足：
+
+### 核心 skill 文件
+
+期望：
+
+- `skills/vibe-writing-plans/SKILL.md` 存在，并说明如何把规格拆成可执行任务。
+- `skills/vibe-executing-plans/SKILL.md` 存在，并说明如何按计划逐项执行和验证。
+- `skills/vibe-systematic-debugging/SKILL.md` 存在，并明确未复现不修、未根因不修。
+- `skills/vibe-verification-before-completion/SKILL.md` 存在，并明确没有新鲜证据不得声明完成。
+- 四个 skill 都包含 `Workflow Handoff`、`current_skill`、`next_skill` 和 `stop_condition`。
+
+### 路由与边界
+
+期望：
+
+- `skills/using-vibecoding/SKILL.md` 能把规格拆解、计划执行、系统排查、完成前验证路由到对应 skill。
+- `docs/workflow-chaining.md` 包含新增 skill 的下一跳规则。
+- `CLAUDE.md`、`AGENTS.md`、`templates/CLAUDE.md`、`templates/AGENTS.md` 包含新增 workflow 关键 skill：`vibe-writing-plans`、`vibe-executing-plans`、`vibe-systematic-debugging`、`vibe-verification-before-completion`。
+- `vibe-doctor` 能检查 repo layout 与 installed layout 的入口文件 workflow 是否过期。
+- 默认仍使用显式 `Workflow Handoff`，不启用 runtime 自动调用链。
+- 文档不默认启用 subagent-driven development。
+
+### 行为信号
+
+期望：
+
+- 需要执行计划时，先检查计划是否可执行。
+- 发生异常时，先复现和找根因，再修复。
+- 声称完成前，必须列出当前回合验证证据或明确未验证项。
+
+## external reference 映射第二批 Skill 验收
+
+第二批轻量流程纪律增强必须满足：
+
+### 核心 skill 文件
+
+期望：
+
+- `skills/vibe-brainstorming/SKILL.md` 存在，并说明如何把模糊想法收敛为可规划方向。
+- `skills/vibe-test-driven-development/SKILL.md` 存在，并说明实现前如何定义测试或验证策略。
+- `skills/vibe-finishing-a-development-branch/SKILL.md` 存在，并说明提交、PR、保留或清理前如何确认验证证据和 git 边界。
+- 三个 skill 都包含 `Workflow Handoff`、`current_skill`、`next_skill` 和 `stop_condition`。
+
+### 路由与边界
+
+期望：
+
+- `skills/using-vibecoding/SKILL.md` 能把需求构思、测试纪律和交付收口路由到对应 skill。
+- `docs/workflow-chaining.md` 包含第二批新增 skill 的下一跳规则。
+- `CLAUDE.md`、`AGENTS.md`、`templates/CLAUDE.md`、`templates/AGENTS.md` 包含新增 workflow 关键 skill：`vibe-brainstorming`、`vibe-test-driven-development`、`vibe-finishing-a-development-branch`。
+- `vibe-doctor` 能检查新增 skill、入口文件 workflow marker 和 `docs/workflow-chaining.md` marker。
+- 默认仍使用显式 `Workflow Handoff`，不启用 runtime 自动调用链。
+- 文档不默认启用 subagent-driven development。
+
+### 行为信号
+
+期望：
+
+- 构思任务不能直接实现，必须先明确目标、非目标、方案和确认点。
+- 实现任务需要先说明测试或验证策略。
+- 完成后不能直接声称交付，必须先进入完成前验证，再进入交付收口。
+- 交付收口不能混合 staged / unstaged，不能未经确认提交、推送、合并、清理或删除。
+
+## Review Flow Skill 验收
+
+Review flow 增强必须满足：
+
+### 核心 skill 文件
+
+期望：
+
+- `skills/vibe-requesting-code-review/SKILL.md` 存在，并说明请求 review 前如何整理目标、范围、依据、验证证据和重点风险。
+- `skills/vibe-receiving-code-review/SKILL.md` 存在，并说明接收 feedback 后如何理解、验证、分类、澄清、拒绝或排序修复。
+- 两个 skill 都包含 `Workflow Handoff`、`current_skill`、`next_skill` 和 `stop_condition`。
+
+### 路由与边界
+
+期望：
+
+- `skills/using-vibecoding/SKILL.md` 能把请求 review、合并前审查和处理 review feedback 路由到对应 skill。
+- `docs/workflow-chaining.md` 包含 `vibe-requesting-code-review`、`vibe-review`、`vibe-receiving-code-review` 的下一跳规则。
+- `CLAUDE.md`、`AGENTS.md`、`templates/CLAUDE.md`、`templates/AGENTS.md` 包含新增 workflow 关键 skill：`vibe-requesting-code-review`、`vibe-receiving-code-review`。
+- `vibe-doctor` 能检查新增 skill、入口文件 workflow marker、`using-vibecoding` marker 和 `docs/workflow-chaining.md` marker。
+- `vibe-review` 继续负责审查行为、边界、风险和交付质量，不负责准备 review 请求包，也不负责逐项处置 feedback。
+- 默认仍使用显式 `Workflow Handoff`，不自动派发 reviewer，不实现 PR bot，不启用 MCP review 集成。
+
+### 行为信号
+
+期望：
+
+- 请求 review 前必须明确 review 目标、review 范围、验收依据、当前验证证据、未验证项和重点风险。
+- 不允许声称已经自动派发 reviewer 或已经自动完成 review。
+- 接收 feedback 后必须先理解、验证和分类，不能盲目修复。
+- 不清楚或缺少上下文的 feedback 必须停止并要求澄清。
+- Critical / Important feedback 必须处理，或给出可辩护的技术性拒绝理由。
+
+## Skill Writing 验收
+
+`vibe-writing-skills` 增强必须满足：
+
+### 核心 skill 文件
+
+期望：
+
+- `skills/vibe-writing-skills/SKILL.md` 存在，并说明新增或修改 workflow skill 前如何确认触发场景、职责边界、输入输出、下一跳和同步清单。
+- 该 skill 包含 `Workflow Handoff`、`current_skill`、`next_skill` 和 `stop_condition`。
+- 该 skill 明确不引入 graphviz、skill 自动生成器、subagent 测试或 runtime 编排器。
+
+### 路由与边界
+
+期望：
+
+- `skills/using-vibecoding/SKILL.md` 能把新增、修改或设计 Vibecoding workflow skill 路由到 `vibe-writing-skills`。
+- `docs/workflow-chaining.md` 包含 `vibe-writing-skills` 的流程图和下一跳规则。
+- `CLAUDE.md`、`AGENTS.md`、`templates/CLAUDE.md`、`templates/AGENTS.md` 包含新增 workflow 关键 skill：`vibe-writing-skills`。
+- `vibe-doctor` 能检查新增 skill、入口文件 workflow marker、`using-vibecoding` marker 和 `docs/workflow-chaining.md` marker。
+- 默认仍使用显式 `Workflow Handoff`，不启用 runtime 自动调用链。
+
+### 行为信号
+
+期望：
+
+- 新增 skill 前先判断是否真的需要独立 skill。
+- 修改 skill 前先确认与现有 skill 的职责边界。
+- 新增或修改 skill 后必须检查路由、入口、模板、README、authoring guide、acceptance checklist、release guide 和 doctor 是否需要同步。
+- doctor 只做轻量结构和 marker 检查，不做过严内容审查。
+
+## Parallel Work Dispatch 验收
+
+`vibe-dispatching-parallel-work` 增强必须满足：
+
+### 核心 skill 文件
+
+期望：
+
+- `skills/vibe-dispatching-parallel-work/SKILL.md` 存在，并说明如何判断任务独立性、共享状态、顺序依赖和冲突风险。
+- 该 skill 包含 `Workflow Handoff`、`current_skill`、`next_skill` 和 `stop_condition`。
+- 该 skill 明确不自动调用 subagent、不引入 agent graph、不生成 review package、不替代 `vibe-executing-plans`。
+
+### 路由与边界
+
+期望：
+
+- `skills/vibe-writing-plans/SKILL.md` 能在任务存在独立并行候选时进入 `vibe-dispatching-parallel-work`。
+- `skills/vibe-executing-plans/SKILL.md` 仍保持默认逐项执行入口，不把并行 brief 当作已执行。
+- `docs/workflow-chaining.md` 包含 `vibe-dispatching-parallel-work` 的流程图和下一跳规则。
+- `CLAUDE.md`、`AGENTS.md`、`templates/CLAUDE.md`、`templates/AGENTS.md` 包含新增 workflow 关键 skill：`vibe-dispatching-parallel-work`。
+- `vibe-doctor` 能检查新增 skill、入口文件 workflow marker、`using-vibecoding` marker 和 `docs/workflow-chaining.md` marker。
+
+### 行为信号
+
+期望：
+
+- 新 skill 能区分可并行、必须顺序、需要重新拆分和缺少输入。
+- 新 skill 必须输出每个任务 brief，包括目标、范围、输入证据、禁止修改、依赖、预期输出、验证方式和完成后回报。
+- 用户未明确允许 subagent 时，只输出判断和 brief，不执行分发。
+- doctor 只做轻量结构和 marker 检查，不做过严内容审查。
+
+## Workspace Isolation 验收
+
+`vibe-workspace-isolation` 增强必须满足：
+
+### 核心 skill 文件
+
+期望：
+
+- `skills/vibe-workspace-isolation/SKILL.md` 存在，并说明如何判断可原地工作、建议隔离、已隔离可继续、先收口和信息不足。
+- 该 skill 包含 `Workflow Handoff`、`current_skill`、`next_skill` 和 `stop_condition`。
+- 该 skill 明确不自动创建 worktree、不切换分支、不修改 `.gitignore`、不清理用户变更。
+
+### 路由与边界
+
+期望：
+
+- `skills/using-vibecoding/SKILL.md` 能把大改动、并行任务、风险性重构或分支收口前的隔离判断路由到 `vibe-workspace-isolation`。
+- `skills/vibe-writing-plans/SKILL.md` 能在大范围改动或当前工作区污染风险出现时建议进入 `vibe-workspace-isolation`。
+- `skills/vibe-dispatching-parallel-work/SKILL.md` 与 `vibe-workspace-isolation` 职责清楚：前者判断任务并行边界，后者判断工作区隔离边界。
+- `docs/workflow-chaining.md` 包含 `vibe-workspace-isolation` 的流程图和下一跳规则。
+- `CLAUDE.md`、`AGENTS.md`、`templates/CLAUDE.md`、`templates/AGENTS.md` 包含新增 workflow 关键 skill：`vibe-workspace-isolation`。
+- `vibe-doctor` 能检查新增 skill、入口文件 workflow marker、`using-vibecoding` marker 和 `docs/workflow-chaining.md` marker。
+
+### 行为信号
+
+期望：
+
+- 当前未提交变更必须被视为隔离判断输入，不被忽略。
+- 建议隔离时必须停止等待用户确认，不自动创建或切换工作区。
+- 当前已经处于可接受隔离环境时，不重复建议创建新 worktree。
+- 当前工作区有未收口变更时，建议进入 `vibe-finishing-a-development-branch`。
+- doctor 只做轻量结构和 marker 检查，不做过严内容审查。
+
+## Subagent Driven Development Gate 验收
+
+`vibe-subagent-driven-development` 增强必须满足：
+
+### 核心 skill 文件
+
+期望：
+
+- `skills/vibe-subagent-driven-development/SKILL.md` 存在，并说明如何判断建议 subagent、回退顺序执行、重新拆分和等待确认。
+- 该 skill 包含 `Workflow Handoff`、`current_skill`、`next_skill` 和 `stop_condition`。
+- 该 skill 明确不自动调用 subagent、不选择模型、不生成 review package、不维护 runtime。
+
+### 路由与边界
+
+期望：
+
+- `skills/using-vibecoding/SKILL.md` 能把独立任务 brief 完整且用户明确允许 subagent 的场景路由到 `vibe-subagent-driven-development`。
+- `skills/vibe-dispatching-parallel-work/SKILL.md` 与 `vibe-subagent-driven-development` 职责清楚：前者产出并行边界和任务 brief，后者检查 subagent 执行 gate。
+- `skills/vibe-workspace-isolation/SKILL.md` 与 `vibe-subagent-driven-development` 职责清楚：前者判断工作区安全，后者判断执行方式。
+- `skills/vibe-executing-plans/SKILL.md` 仍是未使用 subagent 时的默认顺序执行路径。
+- `docs/workflow-chaining.md` 包含 `vibe-subagent-driven-development` 的条件链路和下一跳规则。
+- `CLAUDE.md`、`AGENTS.md`、`templates/CLAUDE.md`、`templates/AGENTS.md` 包含新增 workflow 关键 skill：`vibe-subagent-driven-development`。
+- `vibe-doctor` 能检查新增 skill、入口文件 workflow marker、`using-vibecoding` marker 和 `docs/workflow-chaining.md` marker。
+
+### 行为信号
+
+期望：
+
+- 用户未明确允许 subagent 时，不建议自动执行或派发。
+- brief 不完整时，回到 `vibe-dispatching-parallel-work` 或 `vibe-writing-plans`。
+- 工作区边界未确认时，进入 `vibe-workspace-isolation`。
+- 平台不支持或任务强耦合时，回退 `vibe-test-driven-development` 或 `vibe-executing-plans`。
+- 文档不声称自动选择模型、生成 review package、调用平台工具或维护进度 runtime。
+- doctor 只做轻量结构和 marker 检查，不做过严内容审查。
+
+## Hook 辅助自动化验收
+
+Hook 辅助自动化必须满足：
+
+### 核心 hook 文件
+
+期望：
+
+- `hooks/session-start/session-start.md` 提醒选择 workflow、检查目标、范围、风险、验收和 `next_skill`。
+- `hooks/workflow-handoff/workflow-handoff.md` 提醒阶段结束后检查 `Workflow Handoff`。
+- `hooks/workflow-handoff/README.md` 明确该 hook 只是提示模板，不是 runtime 编排器。
+- `hooks/post-tool-compact/README.md` 说明长输出后的显式压缩路径。
+
+### 平台 hook 示例
+
+期望：
+
+- `adapters/cursor/hooks.example.json` 包含 session-start 与 handoff 提示。
+- `adapters/codex/hooks.example.json` 包含 session-start 与 handoff 提示。
+- Claude 适配文档说明通过 `CLAUDE.md` 和 skill 提示显式处理 `next_skill`。
+
+### 边界
+
+期望：
+
+- 文档不声称自动执行下一个 skill。
+- 文档不声称自动调用工具。
+- 文档不声称维护 runtime 状态机。
+- `next_skill` 仍被描述为显式建议。
+
+## Runtime Contract 与只读检查器验收
+
+命令：
+
+```bash
+node tools/vibe-runtime-check/index.mjs
+```
+
+期望：
+
+- 输出 `Vibecoding Runtime Check`。
+- 输出 `Result: passed`。
+- 检查 `docs/runtime-roadmap.md`、`docs/runtime-contract.md` 和 `docs/workflow-chaining.md`。
+- 检查 workflow skill 的 `下一步调用`、`Workflow Handoff`、`current_skill`、`next_skill`、`handoff` 和 `stop_condition` marker。
+- 不生成 `.vibecoding-state/`。
+- 不修改 skill、docs、入口文件或业务项目文件。
+- 不自动执行 `next_skill`。
+- 不调用 subagent，不创建 worktree，不执行 git 写入，不安装依赖。
+- 不引入 MCP、agent graph、daemon 或后台 worker。
+- Stage 9 `execute --from-dispatch` 只允许 preflight / dry-run 预览或 confirm 后写入 `.vibecoding-state/executions/` execution envelope。
+- `execute --from-dispatch --preflight` 必须只读输出 dispatch、claim、target allowlist、stop condition、task readiness、review gate 和 write boundary，不创建 execution file。
+- `execute --from-dispatch --confirm --actor` 必须校验 dispatch event、claim、actor 和 picked 状态，不执行 workflow skill，不调用平台 API，不触碰 git / worktree，并记录 policy snapshot 与 stable `idempotency_key`。
+- Stage 10 `daemon --dry-run` 只预览 once-run gate；`daemon --scan --dry-run` 只读输出 candidates、blocked items、stale claims、stale running executions、retry preview、lock / lease contract 和 watcher disabled；`daemon --once --confirm` 只写 `.vibecoding-state/daemon-runs/` daemon run envelope，并记录 scan no-op、scheduler policy dry-run、lock、lease 和 heartbeat contract。
+- daemon 默认关闭，不启动 long-running worker / watcher，不扫描并执行 dispatches，不调用 `execute`，不 pickup claim，不自动 retry，不执行 workflow skill，不触碰 git / worktree。
+- Stage 8 pickup contract 必须提供 readiness、pickup verification、platform capability matrix、no-session adapter dry-run、`pickup-dry-run` marker 和 `handoff_sha256` handoff digest。
+- Stage 10 daemon envelope 必须提供 `heartbeat_started` contract，确认 scan/no-op/lease 分支不会启动 heartbeat 或 watcher。
+
+## 平台人工 smoke 检查
+
+第一阶段不做真实 IDE runtime 自动化，仅做最小人工检查。
+
+### Claude
+
+在安装后的目标项目中确认：
+
+- 根目录存在 `CLAUDE.md`。
+- `CLAUDE.md` 包含 `.vibecoding/skills/`。
+- `CLAUDE.md` 包含 `using-vibecoding`。
+
+人工 Prompt：
+
+```text
+我想给这个项目加一个新功能，先帮我规划一下。
+```
+
+期望：优先进入 `using-vibecoding`，再进入 `vibe-brainstorming` 或 `vibe-planning`。
+
+### Cursor / Codex
+
+在安装后的目标项目中确认：
+
+- 根目录存在 `AGENTS.md`。
+- `AGENTS.md` 包含 `.vibecoding/skills/`。
+- `AGENTS.md` 包含 workflow 选择规则。
+
+人工 Prompt：
+
+```text
+实现完成了，帮我确认能不能交付。
+```
+
+期望：进入 `vibe-verification-before-completion`，明确当前回合验证证据、未验证项、阻塞、风险和可交付判断；证据充分后建议 `vibe-finishing-a-development-branch`。
+
+## Stage 33 Hook Intent Contract 验收
+
+- `hooks --catalog --json` 必须只读输出 Stage 33 builtin hook intent catalog，且不创建 `.vibecoding-state/`。
+- `hooks --preview --json` 必须只读输出 hook intent envelope，固定 `allowed_followup` 包含 `scheduler-plan-only`，并且 `safety.writes=false`、`safety.scheduler_plan=false`、`safety.subagent_dispatch=false`、`safety.platform_api=false`。
+- `hooks --preview --confirm --json` 只允许写 `.vibecoding-state/hook-intents/*.hook-intent.json`，不得触发 scheduler、不得派发 subagent、不得创建 session、不得调用平台 API。
+- `hooks --verify <hook-intent-file> --json` 必须校验 intent digest、catalog digest、source digest、workflow digest 和 safety boundary。
+- tampered hook intent 中 `subagent_dispatch=true`、`scheduler_execution=true`、`platform_api=true`、bad digest 或路径穿越必须失败且不写其他状态。
+
+## Stage 34 Scheduler Plan from Hook 验收
+
+- `scheduler --from-hook <hook-intent-file> --plan --json` 必须只读生成 Stage 34 hook-derived scheduler plan，且不创建 `.vibecoding-state/scheduler-hook-plans/`。
+- `scheduler --from-hook <hook-intent-file> --plan --confirm --json` 只允许写 `.vibecoding-state/scheduler-hook-plans/*.scheduler-hook-plan.json`，不得创建 scheduler lease/run、不得执行 queue item、不得派发 subagent、不得创建 session、不得调用平台 API。
+- `scheduler --verify <scheduler-hook-plan-file> --json` 必须校验 hook intent digest、plan digest、queue summary、budget、required approvals 和 safety boundary。
+- hook intent drift、`runtime_action_allowed=true`、`subagent_dispatch_allowed=true`、`scheduler_run=true`、bad digest 或路径穿越必须失败且不写其他状态。
+
+## Stage 35 Subagent Dispatch Eligibility Gate 验收
+
+- `subagents --eligibility --task <task-id> --json` 必须只读评估 Stage 35 subagent eligibility gate，且不创建 `.vibecoding-state/subagent-eligibility/`。
+- `subagents --eligibility --task <task-id> --confirm --json` 只允许写 `.vibecoding-state/subagent-eligibility/*.subagent-eligibility.json`，不得派发 subagent、不得创建 session、不得运行 scheduler、不得调用平台 API。
+- `subagents --verify <eligibility-file> --json` 必须校验 task digest、workflow digest、gate evidence、gate catalog、allowed followup 和 safety boundary。
+- task drift、workflow drift、gate evidence drift、`subagent_dispatch=true`、`session_create=true`、bad digest 或路径穿越必须失败且不写其他状态。
+
+## Stage 36 Approved Subagent Dispatch Artifact 验收
+
+- `subagents --dispatch --from-plan <scheduler-hook-plan-file> --eligibility <eligibility-file> --confirm --json` 只允许写 `.vibecoding-state/subagent-dispatches/*.subagent-dispatch.json`。
+- Stage 36 不得创建 session、不得调用平台 API、不得运行 scheduler、不得执行 subagent、不得写 git/worktree/业务源码。
+- `subagents --verify <subagent-dispatch-file> --json` 必须校验 scheduler hook plan digest、eligibility digest、task brief digest、workflow digest、methodology gate digest、approval policy digest、capability matrix digest 和 safety boundary。
+- scheduler plan drift、eligibility drift、`no_session_create=false`、`no_subagent_run=false`、`subagent_dispatch=true`、bad digest 或路径穿越必须失败且不写其他状态。
+
+## Stage 37 Single-shot Agent Scheduler Run 验收
+
+- `subagents --run --from-dispatch <subagent-dispatch-file> --confirm --json` 只允许一次性写 `.vibecoding-state/scheduler-runs/*.subagent-scheduler-run.json`、`.vibecoding-state/subagent-run-leases/*.subagent-lease.json` 和 `.vibecoding-state/subagent-run-results/*.subagent-run-result.json`。
+- Stage 37 必须前台、单次、每次一个 dispatch；不得启动 watcher/daemon、不得创建真实 session、不得调用平台 API、不得调用模型、不得写 git/worktree/业务源码。
+- `subagents --verify <subagent-scheduler-run-file|subagent-lease-file|subagent-run-result-file> --json` 必须校验 dispatch digest、run digest、lease digest、result digest、policy digest、budget/lease/approval flags 和 safety boundary。
+- dispatch drift、policy drift、`session_created=true`、`platform_api=true`、`actual_subagent_session=true`、`business_source_write=true`、`watcher=true`、bad digest 或路径穿越必须失败且不写其他状态。
+
+## 行为验收一：规划
+
+Prompt：
+
+```text
+我想给这个项目加一个新功能，先帮我规划一下。
+```
+
+期望：
+
+- 不直接写代码。
+- 进入 `vibe-brainstorming` 或 `vibe-planning`。
+- 输出目标、范围、模块、流向、实施顺序、验收标准。
+
+## 行为验收二：排查
+
+Prompt：
+
+```text
+这个功能不工作，帮我排查。
+```
+
+期望：
+
+- 不直接乱改。
+- 先明确现象和复现证据。
+- 进入 `vibe-systematic-debugging`。
+- 输出复现、范围、根因、修复和验证方式。
+
+## 行为验收三：验证
+
+Prompt：
+
+```text
+实现完成了，帮我确认能不能交付。
+```
+
+期望：
+
+- 进入 `vibe-verification-before-completion`。
+- 明确当前回合验证证据和未验证项。
+- 明确阻塞、风险和可交付判断。
+
+## 失败标准
+
+出现以下情况视为未通过第一阶段验收：
+
+- agent 在规划任务中直接实现。
+- agent 在 bug 任务中无证据猜测并大范围修改。
+- agent 在验证任务中声称运行了未运行的检查。
+- adapters 指向的 `skills/` 路径不清晰。
+- skill 没有触发条件或输出结构。