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.
@@ -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: "[--auto] [--from-brainstorm SESSION-ID]"
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 `--auto`: After config questions, run research without further interaction. Expects idea document via @ reference.
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 "--auto"
18
+ $maestro-init "-y"
19
19
  $maestro-init "--from-brainstorm 20260318-brainstorm-auth"
20
20
  ```
21
21
 
22
22
  **Flags**:
23
- - `--auto`: Skip interactive questioning; extract from provided document
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 --auto)
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
- - `--auto` flag presence
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 `--auto`**:
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 --auto): granularity (fine/medium/coarse), workflow agents (enable/disable), gate preferences. Write to `.workflow/config.json`.
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 --auto requires document | Ask user for document reference |
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` | `--auto` |
155
- | `quality-test` | `--auto-fix` |
156
- | `quality-retrospective` | `--auto-yes` |
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 user confirms promotion, append `<spec-entry>` to target category file preserving original date and source.
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> [--auto] [--dir <path>] [--gaps] [--spec SPEC-xxx] [--collab]\""
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 --auto"
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"