cc-devflow 4.5.13 → 4.5.15

package/bin/cc-devflow-cli.js

@@ -14,10 +14,6 @@ const {
   setConfigValue,
   writeConfigTemplate
 } = require(path.join(PACKAGE_ROOT, 'lib/skill-runtime/config.js'));
-const {
-  listQueryIds,
-  runQuery
-} = require(path.join(PACKAGE_ROOT, 'lib/skill-runtime/query.js'));
 const ADAPT_BIN = path.join(PACKAGE_ROOT, 'bin', 'adapt.js');
 const ADAPTER_BIN = path.join(PACKAGE_ROOT, 'bin', 'cc-devflow.js');
 const TEMPLATE_IGNORES = new Set(['.DS_Store', 'tsc-cache']);
@@ -58,8 +54,6 @@ Commands:
   config set          Set one project/user/local config value
   config resolve      Print resolved YAML config with key-level trace
   config doctor       Validate config and local ignore safety
-  query list          List typed runtime query ids
-  query <id>          Run a typed runtime query as JSON
   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/
@@ -89,15 +83,6 @@ Config options:
   --trace              Include key-level source trace with policy output
   --force              Overwrite an existing config template
 
-Query options:
-  --cwd <path>         Project path used for devflow artifact lookup
-  --change <id>        Change id, for example REQ-123
-  --change-id <id>     Alias for --change
-  --change-key <key>   Full change key, for example REQ-123-my-feature
-  --data-only          Print only the query data payload when the query succeeds
-  --no-trace           Omit trace metadata from the JSON output
-  --compact            Print minified JSON instead of pretty JSON
-
 Next-change-key options:
   --prefix <REQ|FIX>   Change type prefix (required)
   --description <text> Short description, will be slugified (required)
