maestro-flow 0.3.37 → 0.3.39

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 (186) hide show
  1. package/.claude/agents/workflow-analyzer.md +2 -0
  2. package/.claude/agents/workflow-debugger.md +2 -0
  3. package/.claude/agents/workflow-executor.md +2 -0
  4. package/.claude/agents/workflow-integration-checker.md +1 -0
  5. package/.claude/agents/workflow-nyquist-auditor.md +1 -0
  6. package/.claude/agents/workflow-planner.md +2 -0
  7. package/.claude/agents/workflow-reviewer.md +2 -0
  8. package/.claude/agents/workflow-verifier.md +2 -0
  9. package/.claude/commands/learn-decompose.md +176 -176
  10. package/.claude/commands/learn-follow.md +167 -167
  11. package/.claude/commands/learn-investigate.md +221 -221
  12. package/.claude/commands/learn-retro.md +303 -303
  13. package/.claude/commands/learn-second-opinion.md +167 -167
  14. package/.claude/commands/maestro-amend.md +300 -300
  15. package/.claude/commands/maestro-analyze.md +126 -126
  16. package/.claude/commands/maestro-brainstorm.md +100 -100
  17. package/.claude/commands/maestro-composer.md +354 -354
  18. package/.claude/commands/maestro-execute.md +120 -114
  19. package/.claude/commands/maestro-fork.md +86 -86
  20. package/.claude/commands/maestro-init.md +78 -78
  21. package/.claude/commands/maestro-learn.md +140 -140
  22. package/.claude/commands/maestro-link-coordinate.md +1 -1
  23. package/.claude/commands/maestro-merge.md +61 -61
  24. package/.claude/commands/maestro-milestone-release.md +96 -96
  25. package/.claude/commands/maestro-overlay.md +178 -178
  26. package/.claude/commands/maestro-plan.md +150 -138
  27. package/.claude/commands/maestro-player.md +404 -404
  28. package/.claude/commands/maestro-quick.md +56 -56
  29. package/.claude/commands/maestro-ralph-execute.md +7 -18
  30. package/.claude/commands/maestro-ralph.md +9 -3
  31. package/.claude/commands/maestro-roadmap.md +1 -1
  32. package/.claude/commands/maestro-ui-design.md +93 -93
  33. package/.claude/commands/maestro-update.md +176 -176
  34. package/.claude/commands/maestro-verify.md +96 -90
  35. package/.claude/commands/maestro.md +121 -121
  36. package/.claude/commands/manage-codebase-rebuild.md +75 -75
  37. package/.claude/commands/manage-codebase-refresh.md +57 -57
  38. package/.claude/commands/manage-harvest.md +94 -94
  39. package/.claude/commands/manage-issue-discover.md +77 -77
  40. package/.claude/commands/manage-issue.md +73 -73
  41. package/.claude/commands/manage-knowhow-capture.md +193 -193
  42. package/.claude/commands/manage-knowhow.md +77 -77
  43. package/.claude/commands/manage-learn.md +67 -67
  44. package/.claude/commands/manage-status.md +51 -51
  45. package/.claude/commands/manage-wiki.md +62 -62
  46. package/.claude/commands/quality-auto-test.md +1 -1
  47. package/.claude/commands/quality-debug.md +121 -115
  48. package/.claude/commands/quality-refactor.md +55 -55
  49. package/.claude/commands/quality-retrospective.md +78 -78
  50. package/.claude/commands/quality-review.md +114 -108
  51. package/.claude/commands/quality-sync.md +51 -51
  52. package/.claude/commands/quality-test.md +103 -103
  53. package/.claude/commands/spec-add.md +49 -49
  54. package/.claude/commands/spec-load.md +51 -51
  55. package/.claude/commands/spec-remove.md +51 -51
  56. package/.claude/commands/spec-setup.md +51 -51
  57. package/.claude/commands/wiki-connect.md +62 -62
  58. package/.claude/commands/wiki-digest.md +69 -69
  59. package/.codex/skills/learn-decompose/SKILL.md +113 -113
  60. package/.codex/skills/learn-follow/SKILL.md +1 -1
  61. package/.codex/skills/learn-investigate/SKILL.md +83 -83
  62. package/.codex/skills/learn-retro/SKILL.md +83 -83
  63. package/.codex/skills/learn-second-opinion/SKILL.md +86 -86
  64. package/.codex/skills/maestro/SKILL.md +304 -304
  65. package/.codex/skills/maestro-analyze/SKILL.md +9 -8
  66. package/.codex/skills/maestro-brainstorm/SKILL.md +442 -397
  67. package/.codex/skills/maestro-composer/SKILL.md +213 -213
  68. package/.codex/skills/maestro-execute/SKILL.md +346 -318
  69. package/.codex/skills/maestro-fork/SKILL.md +56 -2
  70. package/.codex/skills/maestro-init/SKILL.md +40 -16
  71. package/.codex/skills/maestro-learn/SKILL.md +80 -80
  72. package/.codex/skills/maestro-link-coordinate/SKILL.md +257 -257
  73. package/.codex/skills/maestro-merge/SKILL.md +1 -1
  74. package/.codex/skills/maestro-milestone-audit/SKILL.md +1 -1
  75. package/.codex/skills/maestro-milestone-complete/SKILL.md +40 -9
  76. package/.codex/skills/maestro-milestone-release/SKILL.md +70 -70
  77. package/.codex/skills/maestro-overlay/SKILL.md +1 -1
  78. package/.codex/skills/maestro-plan/SKILL.md +19 -4
  79. package/.codex/skills/maestro-player/SKILL.md +323 -323
  80. package/.codex/skills/maestro-quick/SKILL.md +1 -1
  81. package/.codex/skills/maestro-ralph/SKILL.md +681 -578
  82. package/.codex/skills/maestro-roadmap/SKILL.md +518 -468
  83. package/.codex/skills/maestro-ui-design/SKILL.md +109 -12
  84. package/.codex/skills/maestro-verify/SKILL.md +27 -9
  85. package/.codex/skills/manage-codebase-rebuild/SKILL.md +3 -2
  86. package/.codex/skills/manage-codebase-refresh/SKILL.md +1 -1
  87. package/.codex/skills/manage-harvest/SKILL.md +91 -91
  88. package/.codex/skills/manage-issue/SKILL.md +19 -6
  89. package/.codex/skills/manage-issue-discover/SKILL.md +1 -1
  90. package/.codex/skills/manage-knowhow/SKILL.md +95 -95
  91. package/.codex/skills/manage-knowhow-capture/SKILL.md +110 -110
  92. package/.codex/skills/manage-learn/SKILL.md +1 -1
  93. package/.codex/skills/manage-status/SKILL.md +1 -1
  94. package/.codex/skills/manage-wiki/SKILL.md +55 -55
  95. package/.codex/skills/quality-auto-test/SKILL.md +547 -547
  96. package/.codex/skills/quality-debug/SKILL.md +339 -334
  97. package/.codex/skills/quality-refactor/SKILL.md +1 -1
  98. package/.codex/skills/quality-retrospective/SKILL.md +292 -292
  99. package/.codex/skills/quality-review/SKILL.md +365 -364
  100. package/.codex/skills/quality-sync/SKILL.md +1 -1
  101. package/.codex/skills/quality-test/SKILL.md +498 -498
  102. package/.codex/skills/spec-add/SKILL.md +101 -101
  103. package/.codex/skills/spec-load/SKILL.md +77 -77
  104. package/.codex/skills/spec-map/SKILL.md +1 -1
  105. package/.codex/skills/spec-remove/SKILL.md +69 -69
  106. package/.codex/skills/spec-setup/SKILL.md +1 -1
  107. package/.codex/skills/team-coordinate/SKILL.md +2 -1
  108. package/.codex/skills/team-executor/SKILL.md +116 -115
  109. package/.codex/skills/team-lifecycle-v4/SKILL.md +2 -1
  110. package/.codex/skills/team-lifecycle-v4/instructions/agent-instruction.md +14 -6
  111. package/.codex/skills/team-lifecycle-v4/roles/analyst/role.md +16 -4
  112. package/.codex/skills/team-lifecycle-v4/roles/executor/commands/implement.md +7 -1
  113. package/.codex/skills/team-lifecycle-v4/roles/planner/role.md +16 -4
  114. package/.codex/skills/team-lifecycle-v4/roles/writer/role.md +8 -2
  115. package/.codex/skills/team-quality-assurance/SKILL.md +2 -1
  116. package/.codex/skills/team-quality-assurance/roles/scout/role.md +9 -2
  117. package/.codex/skills/team-review/SKILL.md +2 -1
  118. package/.codex/skills/team-review/roles/reviewer/role.md +10 -1
  119. package/.codex/skills/team-review/roles/scanner/role.md +10 -1
  120. package/.codex/skills/team-tech-debt/SKILL.md +144 -143
  121. package/.codex/skills/team-tech-debt/roles/executor/role.md +9 -5
  122. package/.codex/skills/team-tech-debt/roles/scanner/role.md +10 -0
  123. package/.codex/skills/team-tech-debt/roles/validator/role.md +8 -2
  124. package/.codex/skills/team-testing/SKILL.md +2 -1
  125. package/.codex/skills/team-testing/roles/executor/role.md +8 -2
  126. package/.codex/skills/team-testing/roles/generator/role.md +8 -2
  127. package/.codex/skills/wiki-connect/SKILL.md +73 -73
  128. package/.codex/skills/wiki-digest/SKILL.md +87 -87
  129. package/README.md +6 -0
  130. package/README.zh-CN.md +6 -0
  131. package/dashboard/dist-server/dashboard/src/server/agents/claude-code-adapter.js +4 -0
  132. package/dashboard/dist-server/dashboard/src/server/agents/claude-code-adapter.js.map +1 -1
  133. package/dashboard/dist-server/dashboard/src/server/agents/codex-cli-adapter.js +118 -7
  134. package/dashboard/dist-server/dashboard/src/server/agents/codex-cli-adapter.js.map +1 -1
  135. package/dashboard/dist-server/shared/agent-types.d.ts +2 -0
  136. package/dashboard/dist-server/src/agents/cli-agent-runner.d.ts +2 -0
  137. package/dashboard/dist-server/src/agents/cli-agent-runner.js +4 -0
  138. package/dashboard/dist-server/src/agents/cli-agent-runner.js.map +1 -1
  139. package/dashboard/dist-server/src/commands/delegate.d.ts +2 -0
  140. package/dashboard/dist-server/src/commands/delegate.js +18 -0
  141. package/dashboard/dist-server/src/commands/delegate.js.map +1 -1
  142. package/dashboard/dist-server/src/config/cli-tools-config.d.ts +6 -0
  143. package/dashboard/dist-server/src/config/cli-tools-config.js +2 -0
  144. package/dashboard/dist-server/src/config/cli-tools-config.js.map +1 -1
  145. package/dist/shared/agent-types.d.ts +2 -0
  146. package/dist/shared/agent-types.d.ts.map +1 -1
  147. package/dist/src/agents/cli-agent-runner.d.ts +2 -0
  148. package/dist/src/agents/cli-agent-runner.d.ts.map +1 -1
  149. package/dist/src/agents/cli-agent-runner.js +4 -0
  150. package/dist/src/agents/cli-agent-runner.js.map +1 -1
  151. package/dist/src/commands/config.d.ts.map +1 -1
  152. package/dist/src/commands/config.js +29 -1
  153. package/dist/src/commands/config.js.map +1 -1
  154. package/dist/src/commands/delegate.d.ts +2 -0
  155. package/dist/src/commands/delegate.d.ts.map +1 -1
  156. package/dist/src/commands/delegate.js +18 -0
  157. package/dist/src/commands/delegate.js.map +1 -1
  158. package/dist/src/commands/launcher.d.ts.map +1 -1
  159. package/dist/src/commands/launcher.js +27 -4
  160. package/dist/src/commands/launcher.js.map +1 -1
  161. package/dist/src/config/cli-tools-config.d.ts +6 -0
  162. package/dist/src/config/cli-tools-config.d.ts.map +1 -1
  163. package/dist/src/config/cli-tools-config.js +2 -0
  164. package/dist/src/config/cli-tools-config.js.map +1 -1
  165. package/dist/src/core/overlay/applier.d.ts.map +1 -1
  166. package/dist/src/core/overlay/applier.js +65 -5
  167. package/dist/src/core/overlay/applier.js.map +1 -1
  168. package/dist/src/core/overlay/loader.d.ts.map +1 -1
  169. package/dist/src/core/overlay/loader.js +9 -4
  170. package/dist/src/core/overlay/loader.js.map +1 -1
  171. package/dist/src/core/overlay/types.d.ts +2 -0
  172. package/dist/src/core/overlay/types.d.ts.map +1 -1
  173. package/dist/src/core/overlay/types.js +2 -0
  174. package/dist/src/core/overlay/types.js.map +1 -1
  175. package/dist/src/tui/tools-ui/ToolsDashboard.d.ts.map +1 -1
  176. package/dist/src/tui/tools-ui/ToolsDashboard.js +1 -1
  177. package/dist/src/tui/tools-ui/ToolsDashboard.js.map +1 -1
  178. package/dist/src/tui/tools-ui/ToolsOverview.d.ts.map +1 -1
  179. package/dist/src/tui/tools-ui/ToolsOverview.js +51 -4
  180. package/dist/src/tui/tools-ui/ToolsOverview.js.map +1 -1
  181. package/package.json +1 -1
  182. package/shared/agent-types.ts +2 -0
  183. package/workflows/delegate-protocol.codex.md +65 -0
  184. package/workflows/issue-analyze.md +2 -3
  185. package/workflows/issue-gaps-analyze.codex.md +260 -0
  186. package/workflows/issue-gaps-analyze.md +214 -0
