cc-devflow 2.4.3 → 2.4.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (34) hide show
  1. package/.claude/CLAUDE.md +3 -2
  2. package/.claude/agents/bug-analyzer.md +0 -1
  3. package/.claude/agents/compatibility-checker.md +0 -1
  4. package/.claude/agents/flow-researcher.md +132 -0
  5. package/.claude/agents/impact-analyzer.md +0 -1
  6. package/.claude/commands/flow-fix.md +1 -1
  7. package/.claude/commands/flow-init.md +33 -65
  8. package/.claude/commands/flow-new.md +2 -3
  9. package/.claude/commands/git-commit.md +425 -0
  10. package/.claude/docs/guides/NEW_TROUBLESHOOTING.md +4 -4
  11. package/.claude/docs/templates/INIT_FLOW_TEMPLATE.md +17 -40
  12. package/.claude/docs/templates/NEW_ORCHESTRATION_TEMPLATE.md +2 -3
  13. package/.claude/rules/devflow-conventions.md +3 -6
  14. package/.claude/scripts/generate-status-report.sh +7 -7
  15. package/.claude/scripts/populate-research-tasks.sh +63 -38
  16. package/.claude/scripts/recover-workflow.sh +18 -12
  17. package/.claude/skills/npm-release/SKILL.md +314 -0
  18. package/.claude/skills/writing-skills/SKILL.md +655 -0
  19. package/.claude/skills/writing-skills/anthropic-best-practices.md +1150 -0
  20. package/.claude/skills/writing-skills/examples/CLAUDE_MD_TESTING.md +189 -0
  21. package/.claude/skills/writing-skills/graphviz-conventions.dot +172 -0
  22. package/.claude/skills/writing-skills/persuasion-principles.md +187 -0
  23. package/.claude/skills/writing-skills/render-graphs.js +168 -0
  24. package/.claude/skills/writing-skills/testing-skills-with-subagents.md +384 -0
  25. package/CHANGELOG.md +76 -0
  26. package/README.md +12 -0
  27. package/README.zh-CN.md +12 -0
  28. package/docs/commands/flow-init.md +14 -10
  29. package/docs/commands/flow-init.zh-CN.md +12 -8
  30. package/package.json +2 -2
  31. package/.claude/tsc-cache/6e64f818-6398-49ca-8623-581a9af85c44/edited-files.log +0 -1
  32. package/.claude/tsc-cache/777aa1de-497e-411b-a40f-13b74efcec58/edited-files.log +0 -2
  33. package/.claude/tsc-cache/795ba6e3-b98a-423b-bab2-51aa62812569/edited-files.log +0 -1
  34. package/.claude/tsc-cache/ae335694-be5a-4ba4-a1a0-b676c09a7906/edited-files.log +0 -1
@@ -47,6 +47,9 @@ Stage 1: Prerequisites validation
47
47
  ├─ Check devflow/ directory
48
48
  └─ Verify REQ-ID uniqueness
49
49
 
50
+ Stage 1.2: Git branch creation
51
+ └─ Create feature/REQ-XXX-english-slug branch (model-translated, not pinyin)
52
+
50
53
  Stage 1.5: Roadmap & Architecture context loading (NEW)
51
54
  ├─ Check ROADMAP.md existence
52
55
  ├─ Locate requirement in roadmap
@@ -64,13 +67,15 @@ Stage 2: Directory structure creation
64
67
  ├─ Initialize orchestration_status.json
65
68
  └─ Create EXECUTION_LOG.md
66
69
 
67
- Stage 2.6: Research task dispatch & decision integration
68
- ├─ Generate research tasks
69
- ├─ Populate research decisions
70
- └─ Consolidate research findings
70
+ Stage 2.3: Brainstorming (skill)
71
+ └─ Generate devflow/requirements/REQ-XXX/BRAINSTORM.md as the “North Star”
71
72
 
