cc-devflow 1.0.2 → 2.4.0

package/README.md

@@ -29,6 +29,7 @@ Complete automated workflow from PRD generation to code delivery with `/flow-new
 - 🔍 **Consistency Verification** - Enterprise-grade consistency checking with intelligent conflict detection
 - 🧪 **TDD Enforced** - Strict Test-Driven Development with TEST VERIFICATION CHECKPOINT
 - 📜 **Constitution** - 10 Articles governing quality, security, and architecture
+- 🔄 **Autonomous Development** - Ralph × Manus Integration for memory-enhanced continuous iteration
 - 🔌 **Multi-Platform Support** - Compile workflows for Codex, Cursor, Qwen, Antigravity via `npm run adapt`
 
 ---
@@ -239,6 +240,8 @@ bash .claude/tests/constitution/run_all_constitution_tests.sh
 | `/flow-init` | 📦 Initialize Requirement | `/flow-init "REQ-123\|Feature"` | [→](docs/commands/flow-init.md) |
 | `/flow-clarify` | 🔎 Clarify Ambiguities | `/flow-clarify "REQ-123"` | [→](.claude/commands/flow-clarify.md) |
 | `/flow-checklist` | ✅ Requirement Quality Check | `/flow-checklist --type ux` | [→](.claude/commands/flow-checklist.md) |
+| `/flow-review` | �� Two-Stage Code Review | `/flow-review "REQ-123"` | [→](.claude/commands/flow-review.md) |
+| `/flow-fix` | 🐛 Systematic Bug Fix | `/flow-fix "BUG-123\|Description"` | [→](.claude/commands/flow-fix.md) |
 | `/flow-verify` | 🔍 Verify Consistency | `/flow-verify "REQ-123"` | [→](docs/commands/flow-verify.md) |
 | `/flow-qa` | 🧪 Quality Assurance | `/flow-qa "REQ-123"` | [→](docs/commands/flow-qa.md) |
 | `/flow-release` | 🚢 Create Release | `/flow-release "REQ-123"` | [→](docs/commands/flow-release.md) |
@@ -275,42 +278,44 @@ The following Mermaid diagram illustrates the complete cc-devflow workflow, incl
 ```mermaid
 graph TB
     Start([Start Project]) --> ProjectLevel{Project-Level Setup}
-    
+
     ProjectLevel --> CoreRoadmap["/core-roadmap<br/>ROADMAP.md & BACKLOG.md"]
     ProjectLevel --> CoreArch["/core-architecture<br/>ARCHITECTURE.md"]
     ProjectLevel --> CoreGuidelines["/core-guidelines<br/>frontend/backend guidelines"]
     ProjectLevel --> CoreStyle["/core-style<br/>STYLE.md"]
-    
+
     CoreRoadmap --> ReqLevel
     CoreArch --> ReqLevel
     CoreGuidelines --> ReqLevel
     CoreStyle --> ReqLevel
-    
-    ReqLevel([Requirement-Level Development]) --> FlowInit["/flow-init<br/>research.md & tasks.json"]
-    
+
+    ReqLevel([Requirement-Level Development]) --> FlowInit["/flow-init<br/>research.md & BRAINSTORM.md"]
+
     FlowInit --> FlowClarify["/flow-clarify<br/>clarifications/*.md<br/>Optional"]
-    FlowClarify --> FlowPRD["/flow-prd<br/>PRD.md"]
+    FlowClarify --> FlowPRD["/flow-prd<br/>PRD.md<br/>BRAINSTORM alignment"]
     FlowInit -.->|Skip clarify| FlowPRD
     FlowPRD --> FlowChecklist["/flow-checklist<br/>checklists/*.md<br/>80% Gate"]
     FlowPRD --> FlowTech["/flow-tech<br/>TECH_DESIGN.md & data-model"]
     FlowPRD --> FlowUI["/flow-ui<br/>UI_PROTOTYPE.html<br/>Optional"]
 
     FlowChecklist --> FlowEpic
