maestro-flow 0.3.47 → 0.3.49

package/workflows/brainstorm.md

@@ -287,6 +287,32 @@ Seven sub-phases producing guidance-specification.md:
 
 **Output**: `{output_dir}/guidance-specification.md`, session metadata (workflow-session.json)
 
+### Step 3.5: Visual Style Foundation (Auto Mode, conditional)
+
+When `ui-designer` is among the selected roles, establish the project's visual direction before role analysis begins. This ensures all downstream UX analysis works within a confirmed design system.
+
+**Condition**: Skip if `.workflow/impeccable/DESIGN.md` already exists (visual direction already locked).
+
+**Execution** (sequential):
+
+1. **Product context** — if `.workflow/impeccable/PRODUCT.md` missing:
+   ```
+   Skill({ skill: "maestro-impeccable", args: "teach" })
+   ```
+   This runs the teach interview to establish brand, users, personality, anti-references.
+
+2. **Visual exploration** — multi-style comparison and selection:
+   ```
+   Skill({ skill: "maestro-impeccable", args: "explore" })
+   ```
+   This generates multiple design system variants as HTML prototypes, launches visual comparison, and lets the user select/mix. Produces DESIGN.md on completion.
+
+3. Record in session metadata: `design_system_established: true`, `design_md_path: ".workflow/impeccable/DESIGN.md"`
+
+**`--yes` mode**: `explore` auto-selects variant 1 without visual comparison. `teach` still requires minimal input if PRODUCT.md is missing.
+
+**Skip mode**: If user explicitly passes `--skip-design` to brainstorm, skip this step entirely. ui-designer role will generate its own independent theme in Phase 2.
+
 ### Step 4: Parallel Role Analysis (Auto Mode)
 
 For EACH selected role, spawn a conceptual-planning-agent in parallel:

package/workflows/cli-tools-usage.md

@@ -186,35 +186,31 @@ CONSTRAINTS: Focus on authentication | Ignore test files
 
 ### Calling Convention
 
-> **CRITICAL BEHAVIOR RULE**: After issuing a `maestro delegate` call with `run_in_background: true`, you MUST end your response immediately. Do not output any text, status message, or additional tool calls after the Bash tool call. Your entire message ends at the tool call.
+`maestro delegate` runs synchronously. Status summary and output are **auto-appended** on completion — no manual `output` or `status` commands needed.
 
-**Why**: `maestro delegate` blocks until completion. Background execution + immediate stop ensures the conversation remains responsive.
-
-**Correct** — response contains ONLY the Bash tool call, nothing after it:
+**Always** use `run_in_background: true` and **end your response immediately**:
 
 ```
 Bash({ command: "maestro delegate \"...\" --to gemini --mode analysis", run_in_background: true })
 ```
 
-**Wrong** — any text or tool call after the Bash call is a violation:
-
+When the background callback arrives, the result is already included:
 ```
-Bash({ command: "maestro delegate \"...\" --to gemini --mode analysis", run_in_background: true })
-"I've started the analysis..."  ← VIOLATION: response must end above
+[MAESTRO_EXEC_ID=gem-143022-a7f2]        , at start
+[DELEGATE COMPLETED] gem-143022-a7f2 gemini/analysis   ← status, on completion
+--- Output ---
+<actual output content>                   ← output, on completion
 ```
 
 **Rules:**
 - NEVER use foreground Bash for delegate calls
-- NEVER output text, status updates, or additional tool calls after the `run_in_background` Bash call
-- NEVER poll with `delegate status` — wait for the background completion callback
-- When the callback arrives, retrieve output with `maestro delegate output <id>`
+- NEVER output text or tool calls after the `run_in_background` Bash call
+- When the callback arrives, output is already included — directly use it
 
 ### Execution ID
 
 ID prefix: gemini→`gem`, qwen→`qwn`, codex→`cdx`, claude→`cld`, opencode→`opc`
 
-Output to stderr: `[MAESTRO_EXEC_ID=<id>]`
-
 ```bash
 maestro delegate "<PROMPT>" --to gemini --mode analysis    # auto-ID: gem-143022-a7f2
 maestro delegate "<PROMPT>" --to gemini --mode write --id my-task-1  # custom ID
@@ -229,19 +225,6 @@ maestro delegate "<PROMPT>" --to gemini --resume <id1>,<id2>     # merge multipl
 ```
 
 Resume auto-assembles previous conversation context. Warning emitted when context exceeds 32KB.
-
-### Subcommands
-
-```bash
-maestro delegate show                     # recent 20 executions
-maestro delegate show --all               # up to 100
-maestro delegate output <id>              # last reply only (after last tool call)
-maestro delegate output <id> --full       # full output (all turns)
-maestro delegate output <id> --verbose    # include start/end timestamps
-maestro delegate status <id>              # broker + history + snapshot preview
-maestro delegate tail <id>                # recent events + history
-maestro delegate cancel <id>              # request cancellation
-```
 </execution>
 
 ---