maestro-flow 0.3.49 → 0.4.2
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/agents/impeccable-agent.md +2 -2
- package/.claude/commands/maestro-analyze.md +2 -2
- package/.claude/commands/maestro-brainstorm.md +1 -1
- package/.claude/commands/maestro-impeccable.md +234 -111
- package/.claude/commands/maestro-roadmap.md +1 -1
- package/.claude/commands/maestro.md +3 -3
- package/.claude/skills/maestro-help/index/catalog.json +1 -1
- package/.claude/skills/maestro-help/phases/01-parse-intent.md +1 -1
- package/.codex/skills/maestro/SKILL.md +70 -28
- package/.codex/skills/maestro-brainstorm/SKILL.md +1 -1
- package/.codex/skills/maestro-help/catalog.json +1 -1
- package/.codex/skills/maestro-impeccable/SKILL.md +234 -117
- package/.codex/skills/maestro-roadmap/SKILL.md +1 -1
- package/chains/singles/ui-design.json +3 -3
- package/chains/ui-craft-build.json +2 -2
- package/dashboard/dist-server/dashboard/src/server/coordinator/chain-map.js +3 -3
- package/dashboard/dist-server/dashboard/src/server/coordinator/chain-map.js.map +1 -1
- package/dist/src/commands/hooks.d.ts +49 -0
- package/dist/src/commands/hooks.d.ts.map +1 -1
- package/dist/src/commands/hooks.js +197 -30
- package/dist/src/commands/hooks.js.map +1 -1
- package/dist/src/commands/install-backend.d.ts +2 -0
- package/dist/src/commands/install-backend.d.ts.map +1 -1
- package/dist/src/commands/install-backend.js +72 -0
- package/dist/src/commands/install-backend.js.map +1 -1
- package/dist/src/commands/install.d.ts.map +1 -1
- package/dist/src/commands/install.js +15 -2
- package/dist/src/commands/install.js.map +1 -1
- package/dist/src/i18n/locales/en.d.ts.map +1 -1
- package/dist/src/i18n/locales/en.js +13 -0
- package/dist/src/i18n/locales/en.js.map +1 -1
- package/dist/src/i18n/locales/zh.d.ts.map +1 -1
- package/dist/src/i18n/locales/zh.js +13 -0
- package/dist/src/i18n/locales/zh.js.map +1 -1
- package/dist/src/i18n/types.d.ts +7 -0
- package/dist/src/i18n/types.d.ts.map +1 -1
- package/dist/src/tui/install-ui/InstallConfirm.d.ts +5 -0
- package/dist/src/tui/install-ui/InstallConfirm.d.ts.map +1 -1
- package/dist/src/tui/install-ui/InstallConfirm.js +1 -1
- package/dist/src/tui/install-ui/InstallConfirm.js.map +1 -1
- package/dist/src/tui/install-ui/InstallExecution.d.ts +2 -0
- package/dist/src/tui/install-ui/InstallExecution.d.ts.map +1 -1
- package/dist/src/tui/install-ui/InstallExecution.js +22 -3
- package/dist/src/tui/install-ui/InstallExecution.js.map +1 -1
- package/dist/src/tui/install-ui/InstallFlow.d.ts +1 -1
- package/dist/src/tui/install-ui/InstallFlow.d.ts.map +1 -1
- package/dist/src/tui/install-ui/InstallFlow.js +25 -4
- package/dist/src/tui/install-ui/InstallFlow.js.map +1 -1
- package/dist/src/tui/install-ui/InstallHub.d.ts +5 -0
- package/dist/src/tui/install-ui/InstallHub.d.ts.map +1 -1
- package/dist/src/tui/install-ui/InstallHub.js +16 -0
- package/dist/src/tui/install-ui/InstallHub.js.map +1 -1
- package/dist/src/tui/install-ui/InstallResult.d.ts.map +1 -1
- package/dist/src/tui/install-ui/InstallResult.js +1 -1
- package/dist/src/tui/install-ui/InstallResult.js.map +1 -1
- package/package.json +1 -1
- package/templates/workflows/specs/node-catalog.md +1 -1
- package/workflows/impeccable/design.md +12 -12
- package/workflows/impeccable/explore.md +5 -5
- package/workflows/maestro-chain-execute.md +2 -2
- package/workflows/maestro.codex.md +3 -3
- package/workflows/maestro.md +107 -117
- package/workflows/plan.md +1 -1
- package/workflows/ui-design.md +1 -1
- package/workflows/ui-style.md +1 -1
- package/.claude/commands/maestro-ui-craft.md +0 -416
- package/.claude/skills/maestro-impeccable/SKILL.md +0 -171
- package/.codex/skills/maestro-ui-craft/SKILL.md +0 -386
|
@@ -1,131 +1,248 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: maestro-impeccable
|
|
3
|
-
description: Production-grade UI design
|
|
4
|
-
argument-hint: "
|
|
3
|
+
description: Production-grade UI design — 24 commands + chain orchestration with quality gates + design search
|
|
4
|
+
argument-hint: "<command|chain|intent> [target] [flags]"
|
|
5
5
|
allowed-tools: Read, Write, Edit, Bash, Glob, Grep, request_user_input
|
|
6
6
|
---
|
|
7
|
+
|
|
7
8
|
<purpose>
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
Includes integrated `search` subcommand for querying UI/UX design knowledge base (BM25 + CSV):
|
|
14
|
-
```bash
|
|
15
|
-
maestro impeccable search "<query>" -d <domain> # domain search
|
|
16
|
-
maestro impeccable search "<query>" --design-system # generate design system
|
|
17
|
-
maestro impeccable search "<query>" --design-system --persist -p "Project" # save MASTER.md
|
|
18
|
-
```
|
|
19
|
-
Domains: style, color, chart, landing, product, ux, typography, icons, react, web, google-fonts.
|
|
20
|
-
Stacks: react, nextjs, vue, svelte, astro, swiftui, react-native, flutter, html-tailwind, shadcn.
|
|
9
|
+
Sequential UI design skill. Parse input → prerequisites → read workflow file → execute → track via status.json.
|
|
10
|
+
|
|
11
|
+
- **Direct**: single command via workflow file
|
|
12
|
+
- **Chain**: orchestrate command sequence with quality gates
|
|
13
|
+
- **Search**: query design knowledge base via CLI
|
|
21
14
|
</purpose>
|
|
22
15
|
|
|
23
16
|
<context>
|
|
24
|
-
$ARGUMENTS
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
|
29
|
-
|
|
30
|
-
|
|
|
31
|
-
|
|
|
32
|
-
|
|
|
33
|
-
|
|
|
34
|
-
|
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
**
|
|
38
|
-
- `--skip-harvest` -- Execute command without knowhow capture
|
|
39
|
-
- `-y` -- Auto-confirm where the skill allows
|
|
40
|
-
|
|
17
|
+
$ARGUMENTS first word determines mode:
|
|
18
|
+
|
|
19
|
+
| First Word | Mode |
|
|
20
|
+
|------------|------|
|
|
21
|
+
| Known command (see routing table) | Direct |
|
|
22
|
+
| Chain name: build, redesign, improve, enhance, launch, harden, foundation, live | Chain |
|
|
23
|
+
| continue / next / -c | Resume |
|
|
24
|
+
| search | Search: `maestro impeccable search "$REST"` |
|
|
25
|
+
| Free text (concrete task) | Direct craft — has specific target + specs/reference |
|
|
26
|
+
| Free text (project intent) | Intent → classify → chain |
|
|
27
|
+
| (empty) | Menu: show commands by category |
|
|
28
|
+
|
|
29
|
+
**Common flags**: `-y` (auto-confirm), `--skip-harvest`, `--skip-design`, `--styles <N>`
|
|
30
|
+
**Chain flags**: `--threshold <N>` (default 26/40), `--max-loops <N>` (default 3)
|
|
41
31
|
</context>
|
|
42
32
|
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
33
|
+
## Command Routing
|
|
34
|
+
|
|
35
|
+
All workflows at `~/.maestro/workflows/impeccable/{command}.md`:
|
|
36
|
+
|
|
37
|
+
| Command | Category | Description |
|
|
38
|
+
|---------|----------|-------------|
|
|
39
|
+
| craft | Build | Shape then build end-to-end — full page/component implementation |
|
|
40
|
+
| shape | Build | Plan UX/UI before code — information architecture, wireframe, visual direction |
|
|
41
|
+
| teach | Build | Set up PRODUCT.md — users, brand, tone, anti-references, principles |
|
|
42
|
+
| document | Build | Generate DESIGN.md from existing code — extract tokens, typography, colors |
|
|
43
|
+
| extract | Build | Pull tokens/components into reusable design system |
|
|
44
|
+
| explore | Build | Multi-style comparison — generate variants, render prototypes, visual compare, select/mix |
|
|
45
|
+
| critique | Evaluate | UX heuristic review with Nielsen scoring (/40) + P0/P1 findings |
|
|
46
|
+
| audit | Evaluate | Technical quality checks — a11y, performance, responsive, code quality (/20) |
|
|
47
|
+
| polish | Refine | Final quality pass — micro-adjustments, pixel perfection |
|
|
48
|
+
| bolder | Refine | Amplify bland/safe designs — stronger personality, more contrast |
|
|
49
|
+
| quieter | Refine | Tone down aggressive/overwhelming designs — reduce visual noise |
|
|
50
|
+
| distill | Refine | Strip to essence — remove clutter, reduce cognitive load |
|
|
51
|
+
| harden | Refine | Production-ready — error states, i18n, edge cases, overflow, empty states |
|
|
52
|
+
| onboard | Refine | First-run flows, empty states, activation paths, progressive disclosure |
|
|
53
|
+
| animate | Enhance | Add purposeful motion — transitions, micro-interactions, scroll effects |
|
|
54
|
+
| colorize | Enhance | Add strategic color — OKLCH palette, contrast, color strategy |
|
|
55
|
+
| typeset | Enhance | Improve typography — scale, hierarchy, font pairing, line length |
|
|
56
|
+
| layout | Enhance | Fix spacing, rhythm, visual hierarchy, alignment, grid |
|
|
57
|
+
| delight | Enhance | Add personality — memorable details, joy, surprise moments |
|
|
58
|
+
| overdrive | Enhance | Push past conventional limits — ambitious visual effects |
|
|
59
|
+
| clarify | Fix | Improve UX copy — labels, error messages, microcopy, CTAs |
|
|
60
|
+
| adapt | Fix | Adapt for devices/screens — responsive, touch targets, breakpoints |
|
|
61
|
+
| optimize | Fix | Fix UI performance — loading, rendering, bundle, paint/layout jank |
|
|
62
|
+
| live | Iterate | Browser-based variant iteration — real-time design in DevTools |
|
|
63
|
+
|
|
64
|
+
Reference files (loaded by workflow as needed, not standalone commands):
|
|
65
|
+
brand.md, product.md, design.md, codex.md, heuristics-scoring.md, cognitive-load.md,
|
|
66
|
+
color-and-contrast.md, interaction-design.md, motion-design.md, personas.md,
|
|
67
|
+
responsive-design.md, spatial-design.md, typography.md, ux-writing.md
|
|
68
|
+
|
|
69
|
+
## Chains
|
|
70
|
+
|
|
71
|
+
| Chain | Steps | Scenario |
|
|
72
|
+
|-------|-------|----------|
|
|
73
|
+
| build | teach? → explore? → shape → craft → critique → [refine] → audit → polish | New from scratch |
|
|
74
|
+
| redesign | document → explore → shape → craft → critique → [refine] → audit → polish | Redesign existing code |
|
|
75
|
+
| improve | critique → [refine] → polish → audit | Iterative improvement |
|
|
76
|
+
| enhance | {cmd...} → critique → [refine] → polish | Targeted enhancement (multi-command) |
|
|
77
|
+
| launch | harden → adapt → optimize → audit → polish | Full production readiness |
|
|
78
|
+
| harden | harden → audit → polish | Edge case hardening |
|
|
79
|
+
| foundation | teach? → explore → document → extract | Design system setup |
|
|
80
|
+
| live | live | Real-time iteration |
|
|
81
|
+
|
|
82
|
+
- `?` = conditional: teach if PRODUCT.md missing; explore if DESIGN.md missing and --skip-design not set
|
|
83
|
+
- `[refine]` = quality gate loop: gate fails → auto-select fix commands from findings → re-gate
|
|
84
|
+
- `{cmd...}` = enhance supports multiple commands, comma-separated: `enhance colorize,typeset target`
|
|
85
|
+
|
|
86
|
+
## Free Text Routing
|
|
87
|
+
|
|
88
|
+
Three-layer priority matching. Stop on first match — do not continue to lower layers.
|
|
89
|
+
|
|
90
|
+
### Layer 1: Single command intent → Direct
|
|
91
|
+
|
|
92
|
+
Semantically match user description against the Command Routing table's Description column. Match the closest **single** command.
|
|
93
|
+
|
|
94
|
+
**Skip condition**: If the prompt also contains a Layer 2 chain keyword AND does not focus on a single design dimension, skip this layer.
|
|
95
|
+
Example: `enhance colors and typography` — "enhance" is a chain keyword + multiple design dimensions → skip to Layer 2.
|
|
96
|
+
|
|
97
|
+
| Intent signal | Command |
|
|
98
|
+
|---------------|---------|
|
|
99
|
+
| review, check UX, score, heuristic, evaluate usability | critique |
|
|
100
|
+
| audit, a11y, accessibility, technical check, performance audit, code quality | audit |
|
|
101
|
+
| add animation, motion, transitions, micro-interactions | animate |
|
|
102
|
+
| color, palette, OKLCH, contrast, color scheme | colorize |
|
|
103
|
+
| font, typography, type scale, line height, font pairing | typeset |
|
|
104
|
+
| layout, spacing, grid, alignment, visual hierarchy | layout |
|
|
105
|
+
| too loud, tone down, visual noise, make it simpler, too busy | quieter |
|
|
106
|
+
| too bland, bolder, more personality, stronger, more contrast | bolder |
|
|
107
|
+
| too complex, simplify, strip, remove clutter, cognitive load | distill |
|
|
108
|
+
| polish, fine-tune, pixel perfect, final pass, refine details | polish |
|
|
109
|
+
| copy, labels, error messages, UX writing, microcopy, CTAs | clarify |
|
|
110
|
+
| responsive, mobile, adapt, breakpoints, touch targets | adapt |
|
|
111
|
+
| performance, loading, bundle, jank, speed, rendering | optimize |
|
|
112
|
+
| edge cases, error states, i18n, overflow, empty state hardening | harden |
|
|
113
|
+
| onboarding, first-run, empty state, activation, progressive disclosure | onboard |
|
|
114
|
+
| fun, surprise, personality, memorable, joy, delight | delight |
|
|
115
|
+
| extraordinary, push limits, ambitious effects, cutting-edge | overdrive |
|
|
116
|
+
| plan UX, wireframe, information architecture, visual direction | shape |
|
|
117
|
+
| multi-style, variants, compare styles, style comparison | explore |
|
|
118
|
+
| brand definition, PRODUCT.md, product context | teach |
|
|
119
|
+
| extract design, DESIGN.md, document design system | document |
|
|
120
|
+
| pull tokens, extract components, design system extraction | extract |
|
|
121
|
+
| real-time, browser iteration, live editing | live |
|
|
122
|
+
|
|
123
|
+
### Layer 2: Project intent → Chain
|
|
124
|
+
|
|
125
|
+
Layer 1 did not match. Check for chain-level keywords — even if the prompt also contains a specific target/path, chain matching takes priority.
|
|
126
|
+
|
|
127
|
+
| Pattern | Chain |
|
|
128
|
+
|---------|-------|
|
|
129
|
+
| new, create, build, from scratch, start fresh | build |
|
|
130
|
+
| redo, redesign, rethink, restyle, overhaul, revamp | redesign |
|
|
131
|
+
| improve, iterate, better, refine overall | improve |
|
|
132
|
+
| enhance, visual upgrade, level up | enhance |
|
|
133
|
+
| launch, deploy, ship, production-ready, go live | launch |
|
|
134
|
+
| harden, production-harden, edge cases | harden |
|
|
135
|
+
| design system, tokens, design foundation, design infrastructure | foundation |
|
|
136
|
+
| real-time, live, browser | live |
|
|
137
|
+
|
|
138
|
+
Ambiguous + no `-y` → `request_user_input`.
|
|
139
|
+
|
|
140
|
+
### Layer 3: Concrete build task → Direct craft
|
|
141
|
+
|
|
142
|
+
Layer 1+2 both did not match, but intent is to build/create a specific thing:
|
|
143
|
+
- Contains a specific file path or target (`d:\path`, `src/pages/`, `index.html`)
|
|
144
|
+
- Contains detailed visual specs (layout, style, color scheme)
|
|
145
|
+
- Contains reference material (`based on...`, `like...`, `similar to...`)
|
|
146
|
+
|
|
147
|
+
→ Route to **craft** (Direct)
|
|
148
|
+
|
|
149
|
+
<invariants>
|
|
150
|
+
1. Prerequisites before any design work — never skip context loading or register detection
|
|
151
|
+
2. Read workflow file before execution — never execute a command without loading its .md
|
|
152
|
+
3. Interactive gates respected — teach, shape, craft retain user confirmation gates
|
|
153
|
+
4. status.json before chain steps — session created before any chain step runs
|
|
154
|
+
</invariants>
|
|
155
|
+
|
|
156
|
+
## Prerequisites
|
|
157
|
+
|
|
158
|
+
Before reading any command workflow:
|
|
159
|
+
|
|
160
|
+
1. **Context**: `maestro spec load --category ui` → if empty → `maestro impeccable load-context`
|
|
161
|
+
2. **PRODUCT.md**: missing/placeholder (<200 chars / `[TODO]`) → execute teach first, then resume original task
|
|
162
|
+
3. **Register**: identify brand/product → Read `~/.maestro/workflows/impeccable/{brand|product}.md`
|
|
163
|
+
|
|
164
|
+
## Direct Execution
|
|
165
|
+
|
|
166
|
+
1. Prerequisites ✓
|
|
167
|
+
2. **Display execution info**:
|
|
52
168
|
```
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
```bash
|
|
57
|
-
maestro impeccable load-context
|
|
169
|
+
── Command: {command} ────────────────────
|
|
170
|
+
Category: {category} | Target: {target}
|
|
171
|
+
─────────────────────────────────────────
|
|
58
172
|
```
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
If PRODUCT.md missing → run `teach` first, then resume original task.
|
|
66
|
-
|
|
67
|
-
## Command Execution
|
|
68
|
-
|
|
69
|
-
Route by first argument:
|
|
70
|
-
1. **Matches command** → load `~/.maestro/workflows/impeccable/{command}.md`, follow instructions
|
|
71
|
-
2. **No argument** → show command menu grouped by category
|
|
72
|
-
3. **No match** → general design invocation with full argument as context
|
|
73
|
-
|
|
74
|
-
## Harvest (Post-Execution)
|
|
173
|
+
3. Read `~/.maestro/workflows/impeccable/{command}.md`
|
|
174
|
+
4. **Progress tracking**: create todo items for each major phase in the workflow file
|
|
175
|
+
- Format: `[{command}] {phase description}`
|
|
176
|
+
- Mark each phase completed immediately upon finishing
|
|
177
|
+
5. Follow workflow file instructions
|
|
178
|
+
6. Post: suggest logical next command (teach→shape, shape→craft, craft→critique, etc.)
|
|
75
179
|
|
|
76
|
-
|
|
180
|
+
## Chain Execution
|
|
77
181
|
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
-
|
|
106
|
-
|
|
107
|
-
-
|
|
108
|
-
- **
|
|
109
|
-
- **
|
|
110
|
-
- **
|
|
111
|
-
|
|
112
|
-
- **
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
182
|
+
1. Prerequisites ✓
|
|
183
|
+
2. **Display chain preview**: parse chain definition, output full step preview:
|
|
184
|
+
```
|
|
185
|
+
── Chain: build ──────────────────────────
|
|
186
|
+
1. teach (conditional: PRODUCT.md missing)
|
|
187
|
+
2. explore (conditional: DESIGN.md missing)
|
|
188
|
+
3. shape
|
|
189
|
+
4. craft
|
|
190
|
+
5. critique ◆ quality gate (threshold: 26/40)
|
|
191
|
+
6. [refine] ↺ auto-fix loop (max: 3)
|
|
192
|
+
7. audit ◆ quality gate (threshold: 14/20)
|
|
193
|
+
8. polish
|
|
194
|
+
─────────────────────────────────────────
|
|
195
|
+
Target: {target}
|
|
196
|
+
```
|
|
197
|
+
- `◆` marks quality gate steps with threshold
|
|
198
|
+
- `↺` marks refine loop with max iteration count
|
|
199
|
+
- Conditional steps show trigger condition
|
|
200
|
+
- Skipped conditional steps marked `(skipped)`
|
|
201
|
+
3. Create session: `.workflow/.maestro/ui-craft-{YYYYMMDD-HHmmss}/status.json`
|
|
202
|
+
```json
|
|
203
|
+
{ "chain_type": "...", "target": "...", "steps": [...], "current_step": 0,
|
|
204
|
+
"gate_history": [], "loop_count": 0, "status": "running" }
|
|
205
|
+
```
|
|
206
|
+
4. **Init tracking**: create todo items for all chain steps
|
|
207
|
+
- One item per step, format: `[chain] step N: {command} — {description}`
|
|
208
|
+
- If conditional step is skipped, immediately mark completed
|
|
209
|
+
- Quality gate steps include threshold: `[chain] step 5: critique ◆ gate ≥26/40`
|
|
210
|
+
5. For each step:
|
|
211
|
+
- Read `~/.maestro/workflows/impeccable/{command}.md` → execute
|
|
212
|
+
- **Step start**: mark current step in_progress
|
|
213
|
+
- **Step done**: mark completed + update status.json (`current_step`, step `status`)
|
|
214
|
+
- **Step failed**: mark completed (with note) + record reason
|
|
215
|
+
6. **Quality gate** (critique/audit steps):
|
|
216
|
+
- Parse score: critique `**Total** | | **N/40**`, audit `**Total** | | **N/20**`
|
|
217
|
+
- Count `[P0]` / `[P1]` tags
|
|
218
|
+
- Pass: score ≥ threshold AND P0 == 0 → advance
|
|
219
|
+
- Fail: collect suggested commands from findings → execute → re-gate
|
|
220
|
+
- Max loops exceeded → force advance with warning
|
|
221
|
+
- Record gate result in current step notes (score, P0/P1 count, pass/fail)
|
|
222
|
+
7. Final report: scores + trend + commands executed
|
|
223
|
+
|
|
224
|
+
## Resume
|
|
225
|
+
|
|
226
|
+
Scan `.workflow/.maestro/ui-craft-*/status.json` for `status == "running"` → most recent → resume from `current_step`.
|
|
227
|
+
|
|
228
|
+
## Quality Gate — Finding → Command Fallback
|
|
229
|
+
|
|
230
|
+
When findings lack explicit suggested command:
|
|
231
|
+
|
|
232
|
+
| Finding Category | Command |
|
|
233
|
+
|-----------------|---------|
|
|
234
|
+
| Layout, spacing, hierarchy, alignment | layout |
|
|
235
|
+
| Color, contrast, palette | colorize |
|
|
236
|
+
| Typography, font, readability | typeset |
|
|
237
|
+
| Animation, motion, transitions | animate |
|
|
238
|
+
| Copy, labels, UX writing | clarify |
|
|
239
|
+
| Responsive, mobile, breakpoints | adapt |
|
|
240
|
+
| Performance, loading, speed | optimize |
|
|
241
|
+
| Complexity, overload, clutter | distill |
|
|
242
|
+
| Bland, safe, generic | bolder |
|
|
243
|
+
| Aggressive, overwhelming | quieter |
|
|
244
|
+
| Onboarding, empty state | onboard |
|
|
245
|
+
| Edge cases, i18n, error handling | harden |
|
|
246
|
+
| Personality, memorability | delight |
|
|
247
|
+
|
|
248
|
+
Never auto-select: teach, shape, craft, live, document, extract, overdrive, critique, audit.
|
|
@@ -158,7 +158,7 @@ Build prev_context from wave 1. Inject strategy + --phases constraint (light mod
|
|
|
158
158
|
+-- readiness-report.md
|
|
159
159
|
```
|
|
160
160
|
7. Update state.json milestones + current_milestone
|
|
161
|
-
8. Next-step routing: need analysis -> maestro-analyze; ready to plan -> maestro-plan; UI first -> maestro-
|
|
161
|
+
8. Next-step routing: need analysis -> maestro-analyze; ready to plan -> maestro-plan; UI first -> maestro-impeccable build; full mode setup -> maestro-init
|
|
162
162
|
|
|
163
163
|
</actions>
|
|
164
164
|
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
"$schema": "../chain-graph.schema.json",
|
|
3
3
|
"id": "singles/ui-design",
|
|
4
4
|
"name": "UI Design",
|
|
5
|
-
"description": "UI design-driven production via maestro-
|
|
5
|
+
"description": "UI design-driven production via maestro-impeccable build chain",
|
|
6
6
|
"version": "1.0.0",
|
|
7
7
|
"tags": [
|
|
8
8
|
"maestro",
|
|
@@ -18,11 +18,11 @@
|
|
|
18
18
|
"nodes": {
|
|
19
19
|
"ui_design": {
|
|
20
20
|
"type": "command",
|
|
21
|
-
"cmd": "maestro-
|
|
21
|
+
"cmd": "maestro-impeccable",
|
|
22
22
|
"next": "done",
|
|
23
23
|
"analyze": false,
|
|
24
24
|
"args": "\"{phase}\" --chain build",
|
|
25
|
-
"description": "UI design-driven production via maestro-
|
|
25
|
+
"description": "UI design-driven production via maestro-impeccable build chain"
|
|
26
26
|
},
|
|
27
27
|
"done": {
|
|
28
28
|
"type": "terminal",
|
|
@@ -13,8 +13,8 @@
|
|
|
13
13
|
"nodes": {
|
|
14
14
|
"ui_design": {
|
|
15
15
|
"type": "command",
|
|
16
|
-
"cmd": "maestro-
|
|
17
|
-
"description": "UI design-driven production via maestro-
|
|
16
|
+
"cmd": "maestro-impeccable",
|
|
17
|
+
"description": "UI design-driven production via maestro-impeccable build chain",
|
|
18
18
|
"args": "\"{phase}\" --chain build",
|
|
19
19
|
"auto_flag": "-y",
|
|
20
20
|
"next": "plan"
|
|
@@ -56,7 +56,7 @@ export const CHAIN_MAP = {
|
|
|
56
56
|
'status': [{ cmd: 'manage-status' }],
|
|
57
57
|
'init': [{ cmd: 'maestro-init' }],
|
|
58
58
|
'analyze': [{ cmd: 'maestro-analyze', args: '{phase}' }],
|
|
59
|
-
'ui_design': [{ cmd: 'maestro-
|
|
59
|
+
'ui_design': [{ cmd: 'maestro-impeccable', args: '"{phase}" --chain build' }],
|
|
60
60
|
'plan': [{ cmd: 'maestro-plan', args: '{phase}' }],
|
|
61
61
|
'execute': [{ cmd: 'maestro-execute', args: '{phase}' }],
|
|
62
62
|
'verify': [{ cmd: 'maestro-verify', args: '{phase}' }],
|
|
@@ -93,7 +93,7 @@ export const CHAIN_MAP = {
|
|
|
93
93
|
// Multi-step chains
|
|
94
94
|
'spec-driven': [{ cmd: 'maestro-init' }, { cmd: 'maestro-roadmap', args: '--mode full "{description}"' }, { cmd: 'maestro-plan', args: '{phase}' }, { cmd: 'maestro-execute', args: '{phase}' }, { cmd: 'maestro-verify', args: '{phase}' }],
|
|
95
95
|
'brainstorm-driven': [{ cmd: 'maestro-brainstorm', args: '"{description}"' }, { cmd: 'maestro-plan', args: '{phase}' }, { cmd: 'maestro-execute', args: '{phase}' }, { cmd: 'maestro-verify', args: '{phase}' }],
|
|
96
|
-
'ui-craft-build': [{ cmd: 'maestro-
|
|
96
|
+
'ui-craft-build': [{ cmd: 'maestro-impeccable', args: '"{phase}" --chain build' }, { cmd: 'maestro-plan', args: '{phase}' }, { cmd: 'maestro-execute', args: '{phase}' }, { cmd: 'maestro-verify', args: '{phase}' }],
|
|
97
97
|
'full-lifecycle': [{ cmd: 'maestro-plan', args: '{phase}' }, { cmd: 'maestro-execute', args: '{phase}' }, { cmd: 'maestro-verify', args: '{phase}' }, { cmd: 'quality-review', args: '{phase}' }, { cmd: 'quality-test', args: '{phase}' }, { cmd: 'maestro-milestone-audit' }, { cmd: 'maestro-milestone-complete' }],
|
|
98
98
|
'execute-verify': [{ cmd: 'maestro-execute', args: '{phase}' }, { cmd: 'maestro-verify', args: '{phase}' }],
|
|
99
99
|
'quality-loop': [{ cmd: 'maestro-verify', args: '{phase}' }, { cmd: 'quality-review', args: '{phase}' }, { cmd: 'quality-test', args: '{phase}' }, { cmd: 'quality-debug', args: '--from-uat {phase}' }, { cmd: 'maestro-plan', args: '{phase} --gaps' }, { cmd: 'maestro-execute', args: '{phase}' }],
|
|
@@ -115,7 +115,7 @@ export const TASK_TO_CHAIN = {
|
|
|
115
115
|
export const AUTO_FLAG_MAP = {
|
|
116
116
|
'maestro-analyze': '-y',
|
|
117
117
|
'maestro-brainstorm': '-y',
|
|
118
|
-
'maestro-
|
|
118
|
+
'maestro-impeccable': '-y',
|
|
119
119
|
'maestro-plan': '--auto',
|
|
120
120
|
'maestro-roadmap': '-y',
|
|
121
121
|
'quality-test': '--auto-fix',
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"chain-map.js","sourceRoot":"","sources":["../../../../../src/server/coordinator/chain-map.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,6EAA6E;AAC7E,iEAAiE;AACjE,8EAA8E;AAa9E,8EAA8E;AAC9E,sEAAsE;AACtE,kCAAkC;AAClC,8EAA8E;AAE9E,MAAM,CAAC,MAAM,eAAe,GAA4B;IACtD,CAAC,gBAAgB,EAAK,8BAA8B,CAAC;IACrD,CAAC,QAAQ,EAAa,0BAA0B,CAAC;IACjD,CAAC,eAAe,EAAM,yCAAyC,CAAC;IAChE,CAAC,YAAY,EAAS,4BAA4B,CAAC;IACnD,CAAC,SAAS,EAAY,oDAAoD,CAAC;IAC3E,CAAC,WAAW,EAAU,gDAAgD,CAAC;IACvE,CAAC,MAAM,EAAe,8BAA8B,CAAC;IACrD,CAAC,MAAM,EAAe,kCAAkC,CAAC;IACzD,CAAC,SAAS,EAAY,6CAA6C,CAAC;IACpE,CAAC,QAAQ,EAAa,mCAAmC,CAAC;IAC1D,CAAC,QAAQ,EAAa,qCAAqC,CAAC;IAC5D,CAAC,UAAU,EAAW,wCAAwC,CAAC;IAC/D,CAAC,MAAM,EAAe,mBAAmB,CAAC;IAC1C,CAAC,OAAO,EAAc,4CAA4C,CAAC;IACnE,CAAC,kBAAkB,EAAG,0BAA0B,CAAC;IACjD,CAAC,UAAU,EAAW,6BAA6B,CAAC;IACpD,CAAC,MAAM,EAAe,4BAA4B,CAAC;IACnD,CAAC,kBAAkB,EAAG,uCAAuC,CAAC;IAC9D,CAAC,WAAW,EAAU,+BAA+B,CAAC;IACtD,CAAC,iBAAiB,EAAI,2BAA2B,CAAC;IAClD,CAAC,oBAAoB,EAAE,2BAA2B,CAAC;IACnD,CAAC,eAAe,EAAM,oCAAoC,CAAC;IAC3D,CAAC,YAAY,EAAS,8BAA8B,CAAC;IACrD,CAAC,eAAe,EAAM,4BAA4B,CAAC;IACnD,CAAC,OAAO,EAAc,8BAA8B,CAAC;IACrD,CAAC,kBAAkB,EAAG,2BAA2B,CAAC;IAClD,CAAC,kBAAkB,EAAG,2BAA2B,CAAC;IAClD,CAAC,YAAY,EAAS,sBAAsB,CAAC;IAC7C,CAAC,UAAU,EAAW,mBAAmB,CAAC;IAC1C,CAAC,WAAW,EAAU,oBAAoB,CAAC;IAC3C,CAAC,UAAU,EAAW,mBAAmB,CAAC;IAC1C,CAAC,iBAAiB,EAAI,wCAAwC,CAAC;IAC/D,CAAC,SAAS,EAAY,aAAa,CAAC;IACpC,CAAC,gBAAgB,EAAK,2BAA2B,CAAC;IAClD,CAAC,iBAAiB,EAAI,yBAAyB,CAAC;IAChD,CAAC,SAAS,EAAY,4BAA4B,CAAC;IACnD,CAAC,WAAW,EAAU,oBAAoB,CAAC;IAC3C,CAAC,aAAa,EAAQ,sBAAsB,CAAC;IAC7C,CAAC,gBAAgB,EAAK,2BAA2B,CAAC;IAClD,CAAC,OAAO,EAAc,kCAAkC,CAAC;CAC1D,CAAC;AAEF,8EAA8E;AAC9E,iDAAiD;AACjD,8EAA8E;AAE9E,MAAM,CAAC,MAAM,SAAS,GAAmC;IACvD,qBAAqB;IACrB,QAAQ,EAAc,CAAC,EAAE,GAAG,EAAE,eAAe,EAAE,CAAC;IAChD,MAAM,EAAgB,CAAC,EAAE,GAAG,EAAE,cAAc,EAAE,CAAC;IAC/C,SAAS,EAAa,CAAC,EAAE,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IACnE,WAAW,EAAW,CAAC,EAAE,GAAG,EAAE,
|
|
1
|
+
{"version":3,"file":"chain-map.js","sourceRoot":"","sources":["../../../../../src/server/coordinator/chain-map.ts"],"names":[],"mappings":"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"}
|
|
@@ -39,6 +39,16 @@ export type HookLevel = 'none' | 'minimal' | 'standard' | 'full';
|
|
|
39
39
|
export declare const HOOK_LEVELS: readonly HookLevel[];
|
|
40
40
|
export declare const HOOK_LEVEL_DESCRIPTIONS: Record<HookLevel, string>;
|
|
41
41
|
export declare const HOOK_DEFS: Record<string, HookDef>;
|
|
42
|
+
interface CodexHookDef {
|
|
43
|
+
event: 'SessionStart' | 'PreToolUse' | 'PostToolUse' | 'UserPromptSubmit' | 'Stop';
|
|
44
|
+
matcher?: string;
|
|
45
|
+
level: HookLevel;
|
|
46
|
+
requiresWorkspace?: boolean;
|
|
47
|
+
statusMessage?: string;
|
|
48
|
+
timeout?: number;
|
|
49
|
+
}
|
|
50
|
+
export declare const CODEX_HOOK_DEFS: Record<string, CodexHookDef>;
|
|
51
|
+
export declare const CODEX_HOOK_LEVEL_DESCRIPTIONS: Record<HookLevel, string>;
|
|
42
52
|
export declare function getClaudeSettingsPath(): string;
|
|
43
53
|
export declare function loadClaudeSettings(settingsPath: string): ClaudeSettings;
|
|
44
54
|
export declare function removeMaestroHooks(settings: ClaudeSettings): void;
|
|
@@ -73,6 +83,45 @@ export declare function installHooksByLevel(level: HookLevel, opts?: {
|
|
|
73
83
|
settingsPath?: string;
|
|
74
84
|
skipStatusline?: boolean;
|
|
75
85
|
}): InstallHooksResult;
|
|
86
|
+
interface CodexHookGroup {
|
|
87
|
+
matcher?: string;
|
|
88
|
+
hooks: Array<{
|
|
89
|
+
type: string;
|
|
90
|
+
command: string;
|
|
91
|
+
statusMessage?: string;
|
|
92
|
+
timeout?: number;
|
|
93
|
+
}>;
|
|
94
|
+
}
|
|
95
|
+
interface CodexHooksFile {
|
|
96
|
+
hooks?: {
|
|
97
|
+
SessionStart?: CodexHookGroup[];
|
|
98
|
+
PreToolUse?: CodexHookGroup[];
|
|
99
|
+
PostToolUse?: CodexHookGroup[];
|
|
100
|
+
UserPromptSubmit?: CodexHookGroup[];
|
|
101
|
+
Stop?: CodexHookGroup[];
|
|
102
|
+
[key: string]: unknown;
|
|
103
|
+
};
|
|
104
|
+
[key: string]: unknown;
|
|
105
|
+
}
|
|
106
|
+
export declare function getCodexHooksPath(opts?: {
|
|
107
|
+
project?: boolean;
|
|
108
|
+
}): string;
|
|
109
|
+
export declare function loadCodexHooks(hooksPath: string): CodexHooksFile;
|
|
110
|
+
export declare function removeCodexMaestroHooks(hooksFile: CodexHooksFile): void;
|
|
111
|
+
/**
|
|
112
|
+
* Check whether `codex_hooks = true` is set in config.toml.
|
|
113
|
+
* Returns true if the flag is found; prints a hint otherwise.
|
|
114
|
+
*/
|
|
115
|
+
export declare function checkCodexHooksFeatureFlag(opts?: {
|
|
116
|
+
project?: boolean;
|
|
117
|
+
}): boolean;
|
|
118
|
+
/**
|
|
119
|
+
* Install hooks at the given level into Codex hooks.json.
|
|
120
|
+
*/
|
|
121
|
+
export declare function installCodexHooksByLevel(level: HookLevel, opts?: {
|
|
122
|
+
project?: boolean;
|
|
123
|
+
hooksPath?: string;
|
|
124
|
+
}): InstallHooksResult;
|
|
76
125
|
export declare function registerHooksCommand(program: Command): void;
|
|
77
126
|
export {};
|
|
78
127
|
//# sourceMappingURL=hooks.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6BzC,UAAU,SAAS;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE;QACN,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;QACzB,WAAW,CAAC,EAAE,SAAS,EAAE,CAAC;QAC1B,gBAAgB,CAAC,EAAE,SAAS,EAAE,CAAC;QAC/B,YAAY,CAAC,EAAE,SAAS,EAAE,CAAC;QAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAMD,UAAU,OAAO;IACf,KAAK,EAAE,YAAY,GAAG,aAAa,GAAG,kBAAkB,GAAG,cAAc,GAAG,MAAM,CAAC;IACnF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,KAAK,EAAE,SAAS,CAAC;IACjB,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;AAEjE,eAAO,MAAM,WAAW,EAAE,SAAS,SAAS,EAA4C,CAAC;AAEzF,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAK7D,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAY7C,CAAC;AAaF,wBAAgB,qBAAqB,IAAI,MAAM,CAG9C;AAED,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc,CAGvE;AASD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAgBjE;AAkBD,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,KAAK,EAAE,SAAS,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,MAAM,GAAG,IAAI,CAMhF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,GAAE;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CACX,GAAG,MAAM,CAoBd;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,EAChB,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO,GAChF,kBAAkB,CA2CpB;AA0RD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,
|
|
1
|
+
{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks.ts"],"names":[],"mappings":"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"}
|