1---
2import Base from '../layouts/Base.astro';
3import '../styles/main.css';
4import '../styles/sub-pages.css';
5---
6
7<Base
8 title="Impeccable: The missing upgrade to Anthropic's impeccable skill"
9 description="1 skill, 23 commands, and curated anti-patterns for impeccable frontend design. Works with Cursor, Claude Code, Gemini CLI, and Codex CLI."
10 activeNav="home"
11 canonicalPath="/"
12 mainId="main-content"
13 mainClass="site-content"
14 ogTitle="Impeccable: Design skills for AI harnesses"
15 ogDescription="1 skill, 23 commands, and curated anti-patterns for impeccable frontend design. Works with Cursor, Claude Code, Gemini CLI, and Codex CLI."
16 ogImage="https://impeccable.style/og-image.jpg"
17 twitterSite="@pbakaus"
18 twitterCreator="@pbakaus"
19>
20
21<Fragment slot="head">
22 <script is:inline async src="https://www.googletagmanager.com/gtag/js?id=G-TEXGHC7V34"></script>
23 <script is:inline>
24 window.dataLayer = window.dataLayer || [];
25 function gtag(){dataLayer.push(arguments);}
26 gtag('js', new Date());
27 gtag('config', 'G-TEXGHC7V34');
28 </script>
29 <link rel="apple-touch-icon" href="/apple-touch-icon.png">
30</Fragment>
31
32<Fragment slot="before-header">
33 <div class="grain-overlay" aria-hidden="true"></div>
34</Fragment>
35
36<Fragment slot="after-header">
37 <!-- Sticky Section Nav -->
38 <nav class="section-nav" id="section-nav" aria-label="Page sections">
39 <a href="#foundation" class="section-nav-item" data-section="foundation"><span class="section-nav-num">01</span><span class="section-nav-label">Foundation</span></a>
40 <a href="#language" class="section-nav-item" data-section="language"><span class="section-nav-num">02</span><span class="section-nav-label">Language</span></a>
41 <a href="#why" class="section-nav-item" data-section="why"><span class="section-nav-num">03</span><span class="section-nav-label">Case</span></a>
42 <a href="#live-mode" class="section-nav-item" data-section="live-mode"><span class="section-nav-num">04</span><span class="section-nav-label">Live</span></a>
43 <a href="#downloads" class="section-nav-item" data-section="downloads"><span class="section-nav-num">05</span><span class="section-nav-label">Install</span></a>
44 <a href="#changelog" class="section-nav-item" data-section="changelog"><span class="section-nav-num">06</span><span class="section-nav-label">New</span></a>
45 <a href="#faq" class="section-nav-item" data-section="faq"><span class="section-nav-num">07</span><span class="section-nav-label">FAQ</span></a>
46 </nav>
47
48 <!-- 1. HERO - Combined with Problem Section -->
49 <section id="hero" class="hero-combined">
50 <div class="hero-combined-container">
51 <!-- Left: Title & Info -->
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67 <div class="hero-combined-left">
68 <h1 class="hero-title-combined">Impeccable</h1>
69 <p class="hero-tagline-combined">Design fluency for AI harnesses</p>
70
71 <p class="hero-hook-text hero-hook-text--full">Great design prompts require design vocabulary. Most people don't have it. Impeccable teaches your AI deep design knowledge and gives you 23 commands to steer the result.</p>
72 <p class="hero-hook-text hero-hook-text--short">Impeccable teaches your AI real design and gives you 23 commands to steer the result.</p>
73
74 <div class="hero-included-box">
75 <span class="hero-included-title">What's included</span>
76 <div class="hero-included-items">
77 <span><em>Impeccable</em> agent skill with 23 design commands</span>
78 <span class="hero-included-sep">·</span>
79 <span>Optional CLI + Chrome extension</span>
80 </div>
81 </div>
82
83 <div class="hero-cta-group">
84 <a href="#downloads" class="hero-cta-combined">Get Started</a>
85
86
87 <div class="hero-logos-inline">
88 <span class="hero-logos-label">Works with</span>
89 <div class="hero-logos-row">
90 <span class="hero-logo-icon has-tooltip" data-tooltip="Cursor"><img src="assets/cursor-logo.png" alt="Cursor" width="24" height="24" loading="lazy"></span>
91 <span class="hero-logo-icon has-tooltip" data-tooltip="Claude Code"><img src="assets/claude-logo.png" alt="Claude Code" width="24" height="24" loading="lazy"></span>
92 <span class="hero-logo-icon has-tooltip" data-tooltip="Gemini CLI"><img src="assets/gemini-logo.png" alt="Gemini CLI" width="20" height="20" loading="lazy"></span>
93 <span class="hero-logo-icon has-tooltip" data-tooltip="Codex CLI"><img src="assets/openai-logo.png" alt="Codex CLI" width="20" height="20" loading="lazy"></span>
94 <span class="hero-logo-icon has-tooltip" data-tooltip="VS Code Copilot"><img src="assets/github-logo.png" alt="VS Code Copilot" width="20" height="20" loading="lazy"></span>
95 <span class="hero-logo-icon has-tooltip" data-tooltip="Antigravity"><img src="assets/antigravity-logo.png" alt="Antigravity" width="20" height="20" loading="lazy"></span>
96 <span class="hero-logo-icon has-tooltip" data-tooltip="Kiro"><img src="assets/kiro-logo.png" alt="Kiro" width="20" height="20" loading="lazy"></span>
97 <span class="hero-logo-icon has-tooltip" data-tooltip="OpenCode"><img src="assets/opencode-logo.png" alt="OpenCode" width="20" height="20" loading="lazy"></span>
98 <span class="hero-logo-icon has-tooltip" data-tooltip="Pi"><img src="assets/pi-logo.svg" alt="Pi" width="20" height="20" loading="lazy" style="background:#1a1a1a;border-radius:50%;padding:3px"></span>
99 </div>
100 </div>
101
102
103 </div>
104 <p class="hero-version-link"><a href="#changelog">v3.1.0: Codex asset producer agent, critique persistence, palette-first image flow</a></p>
105 </div>
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122 <!-- Right: Before/After Demo -->
123 <div class="hero-combined-right">
124 <div class="split-comparison" id="lens-comparison">
125 <div class="split-container">
126 <!-- Before: AI Slop -->
127 <div class="split-before">
128 <span class="split-badge split-badge--before">Before</span>
129 <div class="slop-card">
130 <div class="slop-header">
131 <div class="slop-avatar"></div>
132 <div class="slop-text">
133 <div class="slop-title">Welcome to Our Platform</div>
134 <div class="slop-subtitle">The best solution for your needs</div>
135 </div>
136 </div>
137 <p class="slop-body">Lorem ipsum dolor sit amet, consectetur adipiscing elit. This is generic placeholder text.</p>
138 <button class="slop-button">Get Started</button>
139 </div>
140 <!-- Callout labels pointing to issues -->
141 <div class="slop-callouts">
142 <span class="slop-callout" data-point="font">Inter font</span>
143 <span class="slop-callout" data-point="gradient">Purple gradient</span>
144 <span class="slop-callout" data-point="copy">Generic copy</span>
145 <span class="slop-callout" data-point="rounded">Cards on cards</span>
146 </div>
147 </div>
148 <!-- After: Impeccable (shown through split) -->
149 <div class="split-after">
150 <span class="split-badge split-badge--after">After</span>
151 <div class="impeccable-card">
152 <p class="impeccable-eyebrow">Introducing</p>
153 <p class="impeccable-title">Thoughtful Design</p>
154 <p class="impeccable-body">Every element serves a purpose. Hierarchy guides the eye. Whitespace breathes.</p>
155 <button class="impeccable-button">Explore</button>
156 </div>
157 </div>
158 <!-- The Divider -->
159 <div class="split-divider"></div>
160 </div>
161 <div class="split-labels">
162 <div class="split-label-item" data-point="before">
163 <span class="split-label-dot"></span>
164 <span>Generic AI Output</span>
165 </div>
166 <div class="split-label-item" data-point="after">
167 <span class="split-label-dot split-label-dot--accent"></span>
168 <span>With Design Skills</span>
169 </div>
170 </div>
171 </div>
172 </div>
173 </div>
174 </section>
175</Fragment>
176
177
178 <!-- 01. THE FOUNDATION - Design knowledge -->
179 <section class="foundation-section" id="foundation">
180 <div class="section-header" data-reveal>
181 <span class="section-number">01</span>
182 <h2 class="section-title">The Foundation</h2>
183 </div>
184 <div class="foundation-content">
185 <p class="section-lead" data-reveal>Before any command runs, Impeccable teaches your AI how design works. Seven reference files load on every prompt: typography, color, motion, spatial, interaction, responsive, UX writing.</p>
186
187 <div class="foundation-grid" data-reveal>
188 <!-- 7 dimension cards, rendered by JS -->
189 </div>
190
191 <div class="foundation-cta" data-reveal>
192 <p class="foundation-cta-text">Run <code><span class="foundation-slash">/</span>impeccable teach</code> once to set your project's design context. Every command benefits.</p>
193 </div>
194 </div>
195 </section>
196
197 <!-- 02. THE LANGUAGE - Commands vocabulary + demos -->
198 <section class="language-section" id="language">
199 <div id="solution" style="height:0;overflow:hidden;visibility:hidden"></div>
200 <div class="section-header" data-reveal>
201 <span class="section-number">02</span>
202 <h2 class="section-title">The Language</h2>
203 </div>
204 <div class="language-content">
205 <div class="language-intro-row" data-reveal>
206 <p class="section-lead">23 commands give you a shared design vocabulary with your AI. Each maps to one discipline (<code>/typeset</code> for type, <code>/colorize</code> for color, <code>/animate</code> for motion), so you can ask for the exact thing without explaining it. Pick any to see it in action, or <a href="/docs" class="cheatsheet-link">browse the full reference →</a></p>
207 <div class="language-view-toggle" role="tablist" aria-label="Commands view">
208 <button type="button" role="tab" class="language-view-tab is-active" data-view="palette" aria-selected="true">Palette</button>
209 <button type="button" role="tab" class="language-view-tab" data-view="periodic" aria-selected="false">Periodic</button>
210 </div>
211 </div>
212
213 <div id="commands-section" style="height:0;overflow:hidden;visibility:hidden"></div>
214
215 <div class="language-view language-view--palette is-active" data-view-panel="palette">
216 <div class="commands-subsection">
217 <div class="commands-gallery">
218 <!-- Rendered by JS -->
219 </div>
220 </div>
221 </div>
222
223 <div class="language-view language-view--periodic" data-view-panel="periodic" hidden>
224 <div class="solution-visual-interactive" id="framework-viz-container" data-reveal>
225 <!-- Periodic table generated by JS -->
226 </div>
227 </div>
228 </div>
229 </section>
230
231 <!-- 04. WHY IMPECCABLE - Feature loop -->
232 <section class="why-section" id="why">
233 <div class="why-content" data-reveal>
234 <div class="section-header">
235 <span class="section-number">03</span>
236 <h2 class="section-title">The Case</h2>
237 </div>
238 <div class="why-layout">
239 <div class="why-left">
240 <ol class="why-tabs" role="tablist" aria-label="Reasons Impeccable is different">
241 <li><button role="tab" class="why-tab is-active" data-index="vz" aria-selected="true" aria-controls="why-panel-vz"><span class="why-tab-num">01</span><span class="why-tab-label">Visualize, then ship</span><span class="why-tab-progress" aria-hidden="true"></span></button></li>
242 <li><button role="tab" class="why-tab" data-index="0" aria-selected="false" aria-controls="why-panel-0"><span class="why-tab-num">02</span><span class="why-tab-label">Intentional design</span><span class="why-tab-progress" aria-hidden="true"></span></button></li>
243 <li><button role="tab" class="why-tab" data-index="1" aria-selected="false" aria-controls="why-panel-1"><span class="why-tab-num">03</span><span class="why-tab-label">Prevents AI slop</span><span class="why-tab-progress" aria-hidden="true"></span></button></li>
244 <li><button role="tab" class="why-tab" data-index="2" aria-selected="false" aria-controls="why-panel-2"><span class="why-tab-num">04</span><span class="why-tab-label">Production codebases</span><span class="why-tab-progress" aria-hidden="true"></span></button></li>
245 <li><button role="tab" class="why-tab" data-index="3" aria-selected="false" aria-controls="why-panel-3"><span class="why-tab-num">05</span><span class="why-tab-label">Brand + Product design</span><span class="why-tab-progress" aria-hidden="true"></span></button></li>
246 <li><button role="tab" class="why-tab" data-index="4" aria-selected="false" aria-controls="why-panel-4"><span class="why-tab-num">06</span><span class="why-tab-label">Ships code, not mockups</span><span class="why-tab-progress" aria-hidden="true"></span></button></li>
247 <li><button role="tab" class="why-tab" data-index="5" aria-selected="false" aria-controls="why-panel-5"><span class="why-tab-num">07</span><span class="why-tab-label">Fluent in DESIGN.md</span><span class="why-tab-progress" aria-hidden="true"></span></button></li>
248 <li><button role="tab" class="why-tab" data-index="6" aria-selected="false" aria-controls="why-panel-6"><span class="why-tab-num">08</span><span class="why-tab-label">CI/CD-ready</span><span class="why-tab-progress" aria-hidden="true"></span></button></li>
249 <li><button role="tab" class="why-tab" data-index="7" aria-selected="false" aria-controls="why-panel-7"><span class="why-tab-num">09</span><span class="why-tab-label">Chrome extension</span><span class="why-tab-progress" aria-hidden="true"></span></button></li>
250 </ol>
251 </div>
252
253 <div class="why-panels">
254 <article class="why-panel" id="why-panel-0" role="tabpanel" data-index="0" hidden>
255 <h3 class="why-panel-title">Design that knows who it's for.</h3>
256 <p class="why-panel-body">Most AI tools one-shot a plausible-looking mock. Impeccable starts with a conversation: audience, brand personality, anti-references, aesthetic direction. It captures the answer in <code>PRODUCT.md</code> and <code>DESIGN.md</code> and loads them on every command. The output is design that fits the actual business, not a generic impression of one.</p>
257 <div class="why-visual why-visual--productmd">
258 <div class="why-productmd-file">
259 <div class="why-productmd-header">
260 <span class="why-productmd-filename">PRODUCT.md</span>
261 <span class="why-productmd-status">Loaded on every command</span>
262 </div>
263 <div class="why-productmd-body">
264 <div class="why-productmd-field">
265 <span class="why-productmd-k">Users</span>
266 <span class="why-productmd-v">SREs on call, reading fast, often in the dark.</span>
267 </div>
268 <div class="why-productmd-field">
269 <span class="why-productmd-k">Register</span>
270 <span class="why-productmd-v">Product. Design serves the task.</span>
271 </div>
272 <div class="why-productmd-field">
273 <span class="why-productmd-k">Brand voice</span>
274 <span class="why-productmd-v">Calm, clinical, no hype.</span>
275 </div>
276 <div class="why-productmd-field">
277 <span class="why-productmd-k">Anti-references</span>
278 <span class="why-productmd-v">Purple gradients. Glassmorphism. "Boost your productivity."</span>
279 </div>
280 </div>
281 </div>
282 <aside class="why-productmd-commands">
283 <span class="why-productmd-commands-label">Commands</span>
284 <code>/impeccable teach</code>
285 <code>/impeccable document</code>
286 <code>/impeccable shape</code>
287 </aside>
288 </div>
289 </article>
290
291 <article class="why-panel why-panel--vizfirst is-active" id="why-panel-vz" role="tabpanel" data-index="vz">
292 <h3 class="why-panel-title">Picture it. Build it. Ship the page.</h3>
293 <p class="why-panel-body">Neo Mirai started as generated reference images: a brand toolkit and a hi-fi conference mock. <code>/impeccable craft</code> turned them into a real responsive website, then iterated in the browser until the live page matched the direction.</p>
294 <div class="why-visual why-visual--vizfirst">
295 <figure class="why-vz-plate why-vz-plate--hifi">
296 <span class="why-vz-plate-kind">01 · Visualize</span>
297 <a class="why-vz-plate-frame" href="/cases/neo-mirai" aria-label="Read the Neo Mirai case study">
298 <img src="assets/openai_image_2_hifi.jpg" alt="Auto-generated hi-fi landing-page mock in editorial warm-paper style." loading="lazy" width="864" height="1821" />
299 </a>
300 </figure>
301 <figure class="why-vz-plate why-vz-plate--brand">
302 <span class="why-vz-plate-kind">02 · Shape</span>
303 <a class="why-vz-plate-frame" href="/cases/neo-mirai" aria-label="Read the Neo Mirai case study">
304 <img src="assets/openai_image_2_brand.jpg" alt="Auto-generated brand toolkit: identity lockups, palette, type, icon system, and application mocks for a fictional AI design conference." loading="lazy" width="1536" height="1024" />
305 </a>
306 </figure>
307 <figure class="why-vz-plate why-vz-plate--live">
308 <span class="why-vz-plate-kind">03 · Live build</span>
309 <a class="why-vz-plate-frame" href="/neo-mirai/" aria-label="Open the Neo Mirai live build">
310 <img src="assets/cases/neo-mirai/live-fold.png" alt="Finished Neo Mirai website hero and agenda, implemented from the generated conference mock." loading="lazy" width="1440" height="1100" />
311 </a>
312 </figure>
313 </div>
314 <p class="why-panel-meta">A generated reference became shipped HTML, CSS, assets, responsive fixes, and interaction polish. · <a href="/cases/neo-mirai">Read the case →</a> · <a href="/neo-mirai/">Open the live build →</a></p>
315 </article>
316
317 <article class="why-panel why-panel--antidote" id="why-panel-1" role="tabpanel" data-index="1" hidden>
318 <h3 class="why-panel-title">Every model learned from the same slop.</h3>
319 <p class="why-panel-body">Without intervention, they all produce the same predictable mistakes: purple gradients, nested cards, gradient text, low-contrast labels. Impeccable names 25 of them, detects them in your code and in the browser, and teaches the AI to avoid them.</p>
320 <div class="why-visual why-visual--antidote">
321 <div class="patterns-tabbed" id="patterns-categories">
322 <!-- Rendered by app.js from /api/patterns -->
323 </div>
324 <div class="gallery-stack-container">
325 <div class="gallery-stack-header">
326 <h4 class="gallery-stack-title">Gallery of Shame</h4>
327 <button class="gallery-stack-btn gallery-stack-prev" aria-label="Previous">←</button>
328 <button class="gallery-stack-btn gallery-stack-next" aria-label="Next">→</button>
329 </div>
330 <div class="gallery-stack" id="gallery-stack">
331 <a href="/antipattern-examples/purple-gradients.html" class="gallery-stack-card">
332 <img src="antipattern-images/purple-gradients.png" alt="Purple gradient UI" loading="lazy">
333 <span class="gallery-stack-label">Purple Gradients</span>
334 </a>
335 <a href="/antipattern-examples/thick-border-cards.html" class="gallery-stack-card">
336 <img src="antipattern-images/thick-border-cards.png" alt="Thick border accent cards" loading="lazy">
337 <span class="gallery-stack-label">Side-Tab Cards</span>
338 </a>
339 <a href="/antipattern-examples/cardocalypse.html" class="gallery-stack-card">
340 <img src="antipattern-images/cardocalypse.png" alt="Cards nested inside cards" loading="lazy">
341 <span class="gallery-stack-label">Cardocalypse</span>
342 </a>
343 <a href="/antipattern-examples/inter-everywhere.html" class="gallery-stack-card">
344 <img src="antipattern-images/inter-everywhere.png" alt="Inter font everywhere" loading="lazy">
345 <span class="gallery-stack-label">Inter Everywhere</span>
346 </a>
347 <a href="/antipattern-examples/layout-templates.html" class="gallery-stack-card">
348 <img src="antipattern-images/layout-templates.png" alt="Generic layout templates" loading="lazy">
349 <span class="gallery-stack-label">Template Layouts</span>
350 </a>
351 <a href="/antipattern-examples/bad-contrast.html" class="gallery-stack-card">
352 <img src="antipattern-images/bad-contrast.png" alt="Low contrast text" loading="lazy">
353 <span class="gallery-stack-label">Bad Contrast</span>
354 </a>
355 </div>
356 <a class="gallery-stack-link" href="/slop">Browse the full catalog →</a>
357 </div>
358 </div>
359 </article>
360
361 <article class="why-panel" id="why-panel-2" role="tabpanel" data-index="2" hidden>
362 <h3 class="why-panel-title">Built to live in your production codebase.</h3>
363 <p class="why-panel-body">Impeccable reads your existing tokens, components, and rendered output. It polishes what's there, flags regressions, and stays inside your design system instead of inventing a new one each run.</p>
364 <div class="why-visual why-visual--terminal">
365 <div class="why-terminal">
366 <div class="why-terminal-header">
367 <span class="why-terminal-dot"></span>
368 <span class="why-terminal-dot"></span>
369 <span class="why-terminal-dot"></span>
370 <span class="why-terminal-title">/impeccable polish : scanning codebase</span>
371 </div>
372 <div class="why-terminal-body">
373 <div class="why-terminal-line why-terminal-line--prompt"><span class="why-terminal-prompt">›</span> Walking src/…</div>
374 <div class="why-terminal-line"> <span class="why-terminal-ok">✓</span> <span class="why-terminal-path">src/styles/tokens.css</span> <span class="why-terminal-meta">14 colors, 6 font sizes, 7 spacing steps</span></div>
375 <div class="why-terminal-line"> <span class="why-terminal-ok">✓</span> <span class="why-terminal-path">tailwind.config.ts</span> <span class="why-terminal-meta">theme.extend merged</span></div>
376 <div class="why-terminal-line"> <span class="why-terminal-ok">✓</span> <span class="why-terminal-path">src/components/</span> <span class="why-terminal-meta">34 components</span></div>
377 <div class="why-terminal-line"> <span class="why-terminal-meta">· Button: primary, secondary, ghost, destructive</span></div>
378 <div class="why-terminal-line"> <span class="why-terminal-meta">· Card: 3 variants, 8px / 16px radii</span></div>
379 <div class="why-terminal-line"> <span class="why-terminal-meta">· Input, Select, Dialog, Toast, Table…</span></div>
380 <div class="why-terminal-line"> <span class="why-terminal-ok">✓</span> <span class="why-terminal-path">DESIGN.md</span> <span class="why-terminal-meta">brand rules loaded</span></div>
381 <div class="why-terminal-line why-terminal-line--hint"><span class="why-terminal-arrow">→</span> Matching your system. Not inventing one.</div>
382 </div>
383 </div>
384 </div>
385 <p class="why-panel-meta">Scans your tokens, respects your components, grows with your system.</p>
386 </article>
387
388 <article class="why-panel" id="why-panel-3" role="tabpanel" data-index="3" hidden>
389 <h3 class="why-panel-title">Brand work is not product UI.</h3>
390 <p class="why-panel-body">Most design skills, including Anthropic's own frontend-design skill, collapse everything into one vocabulary. But a landing page and a dashboard live by contradictory rules. Impeccable runs in two modes: <em>brand</em> (design IS the product: marketing, portfolios, editorial) and <em>product</em> (design SERVES the product: app UI, tools, dashboards). Commands like <code>typeset</code>, <code>animate</code>, <code>colorize</code>, <code>bolder</code>, <code>quieter</code>, <code>layout</code>, and <code>delight</code> adjust their choices to match.</p>
391 <div class="why-visual why-visual--registers">
392 <div class="why-register why-register--brand">
393 <span class="why-register-label">Brand mode</span>
394 <div class="why-register-mock why-register-mock--brand">
395 <span class="why-brand-hero-mono">Issue 04</span>
396 <div class="why-brand-hero-title"><em>Shape</em> the story.</div>
397 </div>
398 </div>
399 <div class="why-register why-register--product">
400 <span class="why-register-label">Product mode</span>
401 <div class="why-register-mock why-register-mock--product">
402 <div class="why-product-row"><span class="why-product-k">Users</span><span class="why-product-v">12,482</span></div>
403 <div class="why-product-row"><span class="why-product-k">Active now</span><span class="why-product-v">1,207</span></div>
404 <div class="why-product-row"><span class="why-product-k">Conversion</span><span class="why-product-v">4.8%</span></div>
405 </div>
406 </div>
407 </div>
408 <p class="why-panel-meta">The mode is inferred from your task and confirmed in <code>PRODUCT.md</code>.</p>
409 </article>
410
411 <article class="why-panel" id="why-panel-4" role="tabpanel" data-index="4" hidden>
412 <h3 class="why-panel-title">Design where the work actually happens.</h3>
413 <p class="why-panel-body">The waterfall era (designer in canvas, throws a mock over the wall) is over. Most product work now starts directly in Claude Code, Cursor, Codex, Gemini, or Copilot, on the real codebase, in the browser. Impeccable runs there. No canvas. No handoff. Open your AI harness, type a command, ship the change.</p>
414 <div class="why-visual why-visual--v2">
415 <div class="v2-side v2-side--old">
416 <span class="v2-label">The old way</span>
417 <div class="v2-canvas-chrome">
418 <span class="v2-canvas-tool">Move</span>
419 <span class="v2-canvas-tool">Frame</span>
420 <span class="v2-canvas-tool">Comment</span>
421 </div>
422 <div class="v2-canvas-art">
423 <span class="v2-canvas-file">Checkout v7 (final) final FINAL.fig</span>
424 <div class="v2-canvas-mock"></div>
425 <span class="v2-canvas-stamp">last touched Q3 2025</span>
426 </div>
427 </div>
428 <div class="v2-side v2-side--new">
429 <span class="v2-label">With Impeccable</span>
430 <div class="v2-new-surface">
431 <div class="v2-new-line">impeccable craft checkout</div>
432 <div class="v2-new-browser">
433 <div class="v2-new-browser-dots">
434 <span class="v2-new-browser-dot"></span>
435 <span class="v2-new-browser-dot"></span>
436 <span class="v2-new-browser-dot"></span>
437 </div>
438 <div class="v2-new-browser-frame"></div>
439 </div>
440 <span class="v2-new-bar">pick · prompt · accept</span>
441 </div>
442 </div>
443 </div>
444 </article>
445
446 <article class="why-panel" id="why-panel-5" role="tabpanel" data-index="5" hidden>
447 <h3 class="why-panel-title">Your design system in a portable file.</h3>
448 <p class="why-panel-body"><code>/impeccable document</code> scans your codebase and writes a <code>DESIGN.md</code> that follows the <a href="https://stitch.withgoogle.com/docs/design-md/format/" target="_blank" rel="noopener">Google Stitch DESIGN.md format</a>, the emerging standard. Six fixed sections in a fixed order, parseable by every other DESIGN.md-aware tool. Your visual system travels. Impeccable also consumes DESIGN.md on every command, so it stays on brand without being told twice.</p>
449 <div class="why-visual why-visual--designmd-v2">
450 <div class="why-dm-header">
451 <span class="why-dm-filename">DESIGN.md</span>
452 <span class="why-dm-badge">Google Stitch spec</span>
453 </div>
454 <div class="why-dm-grid">
455 <div class="why-dm-tile why-dm-tile--color" style="--c: oklch(60% 0.25 350);">
456 <div class="why-dm-tile-meta"><span>Accent</span><span>oklch(60% .25 350)</span></div>
457 <div class="why-dm-color-hero"></div>
458 <div class="why-dm-color-ramp">
459 <span style="background: oklch(20% .25 350)"></span>
460 <span style="background: oklch(32% .25 350)"></span>
461 <span style="background: oklch(44% .25 350)"></span>
462 <span style="background: oklch(56% .25 350)"></span>
463 <span style="background: oklch(68% .22 350)"></span>
464 <span style="background: oklch(80% .15 350)"></span>
465 <span style="background: oklch(90% .08 350)"></span>
466 <span style="background: oklch(96% .02 350)"></span>
467 </div>
468 </div>
469 <div class="why-dm-tile why-dm-tile--type">
470 <div class="why-dm-tile-meta"><span>Display</span><span>Italic 400</span></div>
471 <div class="why-dm-type-specimen">Aa</div>
472 <div class="why-dm-type-family">Cormorant Garamond</div>
473 </div>
474 <div class="why-dm-tile why-dm-tile--type">
475 <div class="why-dm-tile-meta"><span>Body</span><span>Regular 400</span></div>
476 <div class="why-dm-type-specimen why-dm-type-specimen--sans">Aa</div>
477 <div class="why-dm-type-family">Instrument Sans</div>
478 </div>
479 <div class="why-dm-tile why-dm-tile--components">
480 <div class="why-dm-tile-meta"><span>Components</span><span>34</span></div>
481 <div class="why-dm-comp-row">
482 <span class="why-dm-comp-chip why-dm-comp-chip--primary">Primary</span>
483 <span class="why-dm-comp-chip">Ghost</span>
484 </div>
485 <div class="why-dm-comp-input">Email address</div>
486 </div>
487 </div>
488 <div class="why-dm-foot">Readable by every DESIGN.md-aware tool.</div>
489 </div>
490 </article>
491
492 <article class="why-panel" id="why-panel-6" role="tabpanel" data-index="6" hidden>
493 <h3 class="why-panel-title">Block AI slop before it ships.</h3>
494 <p class="why-panel-body">Run <code>npx impeccable detect src/</code> on a PR branch and get JSON output with every purple gradient, nested card, low-contrast label, and gradient-text heading caught. Fail the build on severity. 29 deterministic checks, no LLM required, no API key, no flaky scoring. Gate your PRs the same way you gate lint and types.</p>
495 <div class="why-visual why-visual--ci">
496 <div class="why-ci-window">
497 <div class="why-ci-header">
498 <span class="why-ci-branch">feat/pricing-page</span>
499 <span class="why-ci-status why-ci-status--fail">✗ failing</span>
500 </div>
501 <div class="why-ci-body">
502 <div class="why-ci-line"><span class="why-ci-cmd">$</span> npx impeccable detect src/</div>
503 <div class="why-ci-issue"><span class="why-ci-x">✗</span> <code>src/Hero.tsx:42</code> gradient-text</div>
504 <div class="why-ci-issue"><span class="why-ci-x">✗</span> <code>src/Card.tsx:8</code> side-stripe-border</div>
505 <div class="why-ci-issue"><span class="why-ci-x">✗</span> <code>src/Button.tsx:17</code> ai-color-palette</div>
506 <div class="why-ci-summary">3 anti-patterns · exit 1</div>
507 </div>
508 </div>
509 </div>
510 <p class="why-panel-meta">29 rules · <code>--json</code> · <code>--fast</code> · exit codes for CI.</p>
511 </article>
512
513 <article class="why-panel" id="why-panel-7" role="tabpanel" data-index="7" hidden>
514 <h3 class="why-panel-title">One click on any site.</h3>
515 <p class="why-panel-body">The Impeccable Chrome extension runs the same 25-rule detector on every page you visit, in-browser, with zero setup. Audit your own staging. Audit the design your PM showed in Slack. Audit your competitor on a Tuesday. The overlay highlights each issue in place so you never have to map a JSON report back to a DOM node.</p>
516 <div class="why-visual why-visual--extension">
517 <div class="why-browser">
518 <div class="why-browser-chrome">
519 <span class="why-browser-dot"></span>
520 <span class="why-browser-dot"></span>
521 <span class="why-browser-dot"></span>
522 <span class="why-browser-url">example.com</span>
523 </div>
524 <div class="why-browser-body">
525 <div class="why-ext-popup">
526 <div class="why-ext-popup-header">Impeccable · 4 issues</div>
527 <div class="why-ext-popup-row"><span class="why-ext-sev">✗</span>Purple gradient hero</div>
528 <div class="why-ext-popup-row"><span class="why-ext-sev">✗</span>Low contrast label</div>
529 <div class="why-ext-popup-row"><span class="why-ext-sev">✗</span>Nested card</div>
530 <div class="why-ext-popup-row"><span class="why-ext-sev">✗</span>Gradient text heading</div>
531 </div>
532 <div class="why-ext-overlay-a"></div>
533 <div class="why-ext-overlay-b"></div>
534 </div>
535 </div>
536 </div>
537 <p class="why-panel-meta"><a href="https://chromewebstore.google.com/detail/impeccable/bdkgmiklpdmaojlpflclinlofgjfpabf" target="_blank" rel="noopener">Install from the Chrome Web Store →</a></p>
538 </article>
539 </div>
540 </div>
541 </div>
542 </section>
543
544 <!-- 05. LIVE MODE - Interactive demo -->
545 <section class="live-section" id="live-mode">
546 <div class="section-header" data-reveal>
547 <span class="section-number">04</span>
548 <h2 class="section-title">Live Mode <span class="beta-badge">ALPHA</span></h2>
549 </div>
550 <div class="live-content" data-reveal>
551 <p class="section-lead">Pick any element in the browser. Drop a comment or a stroke. Hit Go. Three production-quality variants swap in via your framework's HMR. Accept the one you want and it writes back to source.</p>
552
553 <div class="live-demo" id="live-demo" aria-label="Live Mode interactive demo loop">
554 <div class="live-demo-frame-col"><div class="live-demo-frame">
555 <div class="live-demo-chrome">
556 <span class="live-demo-dot"></span>
557 <span class="live-demo-dot"></span>
558 <span class="live-demo-dot"></span>
559 <span class="live-demo-url">localhost:3000</span>
560 </div>
561
562 <div class="live-demo-stage">
563 <!-- Skeleton: the rest of the page around the target card -->
564 <div class="live-demo-skeleton" aria-hidden="true">
565 <div class="live-demo-skel-nav">
566 <span class="live-demo-skel-logo"></span>
567 <span class="live-demo-skel-link"></span>
568 <span class="live-demo-skel-link"></span>
569 <span class="live-demo-skel-link"></span>
570 <span class="live-demo-skel-cta"></span>
571 </div>
572 <div class="live-demo-skel-heading"></div>
573 <div class="live-demo-skel-line"></div>
574 <div class="live-demo-skel-line live-demo-skel-line--short"></div>
575 </div>
576
577 <!-- Target element that gets picked + iterated -->
578 <div class="live-demo-target" data-demo-target>
579 <div class="live-demo-variant is-active" data-variant="original">
580 <div class="live-demo-card live-demo-card--plain">
581 <span class="live-demo-card-kicker">Newsletter</span>
582 <h3>Subscribe for updates</h3>
583 <p>Monthly-ish design notes.</p>
584 <button type="button">Subscribe</button>
585 </div>
586 </div>
587 <div class="live-demo-variant" data-variant="1">
588 <div class="live-demo-card live-demo-card--v1">
589 <span class="live-demo-card-kicker">No. 04</span>
590 <h3>Letters, <em>occasionally</em>.</h3>
591 <p>A postcard from the editor, about once a month. No tracking pixels, no "just checking in."</p>
592 <button type="button">Send me one</button>
593 </div>
594 </div>
595 <div class="live-demo-variant" data-variant="2">
596 <div class="live-demo-card live-demo-card--v2">
597 <div class="live-demo-card-stamp">☞</div>
598 <span class="live-demo-card-kicker">Dispatch</span>
599 <h3>Design notes, <br>every other<br>Thursday.</h3>
600 <button type="button">Join the list →</button>
601 </div>
602 </div>
603 <div class="live-demo-variant" data-variant="3">
604 <div class="live-demo-card live-demo-card--v3">
605 <div class="live-demo-card-sticker"><span>☆</span><span>☆</span><span>☆</span></div>
606 <span class="live-demo-card-kicker">Field Notes</span>
607 <h3>A monthly letter, for people who still read email for pleasure.</h3>
608 <button type="button">Receive the letter <span aria-hidden="true">✺</span></button>
609 </div>
610 </div>
611 </div>
612
613 <!-- Highlight rectangle that outlines the target -->
614 <div class="live-demo-outline" data-demo-outline aria-hidden="true"></div>
615
616 <!-- Annotation layer (stroke + comment) drawn on the page -->
617 <div class="live-demo-annotations" data-demo-annotations aria-hidden="true">
618 <svg class="live-demo-stroke" viewBox="0 0 300 60" preserveAspectRatio="none" aria-hidden="true">
619 <path d="M 10,40 Q 60,10 110,38 T 210,32 T 290,20" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" pathLength="1"/>
620 </svg>
621 <div class="live-demo-comment">more playful</div>
622 </div>
623
624 <!-- Contextual bar (LIGHT pill, floats near the picked element) -->
625 <div class="live-demo-ctx" data-demo-ctx data-phase="hidden">
626 <div class="live-demo-ctx-row live-demo-ctx-row--configure">
627 <button type="button" class="live-demo-ctx-pill" data-demo-ctx-pill>
628 <span data-demo-cmd-name>delight</span>
629 <span class="live-demo-ctx-pill-caret" aria-hidden="true">▾</span>
630 </button>
631 <span class="live-demo-ctx-input" data-demo-input>
632 <span data-demo-input-text></span><span class="live-demo-ctx-caret"></span>
633 </span>
634 <button type="button" class="live-demo-ctx-count">×3</button>
635 <button type="button" class="live-demo-ctx-go" data-demo-go>Go <span aria-hidden="true">→</span></button>
636 </div>
637 <div class="live-demo-ctx-row live-demo-ctx-row--generating">
638 <span class="live-demo-ctx-spinner" aria-hidden="true"></span>
639 <span>Generating variants…</span>
640 </div>
641 <div class="live-demo-ctx-row live-demo-ctx-row--cycling">
642 <button type="button" class="live-demo-ctx-nav" aria-label="Previous variant">‹</button>
643 <span class="live-demo-ctx-counter" data-demo-counter>1 / 3</span>
644 <button type="button" class="live-demo-ctx-nav" aria-label="Next variant">›</button>
645 <span class="live-demo-ctx-divider"></span>
646 <button type="button" class="live-demo-ctx-discard" aria-label="Discard">✕</button>
647 <button type="button" class="live-demo-ctx-accept" data-demo-accept>Accept</button>
648 </div>
649 <div class="live-demo-ctx-row live-demo-ctx-row--accepted">
650 <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><polyline points="20 6 9 17 4 12"/></svg>
651 <span>Variant 3 written to source</span>
652 </div>
653 </div>
654
655 <!-- Simulated cursor -->
656 <div class="live-demo-cursor" data-demo-cursor aria-hidden="true">
657 <svg width="18" height="22" viewBox="0 0 18 22" fill="none">
658 <path d="M1 1 L1 17 L5 13 L8 20 L11 19 L7.5 12 L13 12 Z" fill="#111" stroke="#fff" stroke-width="1.2" stroke-linejoin="round"/>
659 </svg>
660 </div>
661 </div>
662
663 <!-- Global bar: persistent dark pill at the bottom of every session -->
664 <div class="live-demo-gbar" data-demo-gbar>
665 <span class="live-demo-gbar-brand">/</span>
666 <button type="button" class="live-demo-gbar-btn is-active" data-demo-gbar-pick>
667 <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="12" cy="12" r="10"/><line x1="22" y1="12" x2="18" y2="12"/><line x1="6" y1="12" x2="2" y2="12"/><line x1="12" y1="6" x2="12" y2="2"/><line x1="12" y1="22" x2="12" y2="18"/></svg>
668 <span>Pick</span>
669 </button>
670 <button type="button" class="live-demo-gbar-btn">
671 <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M1 12s4-8 11-8 11 8 11 8-4 8-11 8-11-8-11-8z"/><circle cx="12" cy="12" r="3"/></svg>
672 </button>
673 <button type="button" class="live-demo-gbar-btn">
674 <span class="live-demo-gbar-dmd" aria-hidden="true"><span></span><span></span><span></span><span></span></span>
675 </button>
676 <span class="live-demo-gbar-divider"></span>
677 <button type="button" class="live-demo-gbar-x" aria-label="Exit live mode">✕</button>
678 </div>
679 </div>
680
681 </div>
682
683 <!-- Supporting list sits to the right of the frame on desktop -->
684 <div class="live-demo-support">
685 <div class="live-demo-support-cell">
686 <span class="live-demo-support-k">Start</span>
687 <span class="live-demo-support-v"><code>/impeccable live</code> to open, then stop live mode when you're done. That's the whole invocation.</span>
688 </div>
689 <div class="live-demo-support-cell">
690 <span class="live-demo-support-k">Your agent, your code</span>
691 <span class="live-demo-support-v">The same AI you've been working with, reading your real project context. Variants are generated as actual edits, not mocks.</span>
692 </div>
693 <div class="live-demo-support-cell">
694 <span class="live-demo-support-k">Accept = write</span>
695 <span class="live-demo-support-v">An accepted variant lands in your source file. Canvas-like iteration, production output.</span>
696 </div>
697 <div class="live-demo-support-cell">
698 <span class="live-demo-support-k">Skill-native</span>
699 <span class="live-demo-support-v">No external tools or IDE extensions. Works across Claude Code, Cursor, Codex, Gemini, and every harness the skill targets.</span>
700 </div>
701 </div>
702 </div>
703 </div>
704 </section>
705
706 <!-- 05. GET STARTED -->
707 <section class="platforms-section" id="downloads">
708 <div class="section-header" data-reveal>
709 <span class="section-number">05</span>
710 <h2 class="section-title">Get Started</h2>
711 </div>
712
713 <!-- Row 1: Primary install + How to use (50/50 split) -->
714 <div class="install-row-primary" data-reveal>
715 <!-- Left: Install the skill and CLI -->
716 <div class="install-primary-main">
717 <h3 class="install-path-title"><span class="install-path-step">1</span>Install the skill</h3>
718 <p class="install-path-desc">One agent skill that teaches your AI to design, with 23 commands bundled inside. Works in every major AI coding harness.</p>
719
720 <div class="install-path-terminal">
721 <div class="glass-terminal">
722 <div class="terminal-header">
723 <span class="terminal-dot red"></span>
724 <span class="terminal-dot yellow"></span>
725 <span class="terminal-dot green"></span>
726 </div>
727 <div class="terminal-body">
728 <div class="install-terminal-row">
729 <div class="install-terminal-cmd">
730 <span class="terminal-prompt">$</span>
731 <code>npx skills add pbakaus/impeccable</code>
732 <button class="copy-btn" aria-label="Copy command" data-copy="npx skills add pbakaus/impeccable">
733 <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
734 <rect x="9" y="9" width="13" height="13" rx="2" ry="2"></rect>
735 <path d="M5 15H4a2 2 0 01-2-2V4a2 2 0 012-2h9a2 2 0 012 2v1"></path>
736 </svg>
737 </button>
738 </div>
739 <span class="install-terminal-note">Works with Cursor, Claude Code, Gemini CLI, Codex CLI, and more.</span>
740 </div>
741 </div>
742 </div>
743 </div>
744
745 <!-- Other install methods, collapsed by default -->
746 <details class="install-primary-alts">
747 <summary class="install-alts-summary">
748 <span class="install-alts-label">Other install methods</span>
749 <svg class="install-alts-arrow" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" aria-hidden="true"><path d="M9 6l6 6-6 6"/></svg>
750 </summary>
751
752 <div class="install-alt-method">
753 <span class="install-alt-label">Claude Code plugin</span>
754 <div class="install-terminal-cmd">
755 <span class="terminal-prompt">$</span>
756 <code>/plugin marketplace add pbakaus/impeccable</code>
757 <button class="copy-btn" aria-label="Copy command" data-copy="/plugin marketplace add pbakaus/impeccable">
758 <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
759 <rect x="9" y="9" width="13" height="13" rx="2" ry="2"></rect>
760 <path d="M5 15H4a2 2 0 01-2-2V4a2 2 0 012-2h9a2 2 0 012 2v1"></path>
761 </svg>
762 </button>
763 </div>
764 <span class="install-alt-note">Then open <code>/plugin</code> in Claude Code</span>
765 </div>
766
767 <div class="install-alt-method">
768 <span class="install-alt-label">Manual download <span class="install-alt-sublabel">all 12 providers</span></span>
769 <button class="install-zip-link" data-bundle="universal" aria-label="Download universal zip">
770 <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" aria-hidden="true">
771 <path d="M21 15v4a2 2 0 01-2 2H5a2 2 0 01-2-2v-4M7 10l5 5 5-5M12 15V3"/>
772 </svg>
773 <span class="install-zip-link-name">Download universal zip</span>
774 <span class="install-zip-link-examples"><code>/impeccable polish</code> <code>/impeccable audit</code></span>
775 </button>
776 </div>
777 </details>
778 </div>
779
780 <!-- Right: How to use -->
781 <div class="install-primary-howto">
782 <h3 class="install-path-title"><span class="install-path-step">2</span>Use it</h3>
783 <p class="install-path-desc">Impeccable gives you a shared design vocabulary with your AI. 23 commands (<em>polish</em>, <em>audit</em>, <em>critique</em>, <em>typeset</em>, and more) that each encode a specific design discipline, so you can steer with precision.</p>
784
785 <dl class="install-howto-rows">
786 <div class="install-howto-row">
787 <dt><code><span class="install-path-slash">/</span>impeccable redo this hero</code></dt>
788 <dd>Let the skill pick the approach. No names to memorize.</dd>
789 </div>
790 <div class="install-howto-row">
791 <dt><code><span class="install-path-slash">/</span>impeccable audit checkout</code></dt>
792 <dd>Reach for a command by name. Type <code><span class="install-path-slash">/</span>impeccable</code> alone to see all 23.</dd>
793 </div>
794 <div class="install-howto-row">
795 <dt><code><span class="install-path-slash">/</span>impeccable pin audit</code></dt>
796 <dd>Pin your favorites. <code><span class="install-path-slash">/</span>audit</code> becomes a standalone shortcut.</dd>
797 </div>
798 </dl>
799
800 <div class="install-howto-footer">
801 <a href="/tutorials/getting-started" class="install-howto-link">Full walkthrough <span aria-hidden="true">→</span></a>
802 <a href="/docs" class="install-howto-link">Browse the vocabulary <span aria-hidden="true">→</span></a>
803 </div>
804 </div>
805 </div>
806
807 <!-- Steps 3-4: vertical accordion, mutually exclusive (only one open at a time) -->
808 <div class="install-accordion" data-reveal>
809 <!-- Step 3: Chrome extension -->
810 <details name="install-steps" class="install-step">
811 <summary class="install-step-summary">
812 <h3 class="install-path-title"><span class="install-path-step">3</span>Add the Chrome extension <span class="install-path-badge install-path-badge-muted">Optional</span></h3>
813 <svg class="install-step-arrow" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" aria-hidden="true"><path d="M9 6l6 6-6 6"/></svg>
814 </summary>
815 <div class="install-step-body">
816 <p class="install-path-desc">Click the toolbar icon on any page and every anti-pattern lights up right where it lives. Catches gradient text, AI color palettes, nested cards, low contrast, and 20+ more rules. Works on localhost, staging, production, or anyone else's site.</p>
817
818 <div class="install-tool install-tool--solo">
819 <a href="https://chromewebstore.google.com/detail/impeccable/bdkgmiklpdmaojlpflclinlofgjfpabf" target="_blank" rel="noopener" class="install-tool-preview" aria-label="Install Impeccable from the Chrome Web Store">
820 <img src="assets/extension-detection.png" alt="Screenshot of the Impeccable Chrome extension highlighting anti-patterns on a webpage" width="600" height="508" loading="lazy">
821 <span class="install-tool-preview-caption">Live detection on any webpage</span>
822 </a>
823 <a href="https://chromewebstore.google.com/detail/impeccable/bdkgmiklpdmaojlpflclinlofgjfpabf" target="_blank" rel="noopener" class="btn btn-primary install-tool-cta">
824 <span>Install from Chrome Web Store →</span>
825 </a>
826 </div>
827 </div>
828 </details>
829
830 <!-- Step 4: Install the CLI -->
831 <details name="install-steps" class="install-step">
832 <summary class="install-step-summary">
833 <h3 class="install-path-title"><span class="install-path-step">4</span>Install the CLI <span class="install-path-badge install-path-badge-muted">Optional</span></h3>
834 <svg class="install-step-arrow" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" aria-hidden="true"><path d="M9 6l6 6-6 6"/></svg>
835 </summary>
836 <div class="install-step-body">
837 <p class="install-path-desc">Run anti-pattern scans outside the skill: in CI, in a PR check, or against a whole directory. 29 deterministic rules, no LLM required, JSON output ready for build gates.</p>
838
839 <div class="install-cmd-block">
840 <div class="install-cmd-line">
841 <span class="terminal-prompt">$</span>
842 <code>npm i -g impeccable</code>
843 <button class="copy-btn" aria-label="Copy command" data-copy="npm i -g impeccable">
844 <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
845 <rect x="9" y="9" width="13" height="13" rx="2" ry="2"></rect>
846 <path d="M5 15H4a2 2 0 01-2-2V4a2 2 0 012-2h9a2 2 0 012 2v1"></path>
847 </svg>
848 </button>
849 </div>
850 <span class="install-cmd-note">Then <code>impeccable detect src/</code> to scan a project, or <code>npx impeccable detect</code> without installing. <a href="https://www.npmjs.com/package/impeccable" target="_blank" rel="noopener">View on npm →</a></span>
851 </div>
852 </div>
853 </details>
854
855 <!-- Step 5: Stay updated -->
856 <details name="install-steps" class="install-step">
857 <summary class="install-step-summary">
858 <h3 class="install-path-title"><span class="install-path-step">5</span>Stay updated</h3>
859 <svg class="install-step-arrow" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" aria-hidden="true"><path d="M9 6l6 6-6 6"/></svg>
860 </summary>
861 <div class="install-step-body">
862 <p class="install-path-desc">Keep skills current and follow along with new commands, anti-patterns, and the design thinking behind Impeccable.</p>
863
864 <div class="install-cmd-block">
865 <div class="install-cmd-line">
866 <span class="terminal-prompt">$</span>
867 <code>npx impeccable skills update</code>
868 <button class="copy-btn" aria-label="Copy command" data-copy="npx impeccable skills update">
869 <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
870 <rect x="9" y="9" width="13" height="13" rx="2" ry="2"></rect>
871 <path d="M5 15H4a2 2 0 01-2-2V4a2 2 0 012-2h9a2 2 0 012 2v1"></path>
872 </svg>
873 </button>
874 </div>
875 <span class="install-cmd-note">Run periodically to pull the latest skill definitions.</span>
876 </div>
877
878 <div class="install-updated-subscribe">
879 <iframe class="install-updated-substack" src="https://impeccablestyle.substack.com/embed" width="100%" height="130" frameborder="0" scrolling="no"></iframe>
880 <a href="https://x.com/impeccable_ai" class="install-updated-x" target="_blank" rel="noopener">
881 <svg class="install-updated-x-icon" width="22" height="22" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M18.244 2.25h3.308l-7.227 8.26 8.502 11.24H16.17l-5.214-6.817L4.99 21.75H1.68l7.73-8.835L1.254 2.25H8.08l4.713 6.231zm-1.161 17.52h1.833L7.084 4.126H5.117z"/></svg>
882 <span class="install-updated-x-label">Follow on X</span>
883 <span class="install-updated-x-handle">@impeccable_ai</span>
884 </a>
885 </div>
886 </div>
887 </details>
888 </div>
889 </section>
890
891 <!-- 5+6. CHANGELOG + FAQ (side-by-side on desktop) -->
892 <div class="changelog-faq-row">
893 <!-- 5. CHANGELOG -->
894 <section class="changelog-section" id="changelog">
895 <div class="section-header" data-reveal>
896 <span class="section-number">06</span>
897 <h2 class="section-title">What's New</h2>
898 </div>
899
900 <div class="changelog-highlights" data-reveal>
901 <p class="changelog-highlights-label">Highlights since v3.0 <span class="changelog-date">April 10 – May 13, 2026</span></p>
902 <ul class="changelog-items">
903 <li><strong>Live mode preserves identity by default.</strong> Variants stay on-brand for the existing surface and explore different expression axes within that identity. Departure from the current aesthetic only triggers when PRODUCT.md anti-references explicitly reject the current surface, or the user asks for it. Departure directions derive from brand voice, not a fixed catalog.</li>
904 <li><strong>Detector flags the new monoculture.</strong> The overused-font rule now catches Fraunces, Geist, Mona Sans, Plus Jakarta Sans, Space Grotesk, Recoleta, and Instrument Sans. Contrast checks run on styled <code><a></code> and <code><button></code> elements. Brand exceptions for Vercel, Next.js, and GitHub on their own domains.</li>
905 <li><strong>Live mode works everywhere.</strong> Strict-CSP apps, modal hosts (Radix, Headless UI, vaul), React/TSX projects, and repeated identical-class siblings all handle cleanly through the wrap, preview, accept, and carbonize loop.</li>
906 <li><strong>PRODUCT.md + DESIGN.md as shared context.</strong> A strategic file (who, what, why) and a visual file (colors, typography, components in the <a href="https://stitch.withgoogle.com/docs/design-md/format/" target="_blank" rel="noopener">Google Stitch format</a>) that every command reads before generating. Created via <code>/impeccable teach</code> and <code>/impeccable document</code>.</li>
907 <li><strong>18 skills became 1 skill with 23 commands.</strong> One <code>/impeccable</code> entry in the menu, shared design vocabulary, and <code>/impeccable pin</code> to promote favorites back as standalone shortcuts.</li>
908 </ul>
909 </div>
910
911 <details class="changelog-older" data-reveal>
912 <summary class="changelog-older-toggle">Full version history</summary>
913 <div class="changelog-older-entries">
914 <div class="changelog-list">
915 <div class="changelog-entry">
916 <div class="changelog-version-header">
917 <span class="changelog-version">v3.1.1</span>
918 <span class="changelog-date">May 14, 2026</span>
919 </div>
920 <ul class="changelog-items">
921 <li><strong><code>/impeccable critique</code> works on Windows.</strong> The CLI entry-point check in <code>critique-storage.mjs</code> compared <code>import.meta.url</code> against a hand-built <code>file://</code> string, which silently failed on Windows because Node returns forward slashes in <code>import.meta.url</code> but backslashes in <code>process.argv[1]</code>. The script exited 0 with no output and the snapshot save was skipped. Switched to <code>pathToFileURL</code>, the standard cross-platform pattern. Reported by <a href="https://github.com/Genmutant" target="_blank" rel="noopener">@Genmutant</a> in <a href="https://github.com/pbakaus/impeccable/issues/155" target="_blank" rel="noopener">#155</a> with a precise side-by-side diagnosis of the path mismatch.</li>
922 </ul>
923 </div>
924
925 <div class="changelog-entry">
926 <div class="changelog-version-header">
927 <span class="changelog-version">v3.1.0</span>
928 <span class="changelog-date">May 13, 2026</span>
929 </div>
930 <ul class="changelog-items">
931 <li><strong>Codex asset producer agent.</strong> A native Codex subagent that produces clean, reusable raster assets from approved Impeccable mock references without redesigning the direction. Preserves silhouette, palette, lighting, and material; strips baked-in UI text and presentation chrome that CSS should own. Codex-only because Codex is the harness with native image generation today. Cross-compile pipeline (<code>skill/agents/</code> -> Codex TOML or Claude Markdown) is in place for future agents.</li>
932 <li><strong>Critique persistence.</strong> Each <code>/impeccable critique</code> run now writes a per-target snapshot to <code>.impeccable/critique/<timestamp>__<slug>.md</code> with score, P0/P1 counts, and full report. <code>/impeccable polish</code> reads the latest matching snapshot as additional signal when invoked on the same target, so you stop re-deriving the backlog. <code>ignore.md</code> at the same path is user-curated; lines there are designer-intended deviations that critique will not re-raise.</li>
933 <li><strong>Codex-specific image flow extracted.</strong> The mock-and-palette workflow lives in <code>reference/codex.md</code> with a palette-first gate (lock the palette before any mocks, so generated comps stop drifting). Craft.md is shorter and cleaner for every non-Codex harness, and Codex gets sharper, denser guidance for the part it can actually do.</li>
934 <li><strong>Detector: new rule + false-positive fixes.</strong> <code>body-text-viewport-edge</code> catches body text running to the absolute viewport edge (29 deterministic rules now). OKLCH and CSS-var resolution improvements remove a class of false positives in modern token-based codebases. Anchor-inheritance fix stops misreading link text inheriting color from a styled parent.</li>
935 <li><strong>Brand register sharpened.</strong> An "inverse test" question now sits up front: describe your page the way a competitor would describe theirs; if that sentence fits the modal landing page in the category, restart. A cultural-symbol palette guardrail catches the lazy pull (reach past the obvious colour, let the cultural reading come from typography and imagery instead).</li>
936 <li><strong>Shape and craft gates strengthened.</strong> Image-gen skips are announced in one line (silent skips let GPT 5.5 quietly elide image work). Brief confirmation is explicit, not assumed. When the harness has native image generation, craft now names the four user gates between shape and code (direction questions, palette generation, mock generation, mock approval) with explicit STOP markers at each, so a compact shape's "confirm or override" stops reading as code-green.</li>
937 <li><strong>Skill prose, image discipline, and detector counts kept honest.</strong> A skill-side prose validator catches em dashes and the worst AI tells in reference instructions. Craft step 3 reads the screenshot back into context after capture (taking is not inspecting). Build validator now ignores changelog history when checking detector counts, so historical "28 rules" references don't false-flag against the current total.</li>
938 </ul>
939 </div>
940
941 <div class="changelog-entry">
942 <div class="changelog-version-header">
943 <span class="changelog-version">v3.0.7</span>
944 <span class="changelog-date">May 4, 2026</span>
945 </div>
946 <ul class="changelog-items">
947 <li><strong>Detector flags italic-serif display heroes.</strong> Oversized italic serif (Fraunces, Recoleta, Newsreader, Playfair, Cormorant, Tiempos) running as the primary hero h1 is now caught as a structural fingerprint of late-2025 and early-2026 AI-generated marketing pages. Editorial and magazine surfaces that legitimately want the pattern can ignore the rule. Contributed by <a href="https://github.com/vinaypokharkar" target="_blank" rel="noopener">@vinaypokharkar</a> in <a href="https://github.com/pbakaus/impeccable/pull/129" target="_blank" rel="noopener">#129</a>.</li>
948 <li><strong>Detector flags hero eyebrow chips.</strong> The uppercase letter-spaced label sitting directly above a hero h1 now fires, including the pill-chip variant (background plus 999px border-radius). Bounded to short labels at small sizes so editorial captions and ordinary subheads do not false-positive. Also contributed by <a href="https://github.com/vinaypokharkar" target="_blank" rel="noopener">@vinaypokharkar</a> in <a href="https://github.com/pbakaus/impeccable/pull/129" target="_blank" rel="noopener">#129</a>.</li>
949 <li><strong>Live mode survives disconnects.</strong> A durable session journal records every event, so an agent crash, a network blip, or a browser refresh no longer loses the session. Three new sub-commands: <code>live status</code> reports current state, <code>live resume</code> rejoins after a break, and <code>live complete</code> finalizes a manually accepted variant. Acknowledgement, polling replies, and fallback recovery all flow through the journal. Contributed by <a href="https://github.com/nqh-packages" target="_blank" rel="noopener">@nqh-packages</a> in <a href="https://github.com/pbakaus/impeccable/pull/125" target="_blank" rel="noopener">#125</a>.</li>
950 <li><strong>Reference files stripped of repetitive scaffolding.</strong> SKILL.md and 33 sub-command files lost the "Remember:" closer chants, the brochure-style "[Verb] [object] to [outcome]" openers on 12 older commands, and 419 em-dashes that obscured the choice between colon, semicolon, period, or parens. Surviving closers hand off to <code>/impeccable polish</code> instead of restating the rules. Less context per command load, less repetition the model has to read past.</li>
951 </ul>
952 </div>
953
954 <div class="changelog-entry">
955 <div class="changelog-version-header">
956 <span class="changelog-version">v3.0.6</span>
957 <span class="changelog-date">April 30, 2026</span>
958 </div>
959 <ul class="changelog-items">
960 <li><strong>Live mode preserves identity by default.</strong> Variants now stay on-brand for the existing surface (same palette, same type pairing, same visual rhetoric) and explore different expression axes within that identity. Departure from the existing aesthetic only triggers when PRODUCT.md anti-references explicitly call out the current surface, or the user asks for it.</li>
961 <li><strong>Departure mode derives from brand voice, not a fixed catalog.</strong> The old lane list (Swiss-grid, Terminal, Industrial-signage, etc.) caused the model to converge on the same three directions every time. Replaced with a brand-voice derivation process: read personality words, imagine physical experiences, derive visual directions. Each run produces directions specific to the brand.</li>
962 <li><strong>Parameters ship consistently on large surfaces.</strong> Planning params is now part of variant planning, not a separate step. The freeform bias aligns with the budget table: 2-3 knobs per variant for heroes and sections, with 0-param heroes flagged as mistakes rather than judgment calls.</li>
963 <li><strong>Reflex-reject aesthetic lanes.</strong> Parallel to the font reflex-reject list in <code>brand.md</code>. Editorial-typographic is the first entry, catching the second-order training reflex where every departure from SaaS-cream defaults to magazine-cover aesthetics.</li>
964 <li><strong>Two-altitude category-reflex check.</strong> The shared design laws now catch both first-order reflexes (theme + palette from category alone) and second-order reflexes (aesthetic family from category + anti-references).</li>
965 </ul>
966 </div>
967
968 <div class="changelog-entry">
969 <div class="changelog-version-header">
970 <span class="changelog-version">Extension v1.0.3</span>
971 <span class="changelog-date">April 29, 2026</span>
972 </div>
973 <ul class="changelog-items">
974 <li><strong>Contrast checks now run on styled buttons.</strong> A styled <code><a></code> or <code><button></code> with its own opaque background was silently skipped by the contrast rule, so a "Get started" pill with charcoal text on a near-black background read as fine to the detector. Buttons with their own background and direct text now flow through the same contrast and palette checks as every other text element. Inline links inside paragraphs continue to skip, as before.</li>
975 </ul>
976 </div>
977
978 <div class="changelog-entry">
979 <div class="changelog-version-header">
980 <span class="changelog-version">Extension v1.0.2</span>
981 <span class="changelog-date">April 29, 2026</span>
982 </div>
983 <ul class="changelog-items">
984 <li><strong>Popup scan no longer hangs after a page reload.</strong> The toolbar-icon flow worked the first time but got stuck on "Scanning…" on subsequent clicks if the page had been reloaded in between. The service worker only cleared its content-script-injected flag when DevTools was open, so the popup-only path saw a stale flag and silently sent its scan request to a tab whose content script had already been wiped. Reset is now unconditional; auto-rescan stays gated to DevTools.</li>
985 <li><strong>Detector flags the new monoculture.</strong> The overused-font rule now catches Fraunces, Geist, Mona Sans, Plus Jakarta Sans, Space Grotesk, Recoleta, and Instrument Sans alongside Inter and the older defaults. Brand exceptions for Vercel, Next.js, and GitHub on their own domains.</li>
986 </ul>
987 </div>
988
989 <div class="changelog-entry">
990 <div class="changelog-version-header">
991 <span class="changelog-version">CLI v2.1.9</span>
992 <span class="changelog-date">May 13, 2026</span>
993 </div>
994 <ul class="changelog-items">
995 <li><strong>New rule: <code>body-text-viewport-edge</code>.</strong> Catches body copy running to the absolute viewport edge with no horizontal padding (a structural AI tell where the model skipped layout and let everything butt against the window). Brings the deterministic rule count to 29.</li>
996 <li><strong>OKLCH and CSS-var resolution.</strong> The contrast and color rules now resolve <code>oklch(...)</code> and <code>var(--token)</code> references through the cascade before evaluating. A class of false positives in Tailwind v4 / shadcn / token-based codebases is gone; previously the resolver bailed on modern syntax and reported nothing or the wrong thing.</li>
997 <li><strong>Anchor inheritance fix.</strong> The contrast rules were misreading <code><a></code> color when the link inherited from a styled parent (e.g. a hero with a non-default text color), flagging real text as low-contrast against itself. Resolution now walks the inheritance chain correctly.</li>
998 <li><strong>Live screenshot overlay no longer flashes solid black during loading.</strong> Pages with no explicit page background painted the overlay backdrop in pure ink for a frame before the screenshot loaded. The overlay now starts transparent and resolves once the bitmap is ready.</li>
999 </ul>
1000 </div>
1001
1002 <div class="changelog-entry">
1003 <div class="changelog-version-header">
1004 <span class="changelog-version">CLI v2.1.8</span>
1005 <span class="changelog-date">April 28, 2026</span>
1006 </div>
1007 <ul class="changelog-items">
1008 <li><strong>Detector runs on Windows.</strong> CLI path resolution used <code>new URL(...).pathname</code>, which prepends a slash to drive letters (<code>/C:/...</code>) and breaks <code>fs</code> on Windows. Switched to <code>fileURLToPath</code> across the board. Reported in <a href="https://github.com/pbakaus/impeccable/issues/95" target="_blank" rel="noopener">#95</a>, contributed by <a href="https://github.com/voidborne-d" target="_blank" rel="noopener">@voidborne-d</a>.</li>
1009 <li><strong>Border-radius detection no longer flickers under jsdom.</strong> The pill-button rule was missing real cases when jsdom returned a percent radius without an explicit width, and over-reporting when CSS shorthand left individual corners unset. The reader now preserves the percent signal and resolves shorthand consistently across the browser and jsdom paths, so CLI scans match what the live overlay sees.</li>
1010 </ul>
1011 </div>
1012
1013 <div class="changelog-entry">
1014 <div class="changelog-version-header">
1015 <span class="changelog-version">v3.0.5</span>
1016 <span class="changelog-date">April 28, 2026</span>
1017 </div>
1018 <ul class="changelog-items">
1019 <li><strong>Live mode lands valid TSX through the wrap → preview → accept → carbonize loop on Vite/Next React/TSX projects.</strong> The wrapper now keeps a single JSX-slot child instead of three adjacent siblings, so it round-trips cleanly inside <code>return (...)</code>, array <code>.map(...)</code>, and <code>asChild</code> parents like Radix's <code><DialogPrimitive.Title></code>. Carbonize stopped double-wrapping CSS in nested template literals on TSX targets, accept and discard restore the picked element at its original indent (with relative depth between lines preserved), and the screenshot overlay no longer flashes solid black on default-background pages. Closes <a href="https://github.com/pbakaus/impeccable/issues/114" target="_blank" rel="noopener">#114</a>, with thanks again to <a href="https://github.com/dergachoff" target="_blank" rel="noopener">@dergachoff</a> for the detailed bug report.</li>
1020 <li><strong>Wrap correctly disambiguates repeated identical-class siblings.</strong> A list of <code><Card className="card"></code> rendered three times with the same classes used to land on the first one regardless of which the user picked. <code>live-wrap.mjs</code> now accepts <code>--text TEXT</code> (the picked element's <code>textContent</code>) and narrows candidates accordingly, falling back to first-match when the text is too short or doesn't appear literally in source (children with interpolated values like <code>{title}</code>), and erroring with <code>element_ambiguous</code> when multiple branches still match equally.</li>
1021 <li><strong><code>live-inject</code> CSP-meta unwrap now byte-for-byte preserves self-closing tag whitespace.</strong> The patch+revert cycle on a <code><meta http-equiv="Content-Security-Policy" ... /></code> tag was eating the space before <code>/></code> via a double-space artifact in the marker insertion path; common Vite shapes that ship a CSP meta now round-trip cleanly.</li>
1022 <li><strong><code>live.md</code> spec gained explicit guidance for three real authoring traps.</strong> Variant CSS must use a descendant combinator (<code>:scope > .card</code>, not bare <code>:scope</code>) or it lands on the wrapper instead of the picked element. JSX <code><style></code> bodies need <code>{`...`}</code> template-literal wrapping. Aborting an in-flight session uses <code>live-poll --reply EVENT_ID error "msg"</code>, not <code>live-accept --discard</code>; the latter only mutates source while the bar stays stuck on GENERATING dots forever.</li>
1023 </ul>
1024 </div>
1025
1026 <div class="changelog-entry">
1027 <div class="changelog-version-header">
1028 <span class="changelog-version">v3.0.4</span>
1029 <span class="changelog-date">April 28, 2026</span>
1030 </div>
1031 <ul class="changelog-items">
1032 <li><strong><code>/impeccable craft</code> now treats approved mocks as visual contracts.</strong> 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.</li>
1033 <li><strong>Image-led brand surfaces can no longer degrade into abstract panels.</strong> 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.</li>
1034 <li><strong><code>/impeccable craft</code> and <code>/impeccable shape</code> hardened against autonomous agents.</strong> 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: <code>shape=pass</code> 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.</li>
1035 <li><strong>Live picker plays nice with modal hosts.</strong> Inside Radix Dialog, Headless UI, vaul, and other portals that lock <code>body { pointer-events: none }</code> 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 <code>pointer-events: auto</code> on themselves. Theme detection also stopped misreading a transparent body as black. Closes <a href="https://github.com/pbakaus/impeccable/issues/113" target="_blank" rel="noopener">#113</a>, with thanks to <a href="https://github.com/dergachoff" target="_blank" rel="noopener">@dergachoff</a> for the thoughtful bug report.</li>
1036 </ul>
1037 </div>
1038
1039 <div class="changelog-entry">
1040 <div class="changelog-version-header">
1041 <span class="changelog-version">v3.0.2</span>
1042 <span class="changelog-date">April 27, 2026</span>
1043 </div>
1044 <ul class="changelog-items">
1045 <li><strong>Claude Code plugin install shrunk by 380×.</strong> The marketplace now ships only the runtime payload (~770 KB) instead of the entire monorepo (291 MB). Plugin source moved from <code>./</code> to <code>./plugin</code>, so the cache no longer copies <code>node_modules</code>, build scripts, tests, or the other harness directories. Reported in <a href="https://github.com/pbakaus/impeccable/issues/107" target="_blank" rel="noopener">#107</a>.</li>
1046 <li><strong>Slash commands now register reliably on Claude Code.</strong> The <code>skills</code> field in <code>plugin.json</code> was missing the trailing slash that the documented schema expects (<code>"./skills/"</code>, not <code>"./skills"</code>), which caused Claude Code's plugin loader to skip command registration on some setups. Reported by three users in <a href="https://github.com/pbakaus/impeccable/issues/86" target="_blank" rel="noopener">#86</a>.</li>
1047 </ul>
1048 </div>
1049
1050 <div class="changelog-entry">
1051 <div class="changelog-version-header">
1052 <span class="changelog-version">v3.0.1</span>
1053 <span class="changelog-date">April 24, 2026</span>
1054 </div>
1055 <ul class="changelog-items">
1056 <li><strong>Live mode runs in strict-CSP apps.</strong> When your HTML carries a Content-Security-Policy meta tag, <code>/impeccable live</code> now silently appends the live-server origin to <code>script-src</code> and <code>connect-src</code> (and <code>blob:</code> to <code>img-src</code> for the screenshot overlay) on session start, and reverts the patch verbatim on stop. Header-based CSP setups still get the existing detect-and-suggest path.</li>
1057 <li><strong>Live mode survives conditional-render content.</strong> Picking an element inside a closed modal, an inactive tab, or a collapsible panel used to wedge live mode when Vite Fast Refresh remounted the parent and reset state. Now: a brief upfront heads-up at pick time, plus a contextual toast after Go ("retrace the path that revealed it") so variants land the moment the element is back in the DOM. No more force-reload that masked the issue.</li>
1058 <li><strong>Live mode no longer breaks JSX projects.</strong> Three round-trip bugs in <code>/impeccable live</code>'s accept path are fixed: the carbonize stash now uses JSX-syntax style attributes and template-literal CSS, and the post-accept rewrite no longer leaks template-literal punctuation into the file. SvelteKit and other frameworks that hydrate after HTML parse now also resume cleanly post-reload.</li>
1059 <li><strong><code>/impeccable polish</code> now a true superset of the retired <code>/normalize</code>.</strong> Aligning to the design system is non-optional, drift is named by root cause (missing token, one-off implementation, or conceptual misalignment), and a new Information Architecture & Flow dimension covers progressive disclosure, established user-flow shapes, and naming consistency. Cosmetic-vs-functional triage helps order work when polish time is short.</li>
1060 </ul>
1061 </div>
1062
1063 <div class="changelog-entry">
1064 <div class="changelog-version-header">
1065 <span class="changelog-version">v3.0</span>
1066 <span class="changelog-date">April 10, 2026</span>
1067 </div>
1068 <ul class="changelog-items">
1069 <li><strong>Live Mode (Alpha).</strong> Run <code>/impeccable live</code> and iterate on your UI in the browser: pick any element, drop a comment or stroke, hit Go, get three production-quality variants swapped in via your framework's HMR, accept the one you want and it writes back to source. Works on Vite, Next.js (including monorepos), SvelteKit, Astro, Nuxt. Detects your project's Content Security Policy and offers a one-time, dev-only patch so it runs in strict-CSP apps too.</li>
1070 <li><strong>Visualize, then build.</strong> Image gen crossed the reference-quality threshold with GPT Image 2, Nano Banana Pro, and Imagen 4 Ultra. <code>/impeccable shape</code> drafts a brand toolkit (color, typography, mood board) as real images; <code>/impeccable craft</code> pre-renders the hi-fi mock to code toward. Strongest in Codex with GPT 5.5.</li>
1071 <li><strong>PRODUCT.md, shared design memory for your AI.</strong> A single file at your project root that names the audience, brand personality, anti-references, and register (brand vs product). Every command reads it before generating, so output stops drifting into generic "modern SaaS" territory and starts sounding like your product. Created in one step via <code>/impeccable teach</code>.</li>
1072 <li><strong>DESIGN.md generation, spec-compliant and interoperable.</strong> <code>/impeccable document</code> scans your tokens, components, and rendered output and writes a DESIGN.md that follows the <a href="https://stitch.withgoogle.com/docs/design-md/format/" target="_blank" rel="noopener">Google Stitch DESIGN.md format</a>. Colors, typography, elevation, components, do's and don'ts, in the exact six sections other DESIGN.md-aware tools expect. Your visual system travels with you.</li>
1073 <li><strong>Brand and product registers.</strong> Design work splits cleanly into two worlds: brand (marketing sites, landing pages, portfolios, where design IS the product) and product (app UI, dashboards, tools, where design SERVES the product). Register-aware commands (<code>typeset</code>, <code>animate</code>, <code>bolder</code>, <code>quieter</code>, <code>colorize</code>, <code>layout</code>, <code>delight</code>) each adjust their vocabulary to match, so brand work isn't critiqued for breaking product-UI conventions and vice versa.</li>
1074 <li><strong>18 skills became 1 skill with 23 commands.</strong> Every command now lives under <code>/impeccable</code>: <code>/impeccable audit</code>, <code>/impeccable polish</code>, <code>/impeccable critique</code>, and the rest. One entry in your <code>/</code> menu instead of 18, a shared design vocabulary between you and your AI, and far less namespace pollution as the plugin ecosystem grows. The autocomplete shows the full list the moment you type <code>/impeccable</code>.</li>
1075 <li><strong>Pin your favorites back as shortcuts.</strong> Run <code>/impeccable pin audit</code> and <code>/audit</code> becomes a standalone command again, without reversing the consolidation. Under the hood it writes a lightweight redirect skill that delegates to <code>/impeccable audit</code>, so updates to the parent skill flow through automatically. <code>/impeccable unpin audit</code> removes it.</li>
1076 </ul>
1077 </div>
1078 </div>
1079 </div>
1080 </details>
1081
1082 <details class="changelog-older">
1083 <summary class="changelog-older-toggle">View older releases</summary>
1084 <div class="changelog-older-entries">
1085 <div class="changelog-entry">
1086 <div class="changelog-version-header">
1087 <span class="changelog-version">v2.1</span>
1088 <span class="changelog-date">April 9, 2026</span>
1089 </div>
1090 <ul class="changelog-items">
1091 <li><strong>Streamlined from 21 to 18 commands.</strong> Removed overlap and confusion: <code>/arrange</code> renamed to <code>/layout</code>, <code>/normalize</code> merged into <code>/polish</code> (design system alignment is now part of the final pass), <code>/onboard</code> merged into <code>/harden</code> (empty states and first-run experiences are part of production readiness), and <code>/extract</code> became <code>/impeccable extract</code> (a sub-mode alongside craft and teach). Every remaining command has a clearly distinct job.</li>
1092 <li><strong>Automatic cleanup of deprecated skills.</strong> On first load after updating, the skill detects and removes leftover files from renamed or merged commands. No manual cleanup needed.</li>
1093 </ul>
1094 </div>
1095
1096 <div class="changelog-entry">
1097 <div class="changelog-version-header">
1098 <span class="changelog-version">v2.0</span>
1099 <span class="changelog-date">April 8, 2026</span>
1100 </div>
1101 <ul class="changelog-items">
1102 <li><strong>Renamed <code>frontend-design</code> to <code>impeccable</code>.</strong> The core skill now shares its name with the project, and the teach subcommand moved from <code>/teach-impeccable</code> to <code>/impeccable teach</code>. One skill, one namespace.</li>
1103 <li><strong>Skill rewritten against evals.</strong> Fifteen briefs ran through gpt-5.4 and Qwen 3.6 Plus, with and without the skill loaded, then graded side by side. More font and color variety, fewer purple gradients, much better Codex output. The single change that moved the numbers most: before the model commits to a font or palette, it has to name its first three instincts and reject them.</li>
1104 <li><strong>Anti-pattern detection engine.</strong> 28 deterministic rules across typography, color, layout, motion, and quality. Handles oklch, oklab, lch, and lab color formats, CSS variables inside border shorthands, gradient-backed text, and emoji-only nodes.</li>
1105 <li><strong>CLI: <code>npx impeccable detect</code>.</strong> Scans HTML, CSS, JSX/TSX, Vue, Svelte, and CSS-in-JS. Framework detection, multi-file import tracking, Puppeteer-backed live URL scanning, CI-ready JSON output, and a <code>--fast</code> regex mode for huge codebases.</li>
1106 <li><strong>Chrome DevTools extension.</strong> One-click detection on any page: yours, staging, production, or someone else's. Reads live computed styles, surfaces findings in an interactive panel, and highlights elements on the page. In Chrome Web Store review.</li>
1107 <li><strong><code>/critique</code> got teeth.</strong> Persona sub-agents review in parallel, score against Nielsen's heuristics, run the detector automatically, and open a live browser overlay so you can walk each finding in place.</li>
1108 <li><strong>New ways to create with Impeccable.</strong> <code>/shape</code> runs a structured discovery interview about purpose, audience, and goals, then produces a design brief before any code is written. <code>/impeccable craft</code> chains that brief straight into the full implementation flow so you ship a designed feature instead of a reflex card grid.</li>
1109 <li><strong>New docs site.</strong> Top-level <a href="/docs">Docs</a>, <a href="/anti-patterns">Anti-Patterns</a>, and <a href="/visual-mode">Visual Mode</a> sections. 18 per-skill pages with before/after demos and the canonical SKILL.md inline, two <a href="/tutorials">tutorials</a>, and 38 rule cards with inline visual examples.</li>
1110 <li><strong>New harness: Rovo Dev.</strong> 11 supported AI tools total.</li>
1111 </ul>
1112 </div>
1113
1114 <div class="changelog-entry">
1115 <div class="changelog-version-header">
1116 <span class="changelog-version">v1.6.0</span>
1117 <span class="changelog-date">March 18, 2026</span>
1118 </div>
1119 <ul class="changelog-items">
1120 <li>New provider: <strong>Trae</strong> (China + International)</li>
1121 <li><code>/critique</code> now scores against Nielsen's 10 heuristics, tests with persona archetypes, and assesses cognitive load</li>
1122 <li><code>/audit</code> now scores 5 dimensions with P0-P3 severity ratings and structured action plans</li>
1123 <li>Improved skill descriptions for better agent auto-discovery</li>
1124 <li>Fixed invalid YAML frontmatter that broke GitHub preview and Codex loading (<a href="https://github.com/pbakaus/impeccable/issues/67">#67</a>)</li>
1125 <li>Codex CLI now uses correct <code>$</code> prefix for command references</li>
1126 </ul>
1127 </div>
1128
1129 <div class="changelog-entry">
1130 <div class="changelog-version-header">
1131 <span class="changelog-version">v1.5.1</span>
1132 <span class="changelog-date">March 17, 2026</span>
1133 </div>
1134 <ul class="changelog-items">
1135 <li><code>/typeset</code> now recommends fixed type scales for app UIs, reserving fluid typography for marketing/content pages</li>
1136 </ul>
1137 </div>
1138
1139 <div class="changelog-entry">
1140 <div class="changelog-version-header">
1141 <span class="changelog-version">v1.5.0</span>
1142 <span class="changelog-date">March 16, 2026</span>
1143 </div>
1144 <ul class="changelog-items">
1145 <li>3 new skills: <code>/typeset</code> (fix typography), <code>/arrange</code> (fix layout & spacing), <code>/overdrive</code> (technically extraordinary effects, beta)</li>
1146 <li>Skills now auto-gather design context via <code>.impeccable.md</code>. Run <code>/teach-impeccable</code> once, all skills benefit</li>
1147 <li>Deep linking to commands (<code>#cmd-overdrive</code>, etc.)</li>
1148 </ul>
1149 </div>
1150
1151 <div class="changelog-entry">
1152 <div class="changelog-version-header">
1153 <span class="changelog-version">v1.3.0</span>
1154 <span class="changelog-date">March 12, 2026</span>
1155 </div>
1156 <ul class="changelog-items">
1157 <li>Added OpenCode provider support</li>
1158 <li>Added Pi provider support</li>
1159 <li>Recategorized <code>/onboard</code> as an enhancement command</li>
1160 </ul>
1161 </div>
1162
1163 <div class="changelog-entry">
1164 <div class="changelog-version-header">
1165 <span class="changelog-version">v1.2.0</span>
1166 <span class="changelog-date">March 5, 2026</span>
1167 </div>
1168 <ul class="changelog-items">
1169 <li>Added Kiro support (<code>.kiro/skills/</code>)</li>
1170 <li>Restored prefix toggle: download <code>i-</code> prefixed bundles to avoid naming conflicts</li>
1171 <li>Audit and critique skills only suggest real, installed commands</li>
1172 </ul>
1173 </div>
1174
1175 <div class="changelog-entry">
1176 <div class="changelog-version-header">
1177 <span class="changelog-version">v1.1.0</span>
1178 <span class="changelog-date">March 4, 2026</span>
1179 </div>
1180 <ul class="changelog-items">
1181 <li>Unified skills architecture: commands are now skills with <code>user-invocable: true</code></li>
1182 <li>Added VS Code Copilot and Google Antigravity support</li>
1183 <li>New install flow: <code>npx skills add</code> as primary, universal ZIP as fallback</li>
1184 <li>Added universal ZIP containing all 5 provider directories</li>
1185 <li>Renamed <code>/simplify</code> to <code>/distill</code> to avoid Claude Code conflict</li>
1186 </ul>
1187 </div>
1188
1189 <div class="changelog-entry">
1190 <div class="changelog-version-header">
1191 <span class="changelog-version">v1.0.0</span>
1192 <span class="changelog-date">February 28, 2026</span>
1193 </div>
1194 <ul class="changelog-items">
1195 <li>Initial release with enhanced frontend-design skill</li>
1196 <li>17 design commands: /polish, /audit, /distill, /bolder, and more</li>
1197 <li>Support for Cursor, Claude Code, Gemini CLI, and Codex CLI</li>
1198 <li>Interactive command cheatsheet</li>
1199 </ul>
1200 </div>
1201 </div>
1202 </details>
1203
1204 </section>
1205
1206 <!-- 8. FAQ -->
1207 <section class="faq-section" id="faq">
1208 <div class="section-header" data-reveal>
1209 <span class="section-number">07</span>
1210 <h2 class="section-title">Frequently Asked Questions</h2>
1211 </div>
1212
1213 <div class="faq-list" data-reveal>
1214 <details class="faq-item">
1215 <summary class="faq-question">Where do I put the downloaded files?</summary>
1216 <div class="faq-answer">
1217 <p>The easiest way is <code>npx skills add pbakaus/impeccable</code>, which auto-detects your AI harness and places files correctly.</p>
1218 <p>If you downloaded the <strong>universal ZIP</strong>, extract it to your <strong>project root</strong> (same level as your <code>package.json</code> or <code>src/</code> folder). It creates hidden folders for each supported tool: <code>.cursor/</code>, <code>.claude/</code>, <code>.gemini/</code>, <code>.codex/</code>, <code>.agents/</code>, and <code>.github/</code>.</p>
1219 <p>Project-level installation takes precedence and lets you version control your skills.</p>
1220 </div>
1221 </details>
1222
1223 <details class="faq-item">
1224 <summary class="faq-question">How do I update to the latest version?</summary>
1225 <div class="faq-answer">
1226 <p>Run <code>npx impeccable skills update</code> from your project root. It downloads the latest skills, cleans up deprecated files, and preserves any prefix you use.</p>
1227 <ul>
1228 <li><strong>Alternative:</strong> <code>npx skills add pbakaus/impeccable</code> re-installs from scratch.</li>
1229 <li><strong>Claude Code plugin:</strong> Open <code>/plugin</code>, go to the Discover tab.</li>
1230 <li><strong>Manual ZIP:</strong> Download from above and extract to the project root.</li>
1231 </ul>
1232 <p>Your <code>PRODUCT.md</code> and <code>DESIGN.md</code> context files are never overwritten.</p>
1233 </div>
1234 </details>
1235
1236 <details class="faq-item">
1237 <summary class="faq-question">I used to type <code>/critique</code> directly. How do I get that back?</summary>
1238 <div class="faq-answer">
1239 <p>Pinning is built in. Run <code>/impeccable pin critique</code> and <code>/critique</code> becomes a standalone shortcut again, without reversing the consolidation.</p>
1240 <p>Under the hood it writes a lightweight redirect skill that delegates to <code>/impeccable critique</code>, so updates to the parent skill flow through automatically. It works for every command.</p>
1241 <p><strong>Examples:</strong></p>
1242 <ul>
1243 <li><code>/impeccable pin polish</code> → <code>/polish</code> works again</li>
1244 <li><code>/impeccable pin audit</code> → <code>/audit</code> works again</li>
1245 <li><code>/impeccable pin live</code> → <code>/live</code> works again</li>
1246 </ul>
1247 <p>To remove: <code>/impeccable unpin critique</code>. To see your current pins, check your harness skills directory (<code>.claude/skills/</code>, <code>.cursor/skills/</code>, etc.) for directories prefixed with <code>i-</code>.</p>
1248 </div>
1249 </details>
1250
1251 <details class="faq-item">
1252 <summary class="faq-question">Commands or skills aren't appearing. What do I do?</summary>
1253 <div class="faq-answer">
1254 <p><strong>For commands:</strong> Type <code>/impeccable</code> in your AI harness and look for commands like <code>/impeccable audit</code>, <code>/impeccable polish</code>, etc. If they don't appear, double-check the files are in the correct location.</p>
1255 <p><strong>For skills:</strong> Skills are applied automatically when relevant. To verify, explicitly mention "use the impeccable skill" in your prompt. This forces the AI to acknowledge and apply it.</p>
1256 <p><strong>Tool-specific setup:</strong></p>
1257 <ul>
1258 <li><strong>Cursor:</strong> Requires Nightly channel + Agent Skills enabled in Settings → Rules</li>
1259 <li><strong>Gemini CLI:</strong> Requires <code>@google/gemini-cli@preview</code> + Skills enabled via <code>/settings</code></li>
1260 <li><strong>Codex:</strong> Skills do not appear in the normal <code>/</code> command picker. Open <code>/skills</code> or type <code>$</code>. Repo installs live in <code>.agents/skills/</code>, user installs live in <code>~/.agents/skills/</code>. Restart Codex if a new skill does not show up.</li>
1261 </ul>
1262 </div>
1263 </details>
1264
1265 <details class="faq-item">
1266 <summary class="faq-question">I'm new to AI harnesses. Where do I start?</summary>
1267 <div class="faq-answer">
1268 <p>Skills and commands are intermediate features. If you're just getting started, learn the basics first:</p>
1269 <ul>
1270 <li><strong>Claude Code:</strong> <a href="https://docs.anthropic.com/en/docs/claude-code" target="_blank" rel="noopener">Official Documentation</a></li>
1271 <li><strong>Cursor:</strong> <a href="https://docs.cursor.com" target="_blank" rel="noopener">Cursor Docs</a></li>
1272 <li><strong>Gemini CLI:</strong> <a href="https://geminicli.com/docs/" target="_blank" rel="noopener">Gemini CLI Docs</a></li>
1273 <li><strong>Codex CLI:</strong> <a href="https://github.com/openai/codex" target="_blank" rel="noopener">Codex GitHub</a></li>
1274 </ul>
1275 <p>Once you're comfortable with basic prompting and code generation, come back and give Impeccable a try.</p>
1276 </div>
1277 </details>
1278
1279 <details class="faq-item">
1280 <summary class="faq-question">Is Impeccable free?</summary>
1281 <div class="faq-answer">
1282 <p>Yes. Everything is <strong>Apache 2.0</strong>: skills, commands, CLI, and the detection engine. Fully open source, free for everyone.</p>
1283 </div>
1284 </details>
1285 </div>
1286 </section>
1287 </div><!-- /.changelog-faq-row -->
1288
1289 <!-- PARTNERSHIPS -->
1290 <section class="consulting-section" id="consulting">
1291 <div class="consulting-content" data-reveal>
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304 <div class="consulting-text">
1305 <h2 class="consulting-title">Work with me</h2>
1306 <p class="consulting-desc">Impeccable is built by <a href="https://renaissance-geek.ai" target="_blank" rel="noopener">Renaissance Geek</a>. I work with enterprise teams on large-scale rollouts, custom integrations, and training for designers and developers. If you're a frontier lab, design tool company, or enterprise looking to raise the bar on AI-generated design, let's talk.</p>
1307 </div>
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320 <div class="consulting-actions">
1321 <a href="mailto:paul@renaissance-geek.ai" class="btn btn-primary">
1322 <span>Get in touch</span>
1323 <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
1324 <path d="M5 12h14M12 5l7 7-7 7"/>
1325 </svg>
1326 </a>
1327 </div>
1328 </div>
1329 </section>
1330
1331<Fragment slot="scripts">
1332 <script>
1333 import '../scripts/app.js';
1334 </script>
1335</Fragment>
1336
1337</Base>