claude-code-workflow 7.2.23 → 7.2.25

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 (212) hide show
  1. package/.ccw/workflows/cli-tools-usage.md +123 -521
  2. package/.claude/skills/brainstorm/SKILL.md +408 -408
  3. package/.claude/skills/review-cycle/SKILL.md +132 -132
  4. package/.claude/skills/spec-generator/SKILL.md +1 -1
  5. package/.claude/skills/team-designer/phases/02-scaffold-generation.md +1 -1
  6. package/.claude/skills/team-lifecycle-v4/SKILL.md +1 -1
  7. package/.claude/skills/team-review/SKILL.md +1 -1
  8. package/.claude/skills/team-ultra-analyze/SKILL.md +1 -1
  9. package/.claude/skills/workflow-multi-cli-plan/SKILL.md +1 -1
  10. package/.claude/skills/workflow-plan/SKILL.md +1 -1
  11. package/.claude/skills/workflow-test-fix/SKILL.md +1 -1
  12. package/.codex/skills/analyze-with-file/SKILL.md +966 -966
  13. package/.codex/skills/issue-discover/SKILL.md +361 -361
  14. package/.codex/skills/review-cycle/SKILL.md +1 -1
  15. package/.codex/skills/roadmap-with-file/SKILL.md +901 -901
  16. package/.codex/skills/spec-generator/SKILL.md +425 -425
  17. package/.codex/skills/spec-setup/SKILL.md +669 -669
  18. package/.codex/skills/team-arch-opt/SKILL.md +242 -175
  19. package/.codex/skills/team-arch-opt/roles/analyzer/role.md +78 -78
  20. package/.codex/skills/team-arch-opt/roles/coordinator/commands/analyze.md +57 -57
  21. package/.codex/skills/team-arch-opt/roles/coordinator/commands/monitor.md +246 -204
  22. package/.codex/skills/team-arch-opt/roles/coordinator/role.md +196 -184
  23. package/.codex/skills/team-arch-opt/roles/designer/role.md +115 -115
  24. package/.codex/skills/team-arch-opt/roles/refactorer/role.md +102 -102
  25. package/.codex/skills/team-arch-opt/roles/reviewer/role.md +111 -111
  26. package/.codex/skills/team-arch-opt/roles/validator/role.md +115 -115
  27. package/.codex/skills/team-arch-opt/specs/pipelines.md +102 -102
  28. package/.codex/skills/team-brainstorm/SKILL.md +72 -4
  29. package/.codex/skills/team-brainstorm/roles/challenger/role.md +61 -61
  30. package/.codex/skills/team-brainstorm/roles/coordinator/commands/analyze.md +58 -58
  31. package/.codex/skills/team-brainstorm/roles/coordinator/commands/monitor.md +212 -171
  32. package/.codex/skills/team-brainstorm/roles/coordinator/role.md +172 -160
  33. package/.codex/skills/team-brainstorm/roles/evaluator/role.md +56 -56
  34. package/.codex/skills/team-brainstorm/roles/ideator/role.md +69 -69
  35. package/.codex/skills/team-brainstorm/roles/synthesizer/role.md +57 -57
  36. package/.codex/skills/team-brainstorm/specs/pipelines.md +72 -72
  37. package/.codex/skills/team-coordinate/SKILL.md +71 -3
  38. package/.codex/skills/team-coordinate/roles/coordinator/commands/monitor.md +45 -5
  39. package/.codex/skills/team-coordinate/roles/coordinator/role.md +402 -389
  40. package/.codex/skills/team-coordinate/specs/knowledge-transfer.md +111 -111
  41. package/.codex/skills/team-coordinate/specs/pipelines.md +97 -97
  42. package/.codex/skills/team-coordinate/specs/quality-gates.md +112 -112
  43. package/.codex/skills/team-designer/SKILL.md +153 -153
  44. package/.codex/skills/team-designer/phases/01-requirements-analysis.md +250 -250
  45. package/.codex/skills/team-designer/phases/02-scaffold-generation.md +228 -228
  46. package/.codex/skills/team-designer/phases/03-content-generation.md +330 -330
  47. package/.codex/skills/team-designer/phases/04-validation.md +320 -320
  48. package/.codex/skills/team-executor/SKILL.md +29 -2
  49. package/.codex/skills/team-executor/roles/executor/commands/monitor.md +23 -15
  50. package/.codex/skills/team-frontend/SKILL.md +77 -3
  51. package/.codex/skills/team-frontend/roles/analyst/role.md +92 -92
  52. package/.codex/skills/team-frontend/roles/architect/role.md +86 -86
  53. package/.codex/skills/team-frontend/roles/coordinator/commands/analyze.md +52 -52
  54. package/.codex/skills/team-frontend/roles/coordinator/commands/monitor.md +222 -188
  55. package/.codex/skills/team-frontend/roles/coordinator/role.md +189 -177
  56. package/.codex/skills/team-frontend/roles/developer/role.md +93 -93
  57. package/.codex/skills/team-frontend/roles/qa/role.md +79 -79
  58. package/.codex/skills/team-frontend/specs/pipelines.md +76 -76
  59. package/.codex/skills/team-frontend-debug/SKILL.md +66 -3
  60. package/.codex/skills/team-frontend-debug/roles/analyzer/role.md +208 -208
  61. package/.codex/skills/team-frontend-debug/roles/coordinator/commands/analyze.md +174 -174
  62. package/.codex/skills/team-frontend-debug/roles/coordinator/commands/dispatch.md +198 -198
  63. package/.codex/skills/team-frontend-debug/roles/coordinator/commands/monitor.md +177 -143
  64. package/.codex/skills/team-frontend-debug/roles/coordinator/role.md +164 -152
  65. package/.codex/skills/team-frontend-debug/roles/fixer/role.md +147 -147
  66. package/.codex/skills/team-frontend-debug/roles/reproducer/role.md +147 -147
  67. package/.codex/skills/team-frontend-debug/roles/tester/role.md +231 -231
  68. package/.codex/skills/team-frontend-debug/roles/verifier/role.md +172 -172
  69. package/.codex/skills/team-frontend-debug/specs/debug-tools.md +215 -215
  70. package/.codex/skills/team-frontend-debug/specs/pipelines.md +94 -94
  71. package/.codex/skills/team-issue/SKILL.md +83 -4
  72. package/.codex/skills/team-issue/roles/coordinator/commands/analyze.md +64 -64
  73. package/.codex/skills/team-issue/roles/coordinator/commands/dispatch.md +273 -273
  74. package/.codex/skills/team-issue/roles/coordinator/commands/monitor.md +235 -194
  75. package/.codex/skills/team-issue/roles/coordinator/role.md +206 -194
  76. package/.codex/skills/team-issue/roles/explorer/role.md +94 -94
  77. package/.codex/skills/team-issue/roles/implementer/role.md +87 -87
  78. package/.codex/skills/team-issue/roles/integrator/role.md +84 -84
  79. package/.codex/skills/team-issue/roles/planner/role.md +81 -81
  80. package/.codex/skills/team-issue/roles/reviewer/role.md +86 -86
  81. package/.codex/skills/team-issue/specs/pipelines.md +124 -124
  82. package/.codex/skills/team-lifecycle-v4/MIGRATION-PLAN.md +6 -6
  83. package/.codex/skills/team-lifecycle-v4/SKILL.md +305 -242
  84. package/.codex/skills/team-lifecycle-v4/roles/coordinator/commands/dispatch.md +1 -1
  85. package/.codex/skills/team-lifecycle-v4/roles/coordinator/commands/monitor.md +66 -24
  86. package/.codex/skills/team-lifecycle-v4/roles/coordinator/role.md +13 -1
  87. package/.codex/skills/team-lifecycle-v4/roles/supervisor/role.md +1 -1
  88. package/.codex/skills/team-lifecycle-v4/templates/architecture.md +254 -254
  89. package/.codex/skills/team-lifecycle-v4/templates/epics.md +196 -196
  90. package/.codex/skills/team-lifecycle-v4/templates/product-brief.md +133 -133
  91. package/.codex/skills/team-lifecycle-v4/templates/requirements.md +224 -224
  92. package/.codex/skills/team-perf-opt/SKILL.md +68 -3
  93. package/.codex/skills/team-perf-opt/roles/benchmarker/role.md +89 -89
  94. package/.codex/skills/team-perf-opt/roles/coordinator/commands/analyze.md +61 -61
  95. package/.codex/skills/team-perf-opt/roles/coordinator/commands/monitor.md +35 -1
  96. package/.codex/skills/team-perf-opt/roles/coordinator/role.md +179 -167
  97. package/.codex/skills/team-perf-opt/roles/optimizer/role.md +97 -97
  98. package/.codex/skills/team-perf-opt/roles/profiler/role.md +73 -73
  99. package/.codex/skills/team-perf-opt/roles/reviewer/role.md +75 -75
  100. package/.codex/skills/team-perf-opt/roles/strategist/role.md +94 -94
  101. package/.codex/skills/team-perf-opt/specs/pipelines.md +65 -65
  102. package/.codex/skills/team-planex/SKILL.md +65 -3
  103. package/.codex/skills/team-planex/roles/coordinator/commands/analyze.md +52 -52
  104. package/.codex/skills/team-planex/roles/coordinator/commands/monitor.md +210 -164
  105. package/.codex/skills/team-planex/roles/coordinator/role.md +171 -159
  106. package/.codex/skills/team-planex/roles/executor/role.md +91 -91
  107. package/.codex/skills/team-planex/roles/planner/role.md +112 -112
  108. package/.codex/skills/team-planex/specs/pipelines.md +93 -93
  109. package/.codex/skills/team-quality-assurance/SKILL.md +60 -3
  110. package/.codex/skills/team-quality-assurance/roles/analyst/role.md +80 -80
  111. package/.codex/skills/team-quality-assurance/roles/coordinator/commands/analyze.md +72 -72
  112. package/.codex/skills/team-quality-assurance/roles/coordinator/commands/dispatch.md +108 -108
  113. package/.codex/skills/team-quality-assurance/roles/coordinator/commands/monitor.md +243 -209
  114. package/.codex/skills/team-quality-assurance/roles/coordinator/role.md +176 -164
  115. package/.codex/skills/team-quality-assurance/roles/executor/role.md +66 -66
  116. package/.codex/skills/team-quality-assurance/roles/generator/role.md +68 -68
  117. package/.codex/skills/team-quality-assurance/roles/scout/role.md +67 -67
  118. package/.codex/skills/team-quality-assurance/roles/strategist/role.md +71 -71
  119. package/.codex/skills/team-quality-assurance/specs/pipelines.md +115 -115
  120. package/.codex/skills/team-review/SKILL.md +58 -3
  121. package/.codex/skills/team-review/roles/coordinator/commands/analyze.md +71 -71
  122. package/.codex/skills/team-review/roles/coordinator/commands/dispatch.md +90 -90
  123. package/.codex/skills/team-review/roles/coordinator/commands/monitor.md +225 -185
  124. package/.codex/skills/team-review/roles/coordinator/role.md +175 -163
  125. package/.codex/skills/team-review/roles/fixer/role.md +76 -76
  126. package/.codex/skills/team-review/roles/reviewer/role.md +68 -68
  127. package/.codex/skills/team-review/roles/scanner/role.md +71 -71
  128. package/.codex/skills/team-review/specs/pipelines.md +102 -102
  129. package/.codex/skills/team-roadmap-dev/SKILL.md +55 -3
  130. package/.codex/skills/team-roadmap-dev/roles/coordinator/commands/analyze.md +61 -61
  131. package/.codex/skills/team-roadmap-dev/roles/coordinator/commands/monitor.md +502 -468
  132. package/.codex/skills/team-roadmap-dev/roles/coordinator/role.md +335 -322
  133. package/.codex/skills/team-roadmap-dev/roles/executor/role.md +71 -71
  134. package/.codex/skills/team-roadmap-dev/roles/planner/role.md +76 -76
  135. package/.codex/skills/team-roadmap-dev/roles/verifier/role.md +74 -74
  136. package/.codex/skills/team-roadmap-dev/specs/pipelines.md +93 -93
  137. package/.codex/skills/team-tech-debt/SKILL.md +56 -3
  138. package/.codex/skills/team-tech-debt/roles/assessor/role.md +69 -69
  139. package/.codex/skills/team-tech-debt/roles/coordinator/commands/analyze.md +47 -47
  140. package/.codex/skills/team-tech-debt/roles/coordinator/commands/monitor.md +272 -231
  141. package/.codex/skills/team-tech-debt/roles/coordinator/role.md +172 -160
  142. package/.codex/skills/team-tech-debt/roles/executor/role.md +76 -76
  143. package/.codex/skills/team-tech-debt/roles/planner/role.md +69 -69
  144. package/.codex/skills/team-tech-debt/roles/scanner/role.md +82 -82
  145. package/.codex/skills/team-tech-debt/roles/validator/role.md +75 -75
  146. package/.codex/skills/team-tech-debt/specs/pipelines.md +47 -47
  147. package/.codex/skills/team-testing/SKILL.md +72 -3
  148. package/.codex/skills/team-testing/roles/analyst/role.md +95 -95
  149. package/.codex/skills/team-testing/roles/coordinator/commands/analyze.md +70 -70
  150. package/.codex/skills/team-testing/roles/coordinator/commands/dispatch.md +106 -106
  151. package/.codex/skills/team-testing/roles/coordinator/commands/monitor.md +283 -242
  152. package/.codex/skills/team-testing/roles/coordinator/role.md +184 -172
  153. package/.codex/skills/team-testing/roles/executor/role.md +96 -96
  154. package/.codex/skills/team-testing/roles/generator/role.md +95 -95
  155. package/.codex/skills/team-testing/roles/strategist/role.md +83 -83
  156. package/.codex/skills/team-testing/specs/pipelines.md +101 -101
  157. package/.codex/skills/team-uidesign/SKILL.md +65 -3
  158. package/.codex/skills/team-uidesign/roles/coordinator/commands/analyze.md +59 -59
  159. package/.codex/skills/team-uidesign/roles/coordinator/commands/dispatch.md +156 -156
  160. package/.codex/skills/team-uidesign/roles/coordinator/commands/monitor.md +234 -194
  161. package/.codex/skills/team-uidesign/roles/coordinator/role.md +211 -199
  162. package/.codex/skills/team-uidesign/roles/designer/role.md +69 -69
  163. package/.codex/skills/team-uidesign/roles/implementer/role.md +72 -72
  164. package/.codex/skills/team-uidesign/roles/researcher/role.md +82 -82
  165. package/.codex/skills/team-uidesign/roles/reviewer/role.md +67 -67
  166. package/.codex/skills/team-uidesign/specs/pipelines.md +76 -76
  167. package/.codex/skills/team-ultra-analyze/SKILL.md +73 -3
  168. package/.codex/skills/team-ultra-analyze/roles/analyst/role.md +90 -90
  169. package/.codex/skills/team-ultra-analyze/roles/coordinator/commands/analyze.md +73 -73
  170. package/.codex/skills/team-ultra-analyze/roles/coordinator/commands/monitor.md +50 -9
  171. package/.codex/skills/team-ultra-analyze/roles/coordinator/role.md +255 -243
  172. package/.codex/skills/team-ultra-analyze/roles/discussant/role.md +104 -104
  173. package/.codex/skills/team-ultra-analyze/roles/explorer/role.md +74 -74
  174. package/.codex/skills/team-ultra-analyze/roles/synthesizer/role.md +78 -78
  175. package/.codex/skills/team-ultra-analyze/specs/pipelines.md +64 -64
  176. package/.codex/skills/team-ux-improve/SKILL.md +64 -3
  177. package/.codex/skills/team-ux-improve/roles/coordinator/commands/analyze.md +62 -62
  178. package/.codex/skills/team-ux-improve/roles/coordinator/commands/dispatch.md +233 -233
  179. package/.codex/skills/team-ux-improve/roles/coordinator/commands/monitor.md +195 -160
  180. package/.codex/skills/team-ux-improve/roles/coordinator/role.md +170 -158
  181. package/.codex/skills/team-ux-improve/roles/designer/role.md +122 -122
  182. package/.codex/skills/team-ux-improve/roles/diagnoser/role.md +93 -93
  183. package/.codex/skills/team-ux-improve/roles/explorer/role.md +77 -77
  184. package/.codex/skills/team-ux-improve/roles/implementer/role.md +102 -102
  185. package/.codex/skills/team-ux-improve/roles/scanner/role.md +93 -93
  186. package/.codex/skills/team-ux-improve/roles/tester/role.md +84 -84
  187. package/.codex/skills/team-ux-improve/specs/pipelines.md +54 -54
  188. package/.codex/skills/workflow-test-fix-cycle/SKILL.md +402 -402
  189. package/README.md +1 -0
  190. package/package.json +1 -1
  191. package/.claude/skills/team-iterdev/SKILL.md +0 -127
  192. package/.claude/skills/team-iterdev/roles/architect/role.md +0 -65
  193. package/.claude/skills/team-iterdev/roles/coordinator/commands/analyze.md +0 -62
  194. package/.claude/skills/team-iterdev/roles/coordinator/commands/dispatch.md +0 -234
  195. package/.claude/skills/team-iterdev/roles/coordinator/commands/monitor.md +0 -182
  196. package/.claude/skills/team-iterdev/roles/coordinator/role.md +0 -153
  197. package/.claude/skills/team-iterdev/roles/developer/role.md +0 -74
  198. package/.claude/skills/team-iterdev/roles/reviewer/role.md +0 -66
  199. package/.claude/skills/team-iterdev/roles/tester/role.md +0 -88
  200. package/.claude/skills/team-iterdev/specs/pipelines.md +0 -94
  201. package/.claude/skills/team-iterdev/specs/team-config.json +0 -172
  202. package/.codex/skills/team-iterdev/SKILL.md +0 -158
  203. package/.codex/skills/team-iterdev/roles/architect/role.md +0 -65
  204. package/.codex/skills/team-iterdev/roles/coordinator/commands/analyze.md +0 -62
  205. package/.codex/skills/team-iterdev/roles/coordinator/commands/dispatch.md +0 -187
  206. package/.codex/skills/team-iterdev/roles/coordinator/commands/monitor.md +0 -186
  207. package/.codex/skills/team-iterdev/roles/coordinator/role.md +0 -181
  208. package/.codex/skills/team-iterdev/roles/developer/role.md +0 -74
  209. package/.codex/skills/team-iterdev/roles/reviewer/role.md +0 -66
  210. package/.codex/skills/team-iterdev/roles/tester/role.md +0 -88
  211. package/.codex/skills/team-iterdev/specs/pipelines.md +0 -94
  212. package/.codex/skills/team-iterdev/specs/team-config.json +0 -172
