maestro-flow 0.3.38 → 0.3.39

package/.claude/commands/maestro-quick.md

@@ -1,56 +1,56 @@
----
-name: maestro-quick
-description: Execute a quick task with workflow guarantees but skip optional agents
-argument-hint: "[description] [--full] [--discuss]"
-allowed-tools:
-  - Read
-  - Write
-  - Edit
-  - Bash
-  - Glob
-  - Grep
-  - Task
-  - AskUserQuestion
----
-<purpose>
-Execute small, ad-hoc tasks with workflow guarantees (atomic commits, state tracking) using a shortened pipeline. Invoked for tasks that are well-understood and do not require full phase-level planning. Produces scratch task directory with plan, execution results, and optional verification. Flags --discuss and --full enable additional pipeline stages.
-</purpose>
-
-<required_reading>
-@~/.maestro/workflows/quick.md
-</required_reading>
-
-<context>
-$ARGUMENTS
-
-Parse for:
-- `--full` flag -- Enables plan-checking (max 2 iterations) and post-execution verification
-- `--discuss` flag -- Decision extraction before planning (gray areas, Locked/Free/Deferred classification)
-- Remaining text as task description
-</context>
-
-<execution>
-Follow '~/.maestro/workflows/quick.md' completely.
-
-**Next-step routing on completion:**
-- Task done, --full verification passed → /manage-status
-- Task done, verification found gaps → /quality-debug {issue}
-- Task done, want to sync docs → /quality-sync
-- Need a full phase workflow instead → /maestro-plan {phase}
-</execution>
-
-<error_codes>
-| Code | Severity | Condition | Recovery |
-|------|----------|-----------|----------|
-| E001 | error | Task description required (no text provided) | Check arguments format, re-run with correct input |
-| E002 | error | Scratch directory creation failed | Check disk space and .workflow/ permissions |
-| W001 | warning | Verification found minor gaps | Review gaps and determine if they need fixing |
-</error_codes>
-
-<success_criteria>
-- [ ] Scratch task directory created under .workflow/scratch/
-- [ ] plan.json written with task definitions
-- [ ] All tasks executed with summaries written
-- [ ] state.json updated with scratch task entry
-- [ ] Commit created with task changes
-</success_criteria>
+---
+name: maestro-quick
+description: Quick task execution, skip optional agents
+argument-hint: "[description] [--full] [--discuss]"
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash
+  - Glob
+  - Grep
+  - Task
+  - AskUserQuestion
+---
+<purpose>
+Execute small, ad-hoc tasks with workflow guarantees (atomic commits, state tracking) using a shortened pipeline. Invoked for tasks that are well-understood and do not require full phase-level planning. Produces scratch task directory with plan, execution results, and optional verification. Flags --discuss and --full enable additional pipeline stages.
+</purpose>
+
+<required_reading>
+@~/.maestro/workflows/quick.md
+</required_reading>
+
+<context>
+$ARGUMENTS
+
+Parse for:
+- `--full` flag -- Enables plan-checking (max 2 iterations) and post-execution verification
+- `--discuss` flag -- Decision extraction before planning (gray areas, Locked/Free/Deferred classification)
+- Remaining text as task description
+</context>
+
+<execution>
+Follow '~/.maestro/workflows/quick.md' completely.
+
+**Next-step routing on completion:**
+- Task done, --full verification passed → /manage-status
+- Task done, verification found gaps → /quality-debug {issue}
+- Task done, want to sync docs → /quality-sync
+- Need a full phase workflow instead → /maestro-plan {phase}
+</execution>
+
+<error_codes>
+| Code | Severity | Condition | Recovery |
+|------|----------|-----------|----------|
+| E001 | error | Task description required (no text provided) | Check arguments format, re-run with correct input |
+| E002 | error | Scratch directory creation failed | Check disk space and .workflow/ permissions |
+| W001 | warning | Verification found minor gaps | Review gaps and determine if they need fixing |
+</error_codes>
+
+<success_criteria>
+- [ ] Scratch task directory created under .workflow/scratch/
+- [ ] plan.json written with task definitions
+- [ ] All tasks executed with summaries written
+- [ ] state.json updated with scratch task entry
+- [ ] Commit created with task changes
+</success_criteria>

