@boyingliu01/xp-gate 0.14.7 → 0.14.9

package/mutation/__tests__/update-baseline.test.ts

@@ -0,0 +1,393 @@
+/**
+ * @test update-baseline.ts - Mutation baseline update CLI
+ * @intent Verify parseArgs, updateBaseline, removeDeletedFiles, and readBaseline
+ *         work correctly through the module's side effects
+ * @covers REQ-MUT-001 AC-004 (baseline update from mutation scores)
+ */
+
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+
+vi.mock('fs/promises', () => ({
+  default: {
+    readFile: vi.fn(),
+    writeFile: vi.fn(),
+    access: vi.fn()
+  },
+  readFile: vi.fn(),
+  writeFile: vi.fn(),
+  access: vi.fn()
+}));
+
+const mockFs = await import('fs/promises');
+
+interface MockBaseline {
+  version: string;
+  generatedAt: string;
+  source: 'local' | 'ci';
+  scores: Record<string, { score: number; mutants: number; killed: number; survived: number }>;
+}
+
+function makeBaseline(overrides: Partial<MockBaseline> = {}): MockBaseline {
+  return {
+    version: '1.0.0',
+    generatedAt: '2024-01-01T00:00:00.000Z',
+    source: 'local',
+    scores: {},
+    ...overrides
+  };
+}
+
+describe('update-baseline.ts - Mutation Baseline Update CLI', () => {
+  let originalArgv: string[];
+  let originalExit: typeof process.exit;
+  let originalCwd: typeof process.cwd;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  let consoleLogSpy: any;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  let consoleErrorSpy: any;
+  let exitCode: number | undefined;
+
+  beforeEach(() => {
+    originalArgv = process.argv;
+    originalExit = process.exit;
+    originalCwd = process.cwd;
+
+    consoleLogSpy = vi.spyOn(console, 'log').mockImplementation(() => undefined);
+    consoleErrorSpy = vi.spyOn(console, 'error').mockImplementation(() => undefined);
+
+    process.exit = ((code?: number) => {
+      exitCode = code;
+      return undefined as never;
+    }) as typeof process.exit;
+
+    process.cwd = () => '/fake/project';
+
+    vi.resetModules();
+    vi.clearAllMocks();
+    exitCode = undefined;
+  });
+
+  afterEach(() => {
+    process.argv = originalArgv;
+    process.exit = originalExit;
+    process.cwd = originalCwd;
+    consoleLogSpy.mockRestore();
+    consoleErrorSpy.mockRestore();
+  });
+
+  async function importModule(): Promise<void> {
+    await import('../update-baseline');
+    // Allow the main() promise chain to settle
+    await new Promise((resolve) => setTimeout(resolve, 10));
+  }
+
+  describe('parseArgs', () => {
+    it('should parse valid --scores argument with single file', async () => {
+      process.argv = ['node', 'update-baseline.js', '--scores', 'src/foo.ts:75.5'];
+      const baseline = makeBaseline();
+      (mockFs.default.readFile as ReturnType<typeof vi.fn>).mockResolvedValue(
+        JSON.stringify(baseline)
+      );
+      (mockFs.default.access as ReturnType<typeof vi.fn>).mockResolvedValue(undefined);
+      (mockFs.default.writeFile as ReturnType<typeof vi.fn>).mockResolvedValue(undefined);
+
+      await importModule();
+
+      expect(exitCode).toBeUndefined();
+      expect(mockFs.default.writeFile).toHaveBeenCalled();
+      const written = JSON.parse(
+        (mockFs.default.writeFile as ReturnType<typeof vi.fn>).mock.calls[0][1] as string
+      );
+      expect(written.scores['src/foo.ts'].score).toBe(75.5);
+    });
+
+    it('should parse multiple comma-separated scores', async () => {
+      process.argv = [
+        'node',
+        'update-baseline.js',
+        '--scores',
+        'src/a.ts:80.0,src/b.ts:65.3,src/c.ts:92.7'
+      ];
+      const baseline = makeBaseline();
+      (mockFs.default.readFile as ReturnType<typeof vi.fn>).mockResolvedValue(
+        JSON.stringify(baseline)
+      );
+      (mockFs.default.access as ReturnType<typeof vi.fn>).mockResolvedValue(undefined);
+      (mockFs.default.writeFile as ReturnType<typeof vi.fn>).mockResolvedValue(undefined);
+
+      await importModule();
+
+      const written = JSON.parse(
+        (mockFs.default.writeFile as ReturnType<typeof vi.fn>).mock.calls[0][1] as string
+      );
+      expect(Object.keys(written.scores)).toHaveLength(3);
+      expect(written.scores['src/a.ts'].score).toBe(80.0);
+      expect(written.scores['src/b.ts'].score).toBe(65.3);
+      expect(written.scores['src/c.ts'].score).toBe(92.7);
+    });
+
+    it('should throw and exit 1 when --scores is missing', async () => {
+      process.argv = ['node', 'update-baseline.js'];
+
+      await importModule();
+
+      expect(exitCode).toBe(1);
+      expect(consoleErrorSpy).toHaveBeenCalledWith(
+        expect.stringContaining('Missing required argument: --scores')
+      );
+    });
+
+    it('should throw and exit 1 when score format is invalid (missing colon)', async () => {
+      process.argv = ['node', 'update-baseline.js', '--scores', 'src/foo.ts'];
+
+      await importModule();
+
+      expect(exitCode).toBe(1);
+      expect(consoleErrorSpy).toHaveBeenCalledWith(
+        expect.stringContaining('Invalid score format')
+      );
+    });
+
+    it('should throw and exit 1 when score value is NaN', async () => {
+      process.argv = ['node', 'update-baseline.js', '--scores', 'src/foo.ts:notanumber'];
+
+      await importModule();
+
+      expect(exitCode).toBe(1);
+      expect(consoleErrorSpy).toHaveBeenCalledWith(
+        expect.stringContaining('Invalid score value')
+      );
+    });
+
+    it('should throw and exit 1 when score is out of range (>100)', async () => {
+      process.argv = ['node', 'update-baseline.js', '--scores', 'src/foo.ts:150'];
+
+      await importModule();
+
+      expect(exitCode).toBe(1);
+      expect(consoleErrorSpy).toHaveBeenCalledWith(
+        expect.stringContaining('Invalid score value')
+      );
+    });
+
+    it('should throw and exit 1 when score is negative', async () => {
+      process.argv = ['node', 'update-baseline.js', '--scores', 'src/foo.ts:-5'];
+
+      await importModule();
+
+      expect(exitCode).toBe(1);
+      expect(consoleErrorSpy).toHaveBeenCalledWith(
+        expect.stringContaining('Invalid score value')
+      );
+    });
+  });
+
+  describe('updateBaseline (via module side effects)', () => {
+    it('should merge new scores into existing baseline entries', async () => {
+      process.argv = ['node', 'update-baseline.js', '--scores', 'src/existing.ts:88.5'];
+      const baseline = makeBaseline({
+        scores: {
+          'src/existing.ts': { score: 50.0, mutants: 10, killed: 5, survived: 5 }
+        }
+      });
+      (mockFs.default.readFile as ReturnType<typeof vi.fn>).mockResolvedValue(
+        JSON.stringify(baseline)
+      );
+      (mockFs.default.access as ReturnType<typeof vi.fn>).mockResolvedValue(undefined);
+      (mockFs.default.writeFile as ReturnType<typeof vi.fn>).mockResolvedValue(undefined);
+
+      await importModule();
+
+      const written = JSON.parse(
+        (mockFs.default.writeFile as ReturnType<typeof vi.fn>).mock.calls[0][1] as string
+      );
+      // Score should be updated
+      expect(written.scores['src/existing.ts'].score).toBe(88.5);
+      // Existing metadata should be preserved
+      expect(written.scores['src/existing.ts'].mutants).toBe(10);
+      expect(written.scores['src/existing.ts'].killed).toBe(5);
+      expect(written.scores['src/existing.ts'].survived).toBe(5);
+    });
+
+    it('should add new file entries with zeroed metadata', async () => {
+      process.argv = ['node', 'update-baseline.js', '--scores', 'src/new.ts:72.0'];
+      const baseline = makeBaseline({
+        scores: {
+          'src/old.ts': { score: 60.0, mutants: 8, killed: 4, survived: 4 }
+        }
+      });
+      (mockFs.default.readFile as ReturnType<typeof vi.fn>).mockResolvedValue(
+        JSON.stringify(baseline)
+      );
+      (mockFs.default.access as ReturnType<typeof vi.fn>).mockResolvedValue(undefined);
+      (mockFs.default.writeFile as ReturnType<typeof vi.fn>).mockResolvedValue(undefined);
+
+      await importModule();
+
+      const written = JSON.parse(
+        (mockFs.default.writeFile as ReturnType<typeof vi.fn>).mock.calls[0][1] as string
+      );
+      expect(written.scores['src/new.ts']).toEqual({
+        score: 72.0,
+        mutants: 0,
+        killed: 0,
+        survived: 0
+      });
+      // Old entry should still be present
+      expect(written.scores['src/old.ts'].score).toBe(60.0);
+    });
+
+    it('should update generatedAt timestamp', async () => {
+      process.argv = ['node', 'update-baseline.js', '--scores', 'src/foo.ts:50.0'];
+      const baseline = makeBaseline({ generatedAt: '2020-01-01T00:00:00.000Z' });
+      (mockFs.default.readFile as ReturnType<typeof vi.fn>).mockResolvedValue(
+        JSON.stringify(baseline)
+      );
+      (mockFs.default.access as ReturnType<typeof vi.fn>).mockResolvedValue(undefined);
+      (mockFs.default.writeFile as ReturnType<typeof vi.fn>).mockResolvedValue(undefined);
+
+      await importModule();
+
+      const written = JSON.parse(
+        (mockFs.default.writeFile as ReturnType<typeof vi.fn>).mock.calls[0][1] as string
+      );
+      expect(written.generatedAt).not.toBe('2020-01-01T00:00:00.000Z');
+      // Should be a valid ISO date string
+      expect(new Date(written.generatedAt).toISOString()).toBe(written.generatedAt);
+    });
+
+    it('should round score to 1 decimal place', async () => {
+      process.argv = ['node', 'update-baseline.js', '--scores', 'src/foo.ts:66.66666'];
+      const baseline = makeBaseline();
+      (mockFs.default.readFile as ReturnType<typeof vi.fn>).mockResolvedValue(
+        JSON.stringify(baseline)
+      );
+      (mockFs.default.access as ReturnType<typeof vi.fn>).mockResolvedValue(undefined);
+      (mockFs.default.writeFile as ReturnType<typeof vi.fn>).mockResolvedValue(undefined);
+
+      await importModule();
+
+      const written = JSON.parse(
+        (mockFs.default.writeFile as ReturnType<typeof vi.fn>).mock.calls[0][1] as string
+      );
+      expect(written.scores['src/foo.ts'].score).toBe(66.7);
+    });
+  });
+
+  describe('removeDeletedFiles (via module side effects)', () => {
+    it('should remove files that no longer exist on disk', async () => {
+      process.argv = ['node', 'update-baseline.js', '--scores', 'src/keep.ts:80.0'];
+      const baseline = makeBaseline({
+        scores: {
+          'src/keep.ts': { score: 70.0, mutants: 10, killed: 7, survived: 3 },
+          'src/deleted.ts': { score: 50.0, mutants: 5, killed: 2, survived: 3 }
+        }
+      });
+      (mockFs.default.readFile as ReturnType<typeof vi.fn>).mockResolvedValue(
+        JSON.stringify(baseline)
+      );
+      (mockFs.default.access as ReturnType<typeof vi.fn>).mockImplementation(
+        (filePath: string) => {
+          if (filePath.includes('deleted.ts')) {
+            return Promise.reject(new Error('ENOENT'));
+          }
+          return Promise.resolve(undefined);
+        }
+      );
+      (mockFs.default.writeFile as ReturnType<typeof vi.fn>).mockResolvedValue(undefined);
+
+      await importModule();
+
+      const written = JSON.parse(
+        (mockFs.default.writeFile as ReturnType<typeof vi.fn>).mock.calls[0][1] as string
+      );
+      expect(written.scores['src/keep.ts']).toBeDefined();
+      expect(written.scores['src/deleted.ts']).toBeUndefined();
+      expect(consoleLogSpy).toHaveBeenCalledWith(
+        expect.stringContaining('Removing deleted file from baseline: src/deleted.ts')
+      );
+    });
+
+    it('should keep all files when they all exist on disk', async () => {
+      process.argv = ['node', 'update-baseline.js', '--scores', 'src/a.ts:90.0'];
+      const baseline = makeBaseline({
+        scores: {
+          'src/a.ts': { score: 80.0, mutants: 10, killed: 8, survived: 2 },
+          'src/b.ts': { score: 70.0, mutants: 8, killed: 5, survived: 3 }
+        }
+      });
+      (mockFs.default.readFile as ReturnType<typeof vi.fn>).mockResolvedValue(
+        JSON.stringify(baseline)
+      );
+      (mockFs.default.access as ReturnType<typeof vi.fn>).mockResolvedValue(undefined);
+      (mockFs.default.writeFile as ReturnType<typeof vi.fn>).mockResolvedValue(undefined);
+
+      await importModule();
+
+      const written = JSON.parse(
+        (mockFs.default.writeFile as ReturnType<typeof vi.fn>).mock.calls[0][1] as string
+      );
+      expect(Object.keys(written.scores)).toHaveLength(2);
+    });
+  });
+
+  describe('readBaseline (via module side effects)', () => {
+    it('should fail with error when baseline file does not exist', async () => {
+      process.argv = ['node', 'update-baseline.js', '--scores', 'src/foo.ts:50.0'];
+      (mockFs.default.readFile as ReturnType<typeof vi.fn>).mockRejectedValue(
+        new Error('ENOENT: no such file')
+      );
+
+      await importModule();
+
+      expect(exitCode).toBe(1);
+      expect(consoleErrorSpy).toHaveBeenCalledWith(
+        expect.stringContaining('Failed to read baseline file')
+      );
+    });
+
+    it('should fail with error when baseline file contains invalid JSON', async () => {
+      process.argv = ['node', 'update-baseline.js', '--scores', 'src/foo.ts:50.0'];
+      (mockFs.default.readFile as ReturnType<typeof vi.fn>).mockResolvedValue(
+        'not-valid-json{{{'
+      );
+
+      await importModule();
+
+      expect(exitCode).toBe(1);
+      expect(consoleErrorSpy).toHaveBeenCalledWith(
+        expect.stringContaining('Failed to read baseline file')
+      );
+    });
+  });
+
+  describe('end-to-end output', () => {
+    it('should log per-file scores and total file count', async () => {
+      process.argv = [
+        'node',
+        'update-baseline.js',
+        '--scores',
+        'src/a.ts:80.0,src/b.ts:60.0'
+      ];
+      const baseline = makeBaseline();
+      (mockFs.default.readFile as ReturnType<typeof vi.fn>).mockResolvedValue(
+        JSON.stringify(baseline)
+      );
+      (mockFs.default.access as ReturnType<typeof vi.fn>).mockResolvedValue(undefined);
+      (mockFs.default.writeFile as ReturnType<typeof vi.fn>).mockResolvedValue(undefined);
+
+      await importModule();
+
+      const allLogs = consoleLogSpy.mock.calls.map((c: unknown[]) => c[0]);
+      expect(allLogs).toEqual(
+        expect.arrayContaining([
+          'Reading existing mutation baseline...',
+          'Updating 2 file score(s)...',
+          'Checking for deleted files...',
+          'Total files: 2'
+        ])
+      );
+      expect(allLogs).toEqual(expect.arrayContaining(['  src/a.ts: 80%', '  src/b.ts: 60%']));
+    });
+  });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@boyingliu01/xp-gate",
-  "version": "0.14.7",
+  "version": "0.14.9",
   "description": "AI-driven development workflow: 6 quality gates + Delphi review + Sprint Flow",
   "bin": {
     "xp-gate": "./bin/xp-gate.js"

package/plugins/claude-code/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "xp-gate",
-  "version": "0.14.7",
+  "version": "0.14.9",
   "displayName": "XP-Gate",
   "description": "Extreme Programming quality gates + AI workflow skills for Claude Code. Includes 10 quality gates (Gate 0-9), Sprint Flow (11 phases), and Delphi multi-expert review (>=90% consensus).",
   "author": {

package/plugins/claude-code/skills/delphi-review/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/DELPHI-REVIEW KNOWLEDGE BASE
 
-**Generated:** 2026-07-10
-**Commit:** a9276f6
-**Branch:** main
-**Version:** 0.14.6.2
+**Generated:** 2026-07-13
+**Commit:** cb954fe
+**Branch:** sprint/2026-07-13-01
+**Version:** 0.14.9.0
 
 ## OVERVIEW
 Delphi Consensus Review — multi-round anonymous expert review (≥90% threshold, 3 experts from ≥2 providers, domestic models only). Supports design + code-walkthrough modes.

package/plugins/claude-code/skills/sprint-flow/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/SPRINT-FLOW KNOWLEDGE BASE
 
-**Generated:** 2026-07-10
-**Commit:** a9276f6
-**Branch:** main
-**Version:** 0.14.6.2
+**Generated:** 2026-07-13
+**Commit:** cb954fe
+**Branch:** sprint/2026-07-13-01
+**Version:** 0.14.9.0
 
 ## OVERVIEW
 **6-phase** development pipeline (v2.0 compact redesign, Issue #290): PREP → DESIGN → BUILD → VERIFY → SHIP → CLOSE. Phase 3/6 BUILD default build mode is **ralph-loop** (REQ-level iteration, 40-67% token savings vs parallel). HARD-GATE between DESIGN (2/6) and BUILD (3/6): design must pass Delphi review (≥90% consensus) before any coding.

package/plugins/claude-code/skills/sprint-flow/SKILL.md

@@ -167,7 +167,7 @@ PREP → DESIGN → BUILD → VERIFY → SHIP → CLOSE
 | Phase | Name | Key Actions | Output |
 |-------|------|-------------|--------|
 | 1/6 | PREP | Detect protected branch → Create git worktree → AUTO-ESTIMATE sizing → Classify (lightweight/standard/complex) | Worktree path + impact assessment |
-| 2/6 | DESIGN | brainstorming → autoplan → delphi-review (HARD-GATE ≥90% consensus) → to-issues → specification.yaml | specification.yaml + slices-manifest.json |
+| 2/6 | DESIGN | CONTEXT.md 预检 (#322) → brainstorming (如需要) → autoplan → delphi-review (HARD-GATE ≥90% consensus) → to-issues → specification.yaml | specification.yaml + slices-manifest.json |
 | 3/6 | BUILD | GITHOOKS-GATE → DELPHI-GATE → ralph-loop (default) or parallel → TDD → freeze → blind review → verification | MVP code |
 | 4/6 | VERIFY | delphi-review --mode code-walkthrough → test-specification-alignment → browse QA → learn + retro | Review report + feedback-log.md |
 | 5/6 | SHIP | VERSION-GATE → finishing-a-development-branch → ship (create PR) → land-and-deploy → merge to main + CI + canary | PR URL + deploy status + merge confirmation |

package/plugins/claude-code/skills/sprint-flow/references/phase-2-design.md

@@ -11,6 +11,27 @@
 
 ## Part A: THINK（需求探索与设计）
 
+### Step 0: CONTEXT.md 预检（v0.14.9+ — Issue #322）
+
+在进入 brainstorming 前，检查 `CONTEXT.md` 是否已存在：
+
+```
+IF CONTEXT.md 存在于项目根目录:
+  → 读取已有设计上下文
+  → SKIP brainstorming（设计已存在，避免重复探索）
+  → 直接进入 Part B PLAN（使用已有 CONTEXT.md 和设计文档作为输入）
+  → 输出: "[sprint-flow] CONTEXT.md 已存在，跳过需求探索，直接进入共识评审"
+ELSE:
+  → 继续执行 Step 1（结构化需求探索）
+```
+
+**CONTEXT.md 预检路由表**:
+
+| CONTEXT.md 状态 | brainstorming | 输入到 Part B | 说明 |
+|----------------|---------------|---------------|------|
+| 不存在 | ✅ 执行 | brainstorming 输出 + autoplan 输出 | 标准路径 |
+| 存在 | ❌ SKIP | 已有 CONTEXT.md + 设计文档 | 快速路径 (Issue #322) |
+
 ### 调用 Skills
 
 - `brainstorming` (superpowers) — **HARD-GATE**: 设计未批准 → 不可进入实现
@@ -102,14 +123,18 @@ skill(name="brainstorming", user_message="[需求描述]")
 skill(name="design-shotgun", user_message="[Pain Document 内容 + 需求描述]")
 ```
 
-#### Step 0.5: DESIGN 路由分叉（v0.14.0+ — Issue #306）
+#### Step 0.5: DESIGN 路由分叉（v0.14.0+ — Issue #306, #322）
 
-根据 Phase 1/6 PREP (AUTO-ESTIMATE) 的 `change_type` 决定走哪条路径：
+根据 Phase 1/6 PREP (AUTO-ESTIMATE) 的 `change_type` 以及 Part A 的 CONTEXT.md 预检结果，决定走哪条路径：
 
 ```
 读取 .sprint-state/sprint-state.json → auto_estimate.change_type
+读取 CONTEXT.md 存在状态
 
-IF change_type == "修改已存在代码":
+IF CONTEXT.md 存在（Part A Step 0 预检结果）:
+  → 快速路径: SKIP brainstorming, 使用已有 CONTEXT.md + 设计文档
+  → 直接进入 autoplan (标准) 或 delphi-review (增量)
+ELSE IF change_type == "修改已存在代码":
   → 增量优化路径: SKIP autoplan
   → 直接进入 Step 2b: delphi-review (lightweight: 2 专家, 1 轮)
 ELSE (change_type == "新增功能" 或 未定义):
@@ -118,11 +143,12 @@ ELSE (change_type == "新增功能" 或 未定义):
 
 **路由决策表**:
 
-| change_type | 路径 | autoplan | delphi-review |
-|------------|------|----------|---------------|
-| `修改已存在代码` | 增量优化 | ❌ SKIP | lightweight (2 专家, 1 轮) |
-| `新增功能` | 标准 | ✅ 执行 | 标准 (3 专家) |
-| `undefined` / 缺失 | 标准 (fail-safe) | ✅ 执行 | 标准 (3 专家) |
+| CONTEXT.md | change_type | brainstorming | autoplan | delphi-review |
+|-----------|------------|---------------|----------|---------------|
+| 存在 | 任意 | ❌ SKIP | ✅ 执行 (标准) | 标准 (3 专家) |
+| 不存在 | `修改已存在代码` | ✅ 执行 | ❌ SKIP | lightweight (2 专家, 1 轮) |
+| 不存在 | `新增功能` | ✅ 执行 | ✅ 执行 | 标准 (3 专家) |
+| 不存在 | `undefined` / 缺失 | ✅ 执行 | ✅ 执行 | 标准 (3 专家) |
 
 **HARD-GATE 不变**: 两条路径最终都必须产出 APPROVED 的 delphi-reviewed.json。
 

package/plugins/claude-code/skills/test-specification-alignment/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/TEST-SPECIFICATION-ALIGNMENT KNOWLEDGE BASE
 
-**Generated:** 2026-07-10
-**Commit:** a9276f6
-**Branch:** main
-**Version:** 0.14.6.2
+**Generated:** 2026-07-13
+**Commit:** cb954fe
+**Branch:** sprint/2026-07-13-01
+**Version:** 0.14.9.0
 
 ## OVERVIEW
 Test-Specification Alignment Engine — two-stage validation ensuring tests accurately reflect requirements and design specs.

package/plugins/opencode/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@boyingliu01/opencode-plugin",
-  "version": "0.14.7",
+  "version": "0.14.9",
   "type": "module",
   "main": "index.ts",
   "description": "XP-Gate quality gates + AI workflow skills + Sprint Flow TUI sidebar for OpenCode",

package/plugins/opencode/skills/delphi-review/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/DELPHI-REVIEW KNOWLEDGE BASE
 
-**Generated:** 2026-07-10
-**Commit:** a9276f6
-**Branch:** main
-**Version:** 0.14.6.2
+**Generated:** 2026-07-13
+**Commit:** cb954fe
+**Branch:** sprint/2026-07-13-01
+**Version:** 0.14.9.0
 
 ## OVERVIEW
 Delphi Consensus Review — multi-round anonymous expert review (≥90% threshold, 3 experts from ≥2 providers, domestic models only). Supports design + code-walkthrough modes.

package/plugins/opencode/skills/sprint-flow/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/SPRINT-FLOW KNOWLEDGE BASE
 
-**Generated:** 2026-07-10
-**Commit:** a9276f6
-**Branch:** main
-**Version:** 0.14.6.2
+**Generated:** 2026-07-13
+**Commit:** cb954fe
+**Branch:** sprint/2026-07-13-01
+**Version:** 0.14.9.0
 
 ## OVERVIEW
 **6-phase** development pipeline (v2.0 compact redesign, Issue #290): PREP → DESIGN → BUILD → VERIFY → SHIP → CLOSE. Phase 3/6 BUILD default build mode is **ralph-loop** (REQ-level iteration, 40-67% token savings vs parallel). HARD-GATE between DESIGN (2/6) and BUILD (3/6): design must pass Delphi review (≥90% consensus) before any coding.

package/plugins/opencode/skills/sprint-flow/SKILL.md

@@ -167,7 +167,7 @@ PREP → DESIGN → BUILD → VERIFY → SHIP → CLOSE
 | Phase | Name | Key Actions | Output |
 |-------|------|-------------|--------|
 | 1/6 | PREP | Detect protected branch → Create git worktree → AUTO-ESTIMATE sizing → Classify (lightweight/standard/complex) | Worktree path + impact assessment |
-| 2/6 | DESIGN | brainstorming → autoplan → delphi-review (HARD-GATE ≥90% consensus) → to-issues → specification.yaml | specification.yaml + slices-manifest.json |
+| 2/6 | DESIGN | CONTEXT.md 预检 (#322) → brainstorming (如需要) → autoplan → delphi-review (HARD-GATE ≥90% consensus) → to-issues → specification.yaml | specification.yaml + slices-manifest.json |
 | 3/6 | BUILD | GITHOOKS-GATE → DELPHI-GATE → ralph-loop (default) or parallel → TDD → freeze → blind review → verification | MVP code |
 | 4/6 | VERIFY | delphi-review --mode code-walkthrough → test-specification-alignment → browse QA → learn + retro | Review report + feedback-log.md |
 | 5/6 | SHIP | VERSION-GATE → finishing-a-development-branch → ship (create PR) → land-and-deploy → merge to main + CI + canary | PR URL + deploy status + merge confirmation |

package/plugins/opencode/skills/sprint-flow/references/phase-2-design.md

@@ -11,6 +11,27 @@
 
 ## Part A: THINK（需求探索与设计）
 
+### Step 0: CONTEXT.md 预检（v0.14.9+ — Issue #322）
+
+在进入 brainstorming 前，检查 `CONTEXT.md` 是否已存在：
+
+```
+IF CONTEXT.md 存在于项目根目录:
+  → 读取已有设计上下文
+  → SKIP brainstorming（设计已存在，避免重复探索）
+  → 直接进入 Part B PLAN（使用已有 CONTEXT.md 和设计文档作为输入）
+  → 输出: "[sprint-flow] CONTEXT.md 已存在，跳过需求探索，直接进入共识评审"
+ELSE:
+  → 继续执行 Step 1（结构化需求探索）
+```
+
+**CONTEXT.md 预检路由表**:
+
+| CONTEXT.md 状态 | brainstorming | 输入到 Part B | 说明 |
+|----------------|---------------|---------------|------|
+| 不存在 | ✅ 执行 | brainstorming 输出 + autoplan 输出 | 标准路径 |
+| 存在 | ❌ SKIP | 已有 CONTEXT.md + 设计文档 | 快速路径 (Issue #322) |
+
 ### 调用 Skills
 
 - `brainstorming` (superpowers) — **HARD-GATE**: 设计未批准 → 不可进入实现
@@ -102,14 +123,18 @@ skill(name="brainstorming", user_message="[需求描述]")
 skill(name="design-shotgun", user_message="[Pain Document 内容 + 需求描述]")
 ```
 
-#### Step 0.5: DESIGN 路由分叉（v0.14.0+ — Issue #306）
+#### Step 0.5: DESIGN 路由分叉（v0.14.0+ — Issue #306, #322）
 
-根据 Phase 1/6 PREP (AUTO-ESTIMATE) 的 `change_type` 决定走哪条路径：
+根据 Phase 1/6 PREP (AUTO-ESTIMATE) 的 `change_type` 以及 Part A 的 CONTEXT.md 预检结果，决定走哪条路径：
 
 ```
 读取 .sprint-state/sprint-state.json → auto_estimate.change_type
+读取 CONTEXT.md 存在状态
 
-IF change_type == "修改已存在代码":
+IF CONTEXT.md 存在（Part A Step 0 预检结果）:
+  → 快速路径: SKIP brainstorming, 使用已有 CONTEXT.md + 设计文档
+  → 直接进入 autoplan (标准) 或 delphi-review (增量)
+ELSE IF change_type == "修改已存在代码":
   → 增量优化路径: SKIP autoplan
   → 直接进入 Step 2b: delphi-review (lightweight: 2 专家, 1 轮)
 ELSE (change_type == "新增功能" 或 未定义):
@@ -118,11 +143,12 @@ ELSE (change_type == "新增功能" 或 未定义):
 
 **路由决策表**:
 
-| change_type | 路径 | autoplan | delphi-review |
-|------------|------|----------|---------------|
-| `修改已存在代码` | 增量优化 | ❌ SKIP | lightweight (2 专家, 1 轮) |
-| `新增功能` | 标准 | ✅ 执行 | 标准 (3 专家) |
-| `undefined` / 缺失 | 标准 (fail-safe) | ✅ 执行 | 标准 (3 专家) |
+| CONTEXT.md | change_type | brainstorming | autoplan | delphi-review |
+|-----------|------------|---------------|----------|---------------|
+| 存在 | 任意 | ❌ SKIP | ✅ 执行 (标准) | 标准 (3 专家) |
+| 不存在 | `修改已存在代码` | ✅ 执行 | ❌ SKIP | lightweight (2 专家, 1 轮) |
+| 不存在 | `新增功能` | ✅ 执行 | ✅ 执行 | 标准 (3 专家) |
+| 不存在 | `undefined` / 缺失 | ✅ 执行 | ✅ 执行 | 标准 (3 专家) |
 
 **HARD-GATE 不变**: 两条路径最终都必须产出 APPROVED 的 delphi-reviewed.json。
 

package/plugins/opencode/skills/test-specification-alignment/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/TEST-SPECIFICATION-ALIGNMENT KNOWLEDGE BASE
 
-**Generated:** 2026-07-10
-**Commit:** a9276f6
-**Branch:** main
-**Version:** 0.14.6.2
+**Generated:** 2026-07-13
+**Commit:** cb954fe
+**Branch:** sprint/2026-07-13-01
+**Version:** 0.14.9.0
 
 ## OVERVIEW
 Test-Specification Alignment Engine — two-stage validation ensuring tests accurately reflect requirements and design specs.