cc-devflow 4.5.11 → 4.5.12

package/.claude/skills/cc-spec-init/PLAYBOOK.md

@@ -1,55 +1,19 @@
 # CC-Spec-Init Playbook
 
-## Core Rules
+## Role
 
-1. 先定 capability 边界，再写 spec 文本。
-2. `spec` 记录现状，`roadmap` 记录未来，`change-meta` 记录桥接。
-3. 同一个 change 可以多挂 capability，但只能有一个 primary capability。
-4. 正常演化优先 `deprecated` / `merged` / `split`，不要直接物理删除。
-5. 每次变更结束都跑链接校验，别把断链留到下轮执行。
+Specs record current capability truth. Roadmap records future work. Git records process history.
 
-## Standard Modes
+## Flow
 
-### Bootstrap
+1. Read existing `devflow/specs/INDEX.md`.
+2. Read related capability specs.
+3. Decide whether the work is bootstrap, create, split, merge, deprecate, or language cleanup.
+4. Update spec Markdown only.
+5. Commit the spec change.
 
-- 建 `devflow/specs/INDEX.md`
-- 建 `devflow/specs/capabilities/`
-- 为当前最重要的 capability 建最小 truth source
+## Do Not
 
-### Create
-
-- 新 capability spec
-- 回写 `INDEX.md`
-- 为当前 change 生成 `change-meta.json`
-
-### Update Links
-
-- 修 roadmap / backlog / change / spec 的 capability 引用
-- 重建 `INDEX.md`
-
-### Split / Merge / Deprecate
-
-- 在原 capability spec 标明状态变化
-- 补 `splitInto` / `mergedInto` / `supersededBy`
-- 确认历史 change 仍然可追踪
-
-## Command Kit
-
-```bash
-# 初始化 specs 目录
-bash .claude/skills/cc-spec-init/scripts/bootstrap-specs.sh
-
-# 校验 spec 链路
-bash .claude/skills/cc-spec-init/scripts/validate-spec-links.sh
-
-# 看哪些 change 已缺 change-meta
-find devflow/changes -maxdepth 2 -name change-meta.json | sort
-```
-
-## Review Questions
-
-1. capability 的边界是否清楚到 AI 不会把别的系统能力写进来？
-2. `Current Truth` 是否只写当前成立的承诺？
-3. `Missing` 和 `Intentional Gaps` 是否被保留下来？
-4. roadmap item 和 change 是否都能指向 capability？
-5. 这次是该 `update`，还是其实应该 `split` / `merge`？
+- Do not create change-scoped JSON.
+- Do not store workflow state in specs.
+- Do not turn one requirement's implementation detail into capability truth.

package/.claude/skills/cc-spec-init/SKILL.md

@@ -1,148 +1,45 @@
 ---
 name: cc-spec-init
-version: 1.1.0
-description: Use when you need to initialize capability specs under `devflow/specs/`, create or evolve capability truth sources, generate `change-meta.json`, or validate roadmap/change/spec links before roadmap, planning, or closeout work continues.
+version: 1.2.0
+description: Use when you need to initialize or evolve capability specs under `devflow/specs/`.
+reads:
+  - PLAYBOOK.md
+  - references/spec-contract.md
+  - assets/INDEX_TEMPLATE.md
+  - assets/CAPABILITY_TEMPLATE.md
+writes:
+  - path: devflow/specs/INDEX.md
+    durability: durable
+    required: false
+  - path: devflow/specs/capabilities/<capability>.md
+    durability: durable
+    required: false
+effects:
+  - capability truth source initialization or update
+  - Git commit after spec work completes
 ---
 
 # CC-Spec-Init
 
-> [PROTOCOL]: 变更时同步更新 `version`、`CHANGELOG.md`、相关模板/脚本引用，然后检查 `CLAUDE.md`
+`cc-spec-init` maintains long-lived capability specs. It is not a process-state generator.
 
