cc-devflow 4.5.10 → 4.5.12

package/docs/guides/minimize-artifacts.md

@@ -1,123 +1,23 @@
-# Minimized Workflow Artifacts
+# Minimize Artifacts
 
-This guide describes the default artifact contract for new cc-devflow changes.
-The goal is simple: keep durable workflow truth readable, small, and measurable.
+The workflow is intentionally Git-first.
 
-## Default Shape
+## Keep
 
-Each new change keeps durable truth under `devflow/changes/<change-key>/`.
+- `task.md`
+- `handoff/pr-brief.md` when a PR or local handoff needs it
+- incident postmortem when a FIX or recurring failure needs it
 
-Default human-authored Markdown:
+## Do Not Keep
 
-- `planning/tasks.md`
+- process JSON
+- review ledgers or finding files
+- report cards
+- status or resume files
+- release notes
+- principles files
+- task context or checkpoint files
 
-Default machine-owned records:
+## Commit Rule
 
-- `change-meta.json`
-- `planning/task-manifest.json`
-- `review/review-ledger.jsonl`
-- `review/review-findings.json` when findings exist
-- `execution/tasks/<task-id>/checkpoint.json`
-- `review/report-card.json`
-- one final handoff file under `handoff/`
-
-Runtime scratch, worker prompts, journals, assignments, and session logs belong
-under `devflow/workspaces/<change-key>/`, not beside durable change truth.
-
-## Feature Plans
-
-Feature and scope changes use:
-
-- `planning/tasks.md#Contract Summary`
-- `planning/task-manifest.json`
-- `change-meta.json`
-
-`Contract Summary` owns the frozen human-readable plan: user story, non-negotiable
-constraints, decisions that must not be reopened, task slices, and verification
-expectations. The task manifest is generated or validated by CLI tooling and owns
-machine-readable task status.
-
-## Bug Investigations
-
-Bug, regression, and unexpected-behavior work uses:
-
-- `planning/tasks.md#Root Cause Contract`
-- `planning/task-manifest.json`
-- `change-meta.json`
-
-`Root Cause Contract` owns the symptom, reproduction evidence, confirmed cause,
-rejected near-causes, repair boundary, and task handoff. `cc-do` should implement
-from that frozen contract instead of reopening investigation during execution.
-
-## Review Records
-
-`cc-review` writes structured lifecycle events first:
-
-- `review/review-ledger.jsonl`
-- optional `review/review-findings.json`
-- optional rendered Markdown from `cc-devflow review render`
-
-Markdown review reports are for human reading when needed. They are not the
-default durable review source.
-
-Useful commands:
-
-```bash
-npx cc-devflow review start --change REQ-001 --change-key REQ-001-copy-invite-link --base-sha abc123 --head-sha def456
-npx cc-devflow review record-node --change REQ-001 --change-key REQ-001-copy-invite-link --review-id <review-id> --node-id R001 --target planning/tasks.md --status checked --coverage contract --evidence-ref "cmd:npm run verify"
-npx cc-devflow review add-finding --change REQ-001 --change-key REQ-001-copy-invite-link --review-id <review-id> --finding-id F001 --severity important --confidence 8 --display-tier blocking --fingerprint sha256:<hash> --scope "current change" --path planning/tasks.md --evidence "finding evidence" --recommendation "repair action" --route cc-do
-npx cc-devflow review close --change REQ-001 --change-key REQ-001-copy-invite-link --review-id <review-id> --status clean --blocking-count 0 --warning-count 0 --next cc-check
-npx cc-devflow review render --change REQ-001 --change-key REQ-001-copy-invite-link --review-id <review-id> --output review/review-report.md
-```
-
-## Legacy Fallback
-
-Older changes may still contain:
-
-- `planning/design.md`
-- `planning/analysis.md`
-- `review/cc-review-plan.md`
-- `review/cc-review-report.md`
-- `review/cc-review-agent-results.jsonl`
-
-Those files remain readable compatibility inputs. New changes should not write
-them by default. When migrating old work, fold feature-plan truth into
-`planning/tasks.md#Contract Summary` and bug-investigation truth into
-`planning/tasks.md#Root Cause Contract`.
-
-## Validation Gates
-
-Validate one change:
-
-```bash
-npx cc-devflow task-contract validate --change REQ-001 --change-key REQ-001-copy-invite-link
-```
-
-Validate the repository artifact contract:
-
-```bash
-npm run verify:artifacts
-```
-
-Measure the contract:
-
-```bash
-npm run benchmark:artifacts
-```
-
-The package-level verification command also includes artifact validation:
-
-```bash
-npm run verify
-```
-
-## Authoring Rule
-
-Before adding a durable file under `devflow/changes/<change-key>/`, answer:
-
-1. Which downstream skill reads it by default?
-2. Which state does it own that no existing artifact owns?
-3. Which command fails if it drifts?
-
-If those answers are unclear, keep the information in `planning/tasks.md`, a
-machine record, or ephemeral workspace scratch instead.
+Each completed PDCA or IDCA environment/stage gets a Git commit. Use the commit graph as the process record.