package/.claude/commands/maestro-ralph-execute.md

@@ -1,6 +1,6 @@
 ---
 name: maestro-ralph-execute
-description: Single-step executor — find next pending step in session, execute by type (decision/internal/external), hand off to next iteration
+description: Execute next pending step in ralph session
 argument-hint: "[-y] [session-id]"
 allowed-tools:
   - Read
@@ -130,11 +130,6 @@ Display step banner:
 
 If decision node: also show `Retry: {retry_count}/{max_retries}` from parsed args.
 
-Context weight hint (non-auto only, after 4+ completed steps):
-```
-⚡ 已执行 {completed_count} 步，上下文较重。可 /maestro-ralph continue 在新上下文恢复。
-```
-
 ## Step 5: Execute by Type
 
 ### 5a. decision node (ralph-only)
@@ -189,13 +184,8 @@ HARD RULE: external nodes ALWAYS delegate to `claude` — only Claude Code can e
 
 ```
 Bash({
-  command: `maestro delegate "Execute: /${next.skill} ${next.args}
-
-You are a delegate session within a ralph/maestro pipeline.
-Your task: invoke the slash command /${next.skill} with args: ${next.args}
-Use Skill({ skill: \"${next.skill}\", args: \"${next.args}\" }) to execute it.
-Do NOT reimplement the skill logic manually — invoke the actual command.
-All artifact outputs follow the skill's own conventions." --to claude --mode write`,
+  command: `maestro delegate "Execute: Skill({ skill: \"${next.skill}\", args: \"${next.args}\" })
+Do NOT reimplement — invoke the skill command directly." --to claude --mode write`,
   run_in_background: true,
   timeout: 600000
 })
@@ -245,10 +235,10 @@ If not next.retried:
   next.retried = true, next.status = "pending", next.error = null
   Write status.json → Skill("maestro-ralph-execute")  // retry once
 Else:
-  next.status = "skipped"
+  status.status = "paused"
   Write status.json
-  Display: [{next.index}/{total}] ⏭ {next.skill} auto-skipped after retry
-  → Skill("maestro-ralph-execute")  // continue
+  Display: [{next.index}/{total}] ✗ {next.skill} 重试后仍失败，会话已暂停。请检查后 /maestro-ralph continue 恢复。
+  End.
 ```
 
 **Interactive mode (non-auto):**
@@ -302,7 +292,6 @@ Type badges: `◆` decision, `⚡` external, (none) internal.
 | E002 | error | Session status.json corrupt | Show path, suggest manual check |
 | E003 | error | CLI delegate failed + user abort | Mark paused, suggest resume |
 | W001 | warning | Step completed with warnings | Log and continue |
-| W002 | warning | Context heavy (step >= 4) | Hint: /maestro-ralph continue |
 </error_codes>
 
 <success_criteria>
@@ -316,7 +305,7 @@ Type badges: `◆` decision, `⚡` external, (none) internal.
 - [ ] external nodes use maestro delegate --to claude with run_in_background + STOP pattern
 - [ ] Context propagation: output signals update status.json.context
 - [ ] status.json updated after every status change (resume-safe)
-- [ ] Auto mode: retry once then skip; interactive: AskUserQuestion retry/skip/abort
+- [ ] Auto mode: retry once then pause; interactive: AskUserQuestion retry/skip/abort
 - [ ] Completion report shows all steps with status icons and type badges
 - [ ] Self-invocation chain continues until all steps complete or session paused
 </success_criteria>

package/.claude/commands/maestro-ralph.md

@@ -1,6 +1,6 @@
 ---
 name: maestro-ralph
-description: Closed-loop lifecycle decision engine — read project state, infer position, build adaptive command chain with decision/internal/external nodes
+description: Adaptive lifecycle engine — infer state, build command chain
 argument-hint: "[-y] \"intent\" | status | continue"
 allowed-tools:
   - Read
@@ -112,6 +112,12 @@ Also check: `.workflow/roadmap.md` existence, `.workflow/scratch/` for result fi
 
 ### 2.2: Infer lifecycle position
 
+**Phase 0 — Intent-based override:**
+
+If intent matches brainstorm pattern (contains "brainstorm", "头脑风暴", "探索", "ideate", or "设计思路"), position = `brainstorm` regardless of project state.
+
+Chain for existing project: `brainstorm → roadmap → analyze → ...` (skip init if `.workflow/state.json` exists).
+
 **Phase 1 — Bootstrap detection:**
 
 | Condition | Position | Chain starts at |
@@ -164,7 +170,7 @@ Generate steps from `lifecycle_position` to target (default: `milestone-complete
 
 | Stage | Skill command | Type | Decision after |
 |-------|--------------|------|----------------|