-## Role
-
-`cc-spec-init` 是 capability-centered spec 的收口器。
-
-它只做一件事：把系统“当前承诺什么”收成稳定 truth source，并把 `roadmap -> change -> spec` 的链接补齐。
-
-它不是主 workflow 的一环。
-
-主 workflow 仍然是：
-
-- `cc-roadmap`
-- `cc-plan` 或 `cc-investigate`
-- `cc-do`
-- `cc-check`
-- `cc-act`
-
-`cc-spec-init` 负责这些动作：
-
-- 初始化 `devflow/specs/`
-- 新建 capability spec
-- 对 capability 做 `split` / `merge` / `deprecate`
-- 生成或修复 `devflow/changes/<change-key>/change-meta.json`
-- 重建 `devflow/specs/INDEX.md`
-- 校验 capability、roadmap item、change 之间的链接完整性
-
-## Runtime Output Policy
-
-写入任何 durable Markdown 或 JSON metadata 前，先运行 `cc-devflow config resolve --format policy`。
-
-- `Output language` 是机器约束，capability spec、`devflow/specs/INDEX.md` 和 `change-meta.json` 必须记录并遵守它。
-- `agent_preferences` 是用户偏好建议，只影响表达方式和结构选择，不覆盖本 Skill 的工作流边界。
-- 如果配置解析失败，先修配置或向用户说明阻塞，不要用默认语言继续生成正式文档。
-
-## Read First
-
-1. `PLAYBOOK.md`
-2. `CHANGELOG.md`
-3. `references/spec-contract.md`
-4. `assets/INDEX_TEMPLATE.md`
-5. `assets/CAPABILITY_TEMPLATE.md`
-6. `assets/CHANGE_META_TEMPLATE.json`
-
-## Use This Skill When
-
-- 你第一次把仓库升级到 capability-centered spec 模型
-- 需要创建新 capability spec
-- 需要把 change 绑定到 primary / secondary capability
-- 需要做 capability 的 `split` / `merge` / `deprecate`
-- `cc-roadmap`、`cc-plan`、`cc-act` 发现 spec 链路断了
-- 需要在 closeout 前确认 spec/roadmap/change 仍然同构
-
-如果当前工作只是执行一个已冻结任务，不要停在这里，回主 workflow。
-
-## Entry Gate
-
-1. 先读现有 `devflow/specs/INDEX.md`、相关 capability spec、相关 `devflow/ROADMAP.md` / `devflow/BACKLOG.md`、相关 `change-meta.json`。
-2. 先判断你是在做 `bootstrap`、`create`、`update-links`、`split`、`merge` 还是 `deprecate`。
-3. 先锁定 capability 边界，再写模板；不要先写 prose 再猜结构。
-4. 先明确 primary capability，再允许 secondary capabilities 存在。
-5. 先检查命名是否已经有 canonical term；同义词、歧义词和关系约束没收口前，不要新建第二套 capability 名称。
-
-## Session Protocol
-
-1. 先判断现状：
-   - `devflow/specs/` 是否已存在
-   - capability 是否已存在
-   - 相关 change 是否已有 `change-meta.json`
-2. 如果是首次初始化：
-   - 创建 `devflow/specs/INDEX.md`
-   - 创建 `devflow/specs/capabilities/`
-   - 为当前已知 capability 写最小 spec
-3. 如果是新 capability：
-   - 先写 capability 边界、约束、当前 truth、gaps
-   - 再写最小 language block：canonical term、definition、aliases to avoid、relationships、flagged ambiguities
-   - 再登记到 `INDEX.md`
-4. 如果是 change 绑定：
-   - 生成或更新 `change-meta.json`
-   - 填入 `primaryCapability`、`secondaryCapabilities`、`expectedDelta`、`affectedInvariants`、`gapsClosed`、`newGaps`
-5. 如果是 capability 结构调整：
-   - 优先 `deprecated` / `mergedInto` / `splitInto`
-   - 不要直接物理删除，除非确认没有 roadmap/change 仍在引用
-6. 结束前运行链接校验，确认：
-   - `INDEX.md` 引到的 capability 文件都存在
-   - `change-meta.json` 里的 capability 都能落到 spec
-   - roadmap / backlog 里的 capability 引用仍可追踪
-   - 新 capability 的名称、aliases、relationships 没有和已有 spec 冲突
-
-## Language Boundary Gate
-
-capability spec 是长期 truth source，命名必须比一次需求更稳定：
-
-- canonical term：只选一个主名，优先沿用 roadmap、历史 design/analysis、代码公共接口和用户领域语言里已经稳定的词。
-- aliases to avoid：记录容易混用的别名，说明为什么不能继续用。
-- flagged ambiguity：同一个词指向两个概念时，必须写清拆分边界，必要时拆 capability。
-- relationships：用一句话写清 capability 之间的拥有、依赖、生命周期、输入输出或互斥关系。
-- implementation names：类名、文件名、函数名只有在它们已经是公共领域语言时才进入 spec；否则留在 change 设计里。
-
-## Output
+Allowed outputs:
 
 - `devflow/specs/INDEX.md`
 - `devflow/specs/capabilities/<capability>.md`