@@ -1,126 +1,126 @@
1
- ---
2
- name: maestro-analyze
3
- description: Multi-dimensional analysis with CLI exploration, decision extraction, and intent tracking
4
- argument-hint: "[phase|topic] [-y] [-c] [-q] [--gaps [ISS-ID]]"
5
- allowed-tools:
6
- - Read
7
- - Write
8
- - Edit
9
- - Bash
10
- - Glob
11
- - Grep
12
- - Agent
13
- - AskUserQuestion
14
- ---
15
- <purpose>
16
- Perform multi-dimensional analysis of a technical proposal, decision, or architecture choice through iterative CLI-assisted exploration and interactive discussion. Produces a discussion timeline (discussion.md) with evolving understanding, multi-perspective findings, Decision Recording Protocol, Intent Coverage tracking, and a final conclusions package with Go/No-Go recommendation.
17
-
18
- Combines structured 6-dimension scoring with iterative deepening and decision extraction. Replaces both analysis and decision-capture workflows — produces analysis.md (scoring) AND context.md (Locked/Free/Deferred decisions for plan).
19
-
20
- Use `-q` for quick decision extraction only (skip exploration + scoring).
21
-
22
- Use `--gaps` for issue-focused root cause analysis (replaces manage-issue-analyze). Loads issues from issues.jsonl, performs CLI exploration against issue context/location, synthesizes root cause into issue.analysis, and outputs context.md for downstream `plan --gaps`.
23
- </purpose>
24
-
25
- <required_reading>
26
- @~/.maestro/workflows/analyze.md
27
- </required_reading>
28
-
29
- <deferred_reading>
30
- - [state.json](~/.maestro/templates/state.json) — read when registering artifact
31
- - [issue-gaps-analyze.md](~/.maestro/workflows/issue-gaps-analyze.md) — read when --gaps is triggered
32
- </deferred_reading>
33
-
34
- <context>
35
- $ARGUMENTS -- phase number for milestone-scoped, topic text for adhoc/standalone mode, no args for milestone-wide.
36
-
37
- **Flags:**
38
- - `-y` / `--yes`: Auto mode — skip interactive scoping, use recommended defaults, auto-deepen
39
- - `-c` / `--continue`: Resume from existing session (auto-detect session folder + discussion.md)
40
- - `-q` / `--quick`: Quick mode — skip exploration + scoring, go straight to decision extraction (context.md only)
41
- - `--gaps [ISS-ID]`: Issue root cause analysis mode. If ISS-ID provided, analyze single issue. If omitted, analyze all open/registered issues from issues.jsonl.
42
-
43
- Scope routing, output directory format, artifact registration schema, and output artifact listing are defined in workflow analyze.md (Scope Routing and Output Structure sections).
44
- </context>
45
-
46
- <execution>
47
- Follow '~/.maestro/workflows/analyze.md' completely.
48
-
49
- ### --gaps Mode (Issue Root Cause Analysis)
50
-
51
- When `--gaps` flag is present, follow `~/.maestro/workflows/issue-gaps-analyze.md` instead of the standard analyze pipeline:
52
-
53
- ```
54
- Phase 1: Load issues from .workflow/issues/issues.jsonl
55
- - If ISS-ID provided: load single issue
56
- - If no ISS-ID: filter issues where status = open | registered
57
- - Validate: at least 1 issue loaded, else error E_NO_ISSUES
58
-
59
- Phase 2: CLI exploration per issue
60
- - For each issue: build exploration prompt from issue.title, description, context, related_files
61
- - Run maestro delegate --role analyze --mode analysis with codebase context
62
- - Gather affected files, call chains, root cause evidence
63
-
64
- Phase 3: Root cause synthesis → write issue.analysis
65
- - Parse CLI output into analysis record: { root_cause, affected_files, impact_scope, fix_direction, confidence, analyzed_at, tool, depth }
66
- - Write analysis record to issue in issues.jsonl
67
- - Append history entry: { action: "analyzed", at: <ISO>, by: "maestro-analyze --gaps" }
68
-
69
- Phase 4: Output context.md for downstream plan --gaps
70
- - Aggregate all analyzed issues into context.md with root causes and fix directions
71
- - Register ANL artifact in state.json
72
- ```
73
-
74
- **Handoff:** context.md is consumed by maestro-plan (loads Locked/Free/Deferred decisions). In --gaps mode, context.md contains issue root causes for `plan --gaps` consumption.
75
-
76
- **Next-step routing on completion:**
77
-
78
- Phase/Milestone scope:
79
- - Go recommendation, UI work needed → `/maestro-ui-design {phase}`
80
- - Go recommendation, ready to plan → `/maestro-plan` or `/maestro-plan {phase}`
81
- - No-Go recommendation → revisit requirements or `/maestro-brainstorm {topic}`
82
-
83
- Adhoc/Standalone scope:
84
- - Ready to plan → `/maestro-plan --dir {scratch_dir}`
85
- - Need more exploration → `/maestro-analyze {topic} -c`
86
-
87
- Gaps scope:
88
- - Issues analyzed → `/maestro-plan --gaps` (plan fix tasks linked to issues)
89
- - Need more context → `/maestro-analyze --gaps {ISS-ID}` (re-analyze specific issue)
90
- </execution>
91
-
92
- <error_codes>
93
- | Code | Severity | Condition | Recovery |
94
- |------|----------|-----------|----------|
95
- | E001 | error | No args and no roadmap (cannot determine scope) | Prompt user for topic text or create roadmap first |
96
- | W001 | warning | CLI exploration failed | Continue with available context, note limitation |
97
- | W002 | warning | CLI analysis timeout | Retry with shorter prompt, or skip perspective |
98
- | W003 | warning | Insufficient evidence for scoring dimensions | Note low-confidence dimensions, proceed with available evidence |
99
- | W004 | warning | Max rounds reached (5) | Force synthesis, offer continuation option |
100
- | E_NO_ISSUES | error | --gaps but no open/registered issues found | Suggest `/manage-issue-discover` or `/manage-issue create` |
101
- | E_ISSUE_NOT_FOUND | error | --gaps with ISS-ID but issue not found | Suggest `/manage-issue list` to find valid IDs |
102
- </error_codes>
103
-
104
- <success_criteria>
105
- Full mode:
106
- - [ ] CLI exploration completed with code anchors and call chains
107
- - [ ] discussion.md created with full timeline, TOC, Current Understanding
108
- - [ ] analysis.md written with all 6 dimensions scored with evidence
109
- - [ ] conclusions.json created with recommendations and decision trail
110
- - [ ] Intent Coverage tracked and verified (no unresolved ❌ items)
111
-
112
- Gaps mode:
113
- - [ ] Issues loaded from issues.jsonl (all open/registered, or single ISS-ID)
114
- - [ ] CLI exploration executed per issue with codebase context
115
- - [ ] Analysis record attached to each issue in issues.jsonl
116
- - [ ] context.md written with aggregated root causes for plan --gaps
117
-
118
- Both modes (full + quick):
119
- - [ ] context.md written with all decisions classified as Locked/Free/Deferred
120
- - [ ] Gray areas identified through phase-specific analysis
121
- - [ ] Decision Recording Protocol applied to all decisions
122
- - [ ] Scope creep redirected to Deferred section
123
- - [ ] Deferred items auto-created as issues (if any)
124
- - [ ] Artifact registered in state.json with correct scope/milestone/phase
125
- - [ ] Next step routed (ui-design/plan for Go, brainstorm for No-Go)
126
- </success_criteria>
1
+ ---
2
+ name: maestro-analyze
3
+ description: Multi-angle analysis with CLI-assisted exploration
4
+ argument-hint: "[phase|topic] [-y] [-c] [-q] [--gaps [ISS-ID]]"
5
+ allowed-tools:
6
+ - Read
7
+ - Write
8
+ - Edit
9
+ - Bash
10
+ - Glob
11
+ - Grep
12
+ - Agent
13
+ - AskUserQuestion
14
+ ---
15
+ <purpose>
16
+ Perform multi-dimensional analysis of a technical proposal, decision, or architecture choice through iterative CLI-assisted exploration and interactive discussion. Produces a discussion timeline (discussion.md) with evolving understanding, multi-perspective findings, Decision Recording Protocol, Intent Coverage tracking, and a final conclusions package with Go/No-Go recommendation.
17
+
18
+ Combines structured 6-dimension scoring with iterative deepening and decision extraction. Replaces both analysis and decision-capture workflows — produces analysis.md (scoring) AND context.md (Locked/Free/Deferred decisions for plan).
19
+
20
+ Use `-q` for quick decision extraction only (skip exploration + scoring).
21
+
22
+ Use `--gaps` for issue-focused root cause analysis (replaces manage-issue-analyze). Loads issues from issues.jsonl, performs CLI exploration against issue context/location, synthesizes root cause into issue.analysis, and outputs context.md for downstream `plan --gaps`.
23
+ </purpose>
24
+
25
+ <required_reading>
26
+ @~/.maestro/workflows/analyze.md
27
+ </required_reading>
28
+
29
+ <deferred_reading>
30
+ - [state.json](~/.maestro/templates/state.json) — read when registering artifact
31
+ - [issue-gaps-analyze.md](~/.maestro/workflows/issue-gaps-analyze.md) — read when --gaps is triggered
32
+ </deferred_reading>
33
+
34
+ <context>
35
+ $ARGUMENTS -- phase number for milestone-scoped, topic text for adhoc/standalone mode, no args for milestone-wide.
36
+
37
+ **Flags:**
38
+ - `-y` / `--yes`: Auto mode — skip interactive scoping, use recommended defaults, auto-deepen
39
+ - `-c` / `--continue`: Resume from existing session (auto-detect session folder + discussion.md)
40
+ - `-q` / `--quick`: Quick mode — skip exploration + scoring, go straight to decision extraction (context.md only)
41
+ - `--gaps [ISS-ID]`: Issue root cause analysis mode. If ISS-ID provided, analyze single issue. If omitted, analyze all open/registered issues from issues.jsonl.
42
+
43
+ Scope routing, output directory format, artifact registration schema, and output artifact listing are defined in workflow analyze.md (Scope Routing and Output Structure sections).
44
+ </context>
45
+
46
+ <execution>
47
+ Follow '~/.maestro/workflows/analyze.md' completely.
48
+
49
+ ### --gaps Mode (Issue Root Cause Analysis)
50
+
51
+ When `--gaps` flag is present, follow `~/.maestro/workflows/issue-gaps-analyze.md` instead of the standard analyze pipeline:
52
+
53
+ ```
54
+ Phase 1: Load issues from .workflow/issues/issues.jsonl
55
+ - If ISS-ID provided: load single issue
56
+ - If no ISS-ID: filter issues where status = open | registered
57
+ - Validate: at least 1 issue loaded, else error E_NO_ISSUES
58
+
59
+ Phase 2: CLI exploration per issue
60
+ - For each issue: build exploration prompt from issue.title, description, context, related_files
61
+ - Run maestro delegate --role analyze --mode analysis with codebase context
62
+ - Gather affected files, call chains, root cause evidence
63
+
64
+ Phase 3: Root cause synthesis → write issue.analysis
65
+ - Parse CLI output into analysis record: { root_cause, affected_files, impact_scope, fix_direction, confidence, analyzed_at, tool, depth }
66
+ - Write analysis record to issue in issues.jsonl
67
+ - Append history entry: { action: "analyzed", at: <ISO>, by: "maestro-analyze --gaps" }
68
+
69
+ Phase 4: Output context.md for downstream plan --gaps
70
+ - Aggregate all analyzed issues into context.md with root causes and fix directions
71
+ - Register ANL artifact in state.json
72
+ ```
73
+
74
+ **Handoff:** context.md is consumed by maestro-plan (loads Locked/Free/Deferred decisions). In --gaps mode, context.md contains issue root causes for `plan --gaps` consumption.
75
+
76
+ **Next-step routing on completion:**
77
+
78
+ Phase/Milestone scope:
79
+ - Go recommendation, UI work needed → `/maestro-ui-design {phase}`
80
+ - Go recommendation, ready to plan → `/maestro-plan` or `/maestro-plan {phase}`
81
+ - No-Go recommendation → revisit requirements or `/maestro-brainstorm {topic}`
82
+
83
+ Adhoc/Standalone scope:
84
+ - Ready to plan → `/maestro-plan --dir {scratch_dir}`
85
+ - Need more exploration → `/maestro-analyze {topic} -c`
86
+
87
+ Gaps scope:
88
+ - Issues analyzed → `/maestro-plan --gaps` (plan fix tasks linked to issues)
89
+ - Need more context → `/maestro-analyze --gaps {ISS-ID}` (re-analyze specific issue)
90
+ </execution>
91
+
92
+ <error_codes>
93
+ | Code | Severity | Condition | Recovery |
94
+ |------|----------|-----------|----------|
95
+ | E001 | error | No args and no roadmap (cannot determine scope) | Prompt user for topic text or create roadmap first |
96
+ | W001 | warning | CLI exploration failed | Continue with available context, note limitation |
97
+ | W002 | warning | CLI analysis timeout | Retry with shorter prompt, or skip perspective |
98
+ | W003 | warning | Insufficient evidence for scoring dimensions | Note low-confidence dimensions, proceed with available evidence |
99
+ | W004 | warning | Max rounds reached (5) | Force synthesis, offer continuation option |
100
+ | E_NO_ISSUES | error | --gaps but no open/registered issues found | Suggest `/manage-issue-discover` or `/manage-issue create` |
101
+ | E_ISSUE_NOT_FOUND | error | --gaps with ISS-ID but issue not found | Suggest `/manage-issue list` to find valid IDs |
102
+ </error_codes>
103
+
104
+ <success_criteria>
105
+ Full mode:
106
+ - [ ] CLI exploration completed with code anchors and call chains
107
+ - [ ] discussion.md created with full timeline, TOC, Current Understanding
108
+ - [ ] analysis.md written with all 6 dimensions scored with evidence
109
+ - [ ] conclusions.json created with recommendations and decision trail
110
+ - [ ] Intent Coverage tracked and verified (no unresolved ❌ items)
111
+
112
+ Gaps mode:
113
+ - [ ] Issues loaded from issues.jsonl (all open/registered, or single ISS-ID)
114
+ - [ ] CLI exploration executed per issue with codebase context
115
+ - [ ] Analysis record attached to each issue in issues.jsonl
116
+ - [ ] context.md written with aggregated root causes for plan --gaps
117
+
118
+ Both modes (full + quick):
119
+ - [ ] context.md written with all decisions classified as Locked/Free/Deferred
120
+ - [ ] Gray areas identified through phase-specific analysis
121
+ - [ ] Decision Recording Protocol applied to all decisions
122
+ - [ ] Scope creep redirected to Deferred section
123
+ - [ ] Deferred items auto-created as issues (if any)
124
+ - [ ] Artifact registered in state.json with correct scope/milestone/phase
125
+ - [ ] Next step routed (ui-design/plan for Go, brainstorm for No-Go)
126
+ </success_criteria>
@@ -1,100 +1,100 @@
1
- ---
2
- name: maestro-brainstorm
3
- description: Unified brainstorming with dual-mode operation - auto pipeline and single role analysis
4
- argument-hint: "[topic|role-name] [--yes] [--count N] [--session ID] [--update] [--skip-questions] [--include-questions] [--style-skill PKG]"
5
- allowed-tools:
6
- - Read
7
- - Write
8
- - Bash
9
- - Glob
10
- - Grep
11
- - Agent
12
- - AskUserQuestion
13
- ---
14
- <purpose>
15
- Unified brainstorming combining interactive framework generation, multi-role parallel analysis, and cross-role synthesis. Two modes: Auto (full pipeline with guidance-specification → parallel role analysis → synthesis) and Single Role (individual role analysis for an existing session). Outputs structured artifacts in .brainstorming/ directory ready for downstream planning.
16
- </purpose>
17
-
18
- <required_reading>
19
- @~/.maestro/workflows/brainstorm.md
20
- </required_reading>
21
-
22
- <deferred_reading>
23
- - [scratch-index.json](~/.maestro/templates/scratch-index.json) — read when operating in scratch mode
24
- - [index.json](~/.maestro/templates/index.json) — read when operating in phase mode
25
- - [brainstorm-visualize.md](~/.maestro/workflows/brainstorm-visualize.md) — read when html-prototypes/ produced and user wants to browse them
26
- </deferred_reading>
27
-
28
- <context>
29
- $ARGUMENTS -- topic text for auto mode, or role name for single role mode.
30
-
31
- **Auto mode**: topic text (e.g., "Build real-time collaboration platform") triggers full pipeline.
32
- **Single role mode**: valid role name (e.g., "system-architect") runs one role analysis.
33
- **All output** goes to `.workflow/scratch/{YYYYMMDD}-brainstorm-{slug}/`.
34
- **Artifact registration**: On completion, registers artifact (type=brainstorm) in state.json.
35
- **Output boundary**: ALL file writes MUST target `{output_dir}/` or `.workflow/state.json` only. NEVER modify source code or files outside these paths.
36
-
37
- **Valid roles**: data-architect, product-manager, product-owner, scrum-master, subject-matter-expert, system-architect, test-strategist, ui-designer, ux-expert
38
-
39
- **Flags**:
40
- - `--yes` / `-y`: Auto mode, skip interactive questions, use defaults
41
- - `--count N`: Number of roles to select (default 3, max 9)
42
- - `--session ID`: Use existing session
43
- - `--update`: Update existing analysis (single role)
44
- - `--skip-questions`: Skip context gathering questions
45
- - `--include-questions`: Force context gathering even if analysis exists
46
- - `--style-skill PKG`: Style package for ui-designer role
47
- </context>
48
-
49
- <execution>
50
- Follow '~/.maestro/workflows/brainstorm.md' completely.
51
-
52
- **Next-step routing on completion:**
53
-
54
- Auto mode:
55
- - Project not initialized → Skill({ skill: "maestro-init" })
56
- - Project initialized, need spec package → Skill({ skill: "maestro-roadmap", args: "--mode full --from-brainstorm {session_id}" })
57
- - Project initialized, quick roadmap → Skill({ skill: "maestro-roadmap", args: "--from-brainstorm {session_id}" })
58
- - Need deeper analysis first → Skill({ skill: "maestro-analyze", args: "{topic}" })
59
- - `html-prototypes/` produced with 2+ files and user wants to browse → load `~/.maestro/workflows/brainstorm-visualize.md` and launch visualizer server (optional, user-triggered)
60
-
61
- Single role mode:
62
- - More roles needed → Skill({ skill: "maestro-brainstorm", args: "{next_role} --session {session_id}" })
63
- - All roles done, run synthesis → Skill({ skill: "maestro-brainstorm", args: "{topic} --session {session_id}" })
64
- </execution>
65
-
66
- <error_codes>
67
- | Code | Severity | Condition | Recovery |
68
- |------|----------|-----------|----------|
69
- | E001 | error | Topic or role argument required | Prompt user for topic text or role name |
70
- | E002 | error | No active session for single role mode | Guide user to run auto mode first |
71
- | E003 | error | Invalid role name | Show valid roles list |
72
- | W001 | warning | Fewer than 10 ideas in divergent phase | Proceed with available ideas |
73
- | W002 | warning | Project context (.workflow/) not found | Continue without project context |
74
- | W003 | warning | Role template not found | Use generic analysis structure |
75
- | W004 | warning | Validation score < 60 | Log warning, suggest manual review |
76
- | W005 | warning | External research agent failed | Continue without designResearchContext |
77
- </error_codes>
78
-
79
- <success_criteria>
80
- **Auto mode**:
81
- - [ ] guidance-specification.md with RFC 2119 keywords, terminology, non-goals, feature decomposition
82
- - [ ] design-research.md persisted when Step 1.7 external research ran (fail-soft: absence not a failure)
83
- - [ ] Spec Review Gate passed (Step 3.5) or `--yes` bypassed
84
- - [ ] Role analysis files for each selected NON-UI role in `.brainstorming/{role}/`
85
- - [ ] If `ui-designer` in selected_roles: `ui-designer/analysis.md` exists AND exactly one of `html-prototypes/` / `ascii-mockups/` / `api-sketches/` exists with `README.md` + ≥1 prototype file
86
- - [ ] ui-designer/analysis.md references each prototype via `@-notation`
87
- - [ ] HTML prototypes are self-contained (no external `<link>`/`<script src>` URLs — warn only)
88
- - [ ] Feature specs in `.brainstorming/feature-specs/` (or synthesis-specification.md)
89
- - [ ] UI-bearing feature specs reference the corresponding prototype in Section 3 (Interface Contract)
90
- - [ ] feature-index.json and synthesis-changelog.md
91
- - [ ] Final Output Gate passed (Step 5.5) or `--yes` bypassed
92
- - [ ] All user decisions captured with Decision Recording Protocol
93
- - [ ] Session metadata updated with completion status
94
-
95
- **Single role mode**:
96
- - [ ] analysis.md written to `{output_dir}/{role}/`
97
- - [ ] Feature-point organization used when feature list available
98
- - [ ] Framework reference included when guidance-specification.md exists
99
- - [ ] Session metadata updated
100
- </success_criteria>
1
+ ---
2
+ name: maestro-brainstorm
3
+ description: Brainstorm with auto pipeline or single-role analysis
4
+ argument-hint: "[topic|role-name] [--yes] [--count N] [--session ID] [--update] [--skip-questions] [--include-questions] [--style-skill PKG]"
5
+ allowed-tools:
6
+ - Read
7
+ - Write
8
+ - Bash
9
+ - Glob
10
+ - Grep
11
+ - Agent
12
+ - AskUserQuestion
13
+ ---
14
+ <purpose>
15
+ Unified brainstorming combining interactive framework generation, multi-role parallel analysis, and cross-role synthesis. Two modes: Auto (full pipeline with guidance-specification → parallel role analysis → synthesis) and Single Role (individual role analysis for an existing session). Outputs structured artifacts in .brainstorming/ directory ready for downstream planning.
16
+ </purpose>
17
+
18
+ <required_reading>
19
+ @~/.maestro/workflows/brainstorm.md
20
+ </required_reading>
21
+
22
+ <deferred_reading>
23
+ - [scratch-index.json](~/.maestro/templates/scratch-index.json) — read when operating in scratch mode
24
+ - [index.json](~/.maestro/templates/index.json) — read when operating in phase mode
25
+ - [brainstorm-visualize.md](~/.maestro/workflows/brainstorm-visualize.md) — read when html-prototypes/ produced and user wants to browse them
26
+ </deferred_reading>
27
+
28
+ <context>
29
+ $ARGUMENTS -- topic text for auto mode, or role name for single role mode.
30
+
31
+ **Auto mode**: topic text (e.g., "Build real-time collaboration platform") triggers full pipeline.
32
+ **Single role mode**: valid role name (e.g., "system-architect") runs one role analysis.
33
+ **All output** goes to `.workflow/scratch/{YYYYMMDD}-brainstorm-{slug}/`.
34
+ **Artifact registration**: On completion, registers artifact (type=brainstorm) in state.json.
35
+ **Output boundary**: ALL file writes MUST target `{output_dir}/` or `.workflow/state.json` only. NEVER modify source code or files outside these paths.
36
+
37
+ **Valid roles**: data-architect, product-manager, product-owner, scrum-master, subject-matter-expert, system-architect, test-strategist, ui-designer, ux-expert
38
+
39
+ **Flags**:
40
+ - `--yes` / `-y`: Auto mode, skip interactive questions, use defaults
41
+ - `--count N`: Number of roles to select (default 3, max 9)
42
+ - `--session ID`: Use existing session
43
+ - `--update`: Update existing analysis (single role)
44
+ - `--skip-questions`: Skip context gathering questions
45
+ - `--include-questions`: Force context gathering even if analysis exists
46
+ - `--style-skill PKG`: Style package for ui-designer role
47
+ </context>
48
+
49
+ <execution>
50
+ Follow '~/.maestro/workflows/brainstorm.md' completely.
51
+
52
+ **Next-step routing on completion:**
53
+
54
+ Auto mode:
55
+ - Project not initialized → Skill({ skill: "maestro-init" })
56
+ - Project initialized, need spec package → Skill({ skill: "maestro-roadmap", args: "--mode full --from-brainstorm {session_id}" })
57
+ - Project initialized, quick roadmap → Skill({ skill: "maestro-roadmap", args: "--from-brainstorm {session_id}" })
58
+ - Need deeper analysis first → Skill({ skill: "maestro-analyze", args: "{topic}" })
59
+ - `html-prototypes/` produced with 2+ files and user wants to browse → load `~/.maestro/workflows/brainstorm-visualize.md` and launch visualizer server (optional, user-triggered)
60
+
61
+ Single role mode:
62
+ - More roles needed → Skill({ skill: "maestro-brainstorm", args: "{next_role} --session {session_id}" })
63
+ - All roles done, run synthesis → Skill({ skill: "maestro-brainstorm", args: "{topic} --session {session_id}" })
64
+ </execution>
65
+
66
+ <error_codes>
67
+ | Code | Severity | Condition | Recovery |
68
+ |------|----------|-----------|----------|
69
+ | E001 | error | Topic or role argument required | Prompt user for topic text or role name |
70
+ | E002 | error | No active session for single role mode | Guide user to run auto mode first |
71
+ | E003 | error | Invalid role name | Show valid roles list |
72
+ | W001 | warning | Fewer than 10 ideas in divergent phase | Proceed with available ideas |
73
+ | W002 | warning | Project context (.workflow/) not found | Continue without project context |
74
+ | W003 | warning | Role template not found | Use generic analysis structure |
75
+ | W004 | warning | Validation score < 60 | Log warning, suggest manual review |
76
+ | W005 | warning | External research agent failed | Continue without designResearchContext |
77
+ </error_codes>
78
+
79
+ <success_criteria>
80
+ **Auto mode**:
81
+ - [ ] guidance-specification.md with RFC 2119 keywords, terminology, non-goals, feature decomposition
82
+ - [ ] design-research.md persisted when Step 1.7 external research ran (fail-soft: absence not a failure)
83
+ - [ ] Spec Review Gate passed (Step 3.5) or `--yes` bypassed
84
+ - [ ] Role analysis files for each selected NON-UI role in `.brainstorming/{role}/`
85
+ - [ ] If `ui-designer` in selected_roles: `ui-designer/analysis.md` exists AND exactly one of `html-prototypes/` / `ascii-mockups/` / `api-sketches/` exists with `README.md` + ≥1 prototype file
86
+ - [ ] ui-designer/analysis.md references each prototype via `@-notation`
87
+ - [ ] HTML prototypes are self-contained (no external `<link>`/`<script src>` URLs — warn only)
88
+ - [ ] Feature specs in `.brainstorming/feature-specs/` (or synthesis-specification.md)
89
+ - [ ] UI-bearing feature specs reference the corresponding prototype in Section 3 (Interface Contract)
90
+ - [ ] feature-index.json and synthesis-changelog.md
91
+ - [ ] Final Output Gate passed (Step 5.5) or `--yes` bypassed
92
+ - [ ] All user decisions captured with Decision Recording Protocol
93
+ - [ ] Session metadata updated with completion status
94
+
95
+ **Single role mode**:
96
+ - [ ] analysis.md written to `{output_dir}/{role}/`
97
+ - [ ] Feature-point organization used when feature list available
98
+ - [ ] Framework reference included when guidance-specification.md exists
99
+ - [ ] Session metadata updated
100
+ </success_criteria>