@@ -112,8 +97,6 @@ Examples:
   cc-devflow config set output.document_language zh-CN --cwd /path/to/project --project
   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 workflow-context --cwd /path/to/project --change REQ-123 --change-key REQ-123-my-feature --data-only --no-trace --compact
 `);
 }
 
@@ -478,82 +461,6 @@ function runConfig(args) {
   return 0;
 }
 
-function parseChangeScopedArgs(args, options = {}) {
-  const { allowQueryFlags = false } = options;
-  const parsed = {
-    cwd: null,
-    changeId: null,
-    changeKey: null,
-    compact: false,
-    dataOnly: false,
-    noTrace: false,
-    rest: []
-  };
-
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-
-    if (arg === '--cwd') { parsed.cwd = args[++i]; continue; }
-    if (arg.startsWith('--cwd=')) { parsed.cwd = arg.slice('--cwd='.length); continue; }
-    if (arg === '--change' || arg === '--change-id') { parsed.changeId = args[++i]; continue; }
-    if (arg.startsWith('--change=')) { parsed.changeId = arg.slice('--change='.length); continue; }
-    if (arg.startsWith('--change-id=')) { parsed.changeId = arg.slice('--change-id='.length); continue; }
-    if (arg === '--change-key') { parsed.changeKey = args[++i]; continue; }
-    if (arg.startsWith('--change-key=')) { parsed.changeKey = arg.slice('--change-key='.length); continue; }
-    if (allowQueryFlags && arg === '--compact') { parsed.compact = true; continue; }
-    if (allowQueryFlags && arg === '--data-only') { parsed.dataOnly = true; continue; }
-    if (allowQueryFlags && arg === '--no-trace') { parsed.noTrace = true; continue; }
-
-    parsed.rest.push(arg);
-  }
-
-  return parsed;
-}
-
-function formatQueryResult(result, options) {
-  let output = result;
-
-  if (options.dataOnly && result.ok) {
-    output = result.data;
-  } else if (options.noTrace && output && typeof output === 'object') {
-    const { trace, ...withoutTrace } = output;
-    output = withoutTrace;
-  }
-
-  return options.compact
-    ? JSON.stringify(output)
-    : JSON.stringify(output, null, 2);
-}
-
-async function runQueryCommand(args) {
-  const [subcommand, ...rest] = args;
-
-  if (!subcommand || subcommand === '--help' || subcommand === '-h') {
-    console.error('Use: cc-devflow query list OR cc-devflow query <id> --change <changeId> [--change-key <key>] [--cwd <path>]');
-    return 3;
-  }
-
-  if (subcommand === 'list') {
-    process.stdout.write(`${listQueryIds().join('\n')}\n`);
-    return 0;
-  }
-
-  const options = parseChangeScopedArgs(rest, { allowQueryFlags: true });
-  if (!options.changeId) {
-    console.error('Query --change is required.');
-    return 3;
-  }
-
-  const result = await runQuery(subcommand, {
-    repoRoot: path.resolve(options.cwd || process.cwd()),
-    changeId: options.changeId,
-    changeKey: options.changeKey
-  });
-
-  process.stdout.write(`${formatQueryResult(result, options)}\n`);
-  return result.ok ? 0 : 2;
-}
-
 function runNextChangeKey(args) {
   const parsed = { prefix: null, description: null, cwd: null };
 
@@ -700,6 +607,12 @@ async function main() {
     return 0;
   }
 
+  if (command.startsWith('-')) {
+    console.error(`Unknown top-level option: ${command}`);
+    console.error('Use: cc-devflow <command> [options]');
+    return 3;
+  }
+
   if (command === 'init') {
     return runInit(rest);
   }
@@ -713,7 +626,8 @@ async function main() {
   }
 
   if (command === 'query') {
-    return runQueryCommand(rest);
+    console.error('cc-devflow query has been removed. Read task.md, Git history/status, and PR or handoff truth directly.');
+    return 3;
   }
 
   if (command === 'next-change-key') {

package/docs/examples/example-bindings.json

@@ -4,13 +4,13 @@
     "cc-roadmap": "5.3.0",
     "cc-next": "1.1.1",
     "cc-dev": "1.1.2",
-    "cc-plan": "3.10.1",
-    "cc-investigate": "1.6.1",
-    "cc-do": "1.7.1",
-    "cc-review": "2.2.0",
+    "cc-plan": "3.10.4",
+    "cc-investigate": "1.6.2",
+    "cc-do": "1.7.2",
+    "cc-review": "2.2.1",
     "cc-pr-review": "1.1.1",
     "cc-pr-land": "1.1.0",
-    "cc-check": "1.12.1",
+    "cc-check": "1.12.2",
     "cc-act": "1.9.1",
     "cc-spec-init": "1.2.0"
   },

package/docs/examples/full-design-blocked/README.md

@@ -4,7 +4,7 @@
 
 - Example version: `1.0.0`
 - Last reviewed: `2026-04-17`
-- Bound skills: `cc-roadmap@5.3.0`, `cc-plan@3.10.1`, `cc-do@1.7.1`, `cc-check@1.12.1`
+- Bound skills: `cc-roadmap@5.3.0`, `cc-plan@3.10.4`, `cc-do@1.7.2`, `cc-check@1.12.2`
 
 This example shows a requirement that **looked executable**, but `cc-check` correctly stopped it and sent it back to `cc-plan`.
 

package/docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/task.md

@@ -4,7 +4,7 @@
 
 - Requirement version: `REQ-002.v2`
 - Design version: `design.v2`
-- CC-Plan skill version: `3.10.1`
+- CC-Plan skill version: `3.10.4`
 - Work branch: `REQ/002-bulk-invite-import`
 - Source roadmap item: `RM-010`
 - Source roadmap version: `roadmap.v2`
@@ -24,6 +24,18 @@
   - Testing decisions: test bulk-import rules, admin upload flow, and audit mapping
   - Out of scope: SCIM provisioning, background jobs, rollback wizard
 - AI Leverage Decision Lens: sharp-wedge; AI can implement this bounded import path fast, but cc-check may still block final proof if row semantics drift
+- Product / Creative Discovery:
+  - Worth doing: admins cannot trust bulk invite outcomes when duplicates, invalid rows, and seat limits mix together.
+  - Desired product shape: every uploaded row gets a predictable visible result before downstream audit behavior matters.
+  - Narrowest wedge: deterministic row classification for the known CSV invite path.
+  - 10x / better version: full provisioning workflow with retry, rollback, and background processing, deferred outside this requirement.
+  - Do-nothing consequence: admins keep reconciling failed imports manually and audit logs remain hard to trust.
+- Second-Move Review:
+  - First good move: implement mixed CSV result rendering directly in the admin panel.
+  - Simpler move: freeze the row-outcome matrix first and reuse the existing invite engine.
+  - Better architecture: later move bulk provisioning into a job-backed import workflow.
+  - Selected move: row classification first, then admin surface and audit mapping.
+  - Rejected tradeoff: no SCIM, background jobs, or rollback wizard in this requirement.
 - Read first:
   - `design.md`
   - `src/admin/BulkInvitePanel.tsx`
@@ -43,8 +55,8 @@
 ClaudeCode / Codex 执行本计划时，必须把本文件当成任务模板合同，而不是普通 TODO 列表。
 
 - Template source: `assets/TASKS_TEMPLATE.md`
-- CLI resolver: all workflow commands must run through `.claude/skills/cc-dev/scripts/resolve-cc-devflow.sh` or `.codex/skills/cc-dev/scripts/resolve-cc-devflow.sh`; if it cannot prove `query workflow-context` and `next-change-key`, stop blocked.
-- Context first: run resolved CLI `query workflow-context --change <changeId> --change-key <changeKey> --cwd <repo-root> --data-only --no-trace --compact` before opening deep sections.
+- CLI resolver: all workflow commands must run through `.claude/skills/cc-dev/scripts/resolve-cc-devflow.sh` or `.codex/skills/cc-dev/scripts/resolve-cc-devflow.sh`; if it cannot prove `next-change-key`, stop blocked.
+- Context first: read this `task.md`, current Git status/history, and PR or handoff truth when present before opening deep sections.
 - Task selection: use `scripts/select-ready-tasks.sh --tasks devflow/changes/<change-key>/task.md`.
 - Task block rule: read the full task block before coding; title-only execution is invalid.
 - Completion rule: after verification and review gates pass, run `scripts/mark-task-complete.sh --tasks devflow/changes/<change-key>/task.md --task <task-id>`.
@@ -55,8 +67,8 @@ DEVFLOW=".claude/skills/cc-dev/scripts/resolve-cc-devflow.sh"
 if [[ ! -f "$DEVFLOW" && -f ".codex/skills/cc-dev/scripts/resolve-cc-devflow.sh" ]]; then
   DEVFLOW=".codex/skills/cc-dev/scripts/resolve-cc-devflow.sh"
 fi
-bash "$DEVFLOW" require query workflow-context next-change-key
-bash "$DEVFLOW" query workflow-context --change <changeId> --change-key <changeKey> --cwd <repo-root> --data-only --no-trace --compactSCRIPT_ROOT=".claude/skills/cc-do/scripts"
+bash "$DEVFLOW" require next-change-key
+SCRIPT_ROOT=".claude/skills/cc-do/scripts"
 if [[ ! -d "$SCRIPT_ROOT" && -d ".codex/skills/cc-do/scripts" ]]; then
   SCRIPT_ROOT=".codex/skills/cc-do/scripts"
 fi

package/docs/examples/local-handoff/README.md

@@ -4,7 +4,7 @@
 
 - Example version: `1.0.0`
 - Last reviewed: `2026-04-17`
-- Bound skills: `cc-roadmap@5.3.0`, `cc-plan@3.10.1`, `cc-do@1.7.1`, `cc-check@1.12.1`, `cc-act@1.9.1`
+- Bound skills: `cc-roadmap@5.3.0`, `cc-plan@3.10.4`, `cc-do@1.7.2`, `cc-check@1.12.2`, `cc-act@1.9.1`
 
 This example shows verified work that is **ready to move forward**, but `cc-act` still chooses `local-handoff`.
 

package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/task.md

@@ -4,7 +4,7 @@
 
 - Requirement version: `REQ-003.v1`
 - Design version: `design.v1`
-- CC-Plan skill version: `3.10.1`
+- CC-Plan skill version: `3.10.4`
 - Work branch: `REQ/003-audit-log-export`
 - Source roadmap item: `RM-020`
 - Source roadmap version: `roadmap.v3`
@@ -24,6 +24,18 @@
   - Testing decisions: test through admin panel action and visible row data
   - Out of scope: JSON export, scheduled reporting, shared reporting backend
 - AI Leverage Decision Lens: boil-lake; complete visible-row CSV export while keeping reporting-platform work outside the lake
+- Product / Creative Discovery:
+  - Worth doing: admins already copy audit summaries into weekly reports by hand.
+  - Desired product shape: download the same visible rows they are reviewing, without a reporting setup flow.
+  - Narrowest wedge: CSV export for currently visible summary rows.
+  - 10x / better version: scheduled reporting and shared report history, deferred outside this requirement.
+  - Do-nothing consequence: weekly reporting stays manual and easy to miscopy.
+- Second-Move Review:
+  - First good move: add a download action to the audit summary panel.
+  - Simpler move: export only visible rows in CSV and avoid backend report storage.
+  - Better architecture: later introduce a reporting backend for scheduled exports.
+  - Selected move: visible-row CSV download from the existing panel.
+  - Rejected tradeoff: no JSON export, scheduling, or shared reporting backend here.
 - Read first:
   - `design.md`
   - `src/admin/AuditSummaryPanel.tsx`
@@ -42,8 +54,8 @@
 ClaudeCode / Codex 执行本计划时，必须把本文件当成任务模板合同，而不是普通 TODO 列表。
 
 - Template source: `assets/TASKS_TEMPLATE.md`
-- CLI resolver: all workflow commands must run through `.claude/skills/cc-dev/scripts/resolve-cc-devflow.sh` or `.codex/skills/cc-dev/scripts/resolve-cc-devflow.sh`; if it cannot prove `query workflow-context` and `next-change-key`, stop blocked.
-- Context first: run resolved CLI `query workflow-context --change <changeId> --change-key <changeKey> --cwd <repo-root> --data-only --no-trace --compact` before opening deep sections.
+- CLI resolver: all workflow commands must run through `.claude/skills/cc-dev/scripts/resolve-cc-devflow.sh` or `.codex/skills/cc-dev/scripts/resolve-cc-devflow.sh`; if it cannot prove `next-change-key`, stop blocked.
+- Context first: read this `task.md`, current Git status/history, and PR or handoff truth when present before opening deep sections.
 - Task selection: use `scripts/select-ready-tasks.sh --tasks devflow/changes/<change-key>/task.md`.
 - Task block rule: read the full task block before coding; title-only execution is invalid.
 - Completion rule: after verification and review gates pass, run `scripts/mark-task-complete.sh --tasks devflow/changes/<change-key>/task.md --task <task-id>`.
@@ -54,8 +66,8 @@ DEVFLOW=".claude/skills/cc-dev/scripts/resolve-cc-devflow.sh"
 if [[ ! -f "$DEVFLOW" && -f ".codex/skills/cc-dev/scripts/resolve-cc-devflow.sh" ]]; then
   DEVFLOW=".codex/skills/cc-dev/scripts/resolve-cc-devflow.sh"
 fi
-bash "$DEVFLOW" require query workflow-context next-change-key
-bash "$DEVFLOW" query workflow-context --change <changeId> --change-key <changeKey> --cwd <repo-root> --data-only --no-trace --compactSCRIPT_ROOT=".claude/skills/cc-do/scripts"
+bash "$DEVFLOW" require next-change-key
+SCRIPT_ROOT=".claude/skills/cc-do/scripts"
 if [[ ! -d "$SCRIPT_ROOT" && -d ".codex/skills/cc-do/scripts" ]]; then
   SCRIPT_ROOT=".codex/skills/cc-do/scripts"
 fi

package/docs/examples/pdca-loop/README.md

@@ -4,7 +4,7 @@
 
 - Example version: `1.0.0`
 - Last reviewed: `2026-04-17`
-- Bound skills: `cc-roadmap@5.3.0`, `cc-plan@3.10.1`, `cc-do@1.7.1`, `cc-check@1.12.1`, `cc-act@1.9.1`
+- Bound skills: `cc-roadmap@5.3.0`, `cc-plan@3.10.4`, `cc-do@1.7.2`, `cc-check@1.12.2`, `cc-act@1.9.1`
 
 This folder shows one minimal but complete `cc-roadmap -> cc-plan -> cc-do -> cc-check -> cc-act` loop.
 

package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/task.md

@@ -4,7 +4,7 @@
 
 - Requirement version: `REQ-001.v1`
 - Design version: `design.v1`
-- CC-Plan skill version: `3.10.1`
+- CC-Plan skill version: `3.10.4`
 - Work branch: `REQ/001-copy-invite-link`
 - Source roadmap item: `RM-001`
 - Source roadmap version: `roadmap.v1`
@@ -25,6 +25,18 @@
   - Testing decisions: test through share dialog behavior
   - Out of scope: invite generation, role controls, analytics, clipboard fallback redesign
 - AI Leverage Decision Lens: boil-lake; complete the bounded same-dialog copy lake instead of stopping at a happy-path button
+- Product / Creative Discovery:
+  - Worth doing: users already have an invite URL but must manually select and copy it.
+  - Desired product shape: one click in the existing dialog, then visible copied confirmation.
+  - Narrowest wedge: copy the currently visible invite URL only.
+  - 10x / better version: richer share workflow with fallback feedback and analytics, deferred outside this requirement.
+  - Do-nothing consequence: users keep making copy mistakes in the most common sharing path.
+- Second-Move Review:
+  - First good move: add a copy button beside the invite URL.
+  - Simpler move: expose only a browser copy action and keep all share-service contracts unchanged.
+  - Better architecture: centralize all share actions behind a richer share command model later.
+  - Selected move: same-dialog copy action with minimal copied-state confirmation.
+  - Rejected tradeoff: no broader share-service redesign in this bounded requirement.
 - Read first:
   - `design.md`
   - `src/features/share/ShareDialog.tsx`
@@ -45,8 +57,8 @@
 ClaudeCode / Codex 执行本计划时，必须把本文件当成任务模板合同，而不是普通 TODO 列表。
 
 - Template source: `assets/TASKS_TEMPLATE.md`
-- CLI resolver: all workflow commands must run through `.claude/skills/cc-dev/scripts/resolve-cc-devflow.sh` or `.codex/skills/cc-dev/scripts/resolve-cc-devflow.sh`; if it cannot prove `query workflow-context` and `next-change-key`, stop blocked.
-- Context first: run resolved CLI `query workflow-context --change <changeId> --change-key <changeKey> --cwd <repo-root> --data-only --no-trace --compact` before opening deep sections.
+- CLI resolver: all workflow commands must run through `.claude/skills/cc-dev/scripts/resolve-cc-devflow.sh` or `.codex/skills/cc-dev/scripts/resolve-cc-devflow.sh`; if it cannot prove `next-change-key`, stop blocked.
+- Context first: read this `task.md`, current Git status/history, and PR or handoff truth when present before opening deep sections.
 - Task selection: use `scripts/select-ready-tasks.sh --tasks devflow/changes/<change-key>/task.md`.
 - Task block rule: read the full task block before coding; title-only execution is invalid.
 - Completion rule: after verification and review gates pass, run `scripts/mark-task-complete.sh --tasks devflow/changes/<change-key>/task.md --task <task-id>`.
@@ -57,8 +69,8 @@ DEVFLOW=".claude/skills/cc-dev/scripts/resolve-cc-devflow.sh"
 if [[ ! -f "$DEVFLOW" && -f ".codex/skills/cc-dev/scripts/resolve-cc-devflow.sh" ]]; then
   DEVFLOW=".codex/skills/cc-dev/scripts/resolve-cc-devflow.sh"
 fi
-bash "$DEVFLOW" require query workflow-context next-change-key
-bash "$DEVFLOW" query workflow-context --change <changeId> --change-key <changeKey> --cwd <repo-root> --data-only --no-trace --compactSCRIPT_ROOT=".claude/skills/cc-do/scripts"
+bash "$DEVFLOW" require next-change-key
+SCRIPT_ROOT=".claude/skills/cc-do/scripts"
 if [[ ! -d "$SCRIPT_ROOT" && -d ".codex/skills/cc-do/scripts" ]]; then
   SCRIPT_ROOT=".codex/skills/cc-do/scripts"
 fi

package/docs/guides/artifact-contract.md

@@ -15,4 +15,4 @@ Git records process history. Commit after each completed PDCA or IDCA environmen
 
 ## Retired Surface
 
-Do not create process JSON, review ledgers, report cards, status files, resume files, release notes, or principle files.
+Do not create process files beyond the durable files above.

package/docs/guides/getting-started.md

@@ -89,7 +89,7 @@ Typical outputs:
 - `cc-spec-init` writes `devflow/specs/INDEX.md` and capability specs
 - `cc-plan` writes `task.md#Contract Summary`
 - `cc-investigate` writes `task.md#Root Cause Contract`