72
- Stage 3: Git branch creation
73
- └─ Create feature/REQ-XXX-english-slug branch (model-translated, not pinyin)
73
+ Stage 2.5: Research (subagent, mandatory, context-isolated)
74
+ ├─ Run internal codebase research research/internal/codebase-overview.md
75
+ ├─ Capture external sources into files → research/mcp/YYYYMMDD/**
76
+ ├─ Produce decisions → research/research-summary.md
77
+ ├─ Fill tasks → research/tasks.json (decision/rationale/alternatives)
78
+ └─ Consolidate → research/research.md (validated; no TODO/PLACEHOLDER)
74
79
  ```
75
80
 
76
81
  ## 💡 Examples
@@ -124,10 +129,9 @@ Stage 3: Git branch creation
124
129
 
125
130
  ## 📂 Output
126
131
 
127
- - `devflow/requirements/REQ-XXX/` complete directory
128
- - `orchestration_status.json`
129
- - `EXECUTION_LOG.md`
130
- - Roadmap and architecture context (if exists)
132
+ - `devflow/requirements/REQ-XXX/` initialized directory (includes `BRAINSTORM.md` + `research/`)
133
+ - `orchestration_status.json` + `EXECUTION_LOG.md`
134
+ - Roadmap and architecture context display (if exists)
131
135
 
132
136
  ## 🔗 Related Commands
133
137
 
@@ -43,6 +43,9 @@ Stage 1: 前置条件验证
43
43
  ├─ 检查 devflow/ 目录
44
44
  └─ 验证 REQ-ID 唯一性
45
45
 
46
+ Stage 1.2: Git 分支创建
47
+ └─ 创建 feature/REQ-XXX-english-slug 分支(标题英文意译,非拼音)
48
+
46
49
  Stage 1.5: 路线图与架构上下文加载(NEW)
47
50
  ├─ 检查 ROADMAP.md 存在性
48
51
  ├─ 定位需求在路线图中的位置
@@ -57,17 +60,19 @@ Stage 1.5: 路线图与架构上下文加载(NEW)
57
60
 
58
61
  Stage 2: 目录结构创建
59
62
  ├─ 创建 devflow/requirements/REQ-123/
60
- ├─ 创建子目录 tasks/, research/
63
+ ├─ 创建子目录 research/
61
64
  ├─ 初始化 orchestration_status.json
62
65
  └─ 初始化 EXECUTION_LOG.md
63
66
 
64
- Stage 2.6: 调研任务分派与决策整合(FIXED
65
- ├─ 生成研究任务 (generate-research-tasks.sh)
66
- ├─ 填充研究决策 (populate-research-tasks.sh)
67
- └─ 整合研究结论 (consolidate-research.sh)
67
+ Stage 2.3: 头脑风暴(skill
68
+ └─ 生成 devflow/requirements/REQ-XXX/BRAINSTORM.md 作为需求「北极星」
68
69
 
69
- Stage 3: Git 分支创建
70
- └─ 创建 feature/REQ-123-user-auth 分支(标题英文意译,非拼音)
70
+ Stage 2.5: 调研(subagent,默认必跑,上下文隔离)
71
+ ├─ 内部代码库调研 → research/internal/codebase-overview.md
72
+ ├─ 外部资料落盘 → research/mcp/YYYYMMDD/**
73
+ ├─ 决策摘要 → research/research-summary.md
74
+ ├─ 任务回填 → research/tasks.json(decision/rationale/alternatives 完整)
75
+ └─ 研究整合 → research/research.md(通过校验,无 TODO/PLACEHOLDER)
71
76
  ```
72
77
 
73
78
  ## 💡 示例
@@ -129,7 +134,6 @@ Stage 3: Git 分支创建
129
134
  devflow/requirements/REQ-123/
130
135
  ├── orchestration_status.json # 状态管理
131
136
  ├── EXECUTION_LOG.md # 审计轨迹
132
- ├── tasks/ # 任务产物目录
133
137
  ├── research/ # 研究材料目录
134
138
  └── (等待后续阶段生成其他文档)
135
139
  ```
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "cc-devflow",
3
- "version": "2.4.3",
3
+ "version": "2.4.6",
4
4
  "description": "DevFlow CLI tool",
5
5
  "main": "bin/cc-devflow.js",
6
6
  "bin": {
@@ -47,4 +47,4 @@
47
47
  "engines": {
48
48
  "node": ">=18"
49
49
  }
50
- }
50
+ }
@@ -1 +0,0 @@
1
- 1766046071 Edit /Users/dimon/001Area/80-CodeWorld/002-devflow/cc-devflow/package.json root
@@ -1,2 +0,0 @@
1
- 1766298649 Edit /Users/dimon/001Area/80-CodeWorld/002-devflow/cc-devflow/package.json root
2
- 1766298660 Edit /Users/dimon/001Area/80-CodeWorld/002-devflow/cc-devflow/package.json root
@@ -1 +0,0 @@
1
- 1766132827 Edit /Users/dimon/001Area/80-CodeWorld/002-devflow/cc-devflow/package.json root
@@ -1 +0,0 @@
1
- 1766112103 Edit /Users/dimon/001Area/80-CodeWorld/002-devflow/cc-devflow/.gitignore root