package/docs/guides/project-postmortem.md

@@ -1,78 +1,21 @@
-# Project Postmortem Contract
+# Project Postmortems
 
-cc-devflow treats project postmortems as a durable AI memory surface. They are not
-chat summaries. They are repo-owned evidence that future agents can search before
-planning, investigating, or executing work.
+Postmortems preserve recurring failures without turning every workflow step into a file.
 
-## Storage Layout
+## Files
 
-Project-level postmortems live under `devflow/postmortems/`:
+- `devflow/postmortems/INDEX.md`
+- `devflow/postmortems/incidents/<date>-<change-key>.md`
 
-| Path | Owner | Purpose |
-| --- | --- | --- |
-| `INDEX.md` | `cc-act` | Progressive entry point, latest incidents, tags, and search hints |
-| `principles.md` | `cc-act` | Generalized lessons about recurring model, process, and engineering mistakes |
-| `incidents/<date>-<change-key>.md` | `cc-act` | Immutable-ish factual record for one incident, bug, or repeated AI failure |
+## When To Write One
 
-`cc-act` owns writes because it has verified closeout, Git state, review state, and
-ship facts. Earlier skills only read and project the relevant reminders into their
-own artifacts.
+- closing a `FIX-*`
+- repeated AI, test, release, Git, or architecture failure
+- explicit user request
 
-## Progressive Disclosure
+## Rules
 
-- Default layer: `INDEX.md` gives tags, one-line lessons, severity, affected
-  surfaces, and links to deeper incident files.
-- Principle layer: `principles.md` gives reusable rules such as model failure
-  modes, domain-specific judgment traps, and required countermeasures.
-- Incident layer: `incidents/*.md` gives the detailed facts, Git evidence,
-  timeline, root cause, detection gap, repair, follow-ups, and search terms.
-
-Agents should start with keyword search over the default and principle layers, then
-open incident files only when the tags or failure class match the current task.
-
-## Required Incident Evidence
-
-Every incident file should include:
-
-- Symptom and impact.
-- Trigger and timeline.
-- Confirmed root cause and rejected near-causes.
-- Why the failure escaped planning, investigation, execution, review, or ship.
-- Git evidence: branch, base, head SHA, PR if any, relevant commits, review range,
-  and dirty-tree notes when they matter.
-- Verification evidence: commands, exit status, key output, and artifact paths.
-- Follow-up actions: root-cause fixes, detection improvements, and backlog items.
-- AI failure mode: model limitation, pattern-matching trap, missing evidence habit,
-  over-broad abstraction, fake compatibility, test-seam mistake, or other reusable
-  class.
-- Search terms future agents should use before repeating similar work.
-
-## Redaction Guard
-
-Postmortems are durable repo artifacts, so they must never preserve secrets,
-tokens, private customer data, personal machine paths, or raw private logs unless
-the repository already treats that exact artifact as public source truth.
-
-- Record the command, file path, commit, or artifact pointer that proves the fact.
-- Quote only the minimal output needed to prove the incident.
-- Replace sensitive values with `<redacted>` and add a short redaction summary.
-- If the only available proof is sensitive, cite the owner artifact and describe
-  the observed shape instead of copying the raw value.
-
-## Read Gates
-
-`cc-plan`, `cc-investigate`, and `cc-do` must run a quick local search before they
-freeze direction or touch code:
-
-```bash
-rg -n "<capability|module|error|failure-class|model-risk>" devflow/postmortems
-```
-
-If `devflow/postmortems/` does not exist, record `no-project-postmortems-yet`.
-If a match exists, load only `INDEX.md`, `principles.md`, and the one or two
-incident files most relevant to the current work.
-
-## State Ownership
-
-Postmortems do not own task status, roadmap progress, review verdicts, or spec sync
-state. They cite those stronger owners by path, commit, or command output.
+- Use Git evidence, commands, and current files.
+- Redact secrets, customer data, private logs, and local machine paths.
+- Do not create a separate principles file.
+- Do not use postmortems as task, review, or release state.

