maestro-flow 0.3.28 → 0.3.30
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/commands/maestro-init.md +3 -3
- package/.claude/commands/maestro-plan.md +2 -2
- package/.claude/commands/maestro-ralph-execute.md +332 -0
- package/.claude/commands/maestro-ralph.md +526 -0
- package/.claude/commands/maestro.md +13 -11
- package/.claude/commands/quality-business-test.md +3 -3
- package/.claude/commands/quality-retrospective.md +2 -2
- package/.codex/skills/maestro/SKILL.md +4 -4
- package/.codex/skills/maestro-init/SKILL.md +9 -9
- package/.codex/skills/maestro-link-coordinate/SKILL.md +4 -4
- package/.codex/skills/maestro-milestone-complete/SKILL.md +3 -2
- package/.codex/skills/maestro-plan/SKILL.md +2 -2
- package/.codex/skills/maestro-ralph/SKILL.md +662 -0
- package/.codex/skills/maestro-ralph-execute/SKILL.md +193 -0
- package/.codex/skills/quality-business-test/SKILL.md +6 -6
- package/.codex/skills/quality-retrospective/SKILL.md +5 -5
- package/.codex/skills/quality-test/SKILL.md +2 -2
- package/package.json +1 -1
|
@@ -1,26 +1,26 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: maestro-init
|
|
3
3
|
description: Initialize project with auto state detection — creates .workflow/ directory, project.md, state.json, config.json, and specs/
|
|
4
|
-
argument-hint: "[
|
|
4
|
+
argument-hint: "[-y] [--from-brainstorm SESSION-ID]"
|
|
5
5
|
allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
|
|
6
6
|
---
|
|
7
7
|
|
|
8
8
|
<purpose>
|
|
9
9
|
Sequential project setup skill. Detects project state (empty/code/existing), gathers project information through deep questioning or document extraction, then creates the `.workflow/` directory structure. No parallel agents — single sequential flow.
|
|
10
10
|
|
|
11
|
-
When
|
|
11
|
+
When `-y`: After config questions, run research without further interaction. Expects idea document via @ reference.
|
|
12
12
|
</purpose>
|
|
13
13
|
|
|
14
14
|
<context>
|
|
15
15
|
|
|
16
16
|
```bash
|
|
17
17
|
$maestro-init ""
|
|
18
|
-
$maestro-init "
|
|
18
|
+
$maestro-init "-y"
|
|
19
19
|
$maestro-init "--from-brainstorm 20260318-brainstorm-auth"
|
|
20
20
|
```
|
|
21
21
|
|
|
22
22
|
**Flags**:
|
|
23
|
-
-
|
|
23
|
+
- `-y`: Skip interactive questioning; extract from provided document
|
|
24
24
|
- `--from-brainstorm SESSION-ID`: Import vision/goals/constraints from brainstorm guidance-specification.md
|
|
25
25
|
|
|
26
26
|
**Output**: `.workflow/` directory with project.md, state.json, config.json, specs/
|
|
@@ -29,7 +29,7 @@ $maestro-init "--from-brainstorm 20260318-brainstorm-auth"
|
|
|
29
29
|
|
|
30
30
|
<invariants>
|
|
31
31
|
1. **Never create roadmap** — init only creates .workflow/ structure; roadmap is a separate step
|
|
32
|
-
2. **Deep questioning over speed** — follow threads, ask clarifying questions (unless
|
|
32
|
+
2. **Deep questioning over speed** — follow threads, ask clarifying questions (unless -y)
|
|
33
33
|
3. **Detect, don't assume** — scan for existing files, package managers, frameworks before asking
|
|
34
34
|
4. **Templates are source of truth** — always read templates before writing files
|
|
35
35
|
5. **Idempotent check** — if .workflow/ exists, refuse to overwrite (E002)
|
|
@@ -40,7 +40,7 @@ $maestro-init "--from-brainstorm 20260318-brainstorm-auth"
|
|
|
40
40
|
### Step 1: Parse Arguments
|
|
41
41
|
|
|
42
42
|
Extract flags from arguments:
|
|
43
|
-
-
|
|
43
|
+
- `-y` flag presence
|
|
44
44
|
- `--from-brainstorm SESSION-ID` value
|
|
45
45
|
- Remaining text as project description
|
|
46
46
|
|
|
@@ -60,7 +60,7 @@ Classify as:
|
|
|
60
60
|
- Extract: vision, goals, constraints, terminology, tech decisions
|
|
61
61
|
- Skip interactive questioning
|
|
62
62
|
|
|
63
|
-
**If
|
|
63
|
+
**If `-y`**:
|
|
64
64
|
- Extract project info from provided document/@ reference
|
|
65
65
|
- Minimal interactive questions (confirm core value only)
|
|
66
66
|
|
|
@@ -94,7 +94,7 @@ Initialize from template with `current_milestone: null`, `status: "initialized"`
|
|
|
94
94
|
|
|
95
95
|
### Step 8: Write config.json
|
|
96
96
|
|
|
97
|
-
Configuration questions (or defaults for
|
|
97
|
+
Configuration questions (or defaults for -y): granularity (fine/medium/coarse), workflow agents (enable/disable), gate preferences. Write to `.workflow/config.json`.
|
|
98
98
|
|
|
99
99
|
### Step 9: Initialize specs/
|
|
100
100
|
|
|
@@ -110,7 +110,7 @@ Display created files and next steps: `$maestro-roadmap --mode full` (full spec)
|
|
|
110
110
|
|
|
111
111
|
| Code | Severity | Description | Recovery |
|
|
112
112
|
|------|----------|-------------|----------|
|
|
113
|
-
| E001 | error | No arguments when
|
|
113
|
+
| E001 | error | No arguments when -y requires document | Ask user for document reference |
|
|
114
114
|
| E002 | error | .workflow/ already exists | Show status, suggest manage-status |
|
|
115
115
|
| E003 | error | Brainstorm session not found | List available sessions |
|
|
116
116
|
| W001 | warning | Could not detect tech stack | Continue with manual input |
|
|
@@ -150,10 +150,10 @@ Set `state.status` to completed/failed based on `node.status`. Record final hist
|
|
|
150
150
|
|
|
151
151
|
| Skill | Flag |
|
|
152
152
|
|-------|------|
|
|
153
|
-
| `maestro-analyze`, `maestro-brainstorm`, `maestro-ui-design`, `maestro-roadmap` | `-y` |
|
|
154
|
-
| `maestro-plan` |
|
|
155
|
-
| `quality-test` |
|
|
156
|
-
| `quality-
|
|
153
|
+
| `maestro-init`, `maestro-analyze`, `maestro-brainstorm`, `maestro-ui-design`, `maestro-roadmap` | `-y` |
|
|
154
|
+
| `maestro-plan`, `maestro-execute`, `maestro-milestone-complete` | `-y` |
|
|
155
|
+
| `quality-business-test`, `quality-retrospective` | `-y` |
|
|
156
|
+
| `quality-test` | `-y --auto-fix` |
|
|
157
157
|
|
|
158
158
|
**buildSkillCall(node, ctx, autoMode)**: Substitute `{phase}`, `{description}`, `{issue_id}`, `{milestone_num}` from context into `node.args`. If autoMode, append auto flag from `node.auto_flag` or AUTO_FLAG_MAP. Return `$${node.cmd} ${resolvedArgs}`.
|
|
159
159
|
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: maestro-milestone-complete
|
|
3
3
|
description: Archive completed milestone scratch artifacts to milestones/ dir, move artifact entries to milestone_history, extract learnings, advance state.
|
|
4
|
-
argument-hint: "[milestone] [--force]"
|
|
4
|
+
argument-hint: "[milestone] [--force] [-y]"
|
|
5
5
|
allowed-tools: Read, Write, Edit, Bash, Glob, Grep
|
|
6
6
|
---
|
|
7
7
|
|
|
@@ -49,7 +49,8 @@ Read `.summaries/` and `reflection-log.md` from execute artifacts. Extract patte
|
|
|
49
49
|
2. **Convention drift**: Compare summaries against `coding-conventions.md` and `architecture-constraints.md` -- ask if conventions need updating
|
|
50
50
|
3. **Wiki island check**: Auto-trigger `wiki-connect --fix` to link new knowledge
|
|
51
51
|
|
|
52
|
-
If
|
|
52
|
+
If `-y`: auto-accept all promotions without asking.
|
|
53
|
+
If not `-y`: ask user for confirmation. If user confirms, append `<spec-entry>` to target category file preserving original date and source.
|
|
53
54
|
|
|
54
55
|
### Step 4: Archive Artifact Entries
|
|
55
56
|
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: maestro-plan
|
|
3
3
|
description: Exploration-driven planning via CSV wave pipeline. Wave 1 runs parallel codebase exploration agents, Wave 2 synthesizes explorations into plan.json + TASK-*.json. Replaces maestro-plan command.
|
|
4
|
-
argument-hint: "[-y|--yes] [-c|--concurrency N] [--continue] \"<phase> [--
|
|
4
|
+
argument-hint: "[-y|--yes] [-c|--concurrency N] [--continue] \"<phase> [--dir <path>] [--gaps] [--spec SPEC-xxx] [--collab]\""
|
|
5
5
|
allowed-tools: spawn_agents_on_csv, Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
|
|
6
6
|
---
|
|
7
7
|
|
|
@@ -51,7 +51,7 @@ Wave-based planning using `spawn_agents_on_csv`. Wave 1 explores codebase contex
|
|
|
51
51
|
<context>
|
|
52
52
|
```bash
|
|
53
53
|
$maestro-plan "3"
|
|
54
|
-
$maestro-plan -y "3
|
|
54
|
+
$maestro-plan -y "3"
|
|
55
55
|
$maestro-plan -c 4 "3 --spec SPEC-001"
|
|
56
56
|
$maestro-plan "3 --gaps"
|
|
57
57
|
$maestro-plan "3 --dir .workflow/scratch/quick-nav-fix"
|