-    FlowTech --> FlowEpic["/flow-epic<br/>EPIC.md & TASKS.md"]
+    FlowTech --> FlowEpic["/flow-epic<br/>EPIC.md & TASKS.md<br/>bite-sized tasks"]
     FlowUI --> FlowEpic
-    
-    FlowEpic --> FlowDev["/flow-dev<br/>TASKS.md execution<br/>TDD enforced"]
-    
-    FlowDev --> FlowQA["/flow-qa<br/>QA reports & Security"]
-    
-    FlowQA --> FlowRelease["/flow-release<br/>PR creation & Deployment"]
-    
+
+    FlowEpic --> FlowDev["/flow-dev<br/>TASKS.md execution<br/>TDD Checkpoint"]
+
+    FlowDev --> FlowReview["/flow-review<br/>Two-Stage Review<br/>Spec → Quality"]
+
+    FlowReview --> FlowQA["/flow-qa<br/>QA reports & Security"]
+
+    FlowQA --> FlowRelease["/flow-release<br/>PR creation<br/>Branch decision"]
+
     FlowRelease --> FlowVerify["/flow-verify<br/>Consistency check"]
-    
+
     FlowVerify --> End([Release Complete])
-    
+
     FlowVerify -.->|Can be called at any stage| ReqLevel
-    
+
     style ProjectLevel fill:#e1f5ff
     style ReqLevel fill:#fff4e1
     style FlowInit fill:#e8f5e9
@@ -321,6 +326,7 @@ graph TB
     style FlowUI fill:#fff9c4
     style FlowEpic fill:#e8f5e9
     style FlowDev fill:#f3e5f5
+    style FlowReview fill:#e1bee7
     style FlowQA fill:#fce4ec
     style FlowRelease fill:#e0f2f1
     style FlowVerify fill:#e3f2fd
@@ -329,10 +335,12 @@ graph TB
 **Workflow Notes**:
 - **Project-Level Commands** (light blue): Execute once at project initialization, establish global standards (SSOT)
 - **Requirement-Level Commands** (light orange): Execute once per requirement (REQ-XXX)
+- **Brainstorming** (v2.3.0): `/flow-init` now generates `BRAINSTORM.md` as requirement "North Star"
+- **Two-Stage Review** (v2.3.0): `/flow-review` validates Spec Compliance before Code Quality
 - **Optional Steps** (yellow): `/flow-clarify` and `/flow-ui` are optional; clarify can be skipped if requirements are clear
 - **Quality Gate** (orange): `/flow-checklist` validates requirement quality with 80% completion threshold before `/flow-epic`
+- **TDD Checkpoint** (v2.3.0): `/flow-dev` includes mandatory TDD checkpoint (tests must FAIL first)
 - **Quality Gates**: Each stage has entry/exit gates ensuring document quality and Constitution compliance
-- **TDD Enforcement**: `/flow-dev` strictly enforces Test-Driven Development order
 - **Consistency Check**: `/flow-verify` can be called at any stage to ensure document consistency
 
 ---
@@ -476,7 +484,84 @@ bash .claude/tests/run-all-tests.sh --scripts
 
 ## 📝 Version History
 
