maestro-flow 0.3.38 → 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.
- package/.claude/agents/workflow-analyzer.md +2 -0
- package/.claude/agents/workflow-debugger.md +2 -0
- package/.claude/agents/workflow-executor.md +2 -0
- package/.claude/agents/workflow-integration-checker.md +1 -0
- package/.claude/agents/workflow-nyquist-auditor.md +1 -0
- package/.claude/agents/workflow-planner.md +2 -0
- package/.claude/agents/workflow-reviewer.md +2 -0
- package/.claude/agents/workflow-verifier.md +2 -0
- package/.claude/commands/learn-decompose.md +176 -176
- package/.claude/commands/learn-follow.md +167 -167
- package/.claude/commands/learn-investigate.md +221 -221
- package/.claude/commands/learn-retro.md +303 -303
- package/.claude/commands/learn-second-opinion.md +167 -167
- package/.claude/commands/maestro-amend.md +300 -300
- package/.claude/commands/maestro-analyze.md +126 -126
- package/.claude/commands/maestro-brainstorm.md +100 -100
- package/.claude/commands/maestro-composer.md +354 -354
- package/.claude/commands/maestro-execute.md +120 -114
- package/.claude/commands/maestro-fork.md +86 -86
- package/.claude/commands/maestro-init.md +78 -78
- package/.claude/commands/maestro-learn.md +140 -140
- package/.claude/commands/maestro-link-coordinate.md +1 -1
- package/.claude/commands/maestro-merge.md +61 -61
- package/.claude/commands/maestro-milestone-release.md +96 -96
- package/.claude/commands/maestro-overlay.md +178 -178
- package/.claude/commands/maestro-plan.md +150 -138
- package/.claude/commands/maestro-player.md +404 -404
- package/.claude/commands/maestro-quick.md +56 -56
- package/.claude/commands/maestro-ralph-execute.md +7 -18
- package/.claude/commands/maestro-ralph.md +9 -3
- package/.claude/commands/maestro-roadmap.md +1 -1
- package/.claude/commands/maestro-ui-design.md +93 -93
- package/.claude/commands/maestro-update.md +176 -176
- package/.claude/commands/maestro-verify.md +96 -90
- package/.claude/commands/maestro.md +121 -121
- package/.claude/commands/manage-codebase-rebuild.md +75 -75
- package/.claude/commands/manage-codebase-refresh.md +57 -57
- package/.claude/commands/manage-harvest.md +94 -94
- package/.claude/commands/manage-issue-discover.md +77 -77
- package/.claude/commands/manage-issue.md +73 -73
- package/.claude/commands/manage-knowhow-capture.md +193 -193
- package/.claude/commands/manage-knowhow.md +77 -77
- package/.claude/commands/manage-learn.md +67 -67
- package/.claude/commands/manage-status.md +51 -51
- package/.claude/commands/manage-wiki.md +62 -62
- package/.claude/commands/quality-auto-test.md +1 -1
- package/.claude/commands/quality-debug.md +121 -115
- package/.claude/commands/quality-refactor.md +55 -55
- package/.claude/commands/quality-retrospective.md +78 -78
- package/.claude/commands/quality-review.md +114 -108
- package/.claude/commands/quality-sync.md +51 -51
- package/.claude/commands/quality-test.md +103 -103
- package/.claude/commands/spec-add.md +49 -49
- package/.claude/commands/spec-load.md +51 -51
- package/.claude/commands/spec-remove.md +51 -51
- package/.claude/commands/spec-setup.md +51 -51
- package/.claude/commands/wiki-connect.md +62 -62
- package/.claude/commands/wiki-digest.md +69 -69
- package/.codex/skills/learn-decompose/SKILL.md +113 -113
- package/.codex/skills/learn-follow/SKILL.md +1 -1
- package/.codex/skills/learn-investigate/SKILL.md +83 -83
- package/.codex/skills/learn-retro/SKILL.md +83 -83
- package/.codex/skills/learn-second-opinion/SKILL.md +86 -86
- package/.codex/skills/maestro/SKILL.md +304 -304
- package/.codex/skills/maestro-analyze/SKILL.md +4 -3
- package/.codex/skills/maestro-brainstorm/SKILL.md +442 -397
- package/.codex/skills/maestro-composer/SKILL.md +213 -213
- package/.codex/skills/maestro-execute/SKILL.md +346 -318
- package/.codex/skills/maestro-fork/SKILL.md +56 -2
- package/.codex/skills/maestro-init/SKILL.md +40 -16
- package/.codex/skills/maestro-learn/SKILL.md +80 -80
- package/.codex/skills/maestro-link-coordinate/SKILL.md +257 -257
- package/.codex/skills/maestro-merge/SKILL.md +1 -1
- package/.codex/skills/maestro-milestone-audit/SKILL.md +1 -1
- package/.codex/skills/maestro-milestone-complete/SKILL.md +40 -9
- package/.codex/skills/maestro-milestone-release/SKILL.md +70 -70
- package/.codex/skills/maestro-overlay/SKILL.md +1 -1
- package/.codex/skills/maestro-plan/SKILL.md +19 -4
- package/.codex/skills/maestro-player/SKILL.md +323 -323
- package/.codex/skills/maestro-quick/SKILL.md +1 -1
- package/.codex/skills/maestro-ralph/SKILL.md +681 -578
- package/.codex/skills/maestro-roadmap/SKILL.md +518 -468
- package/.codex/skills/maestro-ui-design/SKILL.md +109 -12
- package/.codex/skills/maestro-verify/SKILL.md +27 -9
- package/.codex/skills/manage-codebase-rebuild/SKILL.md +3 -2
- package/.codex/skills/manage-codebase-refresh/SKILL.md +1 -1
- package/.codex/skills/manage-harvest/SKILL.md +91 -91
- package/.codex/skills/manage-issue/SKILL.md +19 -6
- package/.codex/skills/manage-issue-discover/SKILL.md +1 -1
- package/.codex/skills/manage-knowhow/SKILL.md +95 -95
- package/.codex/skills/manage-knowhow-capture/SKILL.md +110 -110
- package/.codex/skills/manage-learn/SKILL.md +1 -1
- package/.codex/skills/manage-status/SKILL.md +1 -1
- package/.codex/skills/manage-wiki/SKILL.md +55 -55
- package/.codex/skills/quality-auto-test/SKILL.md +547 -547
- package/.codex/skills/quality-debug/SKILL.md +339 -334
- package/.codex/skills/quality-refactor/SKILL.md +1 -1
- package/.codex/skills/quality-retrospective/SKILL.md +292 -292
- package/.codex/skills/quality-review/SKILL.md +365 -364
- package/.codex/skills/quality-sync/SKILL.md +1 -1
- package/.codex/skills/quality-test/SKILL.md +498 -498
- package/.codex/skills/spec-add/SKILL.md +101 -101
- package/.codex/skills/spec-load/SKILL.md +77 -77
- package/.codex/skills/spec-map/SKILL.md +1 -1
- package/.codex/skills/spec-remove/SKILL.md +69 -69
- package/.codex/skills/spec-setup/SKILL.md +1 -1
- package/.codex/skills/team-coordinate/SKILL.md +2 -1
- package/.codex/skills/team-executor/SKILL.md +116 -115
- package/.codex/skills/team-lifecycle-v4/SKILL.md +2 -1
- package/.codex/skills/team-lifecycle-v4/instructions/agent-instruction.md +14 -6
- package/.codex/skills/team-lifecycle-v4/roles/analyst/role.md +16 -4
- package/.codex/skills/team-lifecycle-v4/roles/executor/commands/implement.md +7 -1
- package/.codex/skills/team-lifecycle-v4/roles/planner/role.md +16 -4
- package/.codex/skills/team-lifecycle-v4/roles/writer/role.md +8 -2
- package/.codex/skills/team-quality-assurance/SKILL.md +2 -1
- package/.codex/skills/team-quality-assurance/roles/scout/role.md +9 -2
- package/.codex/skills/team-review/SKILL.md +2 -1
- package/.codex/skills/team-review/roles/reviewer/role.md +10 -1
- package/.codex/skills/team-review/roles/scanner/role.md +10 -1
- package/.codex/skills/team-tech-debt/SKILL.md +144 -143
- package/.codex/skills/team-tech-debt/roles/executor/role.md +9 -5
- package/.codex/skills/team-tech-debt/roles/scanner/role.md +10 -0
- package/.codex/skills/team-tech-debt/roles/validator/role.md +8 -2
- package/.codex/skills/team-testing/SKILL.md +2 -1
- package/.codex/skills/team-testing/roles/executor/role.md +8 -2
- package/.codex/skills/team-testing/roles/generator/role.md +8 -2
- package/.codex/skills/wiki-connect/SKILL.md +73 -73
- package/.codex/skills/wiki-digest/SKILL.md +87 -87
- package/dashboard/dist-server/dashboard/src/server/agents/claude-code-adapter.js +4 -0
- package/dashboard/dist-server/dashboard/src/server/agents/claude-code-adapter.js.map +1 -1
- package/dashboard/dist-server/dashboard/src/server/agents/codex-cli-adapter.js +6 -0
- package/dashboard/dist-server/dashboard/src/server/agents/codex-cli-adapter.js.map +1 -1
- package/dashboard/dist-server/shared/agent-types.d.ts +2 -0
- package/dashboard/dist-server/src/agents/cli-agent-runner.d.ts +2 -0
- package/dashboard/dist-server/src/agents/cli-agent-runner.js +4 -0
- package/dashboard/dist-server/src/agents/cli-agent-runner.js.map +1 -1
- package/dashboard/dist-server/src/commands/delegate.d.ts +2 -0
- package/dashboard/dist-server/src/commands/delegate.js +18 -0
- package/dashboard/dist-server/src/commands/delegate.js.map +1 -1
- package/dashboard/dist-server/src/config/cli-tools-config.d.ts +6 -0
- package/dashboard/dist-server/src/config/cli-tools-config.js +2 -0
- package/dashboard/dist-server/src/config/cli-tools-config.js.map +1 -1
- package/dist/shared/agent-types.d.ts +2 -0
- package/dist/shared/agent-types.d.ts.map +1 -1
- package/dist/src/agents/cli-agent-runner.d.ts +2 -0
- package/dist/src/agents/cli-agent-runner.d.ts.map +1 -1
- package/dist/src/agents/cli-agent-runner.js +4 -0
- package/dist/src/agents/cli-agent-runner.js.map +1 -1
- package/dist/src/commands/config.d.ts.map +1 -1
- package/dist/src/commands/config.js +29 -1
- package/dist/src/commands/config.js.map +1 -1
- package/dist/src/commands/delegate.d.ts +2 -0
- package/dist/src/commands/delegate.d.ts.map +1 -1
- package/dist/src/commands/delegate.js +18 -0
- package/dist/src/commands/delegate.js.map +1 -1
- package/dist/src/commands/launcher.d.ts.map +1 -1
- package/dist/src/commands/launcher.js +27 -4
- package/dist/src/commands/launcher.js.map +1 -1
- package/dist/src/config/cli-tools-config.d.ts +6 -0
- package/dist/src/config/cli-tools-config.d.ts.map +1 -1
- package/dist/src/config/cli-tools-config.js +2 -0
- package/dist/src/config/cli-tools-config.js.map +1 -1
- package/dist/src/core/overlay/applier.d.ts.map +1 -1
- package/dist/src/core/overlay/applier.js +65 -5
- package/dist/src/core/overlay/applier.js.map +1 -1
- package/dist/src/core/overlay/loader.d.ts.map +1 -1
- package/dist/src/core/overlay/loader.js +9 -4
- package/dist/src/core/overlay/loader.js.map +1 -1
- package/dist/src/core/overlay/types.d.ts +2 -0
- package/dist/src/core/overlay/types.d.ts.map +1 -1
- package/dist/src/core/overlay/types.js +2 -0
- package/dist/src/core/overlay/types.js.map +1 -1
- package/dist/src/tui/tools-ui/ToolsDashboard.d.ts.map +1 -1
- package/dist/src/tui/tools-ui/ToolsDashboard.js +1 -1
- package/dist/src/tui/tools-ui/ToolsDashboard.js.map +1 -1
- package/dist/src/tui/tools-ui/ToolsOverview.d.ts.map +1 -1
- package/dist/src/tui/tools-ui/ToolsOverview.js +51 -4
- package/dist/src/tui/tools-ui/ToolsOverview.js.map +1 -1
- package/package.json +1 -1
- package/shared/agent-types.ts +2 -0
- package/workflows/delegate-protocol.codex.md +65 -0
|
@@ -1,126 +1,126 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: maestro-analyze
|
|
3
|
-
description: Multi-
|
|
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:
|
|
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>
|