cc-devflow 4.5.0 → 4.5.1

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 (45) hide show
  1. package/.claude/skills/cc-plan/CHANGELOG.md +14 -0
  2. package/.claude/skills/cc-plan/PLAYBOOK.md +19 -2
  3. package/.claude/skills/cc-plan/SKILL.md +52 -20
  4. package/.claude/skills/cc-plan/assets/DESIGN_TEMPLATE.md +70 -1
  5. package/.claude/skills/cc-plan/assets/TASKS_TEMPLATE.md +13 -0
  6. package/.claude/skills/cc-plan/assets/TASK_MANIFEST_TEMPLATE.json +3 -1
  7. package/.claude/skills/cc-plan/assets/TINY_DESIGN_TEMPLATE.md +22 -0
  8. package/.claude/skills/cc-roadmap/CHANGELOG.md +12 -0
  9. package/.claude/skills/cc-roadmap/PLAYBOOK.md +24 -1
  10. package/.claude/skills/cc-roadmap/SKILL.md +50 -15
  11. package/.claude/skills/cc-roadmap/assets/BACKLOG_TEMPLATE.md +15 -0
  12. package/.claude/skills/cc-roadmap/assets/ROADMAP_TEMPLATE.md +37 -0
  13. package/.claude/skills/cc-roadmap/assets/TRACKING_TEMPLATE.json +2 -1
  14. package/CHANGELOG.md +20 -0
  15. package/CODE_OF_CONDUCT.md +39 -0
  16. package/CODE_OF_CONDUCT.zh-CN.md +39 -0
  17. package/CONTRIBUTING.md +195 -0
  18. package/CONTRIBUTING.zh-CN.md +195 -0
  19. package/README.md +141 -150
  20. package/README.zh-CN.md +144 -148
  21. package/SECURITY.md +56 -0
  22. package/SECURITY.zh-CN.md +56 -0
  23. package/docs/examples/example-bindings.json +3 -3
  24. package/docs/examples/full-design-blocked/BACKLOG.md +1 -1
  25. package/docs/examples/full-design-blocked/README.md +1 -1
  26. package/docs/examples/full-design-blocked/ROADMAP.md +1 -1
  27. package/docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/planning/design.md +1 -1
  28. package/docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/planning/tasks.md +1 -1
  29. package/docs/examples/full-design-blocked/roadmap-tracking.json +1 -1
  30. package/docs/examples/local-handoff/BACKLOG.md +1 -1
  31. package/docs/examples/local-handoff/README.md +1 -1
  32. package/docs/examples/local-handoff/ROADMAP.md +1 -1
  33. package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/planning/design.md +1 -1
  34. package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/planning/tasks.md +1 -1
  35. package/docs/examples/local-handoff/roadmap-tracking.json +1 -1
  36. package/docs/examples/pdca-loop/BACKLOG.md +1 -1
  37. package/docs/examples/pdca-loop/README.md +1 -1
  38. package/docs/examples/pdca-loop/ROADMAP.md +1 -1
  39. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/design.md +1 -1
  40. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/task-manifest.json +2 -2
  41. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/tasks.md +1 -1
  42. package/docs/examples/pdca-loop/roadmap-tracking.json +1 -1
  43. package/docs/guides/getting-started.md +5 -0
  44. package/docs/guides/getting-started.zh-CN.md +5 -0
  45. package/package.json +7 -1
@@ -3,7 +3,7 @@
3
3
  ## Roadmap Meta
4
4
 
5
5
  - Roadmap version: `roadmap.v1`
6
- - Skill version: `4.3.2`
6
+ - Skill version: `4.3.4`
7
7
  - Status: `active`
8
8
  - Last updated: `2026-04-15`
9
9
  - Owner / decider: `product-owner`
@@ -4,7 +4,7 @@
4
4
 
5
5
  - Requirement version: `REQ-001.v1`
6
6
  - Design version: `design.v1`
7
- - CC-Plan skill version: `3.5.4`
7
+ - CC-Plan skill version: `3.5.6`
8
8
  - Requirement ID: `REQ-001`
9
9
  - Design mode: `tiny-design`
10
10
  - Why this stays `tiny-design`: the patch is limited to an existing dialog and test file, with no API or data model changes