-- `cc-review` reports concrete findings in the response; it does not write review process files
+- `cc-review` writes plan/investigation findings into `task.md`; implementation findings stay in the response until the user chooses a repair option
 - `cc-check` reports verification facts in the response, PR brief, or Git commit
 - `cc-act` writes exactly one final PR file, `handoff/pr-brief.md`, or incident postmortem files when a real incident needs a corpse report
 
@@ -98,8 +98,8 @@ Change truth lives in `devflow/changes/<change>/`.
 
 - Keep `INDEX.md` plus capability markdown under `devflow/specs/`.
 - Name new change directories as `REQ-<number>-<description>` for requirements or `FIX-<number>-<description>` for bug fixes. `REQ` and `FIX` advance as separate local sequences, so cross-prefix duplicates are valid. Parallel worktrees may still repeat numbers; the full change key, especially the description, distinguishes the work. Old lowercase directories are compatibility reads only.
-- Keep `task.md`, optional `handoff/pr-brief.md`, and incident postmortem files under each `devflow/changes/<change>/`. Do not generate task `context.md`, `checkpoint.json`, review ledgers, status/resume files, release notes, principle files, or AI-written process files.
-- Workflow state is Git-owned: keep `task.md`, commit each completed stage, and do not create process JSON.
+- Keep `task.md`, optional `handoff/pr-brief.md`, and Git commits as change truth. Real recurring failures may also write incident postmortems under `devflow/postmortems/`. Do not generate extra process files.
+- Workflow state is Git-owned: keep `task.md`, commit each completed stage, and do not create extra process files.
 - Legacy `planning/design.md`, `planning/analysis.md`, and `cc-review-*.md` are readable fallback inputs for older changes, not new default writes.
 - Worker prompts, journals, assignments, and session logs belong under `devflow/workspaces/<change>/` as ephemeral scratch.
 

