maestro-flow 0.3.46 → 0.3.48

package/.codex/skills/maestro-execute/SKILL.md

@@ -209,7 +209,9 @@ If exit code is 1, present warnings and ask whether to proceed.
 
 5. **Load project specs + tools**: Run `maestro spec load --category coding` to load coding conventions, architecture constraints, AND discoverable knowhow tools (passed to all agents)
 
-6. **Load codebase + wiki context** (optional, passed to all agents):
+6. **Load UI specs (conditional)**: If any task involves frontend/UI work (task scope/description contains component, page, style, layout, CSS, HTML, frontend; or focus_paths in `src/components/`, `src/pages/`, `src/styles/`, `src/ui/`), also run `maestro spec load --category ui` and include in agent context.
+
+7. **Load codebase + wiki context** (optional, passed to all agents):
    - If `.workflow/codebase/ARCHITECTURE.md` exists: read and include as `codebase_context` in agent instructions
    - Run `maestro wiki search "<phase keywords>" --json 2>/dev/null`; if results: include top 5 entries as `wiki_context`
    - Both are optional — proceed without if unavailable

package/.codex/skills/maestro-impeccable/SKILL.md

@@ -0,0 +1,112 @@
+---
+name: maestro-impeccable
+description: Production-grade UI design with knowhow accumulation -- 23 commands for build, evaluate, refine, enhance, fix
+argument-hint: "[craft|shape · audit|critique · animate|bolder|colorize|delight|layout|overdrive|quieter|typeset · adapt|clarify|distill · harden|onboard|optimize|polish · teach|document|extract|live] [target] [--skip-harvest] [-y]"
+allowed-tools: Read, Write, Edit, Bash, Glob, Grep, request_user_input
+---
+<purpose>
+Designs and iterates production-grade frontend interfaces. Real working code, committed design choices, exceptional craft.
+After each command, automatically harvests design knowledge to `.workflow/knowhow/` (category: ui) for cross-session accumulation.
+
+Replaces the standalone impeccable skill. 23 commands covering the full design lifecycle.
+</purpose>
+
+<context>
+$ARGUMENTS -- sub-command + target + optional flags.
+
+**Sub-commands** (23):
+
+| Category | Commands |
+|----------|----------|
+| Build | craft, shape, teach, document, extract |
+| Evaluate | critique, audit |
+| Refine | polish, bolder, quieter, distill, harden, onboard |
+| Enhance | animate, colorize, typeset, layout, delight, overdrive |
+| Fix | clarify, adapt, optimize |
+| Iterate | live |
+
+**Flags:**
+- `--skip-harvest` -- Execute command without knowhow capture
+- `-y` -- Auto-confirm where the skill allows
+</context>
+
+<execution>
+
+## Setup
+
+Before any design work:
+
+1. Load context (PRODUCT.md / DESIGN.md) via spec system:
+   ```bash
+   maestro spec load --category ui
+   ```
+   This surfaces all design context (product + visual) from `.workflow/specs/ui-conventions.md`.
+
+   If specs are not initialized, fall back to the legacy loader:
+   ```bash
+   maestro impeccable load-context
+   ```
+   The loader searches `.workflow/impeccable/` first, then the project root, then `.agents/context/` and `docs/`.
+   PRODUCT.md and DESIGN.md are stored at `.workflow/impeccable/`.
+
+2. Identify register (brand vs product) and load matching reference from `~/.maestro/workflows/impeccable/brand.md` or `product.md`.
+3. If sub-command invoked, load its reference file from `~/.maestro/workflows/impeccable/{command}.md`.
+
+If PRODUCT.md missing → run `teach` first, then resume original task.
+
+## Command Execution
+
+Route by first argument:
+1. **Matches command** → load `~/.maestro/workflows/impeccable/{command}.md`, follow instructions
+2. **No argument** → show command menu grouped by category
+3. **No match** → general design invocation with full argument as context
+
+## Harvest (Post-Execution)
+
+After command completes (except `live`), unless `--skip-harvest`:
+
+| Command | Knowhow Type | Prefix |
+|---------|-------------|--------|
+| craft | decision + asset | DCS- + AST- |
+| shape | decision | DCS- |
+| teach | reference | REF- |
+| document, extract | asset | AST- |
+| critique, audit, polish, harden, onboard, clarify, adapt, optimize | tip | TIP- |
+| colorize, typeset, layout, animate, bolder, quieter, distill, delight, overdrive | decision | DCS- |
+
+Write knowhow with `category: ui`. For DCS-/AST- types, also create spec index:
+```bash
+maestro spec add ui "<title>" "<summary>" --keywords impeccable,<cmd>,... --ref knowhow/<file>
+```
+
+</execution>
+
+<shared_design_laws>
+
+- **Color**: OKLCH only. Never #000/#fff. Pick color strategy first (Restrained → Committed → Full palette → Drenched).
+- **Theme**: Write physical scene sentence before choosing dark/light.
+- **Typography**: Body 65-75ch. Hierarchy via scale + weight (>=1.25 ratio).
+- **Layout**: Vary spacing for rhythm. Cards only when truly best. No nested cards.
+- **Motion**: No CSS layout animations. Ease-out exponential curves.
+- **Bans**: Side-stripe borders, gradient text, glassmorphism default, hero-metric template, identical card grids, modal as first thought.
+- **Copy**: Every word earns its place. No em dashes.
+- **AI slop test**: Two-altitude category-reflex check.
+
+</shared_design_laws>
+
+<error_codes>
+| Code | Severity | Description |
+|------|----------|-------------|
+| E001 | error | Invalid sub-command |
+| E002 | error | No intent or target specified |
+| W001 | warning | Harvest failed (command still succeeded) |
+| W002 | warning | PRODUCT.md missing, auto-triggering teach |
+</error_codes>
+
+<success_criteria>
+- [ ] Sub-command recognized and reference file loaded
+- [ ] Context loaded from .workflow/impeccable/ (PRODUCT.md, register identified)
+- [ ] Design changes applied to target files
+- [ ] Knowhow entry created in .workflow/knowhow/ with category: ui (unless --skip-harvest or live)
+- [ ] Spec index entry created for DCS-/AST- types
+</success_criteria>