-| brainstorm | `maestro-brainstorm "{intent}"` | external | — (0→1 only) |
+| brainstorm | `maestro-brainstorm "{intent}"` | external | — |
 | init | `maestro-init` | internal | — |
 | roadmap | `maestro-roadmap "{intent}"` | internal | — |
 | analyze | `maestro-analyze {phase}` | external | — |
@@ -316,7 +322,7 @@ For quality-gate decisions (post-verify, post-business-test, post-review, post-t
 | Decision type | Files to include |
 |---------------|-----------------|
 | post-verify | `{artifact_dir}/verification.json` |
-| post-business-test | `{artifact_dir}/business-test-results.json` |
+| post-business-test | `{artifact_dir}/.tests/auto-test/report.json` |
 | post-review | `{artifact_dir}/review.json` |
 | post-test | `{artifact_dir}/uat.md`, `{artifact_dir}/.tests/test-results.json` |
 

package/.claude/commands/maestro-roadmap.md

@@ -1,6 +1,6 @@
 ---
 name: maestro-roadmap
-description: Roadmap generation with dual mode — light (requirement→roadmap) or full (requirement→spec package→roadmap)
+description: Generate roadmap from requirements (light or full mode)
 argument-hint: "<requirement> [--mode light|full] [-y] [-c] [-m progressive|direct|auto] [--from-brainstorm SESSION-ID] [--revise [instructions]] [--review]"
 allowed-tools:
   - Read

package/.claude/commands/maestro-ui-design.md

@@ -1,93 +1,93 @@
----
-name: maestro-ui-design
-description: Generate UI design prototypes with multiple styles via ui-ux-pro-max, user selects winner, solidify as code reference
-argument-hint: "<phase|topic> [--styles N] [--stack <stack>] [--targets <pages>] [--layouts N] [--refine] [--persist] [--full] [-y]"
-allowed-tools:
-  - Read
-  - Write
-  - Edit
-  - Bash
-  - Glob
-  - Grep
-  - Agent
-  - AskUserQuestion
----
-<purpose>
-Generate UI design prototypes for a phase or topic. Two workflow paths, auto-selected by skill availability:
-
-1. **Primary (ui-style.md):** Delegates design to ui-ux-pro-max skill. Generates multiple style variants via `--design-system`, user selects, solidifies as code reference. Lightweight and fast.
-2. **Fallback (ui-design.md):** Self-contained 4-layer pipeline (style → animation → layout → assembly) with 6D attribute space, OKLCH tokens, layout templates, and full prototype matrix. Used when ui-ux-pro-max is unavailable or `--full` is requested.
-
-Both paths produce the same output contract: MASTER.md + design-tokens.json + animation-tokens.json + selection.json for downstream plan/execute consumption.
-
-Position in pipeline: analyze -> **ui-design** -> plan -> execute -> verify
-</purpose>
-
-<deferred_reading>
-- [ui-style.md](~/.maestro/workflows/ui-style.md) — read when SKILL_PATH found (primary path)
-- [ui-design.md](~/.maestro/workflows/ui-design.md) — read when SKILL_PATH empty or --full (fallback path)
-- [index.json](~/.maestro/templates/index.json) — read when updating phase metadata
-- [scratch-index.json](~/.maestro/templates/scratch-index.json) — read when operating in scratch mode
-</deferred_reading>
-
-<context>
-$ARGUMENTS — phase number for phase mode, topic text for scratch mode, with optional flags.
-
-Flags, workflow routing, scope modes, and output artifacts defined in the routed workflow (ui-style.md or ui-design.md).
-
-**Phase mode** (number): resolves phase directory, reads context.md/brainstorm for requirements.
-**Scratch mode** (text): creates `.workflow/scratch/{YYYYMMDD}-ui-design-{slug}/` for standalone exploration.
-</context>
-
-<execution>
-## Workflow Routing
-
-Detect ui-ux-pro-max skill availability and route to the appropriate workflow:
-
-- **`--full` flag present** → Follow '~/.maestro/workflows/ui-design.md' completely (forced full pipeline)
-- **ui-ux-pro-max found** → Follow '~/.maestro/workflows/ui-style.md' completely (lightweight delegation)
-- **ui-ux-pro-max not found** → Follow '~/.maestro/workflows/ui-design.md' completely (self-contained fallback)
-
-Skill detection logic, report format, and complete pipeline steps defined in the routed workflow file.
-
-**Next-step routing on completion:**
-- Plan with design reference → /maestro-plan {phase}
-- Refine selected design → /maestro-ui-design {phase} --refine
-- Analyze before planning → /maestro-analyze {phase}
-</execution>
-
-<error_codes>
-| Code | Severity | Description | Stage |
-|------|----------|-------------|-------|
-| E001 | error | Phase or topic argument required | parse_input |
-| E002 | error | Phase directory not found | parse_input |
-| E003 | error | Python not available (both paths need Python for ui-ux-pro-max or agent fallback) | setup |
-| E004 | error | --refine requires existing design-ref/ | parse_input |
-| W001 | warning | Design system generation returned partial results | generate |
-| W002 | warning | Prototype rendering failed for one variant | render |
-| W003 | warning | No context.md found, using phase goal only | context |
-| W004 | warning | ui-ux-pro-max not found, falling back to full pipeline | routing |
-</error_codes>
-
-<success_criteria>
-**Both paths (common):**
-- [ ] Requirements extracted from phase context (context.md, brainstorm, spec, or user input)
-- [ ] N style variants generated with contrasting design directions
-- [ ] User selected preferred variant (or auto-selected in -y mode)
-- [ ] MASTER.md written with complete design system specification
-- [ ] design-tokens.json written with production-ready tokens (OKLCH colors, component_styles)
-- [ ] animation-tokens.json written (duration, easing, transitions, keyframes)
-- [ ] selection.json recorded with choice metadata
-- [ ] index.json updated with design_ref status
-
-**ui-style.md path (primary):**
-- [ ] ui-ux-pro-max --design-system called with product/industry/style keywords
-- [ ] Tokens extracted from ui-ux-pro-max output into structured JSON
-
-**ui-design.md path (--full or fallback):**
-- [ ] 6D attribute space used for maximum contrast between variants
-- [ ] Layout templates generated per target (dom_structure + css_layout_rules)
-- [ ] HTML prototypes assembled: styles x layouts x targets
-- [ ] compare.html generated as interactive matrix viewer
-</success_criteria>
-</output>
+---
+name: maestro-ui-design
+description: Generate UI design prototypes, select and solidify as code
+argument-hint: "<phase|topic> [--styles N] [--stack <stack>] [--targets <pages>] [--layouts N] [--refine] [--persist] [--full] [-y]"
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash
+  - Glob
+  - Grep
+  - Agent
+  - AskUserQuestion
+---
+<purpose>
+Generate UI design prototypes for a phase or topic. Two workflow paths, auto-selected by skill availability:
+
+1. **Primary (ui-style.md):** Delegates design to ui-ux-pro-max skill. Generates multiple style variants via `--design-system`, user selects, solidifies as code reference. Lightweight and fast.
+2. **Fallback (ui-design.md):** Self-contained 4-layer pipeline (style → animation → layout → assembly) with 6D attribute space, OKLCH tokens, layout templates, and full prototype matrix. Used when ui-ux-pro-max is unavailable or `--full` is requested.
+
+Both paths produce the same output contract: MASTER.md + design-tokens.json + animation-tokens.json + selection.json for downstream plan/execute consumption.
+
+Position in pipeline: analyze -> **ui-design** -> plan -> execute -> verify
+</purpose>
+
+<deferred_reading>
+- [ui-style.md](~/.maestro/workflows/ui-style.md) — read when SKILL_PATH found (primary path)
+- [ui-design.md](~/.maestro/workflows/ui-design.md) — read when SKILL_PATH empty or --full (fallback path)
+- [index.json](~/.maestro/templates/index.json) — read when updating phase metadata
+- [scratch-index.json](~/.maestro/templates/scratch-index.json) — read when operating in scratch mode
+</deferred_reading>
+
+<context>
+$ARGUMENTS — phase number for phase mode, topic text for scratch mode, with optional flags.
+
+Flags, workflow routing, scope modes, and output artifacts defined in the routed workflow (ui-style.md or ui-design.md).
+
+**Phase mode** (number): resolves phase directory, reads context.md/brainstorm for requirements.
+**Scratch mode** (text): creates `.workflow/scratch/{YYYYMMDD}-ui-design-{slug}/` for standalone exploration.
+</context>
+
+<execution>
+## Workflow Routing
+
+Detect ui-ux-pro-max skill availability and route to the appropriate workflow:
+
+- **`--full` flag present** → Follow '~/.maestro/workflows/ui-design.md' completely (forced full pipeline)
+- **ui-ux-pro-max found** → Follow '~/.maestro/workflows/ui-style.md' completely (lightweight delegation)
+- **ui-ux-pro-max not found** → Follow '~/.maestro/workflows/ui-design.md' completely (self-contained fallback)
+
+Skill detection logic, report format, and complete pipeline steps defined in the routed workflow file.
+
+**Next-step routing on completion:**
+- Plan with design reference → /maestro-plan {phase}
+- Refine selected design → /maestro-ui-design {phase} --refine
+- Analyze before planning → /maestro-analyze {phase}
+</execution>
+
+<error_codes>
+| Code | Severity | Description | Stage |
+|------|----------|-------------|-------|
+| E001 | error | Phase or topic argument required | parse_input |
+| E002 | error | Phase directory not found | parse_input |
+| E003 | error | Python not available (both paths need Python for ui-ux-pro-max or agent fallback) | setup |
+| E004 | error | --refine requires existing design-ref/ | parse_input |
+| W001 | warning | Design system generation returned partial results | generate |
+| W002 | warning | Prototype rendering failed for one variant | render |
+| W003 | warning | No context.md found, using phase goal only | context |
+| W004 | warning | ui-ux-pro-max not found, falling back to full pipeline | routing |
+</error_codes>
+
+<success_criteria>
+**Both paths (common):**
+- [ ] Requirements extracted from phase context (context.md, brainstorm, spec, or user input)
+- [ ] N style variants generated with contrasting design directions
+- [ ] User selected preferred variant (or auto-selected in -y mode)
+- [ ] MASTER.md written with complete design system specification
+- [ ] design-tokens.json written with production-ready tokens (OKLCH colors, component_styles)
+- [ ] animation-tokens.json written (duration, easing, transitions, keyframes)
+- [ ] selection.json recorded with choice metadata
+- [ ] index.json updated with design_ref status
+
+**ui-style.md path (primary):**
+- [ ] ui-ux-pro-max --design-system called with product/industry/style keywords
+- [ ] Tokens extracted from ui-ux-pro-max output into structured JSON
+
+**ui-design.md path (--full or fallback):**
+- [ ] 6D attribute space used for maximum contrast between variants
+- [ ] Layout templates generated per target (dom_structure + css_layout_rules)
+- [ ] HTML prototypes assembled: styles x layouts x targets
+- [ ] compare.html generated as interactive matrix viewer
+</success_criteria>
+</output>