maestro-flow 0.3.10 → 0.3.12

package/.codex/skills/maestro-ui-design/SKILL.md

@@ -5,13 +5,18 @@ argument-hint: "[topic] [-y] [--style-skill PKG]"
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep, Agent, AskUserQuestion
 ---
 
-## Auto Mode
+<purpose>
+Two workflow paths, auto-selected by skill availability:
+1. **Primary (ui-ux-pro-max)**: Lightweight -- delegates design generation, owns selection and solidification
+2. **Fallback (self-contained)**: Full 4-layer pipeline (style -> animation -> layout -> assembly)
 
-When `--yes` or `-y`: Skip interactive selection, auto-pick top-scored variant, skip brief review.
+Both produce the same output contract for downstream plan/execute consumption.
+</purpose>
 
-# UI Design
+<context>
+$ARGUMENTS -- phase number or topic text, plus optional flags.
 
-## Usage
+**Usage**:
 
 ```bash
 $maestro-ui-design "3"                          # phase mode
@@ -30,26 +35,26 @@ $maestro-ui-design "3 --style-skill PKG --stack react"
 - `--persist`: Save design system with hierarchical page overrides
 - `--full`: Force full 4-layer self-contained pipeline
 
-**Output**: `{phase_dir}/design-ref/` with MASTER.md, design-tokens.json, animation-tokens.json, selection.json, prototypes/
-
----
-
-## Overview
-
-Two workflow paths, auto-selected by skill availability:
-1. **Primary (ui-ux-pro-max)**: Lightweight -- delegates design generation, owns selection and solidification
-2. **Fallback (self-contained)**: Full 4-layer pipeline (style -> animation -> layout -> assembly)
+When `--yes` or `-y`: Skip interactive selection, auto-pick top-scored variant, skip brief review.
 
-Both produce the same output contract for downstream plan/execute consumption.
+**Output**: `{phase_dir}/design-ref/` with MASTER.md, design-tokens.json, animation-tokens.json, selection.json, prototypes/
+</context>
 
----
+<invariants>
+1. **Output contract is fixed** -- both paths produce MASTER.md + design-tokens.json + animation-tokens.json + selection.json
+2. **Colors in OKLCH** format in design-tokens.json
+3. **WCAG AA** contrast: 4.5:1 text, 3:1 UI elements
+4. **No lorem ipsum** -- use contextual placeholder content
+5. **Agent calls use `run_in_background: false`** for synchronous execution
+6. **Variant contrast** -- each variant must represent a distinctly different design direction
+</invariants>
 
-## Implementation
+<execution>
 
 ### Step 1: Parse Input and Resolve Target
 
 1. Parse flags from `$ARGUMENTS`: `--styles N`, `--stack`, `--targets`, `--persist`, `--full`, `-y`
-2. **Phase mode** (number): resolve `.workflow/phases/{NN}-*/` directory
+2. **Phase mode** (number): resolve via state.json artifact registry to `.workflow/scratch/{type}-{slug}-{date}/`; legacy fallback to `.workflow/phases/{NN}-*/`
 3. **Scratch mode** (text): create `.workflow/scratch/ui-design-{slug}-{date}/` with minimal index.json
 4. Create output directories:
    ```bash
@@ -152,11 +157,9 @@ Agent({
      Skill({ skill: "maestro-plan", args: "{phase}" })
      Skill({ skill: "maestro-ui-design", args: "{phase} --refine" })
    ```
+</execution>
 
----
-
-## Error Handling
-
+<error_codes>
 | Code | Severity | Condition | Recovery |
 |------|----------|-----------|----------|
 | E001 | error | Phase or topic argument required | Prompt user |
@@ -166,14 +169,14 @@ Agent({
 | W001 | warning | Design system returned partial results | Retry with broader keywords |
 | W002 | warning | Prototype rendering failed for one variant | Continue with remaining |
 | W004 | warning | ui-ux-pro-max not found, using fallback | Proceed with self-contained pipeline |
-
----
-
-## Core Rules
-
-- **Output contract is fixed** -- both paths produce MASTER.md + design-tokens.json + animation-tokens.json + selection.json
-- **Colors in OKLCH** format in design-tokens.json
-- **WCAG AA** contrast: 4.5:1 text, 3:1 UI elements
-- **No lorem ipsum** -- use contextual placeholder content
-- **Agent calls use `run_in_background: false`** for synchronous execution
-- **Variant contrast** -- each variant must represent a distinctly different design direction
+</error_codes>
+
+<success_criteria>
+- [ ] Target resolved (phase or scratch directory)
+- [ ] Style variants generated with intentional contrast
+- [ ] User selected variant (or auto-picked in `-y` mode)
+- [ ] MASTER.md + design-tokens.json + animation-tokens.json + selection.json written
+- [ ] Colors in OKLCH format, WCAG AA contrast met
+- [ ] Prototypes generated for all targets (if applicable)
+- [ ] index.json updated with design_ref status
+</success_criteria>