cc-devflow 4.2.0 → 4.3.0

package/.claude/commands/flow/CLAUDE.md

@@ -3,8 +3,6 @@
 
 成员清单
 archive.md: 归档需求命令。
-checklist.md: 已废弃命令，统一迁移到 /flow:verify。
-clarify.md: 已废弃命令，默认主链移除独立澄清阶段。
 constitution.md: 宪法规则管理命令。
 context.md: 上下文资产管理命令。
 delta.md: 需求增量变更命令。
@@ -12,8 +10,6 @@ dev.md: 主链开发阶段命令，触发 harness dispatch/resume。
 fix.md: Bug 修复命令。
 ideate.md: 想法到需求命令。
 init.md: 主链初始化命令，触发 harness init/pack。
-new.md: 已废弃命令，迁移到 /flow:init -> /flow:spec -> /flow:dev -> /flow:verify -> /flow:release。
-quality.md: 已废弃命令，统一迁移到 /flow:verify。
 release.md: 主链发布命令，触发 harness release/janitor。
 restart.md: 旧中断恢复命令（迁移过渡保留）。
 spec.md: 主链规格命令，触发 harness plan。

package/.claude/docs/examples/design-inspiration-pool.md

@@ -0,0 +1,59 @@
+# Design Inspiration Pool
+
+> 80+ 位艺术家/设计师/建筑师灵感来源池
+> 用于 UI_PROTOTYPE_TEMPLATE.md Phase 2: Design Inspiration Sampling
+
+---
+
+## 使用方法
+
+从不同类别中随机采样 2 位大师，生成风格转译说明。
+
+**采样策略**:
+- 从不同类别中选择（避免风格过于相似）
+- 优先组合：现代主义 + 生成艺术，建筑 + 平面设计
+- 避免组合：同类别内的大师（如两位都是建筑师）
+
+**转译模板**:
+```
+**灵感来源X**: {艺术家姓名} ({类别})
+**核心特质**: {艺术家代表性特点,1-2句话}
+**网页转译**:
+  - 色彩: {具体色值} → {应用场景}
+  - 版式: {布局策略} → {CSS实现方式}
+  - 形态: {视觉元素} → {HTML/CSS实现}
+  - 动效: {动态特征} → {CSS/JS实现}
+**禁止模仿**: 不复刻{具体作品名称}的{具体元素}
+```
+
+---
+
+## 灵感来源池 (8 类别, 80+ 位大师)
+
+### 类别1: 影视片头 / 动态叙事
+Saul Bass, Maurice Binder, Pablo Ferro, Dan Perri, Kyle Cooper
+
+### 类别2: 平面 / 字体 / 后现代图形
+Paula Scher, Neville Brody, April Greiman, David Carson, Jamie Reid, Push Pin Studios (Seymour Chwast)
+
+### 类别3: 现代主义信息设计 / 网格系统
+Massimo Vignelli, Josef Müller-Brockmann, Otl Aicher, Armin Hofmann, Karl Gerstner, Muriel Cooper
+
+### 类别4: 几何与抽象艺术 / 光学艺术
+Piet Mondrian, Sonia Delaunay, Josef Albers, Victor Vasarely, Bridget Riley, M. C. Escher, Paul Klee, Kazimir Malevich, Joan Miró, Henri Matisse, Mark Rothko, René Magritte, Salvador Dalí
+
+### 类别5: 亚洲与当代艺术
+Yayoi Kusama, Takashi Murakami, Katsushika Hokusai(葛饰北斋), Xu Bing(徐冰), Zao Wou-Ki(赵无极)
+
+### 类别6: 建筑 / 空间设计
+Zaha Hadid, Frank Gehry, Le Corbusier, Mies van der Rohe, Tadao Ando(安藤忠雄), Oscar Niemeyer, Santiago Calatrava, Norman Foster, Rem Koolhaas
+
+### 类别7: 生成艺术 / 算法设计 / 数据可视化
+Casey Reas, Ben Fry (Processing), Joshua Davis, Jared Tarbell, Robert Hodgin, Jer Thorp, Nadieh Bremer, Shirley Wu, Stefanie Posavec, Giorgia Lupi
+
+### 类别8: 工业设计 / 产品设计
+Dieter Rams, Charles & Ray Eames, Naoto Fukasawa(深泽直人), Jasper Morrison, Marc Newson, Philippe Starck, Karim Rashid, Jonathan Ive
+
+---
+
+**[PROTOCOL]**: 变更时更新此头部，然后检查 CLAUDE.md