@@ -9,7 +9,7 @@
9
9
  "sourceRoadmap": {
10
10
  "itemId": "RM-001",
11
11
  "roadmapVersion": "roadmap.v1",
12
- "roadmapSkillVersion": "4.3.2",
12
+ "roadmapSkillVersion": "4.3.4",
13
13
  "sourceStage": "Stage 1",
14
14
  "successSignal": "Users can copy the invite link with one click",
15
15
  "killSignal": "The patch requires backend or permission changes",
@@ -22,7 +22,7 @@
22
22
  ]
23
23
  },
24
24
  "planningMeta": {
25
- "reqPlanSkillVersion": "3.5.4",
25
+ "reqPlanSkillVersion": "3.5.6",
26
26
  "designVersion": "design.v1",
27
27
  "approvedAt": "2026-04-15T10:05:00.000Z",
28
28
  "approvedBy": "user",
@@ -4,7 +4,7 @@
4
4
 
5
5
  - Requirement version: `REQ-001.v1`
6
6
  - Design version: `design.v1`
7
- - CC-Plan skill version: `3.5.4`
7
+ - CC-Plan skill version: `3.5.6`
8
8
  - Source roadmap item: `RM-001`
9
9
  - Source roadmap version: `roadmap.v1`
10
10
 
@@ -3,7 +3,7 @@
3
3
  "lastSyncedAt": "2026-04-19",
4
4
  "backlogMeta": {
5
5
  "roadmapVersion": "roadmap.v1",
6
- "skillVersion": "4.3.2",
6
+ "skillVersion": "4.3.4",
7
7
  "currentFocusStage": "Stage 1"
8
8
  },
9
9
  "dependencyHandoff": {
@@ -98,6 +98,11 @@ Change truth lives in `devflow/changes/<change>/`.
98
98
  - Keep `change-state.json`, `change-meta.json`, planning docs, `task-manifest.json`, optional `team-state.json`, task `checkpoint.json`, `report-card.json`, and one final handoff file under each `devflow/changes/<change>/`.
99
99
  - Worker prompts, journals, assignments, and session logs belong under `devflow/workspaces/<change>/` as ephemeral scratch.
100
100
 
101
+ Planning handoffs should be evidence-rich before implementation starts:
102
+
103
+ - `cc-roadmap` records planning posture, evidence maturity, framing check, dependency graph, and any developer/operator adoption context.
104
+ - `cc-plan` records option roles, implementation surface, decision horizon, error/rescue map, test framework source, coverage quality, and regression-test requirements when they apply.
105
+
101
106
  Typical public contract fields:
102
107
 
103
108
  - `triggers`, `reads`, structured `writes`, `effects`
@@ -97,6 +97,11 @@ durable truth 分两层:
97
97
  - `devflow/changes/<change>/`:变更真相,保留 `change-state.json`、`change-meta.json`、planning 文档、`task-manifest.json`、可选 `team-state.json`、任务级 `checkpoint.json`、`report-card.json` 和唯一的最终 handoff 文件。
98
98
  - worker prompt、journal、assignment、session log 统一放到 `devflow/workspaces/<change>/`,作为 ephemeral scratch。
99
99
 
100
+ 进入实现前,planning handoff 应该先把证据写实:
101
+
102
+ - `cc-roadmap` 记录 planning posture、evidence maturity、framing check、依赖图,以及适用时的 developer/operator adoption context。
103
+ - `cc-plan` 记录 option roles、implementation surface、decision horizon、error/rescue map、测试框架来源、覆盖质量,以及适用时的 regression-test requirement。
104
+
100
105
  公开契约字段的典型形状:
101
106
 
102
107
  - `triggers`、`reads`、结构化 `writes`、`effects`
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "cc-devflow",
3
- "version": "4.5.0",
3
+ "version": "4.5.1",
4
4
  "description": "Multi-platform CLI and skill pack for agent coding",
5
5
  "main": "bin/cc-devflow.js",
6
6
  "bin": {
@@ -21,6 +21,12 @@
21
21
  "docs/",
22
22
  "README.md",
23
23
  "README.zh-CN.md",
24
+ "CONTRIBUTING.md",
25
+ "CONTRIBUTING.zh-CN.md",
26
+ "CODE_OF_CONDUCT.md",
27
+ "CODE_OF_CONDUCT.zh-CN.md",
28
+ "SECURITY.md",
29
+ "SECURITY.zh-CN.md",
24
30
  "CHANGELOG.md",
25
31
  "LICENSE",
26
32
  "package.json"