maestro-flow 0.3.48 → 0.4.1

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.
Files changed (93) hide show
  1. package/.claude/agents/impeccable-agent.md +99 -0
  2. package/.claude/commands/maestro-analyze.md +2 -2
  3. package/.claude/commands/maestro-brainstorm.md +116 -112
  4. package/.claude/commands/maestro-composer.md +5 -0
  5. package/.claude/commands/maestro-impeccable.md +231 -74
  6. package/.claude/commands/maestro-merge.md +3 -0
  7. package/.claude/commands/maestro-roadmap.md +5 -1
  8. package/.claude/commands/maestro.md +3 -3
  9. package/.claude/commands/manage-issue-discover.md +4 -0
  10. package/.claude/commands/quality-refactor.md +3 -0
  11. package/.claude/skills/maestro-help/index/catalog.json +1 -1
  12. package/.claude/skills/maestro-help/phases/01-parse-intent.md +1 -1
  13. package/.codex/skills/maestro/SKILL.md +70 -28
  14. package/.codex/skills/maestro-brainstorm/SKILL.md +19 -2
  15. package/.codex/skills/maestro-composer/SKILL.md +5 -0
  16. package/.codex/skills/maestro-help/catalog.json +1 -1
  17. package/.codex/skills/maestro-impeccable/SKILL.md +230 -97
  18. package/.codex/skills/maestro-merge/SKILL.md +3 -0
  19. package/.codex/skills/maestro-milestone-audit/SKILL.md +64 -7
  20. package/.codex/skills/maestro-quick/SKILL.md +1 -1
  21. package/.codex/skills/maestro-roadmap/SKILL.md +1 -1
  22. package/.codex/skills/maestro-tools-execute/SKILL.md +1 -1
  23. package/.codex/skills/maestro-tools-register/SKILL.md +1 -1
  24. package/.codex/skills/quality-refactor/SKILL.md +114 -22
  25. package/chains/_intent-map.json +1 -1
  26. package/chains/singles/ui-design.json +4 -4
  27. package/chains/{ui-design-driven.json → ui-craft-build.json} +8 -8
  28. package/dashboard/dist-server/dashboard/src/server/coordinator/chain-map.js +3 -3
  29. package/dashboard/dist-server/dashboard/src/server/coordinator/chain-map.js.map +1 -1
  30. package/dist/src/commands/delegate.d.ts.map +1 -1
  31. package/dist/src/commands/delegate.js +12 -7
  32. package/dist/src/commands/delegate.js.map +1 -1
  33. package/dist/src/commands/impeccable.d.ts +2 -1
  34. package/dist/src/commands/impeccable.d.ts.map +1 -1
  35. package/dist/src/commands/impeccable.js +80 -1
  36. package/dist/src/commands/impeccable.js.map +1 -1
  37. package/package.json +1 -1
  38. package/templates/planning-roles/ui-designer.md +86 -99
  39. package/templates/workflows/specs/node-catalog.md +1 -1
  40. package/workflows/brainstorm.md +26 -0
  41. package/workflows/cli-tools-usage.md +9 -26
  42. package/workflows/delegate-usage.md +301 -343
  43. package/workflows/impeccable/design.md +462 -0
  44. package/workflows/impeccable/explore.md +157 -0
  45. package/workflows/impeccable/shape.md +4 -0
  46. package/workflows/impeccable/ui-search/__pycache__/core.cpython-313.pyc +0 -0
  47. package/workflows/impeccable/ui-search/__pycache__/design_system.cpython-313.pyc +0 -0
  48. package/workflows/impeccable/ui-search/core.py +262 -0
  49. package/workflows/impeccable/ui-search/data/app-interface.csv +31 -0
  50. package/workflows/impeccable/ui-search/data/charts.csv +26 -0
  51. package/workflows/impeccable/ui-search/data/colors.csv +162 -0
  52. package/workflows/impeccable/ui-search/data/design.csv +1776 -0
  53. package/workflows/impeccable/ui-search/data/draft.csv +1779 -0
  54. package/workflows/impeccable/ui-search/data/google-fonts.csv +1924 -0
  55. package/workflows/impeccable/ui-search/data/icons.csv +106 -0
  56. package/workflows/impeccable/ui-search/data/landing.csv +35 -0
  57. package/workflows/impeccable/ui-search/data/products.csv +162 -0
  58. package/workflows/impeccable/ui-search/data/react-performance.csv +45 -0
  59. package/workflows/impeccable/ui-search/data/stacks/angular.csv +51 -0
  60. package/workflows/impeccable/ui-search/data/stacks/astro.csv +54 -0
  61. package/workflows/impeccable/ui-search/data/stacks/flutter.csv +53 -0
  62. package/workflows/impeccable/ui-search/data/stacks/html-tailwind.csv +56 -0
  63. package/workflows/impeccable/ui-search/data/stacks/jetpack-compose.csv +53 -0
  64. package/workflows/impeccable/ui-search/data/stacks/laravel.csv +51 -0
  65. package/workflows/impeccable/ui-search/data/stacks/nextjs.csv +53 -0
  66. package/workflows/impeccable/ui-search/data/stacks/nuxt-ui.csv +51 -0
  67. package/workflows/impeccable/ui-search/data/stacks/nuxtjs.csv +59 -0
  68. package/workflows/impeccable/ui-search/data/stacks/react-native.csv +52 -0
  69. package/workflows/impeccable/ui-search/data/stacks/react.csv +54 -0
  70. package/workflows/impeccable/ui-search/data/stacks/shadcn.csv +61 -0
  71. package/workflows/impeccable/ui-search/data/stacks/svelte.csv +54 -0
  72. package/workflows/impeccable/ui-search/data/stacks/swiftui.csv +51 -0
  73. package/workflows/impeccable/ui-search/data/stacks/threejs.csv +54 -0
  74. package/workflows/impeccable/ui-search/data/stacks/vue.csv +50 -0
  75. package/workflows/impeccable/ui-search/data/styles.csv +85 -0
  76. package/workflows/impeccable/ui-search/data/typography.csv +74 -0
  77. package/workflows/impeccable/ui-search/data/ui-reasoning.csv +162 -0
  78. package/workflows/impeccable/ui-search/data/ux-guidelines.csv +100 -0
  79. package/workflows/impeccable/ui-search/design_system.py +1148 -0
  80. package/workflows/impeccable/ui-search/prototype-template.html +511 -0
  81. package/workflows/impeccable/ui-search/render-prototype.js +208 -0
  82. package/workflows/impeccable/ui-search/search.py +114 -0
  83. package/workflows/maestro-chain-execute.md +2 -2
  84. package/workflows/maestro.codex.md +3 -3
  85. package/workflows/maestro.md +107 -117
  86. package/workflows/plan.md +1 -1
  87. package/workflows/ui-design.md +1 -1
  88. package/workflows/ui-style.md +1 -1
  89. package/.claude/commands/maestro-ui-craft.md +0 -364
  90. package/.claude/commands/maestro-ui-design.md +0 -104
  91. package/.claude/skills/maestro-impeccable/SKILL.md +0 -169
  92. package/.codex/skills/maestro-ui-craft/SKILL.md +0 -341
  93. package/.codex/skills/maestro-ui-design/SKILL.md +0 -242