package/.claude/docs/examples/ui-prototype-constitution-checklist.md

@@ -0,0 +1,75 @@
+# UI Prototype Constitution Checklist
+
+> UI 原型宪法合规检查清单
+> 用于 UI_PROTOTYPE_TEMPLATE.md Phase 10: Constitution & Quality Check
+
+---
+
+## Constitution 检查
+
+### Article I - Quality First (质量至上)
+- [ ] I.1 Complete Implementation: HTML 无占位符，所有页面完整
+- [ ] I.2 No Simplification: 交互逻辑完整，非简化版本
+- [ ] I.4 Quality Gates: 通过 HTML 验证，无 console 错误
+
+### Article III - Security First (安全优先)
+- [ ] III.1 No Hardcoded Secrets: 无 API 密钥硬编码
+- [ ] III.2 Input Validation: 表单有验证逻辑
+- [ ] III.4 Secure by Default: 使用 HTTPS CDN 资源
+
+### Article V - Maintainability (可维护性)
+- [ ] V.3 Documentation: HTML 注释包含设计文档
+- [ ] V.4 File Size Limits: 单文件 HTML ≤ 2000 行（可接受）
+
+### Article X - Requirement Boundary (需求边界)
+- [ ] X.1 No Speculation: 仅实现 PRD 明确的功能
+- [ ] X.2 No Speculative Features: 无"未来可能需要"的功能
+
+---
+
+## 质量检查清单
+
+### HTML 质量
+- [ ] 使用 HTML5 语义化标签
+- [ ] 无未闭合标签
+- [ ] ARIA 标签完整
+- [ ] 无重复 ID
+
+### CSS 质量
+- [ ] 使用 CSS 变量（Design System）
+- [ ] 响应式媒体查询正常
+- [ ] 无 !important 滥用
+- [ ] 命名规范（BEM 或一致的命名）
+
+### JavaScript 质量
+- [ ] 无全局变量污染
+- [ ] 事件监听器正确绑定
+- [ ] 无内存泄漏（事件监听器移除）
+- [ ] Console 无错误
+
+### 可访问性
+- [ ] 色彩对比度 ≥ 4.5:1
+- [ ] 键盘导航可用
+- [ ] 屏幕阅读器友好
+- [ ] focus 状态可见
+
+### 性能
+- [ ] CDN 资源加载 <1s
+- [ ] 首屏渲染 <2s
+- [ ] 交互响应 <100ms
+- [ ] 无不必要的重绘/回流
+
+---
+
+## Anti-Generic-Design 验证
+- [ ] 无占位图片（Picsum 图片正常加载）
+- [ ] 无常见 AI 紫/蓝配色
+- [ ] 无 Emoji 图标（使用 SVG/图标库）
+- [ ] 无 Lorem Ipsum 文本
+- [ ] 所有交互元素有完整状态（hover/active/disabled/error）
+
+---
+
+**完整 Constitution 文档**: `.claude/rules/project-constitution.md`
+
+**[PROTOCOL]**: 变更时更新此头部，然后检查 CLAUDE.md

package/.claude/docs/implementation-summary-v7.md