package/docs/guides/getting-started.zh-CN.md

@@ -89,7 +89,7 @@ find .codex/skills -mindepth 2 -maxdepth 2 -name SKILL.md | sort
 - `cc-spec-init` 产出 `devflow/specs/INDEX.md` 和 capability spec
 - `cc-plan` 产出 `task.md#Contract Summary`
 - `cc-investigate` 产出 `task.md#Root Cause Contract`
-- `cc-review` 在当前回复里报告具体问题，不写 review 过程文件
+- `cc-review` 把计划 / 调查 finding 写入 `task.md`；执行 finding 留在回复里，等用户选择修复方案后再改代码
 - `cc-check` 在当前回复、PR 文件或 Git commit 里记录验证事实
 - `cc-act` 只产出最终 PR 文件 `handoff/pr-brief.md`；真实事故需要尸检时才产出 incident postmortem 文件
 
@@ -97,8 +97,8 @@ durable truth 分两层：
 
 - `devflow/specs/`：capability 真相，保留 `INDEX.md` 与 `capabilities/*.md`
 - 新 change 目录必须命名为 `REQ-<number>-<description>`（需求）或 `FIX-<number>-<description>`（修复）；`REQ` 和 `FIX` 分别维护自己的递增编号，跨前缀同号不是冲突；并行工作树造成重复编号时，完整 change key 的描述负责区分业务内容，旧小写目录只作为历史兼容读取。