package/lib/compiler/__tests__/skills-registry.test.js

@@ -159,9 +159,9 @@ describe('Skills Registry Generator', () => {
       expect(execute.writes).toEqual(
         expect.arrayContaining([
           expect.objectContaining({
-            path: 'devflow/changes/<change-key>/execution/tasks/<task-id>/events.jsonl',
+            path: 'devflow/changes/<change-key>/task.md',
             durability: 'durable',
-            required: false
+            required: true
           })
         ])
       );
@@ -183,13 +183,14 @@ describe('Skills Registry Generator', () => {
         expect.arrayContaining([
           expect.objectContaining({
             path: 'devflow/changes/<change-key>/handoff/pr-brief.md',
-            required: false,
-            exclusiveGroup: 'handoff'
-          }),
+            required: false
+          })
+        ])
+      );
+      expect(act.writes).not.toEqual(
+        expect.arrayContaining([
           expect.objectContaining({
-            path: 'devflow/changes/<change-key>/handoff/release-note.md',
-            required: false,
-            exclusiveGroup: 'handoff'
+            path: expect.stringContaining('release')
           })
         ])
       );

package/lib/compiler/resource-copier.js

@@ -428,6 +428,7 @@ async function mirrorDirectoryRecursive(sourceDir, targetDir, options = {}) {
 
   if (!dryRun) {
     await fs.promises.mkdir(targetDir, { recursive: true, mode: 0o755 });
+    await pruneMirroredDirectoryRecursive(sourceDir, targetDir, options);
   }
 
   for (const entry of entries) {
@@ -473,6 +474,34 @@ async function mirrorDirectoryRecursive(sourceDir, targetDir, options = {}) {
   return result;
 }
 
+async function pruneMirroredDirectoryRecursive(sourceDir, targetDir, options = {}) {
+  const { verbose = false } = options;
+
+  if (!fs.existsSync(targetDir)) {
+    return;
+  }
+
+  const targetEntries = await fs.promises.readdir(targetDir, { withFileTypes: true });
+  await Promise.all(
+    targetEntries.map(async (entry) => {
+      const sourcePath = path.join(sourceDir, entry.name);
+      const targetPath = path.join(targetDir, entry.name);
+
+      if (!fs.existsSync(sourcePath)) {
+        await fs.promises.rm(targetPath, { recursive: true, force: true });
+        if (verbose) {
+          console.log(`Pruned stale skill file: ${path.relative(process.cwd(), targetPath)}`);
+        }
+        return;
+      }
+
+      if (entry.isDirectory()) {
+        await pruneMirroredDirectoryRecursive(sourcePath, targetPath, options);
+      }
+    })
+  );
+}
+
 // ============================================================
 // clearResourceCache - 清除资源缓存（用于测试）
 // ============================================================

package/lib/skill-runtime/__tests__/archive-change.test.js

@@ -61,13 +61,13 @@ describe('restoreChange', () => {
     const repoRoot = makeTempRepo();
     const archivedDir = path.join(repoRoot, 'devflow', 'changes', 'archive', '2026-04', 'REQ-002-restored');
     fs.mkdirSync(archivedDir, { recursive: true });
-    fs.writeFileSync(path.join(archivedDir, 'tasks.md'), '- [ ] task');
+    fs.writeFileSync(path.join(archivedDir, 'task.md'), '- [ ] task');
 
     const result = restoreChange(repoRoot, archivedDir);
 
     expect(result.changeKey).toBe('REQ-002-restored');
     expect(fs.existsSync(result.restored)).toBe(true);
-    expect(fs.existsSync(path.join(result.restored, 'tasks.md'))).toBe(true);
+    expect(fs.existsSync(path.join(result.restored, 'task.md'))).toBe(true);
     expect(fs.existsSync(archivedDir)).toBe(false);
 
     fs.rmSync(repoRoot, { recursive: true, force: true });

package/lib/skill-runtime/__tests__/benchmark-skills.test.js

@@ -0,0 +1,109 @@
+/**
+ * [INPUT]: 依赖 scripts/benchmark-skills.js 导出的 runBenchmarkSkills 和临时 skill fixture。
+ * [OUTPUT]: 验证 benchmark:skills 对 SKILL.md 入口体积执行 byte/line advisory 预算。
+ * [POS]: skill 入口瘦身基准的 Red/Green 证据。
+ * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
+ */
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+const { runBenchmarkSkills } = require('../../../scripts/benchmark-skills');
+
+const REPO_ROOT = path.resolve(__dirname, '../../..');
+const BENCHMARK_SCRIPT = path.join(REPO_ROOT, 'scripts', 'benchmark-skills.js');
+
+function writeSkill(repoRoot, skillName, body) {
+  const filePath = path.join(repoRoot, '.claude', 'skills', skillName, 'SKILL.md');
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  fs.writeFileSync(filePath, body);
+}
+
+function skillBody({ version = '1.0.0', filler = '' } = {}) {
+  return [
+    '---',
+    'name: cc-plan',
+    `version: ${version}`,
+    'description: fixture',
+    '---',
+    '',
+    '# Fixture',
+    '',
+    'Thin entrypoint.',
+    filler
+  ].join('\n');
+}
+
+function investigateSkillBody({ filler = '' } = {}) {
+  return skillBody().replace('name: cc-plan', 'name: cc-investigate') + filler;
+}
+
+describe('benchmark:skills', () => {
+  let repoRoot;
+
+  beforeEach(() => {
+    repoRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'cc-devflow-benchmark-skills-'));
+  });
+
+  afterEach(() => {
+    fs.rmSync(repoRoot, { recursive: true, force: true });
+  });
+
+  test('passes when cc-plan stays under the thin entrypoint budget', () => {
+    writeSkill(repoRoot, 'cc-plan', skillBody());
+
+    const result = runBenchmarkSkills(repoRoot);
+
+    expect(result.code).toBe(0);
+    expect(result.rows[0]).toMatchObject({
+      skill: 'cc-plan',
+      max_bytes: 16000,
+      max_lines: 360,
+      correctness_pass: true
+    });
+  });
+
+  test('passes when cc-investigate stays under the thin entrypoint budget', () => {
+    writeSkill(repoRoot, 'cc-investigate', investigateSkillBody());
+
+    const result = runBenchmarkSkills(repoRoot);
+
+    expect(result.rows[0]).toMatchObject({
+      skill: 'cc-investigate',
+      max_bytes: 16000,
+      max_lines: 360,
+      correctness_pass: true
+    });
+  });
+
+  test('reports advisory failure without blocking when cc-plan grows past the byte budget', () => {
+    writeSkill(repoRoot, 'cc-plan', skillBody({ filler: 'x'.repeat(17000) }));
+
+    const result = runBenchmarkSkills(repoRoot);
+
+    expect(result.code).toBe(0);
+    expect(result.rows[0]).toMatchObject({
+      skill: 'cc-plan',
+      correctness_pass: false,
+      note: 'skill entrypoint exceeds context budget'
+    });
+  });
+
+  test('CLI prints stdout JSON array', () => {
+    writeSkill(repoRoot, 'cc-plan', skillBody());
+
+    const result = spawnSync(process.execPath, [BENCHMARK_SCRIPT, repoRoot], { encoding: 'utf8' });
+    const rows = JSON.parse(result.stdout);
+
+    expect(result.status).toBe(0);
+    expect(Array.isArray(rows)).toBe(true);
+    expect(rows[0]).toHaveProperty('estimated_tokens');
+  });
+
+  test('package.json exposes npm run benchmark:skills', () => {
+    const pkg = JSON.parse(fs.readFileSync(path.join(REPO_ROOT, 'package.json'), 'utf8'));
+    expect(pkg.scripts['benchmark:skills']).toBe('node scripts/benchmark-skills.js');
+  });
+});

package/lib/skill-runtime/__tests__/cli-bootstrap.integration.test.js

@@ -108,7 +108,8 @@ describe('cc-devflow cli distribution bootstrap', () => {
 
     expect(skillContent).not.toContain('<!-- CC-DEVFLOW OUTPUT POLICY START -->');
     expect(skillContent).not.toContain('文档语言: zh-CN');
-    expect(skillContent).toContain('cc-devflow config resolve --format policy');
+    expect(skillContent).toContain('resolve-cc-devflow.sh');
+    expect(skillContent).toContain('bash "$DEVFLOW" config resolve --format policy');
     expect(fs.readFileSync(path.join(customSkillDir, 'SKILL.md'), 'utf8')).toBe('# Custom Skill\n');
   });
 
@@ -177,7 +178,10 @@ describe('cc-devflow cli distribution bootstrap', () => {
     expect(runCli(['init', '--dir', repoRoot], repoRoot).status).toBe(0);
 
     const targetSkill = path.join(repoRoot, '.claude', 'skills', 'cc-roadmap', 'SKILL.md');
+    const staleManagedFile = path.join(repoRoot, '.claude', 'skills', 'cc-act', 'assets', 'STALE.md');
+    fs.mkdirSync(path.dirname(staleManagedFile), { recursive: true });
     fs.writeFileSync(targetSkill, '# local override\n');
+    fs.writeFileSync(staleManagedFile, '# stale\n');
 
     const result = runCli(['init', '--dir', repoRoot, '--force'], repoRoot);
     expect(result.status).toBe(0);
@@ -186,10 +190,14 @@ describe('cc-devflow cli distribution bootstrap', () => {
       fs.readFileSync(path.join(TEMPLATE_ROOT, 'skills', 'cc-roadmap', 'SKILL.md'), 'utf8')
     );
     expect(fs.existsSync(`${targetSkill}.new`)).toBe(false);
+    expect(fs.existsSync(staleManagedFile)).toBe(false);
   });
 
   test('adapt mirrors public skills into .codex/skills for Codex', () => {
     expect(runCli(['init', '--dir', repoRoot], repoRoot).status).toBe(0);
+    const staleCodexAsset = path.join(repoRoot, '.codex', 'skills', 'cc-act', 'assets', 'STALE.md');
+    fs.mkdirSync(path.dirname(staleCodexAsset), { recursive: true });
+    fs.writeFileSync(staleCodexAsset, '# stale\n');
 
     const result = runCli(['adapt', '--cwd', repoRoot, '--platform', 'codex'], repoRoot);
     expect(result.status).toBe(0);
@@ -202,6 +210,7 @@ describe('cc-devflow cli distribution bootstrap', () => {
     expect(fs.existsSync(path.join(repoRoot, '.codex', 'skills', 'cc-review', 'SKILL.md'))).toBe(true);
     expect(fs.existsSync(path.join(repoRoot, '.codex', 'skills', 'cc-check', 'SKILL.md'))).toBe(true);
     expect(fs.existsSync(path.join(repoRoot, '.codex', 'skills', 'cc-act', 'SKILL.md'))).toBe(true);
+    expect(fs.existsSync(staleCodexAsset)).toBe(false);
 
     const codexInvestigateSkill = fs.readFileSync(
       path.join(repoRoot, '.codex', 'skills', 'cc-investigate', 'SKILL.md'),
@@ -217,9 +226,9 @@ describe('cc-devflow cli distribution bootstrap', () => {
     expect(codexDoSkill.data.writes).toEqual(
       expect.arrayContaining([
         expect.objectContaining({
-          path: 'devflow/changes/<change-key>/execution/tasks/<task-id>/events.jsonl',
+          path: 'devflow/changes/<change-key>/task.md',
           durability: 'durable',
-          required: false
+          required: true
         })
       ])
     );
@@ -277,7 +286,8 @@ describe('cc-devflow cli distribution bootstrap', () => {
     );
     expect(codexPlanSkill).not.toContain('<!-- CC-DEVFLOW OUTPUT POLICY START -->');
     expect(codexPlanSkill).not.toContain('文档语言: zh-CN');
-    expect(codexPlanSkill).toContain('cc-devflow config resolve --format policy');
+    expect(codexPlanSkill).toContain('resolve-cc-devflow.sh');
+    expect(codexPlanSkill).toContain('bash "$DEVFLOW" config resolve --format policy');
   });
 
   test('adapt preserves pre-existing non-public Codex skills and does not mirror new private ones', () => {

package/lib/skill-runtime/errors.js

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

package/lib/skill-runtime/index.js

@@ -1,44 +1,26 @@
 /**
- * [INPUT]: 依赖 skill runtime 各模块。
- * [OUTPUT]: 统一导出 schema/store/planner/query 与 operations 入口。
- * [POS]: skill runtime 模块聚合出口，被内部测试与脚本使用。
+ * [INPUT]: 依赖 skill runtime 基础模块。
+ * [OUTPUT]: 统一导出 config/path/store/query helpers。
+ * [POS]: skill runtime 模块聚合出口，只保留 CLI 仍需的轻量能力。
  * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
  */
 
 const store = require('./store');
-const schemas = require('./schemas');
-const planner = require('./planner');
 const query = require('./query');
 const queryRegistry = require('./query-registry');
 const errors = require('./errors');
 const trace = require('./trace');
-const readiness = require('./readiness');
-const intent = require('./intent');
-const artifacts = require('./artifacts');
-const lifecycle = require('./lifecycle');
-const teamState = require('./team-state');
-const delegation = require('./delegation');
 const paths = require('./paths');
 const config = require('./config');
-const worker = require('./operations/worker');
-const workerRun = require('./operations/worker-run');
+const archiveChange = require('./archive-change');
 
 module.exports = {
   ...store,
-  ...schemas,
-  ...planner,
   ...query,
   ...queryRegistry,
   ...errors,
   ...trace,
-  ...readiness,
-  ...artifacts,
-  ...intent,
-  ...lifecycle,
-  ...teamState,
-  ...delegation,
   ...paths,
   ...config,
-  ...worker,
-  ...workerRun
+  ...archiveChange
 };

package/lib/skill-runtime/paths.js

@@ -1,6 +1,6 @@
 /**
- * [INPUT]: 依赖 fs/path，接收 repoRoot/changeId/taskId/workerId 等定位参数。
- * [OUTPUT]: 对外提供 devflow canonical layout 的唯一路径解析能力。
+ * [INPUT]: 依赖 fs/path，接收 repoRoot/changeId 等定位参数。
+ * [OUTPUT]: 对外提供 devflow canonical change layout 的唯一路径解析能力。
  * [POS]: skill runtime 的路径真相源，完整 change key 才是目录身份。
  * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
  */
@@ -70,10 +70,6 @@ function getChangesRoot(repoRoot) {
   return path.join(getDevflowRoot(repoRoot), 'changes');
 }
 
-function getWorkspacesRoot(repoRoot) {
-  return path.join(getDevflowRoot(repoRoot), 'workspaces');
-}
-
 function listChangeKeys(repoRoot) {
   const changesRoot = getChangesRoot(repoRoot);
   if (!fs.existsSync(changesRoot)) {
@@ -196,56 +192,15 @@ function nextChangeKey(repoRoot, prefix, description) {
 function getChangePaths(repoRoot, changeId, options = {}) {
   const changeKey = resolveChangeKey(repoRoot, changeId, options);
   const changeDir = path.join(getChangesRoot(repoRoot), changeKey);
-  const metaDir = path.join(changeDir, 'meta');
-  const planningDir = path.join(changeDir, 'planning');
-  const executionDir = path.join(changeDir, 'execution');
-  const reviewDir = path.join(changeDir, 'review');
   const handoffDir = path.join(changeDir, 'handoff');
 
   return {
     changeId,
     changeKey,
     changeDir,
-    metaDir,
-    planningDir,
-    executionDir,
-    reviewDir,
     handoffDir,
-    tasksDir: path.join(executionDir, 'tasks'),
-    workersDir: path.join(executionDir, 'workers'),
-    workspacesDir: path.join(getWorkspacesRoot(repoRoot), changeKey)
-  };
-}
-
-function getTaskPaths(repoRoot, changeId, taskId, options = {}) {
-  const change = getChangePaths(repoRoot, changeId, options);
-  const taskDir = path.join(change.tasksDir, taskId);
-
-  return {
-    ...change,
-    taskId,
-    taskDir,
-    eventsPath: path.join(taskDir, 'events.jsonl')
-  };
-}
-
-function getWorkerPaths(repoRoot, changeId, workerId, options = {}) {
-  const change = getChangePaths(repoRoot, changeId, options);
-  const workspacePath = path.join(change.workspacesDir, workerId);
-  const workerDir = path.join(workspacePath, '.runtime');
-
-  return {
-    ...change,
-    workerId,
-    workerDir,
-    sharedRuntimeDir: path.join(change.workspacesDir, '.runtime'),
-    assignmentPath: path.join(workerDir, 'assignment.md'),
-    promptPath: path.join(workerDir, 'prompt.md'),
-    launchPath: path.join(workerDir, 'launch.md'),
-    statePath: path.join(workerDir, 'state.md'),
-    journalPath: path.join(workerDir, 'journal.md'),
-    sessionLogPath: path.join(workerDir, 'session.log'),
-    workspacePath
+    taskPath: path.join(changeDir, 'task.md'),
+    prBriefPath: path.join(handoffDir, 'pr-brief.md')
   };
 }
 
@@ -256,11 +211,9 @@ module.exports = {
   getChangeSlug,
   getDevflowRoot,
   getChangesRoot,
-  getWorkspacesRoot,
   nextChangeKey,
   resolveChangeKey,
   buildChangeKey,
   getChangePaths,
-  getTaskPaths,
-  getWorkerPaths
+  assertChangeId
 };