@@ -1 +1 @@
1
- {"version":3,"file":"impeccable.js","sourceRoot":"","sources":["../../../src/commands/impeccable.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"impeccable.js","sourceRoot":"","sources":["../../../src/commands/impeccable.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "maestro-flow",
3
- "version": "0.3.48",
3
+ "version": "0.4.1",
4
4
  "description": "Workflow orchestration CLI with MCP endpoint support and extensible architecture",
5
5
  "type": "module",
6
6
  "imports": {
@@ -1,99 +1,86 @@
1
- ---
2
- name: ui-designer
3
- description: User interface and experience design with visual prototypes and HTML design artifacts
4
- ---
5
-
6
- # UI Designer Planning Template
7
-
8
- You are a **UI Designer** specializing in user interface and experience design with visual prototyping capabilities.
9
-
10
- ## Your Role & Responsibilities
11
-
12
- **Primary Focus**: User interface design, interaction flow, user experience planning, and visual design artifacts
13
-
14
- **Core Responsibilities**:
15
- - **Visual Design Artifacts**: Create HTML/CSS design prototypes and mockups
16
- - Interface design wireframes and high-fidelity prototypes
17
- - User interaction flows and journey mapping
18
- - Design system specifications and component definitions
19
- - Responsive design strategies and accessibility planning
20
- - Visual design guidelines and branding consistency
21
-
22
- **Does NOT Include**: Production frontend code, full implementation, automated UI testing
23
-
24
- **Output Requirements**: Must generate visual design artifacts (HTML prototypes) in addition to written specifications
25
-
26
- ## Planning Document Structure
27
-
28
- ### 1. Design Overview & Vision
29
- - **Design Goal**: Primary objective and target users
30
- - **Design Philosophy**: Design principles, brand alignment, aesthetic approach
31
- - **User Experience Goals**: Usability, accessibility, performance, engagement objectives
32
-
33
- ### 2. User Research & Analysis
34
- - **User Personas**: Primary, secondary, and edge case user definitions
35
- - **User Journey Mapping**: Entry points, core tasks, exit points, pain points
36
- - **Competitive Analysis**: Direct competitors, best practices, differentiation strategies
37
-
38
- ### 3. Information Architecture
39
- - **Content Structure**: Primary and secondary content hierarchy
40
- - **User Flows**: Primary flow, secondary flows, error handling flows
41
- - **Navigation Structure**: Sitemap, top-level sections, deep links
42
-
43
- ### 4. Design System Planning
44
- - **Visual Design Language**: Color palette, typography, iconography, imagery guidelines
45
- - **Component Library**: Basic components (buttons, forms, cards), complex components (tables, modals)
46
- - **Design Tokens**: Spacing system, breakpoints, animation specifications
47
- - **Layout Structure**: Header, main content, sidebar, footer specifications
48
-
49
- ### 5. Interface Design Specifications
50
- - **Key Screens/Pages**: Landing page, dashboard, detail views, forms
51
- - **Interactive Elements**: Navigation patterns, buttons, forms, data display
52
- - **Responsive Strategy**: Mobile, tablet, desktop design adaptations
53
- - **Accessibility Planning**: WCAG compliance, inclusive design considerations
54
-
55
- ### 6. Prototyping & Implementation Plan
56
- - **Prototyping Approach**: Wireframes (low, mid, high fidelity), interactive prototypes
57
- - **Testing Strategy**: Usability testing, accessibility testing, performance testing
58
- - **Implementation Guidelines**: Development handoff, asset delivery, quality assurance
59
-
60
- ## Design Workflow (4 Phases)
61
-
62
- ### Phase 1: Layout Design (ASCII Wireframe)
63
- - Analyze user requirements and identify key UI components
64
- - Design information architecture and content hierarchy
65
- - Create ASCII wireframe showing component placement
66
-
67
- ### Phase 2: Theme Design (CSS Variables)
68
- - Define color palette using OKLCH color space
69
- - Specify typography system using Google Fonts
70
- - Define spacing scale, shadow system, and border radius
71
-
72
- ### Phase 3: Animation Design (Micro-interaction Specs)
73
- - Define entrance/exit animations (slide, fade, scale)
74
- - Specify hover/focus/active states
75
- - Design loading states and transitions
76
-
77
- ### Phase 4: HTML Prototype Generation (Single-file HTML)
78
- - Generate single-page HTML prototype
79
- - Reference theme CSS from Phase 2
80
- - Implement animations from Phase 3
81
- - Use CDN libraries (Tailwind, Flowbite, Lucide icons)
82
-
83
- ## Technical Requirements
84
-
85
- - **Libraries**: Flowbite as base library (unless specified otherwise)
86
- - **Colors**: Avoid indigo/blue unless explicitly requested; use OKLCH color space
87
- - **Fonts**: Google Fonts only (JetBrains Mono, Inter, Poppins, Montserrat, DM Sans, Geist, Space Grotesk)
88
- - **Responsive**: ALL designs MUST be responsive (mobile, tablet, desktop)
89
- - **Icons**: Lucide icons via CDN
90
-
91
- ## Brainstorming Analysis Structure
92
-
93
- ### Individual Role Analysis File: `analysis.md`
94
-
95
- - User Experience Assessment (interaction patterns, usability implications, accessibility, design considerations)
96
- - Interface Design Evaluation (visual design patterns, information architecture, responsive, multi-platform)
97
- - Design System Integration (component library requirements, pattern consistency, brand alignment)
98
- - User Journey Optimization (critical user paths, friction reduction, engagement optimization)
99
- - Recommendations (UI/UX design approach, component specs, design validation strategies)
1
+ ---
2
+ name: ui-designer
3
+ description: UX analysis interaction flows, information architecture, state design, user journeys. Visual style is determined upstream by impeccable explore.
4
+ ---
5
+
6
+ # UI Designer Planning Template
7
+
8
+ You are a **UX Designer** specializing in interaction design, information architecture, and user experience analysis.
9
+
10
+ ## Your Role & Responsibilities
11
+
12
+ **Primary Focus**: Interaction design, user flows, information architecture, state design, and UX analysis
13
+
14
+ **Core Responsibilities**:
15
+ - User interaction flows and journey mapping
16
+ - Information architecture and content hierarchy
17
+ - State design (empty, loading, error, success, edge cases)
18
+ - Responsive strategy and accessibility planning
19
+ - Component behavior specifications (not visual styling)
20
+ - UX copy requirements and microcopy guidelines
21
+
22
+ **Does NOT Include**: Visual styling decisions (colors, typography, spacing — handled by impeccable explore/DESIGN.md), production frontend code, HTML prototype generation
23
+
24
+ **Visual System**: If `.workflow/impeccable/DESIGN.md` exists (produced by `impeccable explore`), reference it for visual constraints. Your job is UX structure, not visual direction.
25
+
26
+ **Output Requirements**: Written UX specifications with ASCII wireframes for layout structure
27
+
28
+ ## Planning Document Structure
29
+
30
+ ### 1. Design Overview & Vision
31
+ - **Design Goal**: Primary objective and target users
32
+ - **Design Philosophy**: Design principles, brand alignment, aesthetic approach
33
+ - **User Experience Goals**: Usability, accessibility, performance, engagement objectives
34
+
35
+ ### 2. User Research & Analysis
36
+ - **User Personas**: Primary, secondary, and edge case user definitions
37
+ - **User Journey Mapping**: Entry points, core tasks, exit points, pain points
38
+ - **Competitive Analysis**: Direct competitors, best practices, differentiation strategies
39
+
40
+ ### 3. Information Architecture
41
+ - **Content Structure**: Primary and secondary content hierarchy
42
+ - **User Flows**: Primary flow, secondary flows, error handling flows
43
+ - **Navigation Structure**: Sitemap, top-level sections, deep links
44
+
45
+ ### 4. Component Behavior Specifications
46
+ - **Component Inventory**: List all interactive components needed per screen
47
+ - **State Matrix**: Default, hover, active, disabled, loading, error states for each component
48
+ - **Interaction Patterns**: Click, hover, scroll, drag, keyboard navigation behaviors
49
+ - **Feedback Mechanisms**: Loading indicators, success/error messages, progress indicators
50
+
51
+ ### 5. Screen & Flow Specifications
52
+ - **Key Screens/Pages**: Landing page, dashboard, detail views, forms (ASCII wireframes)
53
+ - **Navigation Patterns**: Primary nav, breadcrumbs, tabs, pagination
54
+ - **Responsive Strategy**: Mobile, tablet, desktop layout adaptations (breakpoint behavior)
55
+ - **Accessibility Planning**: WCAG AA compliance, keyboard navigation, screen reader support
56
+
57
+ ### 6. Edge Cases & Error Handling
58
+ - **Empty States**: First-time use, no results, no data scenarios
59
+ - **Error States**: Network errors, validation errors, permission errors
60
+ - **Loading States**: Skeleton screens, spinners, progressive loading
61
+ - **Overflow Handling**: Long text, many items, extreme data volumes
62
+
63
+ ## Design Workflow (2 Phases)
64
+
65
+ ### Phase 1: Information Architecture (ASCII Wireframe)
66
+ - If `.workflow/impeccable/DESIGN.md` exists: reference it as the visual baseline in analysis.md header (*"Visual system: {style_name} from DESIGN.md — this analysis covers UX structure only"*)
67
+ - Analyze user requirements and identify key UI components
68
+ - Design content hierarchy and navigation structure
69
+ - Create ASCII wireframe showing component placement and flow
70
+ - Define responsive breakpoint behavior
71
+
72
+ ### Phase 2: Interaction Specification
73
+ - Define all interactive states per component
74
+ - Specify user flow sequences (happy path + error paths)
75
+ - Document accessibility requirements
76
+ - List UX copy requirements (labels, errors, empty states, confirmations)
77
+
78
+ ## Brainstorming Analysis Structure
79
+
80
+ ### Individual Role Analysis File: `analysis.md`
81
+
82
+ - User Experience Assessment (interaction patterns, usability implications, accessibility, design considerations)
83
+ - Interface Design Evaluation (visual design patterns, information architecture, responsive, multi-platform)
84
+ - Design System Integration (component library requirements, pattern consistency, brand alignment)
85
+ - User Journey Optimization (critical user paths, friction reduction, engagement optimization)
86
+ - Recommendations (UI/UX design approach, component specs, design validation strategies)
@@ -15,7 +15,7 @@ Only commands that exist in `~/.claude/commands/` are listed.
15
15
  | `maestro-spec-generate` | requirement | specification | `"{goal}"` |
16
16
  | `maestro-roadmap` | requirement | roadmap | `"{goal}"` |
17
17
  | `maestro-quick` | requirement | code | `"{goal}"` |
18
- | `maestro-ui-design` | requirement | ui-design | `{phase}` |
18
+ | `maestro-impeccable` | requirement | ui-design | `"{phase}" --chain build` |
19
19
 
20
20
  ## Quality Commands (as skill nodes)
21
21
 
@@ -287,6 +287,32 @@ Seven sub-phases producing guidance-specification.md:
287
287
 
288
288
  **Output**: `{output_dir}/guidance-specification.md`, session metadata (workflow-session.json)
289
289
 
290
+ ### Step 3.5: Visual Style Foundation (Auto Mode, conditional)
291
+
292
+ 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.
293
+
294
+ **Condition**: Skip if `.workflow/impeccable/DESIGN.md` already exists (visual direction already locked).
295
+
296
+ **Execution** (sequential):
297
+
298
+ 1. **Product context** — if `.workflow/impeccable/PRODUCT.md` missing:
299
+ ```
300
+ Skill({ skill: "maestro-impeccable", args: "teach" })
301
+ ```
302
+ This runs the teach interview to establish brand, users, personality, anti-references.
303
+
304
+ 2. **Visual exploration** — multi-style comparison and selection:
305
+ ```
306
+ Skill({ skill: "maestro-impeccable", args: "explore" })
307
+ ```
308
+ This generates multiple design system variants as HTML prototypes, launches visual comparison, and lets the user select/mix. Produces DESIGN.md on completion.
309
+
310
+ 3. Record in session metadata: `design_system_established: true`, `design_md_path: ".workflow/impeccable/DESIGN.md"`
311
+
312
+ **`--yes` mode**: `explore` auto-selects variant 1 without visual comparison. `teach` still requires minimal input if PRODUCT.md is missing.
313
+
314
+ **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.
315
+
290
316
  ### Step 4: Parallel Role Analysis (Auto Mode)
291
317
 
292
318
  For EACH selected role, spawn a conceptual-planning-agent in parallel:
@@ -186,35 +186,31 @@ CONSTRAINTS: Focus on authentication | Ignore test files
186
186
 
187
187
  ### Calling Convention
188
188
 
189
- > **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.
189
+ `maestro delegate` runs synchronously. Status summary and output are **auto-appended** on completion no manual `output` or `status` commands needed.
190
190
 
191
- **Why**: `maestro delegate` blocks until completion. Background execution + immediate stop ensures the conversation remains responsive.
192
-
193
- **Correct** — response contains ONLY the Bash tool call, nothing after it:
191
+ **Always** use `run_in_background: true` and **end your response immediately**:
194
192
 
195
193
  ```
196
194
  Bash({ command: "maestro delegate \"...\" --to gemini --mode analysis", run_in_background: true })
197
195
  ```
198
196
 
199
- **Wrong** any text or tool call after the Bash call is a violation:
200
-
197
+ When the background callback arrives, the result is already included:
201
198
  ```
202
- Bash({ command: "maestro delegate \"...\" --to gemini --mode analysis", run_in_background: true })
203
- "I've started the analysis..." VIOLATION: response must end above
199
+ [MAESTRO_EXEC_ID=gem-143022-a7f2] , at start
200
+ [DELEGATE COMPLETED] gem-143022-a7f2 gemini/analysis status, on completion
201
+ --- Output ---
202
+ <actual output content> ← output, on completion
204
203
  ```
205
204
 
206
205
  **Rules:**
207
206
  - NEVER use foreground Bash for delegate calls
208
- - NEVER output text, status updates, or additional tool calls after the `run_in_background` Bash call
209
- - NEVER poll with `delegate status` wait for the background completion callback
210
- - When the callback arrives, retrieve output with `maestro delegate output <id>`
207
+ - NEVER output text or tool calls after the `run_in_background` Bash call
208
+ - When the callback arrives, output is already included directly use it
211
209
 
212
210
  ### Execution ID
213
211
 
214
212
  ID prefix: gemini→`gem`, qwen→`qwn`, codex→`cdx`, claude→`cld`, opencode→`opc`
215
213
 
216
- Output to stderr: `[MAESTRO_EXEC_ID=<id>]`
217
-
218
214
  ```bash
219
215
  maestro delegate "<PROMPT>" --to gemini --mode analysis # auto-ID: gem-143022-a7f2
220
216
  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
229
225
  ```
230
226
 
231
227
  Resume auto-assembles previous conversation context. Warning emitted when context exceeds 32KB.
232
-
233
- ### Subcommands
234
-
235
- ```bash
236
- maestro delegate show # recent 20 executions
237
- maestro delegate show --all # up to 100
238
- maestro delegate output <id> # last reply only (after last tool call)
239
- maestro delegate output <id> --full # full output (all turns)
240
- maestro delegate output <id> --verbose # include start/end timestamps
241
- maestro delegate status <id> # broker + history + snapshot preview
242
- maestro delegate tail <id> # recent events + history
243
- maestro delegate cancel <id> # request cancellation
244
- ```
245
228
  </execution>
246
229
 
247
230
  ---