-- `devflow/changes/<change>/`：变更真相，只保留 `task.md`、可选 `handoff/pr-brief.md`，以及真实事故需要的尸检文件。不要生成任务级 `context.md`、`checkpoint.json`、review ledger、status/resume 文件、release note、principles 或 AI 手写过程文件。
-- 流程状态归 Git：保留 `task.md`，每个完成阶段提交 commit，不创建过程 JSON。
+- `devflow/changes/<change>/`：变更真相，只保留 `task.md`、可选 `handoff/pr-brief.md` 和 Git commit；真实复发事故可在 `devflow/postmortems/` 写尸检文件。不要生成额外过程文件。
+- 流程状态归 Git：保留 `task.md`，每个完成阶段提交 commit，不创建额外过程文件。
 - 历史 `planning/design.md`、`planning/analysis.md` 和 `cc-review-*.md` 是旧 change 的可读 fallback，不再是新默认写入。
 - worker prompt、journal、assignment、session log 统一放到 `devflow/workspaces/<change>/`，作为 ephemeral scratch。
 

package/docs/guides/minimize-artifacts.md

@@ -10,13 +10,7 @@ The workflow is intentionally Git-first.
 
 ## Do Not Keep
 
-- process JSON
-- review ledgers or finding files
-- report cards
-- status or resume files
-- release notes
-- principles files
-- task context or checkpoint files
+Do not generate process files beyond the durable files above.
 
 ## Commit Rule
 