@@ -1,104 +1,104 @@
1
- ---
2
- role: discussant
3
- prefix: DISCUSS
4
- inner_loop: false
5
- message_types:
6
- success: discussion_processed
7
- error: error
8
- ---
9
-
10
- # Discussant
11
-
12
- Process analysis results and user feedback. Execute direction adjustments, deep-dive explorations, or targeted Q&A based on discussion type. Update discussion timeline.
13
-
14
- ## Phase 2: Context Loading
15
-
16
- | Input | Source | Required |
17
- |-------|--------|----------|
18
- | Task description | From task subject/description | Yes |
19
- | Session path | Extracted from task description | Yes |
20
- | Analysis results | `<session>/analyses/*.json` | Yes |
21
- | Exploration results | `<session>/explorations/*.json` | No |
22
-
23
- 1. Extract session path, topic, round, discussion type, user feedback:
24
-
25
- | Field | Pattern | Default |
26
- |-------|---------|---------|
27
- | sessionFolder | `session:\s*(.+)` | required |
28
- | topic | `topic:\s*(.+)` | required |
29
- | round | `round:\s*(\d+)` | 1 |
30
- | discussType | `type:\s*(.+)` | "initial" |
31
- | userFeedback | `user_feedback:\s*(.+)` | empty |
32
-
33
- 2. Read all analysis and exploration results
34
- 3. Aggregate current findings, insights, open questions
35
-
36
- ## Phase 3: Discussion Processing
37
-
38
- Select strategy by discussion type:
39
-
40
- | Type | Mode | Description |
41
- |------|------|-------------|
42
- | initial | inline | Aggregate all analyses: convergent themes, conflicts, top discussion points |
43
- | deepen | cli | Use CLI tool to investigate open questions deeper |
44
- | direction-adjusted | cli | Re-analyze via `ccw cli` from adjusted perspective |
45
- | specific-questions | cli | Targeted exploration answering user questions |
46
-
47
- **initial**: Cross-perspective summary -- identify convergent themes, conflicting views, top 5 discussion points and open questions from all analyses.
48
-
49
- **deepen**: Use CLI tool for deep investigation:
50
- ```javascript
51
- Bash({
52
- command: `ccw cli -p "PURPOSE: Investigate open questions and uncertain insights; success = evidence-based findings
53
- TASK: • Focus on open questions: <questions> • Find supporting evidence • Validate uncertain insights • Document findings
54
- MODE: analysis
55
- CONTEXT: @**/* | Memory: Session <session-folder>, previous analyses
56
- EXPECTED: JSON output with investigation results | Write to <session>/discussions/deepen-<num>.json
57
- CONSTRAINTS: Evidence-based analysis only
58
- " --tool gemini --mode analysis --rule analysis-trace-code-execution`,
59
- })
60
- ```
61
-
62
- **direction-adjusted**: CLI re-analysis from adjusted focus:
63
- ```javascript
64
- Bash({
65
- command: `ccw cli -p "Re-analyze '<topic>' with adjusted focus on '<userFeedback>'" --tool gemini --mode analysis`,
66
- })
67
- ```
68
-
69
- **specific-questions**: Use CLI tool for targeted Q&A:
70
- ```javascript
71
- Bash({
72
- command: `ccw cli -p "PURPOSE: Answer specific user questions about <topic>; success = clear, evidence-based answers
73
- TASK: • Answer: <userFeedback> • Provide code references • Explain context
74
- MODE: analysis
75
- CONTEXT: @**/* | Memory: Session <session-folder>
76
- EXPECTED: JSON output with answers and evidence | Write to <session>/discussions/questions-<num>.json
77
- CONSTRAINTS: Direct answers with code references
78
- " --tool gemini --mode analysis`,
79
- })
80
- ```
81
-
82
- ## Phase 4: Update Discussion Timeline
83
-
84
- 1. Write round content to `<session>/discussions/discussion-round-<num>.json`:
85
- ```json
86
- {
87
- "round": 1, "type": "initial", "user_feedback": "...",
88
- "updated_understanding": { "confirmed": [], "corrected": [], "new_insights": [] },
89
- "new_findings": [], "new_questions": [], "timestamp": "..."
90
- }
91
- ```
92
-
93
- 2. Append round section to `<session>/discussion.md`:
94
- ```markdown
95
- ### Round <N> - Discussion (<timestamp>)
96
- #### Type: <discussType>
97
- #### User Input: <userFeedback or "(Initial discussion round)">
98
- #### Updated Understanding
99
- **Confirmed**: <list> | **Corrected**: <list> | **New Insights**: <list>
100
- #### New Findings / Open Questions
101
- ```
102
-
103
- Update `<session>/wisdom/.msg/meta.json` under `discussant` namespace:
104
- - Read existing -> merge `{ "discussant": { round, type, new_insight_count, corrected_count } }` -> write back
1
+ ---
2
+ role: discussant
3
+ prefix: DISCUSS
4
+ inner_loop: false
5
+ message_types:
6
+ success: discussion_processed
7
+ error: error
8
+ ---
9
+
10
+ # Discussant
11
+
12
+ Process analysis results and user feedback. Execute direction adjustments, deep-dive explorations, or targeted Q&A based on discussion type. Update discussion timeline.
13
+
14
+ ## Phase 2: Context Loading
15
+
16
+ | Input | Source | Required |
17
+ |-------|--------|----------|
18
+ | Task description | From task subject/description | Yes |
19
+ | Session path | Extracted from task description | Yes |
20
+ | Analysis results | `<session>/analyses/*.json` | Yes |
21
+ | Exploration results | `<session>/explorations/*.json` | No |
22
+
23
+ 1. Extract session path, topic, round, discussion type, user feedback:
24
+
25
+ | Field | Pattern | Default |
26
+ |-------|---------|---------|
27
+ | sessionFolder | `session:\s*(.+)` | required |
28
+ | topic | `topic:\s*(.+)` | required |
29
+ | round | `round:\s*(\d+)` | 1 |
30
+ | discussType | `type:\s*(.+)` | "initial" |
31
+ | userFeedback | `user_feedback:\s*(.+)` | empty |
32
+
33
+ 2. Read all analysis and exploration results
34
+ 3. Aggregate current findings, insights, open questions
35
+
36
+ ## Phase 3: Discussion Processing
37
+
38
+ Select strategy by discussion type:
39
+
40
+ | Type | Mode | Description |
41
+ |------|------|-------------|
42
+ | initial | inline | Aggregate all analyses: convergent themes, conflicts, top discussion points |
43
+ | deepen | cli | Use CLI tool to investigate open questions deeper |
44
+ | direction-adjusted | cli | Re-analyze via `ccw cli` from adjusted perspective |
45
+ | specific-questions | cli | Targeted exploration answering user questions |
46
+
47
+ **initial**: Cross-perspective summary -- identify convergent themes, conflicting views, top 5 discussion points and open questions from all analyses.
48
+
49
+ **deepen**: Use CLI tool for deep investigation:
50
+ ```javascript
51
+ Bash({
52
+ command: `ccw cli -p "PURPOSE: Investigate open questions and uncertain insights; success = evidence-based findings
53
+ TASK: • Focus on open questions: <questions> • Find supporting evidence • Validate uncertain insights • Document findings
54
+ MODE: analysis
55
+ CONTEXT: @**/* | Memory: Session <session-folder>, previous analyses
56
+ EXPECTED: JSON output with investigation results | Write to <session>/discussions/deepen-<num>.json
57
+ CONSTRAINTS: Evidence-based analysis only
58
+ " --tool gemini --mode analysis --rule analysis-trace-code-execution`,
59
+ })
60
+ ```
61
+
62
+ **direction-adjusted**: CLI re-analysis from adjusted focus:
63
+ ```javascript
64
+ Bash({
65
+ command: `ccw cli -p "Re-analyze '<topic>' with adjusted focus on '<userFeedback>'" --tool gemini --mode analysis`,
66
+ })
67
+ ```
68
+
69
+ **specific-questions**: Use CLI tool for targeted Q&A:
70
+ ```javascript
71
+ Bash({
72
+ command: `ccw cli -p "PURPOSE: Answer specific user questions about <topic>; success = clear, evidence-based answers
73
+ TASK: • Answer: <userFeedback> • Provide code references • Explain context
74
+ MODE: analysis
75
+ CONTEXT: @**/* | Memory: Session <session-folder>
76
+ EXPECTED: JSON output with answers and evidence | Write to <session>/discussions/questions-<num>.json
77
+ CONSTRAINTS: Direct answers with code references
78
+ " --tool gemini --mode analysis`,
79
+ })
80
+ ```
81
+
82
+ ## Phase 4: Update Discussion Timeline
83
+
84
+ 1. Write round content to `<session>/discussions/discussion-round-<num>.json`:
85
+ ```json
86
+ {
87
+ "round": 1, "type": "initial", "user_feedback": "...",
88
+ "updated_understanding": { "confirmed": [], "corrected": [], "new_insights": [] },
89
+ "new_findings": [], "new_questions": [], "timestamp": "..."
90
+ }
91
+ ```
92
+
93
+ 2. Append round section to `<session>/discussion.md`:
94
+ ```markdown
95
+ ### Round <N> - Discussion (<timestamp>)
96
+ #### Type: <discussType>
97
+ #### User Input: <userFeedback or "(Initial discussion round)">
98
+ #### Updated Understanding
99
+ **Confirmed**: <list> | **Corrected**: <list> | **New Insights**: <list>
100
+ #### New Findings / Open Questions
101
+ ```
102
+
103
+ Update `<session>/wisdom/.msg/meta.json` under `discussant` namespace:
104
+ - Read existing -> merge `{ "discussant": { round, type, new_insight_count, corrected_count } }` -> write back
@@ -1,74 +1,74 @@
1
- ---
2
- role: explorer
3
- prefix: EXPLORE
4
- inner_loop: false
5
- message_types:
6
- success: exploration_ready
7
- error: error
8
- ---
9
-
10
- # Codebase Explorer
11
-
12
- Explore codebase structure through cli-explore-agent, collecting structured context (files, patterns, findings) for downstream analysis. One explorer per analysis perspective.
13
-
14
- ## Phase 2: Context & Scope Assessment
15
-
16
- | Input | Source | Required |
17
- |-------|--------|----------|
18
- | Task description | From task subject/description | Yes |
19
- | Session path | Extracted from task description | Yes |
20
-
21
- 1. Load debug specs: Run `ccw spec load --category debug` for known issues and root-cause notes
22
- 2. Extract session path, topic, perspective, dimensions from task description:
23
-
24
- | Field | Pattern | Default |
25
- |-------|---------|---------|
26
- | sessionFolder | `session:\s*(.+)` | required |
27
- | topic | `topic:\s*(.+)` | required |
28
- | perspective | `perspective:\s*(.+)` | "general" |
29
- | dimensions | `dimensions:\s*(.+)` | "general" |
30
-
31
- 2. Determine exploration number from task subject (EXPLORE-N)
32
- 3. Build exploration strategy by perspective:
33
-
34
- | Perspective | Focus | Search Depth |
35
- |-------------|-------|-------------|
36
- | general | Overall codebase structure and patterns | broad |
37
- | technical | Implementation details, code patterns, feasibility | medium |
38
- | architectural | System design, module boundaries, interactions | broad |
39
- | business | Business logic, domain models, value flows | medium |
40
- | domain_expert | Domain patterns, standards, best practices | deep |
41
-
42
- ## Phase 3: Codebase Exploration
43
-
44
- Use CLI tool for codebase exploration:
45
-
46
- ```javascript
47
- Bash({
48
- command: `ccw cli -p "PURPOSE: Explore codebase for <topic> from <perspective> perspective; success = structured findings with relevant files and patterns
49
- TASK: • Run module depth analysis • Search for topic-related patterns • Identify key files and their relationships • Extract architectural insights
50
- MODE: analysis
51
- CONTEXT: @**/* | Memory: Session <session-folder>, perspective <perspective>
52
- EXPECTED: JSON output with: relevant_files (path, relevance, summary), patterns, key_findings, module_map, questions_for_analysis, _metadata (perspective, search_queries, timestamp)
53
- CONSTRAINTS: Focus on <perspective> angle - <strategy.focus> | Write to <session>/explorations/exploration-<num>.json
54
- " --tool gemini --mode analysis --rule analysis-analyze-code-patterns`,
55
- })
56
- ```
57
-
58
- **ACE fallback** (when CLI produces no output):
59
- ```javascript
60
- mcp__ace-tool__search_context({ project_root_path: ".", query: "<topic> <perspective>" })
61
- ```
62
-
63
- ## Phase 4: Result Validation
64
-
65
- | Check | Method | Action on Failure |
66
- |-------|--------|-------------------|
67
- | Output file exists | Read output path | Create empty result, run ACE fallback |
68
- | Has relevant_files | Array length > 0 | Trigger ACE supplementary search |
69
- | Has key_findings | Array length > 0 | Note partial results, proceed |
70
-
71
- Write validated exploration to `<session>/explorations/exploration-<num>.json`.
72
-
73
- Update `<session>/wisdom/.msg/meta.json` under `explorer` namespace:
74
- - Read existing -> merge `{ "explorer": { perspective, file_count, finding_count } }` -> write back
1
+ ---
2
+ role: explorer
3
+ prefix: EXPLORE
4
+ inner_loop: false
5
+ message_types:
6
+ success: exploration_ready
7
+ error: error
8
+ ---
9
+
10
+ # Codebase Explorer
11
+
12
+ Explore codebase structure through cli-explore-agent, collecting structured context (files, patterns, findings) for downstream analysis. One explorer per analysis perspective.
13
+
14
+ ## Phase 2: Context & Scope Assessment
15
+
16
+ | Input | Source | Required |
17
+ |-------|--------|----------|
18
+ | Task description | From task subject/description | Yes |
19
+ | Session path | Extracted from task description | Yes |
20
+
21
+ 1. Load debug specs: Run `ccw spec load --category debug` for known issues and root-cause notes
22
+ 2. Extract session path, topic, perspective, dimensions from task description:
23
+
24
+ | Field | Pattern | Default |
25
+ |-------|---------|---------|
26
+ | sessionFolder | `session:\s*(.+)` | required |
27
+ | topic | `topic:\s*(.+)` | required |
28
+ | perspective | `perspective:\s*(.+)` | "general" |
29
+ | dimensions | `dimensions:\s*(.+)` | "general" |
30
+
31
+ 2. Determine exploration number from task subject (EXPLORE-N)
32
+ 3. Build exploration strategy by perspective:
33
+
34
+ | Perspective | Focus | Search Depth |
35
+ |-------------|-------|-------------|
36
+ | general | Overall codebase structure and patterns | broad |
37
+ | technical | Implementation details, code patterns, feasibility | medium |
38
+ | architectural | System design, module boundaries, interactions | broad |
39
+ | business | Business logic, domain models, value flows | medium |
40
+ | domain_expert | Domain patterns, standards, best practices | deep |
41
+
42
+ ## Phase 3: Codebase Exploration
43
+
44
+ Use CLI tool for codebase exploration:
45
+
46
+ ```javascript
47
+ Bash({
48
+ command: `ccw cli -p "PURPOSE: Explore codebase for <topic> from <perspective> perspective; success = structured findings with relevant files and patterns
49
+ TASK: • Run module depth analysis • Search for topic-related patterns • Identify key files and their relationships • Extract architectural insights
50
+ MODE: analysis
51
+ CONTEXT: @**/* | Memory: Session <session-folder>, perspective <perspective>
52
+ EXPECTED: JSON output with: relevant_files (path, relevance, summary), patterns, key_findings, module_map, questions_for_analysis, _metadata (perspective, search_queries, timestamp)
53
+ CONSTRAINTS: Focus on <perspective> angle - <strategy.focus> | Write to <session>/explorations/exploration-<num>.json
54
+ " --tool gemini --mode analysis --rule analysis-analyze-code-patterns`,
55
+ })
56
+ ```
57
+
58
+ **ACE fallback** (when CLI produces no output):
59
+ ```javascript
60
+ mcp__ace-tool__search_context({ project_root_path: ".", query: "<topic> <perspective>" })
61
+ ```
62
+
63
+ ## Phase 4: Result Validation
64
+
65
+ | Check | Method | Action on Failure |
66
+ |-------|--------|-------------------|
67
+ | Output file exists | Read output path | Create empty result, run ACE fallback |
68
+ | Has relevant_files | Array length > 0 | Trigger ACE supplementary search |
69
+ | Has key_findings | Array length > 0 | Note partial results, proceed |
70
+
71
+ Write validated exploration to `<session>/explorations/exploration-<num>.json`.
72
+
73
+ Update `<session>/wisdom/.msg/meta.json` under `explorer` namespace:
74
+ - Read existing -> merge `{ "explorer": { perspective, file_count, finding_count } }` -> write back
@@ -1,78 +1,78 @@
1
- ---
2
- role: synthesizer
3
- prefix: SYNTH
4
- inner_loop: false
5
- message_types:
6
- success: synthesis_ready
7
- error: error
8
- ---
9
-
10
- # Synthesizer
11
-
12
- Integrate all explorations, analyses, and discussions into final conclusions. Cross-perspective theme extraction, conflict resolution, evidence consolidation, and recommendation prioritization. Pure integration role -- no external tools or CLI calls.
13
-
14
- ## Phase 2: Context Loading
15
-
16
- | Input | Source | Required |
17
- |-------|--------|----------|
18
- | Task description | From task subject/description | Yes |
19
- | Session path | Extracted from task description | Yes |
20
- | All artifacts | `<session>/explorations/*.json`, `analyses/*.json`, `discussions/*.json` | Yes |
21
- | Decision trail | From wisdom/.msg/meta.json | No |
22
-
23
- 1. Extract session path and topic from task description
24
- 2. Read all exploration, analysis, and discussion round files
25
- 3. Load decision trail and current understanding from meta.json
26
- 4. Select synthesis strategy:
27
-
28
- | Condition | Strategy |
29
- |-----------|----------|
30
- | Single analysis, no discussions | simple (Quick mode summary) |
31
- | Multiple analyses, >2 discussion rounds | deep (track evolution) |
32
- | Default | standard (cross-perspective integration) |
33
-
34
- ## Phase 3: Cross-Perspective Synthesis
35
-
36
- Execute synthesis across four dimensions:
37
-
38
- **1. Theme Extraction**: Identify convergent themes across all analysis perspectives. Cluster insights by similarity, rank by cross-perspective confirmation count.
39
-
40
- **2. Conflict Resolution**: Identify contradictions between perspectives. Present both sides with trade-off analysis when irreconcilable.
41
-
42
- **3. Evidence Consolidation**: Deduplicate findings, aggregate by file reference. Map evidence to conclusions with confidence levels:
43
-
44
- | Level | Criteria |
45
- |-------|----------|
46
- | High | Multiple sources confirm, strong evidence |
47
- | Medium | Single source or partial evidence |
48
- | Low | Speculative, needs verification |
49
-
50
- **4. Recommendation Prioritization**: Sort all recommendations by priority (high > medium > low), deduplicate, cap at 10.
51
-
52
- Integrate decision trail from discussion rounds into final narrative.
53
-
54
- ## Phase 4: Write Conclusions
55
-
56
- 1. Write `<session>/conclusions.json`:
57
- ```json
58
- {
59
- "session_id": "...", "topic": "...", "completed": "ISO-8601",
60
- "summary": "Executive summary...",
61
- "key_conclusions": [{"point": "...", "evidence": "...", "confidence": "high"}],
62
- "recommendations": [{"action": "...", "rationale": "...", "priority": "high"}],
63
- "open_questions": ["..."],
64
- "decision_trail": [{"round": 1, "decision": "...", "context": "..."}],
65
- "cross_perspective_synthesis": { "convergent_themes": [], "conflicts_resolved": [], "unique_contributions": [] },
66
- "_metadata": { "explorations": 3, "analyses": 3, "discussions": 2, "strategy": "standard" }
67
- }
68
- ```
69
-
70
- 2. Append conclusions section to `<session>/discussion.md`:
71
- ```markdown
72
- ## Conclusions
73
- ### Summary / Key Conclusions / Recommendations / Remaining Questions
74
- ## Decision Trail / Current Understanding (Final) / Session Statistics
75
- ```
76
-
77
- Update `<session>/wisdom/.msg/meta.json` under `synthesizer` namespace:
78
- - Read existing -> merge `{ "synthesizer": { conclusion_count, recommendation_count, open_question_count } }` -> write back
1
+ ---
2
+ role: synthesizer
3
+ prefix: SYNTH
4
+ inner_loop: false
5
+ message_types:
6
+ success: synthesis_ready
7
+ error: error
8
+ ---
9
+
10
+ # Synthesizer
11
+
12
+ Integrate all explorations, analyses, and discussions into final conclusions. Cross-perspective theme extraction, conflict resolution, evidence consolidation, and recommendation prioritization. Pure integration role -- no external tools or CLI calls.
13
+
14
+ ## Phase 2: Context Loading
15
+
16
+ | Input | Source | Required |
17
+ |-------|--------|----------|
18
+ | Task description | From task subject/description | Yes |
19
+ | Session path | Extracted from task description | Yes |
20
+ | All artifacts | `<session>/explorations/*.json`, `analyses/*.json`, `discussions/*.json` | Yes |
21
+ | Decision trail | From wisdom/.msg/meta.json | No |
22
+
23
+ 1. Extract session path and topic from task description
24
+ 2. Read all exploration, analysis, and discussion round files
25
+ 3. Load decision trail and current understanding from meta.json
26
+ 4. Select synthesis strategy:
27
+
28
+ | Condition | Strategy |
29
+ |-----------|----------|
30
+ | Single analysis, no discussions | simple (Quick mode summary) |
31
+ | Multiple analyses, >2 discussion rounds | deep (track evolution) |
32
+ | Default | standard (cross-perspective integration) |
33
+
34
+ ## Phase 3: Cross-Perspective Synthesis
35
+
36
+ Execute synthesis across four dimensions:
37
+
38
+ **1. Theme Extraction**: Identify convergent themes across all analysis perspectives. Cluster insights by similarity, rank by cross-perspective confirmation count.
39
+
40
+ **2. Conflict Resolution**: Identify contradictions between perspectives. Present both sides with trade-off analysis when irreconcilable.
41
+
42
+ **3. Evidence Consolidation**: Deduplicate findings, aggregate by file reference. Map evidence to conclusions with confidence levels:
43
+
44
+ | Level | Criteria |
45
+ |-------|----------|
46
+ | High | Multiple sources confirm, strong evidence |
47
+ | Medium | Single source or partial evidence |
48
+ | Low | Speculative, needs verification |
49
+
50
+ **4. Recommendation Prioritization**: Sort all recommendations by priority (high > medium > low), deduplicate, cap at 10.
51
+
52
+ Integrate decision trail from discussion rounds into final narrative.
53
+
54
+ ## Phase 4: Write Conclusions
55
+
56
+ 1. Write `<session>/conclusions.json`:
57
+ ```json
58
+ {
59
+ "session_id": "...", "topic": "...", "completed": "ISO-8601",
60
+ "summary": "Executive summary...",
61
+ "key_conclusions": [{"point": "...", "evidence": "...", "confidence": "high"}],
62
+ "recommendations": [{"action": "...", "rationale": "...", "priority": "high"}],
63
+ "open_questions": ["..."],
64
+ "decision_trail": [{"round": 1, "decision": "...", "context": "..."}],
65
+ "cross_perspective_synthesis": { "convergent_themes": [], "conflicts_resolved": [], "unique_contributions": [] },
66
+ "_metadata": { "explorations": 3, "analyses": 3, "discussions": 2, "strategy": "standard" }
67
+ }
68
+ ```
69
+
70
+ 2. Append conclusions section to `<session>/discussion.md`:
71
+ ```markdown
72
+ ## Conclusions
73
+ ### Summary / Key Conclusions / Recommendations / Remaining Questions
74
+ ## Decision Trail / Current Understanding (Final) / Session Statistics
75
+ ```
76
+
77
+ Update `<session>/wisdom/.msg/meta.json` under `synthesizer` namespace:
78
+ - Read existing -> merge `{ "synthesizer": { conclusion_count, recommendation_count, open_question_count } }` -> write back
@@ -1,64 +1,64 @@
1
- # Pipeline Definitions — Team Ultra Analyze
2
-
3
- ## Pipeline Modes
4
-
5
- ### Quick Mode (3 tasks, serial)
6
-
7
- ```
8
- EXPLORE-001 -> ANALYZE-001 -> SYNTH-001
9
- ```
10
-
11
- | Task | Role | Dependencies |
12
- |------|------|-------------|
13
- | EXPLORE-001 | explorer | (none) |
14
- | ANALYZE-001 | analyst | EXPLORE-001 |
15
- | SYNTH-001 | synthesizer | ANALYZE-001 |
16
-
17
- ### Standard Mode (2N+2 tasks, parallel windows)
18
-
19
- ```
20
- [EXPLORE-001..N](parallel) -> [ANALYZE-001..N](parallel) -> DISCUSS-001 -> SYNTH-001
21
- ```
22
-
23
- | Task | Role | Dependencies |
24
- |------|------|-------------|
25
- | EXPLORE-001..N | explorer | (none, parallel) |
26
- | ANALYZE-001..N | analyst | corresponding EXPLORE-N |
27
- | DISCUSS-001 | discussant | all ANALYZE tasks |
28
- | SYNTH-001 | synthesizer | DISCUSS-001 |
29
-
30
- ### Deep Mode (2N+1 tasks initially, dynamic loop)
31
-
32
- Same as Standard but SYNTH-001 is omitted at dispatch. Created dynamically after discussion loop completes.
33
-
34
- Dynamic tasks created during discussion loop:
35
- - `DISCUSS-N` (round N) — created based on user feedback
36
- - `ANALYZE-fix-N` (direction fix) — created when user requests adjusted focus
37
- - `SYNTH-001` — created after final discussion round
38
-
39
- ## Task Metadata Registry
40
-
41
- | Task ID | Role | Dependencies | Description |
42
- |---------|------|-------------|-------------|
43
- | EXPLORE-1..depth | explorer | (none) | Parallel codebase exploration, one per perspective |
44
- | ANALYZE-1..depth | analyst | EXPLORE-1..depth (all) | Parallel deep analysis, one per perspective |
45
- | DISCUSS-001 | discussant | ANALYZE-1..depth (all) | Process analysis results, identify gaps |
46
- | ANALYZE-fix-N | analyst | DISCUSS-N | Re-analysis for adjusted focus (Deep mode) |
47
- | DISCUSS-002..N | discussant | ANALYZE-fix-N | Subsequent discussion rounds (Deep mode, max 5) |
48
- | SYNTH-001 | synthesizer | Last DISCUSS-N | Cross-perspective integration and conclusions |
49
-
50
- ## Discussion Loop Control
51
-
52
- | Mode | Max Rounds | Trigger |
53
- |------|-----------|---------|
54
- | quick | 0 | No discussion |
55
- | standard | 1 | After DISCUSS-001 |
56
- | deep | 5 | After each DISCUSS-N |
57
-
58
- ## Checkpoints
59
-
60
- | Trigger | Location | Behavior |
61
- |---------|----------|----------|
62
- | Discussion round (Deep mode) | After DISCUSS-N completes | Pause, AskUser for direction/continuation |
63
- | Discussion loop limit | >5 rounds | Force synthesis, offer continuation |
64
- | Pipeline stall | No ready + no running | Check missing tasks, report to user |
1
+ # Pipeline Definitions — Team Ultra Analyze
2
+
3
+ ## Pipeline Modes
4
+
5
+ ### Quick Mode (3 tasks, serial)
6
+
7
+ ```
8
+ EXPLORE-001 -> ANALYZE-001 -> SYNTH-001
9
+ ```
10
+
11
+ | Task | Role | Dependencies |
12
+ |------|------|-------------|
13
+ | EXPLORE-001 | explorer | (none) |
14
+ | ANALYZE-001 | analyst | EXPLORE-001 |
15
+ | SYNTH-001 | synthesizer | ANALYZE-001 |
16
+
17
+ ### Standard Mode (2N+2 tasks, parallel windows)
18
+
19
+ ```
20
+ [EXPLORE-001..N](parallel) -> [ANALYZE-001..N](parallel) -> DISCUSS-001 -> SYNTH-001
21
+ ```
22
+
23
+ | Task | Role | Dependencies |
24
+ |------|------|-------------|
25
+ | EXPLORE-001..N | explorer | (none, parallel) |
26
+ | ANALYZE-001..N | analyst | corresponding EXPLORE-N |
27
+ | DISCUSS-001 | discussant | all ANALYZE tasks |
28
+ | SYNTH-001 | synthesizer | DISCUSS-001 |
29
+
30
+ ### Deep Mode (2N+1 tasks initially, dynamic loop)
31
+
32
+ Same as Standard but SYNTH-001 is omitted at dispatch. Created dynamically after discussion loop completes.
33
+
34
+ Dynamic tasks created during discussion loop:
35
+ - `DISCUSS-N` (round N) — created based on user feedback
36
+ - `ANALYZE-fix-N` (direction fix) — created when user requests adjusted focus
37
+ - `SYNTH-001` — created after final discussion round
38
+
39
+ ## Task Metadata Registry
40
+
41
+ | Task ID | Role | Dependencies | Description |
42
+ |---------|------|-------------|-------------|
43
+ | EXPLORE-1..depth | explorer | (none) | Parallel codebase exploration, one per perspective |
44
+ | ANALYZE-1..depth | analyst | EXPLORE-1..depth (all) | Parallel deep analysis, one per perspective |
45
+ | DISCUSS-001 | discussant | ANALYZE-1..depth (all) | Process analysis results, identify gaps |
46
+ | ANALYZE-fix-N | analyst | DISCUSS-N | Re-analysis for adjusted focus (Deep mode) |
47
+ | DISCUSS-002..N | discussant | ANALYZE-fix-N | Subsequent discussion rounds (Deep mode, max 5) |
48
+ | SYNTH-001 | synthesizer | Last DISCUSS-N | Cross-perspective integration and conclusions |
49
+
50
+ ## Discussion Loop Control
51
+
52
+ | Mode | Max Rounds | Trigger |
53
+ |------|-----------|---------|
54
+ | quick | 0 | No discussion |
55
+ | standard | 1 | After DISCUSS-001 |
56
+ | deep | 5 | After each DISCUSS-N |
57
+
58
+ ## Checkpoints
59
+
60
+ | Trigger | Location | Behavior |
61
+ |---------|----------|----------|
62
+ | Discussion round (Deep mode) | After DISCUSS-N completes | Pause, AskUser for direction/continuation |
63
+ | Discussion loop limit | >5 rounds | Force synthesis, offer continuation |
64
+ | Pipeline stall | No ready + no running | Check missing tasks, report to user |