skill-v3.0.4

pbakaus/impeccableskill-v3.0.4Apr 28, 2026by pbakaus

AI Summary

Enhances the `/impeccable craft` workflow with stricter visual contract enforcement, safeguards against autonomous agents, and fixes UI issues with the live picker in modal environments.

Key Highlights

  • Approved mocks are now treated as visual contracts with blocking defects for missing elements
  • Prevents image-led designs from degrading into abstract panels
  • Adds preflight checklists and explicit build gates to prevent autonomous agents from proceeding without user confirmation
  • Fixes live picker interactions within modal hosts like Radix and Headless UI

New Features

  • Preflight checklist for setup
  • Explicit build gate enforcement

Full Release Notes

- **`/impeccable craft` now treats approved mocks as visual contracts.** The craft flow requires a mock fidelity inventory before build, maps major visible ingredients to code or assets, and flags missing hero objects, imagery, section structure, nav/CTA treatment, and distinctive motifs as blocking defects unless the user accepted the deviation.

- **Image-led brand surfaces can no longer degrade into abstract panels.** Travel, editorial, portfolio, venue, product showcase, entertainment, and education work now requires credible imagery, generated plates, illustrations, maps, renders, or destination scenes when the approved mock or subject matter calls for them.

- **`/impeccable craft` and `/impeccable shape` hardened against autonomous agents.** Codex-class harnesses had started writing files before the user confirmed a design brief, treating their own summary as the brief. Setup now ships a preflight checklist (context, product, command reference, shape, image gate, mutation), and craft enforces an explicit build gate: `shape=pass` only counts when the user separately approves the brief or supplies a pre-confirmed one. Self-authored briefs and "the implementation will be semantic anyway" no longer skip the visual probe.

- **Live picker plays nice with modal hosts.** Inside Radix Dialog, Headless UI, vaul, and other portals that lock `body { pointer-events: none }` or attach outside-click dismissers, the picker chrome had become unclickable, and any click that did land would dismiss the host dialog. The bar, picker, params panel, annotation overlay, and design panel now defang outside-handlers at the chrome boundary and force `pointer-events: auto` on themselves. Theme detection also stopped misreading a transparent body as black. Closes [#113](https://github.com/pbakaus/impeccable/issues/113), with thanks to [@dergachoff](https://github.com/dergachoff) for the thoughtful bug report.