-- `devflow/changes/<change-key>/change-meta.json`
-- 链接校验结果
-
-## Working Rules
 
-1. `spec` 写现状，不写一次性推导过程。
-2. `roadmap` 写未来推进，不写当前 truth。
-3. `change-meta.json` 是机器真相源；capability markdown 是人机共读的长期约束源。
-4. 一个 change 可以挂多个 capability，但必须有一个 `primaryCapability`。
-5. capability 不直接硬删除；优先用状态表达历史连续性。
-6. `INDEX.md` 只做目录和状态总览，不复制各 spec 正文。
+Do not create change-scoped JSON. Changes link to specs through `task.md`, roadmap text, PR text, and Git commits.
 
-## Bundled Resources
+## Use This Skill When
 
-- 变更记录：`CHANGELOG.md`
-- 使用剧本：`PLAYBOOK.md`
-- 契约：`references/spec-contract.md`
-- 模板：`assets/INDEX_TEMPLATE.md`
-- 模板：`assets/CAPABILITY_TEMPLATE.md`
-- 模板：`assets/CHANGE_META_TEMPLATE.json`
-- 初始化：`scripts/bootstrap-specs.sh`
-- 校验：`scripts/validate-spec-links.sh`
+- initializing `devflow/specs/`
+- creating a capability spec
+- splitting, merging, or deprecating a capability
+- clarifying canonical project language
 
 ## Exit Criteria
 
-- `devflow/specs/` 已建立或已修复
-- 相关 capability spec 有明确边界、约束、truth、gaps
-- 相关 change 已有 `change-meta.json`
-- `INDEX.md`、roadmap、change、spec 之间的链接可追踪
-- 下一步可以安心回到 `cc-roadmap`、`cc-plan` 或 `cc-act`
-
-## Do Not
-
-- 不把 roadmap 写回 spec
-- 不把执行细节写成 capability truth
-- 不允许没有 primary capability 的多 capability change
-- 不直接删 capability 文件导致链路断裂
+- capability boundary is clear
+- current truth and gaps are written
+- `INDEX.md` links to existing capability files
+- spec changes are committed to Git

package/.claude/skills/cc-spec-init/references/spec-contract.md

@@ -1,22 +1,13 @@
 # Spec Contract
 
-## Truth Layers
+## Files
 
-- `devflow/ROADMAP.md` / `devflow/BACKLOG.md`: 未来推进什么 capability
-- `devflow/specs/INDEX.md`: capability 总目录与当前状态快照
-- `devflow/specs/capabilities/*.md`: 某个 capability 当前承诺什么
-- `devflow/changes/<change>/change-meta.json`: 某次 change 如何影响 capability
+- `devflow/specs/INDEX.md`
+- `devflow/specs/capabilities/<capability>.md`
 
-## Capability Rules
+## Rules
 
-1. 以用户可感知能力为主，内部系统能力为辅。
-2. `Boundary`、`Invariants`、`Current Truth` 是核心，不要被 narrative 淹没。
-3. `Missing` 与 `Intentional Gaps` 必须长期保留。
-4. capability 名称要稳定、可重用，不要按一次需求命名。
-
-## Change Meta Rules
-
-1. `primaryCapability` 必填。
-2. `secondaryCapabilities` 可空，但必须有明确原因。
-3. `changeType` 只使用：`create`、`update`、`split`、`merge`、`deprecate`。
-4. `syncStatus` 生命周期：`planned -> verified -> synced`。
+- Specs describe stable capability truth.
+- Specs do not track per-change state.
+- Per-change decisions live in `task.md`, PR text, commits, or postmortems.
+- Capability names must follow project language and avoid duplicate terms.

