skills/pbakaus_impeccable
1
0
Fork 0
mirror of https://github.com/pbakaus/impeccable.git synced 2026-09-11 21:57:14 +03:00
Code Issues Packages Projects Releases Wiki Activity

Refine release changelog copy

Browse Source
This commit is contained in:
Paul Bakaus
2026-06-15 13:57:08 +09:00
parent 23eae3cc5b
commit fff712ca98
2 changed files with 19 additions and 20 deletions
Download Patch File Download Diff File Expand all files Collapse all files
site/components/Header.astro
+2 -2
View File
@@ -53,9 +53,9 @@ const { activeNav } = Astro.props;
<path d="M21 14.5A8.5 8.5 0 0 1 9.5 3a7 7 0 1 0 11.5 11.5z"/>
</svg>
</button>
<a href="https://github.com/pbakaus/impeccable" class="site-header-github" target="_blank" rel="noopener" aria-label="Impeccable on GitHub, 38,406 stars">
<a href="https://github.com/pbakaus/impeccable" class="site-header-github" target="_blank" rel="noopener" aria-label="Impeccable on GitHub, 38k stars">
<svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M12 2C6.477 2 2 6.484 2 12.017c0 4.425 2.865 8.18 6.839 9.504.5.092.682-.217.682-.483 0-.237-.008-.868-.013-1.703-2.782.605-3.369-1.343-3.369-1.343-.454-1.158-1.11-1.466-1.11-1.466-.908-.62.069-.608.069-.608 1.003.07 1.531 1.032 1.531 1.032.892 1.53 2.341 1.088 2.91.832.092-.647.35-1.088.636-1.338-2.22-.253-4.555-1.113-4.555-4.951 0-1.093.39-1.988 1.029-2.688-.103-.253-.446-1.272.098-2.65 0 0 .84-.27 2.75 1.026A9.564 9.564 0 0112 6.844c.85.004 1.705.115 2.504.337 1.909-1.296 2.747-1.027 2.747-1.027.546 1.379.202 2.398.1 2.651.64.7 1.028 1.595 1.028 2.688 0 3.848-2.339 4.695-4.566 4.943.359.309.678.92.678 1.855 0 1.338-.012 2.419-.012 2.747 0 .268.18.58.688.482A10.019 10.019 0 0022 12.017C22 6.484 17.522 2 12 2z"/></svg>
<span class="site-header-github-label">38.4k</span>
<span class="site-header-github-label">38k</span>
<svg class="site-header-github-star" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M12 2l2.76 6.36L22 9.27l-5 4.87 1.18 6.88L12 17.77l-6.18 3.25L7 14.14 2 9.27l7.24-.91L12 2z"/></svg>
</a>
</div>
site/pages/changelog.astro
+17 -18
View File
@@ -25,13 +25,14 @@ import '../styles/changelog-faq-kinpaku.css';
<article id="v3.6.0" class="cf-entry cf-entry--current">
<header class="cf-entry-head"><span class="cf-version">v3.6.0</span><span class="cf-date">June 14, 2026</span><span class="cf-current-badge">Current</span></header>
<p class="cf-entry-lead">Project design hooks, deeper Live Mode support for Svelte and manual edits, and a broad detector accuracy pass across the skill, CLI, and extension.</p>
<p class="cf-entry-lead">Impeccable now helps while the agent is editing, and the core skill is leaner: ablation-tested guidance, project hooks, sharper detector signal, and Live Mode support for Svelte and manual browser edits.</p>
<ul class="cf-items">
<li><strong>Project design hooks.</strong> <code>/impeccable hooks</code> installs and repairs a project-local detector hook for Claude, Codex, and Cursor. Claude and Codex get post-edit reminders, Cursor can block proposed writes before they land, and <code>/impeccable hooks on</code> now handles manifest setup and consent instead of leaving users to wire files by hand.</li>
<li><strong>Hook findings are actionable, not noisy.</strong> Hook runs track clean, pending, and fresh findings, cache duplicate reports, audit their own activity, and now frame detector output as findings requiring review: fix true issues, but use context judgment for intentional designs such as literal bounce motion. Narrow ignore flows through <code>ignore-value</code>, <code>ignore-file</code>, and <code>ignore-rule</code> keep confirmed exceptions out of source comments. Shared config lives in <code>.impeccable/config.json</code>, with local consent and overrides in <code>.impeccable/config.local.json</code>.</li>
<li><strong>Svelte-native Live Mode.</strong> Svelte and SvelteKit variants now preview as temporary framework components with params stored in <code>params.json</code>, then accept back into the selected source component. That keeps stateful pages closer to their real shape and avoids the HMR resets caused by string-injected previews.</li>
<li><strong>Manual and browser Live Mode got sturdier.</strong> Manual text edits have dedicated evidence, apply, and discard routes; Live Mode preserves insertion anchors and mapped-list accept cleanup; and the browser payload is split into DOM helpers, UI primitives, vocabulary, and manual-apply modules instead of one giant script.</li>
<li><strong>Detector accuracy improved across the bundled skill.</strong> Hidden and unrendered elements are skipped in browser rules, sr-only and visually hidden text no longer trips <code>text-overflow</code>, repeated kicker false positives are reduced in card and list contexts, oversized H1 detection now requires viewport dominance, clipped overflow distinguishes decorative viewports from escaping content, OKLCH alpha parses correctly, Sass files count as CSS-like detector inputs, transparent borders or shadows no longer trigger the GPT thin-border rule, and page-level numbered-marker checks no longer treat JS, TS, JSX, TSX, or CSS implementation literals as visible page copy.</li>
<li><strong>Ablation-tested skill core.</strong> The main skill got leaner after rule-level evals across three providers and four niches. Redundant typography and copy guidance moved out of the always-on prompt, rules with no measurable lift were cut, and examples that primed models to repeat the exact pattern being banned were rewritten. The result is a smaller prompt that spends attention on guidance proven to move design output.</li>
<li><strong>Design hooks for real editing sessions.</strong> <code>/impeccable hooks</code> wires the detector into Claude, Codex, and Cursor projects. Claude and Codex get focused design reminders after UI file edits, Cursor can review proposed writes before they land, and <code>/impeccable hooks on</code> handles manifest setup, repair, and consent for you.</li>
<li><strong>Findings stay reviewable.</strong> Hook runs distinguish new findings, already-seen findings, and clean scans, so the agent gets useful pressure without repeated walls of output. Confirmed exceptions can be saved through <code>ignore-value</code>, <code>ignore-file</code>, and <code>ignore-rule</code> in <code>.impeccable</code> config files instead of source comments.</li>
<li><strong>The detector now tracks visible design problems more closely.</strong> The 41-rule engine skips hidden elements and screen-reader-only text, understands OKLCH alpha and Sass-like inputs, reports exact motion tokens for bounce or elastic easing, and tightens repeated kickers, oversized H1s, clipped overflow, transparent border/shadow, numbered marker, and cramped-padding checks.</li>
<li><strong>Svelte-native Live Mode.</strong> Svelte and SvelteKit variants preview as temporary framework components with params stored in <code>params.json</code>, then accept back into the selected source component. Stateful pages stay closer to their real shape and avoid the HMR resets caused by string-injected previews.</li>
<li><strong>Live Mode accepts more real-world edits cleanly.</strong> Manual text edits now have dedicated evidence, apply, and discard routes. Insertions preserve their anchors, accepted variants clean up mapped lists and JSX slots more reliably, and SvelteKit projects get a framework-aware live adapter that leaves <code>src/app.html</code> alone.</li>
</ul>
</article>
@@ -86,8 +87,8 @@ import '../styles/changelog-faq-kinpaku.css';
<article id="cli-v3.0.1" class="cf-entry">
<header class="cf-entry-head"><span class="cf-version">CLI v3.0.1</span><span class="cf-date">June 15, 2026</span></header>
<ul class="cf-items">
<li><strong>Motion findings preserve the actual value.</strong> <code>bounce-easing</code> findings now report the concrete animation token, Tailwind class, or overshooting cubic-bezier value instead of collapsing animation names to a generic <code>bounce</code>. That gives hooks and audits enough information to suggest narrow <code>ignore-value</code> exceptions for intentional motion.</li>
<li><strong>Project hook guidance uses judgment first.</strong> Hook output now says findings require review, not automatic correction. Agents are told to fix real design problems, classify contextual false positives explicitly, and avoid changing intentional design just to satisfy the detector.</li>
<li><strong>Exact motion findings.</strong> <code>bounce-easing</code> now reports the concrete animation token, Tailwind class, or overshooting cubic-bezier value instead of a generic <code>bounce</code> label. Intentional motion can be kept or ignored at the narrow value level.</li>
<li><strong>Hook guidance favors design judgment.</strong> Project hook output now asks agents to classify each finding before editing: fix true design problems, leave intentional demos or domain-appropriate motion alone, and explain the decision.</li>
</ul>
</article>
@@ -95,12 +96,11 @@ import '../styles/changelog-faq-kinpaku.css';
<header class="cf-entry-head"><span class="cf-version">CLI v3.0.0</span><span class="cf-date">June 14, 2026</span></header>
<ul class="cf-items">
<li><strong>Breaking: Node 24 minimum.</strong> The CLI now declares <code>"node": "&gt;=24"</code>. Upgrade Node before installing or running this version.</li>
<li><strong>Shorter CLI commands.</strong> <code>impeccable install</code>, <code>impeccable update</code>, <code>impeccable link</code>, and <code>impeccable check</code> are now the primary command shape. The old <code>impeccable skills ...</code> namespace still works for backwards compatibility.</li>
<li><strong>Clearer installer targeting.</strong> <code>impeccable install</code> now shows the harnesses it auto-detected, defaults to that set, lets you customize providers through a searchable picker, and asks whether to install into the current project or globally. Project installs are the default unless real global skills are already present. Scripts can pin the same choice with <code>--providers=claude,codex,cursor</code> and <code>--scope=project|global</code>.</li>
<li><strong>Hook-aware installs and updates.</strong> <code>impeccable install</code> and <code>impeccable update</code> can prompt once for hook consent, persist the local answer, install or repair <code>.claude/settings.local.json</code>, <code>.codex/hooks.json</code>, and <code>.cursor/hooks.json</code>, and still honor <code>--no-hooks</code> for teams that want skills without editor hooks.</li>
<li><strong>Local and submodule workflows are cleaner.</strong> <code>impeccable link --source=.impeccable</code> supports repo-local development, symlink-safe updates avoid clobbering linked installs, provider aliases include Codex and Rovo Dev names, local bundle overrides are explicit, and ZIP extraction is safer on Windows.</li>
<li><strong>The detector got a real accuracy pass.</strong> The CLI detector now skips hidden browser elements, handles sr-only text overflow, reduces repeated kicker false positives, tightens oversized H1 and clipped-overflow heuristics, understands OKLCH alpha and Sass inputs, avoids transparent-border false positives in the GPT thin-border rule, and keeps page-level numbered-marker analysis out of JS, TS, JSX, TSX, and CSS source literals.</li>
<li><strong>Release and CI plumbing is stricter.</strong> Build commands are split between source validation and release-output sync, <code>scripts/run-tests.mjs</code> owns named test suites, and <code>bun run smoke:hooks</code> verifies provider hook manifests across the generated bundles.</li>
<li><strong>Shorter commands.</strong> <code>impeccable install</code>, <code>impeccable update</code>, <code>impeccable link</code>, and <code>impeccable check</code> are now the primary command shape. The old <code>impeccable skills ...</code> namespace still works for existing scripts.</li>
<li><strong>Installer choices match your machine.</strong> <code>impeccable install</code> shows the harnesses it detects, defaults to that set, lets you customize providers through a searchable picker, and asks whether to install into the current project or globally. Project installs are the default unless real global skills already exist.</li>
<li><strong>Hooks install with the skill when you opt in.</strong> <code>impeccable install</code> and <code>impeccable update</code> can prompt once for hook consent, persist the local answer, and install or repair the Claude, Codex, and Cursor hook manifests. Teams that only want the skill can still pass <code>--no-hooks</code>.</li>
<li><strong>Local and submodule installs are safer.</strong> <code>impeccable link --source=.impeccable</code> supports repo-local development, symlink-safe updates avoid clobbering linked installs, provider aliases include Codex and Rovo Dev names, local bundle overrides are explicit, and ZIP extraction is safer on Windows.</li>
<li><strong>Detector output is more precise.</strong> CLI scans pick up the same accuracy work as the skill hooks: hidden-element skips, sr-only text handling, tighter repeated kicker and oversized-H1 heuristics, OKLCH alpha, Sass-like CSS inputs, transparent-border handling, and page-level numbered-marker checks that stay out of implementation literals.</li>
</ul>
</article>
@@ -140,10 +140,9 @@ import '../styles/changelog-faq-kinpaku.css';
<article id="ext-v1.2.0" class="cf-entry">
<header class="cf-entry-head"><span class="cf-version">Extension v1.2.0</span><span class="cf-date">June 14, 2026</span></header>
<ul class="cf-items">
<li><strong>Firefox build.</strong> The same detector, popup, DevTools panel, and per-rule toggles now ship as a Firefox add-on. <code>bun run build:extension</code> emits a Gecko-compatible package next to the Chrome one, with the background worker declared as an event page and a data-collection declaration that states what the extension already does: the scan runs in the page, and nothing leaves your machine.</li>
<li><strong>Firefox DevTools paths are fixed.</strong> DevTools panel and sidebar URLs are root-relative in the Firefox manifest, so packaged builds can open their extension pages reliably.</li>
<li><strong>Detector results match the latest engine.</strong> The overlay picks up the same false-positive fixes as the CLI: hidden-element skips, sr-only text-overflow handling, tighter repeated kicker, oversized H1, clipped-overflow, OKLCH alpha, Sass-adjacent CSS parsing, transparent-border handling, and exact animation values for bounce/easing findings.</li>
<li><strong>Scan responses are easier to correlate.</strong> Extension scan messages echo scan IDs back to the caller, and the store metadata and icon set were refreshed for the current 41-rule detector.</li>
<li><strong>Firefox support.</strong> The same detector, popup, DevTools panel, and per-rule toggles now ship as a Firefox add-on. The Firefox package declares what the extension already does: scans run in the page, and nothing leaves your machine.</li>
<li><strong>The overlay matches the 41-rule engine.</strong> Browser scans pick up the latest detector improvements, including hidden-element skips, sr-only text-overflow handling, tighter repeated kicker, oversized-H1, clipped-overflow, OKLCH alpha, Sass-adjacent CSS parsing, transparent-border handling, and exact animation values for bounce or elastic motion.</li>
<li><strong>DevTools opens reliably in packaged builds.</strong> Firefox panel and sidebar URLs are now root-relative, scan responses echo their scan IDs, and the icon set plus store metadata match the current detector.</li>
</ul>
</article>