package/lib/skill-runtime/CLAUDE.md

@@ -4,7 +4,7 @@
 职责分组
 入口层: `cli.js` 负责命令分发，`index.js` 提供给测试和内部脚本的稳定聚合入口。
 基础层: `schemas.js`、`store.js`、`paths.js` 管住契约、持久化与路径规则，避免执行层重复造轮子。
-状态层: `artifacts.js`、`lifecycle.js`、`query.js`、`workflow-context.js`、`review.js`、`team-state.js` 维护运行时真相源与只读查询。
+状态层: `artifacts.js`、`lifecycle.js`、`review.js`、`team-state.js` 维护运行时真相源。
 规划与交接: `planner.js`、`intent.js`、`delegation.js` 把任务解析、handoff 生成和 team/workspace 委派收口成统一语义。
 阶段操作: `operations/` 是唯一 stage 入口目录；具体阶段边界见 `operations/CLAUDE.md`。
 测试布局: `__tests__/` 紧贴模块放置单元、回归与集成测试；顶层 `test/` 不再承载 `skill-runtime` 私有测试。

package/lib/skill-runtime/index.js

@@ -1,25 +1,17 @@
 /**
  * [INPUT]: 依赖 skill runtime 基础模块。
- * [OUTPUT]: 统一导出 config/path/store/query helpers。
+ * [OUTPUT]: 统一导出 config/path/store helpers。
  * [POS]: skill runtime 模块聚合出口，只保留 CLI 仍需的轻量能力。
  * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
  */
 
 const store = require('./store');