package/CHANGELOG.md

@@ -9,6 +9,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [4.5.12] - 2026-05-13
+
+### Changed
+
+- Changed `cc-devflow task-contract` so task document budgets are advisory warnings instead of blocking validation failures.
+- Changed `npm run benchmark:skills` so skill entrypoint budgets report advisory failures without failing `npm run verify`.
+- Updated `cc-plan` and `cc-investigate` to preserve required task-template fields instead of trimming contract truth to fit token estimates.
+
+### Fixed
+
+- Fixed `task-contract compile` so shorthand task checklists fail before `task-manifest.json` or `change-meta.json` can be generated.
+- Added task-template validation to reject incomplete task blocks with `C11` instead of letting default manifest enrichment hide missing contract fields.
+
 ## [4.5.11] - 2026-05-13
 
 ### Added

package/bin/cc-devflow-cli.js

@@ -60,8 +60,6 @@ Commands:
   config doctor       Validate config and local ignore safety
   query list          List typed runtime query ids
   query <id>          Run a typed runtime query as JSON
-  task-contract       Compile task contract artifacts
-  review              Record durable review ledger events
   next-change-key     Compute the next REQ/FIX change key
   archive-change      Archive a completed change to devflow/changes/archive/YYYY-MM/
   restore-change      Restore an archived change back to devflow/changes/
@@ -115,11 +113,7 @@ Examples:
   cc-devflow config set output.document_language zh-CN --user
   cc-devflow config resolve --cwd /path/to/project --format policy
   cc-devflow query list
-  cc-devflow query ship-readiness --cwd /path/to/project --change REQ-123
   cc-devflow query workflow-context --cwd /path/to/project --change REQ-123 --change-key REQ-123-my-feature --data-only --no-trace --compact