-### v2.2.0 (2025-12-19) - Latest Release
+### v2.3.0 (2026-01-08) - Latest Release
+
+**🛡️ Discipline System: Iron Law + Rationalization Defense + Pressure Testing**
+
+v2.3.0 upgrades the Constitution from a "document" to an "executable discipline system", borrowing best practices from superpowers project:
+
+- **Iron Law + Rationalization Tables** - Pre-block AI Agent rationalization attempts
+  - Each of 10 Constitution Articles now has an Iron Law (absolute prohibition)
+  - Rationalization Tables with `| Excuse | Reality |` format
+  - Red Flags for AI self-check triggers
+  - Centralized `rationalization-library.md` for all rationalizations
+
+- **Two-Stage Code Review** - `/flow-review` command (NEW)
+  - Stage 1: Spec Compliance (don't trust implementer reports, read code directly)
+  - Stage 2: Code Quality (only runs after Stage 1 passes)
+  - `spec-reviewer.md` and `code-quality-reviewer.md` agents
+
+- **Verification Before Completion** - Evidence before assertions
+  - `verification-before-completion` skill
+  - `verify-gate.sh` script for all flow exit gates
+  - No completion claims without fresh verification evidence
+
+- **Systematic Debugging** - `/flow-fix` enhanced with 4-phase debugging
+  - Phase 1: Root Cause Investigation (NO FIXES YET)
+  - Phase 2: Pattern Analysis
+  - Phase 3: Hypothesis and Testing
+  - Phase 4: TDD Implementation
+  - `flow-debugging` and `flow-tdd` skills
+
+- **Brainstorming Integration** - `/flow-init` now includes brainstorming
+  - `BRAINSTORM.md` as requirement "North Star"
+  - `/flow-prd` requires BRAINSTORM alignment check
+  - `flow-brainstorming` skill
+
+- **Pressure Testing Framework** - TDD for Skills
+  - `tests/pressure-scenarios/` with 4 scenarios
+  - Tests AI behavior under time/sunk cost/authority/exhaustion pressure
+  - `run-pressure-tests.sh` runner
+
+- **Skills Fusion** - Superpowers skills migrated to local
+  - `flow-tdd`, `flow-debugging`, `flow-receiving-review`, `flow-finishing-branch`
+  - All `superpowers:xxx` references replaced with local skills
+
+- **Ralph × Manus Integration** - Autonomous development with memory (NEW)
+  - Merged into `/flow-dev` (Autonomous by default)
+  - `flow-attention-refresh` skill with 4 refresh protocols
+  - `ERROR_LOG.md` structured error tracking
+  - `research/attempts/` failure trace recording
+  - Stop Hook for self-referential loops
+  - Manus method in `/flow-init` Stage 2.5 Research
+  - Target: ≥85% task completion rate without human intervention
+
+**📋 Constitution v2.1.0**:
+- All 10 Articles now have Iron Law + Rationalization Defense + Red Flags
+- Cross-reference to `rationalization-library.md`
+
+**📁 New Files**:
+- `.claude/commands/cancel-ralph.md` - Cancel Ralph loop command
+- `.claude/skills/flow-attention-refresh/SKILL.md` - 4 attention refresh protocols
+- `.claude/hooks/ralph-stop-hook.sh` - Stop Hook for self-referential loops
+- `.claude/hooks/hooks.json` - Hook registration configuration
+- `.claude/scripts/setup-ralph-loop.sh` - Ralph state initialization script
+- `.claude/docs/templates/ERROR_LOG_TEMPLATE.md` - Execution error log format
+- `.claude/docs/templates/ATTEMPT_TEMPLATE.md` - Research attempt log format
+- `.claude/agents/spec-reviewer.md` - Stage 1 spec compliance reviewer
+- `.claude/agents/code-quality-reviewer.md` - Stage 2 code quality reviewer
+- `.claude/commands/flow-review.md` - Two-stage review command
+- `.claude/rules/rationalization-library.md` - Centralized rationalization defense
+- `.claude/scripts/verify-gate.sh` - Exit gate verification script
+- `.claude/skills/flow-brainstorming/` - Brainstorming skill
+- `.claude/skills/flow-debugging/` - Systematic debugging skill
+- `.claude/skills/flow-tdd/` - TDD enforcement skill
+- `.claude/skills/flow-receiving-review/` - Review feedback handling skill
+- `.claude/skills/flow-finishing-branch/` - Branch completion decision skill
+- `.claude/skills/verification-before-completion/` - Completion verification skill
+- `tests/` - Pressure testing framework
+
+### v2.2.0 (2025-12-19)
 
 **🔌 Multi-Platform Adaptation: Agent Adapter Architecture + Command Emitter**
 

package/README.zh-CN.md

@@ -29,6 +29,7 @@
 - 🔍 **一致性验证** - 企业级一致性检查，智能冲突检测
 - 🧪 **TDD 强制执行** - 严格的测试驱动开发，TEST VERIFICATION CHECKPOINT
 - 📜 **Constitution** - 10条宪法条款管控质量、安全和架构
+- 🔄 **自主开发** - Ralph × Manus 集成实现有记忆的持续迭代
 - 🔌 **多平台支持** - 通过 `npm run adapt` 编译工作流到 Codex、Cursor、Qwen、Antigravity
 
 ---
@@ -471,7 +472,84 @@ bash .claude/tests/run-all-tests.sh --scripts
 
 ## 📝 版本历史
 
-### v2.2.0 (2025-12-19) - 最新版本
+### v2.3.0 (2026-01-08) - 最新版本
+
+**🛡️ 纪律系统：铁律 + 合理化防御 + 压力测试**
+
+v2.3.0 将 Constitution 从"文档"升级为"可执行纪律系统"，借鉴 superpowers 项目最佳实践：
+
+- **铁律 + 合理化表格** - 预先阻止 AI Agent 合理化尝试
+  - 10 条 Constitution 条款现在都有铁律（绝对禁止）
+  - 合理化表格采用 `| 借口 | 现实 |` 格式
+  - 红旗标志用于 AI 自检触发
+  - 集中式 `rationalization-library.md` 存储所有合理化
+
+- **两阶段代码审查** - `/flow-review` 命令（新增）
+  - 阶段 1：规格合规性（不信任实现者报告，直接读代码）
+  - 阶段 2：代码质量（仅在阶段 1 通过后运行）
+  - `spec-reviewer.md` 和 `code-quality-reviewer.md` 代理
+
+- **完成前验证** - 断言前先有证据
+  - `verification-before-completion` 技能
+  - `verify-gate.sh` 脚本用于所有流程出口闸门
+  - 没有新鲜验证证据不得声称完成
+
+- **系统化调试** - `/flow-fix` 增强 4 阶段调试
+  - 阶段 1：根因调查（尚未修复）
+  - 阶段 2：模式分析
+  - 阶段 3：假设和测试
+  - 阶段 4：TDD 实现
+  - `flow-debugging` 和 `flow-tdd` 技能
+
+- **头脑风暴集成** - `/flow-init` 现在包含头脑风暴
+  - `BRAINSTORM.md` 作为需求"北极星"
+  - `/flow-prd` 需要 BRAINSTORM 对齐检查
+  - `flow-brainstorming` 技能
+
+- **压力测试框架** - 技能的 TDD
+  - `tests/pressure-scenarios/` 包含 4 个场景
+  - 测试 AI 在时间/沉没成本/权威/疲劳压力下的行为
+  - `run-pressure-tests.sh` 运行器
+
+- **技能融合** - Superpowers 技能迁移到本地
+  - `flow-tdd`、`flow-debugging`、`flow-receiving-review`、`flow-finishing-branch`
+  - 所有 `superpowers:xxx` 引用替换为本地技能
+
+- **Ralph × Manus 集成** - 有记忆的自主开发（新增）
+  - 合并入 `/flow-dev` (默认自主模式)
+  - `flow-attention-refresh` 技能提供 4 个刷新协议
+  - `ERROR_LOG.md` 结构化错误追踪
+  - `research/attempts/` 失败痕迹记录
+  - Stop Hook 实现自引用循环
+  - `/flow-init` Stage 2.5 融入 Manus 研究方法
+  - 目标：无人工干预任务完成率 ≥85%
+
+**📋 Constitution v2.1.0**:
+- 所有 10 条条款现在都有铁律 + 合理化防御 + 红旗标志
+- 交叉引用到 `rationalization-library.md`
+
+**📁 新增文件**:
+- `.claude/commands/cancel-ralph.md` - 取消 Ralph 循环命令
+- `.claude/skills/flow-attention-refresh/SKILL.md` - 4 个注意力刷新协议
+- `.claude/hooks/ralph-stop-hook.sh` - 自引用循环 Stop Hook
+- `.claude/hooks/hooks.json` - Hook 注册配置
+- `.claude/scripts/setup-ralph-loop.sh` - Ralph 状态初始化脚本
+- `.claude/docs/templates/ERROR_LOG_TEMPLATE.md` - 执行错误日志格式
+- `.claude/docs/templates/ATTEMPT_TEMPLATE.md` - 研究尝试日志格式
+- `.claude/agents/spec-reviewer.md` - 阶段 1 规格合规性审查员
+- `.claude/agents/code-quality-reviewer.md` - 阶段 2 代码质量审查员
+- `.claude/commands/flow-review.md` - 两阶段审查命令
+- `.claude/rules/rationalization-library.md` - 集中式合理化防御
+- `.claude/scripts/verify-gate.sh` - 出口闸门验证脚本
+- `.claude/skills/flow-brainstorming/` - 头脑风暴技能
+- `.claude/skills/flow-debugging/` - 系统化调试技能
+- `.claude/skills/flow-tdd/` - TDD 强制执行技能
+- `.claude/skills/flow-receiving-review/` - 审查反馈处理技能
+- `.claude/skills/flow-finishing-branch/` - 分支完成决策技能
+- `.claude/skills/verification-before-completion/` - 完成验证技能
+- `tests/` - 压力测试框架
+
+### v2.2.0 (2025-12-19)
 
 **🔌 多平台适配：Agent 适配器架构 + 命令编译器**
 

package/docs/commands/flow-init.md

@@ -22,6 +22,8 @@ Initialize requirement directory structure and load roadmap and architecture con
 |-----------|-------------|----------|---------|
 | **REQ-ID** | Requirement number | ✅ | `REQ-123` |
 | **Feature Title** | Brief description | ✅ | `User Authentication Feature` |
+
+> If the title contains non-ASCII text, the agent produces an English semantic translation for branch naming (not pinyin), while keeping the original title in docs.
 | **--interactive** | Interactive ID selection | ❌ | Auto-select next available ID |
 
 ## 🎬 Use Cases
@@ -68,7 +70,7 @@ Stage 2.6: Research task dispatch & decision integration
   └─ Consolidate research findings
   ↓
 Stage 3: Git branch creation
-  └─ Create feature/REQ-XXX-title branch
+  └─ Create feature/REQ-XXX-english-slug branch (model-translated, not pinyin)
 ```
 
 ## 💡 Examples

package/docs/commands/flow-init.zh-CN.md

@@ -20,6 +20,8 @@
 | **功能标题** | 简短描述 | ✅ | `用户认证功能` |
 | **--interactive** | 交互式选择 ID | ❌ | 自动选择下一个可用 ID |
 
+> 若标题包含中文/非ASCII，分支名将使用模型意译生成英文语义短语（禁止拼音/音译），文档标题仍保留原始中文。
+
 ## 🎬 使用场景
 
 ### ✅ 推荐场景
@@ -65,7 +67,7 @@ Stage 2.6: 调研任务分派与决策整合（FIXED）
   └─ 整合研究结论 (consolidate-research.sh)
   ↓
 Stage 3: Git 分支创建
-  └─ 创建 feature/REQ-123-user-auth 分支
+  └─ 创建 feature/REQ-123-user-auth 分支（标题英文意译，非拼音）
 ```
 
 ## 💡 示例

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "cc-devflow",
-    "version": "1.0.2",
+    "version": "2.4.0",
     "description": "DevFlow CLI tool",
     "main": "bin/cc-devflow.js",
     "bin": {
@@ -36,8 +36,8 @@
         "adapt:antigravity": "node bin/adapt.js --platform antigravity"
     },
     "dependencies": {
-        "gray-matter": "^4.0.3",
         "@iarna/toml": "^2.2.5",
+        "gray-matter": "^4.0.3",
         "js-yaml": "^4.1.0",
         "zod": "^3.22.4"
     },

package/.claude/tsc-cache/777aa1de-497e-411b-a40f-13b74efcec58/affected-repos.txt

@@ -1 +0,0 @@
-root