-const query = require('./query');
-const queryRegistry = require('./query-registry');
-const errors = require('./errors');
-const trace = require('./trace');
 const paths = require('./paths');
 const config = require('./config');
 const archiveChange = require('./archive-change');
 
 module.exports = {
   ...store,
-  ...query,
-  ...queryRegistry,
-  ...errors,
-  ...trace,
   ...paths,
   ...config,
   ...archiveChange

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "cc-devflow",
-    "version": "4.5.13",
+    "version": "4.5.15",
     "description": "Multi-platform CLI and skill pack for agent coding",
     "main": "bin/cc-devflow.js",
     "bin": {

package/lib/skill-runtime/errors.js

@@ -1,39 +0,0 @@
-/**
- * [INPUT]: 接收 runtime/query/compiler 边界抛出的错误或失败字段。
- * [OUTPUT]: 生成可序列化 named error，保留 refs 与 rescue action。
- * [POS]: skill runtime 的失败语义层，避免用 null/false/string 表达可恢复失败。
- * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
- */
-
-class SkillRuntimeError extends Error {
-  constructor(name, message, options = {}) {
-    super(message);
-    this.name = name;
-    this.artifactRefs = options.artifactRefs || [];
-    this.rescueAction = options.rescueAction || 'inspect-task-md-and-git-history';
-    this.details = options.details || {};
-  }
-}
-
-function namedError(name, message, options = {}) {
-  return new SkillRuntimeError(name, message, options);
-}
-
-function serializeError(error, fallbackName = 'SkillRuntimeError') {
-  const name = error?.name || fallbackName;
-  const message = error?.message || String(error || 'Unknown runtime error');
-
-  return {
-    name,
-    message,
-    artifactRefs: error?.artifactRefs || [],
-    rescueAction: error?.rescueAction || 'inspect-task-md-and-git-history',
-    details: error?.details || {}
-  };
-}
-
-module.exports = {
-  SkillRuntimeError,
-  namedError,
-  serializeError
-};

package/lib/skill-runtime/query-registry.js

@@ -1,101 +0,0 @@
-/**
- * [INPUT]: 接收 query id、repoRoot/changeId 与只读 handler registry。
- * [OUTPUT]: 返回 typed query result：ok/data 或 named error，并附 trace。
- * [POS]: skill runtime 的查询分发表，只读派生 task.md 与 Git 语义。
- * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
- */
-
-const fs = require('fs');
-
-const { namedError, serializeError } = require('./errors');
-const { createTrace } = require('./trace');
-
-function resolveArtifactRefs(entry, context, key) {
-  const refs = entry[key];
-  return typeof refs === 'function' ? refs(context) : refs || [];
-}
-
-function createQueryRegistry(entries) {
-  const registry = new Map(entries.map((entry) => [entry.id, entry]));
-
-  function listQueryIds() {
-    return [...registry.keys()].sort();
-  }
-
-  async function runQuery(queryId, context = {}) {
-    const entry = registry.get(queryId);
-
-    if (!entry) {
-      const supported = listQueryIds();
-      const error = namedError(
-        'UnknownQueryError',
-        `Unknown query id: ${queryId}`,
-        {
-          rescueAction: `use one of: ${supported.join(', ')}`,
-          details: { supported }
-        }
-      );
-
-      return {
-        ok: false,
-        queryId,
-        error: serializeError(error),
-        trace: createTrace({
-          event: 'query.unknown',
-          changeId: context.changeId,
-          nextAction: 'choose-supported-query'
-        })
-      };
-    }
-
-    let artifactRefs = [];
-    try {
-      artifactRefs = resolveArtifactRefs(entry, context, 'artifactRefs');
-      const requiredArtifactRefs = resolveArtifactRefs(entry, context, 'requiredArtifactRefs');
-      const missingRefs = requiredArtifactRefs.filter((ref) => !fs.existsSync(ref));
-      if (missingRefs.length > 0) {
-        throw namedError(
-          'MissingQueryArtifactError',
-          `Missing required query artifact: ${missingRefs.join(', ')}`,
-          {
-            artifactRefs: missingRefs,
-            rescueAction: 'create task.md before running this query'
-          }
-        );
-      }
-
-      return {
-        ok: true,
-        queryId,
-        data: await entry.handler(context),
-        trace: createTrace({
-          event: `query.${queryId}`,
-          changeId: context.changeId,
-          artifactRefs,
-          nextAction: entry.nextAction || 'read-query-result'
-        })
-      };
-    } catch (error) {
-      return {
-        ok: false,
-        queryId,
-        error: serializeError(error),
-        trace: createTrace({
-          event: `query.${queryId}.failed`,
-          changeId: context.changeId,
-          artifactRefs,
-          nextAction: error.rescueAction || 'inspect-task-md-and-git-history'
-        })
-      };
-    }
-  }
-
-  return {
-    listQueryIds,
-    runQuery
-  };
-}
-
-module.exports = {
-  createQueryRegistry
-};