-  cc-devflow query progress --change REQ-123 --change-key REQ-123-my-feature
-  cc-devflow task-contract compile --cwd /path/to/project --change REQ-123 --change-key REQ-123-my-feature
-  cc-devflow review start --cwd /path/to/project --change REQ-123 --change-key REQ-123-my-feature --base-sha abc --head-sha def
 `);
 }
 
@@ -183,6 +177,9 @@ function copyManagedDirectory(src, dest, options = {}) {
   const stats = fs.statSync(src);
   if (stats.isDirectory()) {
     fs.mkdirSync(dest, { recursive: true });
+    if (force) {
+      pruneManagedDirectory(src, dest);
+    }
     const entries = fs.readdirSync(src);
     for (const entry of entries) {
       copyManagedDirectory(path.join(src, entry), path.join(dest, entry), options);
@@ -212,6 +209,23 @@ function copyManagedDirectory(src, dest, options = {}) {
   }
 }
 
+function pruneManagedDirectory(src, dest) {
+  if (!fs.existsSync(dest) || !fs.statSync(dest).isDirectory()) {
+    return;
+  }
+
+  const sourceEntries = new Set(fs.readdirSync(src));
+  for (const entry of fs.readdirSync(dest)) {
+    if (sourceEntries.has(entry)) {
+      continue;
+    }
+
+    const targetPath = path.join(dest, entry);
+    fs.rmSync(targetPath, { recursive: true, force: true });
+    console.log(`[DELETE] ${path.relative(process.cwd(), targetPath)}`);
+  }
+}
+
 function syncDistributedSkills(targetRoot, options = {}) {
   const { force = false } = options;
   const targetClaudeDir = path.join(targetRoot, '.claude');
@@ -540,252 +554,6 @@ async function runQueryCommand(args) {
   return result.ok ? 0 : 2;
 }
 
-async function runTaskContractCommand(args) {
-  const [subcommand, ...rest] = args;
-
-  if (!subcommand || subcommand === '--help' || subcommand === '-h') {
-    console.error('Use: cc-devflow task-contract <compile|validate|migrate> --change <changeId> [--change-key <key>] [--cwd <path>] [--fold-design] [--fold-analysis]');
-    return 3;
-  }
-
-  const options = parseChangeScopedArgs(rest);
-  if (!options.changeId) {
-    console.error('task-contract --change is required.');
-    return 3;
-  }
-
-  if (subcommand === 'compile' || subcommand === 'validate' || subcommand === 'migrate') {
-    const {
-      runCompile,
-      runValidate,
-      runMigrate
-    } = require(path.join(PACKAGE_ROOT, 'lib/skill-runtime/operations/task-contract.js'));
-    const runners = {
-      compile: runCompile,
-      validate: runValidate,
-      migrate: runMigrate
-    };
-    const runner = runners[subcommand];
-    const result = await runner({
-      repoRoot: path.resolve(options.cwd || process.cwd()),
-      changeId: options.changeId,
-      changeKey: options.changeKey,
-      foldDesign: options.rest.includes('--fold-design'),
-      foldAnalysis: options.rest.includes('--fold-analysis')
-    });
-    if (result.code !== 0) {
-      console.error(result.stderr || result.error || `task-contract ${subcommand} failed`);
-      return result.code;
-    }
-    process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
-    return result.code;
-  }
-
-  console.error(`Unknown task-contract command: ${subcommand}`);
-  return 3;
-}
-
-function parseReviewStartArgs(args) {
-  const scoped = parseChangeScopedArgs(args);
-  const parsed = {
-    ...scoped,
-    mode: 'implementation',
-    scope: 'current-diff',
-    baseSha: 'unknown',
-    headSha: 'unknown',
-    selectedNodes: [],
-    skippedNodes: [],
-    riskLanes: []
-  };
-
-  for (let i = 0; i < scoped.rest.length; i++) {
-    const arg = scoped.rest[i];
-    if (arg === '--mode') { parsed.mode = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--mode=')) { parsed.mode = arg.slice('--mode='.length); continue; }
-    if (arg === '--scope') { parsed.scope = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--scope=')) { parsed.scope = arg.slice('--scope='.length); continue; }
-    if (arg === '--base-sha') { parsed.baseSha = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--base-sha=')) { parsed.baseSha = arg.slice('--base-sha='.length); continue; }
-    if (arg === '--head-sha') { parsed.headSha = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--head-sha=')) { parsed.headSha = arg.slice('--head-sha='.length); continue; }
-    if (arg === '--selected-node') { parsed.selectedNodes.push(scoped.rest[++i]); continue; }
-    if (arg.startsWith('--selected-node=')) { parsed.selectedNodes.push(arg.slice('--selected-node='.length)); continue; }
-    if (arg === '--skipped-node') { parsed.skippedNodes.push(scoped.rest[++i]); continue; }
-    if (arg.startsWith('--skipped-node=')) { parsed.skippedNodes.push(arg.slice('--skipped-node='.length)); continue; }
-    if (arg === '--risk-lane') { parsed.riskLanes.push(scoped.rest[++i]); continue; }
-    if (arg.startsWith('--risk-lane=')) { parsed.riskLanes.push(arg.slice('--risk-lane='.length)); continue; }
-  }
-
-  return parsed;
-}
-
-function parseReviewEventArgs(args) {
-  const scoped = parseChangeScopedArgs(args);
-  const parsed = {
-    ...scoped,
-    reviewId: null,
-    nodeId: null,
-    mode: 'implementation',
-    target: null,
-    status: null,
-    coverage: [],
-    evidenceRefs: [],
-    findings: [],
-    next: null,
-    findingId: null,
-    severity: null,
-    confidence: null,
-    displayTier: null,
-    fingerprint: null,
-    scope: null,
-    path: null,
-    evidence: null,
-    recommendation: null,
-    route: null,
-    blockingCount: null,
-    warningCount: null,
-    output: null
-  };
-
-  for (let i = 0; i < scoped.rest.length; i++) {
-    const arg = scoped.rest[i];
-    if (arg === '--review-id') { parsed.reviewId = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--review-id=')) { parsed.reviewId = arg.slice('--review-id='.length); continue; }
-    if (arg === '--node-id') { parsed.nodeId = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--node-id=')) { parsed.nodeId = arg.slice('--node-id='.length); continue; }
-    if (arg === '--mode') { parsed.mode = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--mode=')) { parsed.mode = arg.slice('--mode='.length); continue; }
-    if (arg === '--target') { parsed.target = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--target=')) { parsed.target = arg.slice('--target='.length); continue; }
-    if (arg === '--status') { parsed.status = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--status=')) { parsed.status = arg.slice('--status='.length); continue; }
-    if (arg === '--coverage') { parsed.coverage.push(scoped.rest[++i]); continue; }
-    if (arg.startsWith('--coverage=')) { parsed.coverage.push(arg.slice('--coverage='.length)); continue; }
-    if (arg === '--evidence-ref') { parsed.evidenceRefs.push(scoped.rest[++i]); continue; }
-    if (arg.startsWith('--evidence-ref=')) { parsed.evidenceRefs.push(arg.slice('--evidence-ref='.length)); continue; }
-    if (arg === '--finding') { parsed.findings.push(scoped.rest[++i]); continue; }
-    if (arg.startsWith('--finding=')) { parsed.findings.push(arg.slice('--finding='.length)); continue; }
-    if (arg === '--next') { parsed.next = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--next=')) { parsed.next = arg.slice('--next='.length); continue; }
-    if (arg === '--finding-id') { parsed.findingId = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--finding-id=')) { parsed.findingId = arg.slice('--finding-id='.length); continue; }
-    if (arg === '--severity') { parsed.severity = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--severity=')) { parsed.severity = arg.slice('--severity='.length); continue; }
-    if (arg === '--confidence') { parsed.confidence = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--confidence=')) { parsed.confidence = arg.slice('--confidence='.length); continue; }
-    if (arg === '--display-tier') { parsed.displayTier = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--display-tier=')) { parsed.displayTier = arg.slice('--display-tier='.length); continue; }
-    if (arg === '--fingerprint') { parsed.fingerprint = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--fingerprint=')) { parsed.fingerprint = arg.slice('--fingerprint='.length); continue; }
-    if (arg === '--scope') { parsed.scope = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--scope=')) { parsed.scope = arg.slice('--scope='.length); continue; }
-    if (arg === '--path') { parsed.path = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--path=')) { parsed.path = arg.slice('--path='.length); continue; }
-    if (arg === '--evidence') { parsed.evidence = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--evidence=')) { parsed.evidence = arg.slice('--evidence='.length); continue; }
-    if (arg === '--recommendation') { parsed.recommendation = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--recommendation=')) { parsed.recommendation = arg.slice('--recommendation='.length); continue; }
-    if (arg === '--route') { parsed.route = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--route=')) { parsed.route = arg.slice('--route='.length); continue; }
-    if (arg === '--blocking-count') { parsed.blockingCount = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--blocking-count=')) { parsed.blockingCount = arg.slice('--blocking-count='.length); continue; }
-    if (arg === '--warning-count') { parsed.warningCount = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--warning-count=')) { parsed.warningCount = arg.slice('--warning-count='.length); continue; }
-    if (arg === '--output') { parsed.output = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--output=')) { parsed.output = arg.slice('--output='.length); continue; }
-  }
-
-  return parsed;
-}
-
-async function runReviewCommand(args) {
-  const [subcommand, ...rest] = args;
-
-  if (!subcommand || subcommand === '--help' || subcommand === '-h') {
-    console.error('Use: cc-devflow review start --change <changeId> [--change-key <key>] [--cwd <path>]');
-    return 3;
-  }
-
-  const reviewRunners = {
-    start: null,
-    'record-node': 'runReviewRecordNode',
-    'add-finding': 'runReviewAddFinding',
-    close: 'runReviewClose',
-    render: 'runReviewRender'
-  };
-
-  if (subcommand === 'start') {
-    const options = parseReviewStartArgs(rest);
-    if (!options.changeId) {
-      console.error('review start --change is required.');
-      return 3;
-    }
-
-    const { runReviewStart } = require(path.join(PACKAGE_ROOT, 'lib/skill-runtime/operations/review-records.js'));
-    const result = await runReviewStart({
-      repoRoot: path.resolve(options.cwd || process.cwd()),
-      changeId: options.changeId,
-      changeKey: options.changeKey,
-      mode: options.mode,
-      scope: options.scope,
-      baseSha: options.baseSha,
-      headSha: options.headSha,
-      selectedNodes: options.selectedNodes,
-      skippedNodes: options.skippedNodes,
-      riskLanes: options.riskLanes
-    });
-    process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
-    return result.code;
-  }
-
-  if (reviewRunners[subcommand]) {
-    const options = parseReviewEventArgs(rest);
-    if (!options.changeId) {
-      console.error(`review ${subcommand} --change is required.`);
-      return 3;
-    }
-
-    const runnerName = reviewRunners[subcommand];
-    const runners = require(path.join(PACKAGE_ROOT, 'lib/skill-runtime/operations/review-records.js'));
-    const result = await runners[runnerName]({
-      repoRoot: path.resolve(options.cwd || process.cwd()),
-      changeId: options.changeId,
-      changeKey: options.changeKey,
-      reviewId: options.reviewId,
-      nodeId: options.nodeId,
-      mode: options.mode,
-      target: options.target,
-      status: options.status,
-      coverage: options.coverage,
-      evidenceRefs: options.evidenceRefs,
-      findings: options.findings,
-      next: options.next,
-      findingId: options.findingId,
-      severity: options.severity,
-      confidence: options.confidence,
-      displayTier: options.displayTier,
-      fingerprint: options.fingerprint,
-      scope: options.scope,
-      path: options.path,
-      evidence: options.evidence,
-      recommendation: options.recommendation,
-      route: options.route,
-      blockingCount: options.blockingCount,
-      warningCount: options.warningCount,
-      output: options.output
-    });
-    if (result.code !== 0) {
-      console.error(result.stderr || result.error || `review ${subcommand} failed`);
-      return result.code;
-    }
-    process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
-    return result.code;
-  }
-
-  console.error(`Unknown review command: ${subcommand}`);
-  return 3;
-}
-
 function runNextChangeKey(args) {
   const parsed = { prefix: null, description: null, cwd: null };
 
@@ -948,14 +716,6 @@ async function main() {
     return runQueryCommand(rest);
   }
 
-  if (command === 'task-contract') {
-    return runTaskContractCommand(rest);
-  }
-
-  if (command === 'review') {
-    return runReviewCommand(rest);
-  }
-
   if (command === 'next-change-key') {
     return runNextChangeKey(rest);
   }

package/bin/cc-devflow.js

@@ -1,16 +1,53 @@
 #!/usr/bin/env node
 
-const AdapterRegistry = require('../lib/adapters/registry');
-const ClaudeAdapter = require('../lib/adapters/claude-adapter');
-const CodexAdapter = require('../lib/adapters/codex-adapter');
-const { validateConfig, getDefaultConfig } = require('../lib/adapters/config-validator');
-const logger = require('../lib/adapters/logger');
-const fs = require('fs');
+const { spawnSync } = require('child_process');
 const path = require('path');
-const yaml = require('js-yaml');
+
+const CLI_BIN = path.resolve(__dirname, 'cc-devflow-cli.js');
+const CLI_COMMANDS = new Set([
+    'help',
+    '--help',
+    '-h',
+    'init',
+    'adapt',
+    'config',
+    'query',
+    'next-change-key',
+    'archive-change',
+    'restore-change',
+    'list-archived'
+]);
+
+function runCli(args) {
+    const result = spawnSync(process.execPath, [CLI_BIN, ...args], {
+        stdio: 'inherit'
+    });
+
+    if (result.error) {
+        console.error(`Failed to run cc-devflow CLI: ${result.error.message}`);
+        return 1;
+    }
+
+    return typeof result.status === 'number' ? result.status : 1;
+}
 
 async function main() {
     try {
+        const cliArgs = process.argv.slice(2);
+        const cliCommand = cliArgs[0];
+
+        if (!cliCommand || CLI_COMMANDS.has(cliCommand)) {
+            process.exit(runCli(cliArgs));
+        }
+
+        const AdapterRegistry = require('../lib/adapters/registry');
+        const ClaudeAdapter = require('../lib/adapters/claude-adapter');
+        const CodexAdapter = require('../lib/adapters/codex-adapter');
+        const { validateConfig, getDefaultConfig } = require('../lib/adapters/config-validator');
+        const logger = require('../lib/adapters/logger');
+        const fs = require('fs');
+        const yaml = require('js-yaml');
+
         // 1. Initialize Registry
         const registry = AdapterRegistry.getInstance();