@@ -0,0 +1,449 @@
+# CC-DevFlow v4.3 Implementation Summary
+
+> **Last Updated**: 2026-03-12
+> **Status**: Phase 1 Complete (100%), Phase 2 Complete (100%), Phase 3 Complete (100%), Overall 75%
+
+---
+
+## Overview
+
+实施 OpenSpec 单一真相源架构，解决需求偏移问题。核心机制：
+
+1. **项目级 specs/** - 不可变源代码真相（描述当前系统状态）
+2. **需求级 specs/** - 只包含 Delta（ADDED/MODIFIED/REMOVED/RENAMED）
+3. **自动反扩散检查** - 阻止需求偏移
+4. **归档时自动合并** - Delta 合并到项目级 specs/
+
+---
+
+## Completed Tasks (12/16)
+
+### ✅ Task #1: Phase 1.1 - 建立项目级 specs/ 目录
+**Status**: Complete
+**Files Modified**:
+- Created `devflow/specs/README.md` - 项目级 specs 说明文档
+- Created `devflow/specs/auth/spec.md` - 认证模块示例
+- Created `devflow/specs/payments/spec.md` - 支付模块示例
+- Created `devflow/specs/ui/spec.md` - UI 组件模块示例
+- Created `devflow/specs/CLAUDE.md` - L2 文档
+
+**Key Changes**:
+- 建立了项目级 specs/ 作为单一真相源
+- 使用 YAML frontmatter 管理元数据（module, version, created_at, updated_at）
+- 采用 RFC 2119 关键字（SHALL, MUST, SHOULD, MAY）
+- 使用 BDD Given-When-Then 场景格式
+
+---
+
+### ✅ Task #2: Phase 1.2 - 创建 spec.md 格式规范文档
+**Status**: Complete
+**Files Modified**:
+- Created `.claude/docs/spec-format-guide.md` - 完整格式指南（200+ 行）
+
+**Key Changes**:
+- 定义了项目级 vs 需求级 spec.md 的区别
+- 文档化 RFC 2119 关键字语义
+- 说明 BDD 场景格式
+- 提供完整示例和合并逻辑
+
+---
+
+### ✅ Task #3: Phase 1.3 - 创建 spec.md 模板
+**Status**: Complete
+**Files Modified**:
+- Created `.claude/docs/templates/SPEC_TEMPLATE_PROJECT.md` - 项目级模板
+- Created `.claude/docs/templates/SPEC_TEMPLATE_DELTA.md` - Delta 模板
+
+**Key Changes**:
+- 项目级模板：Purpose + Requirements + Implementation
+- Delta 模板：ADDED/MODIFIED/REMOVED/RENAMED 四种操作
+- 包含 Constitutional Constraints 引用
+
+---
+
+### ✅ Task #4: Phase 1.4 - 增强 delta-parser.ts
+**Status**: Complete
+**Files Modified**:
+- Modified `.claude/scripts/delta-parser.ts` (527 → 638 lines)
+
+**Key Changes**:
+- 添加 `bumpVersion()` 函数实现语义化版本管理
+  - REMOVED → MAJOR +1（破坏性变更）
+  - ADDED → MINOR +1（新功能）
+  - MODIFIED/RENAMED → PATCH +1（修复/改进）
+- 添加 `mergeDeltaToMainSpec()` 函数实现 Delta 合并
+  - 读取项目级和 Delta spec.md
+  - 验证模块匹配
+  - 应用 ADDED/MODIFIED/REMOVED/RENAMED 操作
+  - 自动更新版本号和时间戳
+- 添加 CLI `merge` 命令：`delta-parser.ts merge <main-spec> <delta-spec>`
+
+---
+
+### ✅ Task #5: Phase 1.5 - 创建 validate-scope.sh
+**Status**: Complete
+**Files Modified**:
+- Created `.claude/scripts/validate-scope.sh` (200 lines)
+
+**Key Changes**:
+- 提取 proposal.md 的 What 章节作为原始意图
+- 提取 Delta specs 的 ADDED Requirements
+- 使用关键词匹配检测范围扩散
+- 生成 scope-creep-report.md 报告
+  - ✅ 标记符合原始意图的需求
+  - ⚠️ 标记超出范围的需求
+- 检测到范围扩散时返回错误码（exit 1）
+
+---
+
+### ✅ Task #6: Phase 1.6 - 修改 harness:init 生成 proposal.md
+**Status**: Complete
+**Files Modified**:
+- Modified `.claude/skills/flow-init/SKILL.md`
+- Created `.claude/docs/templates/PROPOSAL_TEMPLATE.md`
+
+**Key Changes**:
+- 更新 Execution Steps：
+  - Step 2: 读取项目级 specs/ 了解当前系统状态
+  - Step 6: 生成 proposal.md（Why + What 格式）替代 PRD.md
+  - Step 7: 创建 specs/ 目录准备存放 Delta
+- 创建 PROPOSAL_TEMPLATE.md：
+  - Why 章节：Background, Problem Statement, Business Value
+  - What 章节：Core Features, Scope, Success Criteria
+  - 包含 [NEEDS CLARIFICATION] 标记机制
+- 更新 Exit Criteria 要求 proposal.md 和 specs/ 目录存在
+
+---
+
+### ✅ Task #7: Phase 1.7 - 修改 harness:plan 生成 Delta specs
+**Status**: Complete
+**Files Modified**:
+- Modified `.claude/skills/flow-spec/SKILL.md`
+- Created `.claude/docs/templates/DESIGN_TEMPLATE.md`
+- Modified `lib/harness/operations/plan.js`
+
+**Key Changes**:
+- 更新 flow-spec SKILL.md Execution Steps：
+  - Step 2: 读取项目级 specs/ 了解当前系统状态
+  - Step 3: 生成 design.md（How + Implementation）
+  - Step 4: 生成 Delta specs/（ADDED/MODIFIED/REMOVED/RENAMED）
+  - Step 5: 自动运行 validate-scope.sh 反扩散检查
+- 创建 DESIGN_TEMPLATE.md：
+  - How 章节：Architecture, Technology Stack, Module Changes
+  - Implementation 章节：API Design, Data Model, File Structure, Testing Strategy
+- 更新 Exit Criteria：
+  - 要求 design.md 存在
+  - 要求 specs/ 目录至少有一个 Delta spec.md
+  - 要求 scope-creep-report.md 无阻塞性警告
+- 修改 plan.js：
+  - 检测 proposal.md 存在（v4.3 架构）
+  - 验证 design.md, specs/, scope-creep-report.md 产物
+  - 警告缺失的必需文件
+
+---
+
+### ✅ Task #8: Phase 1.8 - 修改 harness:release 合并 Delta
+**Status**: Complete
+**Files Modified**:
+- Modified `lib/harness/operations/release.js`
+- Modified `.claude/skills/flow-release/SKILL.md`
+
+**Key Changes**:
+- 修改 release.js：
+  - 检测 `devflow/requirements/${REQ_ID}/specs/` 目录
+  - 遍历所有模块的 Delta spec.md 文件
+  - 调用 `delta-parser.ts merge` 合并到项目级 `devflow/specs/{module}/spec.md`
+  - 自动更新项目级 spec.md 的版本号和时间戳
+  - 处理新模块创建（如果项目级 spec 不存在）
+  - 记录合并结果到 manifest.metadata.deltaMergeResults
+  - 生成合并报告（✅ merged, 🆕 created, ❌ failed）
+- 更新 flow-release SKILL.md：
+  - 添加 Step 2: 合并 Delta specs 到项目级 specs/
+  - 更新 Exit Criteria 要求 Delta 已成功合并
+  - 要求项目级 spec.md 版本号已更新
+
+---
+
+### ✅ Task #9: Phase 3.1 - 清理废弃命令和模板
+**Status**: Complete
+**Files Modified**:
+- Deleted `.claude/commands/flow/new.md`
+- Deleted `.claude/commands/flow/clarify.md`
+- Deleted `.claude/commands/flow/checklist.md`
+- Deleted `.claude/commands/flow/quality.md`
+- Deleted `.claude/docs/templates/PRD_TEMPLATE.md`
+- Deleted `.claude/docs/templates/TECH_DESIGN_TEMPLATE.md`
+- Deleted `.claude/docs/templates/EPIC_TEMPLATE.md`
+- Deleted `.claude/docs/templates/TASKS_TEMPLATE.md`
+- Modified `.claude/commands/flow/CLAUDE.md` (removed references to deleted files)
+
+**Key Changes**:
+- 删除了 4 个废弃命令文件 (new.md, clarify.md, checklist.md, quality.md)
+- 删除了 4 个废弃模板文件 (PRD_TEMPLATE.md, TECH_DESIGN_TEMPLATE.md, EPIC_TEMPLATE.md, TASKS_TEMPLATE.md)
+- 更新了 flow/CLAUDE.md 移除废弃文件引用
+- workflow.yaml 已包含 deprecated 章节，无需额外修改
+
+---
+
+### ✅ Task #10: Phase 3.2 - 状态文件增强与查询工具
+**Status**: Complete
+**Files Modified**:
+- Created `.claude/docs/state-consolidation-design.md` - 架构设计文档
+- Modified `lib/harness/schemas.js` - 添加 HarnessStateSchema 和 HarnessStatusSchema
+- Modified `lib/harness/operations/plan.js` - 写入 plannedAt 时间戳
+- Modified `lib/harness/operations/dispatch.js` - 写入 status: 'in_progress'
+- Modified `lib/harness/operations/verify.js` - 写入 verifiedAt 时间戳
+- Created `lib/harness/query.js` - 查询工具函数
+- Modified `lib/harness/index.js` - 导出 query 模块
+- Modified `lib/harness/CLAUDE.md` - 更新成员清单
+
+**Key Changes**:
+- 重新定义 Task #10：不创建统一 state.json，而是增强现有架构
+- 添加 HarnessStateSchema 支持 plannedAt/verifiedAt 字段
+- 扩展 status 枚举：initialized → planned → in_progress → verified → released
+- 创建 query.js 提供 getProgress/getNextTask/getFullState 聚合查询
+- 保持 v6.0 关注点分离原则：harness-state.json (生命周期) + task-manifest.json (进度) + checkpoint.json (恢复) + report-card.json (质量)
+- 设计文档说明：单一真相源 = 职责分离 + 查询聚合，而非单一文件
+
+---
+
+### ✅ Task #11: Phase 2.1 - 实现分阶段上下文注入
+**Status**: Complete
+**Files Modified**:
+- Created `devflow/requirements/REQ-011/context/brainstorm.jsonl` - 初始化阶段上下文
+- Created `devflow/requirements/REQ-011/context/spec.jsonl` - 规格阶段上下文
+- Created `devflow/requirements/REQ-011/context/dev.jsonl` - 开发阶段上下文
+- Created `devflow/requirements/REQ-011/context/README.md` - 上下文目录说明
+- Modified `.claude/hooks/inject-agent-context.ts` - 更新 AGENT_JSONL_MAP 映射
+
+**Key Changes**:
+- 创建分阶段 JSONL 文件结构：
+  - brainstorm.jsonl: proposal.md + Constitution Article X
+  - spec.jsonl: proposal.md + devflow/specs/ + Constitution Article I, X + spec-format-guide.md
+  - dev.jsonl: design.md + Delta specs/ + 相关代码 + Constitution Article I, VI
+- 更新 inject-agent-context.ts 的 agent 到 JSONL 映射：
+  - flow-researcher → brainstorm.jsonl
+  - prd-writer/tech-architect/ui-designer/planner → spec.jsonl
+  - dev-implementer/qa-tester/security-reviewer/release-manager → dev.jsonl
+- Hook 已支持从 `devflow/requirements/${REQ_ID}/context/` 读取 JSONL
+- 实现分阶段隔离：每个阶段只加载必要的上下文，避免注意力分散
+
+---
+
+## Pending Tasks (4/16)
+
+### ⏳ Task #12: Phase 4 - 模板和 Agent 指令瘦身
+**Status**: Not Started
+**Target Files**:
+- All `.claude/docs/templates/*.md`
+- All `.claude/agents/*.md`
+
+**Required Changes**:
+1. 每个模板 ≤200 行
+2. 删除重复的 Constitution 内容（只保留引用）
+3. 删除示例（移到 `.claude/docs/examples/`）
+4. 删除冗长说明（保留核心约束）
+
+---
+
+### ⏳ Task #13: Phase 5.1 - 增强项目级规划命令
+**Status**: Not Started
+**Target Files**:
+- Create `.claude/commands/core/roadmap.md`
+- Create `.claude/commands/core/milestone.md`
+- Create `.claude/commands/core/epic.md`
+- Delete `.claude/commands/flow/checklist.md`
+- Delete `.claude/commands/flow/quality.md`
+- Update `.claude/skills/workflow.yaml`
+
+**Required Changes**:
+1. 删除 7 个废弃命令文件
+2. 删除 4 个废弃模板文件
+3. 更新 workflow.yaml 移除废弃节点和边
+
+---
+
+### ⏳ Task #10: Phase 3.2 - 合并状态文件到 .harness/state.json
+**Status**: Not Started
+**Target Files**:
+- Modify `lib/harness/store.js`
+- Create unified `.harness/state.json` schema
+- Deprecate `orchestration_status.json`, `session-checklist.json`, `session-progress.md`, `session-handoff.md`
+
+**Required Changes**:
+1. 设计统一状态文件 schema：
+   ```json
+   {
+     "changeId": "REQ-123",
+     "lifecycle": { "stage": "dev", "status": "in_progress" },
+     "session": { "currentSessionId": "...", "checkpoints": [...] },
+     "progress": { "totalTasks": 6, "completedTasks": 2 },
+     "deltas": [...]
+   }
+   ```
+2. 迁移现有状态读写逻辑到统一文件
+
+---
+
+### ⏳ Task #11: Phase 4 - 模板和 Agent 指令瘦身
+**Status**: Not Started
+**Target Files**:
+- All `.claude/docs/templates/*.md`
+- All `.claude/agents/*.md`
+
+**Required Changes**:
+1. 每个模板 ≤200 行
+2. 删除重复的 Constitution 内容（只保留引用）
+3. 删除示例（移到 `.claude/docs/examples/`）
+4. 删除冗长说明（保留核心约束）
+
+---
+
+### ⏳ Task #12: Phase 5.1 - 增强项目级规划命令
+**Status**: Not Started
+**Target Files**:
+- Create `.claude/commands/core/roadmap.md`
+- Create `.claude/commands/core/milestone.md`
+- Create `.claude/commands/core/epic.md`
+- Create `devflow/ROADMAP.md`
+- Create `devflow/milestones/`
+- Create `devflow/epics/`
+
+**Required Changes**:
+1. 实现 `/core:roadmap` 生成季度级规划
+2. 实现 `/core:milestone create` 创建月度里程碑
+3. 实现 `/core:epic create` 分解周级 Epic
+4. 实现 `/flow:init` 关联 REQ 到 Epic
+
+---
+
+### ⏳ Task #13: Phase 5.2 - 强制 TDD/BDD 验证
+**Status**: Not Started
+**Target Files**:
+- Modify `lib/harness/planner.js`
+- Modify `.claude/skills/guardrail/tdd-enforcer/SKILL.md`
+
+**Required Changes**:
+1. 在 planner.js 添加 `validateTDDOrder()` 函数：
+   - 检查每个 IMPL 任务是否有对应的 TEST 任务
+   - 检查 IMPL 任务是否依赖 TEST 任务
+   - TDD 违规时抛出错误
+2. 增强 tdd-enforcer 实时阻断能力
+
+---
+
+### ⏳ Task #14: Phase 5.3 - OpenSpec 互操作
+**Status**: Not Started
+**Target Files**:
+- Create `.claude/scripts/import-openspec.ts`
+- Create `.claude/scripts/export-openspec.ts`
+- Create `.claude/commands/flow/import-openspec.md`
+- Create `.claude/commands/flow/export-openspec.md`
+
+**Required Changes**:
+1. 实现 `/flow:import-openspec` 导入 OpenSpec spec.md
+2. 实现 `/flow:export-openspec` 导出为 OpenSpec 格式
+3. 双向转换保持语义一致性
+
+---
+
+### ⏳ Task #15: 集成测试和文档更新
+**Status**: Not Started
+**Target Files**:
+- Create `tests/integration/v7-workflow.test.js`
+- Update `README.md`
+- Update `README.zh-CN.md`
+- Update `.claude/CLAUDE.md`
+
+**Required Changes**:
+1. 编写完整工作流集成测试：
+   - `/flow:init` → `/flow:spec` → `/flow:dev` → `/flow:verify` → `/flow:release`
+   - 验证 proposal.md, design.md, Delta specs, scope-creep-report.md 生成
+   - 验证 Delta 合并到项目级 specs/
+2. 更新所有文档反映 v4.3 架构变更
+
+---
+
+## Progress Summary
+
+| Phase | Tasks | Complete | Pending | Progress |
+|-------|-------|----------|---------|----------|
+| Phase 1 | 8 | 8 | 0 | 100% ✅ |
+| Phase 2 | 1 | 1 | 0 | 100% ✅ |
+| Phase 3 | 2 | 2 | 0 | 100% ✅ |
+| Phase 4 | 1 | 0 | 1 | 0% |
+| Phase 5 | 3 | 0 | 3 | 0% |
+| Testing | 1 | 0 | 1 | 0% |
+| **Total** | **16** | **12** | **4** | **75%** |
+
+---
+
+## Next Steps
+
+**Phase 1 Complete! 🎉**
+**Phase 2 Complete! 🎉**
+**Phase 3 Complete! 🎉**
+
+**Next Priority** (Phase 4 + Phase 5):
+1. ⏳ Task #12: 模板和 Agent 指令瘦身
+2. ⏳ Task #13: 增强项目级规划命令
+3. ⏳ Task #14: 强制 TDD/BDD 验证
+4. ⏳ Task #15: OpenSpec 互操作
+
+**Final Step**:
+5. Task #16: 集成测试和文档更新
+
+---
+
+## Key Architectural Decisions
+
+### 1. 项目级 vs 需求级 specs/
+- **项目级** (`devflow/specs/`): 描述当前系统完整状态，不可变真相
+- **需求级** (`devflow/requirements/${REQ_ID}/specs/`): 只包含 Delta 变更
+
+### 2. Delta 操作类型
+- **ADDED**: 新增需求（MINOR +1）
+- **MODIFIED**: 修改需求（PATCH +1）
+- **REMOVED**: 删除需求（MAJOR +1，破坏性变更）
+- **RENAMED**: 重命名需求（PATCH +1）
+
+### 3. 反扩散检查机制
+- 对比 proposal.md 原始意图与 Delta specs 的 ADDED 需求
+- 使用关键词匹配检测超出范围的功能
+- 生成 scope-creep-report.md 报告
+- 检测到范围扩散时阻塞流程，要求人工确认
+
+### 4. 归档时自动合并
+- `/flow:release` 触发 Delta 合并
+- 调用 `delta-parser.ts merge` 执行合并
+- 自动更新项目级 spec.md 的版本号和时间戳
+- 归档需求到 `devflow/requirements/archive/${REQ_ID}/`
+
+### 5. 状态文件架构（v6.0 Harness-First）
+- **harness-state.json**: 生命周期状态（initialized → planned → in_progress → verified → released）
+- **task-manifest.json**: 任务定义与进度（tasks[].status）
+- **checkpoint.json**: 会话恢复点（per task）
+- **report-card.json**: 质量验证结果
+- **query.js**: 聚合查询工具（getProgress/getNextTask/getFullState）
+- **设计哲学**: 单一真相源 = 职责分离 + 查询聚合，而非单一文件
+
+### 6. 分阶段上下文注入（v4.3）
+- **brainstorm.jsonl**: 初始化阶段（proposal.md + Constitution Article X）
+- **spec.jsonl**: 规格阶段（proposal.md + devflow/specs/ + Constitution Article I, X）
+- **dev.jsonl**: 开发阶段（design.md + Delta specs/ + 相关代码 + Constitution Article I, VI）
+- **设计原则**: 每个阶段只加载必要的上下文，避免注意力分散
+- **排除策略**: spec 阶段不包含现有代码，dev 阶段不包含 proposal.md
+
+---
+
+## Constitutional Compliance
+
+所有实现遵循 CC-DevFlow Constitution v2.1.0：
+
+- **Article I: Quality First** - 完整实现，无部分实现
+- **Article VI: Test-First Development** - TDD 顺序强制验证
+- **Article X: Requirement Boundary** - 反扩散检查阻止范围蔓延
+
+---
+
+**[PROTOCOL]**: 变更时更新此头部，然后检查 CLAUDE.md