القائمة
Use when designing, reviewing, refining, fixing, or codifying frontend UI through the installed Impeccable skill
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/catlog22/maestro-flow --skill maestro-impeccableيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
عرض SKILL.md
| name | maestro-impeccable |
| disable-model-invocation | true |
| description | Use when designing, reviewing, refining, fixing, or codifying frontend UI through the installed Impeccable skill |
| argument-hint | [command] [target] | hooks <action> | doctor | pin|unpin <command> | --codify <path> |
| allowed-tools | ["Bash","Edit","Glob","Grep","Read","Write","followup_task","interrupt_agent","list_agents","request_user_input","send_message","spawn_agent","spawn_agents_on_csv","update_plan","wait_agent"] |
| session-mode | run |
| contract | {"discovery":"self-described","consumes":[],"produces":[]} |
| version | 0.5.83 |
Plan tracking: codex 无 TaskCreate/TaskUpdate/TodoWrite 任务板。进度清单用
update_plan({ explanation?, plan: [{ step, status }] })维护（整体提交步骤数组，status:pending|in_progress|completed），权威状态始终在 session 工件中；依赖/认领（addBlockedBy/owner）是工件字段，不是工具参数。
<required_reading>
@/.maestro/workflows/run-mode.md
@/.maestro/workflows/codex-run-mode.md
</required_reading>
If required reading was not expanded by the host, or is no longer in context, Read it explicitly before execution.
<deferred_reading> Maestro Codify extension only — do not read these files for normal Impeccable work:
--codify starts<upstream_contract>
The installed Impeccable skill is the canonical template. First resolve and invoke it through the Skill tool with name impeccable; its loaded base directory owns SKILL.md, reference/, and scripts/.
If Skill resolution is unavailable, try these fallbacks in order and Read the first existing SKILL.md; its parent directory becomes the skill base directory:
.claude/skills/impeccable/SKILL.md~/.claude/skills/impeccable/SKILL.mdRules:
~/.maestro/workflows/impeccable/{command}.md for normal execution.skill/SKILL.src.md directly: it is a build source with unresolved provider placeholders.SKILL.md, then only the single command/reference file it routes to. Respect its deferred-reading rules.init.audit.native.md / adapt.native.md for native projects; live and the HTML detector are web-only.npx impeccable install (or Maestro's Impeccable add-on installer). Do not silently install or vendor it.npx impeccable update; do not update it as a side effect of design work.Baseline checked against upstream Impeccable Skill 4.1.2. The installed skill remains authoritative when newer. </upstream_contract>
Use these symbols consistently in Maestro-owned displays. Do not substitute colorful success/failure emoji.
| Meaning | Display |
|---|---|
| Current step / transition | → |
| Completed prerequisite or step | ✓ |
| Quality or confirmation gate | ◆ |
| Bounded re-check | ↺ |
| Warning / degraded mode | ⚠ |
| Failure | FAIL |
| Terminal success | Status: DONE |
| Terminal failure | Status: FAILED |
Upstream machine values and required report fields remain unchanged. For an upstream degraded critique banner, normalize only the symbol presentation to ⚠ DEGRADED: single-context (<reason>); do not weaken or omit the degraded disclosure.
Parse $ARGUMENTS without inventing a static workflow chain.
Apply this table top-to-bottom; specific routes override the generic command route.
| Input | Route |
|---|---|
--codify <source-path> ... / codify <source-path> ... | Maestro Codify extension |
hooks <action> | Invoke Impeccable hooks control; load reference/hooks.md |
doctor | Invoke Impeccable doctor; load reference/doctor.md |
pin <command> / unpin <command> | Invoke the installed skill's pin script |
teach ... | Compatibility alias for init; no deprecation warning |
craft ... | Deprecated upstream alias for ordinary new-work; display W001 once |
Legacy Maestro preset (build, redesign, improve, enhance, launch, foundation) | Treat the full text as a general design request and let current upstream routing resolve it; display W002 once; never reconstruct the retired chain |
| One of the remaining commands below | Invoke Impeccable with the arguments unchanged |
| No arguments | Invoke current reference/routing.md; show 2–3 context-aware recommendations, then the full menu; never auto-run |
| Other UI design text | Pass as general Impeccable work; follow current upstream routing |
continue, next, and -c are not Impeccable resume commands. Run/session continuation belongs to the canonical Maestro Session/Run lifecycle in run-mode.md.
This table is a routing index only. The installed Skill and its references own the full instructions.
| Command | Category | Current meaning |
|---|---|---|
craft [feature] | Build | Deprecated alias for ordinary new-work |
shape [feature] | Build | Plan UX/UI before writing code |
init | Build | Capture durable product context in PRODUCT.md |
document | Build | Generate DESIGN.md from existing project code |
extract [target] | Build | Pull reusable tokens and components into a design system |
critique [target] | Evaluate | UX design review with applicable heuristic scoring |
audit [target] | Evaluate | Technical a11y, performance, and responsive checks |
polish [target] | Refine | Final bounded quality pass before shipping |
bolder [target] | Refine | Amplify a safe or bland design |
quieter [target] | Refine | Reduce aggressive or overstimulating design |
distill [target] | Refine | Remove complexity and strip to essence |
harden [target] | Refine | Cover errors, i18n, edge cases, and production states |
onboard [target] | Refine | Improve first-run, empty-state, and activation flows |
animate [target] | Enhance | Add purposeful motion |
colorize [target] | Enhance | Add strategic color |
typeset [target] | Enhance | Improve typography hierarchy and fonts |
layout [target] | Enhance | Fix spacing, rhythm, alignment, and hierarchy |
delight [target] | Enhance | Add personality and memorable details |
overdrive [target] | Enhance | Push past conventional visual limits |
clarify [target] | Fix | Improve UX copy, labels, and error messages |
adapt [target] | Fix | Adapt across devices and screen sizes |
optimize [target] | Fix | Diagnose and fix UI performance |
live | Iterate | Web-only browser variant mode |
Attach the canonical Run
run-mode.md before design work. If a birth packet says run_already_created: true, consume its exact locator, task, continuation, run_dir, and revisions; never create a duplicate Run.run-mode.md.Resolve template
impeccable; if unavailable, Read the first available fallback defined in <upstream_contract> and retain its base directory.Run upstream setup
CONTEXT_STALE; never repair drift unless requested or marked auto by upstream.Resolve route
reference/new-work.md.reference/routing.md; recommendations require confirmation.Display Maestro execution panel
── Impeccable: {command|general} ──────────────
Target: {target|project context}
Mode: {Persuade|Operate|Read|Experience}
Platform: {web|ios|android|adaptive|unknown}
Reference: {relative reference path}
──────────────────────────────────────────────
→ Setup
If platform is unknown, do not default to web. Resolve platform from project evidence or run init before platform-sensitive routing; never run live or the HTML detector on an unconfirmed native target.
Track major phases
Create update_plan items from the loaded reference's major phases; do not invent a generic chain.
Format: [impeccable:{command}] {phase}.
Mark each phase complete immediately when its verifiable outcome is complete.
User-facing progress:
→ [impeccable:{command}] {phase}
✓ [impeccable:{command}] {phase}
⚠ [impeccable:{command}] {phase} — W###: {reason}
FAIL [impeccable:{command}] {phase} — E###: {reason}
Execute upstream reference
reference/craft-floor.md immediately before UI edits, never for planning-only work.n/a, and the applicable maximum may vary.Bounded verification
Show a gate only when the loaded reference defines one:
◆ {gate}: {actual evidence} — PASS|FAIL
↺ confirmation pass 1/1
Do not fabricate a numeric threshold or score.
Do not report PASS without actual evidence from the executed check.
Finish the Run
{run_dir}/report.md using the exact frontmatter vocabulary and whitelist from run-mode.md; put every caveat in concerns.maestro run check {run_id} --session {session_id} --json and repair blocking gates.maestro run complete ... --verdict done|done_with_concerns --advance --json continuation from run-mode.md; parse and retain the returned revisions. Without mutation authority, return the report and check result to the coordinator and do not complete or advance.=== IMPECCABLE RESULT ===
Command: {command|general}
Target: {target}
Evidence: {checks, snapshots, detector output, or files}
Warnings: {none|<warning-code> ...}
--- STATUS ---
Status: DONE | FAILED
Suggest only the next step supported by the loaded upstream reference or current findings.
<codify_mode>
Codify remains a Maestro-owned extension; it is not an upstream Impeccable command. Load ui-codify.md for its phase algorithm; the normal Impeccable Skill/reference route does not apply inside this mode. The Run-governance rules in this section override stale persistence wording or incomplete command examples in the referenced Codify workflows.
Arguments:
--codify <source-path> [--package-name <name>] [--output-dir <path>] [--overwrite]
Boundaries:
--output-dir, .workflow/codify-temp-*, {run_dir}, and other generated directories from discovery, even when they are nested beneath source_path. Never edit a discovered source file.--output-dir (default .workflow/reference_style/). Maestro runtime writes may also use the exact {run_dir}/report.md, {run_dir}/outputs|evidence|work, and the phase-scoped .workflow/codify-temp-* directory required by the referenced workflows.--run {run_id}; review/promotion occurs after sealing under run-mode.md.--overwrite. With --overwrite, clear the validated target package before generation or build in a fresh temporary package and replace it; artifact checks must prove current-Run provenance and must not pass on stale files.ui-codify.md specifies; do not invent a token-first dependency.Display:
── Impeccable: codify ─────────────────────
Source: {source-path}
Output: {output-dir}
───────────────────────────────────────────
→ Phase 1: Validate + workspace setup
◆ GATE 1: source and output policy valid
→ Phase 2: Parallel extraction (Style + Animation + Layout)
◆ GATE 2: extraction artifacts satisfy ui-codify.md
→ Phase 3: Reference package
◆ GATE 3: current-Run preview and required token/layout artifacts exist
→ Phase 4: Manifest + governed candidate staging (confirmation required)
◆ GATE 4: knowhow-manifest.json + stage receipts recorded
At the Phase 3 → 4 gate, request_user_input:
继续生成 knowhow — generate the manifest and stage governed candidates with --run {run_id}; promotion remains post-seal仅保留 preview，跳过 knowhow — clean the temporary directory, verify preview-only artifacts, and finish with an explicit preview-only scope reportCodify diagnostics originate in the referenced workflows. Translate them for Maestro-owned output so they do not collide with normal-mode codes:
--overwrite)Follow the referenced workflows for all other phase instructions and recovery. For every Phase 4 stage command, this adapter additionally requires explicit --run {run_id}, a defined valid --category (never undefined), and a captured candidate receipt. Stage only; never write or promote governed corpus files during the active Run.
</codify_mode>
<error_codes>
| Code | Severity | Condition | Recovery |
|---|---|---|---|
| E001 | error | Skill resolution and both installed-template fallbacks failed | Run npx impeccable install or install the Maestro Impeccable add-on |
| E002 | error | Explicit normal-mode target/path does not exist | Correct the target and retry |
| E003 | error | Required upstream reference/script is missing | Run npx impeccable update, then retry |
| C001 | error | Codify source argument is missing | Provide --codify <source-path> |
| C002 | error | Codify source is missing or not a directory | Correct the source path |
| C003 | error | Codify package exists without --overwrite | Use a new package/output path or explicitly pass --overwrite |
| CW001 | warning | Optional Codify animation tokens are missing | Continue without animation tokens and report reduced motion coverage |
| W001 | warning | Deprecated craft alias used | Route as ordinary new-work and suggest a general request next time |
| W002 | warning | Retired Maestro chain preset used | Route the full request through current upstream semantics; do not recreate the old chain |
| W003 | warning | Upstream execution is degraded | Preserve the required degraded disclosure and evidence limitations |
| </error_codes> |
<success_criteria> Normal mode:
{run_dir}/report.md, run check, fenced completion/return-to-coordinator, and terminal Session handling followed run-mode.md→, ✓, ◆, ↺, ⚠, FAIL, and textual terminal status consistentlyCodify mode:
--run {run_id}