Skip to content

The design language that makes your AI harness better at design.

JavaScript

Sync generated provider output

github-actions[bot]89c6b5a97f97
diff --git a/.agent/skills/impeccable/reference/android.md b/.agent/skills/impeccable/reference/android.md
index 1f67a6bb5..32a5cf7cc 100644
--- a/.agent/skills/impeccable/reference/android.md
+++ b/.agent/skills/impeccable/reference/android.md
@@ -42,5 +42,5 @@ Would a fluent Android user trust this app, or trip on off-spec components? The
## Verifying the build
- **Screenshots come from the emulator or a connected device, never a browser.** Build and install, then capture with `adb exec-out screencap -p > <path>` (pick a device with `adb -s <serial>` when several are attached). Capture every device class the app ships to, at least one phone and, when tablets are a target, one tablet, and write the files where the review flow expects them.
-- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (restore `1.0` after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
+- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (read both settings first with `adb shell cmd uimode night` and `adb shell settings get system font_scale`, and restore them after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
- **Emulators give breadth; gestures, refresh rates, and performance need hardware.** Say which one produced the evidence.
diff --git a/.agent/skills/impeccable/reference/audit.md b/.agent/skills/impeccable/reference/audit.md
index 0a020add6..31518e52a 100644
--- a/.agent/skills/impeccable/reference/audit.md
+++ b/.agent/skills/impeccable/reference/audit.md
@@ -11,7 +11,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
### 1. Accessibility (A11y)
**Check for**:
-- **Contrast issues**: Text contrast ratios < 4.5:1 (or 7:1 for AAA)
+- **Contrast issues**: Text contrast ratios < 4.5:1, or < 3:1 for large text (or 7:1 for AAA)
- **Motion sensitivity**: `prefers-reduced-motion` needs an intentional alternative that preserves state change and hierarchy; flag a global `0.01ms` kill that destroys useful feedback, flashing above threshold, and motion that blocks focus, reading, or task completion
- **Missing ARIA**: Interactive elements without proper roles, labels, or states
- **Keyboard navigation**: Missing focus indicators, illogical tab order, keyboard traps
@@ -47,7 +47,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
**Check for**:
- **Fixed widths**: Hard-coded widths that break on mobile
-- **Touch targets**: Interactive elements < 44x44px
+- **Touch targets**: Interactive elements < 44x44px. WCAG AA (SC 2.5.8) requires at least 24x24 CSS px unless an exception applies: spacing, an equivalent control, inline text, user-agent styling, or an essential size. Spacing passes when a 24 CSS px circle centered on the target's bounding box overlaps no other target and no other undersized target's circle
- **Broken touch interaction**: Custom sliders, drag surfaces, and scrollable control strips whose primary gesture fails under touch, that swallow page scroll or lose the drag to it, or that stay stuck after an interrupted gesture. Code tells: mouse-only handlers, no `touch-action` on a pointer-event drag surface, drag state that nothing clears on cancel, lost capture, or blur. Exercise the gesture when a browser tool can synthesize touch (a rendered viewport proves layout, not the gesture), then say what produced the evidence (emulated viewport, synthesized touch, which engine, physical device) and what stayed untested
- **Horizontal scroll**: Content overflow on narrow viewports
- **Text scaling**: Layouts that break when text size increases
diff --git a/.agent/skills/impeccable/reference/distill.md b/.agent/skills/impeccable/reference/distill.md
index 757630fae..a49697136 100644
--- a/.agent/skills/impeccable/reference/distill.md
+++ b/.agent/skills/impeccable/reference/distill.md
@@ -41,7 +41,7 @@ Expect to say no to good ideas to make room for great execution.
Systematically remove complexity across these dimensions:
### Information Architecture
-- **Reduce scope**: Remove secondary actions, optional features, redundant information
+- **Reduce scope**: Remove secondary actions, redundant information
- **Progressive disclosure**: Hide complexity behind clear entry points (accordions, modals, step-through flows)
- **Combine related actions**: Merge similar buttons, consolidate forms, group related content
- **Clear hierarchy**: ONE primary action, few secondary actions, everything else tertiary or hidden
@@ -70,11 +70,11 @@ Systematically remove complexity across these dimensions:
- **Clear next action**: ONE obvious next action, not five competing ones
### Content Simplification
-- **Shorter copy**: Cut every sentence in half, then do it again
+- **Shorter copy**: Cut filler, not meaning
- **Active voice**: "Save changes" not "Changes will be saved"
- **Remove jargon**: Plain language always wins
- **Scannable structure**: Short paragraphs, bullet points, clear headings
-- **Essential information only**: Remove marketing fluff, legalese, hedging
+- **Essential information only**: Remove marketing fluff, hedging
- **Remove redundant copy**: No headers restating intros, no repeated explanations, say it once
### Code Simplification
diff --git a/.agent/skills/impeccable/reference/doctor.md b/.agent/skills/impeccable/reference/doctor.md
index 7c32ddacb..6eac95b2f 100644
--- a/.agent/skills/impeccable/reference/doctor.md
+++ b/.agent/skills/impeccable/reference/doctor.md
@@ -6,7 +6,7 @@ This is maintenance, not design. Do not redesign anything, do not open files out
Three kinds of drift travel under "out of date". Keep them apart:
-- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it. Not this command's job.
+- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it, or the harness's plugin manager for a plugin install. Not this command's job.
- **Schema drift.** An artifact was written by an older Impeccable: fields nothing reads, fields now expected, files in retired locations. Mechanical, and this command repairs most of it.
- **Truth drift.** The code moved on and the document no longer describes it. No file comparison settles this. `document` owns DESIGN.md, `init` owns PRODUCT.md, and this command's job is to hand them a specific gap rather than a vague suspicion.
diff --git a/.agent/skills/impeccable/reference/document.md b/.agent/skills/impeccable/reference/document.md
index 9da0bc743..ec75b7cc7 100644
--- a/.agent/skills/impeccable/reference/document.md
+++ b/.agent/skills/impeccable/reference/document.md
@@ -17,10 +17,10 @@ colors:
typography:
display:
fontFamily: "Cormorant Garamond, Georgia, serif"
- fontSize: "clamp(2.5rem, 7vw, 4.5rem)"
+ fontSize: "4.5rem"
fontWeight: 300
lineHeight: 1
- letterSpacing: "normal"
+ letterSpacing: "0em"
body:
# ...
rounded:
@@ -325,7 +325,7 @@ If the project has **no component library yet** (bare landing page, new project)
#### Tonal ramps
-For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue and chroma, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
+For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue, chroma reduced near white and black, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
#### Narrative mapping
diff --git a/.agent/skills/impeccable/reference/live.md b/.agent/skills/impeccable/reference/live.md
index e0c585e28..2002228b4 100644
--- a/.agent/skills/impeccable/reference/live.md
+++ b/.agent/skills/impeccable/reference/live.md
@@ -158,14 +158,14 @@ Sources in priority order: DESIGN.md's visual system fields; CSS custom properti
**Default:** compare each variant against the Phase A lock; palette, type voice, or rhetoric drift means it crossed into departure by accident: rework. Then confirm three different primary axes; three "tighter density" variants is failure. **Departure:** two passes, family before sentence. Family pass (non-negotiable): label each variant with a concrete family of your own choosing; shared or interchangeable labels mean rework. Sentence pass: three one-line descriptions side by side; two that rhyme mean rework. When the primary axis is color or theme, the trio must not share theme + dominant hue: three color worlds, not three shades.
-**Action-specific invocations** must vary along the action's dimension:
+**Action-specific invocations** must vary along the action's dimension; in default mode every variation stays within the available faces and existing tokens:
- `bolder`: amplify a different dimension per variant (scale / saturation / structural change).
- `quieter`: pull back a different dimension (color / ornament / spacing).
- `distill`: remove a different class of excess (visual noise / redundant content / nested structure).
- `polish`: a different refinement axis (rhythm / hierarchy / micro-details).
-- `typeset`: different pairing AND different scale ratio each.
-- `colorize`: different hue family each; vary chroma and contrast strategy.
+- `typeset`: departure varies the pairing AND the scale ratio each; default keeps the faces and varies scale ratio, case, and weight each.
+- `colorize`: departure gives each a different hue family and varies chroma and contrast strategy; default gives each a different existing palette role carrying the surface (Restrained / Committed / Full palette / Drenched) and a different contrast strategy.
- `layout`: different structural arrangement, not spacing tweaks.
- `adapt`: different target context per variant (mobile-first / tablet / desktop / print or low-data).
- `animate`: different motion vocabulary (cascade stagger / clip wipe / scale-and-focus / morph / parallax).
diff --git a/.agent/skills/impeccable/reference/optimize.md b/.agent/skills/impeccable/reference/optimize.md
index 5c55a1642..3f3fc7c33 100644
--- a/.agent/skills/impeccable/reference/optimize.md
+++ b/.agent/skills/impeccable/reference/optimize.md
@@ -38,7 +38,6 @@ Create systematic improvement plan:
src="hero.webp"
srcset="hero-400.webp 400w, hero-800.webp 800w, hero-1200.webp 1200w"
sizes="(max-width: 400px) 400px, (max-width: 800px) 800px, 1200px"
- loading="lazy"
alt="Hero image"
/>
```
diff --git a/.agent/skills/impeccable/reference/visualize.md b/.agent/skills/impeccable/reference/visualize.md
index a5e8f656a..47e6f8b77 100644
--- a/.agent/skills/impeccable/reference/visualize.md
+++ b/.agent/skills/impeccable/reference/visualize.md
@@ -26,7 +26,7 @@ Each comp is a direction test, not a screenshot specification. Core UI text, res
Show the three together on the decision page (`impeccable serve-question`, one option per comp with the comp as its hero), or in the harness only when it renders images inline; a text-only surface does not count as display. Ask what should carry forward, what feels false to the world, and whether the selected concept should be approved, combined, revised, or rejected. Then stop and wait. A structured simulated user counts as attended and receives the same question.
-Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md, and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
+Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md (the chosen direction on a new world), and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
This approval point has no substitute and no skip condition. When the structured question tool errors, fall back to the decision page; only after both fail may you treat the choice as delegated, and a delegated pick is recorded exactly as an approval is and disclosed in your first reply, not your last. The finish reviewer treats comp-round comps with no recorded approval as a material finding; decision comps under `.impeccable/mocks/decision/` are the direction round's hand, not comp-round output, and imply no approval on their own.
diff --git a/.agent/skills/impeccable/scripts/command-metadata.json b/.agent/skills/impeccable/scripts/command-metadata.json
index 89891ea4d..4686bb6de 100644
--- a/.agent/skills/impeccable/scripts/command-metadata.json
+++ b/.agent/skills/impeccable/scripts/command-metadata.json
@@ -4,7 +4,7 @@
"argumentHint": "[feature description]"
},
"init": {
- "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); offers DESIGN.md (visual: colors, typography, components) when code exists; pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
+ "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
"argumentHint": ""
},
"document": {
@@ -88,7 +88,7 @@
"argumentHint": "[target]"
},
"shape": {
- "description": "Plan UX and UI before code. Runs a required multi-round discovery interview, uses visual probes when available, and produces a user-confirmed design brief for implementation.",
+ "description": "Plan UX and UI before code. Runs a discovery interview (one round by default), uses visual probes when available, and produces a user-confirmed design brief for implementation.",
"argumentHint": "[feature to shape]"
},
"typeset": {
diff --git a/.agent/skills/impeccable/scripts/live-browser.js b/.agent/skills/impeccable/scripts/live-browser.js
index 504e75b9c..a63f1abe2 100644
--- a/.agent/skills/impeccable/scripts/live-browser.js
+++ b/.agent/skills/impeccable/scripts/live-browser.js
@@ -3271,6 +3271,14 @@
const P = paramsPanelPalette || barPaletteForTheme(detectPageTheme());
paramsPanelBody.innerHTML = '';
for (const p of params) {
+ // A knob the panel shows must be in the live values and on the variant,
+ // or accept drops it and the preview ignores it. Seed only missing keys
+ // so a reopen keeps edits.
+ if (!Object.hasOwn(paramsCurrentValues, p.id)) {
+ paramsCurrentValues[p.id] = p.default;
+ applyParamValue(variantEl, p, p.default);
+ }
+ const value = paramsCurrentValues[p.id];
const row = el('div', { display: 'flex', flexDirection: 'column', gap: '6px' });
const labelRow = el('div', {
display: 'flex', justifyContent: 'space-between',
@@ -3295,7 +3303,7 @@
input.min = String(p.min != null ? p.min : 0);
input.max = String(p.max != null ? p.max : 1);
input.step = String(p.step != null ? p.step : 0.05);
- input.value = String(p.default);
+ input.value = String(value);
Object.assign(input.style, {
width: '100%', accentColor: C.brand, cursor: 'pointer',
});
@@ -3310,7 +3318,7 @@
});
row.appendChild(input);
} else if (p.kind === 'toggle') {
- const initial = !!p.default;
+ const initial = !!value;
readout.textContent = initial ? 'On' : 'Off';
const track = el('button', {
position: 'relative', width: '36px', height: '20px',
@@ -3344,8 +3352,8 @@
const opts = (p.options || []).map(o =>
typeof o === 'string' ? { value: o, label: o } : o
);
- const activeOpt = opts.find(o => o.value === p.default) || opts[0];
- readout.textContent = activeOpt ? activeOpt.label : String(p.default);
+ const activeOpt = opts.find(o => o.value === value) || opts[0];
+ readout.textContent = activeOpt ? activeOpt.label : String(value);
const segRow = el('div', {
display: 'grid',
gridTemplateColumns: 'repeat(' + opts.length + ', 1fr)',
@@ -3354,7 +3362,7 @@
});
const segBtns = [];
opts.forEach(o => {
- const active = o.value === p.default;
+ const active = o.value === value;
const b = el('button', {
padding: '5px 4px', border: 'none', borderRadius: '3px',
background: active ? C.brand : 'transparent',
@@ -4988,8 +4996,8 @@
const variantEl = getVisibleVariantEl();
const params = parseVariantParams(variantEl);
if (!variantEl || params.length === 0) return;
- // Build fresh to ensure the current variant's controls are shown.
- applyParamDefaults(variantEl, params);
+ // Rebuild the controls from the current values. Defaults are applied
+ // when the variant is initialized, not when its Tune panel is reopened.
buildParamsPanel(variantEl, params);
tuneOpen = true;
showParamsPanel();
diff --git a/.agents/skills/impeccable/reference/android.md b/.agents/skills/impeccable/reference/android.md
index 1f67a6bb5..32a5cf7cc 100644
--- a/.agents/skills/impeccable/reference/android.md
+++ b/.agents/skills/impeccable/reference/android.md
@@ -42,5 +42,5 @@ Would a fluent Android user trust this app, or trip on off-spec components? The
## Verifying the build
- **Screenshots come from the emulator or a connected device, never a browser.** Build and install, then capture with `adb exec-out screencap -p > <path>` (pick a device with `adb -s <serial>` when several are attached). Capture every device class the app ships to, at least one phone and, when tablets are a target, one tablet, and write the files where the review flow expects them.
-- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (restore `1.0` after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
+- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (read both settings first with `adb shell cmd uimode night` and `adb shell settings get system font_scale`, and restore them after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
- **Emulators give breadth; gestures, refresh rates, and performance need hardware.** Say which one produced the evidence.
diff --git a/.agents/skills/impeccable/reference/audit.md b/.agents/skills/impeccable/reference/audit.md
index 29eefcc07..13bf0d7c7 100644
--- a/.agents/skills/impeccable/reference/audit.md
+++ b/.agents/skills/impeccable/reference/audit.md
@@ -11,7 +11,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
### 1. Accessibility (A11y)
**Check for**:
-- **Contrast issues**: Text contrast ratios < 4.5:1 (or 7:1 for AAA)
+- **Contrast issues**: Text contrast ratios < 4.5:1, or < 3:1 for large text (or 7:1 for AAA)
- **Motion sensitivity**: `prefers-reduced-motion` needs an intentional alternative that preserves state change and hierarchy; flag a global `0.01ms` kill that destroys useful feedback, flashing above threshold, and motion that blocks focus, reading, or task completion
- **Missing ARIA**: Interactive elements without proper roles, labels, or states
- **Keyboard navigation**: Missing focus indicators, illogical tab order, keyboard traps
@@ -47,7 +47,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
**Check for**:
- **Fixed widths**: Hard-coded widths that break on mobile
-- **Touch targets**: Interactive elements < 44x44px
+- **Touch targets**: Interactive elements < 44x44px. WCAG AA (SC 2.5.8) requires at least 24x24 CSS px unless an exception applies: spacing, an equivalent control, inline text, user-agent styling, or an essential size. Spacing passes when a 24 CSS px circle centered on the target's bounding box overlaps no other target and no other undersized target's circle
- **Broken touch interaction**: Custom sliders, drag surfaces, and scrollable control strips whose primary gesture fails under touch, that swallow page scroll or lose the drag to it, or that stay stuck after an interrupted gesture. Code tells: mouse-only handlers, no `touch-action` on a pointer-event drag surface, drag state that nothing clears on cancel, lost capture, or blur. Exercise the gesture when a browser tool can synthesize touch (a rendered viewport proves layout, not the gesture), then say what produced the evidence (emulated viewport, synthesized touch, which engine, physical device) and what stayed untested
- **Horizontal scroll**: Content overflow on narrow viewports
- **Text scaling**: Layouts that break when text size increases
diff --git a/.agents/skills/impeccable/reference/distill.md b/.agents/skills/impeccable/reference/distill.md
index 6a449dd3c..2537473ce 100644
--- a/.agents/skills/impeccable/reference/distill.md
+++ b/.agents/skills/impeccable/reference/distill.md
@@ -41,7 +41,7 @@ Expect to say no to good ideas to make room for great execution.
Systematically remove complexity across these dimensions:
### Information Architecture
-- **Reduce scope**: Remove secondary actions, optional features, redundant information
+- **Reduce scope**: Remove secondary actions, redundant information
- **Progressive disclosure**: Hide complexity behind clear entry points (accordions, modals, step-through flows)
- **Combine related actions**: Merge similar buttons, consolidate forms, group related content
- **Clear hierarchy**: ONE primary action, few secondary actions, everything else tertiary or hidden
@@ -70,11 +70,11 @@ Systematically remove complexity across these dimensions:
- **Clear next action**: ONE obvious next action, not five competing ones
### Content Simplification
-- **Shorter copy**: Cut every sentence in half, then do it again
+- **Shorter copy**: Cut filler, not meaning
- **Active voice**: "Save changes" not "Changes will be saved"
- **Remove jargon**: Plain language always wins
- **Scannable structure**: Short paragraphs, bullet points, clear headings
-- **Essential information only**: Remove marketing fluff, legalese, hedging
+- **Essential information only**: Remove marketing fluff, hedging
- **Remove redundant copy**: No headers restating intros, no repeated explanations, say it once
### Code Simplification
diff --git a/.agents/skills/impeccable/reference/doctor.md b/.agents/skills/impeccable/reference/doctor.md
index 99211927a..6d680a49f 100644
--- a/.agents/skills/impeccable/reference/doctor.md
+++ b/.agents/skills/impeccable/reference/doctor.md
@@ -6,7 +6,7 @@ This is maintenance, not design. Do not redesign anything, do not open files out
Three kinds of drift travel under "out of date". Keep them apart:
-- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it. Not this command's job.
+- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it, or the harness's plugin manager for a plugin install. Not this command's job.
- **Schema drift.** An artifact was written by an older Impeccable: fields nothing reads, fields now expected, files in retired locations. Mechanical, and this command repairs most of it.
- **Truth drift.** The code moved on and the document no longer describes it. No file comparison settles this. `document` owns DESIGN.md, `init` owns PRODUCT.md, and this command's job is to hand them a specific gap rather than a vague suspicion.
diff --git a/.agents/skills/impeccable/reference/document.md b/.agents/skills/impeccable/reference/document.md
index 5f332e5fe..45721a6f0 100644
--- a/.agents/skills/impeccable/reference/document.md
+++ b/.agents/skills/impeccable/reference/document.md
@@ -17,10 +17,10 @@ colors:
typography:
display:
fontFamily: "Cormorant Garamond, Georgia, serif"
- fontSize: "clamp(2.5rem, 7vw, 4.5rem)"
+ fontSize: "4.5rem"
fontWeight: 300
lineHeight: 1
- letterSpacing: "normal"
+ letterSpacing: "0em"
body:
# ...
rounded:
@@ -325,7 +325,7 @@ If the project has **no component library yet** (bare landing page, new project)
#### Tonal ramps
-For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue and chroma, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
+For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue, chroma reduced near white and black, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
#### Narrative mapping
diff --git a/.agents/skills/impeccable/reference/live.md b/.agents/skills/impeccable/reference/live.md
index a042ed583..ce2e9ccaf 100644
--- a/.agents/skills/impeccable/reference/live.md
+++ b/.agents/skills/impeccable/reference/live.md
@@ -160,14 +160,14 @@ Sources in priority order: DESIGN.md's visual system fields; CSS custom properti
**Default:** compare each variant against the Phase A lock; palette, type voice, or rhetoric drift means it crossed into departure by accident: rework. Then confirm three different primary axes; three "tighter density" variants is failure. **Departure:** two passes, family before sentence. Family pass (non-negotiable): label each variant with a concrete family of your own choosing; shared or interchangeable labels mean rework. Sentence pass: three one-line descriptions side by side; two that rhyme mean rework. When the primary axis is color or theme, the trio must not share theme + dominant hue: three color worlds, not three shades.
-**Action-specific invocations** must vary along the action's dimension:
+**Action-specific invocations** must vary along the action's dimension; in default mode every variation stays within the available faces and existing tokens:
- `bolder`: amplify a different dimension per variant (scale / saturation / structural change).
- `quieter`: pull back a different dimension (color / ornament / spacing).
- `distill`: remove a different class of excess (visual noise / redundant content / nested structure).
- `polish`: a different refinement axis (rhythm / hierarchy / micro-details).
-- `typeset`: different pairing AND different scale ratio each.
-- `colorize`: different hue family each; vary chroma and contrast strategy.
+- `typeset`: departure varies the pairing AND the scale ratio each; default keeps the faces and varies scale ratio, case, and weight each.
+- `colorize`: departure gives each a different hue family and varies chroma and contrast strategy; default gives each a different existing palette role carrying the surface (Restrained / Committed / Full palette / Drenched) and a different contrast strategy.
- `layout`: different structural arrangement, not spacing tweaks.
- `adapt`: different target context per variant (mobile-first / tablet / desktop / print or low-data).
- `animate`: different motion vocabulary (cascade stagger / clip wipe / scale-and-focus / morph / parallax).
diff --git a/.agents/skills/impeccable/reference/optimize.md b/.agents/skills/impeccable/reference/optimize.md
index ea61921c2..a4e55099f 100644
--- a/.agents/skills/impeccable/reference/optimize.md
+++ b/.agents/skills/impeccable/reference/optimize.md
@@ -38,7 +38,6 @@ Create systematic improvement plan:
src="hero.webp"
srcset="hero-400.webp 400w, hero-800.webp 800w, hero-1200.webp 1200w"
sizes="(max-width: 400px) 400px, (max-width: 800px) 800px, 1200px"
- loading="lazy"
alt="Hero image"
/>
```
diff --git a/.agents/skills/impeccable/reference/visualize.md b/.agents/skills/impeccable/reference/visualize.md
index 11ba6d7cd..afb44acce 100644
--- a/.agents/skills/impeccable/reference/visualize.md
+++ b/.agents/skills/impeccable/reference/visualize.md
@@ -26,7 +26,7 @@ Each comp is a direction test, not a screenshot specification. Core UI text, res
Show the three together on the decision page (`impeccable serve-question`, one option per comp with the comp as its hero), or in the harness only when it renders images inline; a text-only surface does not count as display. Ask what should carry forward, what feels false to the world, and whether the selected concept should be approved, combined, revised, or rejected. Then stop and wait. A structured simulated user counts as attended and receives the same question.
-Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md, and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
+Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md (the chosen direction on a new world), and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
This approval point has no substitute and no skip condition. When the structured question tool errors, fall back to the decision page; only after both fail may you treat the choice as delegated, and a delegated pick is recorded exactly as an approval is and disclosed in your first reply, not your last. The finish reviewer treats comp-round comps with no recorded approval as a material finding; decision comps under `.impeccable/mocks/decision/` are the direction round's hand, not comp-round output, and imply no approval on their own.
diff --git a/.agents/skills/impeccable/scripts/command-metadata.json b/.agents/skills/impeccable/scripts/command-metadata.json
index 89891ea4d..4686bb6de 100644
--- a/.agents/skills/impeccable/scripts/command-metadata.json
+++ b/.agents/skills/impeccable/scripts/command-metadata.json
@@ -4,7 +4,7 @@
"argumentHint": "[feature description]"
},
"init": {
- "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); offers DESIGN.md (visual: colors, typography, components) when code exists; pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
+ "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
"argumentHint": ""
},
"document": {
@@ -88,7 +88,7 @@
"argumentHint": "[target]"
},
"shape": {
- "description": "Plan UX and UI before code. Runs a required multi-round discovery interview, uses visual probes when available, and produces a user-confirmed design brief for implementation.",
+ "description": "Plan UX and UI before code. Runs a discovery interview (one round by default), uses visual probes when available, and produces a user-confirmed design brief for implementation.",
"argumentHint": "[feature to shape]"
},
"typeset": {
diff --git a/.agents/skills/impeccable/scripts/live-browser.js b/.agents/skills/impeccable/scripts/live-browser.js
index 504e75b9c..a63f1abe2 100644
--- a/.agents/skills/impeccable/scripts/live-browser.js
+++ b/.agents/skills/impeccable/scripts/live-browser.js
@@ -3271,6 +3271,14 @@
const P = paramsPanelPalette || barPaletteForTheme(detectPageTheme());
paramsPanelBody.innerHTML = '';
for (const p of params) {
+ // A knob the panel shows must be in the live values and on the variant,
+ // or accept drops it and the preview ignores it. Seed only missing keys
+ // so a reopen keeps edits.
+ if (!Object.hasOwn(paramsCurrentValues, p.id)) {
+ paramsCurrentValues[p.id] = p.default;
+ applyParamValue(variantEl, p, p.default);
+ }
+ const value = paramsCurrentValues[p.id];
const row = el('div', { display: 'flex', flexDirection: 'column', gap: '6px' });
const labelRow = el('div', {
display: 'flex', justifyContent: 'space-between',
@@ -3295,7 +3303,7 @@
input.min = String(p.min != null ? p.min : 0);
input.max = String(p.max != null ? p.max : 1);
input.step = String(p.step != null ? p.step : 0.05);
- input.value = String(p.default);
+ input.value = String(value);
Object.assign(input.style, {
width: '100%', accentColor: C.brand, cursor: 'pointer',
});
@@ -3310,7 +3318,7 @@
});
row.appendChild(input);
} else if (p.kind === 'toggle') {
- const initial = !!p.default;
+ const initial = !!value;
readout.textContent = initial ? 'On' : 'Off';
const track = el('button', {
position: 'relative', width: '36px', height: '20px',
@@ -3344,8 +3352,8 @@
const opts = (p.options || []).map(o =>
typeof o === 'string' ? { value: o, label: o } : o
);
- const activeOpt = opts.find(o => o.value === p.default) || opts[0];
- readout.textContent = activeOpt ? activeOpt.label : String(p.default);
+ const activeOpt = opts.find(o => o.value === value) || opts[0];
+ readout.textContent = activeOpt ? activeOpt.label : String(value);
const segRow = el('div', {
display: 'grid',
gridTemplateColumns: 'repeat(' + opts.length + ', 1fr)',
@@ -3354,7 +3362,7 @@
});
const segBtns = [];
opts.forEach(o => {
- const active = o.value === p.default;
+ const active = o.value === value;
const b = el('button', {
padding: '5px 4px', border: 'none', borderRadius: '3px',
background: active ? C.brand : 'transparent',
@@ -4988,8 +4996,8 @@
const variantEl = getVisibleVariantEl();
const params = parseVariantParams(variantEl);
if (!variantEl || params.length === 0) return;
- // Build fresh to ensure the current variant's controls are shown.
- applyParamDefaults(variantEl, params);
+ // Rebuild the controls from the current values. Defaults are applied
+ // when the variant is initialized, not when its Tune panel is reopened.
buildParamsPanel(variantEl, params);
tuneOpen = true;
showParamsPanel();
diff --git a/.claude/skills/impeccable/reference/android.md b/.claude/skills/impeccable/reference/android.md
index 1f67a6bb5..32a5cf7cc 100644
--- a/.claude/skills/impeccable/reference/android.md
+++ b/.claude/skills/impeccable/reference/android.md
@@ -42,5 +42,5 @@ Would a fluent Android user trust this app, or trip on off-spec components? The
## Verifying the build
- **Screenshots come from the emulator or a connected device, never a browser.** Build and install, then capture with `adb exec-out screencap -p > <path>` (pick a device with `adb -s <serial>` when several are attached). Capture every device class the app ships to, at least one phone and, when tablets are a target, one tablet, and write the files where the review flow expects them.
-- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (restore `1.0` after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
+- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (read both settings first with `adb shell cmd uimode night` and `adb shell settings get system font_scale`, and restore them after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
- **Emulators give breadth; gestures, refresh rates, and performance need hardware.** Say which one produced the evidence.
diff --git a/.claude/skills/impeccable/reference/audit.md b/.claude/skills/impeccable/reference/audit.md
index 5669a83d8..41033f119 100644
--- a/.claude/skills/impeccable/reference/audit.md
+++ b/.claude/skills/impeccable/reference/audit.md
@@ -11,7 +11,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
### 1. Accessibility (A11y)
**Check for**:
-- **Contrast issues**: Text contrast ratios < 4.5:1 (or 7:1 for AAA)
+- **Contrast issues**: Text contrast ratios < 4.5:1, or < 3:1 for large text (or 7:1 for AAA)
- **Motion sensitivity**: `prefers-reduced-motion` needs an intentional alternative that preserves state change and hierarchy; flag a global `0.01ms` kill that destroys useful feedback, flashing above threshold, and motion that blocks focus, reading, or task completion
- **Missing ARIA**: Interactive elements without proper roles, labels, or states
- **Keyboard navigation**: Missing focus indicators, illogical tab order, keyboard traps
@@ -47,7 +47,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
**Check for**:
- **Fixed widths**: Hard-coded widths that break on mobile
-- **Touch targets**: Interactive elements < 44x44px
+- **Touch targets**: Interactive elements < 44x44px. WCAG AA (SC 2.5.8) requires at least 24x24 CSS px unless an exception applies: spacing, an equivalent control, inline text, user-agent styling, or an essential size. Spacing passes when a 24 CSS px circle centered on the target's bounding box overlaps no other target and no other undersized target's circle
- **Broken touch interaction**: Custom sliders, drag surfaces, and scrollable control strips whose primary gesture fails under touch, that swallow page scroll or lose the drag to it, or that stay stuck after an interrupted gesture. Code tells: mouse-only handlers, no `touch-action` on a pointer-event drag surface, drag state that nothing clears on cancel, lost capture, or blur. Exercise the gesture when a browser tool can synthesize touch (a rendered viewport proves layout, not the gesture), then say what produced the evidence (emulated viewport, synthesized touch, which engine, physical device) and what stayed untested
- **Horizontal scroll**: Content overflow on narrow viewports
- **Text scaling**: Layouts that break when text size increases
diff --git a/.claude/skills/impeccable/reference/distill.md b/.claude/skills/impeccable/reference/distill.md
index 6943c965b..d7c525d92 100644
--- a/.claude/skills/impeccable/reference/distill.md
+++ b/.claude/skills/impeccable/reference/distill.md
@@ -41,7 +41,7 @@ Expect to say no to good ideas to make room for great execution.
Systematically remove complexity across these dimensions:
### Information Architecture
-- **Reduce scope**: Remove secondary actions, optional features, redundant information
+- **Reduce scope**: Remove secondary actions, redundant information
- **Progressive disclosure**: Hide complexity behind clear entry points (accordions, modals, step-through flows)
- **Combine related actions**: Merge similar buttons, consolidate forms, group related content
- **Clear hierarchy**: ONE primary action, few secondary actions, everything else tertiary or hidden
@@ -70,11 +70,11 @@ Systematically remove complexity across these dimensions:
- **Clear next action**: ONE obvious next action, not five competing ones
### Content Simplification
-- **Shorter copy**: Cut every sentence in half, then do it again
+- **Shorter copy**: Cut filler, not meaning
- **Active voice**: "Save changes" not "Changes will be saved"
- **Remove jargon**: Plain language always wins
- **Scannable structure**: Short paragraphs, bullet points, clear headings
-- **Essential information only**: Remove marketing fluff, legalese, hedging
+- **Essential information only**: Remove marketing fluff, hedging
- **Remove redundant copy**: No headers restating intros, no repeated explanations, say it once
### Code Simplification
diff --git a/.claude/skills/impeccable/reference/doctor.md b/.claude/skills/impeccable/reference/doctor.md
index e73daa7d1..438b8aac8 100644
--- a/.claude/skills/impeccable/reference/doctor.md
+++ b/.claude/skills/impeccable/reference/doctor.md
@@ -6,7 +6,7 @@ This is maintenance, not design. Do not redesign anything, do not open files out
Three kinds of drift travel under "out of date". Keep them apart:
-- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it. Not this command's job.
+- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it, or the harness's plugin manager for a plugin install. Not this command's job.
- **Schema drift.** An artifact was written by an older Impeccable: fields nothing reads, fields now expected, files in retired locations. Mechanical, and this command repairs most of it.
- **Truth drift.** The code moved on and the document no longer describes it. No file comparison settles this. `document` owns DESIGN.md, `init` owns PRODUCT.md, and this command's job is to hand them a specific gap rather than a vague suspicion.
diff --git a/.claude/skills/impeccable/reference/document.md b/.claude/skills/impeccable/reference/document.md
index b5e50d5ed..879ba4e86 100644
--- a/.claude/skills/impeccable/reference/document.md
+++ b/.claude/skills/impeccable/reference/document.md
@@ -17,10 +17,10 @@ colors:
typography:
display:
fontFamily: "Cormorant Garamond, Georgia, serif"
- fontSize: "clamp(2.5rem, 7vw, 4.5rem)"
+ fontSize: "4.5rem"
fontWeight: 300
lineHeight: 1
- letterSpacing: "normal"
+ letterSpacing: "0em"
body:
# ...
rounded:
@@ -325,7 +325,7 @@ If the project has **no component library yet** (bare landing page, new project)
#### Tonal ramps
-For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue and chroma, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
+For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue, chroma reduced near white and black, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
#### Narrative mapping
diff --git a/.claude/skills/impeccable/reference/live.md b/.claude/skills/impeccable/reference/live.md
index bf38f83af..fb598f2ca 100644
--- a/.claude/skills/impeccable/reference/live.md
+++ b/.claude/skills/impeccable/reference/live.md
@@ -158,14 +158,14 @@ Sources in priority order: DESIGN.md's visual system fields; CSS custom properti
**Default:** compare each variant against the Phase A lock; palette, type voice, or rhetoric drift means it crossed into departure by accident: rework. Then confirm three different primary axes; three "tighter density" variants is failure. **Departure:** two passes, family before sentence. Family pass (non-negotiable): label each variant with a concrete family of your own choosing; shared or interchangeable labels mean rework. Sentence pass: three one-line descriptions side by side; two that rhyme mean rework. When the primary axis is color or theme, the trio must not share theme + dominant hue: three color worlds, not three shades.
-**Action-specific invocations** must vary along the action's dimension:
+**Action-specific invocations** must vary along the action's dimension; in default mode every variation stays within the available faces and existing tokens:
- `bolder`: amplify a different dimension per variant (scale / saturation / structural change).
- `quieter`: pull back a different dimension (color / ornament / spacing).
- `distill`: remove a different class of excess (visual noise / redundant content / nested structure).
- `polish`: a different refinement axis (rhythm / hierarchy / micro-details).
-- `typeset`: different pairing AND different scale ratio each.
-- `colorize`: different hue family each; vary chroma and contrast strategy.
+- `typeset`: departure varies the pairing AND the scale ratio each; default keeps the faces and varies scale ratio, case, and weight each.
+- `colorize`: departure gives each a different hue family and varies chroma and contrast strategy; default gives each a different existing palette role carrying the surface (Restrained / Committed / Full palette / Drenched) and a different contrast strategy.
- `layout`: different structural arrangement, not spacing tweaks.
- `adapt`: different target context per variant (mobile-first / tablet / desktop / print or low-data).
- `animate`: different motion vocabulary (cascade stagger / clip wipe / scale-and-focus / morph / parallax).
diff --git a/.claude/skills/impeccable/reference/optimize.md b/.claude/skills/impeccable/reference/optimize.md
index 5c55a1642..3f3fc7c33 100644
--- a/.claude/skills/impeccable/reference/optimize.md
+++ b/.claude/skills/impeccable/reference/optimize.md
@@ -38,7 +38,6 @@ Create systematic improvement plan:
src="hero.webp"
srcset="hero-400.webp 400w, hero-800.webp 800w, hero-1200.webp 1200w"
sizes="(max-width: 400px) 400px, (max-width: 800px) 800px, 1200px"
- loading="lazy"
alt="Hero image"
/>
```
diff --git a/.claude/skills/impeccable/reference/visualize.md b/.claude/skills/impeccable/reference/visualize.md
index 9e1ccee6d..88c09cbbe 100644
--- a/.claude/skills/impeccable/reference/visualize.md
+++ b/.claude/skills/impeccable/reference/visualize.md
@@ -26,7 +26,7 @@ Each comp is a direction test, not a screenshot specification. Core UI text, res
Show the three together on the decision page (`impeccable serve-question`, one option per comp with the comp as its hero), or in the harness only when it renders images inline; a text-only surface does not count as display. Ask what should carry forward, what feels false to the world, and whether the selected concept should be approved, combined, revised, or rejected. Then stop and wait. A structured simulated user counts as attended and receives the same question.
-Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md, and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
+Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md (the chosen direction on a new world), and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
This approval point has no substitute and no skip condition. When the structured question tool errors, fall back to the decision page; only after both fail may you treat the choice as delegated, and a delegated pick is recorded exactly as an approval is and disclosed in your first reply, not your last. The finish reviewer treats comp-round comps with no recorded approval as a material finding; decision comps under `.impeccable/mocks/decision/` are the direction round's hand, not comp-round output, and imply no approval on their own.
diff --git a/.claude/skills/impeccable/scripts/command-metadata.json b/.claude/skills/impeccable/scripts/command-metadata.json
index 89891ea4d..4686bb6de 100644
--- a/.claude/skills/impeccable/scripts/command-metadata.json
+++ b/.claude/skills/impeccable/scripts/command-metadata.json
@@ -4,7 +4,7 @@
"argumentHint": "[feature description]"
},
"init": {
- "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); offers DESIGN.md (visual: colors, typography, components) when code exists; pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
+ "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
"argumentHint": ""
},
"document": {
@@ -88,7 +88,7 @@
"argumentHint": "[target]"
},
"shape": {
- "description": "Plan UX and UI before code. Runs a required multi-round discovery interview, uses visual probes when available, and produces a user-confirmed design brief for implementation.",
+ "description": "Plan UX and UI before code. Runs a discovery interview (one round by default), uses visual probes when available, and produces a user-confirmed design brief for implementation.",
"argumentHint": "[feature to shape]"
},
"typeset": {
diff --git a/.claude/skills/impeccable/scripts/live-browser.js b/.claude/skills/impeccable/scripts/live-browser.js
index 504e75b9c..a63f1abe2 100644
--- a/.claude/skills/impeccable/scripts/live-browser.js
+++ b/.claude/skills/impeccable/scripts/live-browser.js
@@ -3271,6 +3271,14 @@
const P = paramsPanelPalette || barPaletteForTheme(detectPageTheme());
paramsPanelBody.innerHTML = '';
for (const p of params) {
+ // A knob the panel shows must be in the live values and on the variant,
+ // or accept drops it and the preview ignores it. Seed only missing keys
+ // so a reopen keeps edits.
+ if (!Object.hasOwn(paramsCurrentValues, p.id)) {
+ paramsCurrentValues[p.id] = p.default;
+ applyParamValue(variantEl, p, p.default);
+ }
+ const value = paramsCurrentValues[p.id];
const row = el('div', { display: 'flex', flexDirection: 'column', gap: '6px' });
const labelRow = el('div', {
display: 'flex', justifyContent: 'space-between',
@@ -3295,7 +3303,7 @@
input.min = String(p.min != null ? p.min : 0);
input.max = String(p.max != null ? p.max : 1);
input.step = String(p.step != null ? p.step : 0.05);
- input.value = String(p.default);
+ input.value = String(value);
Object.assign(input.style, {
width: '100%', accentColor: C.brand, cursor: 'pointer',
});
@@ -3310,7 +3318,7 @@
});
row.appendChild(input);
} else if (p.kind === 'toggle') {
- const initial = !!p.default;
+ const initial = !!value;
readout.textContent = initial ? 'On' : 'Off';
const track = el('button', {
position: 'relative', width: '36px', height: '20px',
@@ -3344,8 +3352,8 @@
const opts = (p.options || []).map(o =>
typeof o === 'string' ? { value: o, label: o } : o
);
- const activeOpt = opts.find(o => o.value === p.default) || opts[0];
- readout.textContent = activeOpt ? activeOpt.label : String(p.default);
+ const activeOpt = opts.find(o => o.value === value) || opts[0];
+ readout.textContent = activeOpt ? activeOpt.label : String(value);
const segRow = el('div', {
display: 'grid',
gridTemplateColumns: 'repeat(' + opts.length + ', 1fr)',
@@ -3354,7 +3362,7 @@
});
const segBtns = [];
opts.forEach(o => {
- const active = o.value === p.default;
+ const active = o.value === value;
const b = el('button', {
padding: '5px 4px', border: 'none', borderRadius: '3px',
background: active ? C.brand : 'transparent',
@@ -4988,8 +4996,8 @@
const variantEl = getVisibleVariantEl();
const params = parseVariantParams(variantEl);
if (!variantEl || params.length === 0) return;
- // Build fresh to ensure the current variant's controls are shown.
- applyParamDefaults(variantEl, params);
+ // Rebuild the controls from the current values. Defaults are applied
+ // when the variant is initialized, not when its Tune panel is reopened.
buildParamsPanel(variantEl, params);
tuneOpen = true;
showParamsPanel();
diff --git a/.cursor/skills/impeccable/reference/android.md b/.cursor/skills/impeccable/reference/android.md
index 1f67a6bb5..32a5cf7cc 100644
--- a/.cursor/skills/impeccable/reference/android.md
+++ b/.cursor/skills/impeccable/reference/android.md
@@ -42,5 +42,5 @@ Would a fluent Android user trust this app, or trip on off-spec components? The
## Verifying the build
- **Screenshots come from the emulator or a connected device, never a browser.** Build and install, then capture with `adb exec-out screencap -p > <path>` (pick a device with `adb -s <serial>` when several are attached). Capture every device class the app ships to, at least one phone and, when tablets are a target, one tablet, and write the files where the review flow expects them.
-- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (restore `1.0` after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
+- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (read both settings first with `adb shell cmd uimode night` and `adb shell settings get system font_scale`, and restore them after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
- **Emulators give breadth; gestures, refresh rates, and performance need hardware.** Say which one produced the evidence.
diff --git a/.cursor/skills/impeccable/reference/audit.md b/.cursor/skills/impeccable/reference/audit.md
index c1e150638..d8f79f2b4 100644
--- a/.cursor/skills/impeccable/reference/audit.md
+++ b/.cursor/skills/impeccable/reference/audit.md
@@ -11,7 +11,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
### 1. Accessibility (A11y)
**Check for**:
-- **Contrast issues**: Text contrast ratios < 4.5:1 (or 7:1 for AAA)
+- **Contrast issues**: Text contrast ratios < 4.5:1, or < 3:1 for large text (or 7:1 for AAA)
- **Motion sensitivity**: `prefers-reduced-motion` needs an intentional alternative that preserves state change and hierarchy; flag a global `0.01ms` kill that destroys useful feedback, flashing above threshold, and motion that blocks focus, reading, or task completion
- **Missing ARIA**: Interactive elements without proper roles, labels, or states
- **Keyboard navigation**: Missing focus indicators, illogical tab order, keyboard traps
@@ -47,7 +47,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
**Check for**:
- **Fixed widths**: Hard-coded widths that break on mobile
-- **Touch targets**: Interactive elements < 44x44px
+- **Touch targets**: Interactive elements < 44x44px. WCAG AA (SC 2.5.8) requires at least 24x24 CSS px unless an exception applies: spacing, an equivalent control, inline text, user-agent styling, or an essential size. Spacing passes when a 24 CSS px circle centered on the target's bounding box overlaps no other target and no other undersized target's circle
- **Broken touch interaction**: Custom sliders, drag surfaces, and scrollable control strips whose primary gesture fails under touch, that swallow page scroll or lose the drag to it, or that stay stuck after an interrupted gesture. Code tells: mouse-only handlers, no `touch-action` on a pointer-event drag surface, drag state that nothing clears on cancel, lost capture, or blur. Exercise the gesture when a browser tool can synthesize touch (a rendered viewport proves layout, not the gesture), then say what produced the evidence (emulated viewport, synthesized touch, which engine, physical device) and what stayed untested
- **Horizontal scroll**: Content overflow on narrow viewports
- **Text scaling**: Layouts that break when text size increases
diff --git a/.cursor/skills/impeccable/reference/distill.md b/.cursor/skills/impeccable/reference/distill.md
index 757630fae..a49697136 100644
--- a/.cursor/skills/impeccable/reference/distill.md
+++ b/.cursor/skills/impeccable/reference/distill.md
@@ -41,7 +41,7 @@ Expect to say no to good ideas to make room for great execution.
Systematically remove complexity across these dimensions:
### Information Architecture
-- **Reduce scope**: Remove secondary actions, optional features, redundant information
+- **Reduce scope**: Remove secondary actions, redundant information
- **Progressive disclosure**: Hide complexity behind clear entry points (accordions, modals, step-through flows)
- **Combine related actions**: Merge similar buttons, consolidate forms, group related content
- **Clear hierarchy**: ONE primary action, few secondary actions, everything else tertiary or hidden
@@ -70,11 +70,11 @@ Systematically remove complexity across these dimensions:
- **Clear next action**: ONE obvious next action, not five competing ones
### Content Simplification
-- **Shorter copy**: Cut every sentence in half, then do it again
+- **Shorter copy**: Cut filler, not meaning
- **Active voice**: "Save changes" not "Changes will be saved"
- **Remove jargon**: Plain language always wins
- **Scannable structure**: Short paragraphs, bullet points, clear headings
-- **Essential information only**: Remove marketing fluff, legalese, hedging
+- **Essential information only**: Remove marketing fluff, hedging
- **Remove redundant copy**: No headers restating intros, no repeated explanations, say it once
### Code Simplification
diff --git a/.cursor/skills/impeccable/reference/doctor.md b/.cursor/skills/impeccable/reference/doctor.md
index 7dc23b67e..a09e34373 100644
--- a/.cursor/skills/impeccable/reference/doctor.md
+++ b/.cursor/skills/impeccable/reference/doctor.md
@@ -6,7 +6,7 @@ This is maintenance, not design. Do not redesign anything, do not open files out
Three kinds of drift travel under "out of date". Keep them apart:
-- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it. Not this command's job.
+- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it, or the harness's plugin manager for a plugin install. Not this command's job.
- **Schema drift.** An artifact was written by an older Impeccable: fields nothing reads, fields now expected, files in retired locations. Mechanical, and this command repairs most of it.
- **Truth drift.** The code moved on and the document no longer describes it. No file comparison settles this. `document` owns DESIGN.md, `init` owns PRODUCT.md, and this command's job is to hand them a specific gap rather than a vague suspicion.
diff --git a/.cursor/skills/impeccable/reference/document.md b/.cursor/skills/impeccable/reference/document.md
index 9da0bc743..ec75b7cc7 100644
--- a/.cursor/skills/impeccable/reference/document.md
+++ b/.cursor/skills/impeccable/reference/document.md
@@ -17,10 +17,10 @@ colors:
typography:
display:
fontFamily: "Cormorant Garamond, Georgia, serif"
- fontSize: "clamp(2.5rem, 7vw, 4.5rem)"
+ fontSize: "4.5rem"
fontWeight: 300
lineHeight: 1
- letterSpacing: "normal"
+ letterSpacing: "0em"
body:
# ...
rounded:
@@ -325,7 +325,7 @@ If the project has **no component library yet** (bare landing page, new project)
#### Tonal ramps
-For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue and chroma, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
+For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue, chroma reduced near white and black, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
#### Narrative mapping
diff --git a/.cursor/skills/impeccable/reference/live.md b/.cursor/skills/impeccable/reference/live.md
index 54d897491..0e4b97596 100644
--- a/.cursor/skills/impeccable/reference/live.md
+++ b/.cursor/skills/impeccable/reference/live.md
@@ -158,14 +158,14 @@ Sources in priority order: DESIGN.md's visual system fields; CSS custom properti
**Default:** compare each variant against the Phase A lock; palette, type voice, or rhetoric drift means it crossed into departure by accident: rework. Then confirm three different primary axes; three "tighter density" variants is failure. **Departure:** two passes, family before sentence. Family pass (non-negotiable): label each variant with a concrete family of your own choosing; shared or interchangeable labels mean rework. Sentence pass: three one-line descriptions side by side; two that rhyme mean rework. When the primary axis is color or theme, the trio must not share theme + dominant hue: three color worlds, not three shades.
-**Action-specific invocations** must vary along the action's dimension:
+**Action-specific invocations** must vary along the action's dimension; in default mode every variation stays within the available faces and existing tokens:
- `bolder`: amplify a different dimension per variant (scale / saturation / structural change).
- `quieter`: pull back a different dimension (color / ornament / spacing).
- `distill`: remove a different class of excess (visual noise / redundant content / nested structure).
- `polish`: a different refinement axis (rhythm / hierarchy / micro-details).
-- `typeset`: different pairing AND different scale ratio each.
-- `colorize`: different hue family each; vary chroma and contrast strategy.
+- `typeset`: departure varies the pairing AND the scale ratio each; default keeps the faces and varies scale ratio, case, and weight each.
+- `colorize`: departure gives each a different hue family and varies chroma and contrast strategy; default gives each a different existing palette role carrying the surface (Restrained / Committed / Full palette / Drenched) and a different contrast strategy.
- `layout`: different structural arrangement, not spacing tweaks.
- `adapt`: different target context per variant (mobile-first / tablet / desktop / print or low-data).
- `animate`: different motion vocabulary (cascade stagger / clip wipe / scale-and-focus / morph / parallax).
diff --git a/.cursor/skills/impeccable/reference/optimize.md b/.cursor/skills/impeccable/reference/optimize.md
index 5c55a1642..3f3fc7c33 100644
--- a/.cursor/skills/impeccable/reference/optimize.md
+++ b/.cursor/skills/impeccable/reference/optimize.md
@@ -38,7 +38,6 @@ Create systematic improvement plan:
src="hero.webp"
srcset="hero-400.webp 400w, hero-800.webp 800w, hero-1200.webp 1200w"
sizes="(max-width: 400px) 400px, (max-width: 800px) 800px, 1200px"
- loading="lazy"
alt="Hero image"
/>
```
diff --git a/.cursor/skills/impeccable/reference/visualize.md b/.cursor/skills/impeccable/reference/visualize.md
index 48c26814a..f628950a0 100644
--- a/.cursor/skills/impeccable/reference/visualize.md
+++ b/.cursor/skills/impeccable/reference/visualize.md
@@ -26,7 +26,7 @@ Each comp is a direction test, not a screenshot specification. Core UI text, res
Show the three together on the decision page (`impeccable serve-question`, one option per comp with the comp as its hero), or in the harness only when it renders images inline; a text-only surface does not count as display. Ask what should carry forward, what feels false to the world, and whether the selected concept should be approved, combined, revised, or rejected. Then stop and wait. A structured simulated user counts as attended and receives the same question.
-Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md, and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
+Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md (the chosen direction on a new world), and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
This approval point has no substitute and no skip condition. When the structured question tool errors, fall back to the decision page; only after both fail may you treat the choice as delegated, and a delegated pick is recorded exactly as an approval is and disclosed in your first reply, not your last. The finish reviewer treats comp-round comps with no recorded approval as a material finding; decision comps under `.impeccable/mocks/decision/` are the direction round's hand, not comp-round output, and imply no approval on their own.
diff --git a/.cursor/skills/impeccable/scripts/command-metadata.json b/.cursor/skills/impeccable/scripts/command-metadata.json
index 89891ea4d..4686bb6de 100644
--- a/.cursor/skills/impeccable/scripts/command-metadata.json
+++ b/.cursor/skills/impeccable/scripts/command-metadata.json
@@ -4,7 +4,7 @@
"argumentHint": "[feature description]"
},
"init": {
- "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); offers DESIGN.md (visual: colors, typography, components) when code exists; pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
+ "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
"argumentHint": ""
},
"document": {
@@ -88,7 +88,7 @@
"argumentHint": "[target]"
},
"shape": {
- "description": "Plan UX and UI before code. Runs a required multi-round discovery interview, uses visual probes when available, and produces a user-confirmed design brief for implementation.",
+ "description": "Plan UX and UI before code. Runs a discovery interview (one round by default), uses visual probes when available, and produces a user-confirmed design brief for implementation.",
"argumentHint": "[feature to shape]"
},
"typeset": {
diff --git a/.cursor/skills/impeccable/scripts/live-browser.js b/.cursor/skills/impeccable/scripts/live-browser.js
index 504e75b9c..a63f1abe2 100644
--- a/.cursor/skills/impeccable/scripts/live-browser.js
+++ b/.cursor/skills/impeccable/scripts/live-browser.js
@@ -3271,6 +3271,14 @@
const P = paramsPanelPalette || barPaletteForTheme(detectPageTheme());
paramsPanelBody.innerHTML = '';
for (const p of params) {
+ // A knob the panel shows must be in the live values and on the variant,
+ // or accept drops it and the preview ignores it. Seed only missing keys
+ // so a reopen keeps edits.
+ if (!Object.hasOwn(paramsCurrentValues, p.id)) {
+ paramsCurrentValues[p.id] = p.default;
+ applyParamValue(variantEl, p, p.default);
+ }
+ const value = paramsCurrentValues[p.id];
const row = el('div', { display: 'flex', flexDirection: 'column', gap: '6px' });
const labelRow = el('div', {
display: 'flex', justifyContent: 'space-between',
@@ -3295,7 +3303,7 @@
input.min = String(p.min != null ? p.min : 0);
input.max = String(p.max != null ? p.max : 1);
input.step = String(p.step != null ? p.step : 0.05);
- input.value = String(p.default);
+ input.value = String(value);
Object.assign(input.style, {
width: '100%', accentColor: C.brand, cursor: 'pointer',
});
@@ -3310,7 +3318,7 @@
});
row.appendChild(input);
} else if (p.kind === 'toggle') {
- const initial = !!p.default;
+ const initial = !!value;
readout.textContent = initial ? 'On' : 'Off';
const track = el('button', {
position: 'relative', width: '36px', height: '20px',
@@ -3344,8 +3352,8 @@
const opts = (p.options || []).map(o =>
typeof o === 'string' ? { value: o, label: o } : o
);
- const activeOpt = opts.find(o => o.value === p.default) || opts[0];
- readout.textContent = activeOpt ? activeOpt.label : String(p.default);
+ const activeOpt = opts.find(o => o.value === value) || opts[0];
+ readout.textContent = activeOpt ? activeOpt.label : String(value);
const segRow = el('div', {
display: 'grid',
gridTemplateColumns: 'repeat(' + opts.length + ', 1fr)',
@@ -3354,7 +3362,7 @@
});
const segBtns = [];
opts.forEach(o => {
- const active = o.value === p.default;
+ const active = o.value === value;
const b = el('button', {
padding: '5px 4px', border: 'none', borderRadius: '3px',
background: active ? C.brand : 'transparent',
@@ -4988,8 +4996,8 @@
const variantEl = getVisibleVariantEl();
const params = parseVariantParams(variantEl);
if (!variantEl || params.length === 0) return;
- // Build fresh to ensure the current variant's controls are shown.
- applyParamDefaults(variantEl, params);
+ // Rebuild the controls from the current values. Defaults are applied
+ // when the variant is initialized, not when its Tune panel is reopened.
buildParamsPanel(variantEl, params);
tuneOpen = true;
showParamsPanel();
diff --git a/.dsh/skills/impeccable/reference/android.md b/.dsh/skills/impeccable/reference/android.md
index 1f67a6bb5..32a5cf7cc 100644
--- a/.dsh/skills/impeccable/reference/android.md
+++ b/.dsh/skills/impeccable/reference/android.md
@@ -42,5 +42,5 @@ Would a fluent Android user trust this app, or trip on off-spec components? The
## Verifying the build
- **Screenshots come from the emulator or a connected device, never a browser.** Build and install, then capture with `adb exec-out screencap -p > <path>` (pick a device with `adb -s <serial>` when several are attached). Capture every device class the app ships to, at least one phone and, when tablets are a target, one tablet, and write the files where the review flow expects them.
-- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (restore `1.0` after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
+- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (read both settings first with `adb shell cmd uimode night` and `adb shell settings get system font_scale`, and restore them after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
- **Emulators give breadth; gestures, refresh rates, and performance need hardware.** Say which one produced the evidence.
diff --git a/.dsh/skills/impeccable/reference/audit.md b/.dsh/skills/impeccable/reference/audit.md
index 0468f1bdd..40b9fb75f 100644
--- a/.dsh/skills/impeccable/reference/audit.md
+++ b/.dsh/skills/impeccable/reference/audit.md
@@ -11,7 +11,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
### 1. Accessibility (A11y)
**Check for**:
-- **Contrast issues**: Text contrast ratios < 4.5:1 (or 7:1 for AAA)
+- **Contrast issues**: Text contrast ratios < 4.5:1, or < 3:1 for large text (or 7:1 for AAA)
- **Motion sensitivity**: `prefers-reduced-motion` needs an intentional alternative that preserves state change and hierarchy; flag a global `0.01ms` kill that destroys useful feedback, flashing above threshold, and motion that blocks focus, reading, or task completion
- **Missing ARIA**: Interactive elements without proper roles, labels, or states
- **Keyboard navigation**: Missing focus indicators, illogical tab order, keyboard traps
@@ -47,7 +47,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
**Check for**:
- **Fixed widths**: Hard-coded widths that break on mobile
-- **Touch targets**: Interactive elements < 44x44px
+- **Touch targets**: Interactive elements < 44x44px. WCAG AA (SC 2.5.8) requires at least 24x24 CSS px unless an exception applies: spacing, an equivalent control, inline text, user-agent styling, or an essential size. Spacing passes when a 24 CSS px circle centered on the target's bounding box overlaps no other target and no other undersized target's circle
- **Broken touch interaction**: Custom sliders, drag surfaces, and scrollable control strips whose primary gesture fails under touch, that swallow page scroll or lose the drag to it, or that stay stuck after an interrupted gesture. Code tells: mouse-only handlers, no `touch-action` on a pointer-event drag surface, drag state that nothing clears on cancel, lost capture, or blur. Exercise the gesture when a browser tool can synthesize touch (a rendered viewport proves layout, not the gesture), then say what produced the evidence (emulated viewport, synthesized touch, which engine, physical device) and what stayed untested
- **Horizontal scroll**: Content overflow on narrow viewports
- **Text scaling**: Layouts that break when text size increases
diff --git a/.dsh/skills/impeccable/reference/distill.md b/.dsh/skills/impeccable/reference/distill.md
index f450f7b42..f560dc898 100644
--- a/.dsh/skills/impeccable/reference/distill.md
+++ b/.dsh/skills/impeccable/reference/distill.md
@@ -41,7 +41,7 @@ Expect to say no to good ideas to make room for great execution.
Systematically remove complexity across these dimensions:
### Information Architecture
-- **Reduce scope**: Remove secondary actions, optional features, redundant information
+- **Reduce scope**: Remove secondary actions, redundant information
- **Progressive disclosure**: Hide complexity behind clear entry points (accordions, modals, step-through flows)
- **Combine related actions**: Merge similar buttons, consolidate forms, group related content
- **Clear hierarchy**: ONE primary action, few secondary actions, everything else tertiary or hidden
@@ -70,11 +70,11 @@ Systematically remove complexity across these dimensions:
- **Clear next action**: ONE obvious next action, not five competing ones
### Content Simplification
-- **Shorter copy**: Cut every sentence in half, then do it again
+- **Shorter copy**: Cut filler, not meaning
- **Active voice**: "Save changes" not "Changes will be saved"
- **Remove jargon**: Plain language always wins
- **Scannable structure**: Short paragraphs, bullet points, clear headings
-- **Essential information only**: Remove marketing fluff, legalese, hedging
+- **Essential information only**: Remove marketing fluff, hedging
- **Remove redundant copy**: No headers restating intros, no repeated explanations, say it once
### Code Simplification
diff --git a/.dsh/skills/impeccable/reference/doctor.md b/.dsh/skills/impeccable/reference/doctor.md
index 7be558e90..cfd4fe95c 100644
--- a/.dsh/skills/impeccable/reference/doctor.md
+++ b/.dsh/skills/impeccable/reference/doctor.md
@@ -6,7 +6,7 @@ This is maintenance, not design. Do not redesign anything, do not open files out
Three kinds of drift travel under "out of date". Keep them apart:
-- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it. Not this command's job.
+- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it, or the harness's plugin manager for a plugin install. Not this command's job.
- **Schema drift.** An artifact was written by an older Impeccable: fields nothing reads, fields now expected, files in retired locations. Mechanical, and this command repairs most of it.
- **Truth drift.** The code moved on and the document no longer describes it. No file comparison settles this. `document` owns DESIGN.md, `init` owns PRODUCT.md, and this command's job is to hand them a specific gap rather than a vague suspicion.
diff --git a/.dsh/skills/impeccable/reference/document.md b/.dsh/skills/impeccable/reference/document.md
index 2d0312a79..e9215eef8 100644
--- a/.dsh/skills/impeccable/reference/document.md
+++ b/.dsh/skills/impeccable/reference/document.md
@@ -17,10 +17,10 @@ colors:
typography:
display:
fontFamily: "Cormorant Garamond, Georgia, serif"
- fontSize: "clamp(2.5rem, 7vw, 4.5rem)"
+ fontSize: "4.5rem"
fontWeight: 300
lineHeight: 1
- letterSpacing: "normal"
+ letterSpacing: "0em"
body:
# ...
rounded:
@@ -325,7 +325,7 @@ If the project has **no component library yet** (bare landing page, new project)
#### Tonal ramps
-For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue and chroma, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
+For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue, chroma reduced near white and black, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
#### Narrative mapping
diff --git a/.dsh/skills/impeccable/reference/live.md b/.dsh/skills/impeccable/reference/live.md
index 2efb4469e..19cf78242 100644
--- a/.dsh/skills/impeccable/reference/live.md
+++ b/.dsh/skills/impeccable/reference/live.md
@@ -158,14 +158,14 @@ Sources in priority order: DESIGN.md's visual system fields; CSS custom properti
**Default:** compare each variant against the Phase A lock; palette, type voice, or rhetoric drift means it crossed into departure by accident: rework. Then confirm three different primary axes; three "tighter density" variants is failure. **Departure:** two passes, family before sentence. Family pass (non-negotiable): label each variant with a concrete family of your own choosing; shared or interchangeable labels mean rework. Sentence pass: three one-line descriptions side by side; two that rhyme mean rework. When the primary axis is color or theme, the trio must not share theme + dominant hue: three color worlds, not three shades.
-**Action-specific invocations** must vary along the action's dimension:
+**Action-specific invocations** must vary along the action's dimension; in default mode every variation stays within the available faces and existing tokens:
- `bolder`: amplify a different dimension per variant (scale / saturation / structural change).
- `quieter`: pull back a different dimension (color / ornament / spacing).
- `distill`: remove a different class of excess (visual noise / redundant content / nested structure).
- `polish`: a different refinement axis (rhythm / hierarchy / micro-details).
-- `typeset`: different pairing AND different scale ratio each.
-- `colorize`: different hue family each; vary chroma and contrast strategy.
+- `typeset`: departure varies the pairing AND the scale ratio each; default keeps the faces and varies scale ratio, case, and weight each.
+- `colorize`: departure gives each a different hue family and varies chroma and contrast strategy; default gives each a different existing palette role carrying the surface (Restrained / Committed / Full palette / Drenched) and a different contrast strategy.
- `layout`: different structural arrangement, not spacing tweaks.
- `adapt`: different target context per variant (mobile-first / tablet / desktop / print or low-data).
- `animate`: different motion vocabulary (cascade stagger / clip wipe / scale-and-focus / morph / parallax).
diff --git a/.dsh/skills/impeccable/reference/optimize.md b/.dsh/skills/impeccable/reference/optimize.md
index 5c55a1642..3f3fc7c33 100644
--- a/.dsh/skills/impeccable/reference/optimize.md
+++ b/.dsh/skills/impeccable/reference/optimize.md
@@ -38,7 +38,6 @@ Create systematic improvement plan:
src="hero.webp"
srcset="hero-400.webp 400w, hero-800.webp 800w, hero-1200.webp 1200w"
sizes="(max-width: 400px) 400px, (max-width: 800px) 800px, 1200px"
- loading="lazy"
alt="Hero image"
/>
```
diff --git a/.dsh/skills/impeccable/reference/visualize.md b/.dsh/skills/impeccable/reference/visualize.md
index eba4bb4e1..b1597bf62 100644
--- a/.dsh/skills/impeccable/reference/visualize.md
+++ b/.dsh/skills/impeccable/reference/visualize.md
@@ -26,7 +26,7 @@ Each comp is a direction test, not a screenshot specification. Core UI text, res
Show the three together on the decision page (`impeccable serve-question`, one option per comp with the comp as its hero), or in the harness only when it renders images inline; a text-only surface does not count as display. Ask what should carry forward, what feels false to the world, and whether the selected concept should be approved, combined, revised, or rejected. Then stop and wait. A structured simulated user counts as attended and receives the same question.
-Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md, and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
+Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md (the chosen direction on a new world), and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
This approval point has no substitute and no skip condition. When the structured question tool errors, fall back to the decision page; only after both fail may you treat the choice as delegated, and a delegated pick is recorded exactly as an approval is and disclosed in your first reply, not your last. The finish reviewer treats comp-round comps with no recorded approval as a material finding; decision comps under `.impeccable/mocks/decision/` are the direction round's hand, not comp-round output, and imply no approval on their own.
diff --git a/.dsh/skills/impeccable/scripts/command-metadata.json b/.dsh/skills/impeccable/scripts/command-metadata.json
index 89891ea4d..4686bb6de 100644
--- a/.dsh/skills/impeccable/scripts/command-metadata.json
+++ b/.dsh/skills/impeccable/scripts/command-metadata.json
@@ -4,7 +4,7 @@
"argumentHint": "[feature description]"
},
"init": {
- "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); offers DESIGN.md (visual: colors, typography, components) when code exists; pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
+ "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
"argumentHint": ""
},
"document": {
@@ -88,7 +88,7 @@
"argumentHint": "[target]"
},
"shape": {
- "description": "Plan UX and UI before code. Runs a required multi-round discovery interview, uses visual probes when available, and produces a user-confirmed design brief for implementation.",
+ "description": "Plan UX and UI before code. Runs a discovery interview (one round by default), uses visual probes when available, and produces a user-confirmed design brief for implementation.",
"argumentHint": "[feature to shape]"
},
"typeset": {
diff --git a/.dsh/skills/impeccable/scripts/live-browser.js b/.dsh/skills/impeccable/scripts/live-browser.js
index 504e75b9c..a63f1abe2 100644
--- a/.dsh/skills/impeccable/scripts/live-browser.js
+++ b/.dsh/skills/impeccable/scripts/live-browser.js
@@ -3271,6 +3271,14 @@
const P = paramsPanelPalette || barPaletteForTheme(detectPageTheme());
paramsPanelBody.innerHTML = '';
for (const p of params) {
+ // A knob the panel shows must be in the live values and on the variant,
+ // or accept drops it and the preview ignores it. Seed only missing keys
+ // so a reopen keeps edits.
+ if (!Object.hasOwn(paramsCurrentValues, p.id)) {
+ paramsCurrentValues[p.id] = p.default;
+ applyParamValue(variantEl, p, p.default);
+ }
+ const value = paramsCurrentValues[p.id];
const row = el('div', { display: 'flex', flexDirection: 'column', gap: '6px' });
const labelRow = el('div', {
display: 'flex', justifyContent: 'space-between',
@@ -3295,7 +3303,7 @@
input.min = String(p.min != null ? p.min : 0);
input.max = String(p.max != null ? p.max : 1);
input.step = String(p.step != null ? p.step : 0.05);
- input.value = String(p.default);
+ input.value = String(value);
Object.assign(input.style, {
width: '100%', accentColor: C.brand, cursor: 'pointer',
});
@@ -3310,7 +3318,7 @@
});
row.appendChild(input);
} else if (p.kind === 'toggle') {
- const initial = !!p.default;
+ const initial = !!value;
readout.textContent = initial ? 'On' : 'Off';
const track = el('button', {
position: 'relative', width: '36px', height: '20px',
@@ -3344,8 +3352,8 @@
const opts = (p.options || []).map(o =>
typeof o === 'string' ? { value: o, label: o } : o
);
- const activeOpt = opts.find(o => o.value === p.default) || opts[0];
- readout.textContent = activeOpt ? activeOpt.label : String(p.default);
+ const activeOpt = opts.find(o => o.value === value) || opts[0];
+ readout.textContent = activeOpt ? activeOpt.label : String(value);
const segRow = el('div', {
display: 'grid',
gridTemplateColumns: 'repeat(' + opts.length + ', 1fr)',
@@ -3354,7 +3362,7 @@
});
const segBtns = [];
opts.forEach(o => {
- const active = o.value === p.default;
+ const active = o.value === value;
const b = el('button', {
padding: '5px 4px', border: 'none', borderRadius: '3px',
background: active ? C.brand : 'transparent',
@@ -4988,8 +4996,8 @@
const variantEl = getVisibleVariantEl();
const params = parseVariantParams(variantEl);
if (!variantEl || params.length === 0) return;
- // Build fresh to ensure the current variant's controls are shown.
- applyParamDefaults(variantEl, params);
+ // Rebuild the controls from the current values. Defaults are applied
+ // when the variant is initialized, not when its Tune panel is reopened.
buildParamsPanel(variantEl, params);
tuneOpen = true;
showParamsPanel();
diff --git a/.gemini/skills/impeccable/reference/android.md b/.gemini/skills/impeccable/reference/android.md
index 1f67a6bb5..32a5cf7cc 100644
--- a/.gemini/skills/impeccable/reference/android.md
+++ b/.gemini/skills/impeccable/reference/android.md
@@ -42,5 +42,5 @@ Would a fluent Android user trust this app, or trip on off-spec components? The
## Verifying the build
- **Screenshots come from the emulator or a connected device, never a browser.** Build and install, then capture with `adb exec-out screencap -p > <path>` (pick a device with `adb -s <serial>` when several are attached). Capture every device class the app ships to, at least one phone and, when tablets are a target, one tablet, and write the files where the review flow expects them.
-- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (restore `1.0` after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
+- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (read both settings first with `adb shell cmd uimode night` and `adb shell settings get system font_scale`, and restore them after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
- **Emulators give breadth; gestures, refresh rates, and performance need hardware.** Say which one produced the evidence.
diff --git a/.gemini/skills/impeccable/reference/audit.md b/.gemini/skills/impeccable/reference/audit.md
index 9a560bfdc..234815262 100644
--- a/.gemini/skills/impeccable/reference/audit.md
+++ b/.gemini/skills/impeccable/reference/audit.md
@@ -11,7 +11,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
### 1. Accessibility (A11y)
**Check for**:
-- **Contrast issues**: Text contrast ratios < 4.5:1 (or 7:1 for AAA)
+- **Contrast issues**: Text contrast ratios < 4.5:1, or < 3:1 for large text (or 7:1 for AAA)
- **Motion sensitivity**: `prefers-reduced-motion` needs an intentional alternative that preserves state change and hierarchy; flag a global `0.01ms` kill that destroys useful feedback, flashing above threshold, and motion that blocks focus, reading, or task completion
- **Missing ARIA**: Interactive elements without proper roles, labels, or states
- **Keyboard navigation**: Missing focus indicators, illogical tab order, keyboard traps
@@ -47,7 +47,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
**Check for**:
- **Fixed widths**: Hard-coded widths that break on mobile
-- **Touch targets**: Interactive elements < 44x44px
+- **Touch targets**: Interactive elements < 44x44px. WCAG AA (SC 2.5.8) requires at least 24x24 CSS px unless an exception applies: spacing, an equivalent control, inline text, user-agent styling, or an essential size. Spacing passes when a 24 CSS px circle centered on the target's bounding box overlaps no other target and no other undersized target's circle
- **Broken touch interaction**: Custom sliders, drag surfaces, and scrollable control strips whose primary gesture fails under touch, that swallow page scroll or lose the drag to it, or that stay stuck after an interrupted gesture. Code tells: mouse-only handlers, no `touch-action` on a pointer-event drag surface, drag state that nothing clears on cancel, lost capture, or blur. Exercise the gesture when a browser tool can synthesize touch (a rendered viewport proves layout, not the gesture), then say what produced the evidence (emulated viewport, synthesized touch, which engine, physical device) and what stayed untested
- **Horizontal scroll**: Content overflow on narrow viewports
- **Text scaling**: Layouts that break when text size increases
diff --git a/.gemini/skills/impeccable/reference/distill.md b/.gemini/skills/impeccable/reference/distill.md
index 757630fae..a49697136 100644
--- a/.gemini/skills/impeccable/reference/distill.md
+++ b/.gemini/skills/impeccable/reference/distill.md
@@ -41,7 +41,7 @@ Expect to say no to good ideas to make room for great execution.
Systematically remove complexity across these dimensions:
### Information Architecture
-- **Reduce scope**: Remove secondary actions, optional features, redundant information
+- **Reduce scope**: Remove secondary actions, redundant information
- **Progressive disclosure**: Hide complexity behind clear entry points (accordions, modals, step-through flows)
- **Combine related actions**: Merge similar buttons, consolidate forms, group related content
- **Clear hierarchy**: ONE primary action, few secondary actions, everything else tertiary or hidden
@@ -70,11 +70,11 @@ Systematically remove complexity across these dimensions:
- **Clear next action**: ONE obvious next action, not five competing ones
### Content Simplification
-- **Shorter copy**: Cut every sentence in half, then do it again
+- **Shorter copy**: Cut filler, not meaning
- **Active voice**: "Save changes" not "Changes will be saved"
- **Remove jargon**: Plain language always wins
- **Scannable structure**: Short paragraphs, bullet points, clear headings
-- **Essential information only**: Remove marketing fluff, legalese, hedging
+- **Essential information only**: Remove marketing fluff, hedging
- **Remove redundant copy**: No headers restating intros, no repeated explanations, say it once
### Code Simplification
diff --git a/.gemini/skills/impeccable/reference/doctor.md b/.gemini/skills/impeccable/reference/doctor.md
index 0d6c8ec37..45ab0b002 100644
--- a/.gemini/skills/impeccable/reference/doctor.md
+++ b/.gemini/skills/impeccable/reference/doctor.md
@@ -6,7 +6,7 @@ This is maintenance, not design. Do not redesign anything, do not open files out
Three kinds of drift travel under "out of date". Keep them apart:
-- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it. Not this command's job.
+- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it, or the harness's plugin manager for a plugin install. Not this command's job.
- **Schema drift.** An artifact was written by an older Impeccable: fields nothing reads, fields now expected, files in retired locations. Mechanical, and this command repairs most of it.
- **Truth drift.** The code moved on and the document no longer describes it. No file comparison settles this. `document` owns DESIGN.md, `init` owns PRODUCT.md, and this command's job is to hand them a specific gap rather than a vague suspicion.
diff --git a/.gemini/skills/impeccable/reference/document.md b/.gemini/skills/impeccable/reference/document.md
index 9da0bc743..ec75b7cc7 100644
--- a/.gemini/skills/impeccable/reference/document.md
+++ b/.gemini/skills/impeccable/reference/document.md
@@ -17,10 +17,10 @@ colors:
typography:
display:
fontFamily: "Cormorant Garamond, Georgia, serif"
- fontSize: "clamp(2.5rem, 7vw, 4.5rem)"
+ fontSize: "4.5rem"
fontWeight: 300
lineHeight: 1
- letterSpacing: "normal"
+ letterSpacing: "0em"
body:
# ...
rounded:
@@ -325,7 +325,7 @@ If the project has **no component library yet** (bare landing page, new project)
#### Tonal ramps
-For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue and chroma, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
+For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue, chroma reduced near white and black, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
#### Narrative mapping
diff --git a/.gemini/skills/impeccable/reference/live.md b/.gemini/skills/impeccable/reference/live.md
index d1fcdaeb8..cadeae77c 100644
--- a/.gemini/skills/impeccable/reference/live.md
+++ b/.gemini/skills/impeccable/reference/live.md
@@ -158,14 +158,14 @@ Sources in priority order: DESIGN.md's visual system fields; CSS custom properti
**Default:** compare each variant against the Phase A lock; palette, type voice, or rhetoric drift means it crossed into departure by accident: rework. Then confirm three different primary axes; three "tighter density" variants is failure. **Departure:** two passes, family before sentence. Family pass (non-negotiable): label each variant with a concrete family of your own choosing; shared or interchangeable labels mean rework. Sentence pass: three one-line descriptions side by side; two that rhyme mean rework. When the primary axis is color or theme, the trio must not share theme + dominant hue: three color worlds, not three shades.
-**Action-specific invocations** must vary along the action's dimension:
+**Action-specific invocations** must vary along the action's dimension; in default mode every variation stays within the available faces and existing tokens:
- `bolder`: amplify a different dimension per variant (scale / saturation / structural change).
- `quieter`: pull back a different dimension (color / ornament / spacing).
- `distill`: remove a different class of excess (visual noise / redundant content / nested structure).
- `polish`: a different refinement axis (rhythm / hierarchy / micro-details).
-- `typeset`: different pairing AND different scale ratio each.
-- `colorize`: different hue family each; vary chroma and contrast strategy.
+- `typeset`: departure varies the pairing AND the scale ratio each; default keeps the faces and varies scale ratio, case, and weight each.
+- `colorize`: departure gives each a different hue family and varies chroma and contrast strategy; default gives each a different existing palette role carrying the surface (Restrained / Committed / Full palette / Drenched) and a different contrast strategy.
- `layout`: different structural arrangement, not spacing tweaks.
- `adapt`: different target context per variant (mobile-first / tablet / desktop / print or low-data).
- `animate`: different motion vocabulary (cascade stagger / clip wipe / scale-and-focus / morph / parallax).
diff --git a/.gemini/skills/impeccable/reference/optimize.md b/.gemini/skills/impeccable/reference/optimize.md
index 5c55a1642..3f3fc7c33 100644
--- a/.gemini/skills/impeccable/reference/optimize.md
+++ b/.gemini/skills/impeccable/reference/optimize.md
@@ -38,7 +38,6 @@ Create systematic improvement plan:
src="hero.webp"
srcset="hero-400.webp 400w, hero-800.webp 800w, hero-1200.webp 1200w"
sizes="(max-width: 400px) 400px, (max-width: 800px) 800px, 1200px"
- loading="lazy"
alt="Hero image"
/>
```
diff --git a/.gemini/skills/impeccable/reference/visualize.md b/.gemini/skills/impeccable/reference/visualize.md
index 4982c6150..6d77f15bf 100644
--- a/.gemini/skills/impeccable/reference/visualize.md
+++ b/.gemini/skills/impeccable/reference/visualize.md
@@ -26,7 +26,7 @@ Each comp is a direction test, not a screenshot specification. Core UI text, res
Show the three together on the decision page (`impeccable serve-question`, one option per comp with the comp as its hero), or in the harness only when it renders images inline; a text-only surface does not count as display. Ask what should carry forward, what feels false to the world, and whether the selected concept should be approved, combined, revised, or rejected. Then stop and wait. A structured simulated user counts as attended and receives the same question.
-Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md, and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
+Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md (the chosen direction on a new world), and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
This approval point has no substitute and no skip condition. When the structured question tool errors, fall back to the decision page; only after both fail may you treat the choice as delegated, and a delegated pick is recorded exactly as an approval is and disclosed in your first reply, not your last. The finish reviewer treats comp-round comps with no recorded approval as a material finding; decision comps under `.impeccable/mocks/decision/` are the direction round's hand, not comp-round output, and imply no approval on their own.
diff --git a/.gemini/skills/impeccable/scripts/command-metadata.json b/.gemini/skills/impeccable/scripts/command-metadata.json
index 89891ea4d..4686bb6de 100644
--- a/.gemini/skills/impeccable/scripts/command-metadata.json
+++ b/.gemini/skills/impeccable/scripts/command-metadata.json
@@ -4,7 +4,7 @@
"argumentHint": "[feature description]"
},
"init": {
- "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); offers DESIGN.md (visual: colors, typography, components) when code exists; pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
+ "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
"argumentHint": ""
},
"document": {
@@ -88,7 +88,7 @@
"argumentHint": "[target]"
},
"shape": {
- "description": "Plan UX and UI before code. Runs a required multi-round discovery interview, uses visual probes when available, and produces a user-confirmed design brief for implementation.",
+ "description": "Plan UX and UI before code. Runs a discovery interview (one round by default), uses visual probes when available, and produces a user-confirmed design brief for implementation.",
"argumentHint": "[feature to shape]"
},
"typeset": {
diff --git a/.gemini/skills/impeccable/scripts/live-browser.js b/.gemini/skills/impeccable/scripts/live-browser.js
index 504e75b9c..a63f1abe2 100644
--- a/.gemini/skills/impeccable/scripts/live-browser.js
+++ b/.gemini/skills/impeccable/scripts/live-browser.js
@@ -3271,6 +3271,14 @@
const P = paramsPanelPalette || barPaletteForTheme(detectPageTheme());
paramsPanelBody.innerHTML = '';
for (const p of params) {
+ // A knob the panel shows must be in the live values and on the variant,
+ // or accept drops it and the preview ignores it. Seed only missing keys
+ // so a reopen keeps edits.
+ if (!Object.hasOwn(paramsCurrentValues, p.id)) {
+ paramsCurrentValues[p.id] = p.default;
+ applyParamValue(variantEl, p, p.default);
+ }
+ const value = paramsCurrentValues[p.id];
const row = el('div', { display: 'flex', flexDirection: 'column', gap: '6px' });
const labelRow = el('div', {
display: 'flex', justifyContent: 'space-between',
@@ -3295,7 +3303,7 @@
input.min = String(p.min != null ? p.min : 0);
input.max = String(p.max != null ? p.max : 1);
input.step = String(p.step != null ? p.step : 0.05);
- input.value = String(p.default);
+ input.value = String(value);
Object.assign(input.style, {
width: '100%', accentColor: C.brand, cursor: 'pointer',
});
@@ -3310,7 +3318,7 @@
});
row.appendChild(input);
} else if (p.kind === 'toggle') {
- const initial = !!p.default;
+ const initial = !!value;
readout.textContent = initial ? 'On' : 'Off';
const track = el('button', {
position: 'relative', width: '36px', height: '20px',
@@ -3344,8 +3352,8 @@
const opts = (p.options || []).map(o =>
typeof o === 'string' ? { value: o, label: o } : o
);
- const activeOpt = opts.find(o => o.value === p.default) || opts[0];
- readout.textContent = activeOpt ? activeOpt.label : String(p.default);
+ const activeOpt = opts.find(o => o.value === value) || opts[0];
+ readout.textContent = activeOpt ? activeOpt.label : String(value);
const segRow = el('div', {
display: 'grid',
gridTemplateColumns: 'repeat(' + opts.length + ', 1fr)',
@@ -3354,7 +3362,7 @@
});
const segBtns = [];
opts.forEach(o => {
- const active = o.value === p.default;
+ const active = o.value === value;
const b = el('button', {
padding: '5px 4px', border: 'none', borderRadius: '3px',
background: active ? C.brand : 'transparent',
@@ -4988,8 +4996,8 @@
const variantEl = getVisibleVariantEl();
const params = parseVariantParams(variantEl);
if (!variantEl || params.length === 0) return;
- // Build fresh to ensure the current variant's controls are shown.
- applyParamDefaults(variantEl, params);
+ // Rebuild the controls from the current values. Defaults are applied
+ // when the variant is initialized, not when its Tune panel is reopened.
buildParamsPanel(variantEl, params);
tuneOpen = true;
showParamsPanel();
diff --git a/.github/skills/impeccable/reference/android.md b/.github/skills/impeccable/reference/android.md
index 1f67a6bb5..32a5cf7cc 100644
--- a/.github/skills/impeccable/reference/android.md
+++ b/.github/skills/impeccable/reference/android.md
@@ -42,5 +42,5 @@ Would a fluent Android user trust this app, or trip on off-spec components? The
## Verifying the build
- **Screenshots come from the emulator or a connected device, never a browser.** Build and install, then capture with `adb exec-out screencap -p > <path>` (pick a device with `adb -s <serial>` when several are attached). Capture every device class the app ships to, at least one phone and, when tablets are a target, one tablet, and write the files where the review flow expects them.
-- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (restore `1.0` after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
+- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (read both settings first with `adb shell cmd uimode night` and `adb shell settings get system font_scale`, and restore them after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
- **Emulators give breadth; gestures, refresh rates, and performance need hardware.** Say which one produced the evidence.
diff --git a/.github/skills/impeccable/reference/audit.md b/.github/skills/impeccable/reference/audit.md
index d737c51ed..e94965e8c 100644
--- a/.github/skills/impeccable/reference/audit.md
+++ b/.github/skills/impeccable/reference/audit.md
@@ -11,7 +11,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
### 1. Accessibility (A11y)
**Check for**:
-- **Contrast issues**: Text contrast ratios < 4.5:1 (or 7:1 for AAA)
+- **Contrast issues**: Text contrast ratios < 4.5:1, or < 3:1 for large text (or 7:1 for AAA)
- **Motion sensitivity**: `prefers-reduced-motion` needs an intentional alternative that preserves state change and hierarchy; flag a global `0.01ms` kill that destroys useful feedback, flashing above threshold, and motion that blocks focus, reading, or task completion
- **Missing ARIA**: Interactive elements without proper roles, labels, or states
- **Keyboard navigation**: Missing focus indicators, illogical tab order, keyboard traps
@@ -47,7 +47,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
**Check for**:
- **Fixed widths**: Hard-coded widths that break on mobile
-- **Touch targets**: Interactive elements < 44x44px
+- **Touch targets**: Interactive elements < 44x44px. WCAG AA (SC 2.5.8) requires at least 24x24 CSS px unless an exception applies: spacing, an equivalent control, inline text, user-agent styling, or an essential size. Spacing passes when a 24 CSS px circle centered on the target's bounding box overlaps no other target and no other undersized target's circle
- **Broken touch interaction**: Custom sliders, drag surfaces, and scrollable control strips whose primary gesture fails under touch, that swallow page scroll or lose the drag to it, or that stay stuck after an interrupted gesture. Code tells: mouse-only handlers, no `touch-action` on a pointer-event drag surface, drag state that nothing clears on cancel, lost capture, or blur. Exercise the gesture when a browser tool can synthesize touch (a rendered viewport proves layout, not the gesture), then say what produced the evidence (emulated viewport, synthesized touch, which engine, physical device) and what stayed untested
- **Horizontal scroll**: Content overflow on narrow viewports
- **Text scaling**: Layouts that break when text size increases
diff --git a/.github/skills/impeccable/reference/distill.md b/.github/skills/impeccable/reference/distill.md
index 757630fae..a49697136 100644
--- a/.github/skills/impeccable/reference/distill.md
+++ b/.github/skills/impeccable/reference/distill.md
@@ -41,7 +41,7 @@ Expect to say no to good ideas to make room for great execution.
Systematically remove complexity across these dimensions:
### Information Architecture
-- **Reduce scope**: Remove secondary actions, optional features, redundant information
+- **Reduce scope**: Remove secondary actions, redundant information
- **Progressive disclosure**: Hide complexity behind clear entry points (accordions, modals, step-through flows)
- **Combine related actions**: Merge similar buttons, consolidate forms, group related content
- **Clear hierarchy**: ONE primary action, few secondary actions, everything else tertiary or hidden
@@ -70,11 +70,11 @@ Systematically remove complexity across these dimensions:
- **Clear next action**: ONE obvious next action, not five competing ones
### Content Simplification
-- **Shorter copy**: Cut every sentence in half, then do it again
+- **Shorter copy**: Cut filler, not meaning
- **Active voice**: "Save changes" not "Changes will be saved"
- **Remove jargon**: Plain language always wins
- **Scannable structure**: Short paragraphs, bullet points, clear headings
-- **Essential information only**: Remove marketing fluff, legalese, hedging
+- **Essential information only**: Remove marketing fluff, hedging
- **Remove redundant copy**: No headers restating intros, no repeated explanations, say it once
### Code Simplification
diff --git a/.github/skills/impeccable/reference/doctor.md b/.github/skills/impeccable/reference/doctor.md
index 01ee68356..dda57f8b3 100644
--- a/.github/skills/impeccable/reference/doctor.md
+++ b/.github/skills/impeccable/reference/doctor.md
@@ -6,7 +6,7 @@ This is maintenance, not design. Do not redesign anything, do not open files out
Three kinds of drift travel under "out of date". Keep them apart:
-- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it. Not this command's job.
+- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it, or the harness's plugin manager for a plugin install. Not this command's job.
- **Schema drift.** An artifact was written by an older Impeccable: fields nothing reads, fields now expected, files in retired locations. Mechanical, and this command repairs most of it.
- **Truth drift.** The code moved on and the document no longer describes it. No file comparison settles this. `document` owns DESIGN.md, `init` owns PRODUCT.md, and this command's job is to hand them a specific gap rather than a vague suspicion.
diff --git a/.github/skills/impeccable/reference/document.md b/.github/skills/impeccable/reference/document.md
index 9da0bc743..ec75b7cc7 100644
--- a/.github/skills/impeccable/reference/document.md
+++ b/.github/skills/impeccable/reference/document.md
@@ -17,10 +17,10 @@ colors:
typography:
display:
fontFamily: "Cormorant Garamond, Georgia, serif"
- fontSize: "clamp(2.5rem, 7vw, 4.5rem)"
+ fontSize: "4.5rem"
fontWeight: 300
lineHeight: 1
- letterSpacing: "normal"
+ letterSpacing: "0em"
body:
# ...
rounded:
@@ -325,7 +325,7 @@ If the project has **no component library yet** (bare landing page, new project)
#### Tonal ramps
-For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue and chroma, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
+For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue, chroma reduced near white and black, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
#### Narrative mapping
diff --git a/.github/skills/impeccable/reference/live.md b/.github/skills/impeccable/reference/live.md
index 90b74456a..42ca3044a 100644
--- a/.github/skills/impeccable/reference/live.md
+++ b/.github/skills/impeccable/reference/live.md
@@ -158,14 +158,14 @@ Sources in priority order: DESIGN.md's visual system fields; CSS custom properti
**Default:** compare each variant against the Phase A lock; palette, type voice, or rhetoric drift means it crossed into departure by accident: rework. Then confirm three different primary axes; three "tighter density" variants is failure. **Departure:** two passes, family before sentence. Family pass (non-negotiable): label each variant with a concrete family of your own choosing; shared or interchangeable labels mean rework. Sentence pass: three one-line descriptions side by side; two that rhyme mean rework. When the primary axis is color or theme, the trio must not share theme + dominant hue: three color worlds, not three shades.
-**Action-specific invocations** must vary along the action's dimension:
+**Action-specific invocations** must vary along the action's dimension; in default mode every variation stays within the available faces and existing tokens:
- `bolder`: amplify a different dimension per variant (scale / saturation / structural change).
- `quieter`: pull back a different dimension (color / ornament / spacing).
- `distill`: remove a different class of excess (visual noise / redundant content / nested structure).
- `polish`: a different refinement axis (rhythm / hierarchy / micro-details).
-- `typeset`: different pairing AND different scale ratio each.
-- `colorize`: different hue family each; vary chroma and contrast strategy.
+- `typeset`: departure varies the pairing AND the scale ratio each; default keeps the faces and varies scale ratio, case, and weight each.
+- `colorize`: departure gives each a different hue family and varies chroma and contrast strategy; default gives each a different existing palette role carrying the surface (Restrained / Committed / Full palette / Drenched) and a different contrast strategy.
- `layout`: different structural arrangement, not spacing tweaks.
- `adapt`: different target context per variant (mobile-first / tablet / desktop / print or low-data).
- `animate`: different motion vocabulary (cascade stagger / clip wipe / scale-and-focus / morph / parallax).
diff --git a/.github/skills/impeccable/reference/optimize.md b/.github/skills/impeccable/reference/optimize.md
index 5c55a1642..3f3fc7c33 100644
--- a/.github/skills/impeccable/reference/optimize.md
+++ b/.github/skills/impeccable/reference/optimize.md
@@ -38,7 +38,6 @@ Create systematic improvement plan:
src="hero.webp"
srcset="hero-400.webp 400w, hero-800.webp 800w, hero-1200.webp 1200w"
sizes="(max-width: 400px) 400px, (max-width: 800px) 800px, 1200px"
- loading="lazy"
alt="Hero image"
/>
```
diff --git a/.github/skills/impeccable/reference/visualize.md b/.github/skills/impeccable/reference/visualize.md
index f4a337a5c..e8e93624d 100644
--- a/.github/skills/impeccable/reference/visualize.md
+++ b/.github/skills/impeccable/reference/visualize.md
@@ -26,7 +26,7 @@ Each comp is a direction test, not a screenshot specification. Core UI text, res
Show the three together on the decision page (`impeccable serve-question`, one option per comp with the comp as its hero), or in the harness only when it renders images inline; a text-only surface does not count as display. Ask what should carry forward, what feels false to the world, and whether the selected concept should be approved, combined, revised, or rejected. Then stop and wait. A structured simulated user counts as attended and receives the same question.
-Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md, and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
+Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md (the chosen direction on a new world), and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
This approval point has no substitute and no skip condition. When the structured question tool errors, fall back to the decision page; only after both fail may you treat the choice as delegated, and a delegated pick is recorded exactly as an approval is and disclosed in your first reply, not your last. The finish reviewer treats comp-round comps with no recorded approval as a material finding; decision comps under `.impeccable/mocks/decision/` are the direction round's hand, not comp-round output, and imply no approval on their own.
diff --git a/.github/skills/impeccable/scripts/command-metadata.json b/.github/skills/impeccable/scripts/command-metadata.json
index 89891ea4d..4686bb6de 100644
--- a/.github/skills/impeccable/scripts/command-metadata.json
+++ b/.github/skills/impeccable/scripts/command-metadata.json
@@ -4,7 +4,7 @@
"argumentHint": "[feature description]"
},
"init": {
- "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); offers DESIGN.md (visual: colors, typography, components) when code exists; pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
+ "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
"argumentHint": ""
},
"document": {
@@ -88,7 +88,7 @@
"argumentHint": "[target]"
},
"shape": {
- "description": "Plan UX and UI before code. Runs a required multi-round discovery interview, uses visual probes when available, and produces a user-confirmed design brief for implementation.",
+ "description": "Plan UX and UI before code. Runs a discovery interview (one round by default), uses visual probes when available, and produces a user-confirmed design brief for implementation.",
"argumentHint": "[feature to shape]"
},
"typeset": {
diff --git a/.github/skills/impeccable/scripts/live-browser.js b/.github/skills/impeccable/scripts/live-browser.js
index 504e75b9c..a63f1abe2 100644
--- a/.github/skills/impeccable/scripts/live-browser.js
+++ b/.github/skills/impeccable/scripts/live-browser.js
@@ -3271,6 +3271,14 @@
const P = paramsPanelPalette || barPaletteForTheme(detectPageTheme());
paramsPanelBody.innerHTML = '';
for (const p of params) {
+ // A knob the panel shows must be in the live values and on the variant,
+ // or accept drops it and the preview ignores it. Seed only missing keys
+ // so a reopen keeps edits.
+ if (!Object.hasOwn(paramsCurrentValues, p.id)) {
+ paramsCurrentValues[p.id] = p.default;
+ applyParamValue(variantEl, p, p.default);
+ }
+ const value = paramsCurrentValues[p.id];
const row = el('div', { display: 'flex', flexDirection: 'column', gap: '6px' });
const labelRow = el('div', {
display: 'flex', justifyContent: 'space-between',
@@ -3295,7 +3303,7 @@
input.min = String(p.min != null ? p.min : 0);
input.max = String(p.max != null ? p.max : 1);
input.step = String(p.step != null ? p.step : 0.05);
- input.value = String(p.default);
+ input.value = String(value);
Object.assign(input.style, {
width: '100%', accentColor: C.brand, cursor: 'pointer',
});
@@ -3310,7 +3318,7 @@
});
row.appendChild(input);
} else if (p.kind === 'toggle') {
- const initial = !!p.default;
+ const initial = !!value;
readout.textContent = initial ? 'On' : 'Off';
const track = el('button', {
position: 'relative', width: '36px', height: '20px',
@@ -3344,8 +3352,8 @@
const opts = (p.options || []).map(o =>
typeof o === 'string' ? { value: o, label: o } : o
);
- const activeOpt = opts.find(o => o.value === p.default) || opts[0];
- readout.textContent = activeOpt ? activeOpt.label : String(p.default);
+ const activeOpt = opts.find(o => o.value === value) || opts[0];
+ readout.textContent = activeOpt ? activeOpt.label : String(value);
const segRow = el('div', {
display: 'grid',
gridTemplateColumns: 'repeat(' + opts.length + ', 1fr)',
@@ -3354,7 +3362,7 @@
});
const segBtns = [];
opts.forEach(o => {
- const active = o.value === p.default;
+ const active = o.value === value;
const b = el('button', {
padding: '5px 4px', border: 'none', borderRadius: '3px',
background: active ? C.brand : 'transparent',
@@ -4988,8 +4996,8 @@
const variantEl = getVisibleVariantEl();
const params = parseVariantParams(variantEl);
if (!variantEl || params.length === 0) return;
- // Build fresh to ensure the current variant's controls are shown.
- applyParamDefaults(variantEl, params);
+ // Rebuild the controls from the current values. Defaults are applied
+ // when the variant is initialized, not when its Tune panel is reopened.
buildParamsPanel(variantEl, params);
tuneOpen = true;
showParamsPanel();
diff --git a/.grok/skills/impeccable/reference/android.md b/.grok/skills/impeccable/reference/android.md
index 1f67a6bb5..32a5cf7cc 100644
--- a/.grok/skills/impeccable/reference/android.md
+++ b/.grok/skills/impeccable/reference/android.md
@@ -42,5 +42,5 @@ Would a fluent Android user trust this app, or trip on off-spec components? The
## Verifying the build
- **Screenshots come from the emulator or a connected device, never a browser.** Build and install, then capture with `adb exec-out screencap -p > <path>` (pick a device with `adb -s <serial>` when several are attached). Capture every device class the app ships to, at least one phone and, when tablets are a target, one tablet, and write the files where the review flow expects them.
-- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (restore `1.0` after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
+- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (read both settings first with `adb shell cmd uimode night` and `adb shell settings get system font_scale`, and restore them after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
- **Emulators give breadth; gestures, refresh rates, and performance need hardware.** Say which one produced the evidence.
diff --git a/.grok/skills/impeccable/reference/audit.md b/.grok/skills/impeccable/reference/audit.md
index 3253f468a..495c57ba0 100644
--- a/.grok/skills/impeccable/reference/audit.md
+++ b/.grok/skills/impeccable/reference/audit.md
@@ -11,7 +11,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
### 1. Accessibility (A11y)
**Check for**:
-- **Contrast issues**: Text contrast ratios < 4.5:1 (or 7:1 for AAA)
+- **Contrast issues**: Text contrast ratios < 4.5:1, or < 3:1 for large text (or 7:1 for AAA)
- **Motion sensitivity**: `prefers-reduced-motion` needs an intentional alternative that preserves state change and hierarchy; flag a global `0.01ms` kill that destroys useful feedback, flashing above threshold, and motion that blocks focus, reading, or task completion
- **Missing ARIA**: Interactive elements without proper roles, labels, or states
- **Keyboard navigation**: Missing focus indicators, illogical tab order, keyboard traps
@@ -47,7 +47,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
**Check for**:
- **Fixed widths**: Hard-coded widths that break on mobile
-- **Touch targets**: Interactive elements < 44x44px
+- **Touch targets**: Interactive elements < 44x44px. WCAG AA (SC 2.5.8) requires at least 24x24 CSS px unless an exception applies: spacing, an equivalent control, inline text, user-agent styling, or an essential size. Spacing passes when a 24 CSS px circle centered on the target's bounding box overlaps no other target and no other undersized target's circle
- **Broken touch interaction**: Custom sliders, drag surfaces, and scrollable control strips whose primary gesture fails under touch, that swallow page scroll or lose the drag to it, or that stay stuck after an interrupted gesture. Code tells: mouse-only handlers, no `touch-action` on a pointer-event drag surface, drag state that nothing clears on cancel, lost capture, or blur. Exercise the gesture when a browser tool can synthesize touch (a rendered viewport proves layout, not the gesture), then say what produced the evidence (emulated viewport, synthesized touch, which engine, physical device) and what stayed untested
- **Horizontal scroll**: Content overflow on narrow viewports
- **Text scaling**: Layouts that break when text size increases
diff --git a/.grok/skills/impeccable/reference/distill.md b/.grok/skills/impeccable/reference/distill.md
index 6943c965b..d7c525d92 100644
--- a/.grok/skills/impeccable/reference/distill.md
+++ b/.grok/skills/impeccable/reference/distill.md
@@ -41,7 +41,7 @@ Expect to say no to good ideas to make room for great execution.
Systematically remove complexity across these dimensions:
### Information Architecture
-- **Reduce scope**: Remove secondary actions, optional features, redundant information
+- **Reduce scope**: Remove secondary actions, redundant information
- **Progressive disclosure**: Hide complexity behind clear entry points (accordions, modals, step-through flows)
- **Combine related actions**: Merge similar buttons, consolidate forms, group related content
- **Clear hierarchy**: ONE primary action, few secondary actions, everything else tertiary or hidden
@@ -70,11 +70,11 @@ Systematically remove complexity across these dimensions:
- **Clear next action**: ONE obvious next action, not five competing ones
### Content Simplification
-- **Shorter copy**: Cut every sentence in half, then do it again
+- **Shorter copy**: Cut filler, not meaning
- **Active voice**: "Save changes" not "Changes will be saved"
- **Remove jargon**: Plain language always wins
- **Scannable structure**: Short paragraphs, bullet points, clear headings
-- **Essential information only**: Remove marketing fluff, legalese, hedging
+- **Essential information only**: Remove marketing fluff, hedging
- **Remove redundant copy**: No headers restating intros, no repeated explanations, say it once
### Code Simplification
diff --git a/.grok/skills/impeccable/reference/doctor.md b/.grok/skills/impeccable/reference/doctor.md
index 9089fe359..d4effa734 100644
--- a/.grok/skills/impeccable/reference/doctor.md
+++ b/.grok/skills/impeccable/reference/doctor.md
@@ -6,7 +6,7 @@ This is maintenance, not design. Do not redesign anything, do not open files out
Three kinds of drift travel under "out of date". Keep them apart:
-- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it. Not this command's job.
+- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it, or the harness's plugin manager for a plugin install. Not this command's job.
- **Schema drift.** An artifact was written by an older Impeccable: fields nothing reads, fields now expected, files in retired locations. Mechanical, and this command repairs most of it.
- **Truth drift.** The code moved on and the document no longer describes it. No file comparison settles this. `document` owns DESIGN.md, `init` owns PRODUCT.md, and this command's job is to hand them a specific gap rather than a vague suspicion.
diff --git a/.grok/skills/impeccable/reference/document.md b/.grok/skills/impeccable/reference/document.md
index b5e50d5ed..879ba4e86 100644
--- a/.grok/skills/impeccable/reference/document.md
+++ b/.grok/skills/impeccable/reference/document.md
@@ -17,10 +17,10 @@ colors:
typography:
display:
fontFamily: "Cormorant Garamond, Georgia, serif"
- fontSize: "clamp(2.5rem, 7vw, 4.5rem)"
+ fontSize: "4.5rem"
fontWeight: 300
lineHeight: 1
- letterSpacing: "normal"
+ letterSpacing: "0em"
body:
# ...
rounded:
@@ -325,7 +325,7 @@ If the project has **no component library yet** (bare landing page, new project)
#### Tonal ramps
-For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue and chroma, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
+For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue, chroma reduced near white and black, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
#### Narrative mapping
diff --git a/.grok/skills/impeccable/reference/live.md b/.grok/skills/impeccable/reference/live.md
index 0a06a68fd..f05d80166 100644
--- a/.grok/skills/impeccable/reference/live.md
+++ b/.grok/skills/impeccable/reference/live.md
@@ -158,14 +158,14 @@ Sources in priority order: DESIGN.md's visual system fields; CSS custom properti
**Default:** compare each variant against the Phase A lock; palette, type voice, or rhetoric drift means it crossed into departure by accident: rework. Then confirm three different primary axes; three "tighter density" variants is failure. **Departure:** two passes, family before sentence. Family pass (non-negotiable): label each variant with a concrete family of your own choosing; shared or interchangeable labels mean rework. Sentence pass: three one-line descriptions side by side; two that rhyme mean rework. When the primary axis is color or theme, the trio must not share theme + dominant hue: three color worlds, not three shades.
-**Action-specific invocations** must vary along the action's dimension:
+**Action-specific invocations** must vary along the action's dimension; in default mode every variation stays within the available faces and existing tokens:
- `bolder`: amplify a different dimension per variant (scale / saturation / structural change).
- `quieter`: pull back a different dimension (color / ornament / spacing).
- `distill`: remove a different class of excess (visual noise / redundant content / nested structure).
- `polish`: a different refinement axis (rhythm / hierarchy / micro-details).
-- `typeset`: different pairing AND different scale ratio each.
-- `colorize`: different hue family each; vary chroma and contrast strategy.
+- `typeset`: departure varies the pairing AND the scale ratio each; default keeps the faces and varies scale ratio, case, and weight each.
+- `colorize`: departure gives each a different hue family and varies chroma and contrast strategy; default gives each a different existing palette role carrying the surface (Restrained / Committed / Full palette / Drenched) and a different contrast strategy.
- `layout`: different structural arrangement, not spacing tweaks.
- `adapt`: different target context per variant (mobile-first / tablet / desktop / print or low-data).
- `animate`: different motion vocabulary (cascade stagger / clip wipe / scale-and-focus / morph / parallax).
diff --git a/.grok/skills/impeccable/reference/optimize.md b/.grok/skills/impeccable/reference/optimize.md
index 5c55a1642..3f3fc7c33 100644
--- a/.grok/skills/impeccable/reference/optimize.md
+++ b/.grok/skills/impeccable/reference/optimize.md
@@ -38,7 +38,6 @@ Create systematic improvement plan:
src="hero.webp"
srcset="hero-400.webp 400w, hero-800.webp 800w, hero-1200.webp 1200w"
sizes="(max-width: 400px) 400px, (max-width: 800px) 800px, 1200px"
- loading="lazy"
alt="Hero image"
/>
```
diff --git a/.grok/skills/impeccable/reference/visualize.md b/.grok/skills/impeccable/reference/visualize.md
index e8114a52f..d25b7faf1 100644
--- a/.grok/skills/impeccable/reference/visualize.md
+++ b/.grok/skills/impeccable/reference/visualize.md
@@ -26,7 +26,7 @@ Each comp is a direction test, not a screenshot specification. Core UI text, res
Show the three together on the decision page (`impeccable serve-question`, one option per comp with the comp as its hero), or in the harness only when it renders images inline; a text-only surface does not count as display. Ask what should carry forward, what feels false to the world, and whether the selected concept should be approved, combined, revised, or rejected. Then stop and wait. A structured simulated user counts as attended and receives the same question.
-Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md, and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
+Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md (the chosen direction on a new world), and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
This approval point has no substitute and no skip condition. When the structured question tool errors, fall back to the decision page; only after both fail may you treat the choice as delegated, and a delegated pick is recorded exactly as an approval is and disclosed in your first reply, not your last. The finish reviewer treats comp-round comps with no recorded approval as a material finding; decision comps under `.impeccable/mocks/decision/` are the direction round's hand, not comp-round output, and imply no approval on their own.
diff --git a/.grok/skills/impeccable/scripts/command-metadata.json b/.grok/skills/impeccable/scripts/command-metadata.json
index 89891ea4d..4686bb6de 100644
--- a/.grok/skills/impeccable/scripts/command-metadata.json
+++ b/.grok/skills/impeccable/scripts/command-metadata.json
@@ -4,7 +4,7 @@
"argumentHint": "[feature description]"
},
"init": {
- "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); offers DESIGN.md (visual: colors, typography, components) when code exists; pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
+ "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
"argumentHint": ""
},
"document": {
@@ -88,7 +88,7 @@
"argumentHint": "[target]"
},
"shape": {
- "description": "Plan UX and UI before code. Runs a required multi-round discovery interview, uses visual probes when available, and produces a user-confirmed design brief for implementation.",
+ "description": "Plan UX and UI before code. Runs a discovery interview (one round by default), uses visual probes when available, and produces a user-confirmed design brief for implementation.",
"argumentHint": "[feature to shape]"
},
"typeset": {
diff --git a/.grok/skills/impeccable/scripts/live-browser.js b/.grok/skills/impeccable/scripts/live-browser.js
index 504e75b9c..a63f1abe2 100644
--- a/.grok/skills/impeccable/scripts/live-browser.js
+++ b/.grok/skills/impeccable/scripts/live-browser.js
@@ -3271,6 +3271,14 @@
const P = paramsPanelPalette || barPaletteForTheme(detectPageTheme());
paramsPanelBody.innerHTML = '';
for (const p of params) {
+ // A knob the panel shows must be in the live values and on the variant,
+ // or accept drops it and the preview ignores it. Seed only missing keys
+ // so a reopen keeps edits.
+ if (!Object.hasOwn(paramsCurrentValues, p.id)) {
+ paramsCurrentValues[p.id] = p.default;
+ applyParamValue(variantEl, p, p.default);
+ }
+ const value = paramsCurrentValues[p.id];
const row = el('div', { display: 'flex', flexDirection: 'column', gap: '6px' });
const labelRow = el('div', {
display: 'flex', justifyContent: 'space-between',
@@ -3295,7 +3303,7 @@
input.min = String(p.min != null ? p.min : 0);
input.max = String(p.max != null ? p.max : 1);
input.step = String(p.step != null ? p.step : 0.05);
- input.value = String(p.default);
+ input.value = String(value);
Object.assign(input.style, {
width: '100%', accentColor: C.brand, cursor: 'pointer',
});
@@ -3310,7 +3318,7 @@
});
row.appendChild(input);
} else if (p.kind === 'toggle') {
- const initial = !!p.default;
+ const initial = !!value;
readout.textContent = initial ? 'On' : 'Off';
const track = el('button', {
position: 'relative', width: '36px', height: '20px',
@@ -3344,8 +3352,8 @@
const opts = (p.options || []).map(o =>
typeof o === 'string' ? { value: o, label: o } : o
);
- const activeOpt = opts.find(o => o.value === p.default) || opts[0];
- readout.textContent = activeOpt ? activeOpt.label : String(p.default);
+ const activeOpt = opts.find(o => o.value === value) || opts[0];
+ readout.textContent = activeOpt ? activeOpt.label : String(value);
const segRow = el('div', {
display: 'grid',
gridTemplateColumns: 'repeat(' + opts.length + ', 1fr)',
@@ -3354,7 +3362,7 @@
});
const segBtns = [];
opts.forEach(o => {
- const active = o.value === p.default;
+ const active = o.value === value;
const b = el('button', {
padding: '5px 4px', border: 'none', borderRadius: '3px',
background: active ? C.brand : 'transparent',
@@ -4988,8 +4996,8 @@
const variantEl = getVisibleVariantEl();
const params = parseVariantParams(variantEl);
if (!variantEl || params.length === 0) return;
- // Build fresh to ensure the current variant's controls are shown.
- applyParamDefaults(variantEl, params);
+ // Rebuild the controls from the current values. Defaults are applied
+ // when the variant is initialized, not when its Tune panel is reopened.
buildParamsPanel(variantEl, params);
tuneOpen = true;
showParamsPanel();
diff --git a/.hermes/skills/impeccable/reference/android.md b/.hermes/skills/impeccable/reference/android.md
index 1f67a6bb5..32a5cf7cc 100644
--- a/.hermes/skills/impeccable/reference/android.md
+++ b/.hermes/skills/impeccable/reference/android.md
@@ -42,5 +42,5 @@ Would a fluent Android user trust this app, or trip on off-spec components? The
## Verifying the build
- **Screenshots come from the emulator or a connected device, never a browser.** Build and install, then capture with `adb exec-out screencap -p > <path>` (pick a device with `adb -s <serial>` when several are attached). Capture every device class the app ships to, at least one phone and, when tablets are a target, one tablet, and write the files where the review flow expects them.
-- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (restore `1.0` after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
+- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (read both settings first with `adb shell cmd uimode night` and `adb shell settings get system font_scale`, and restore them after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
- **Emulators give breadth; gestures, refresh rates, and performance need hardware.** Say which one produced the evidence.
diff --git a/.hermes/skills/impeccable/reference/audit.md b/.hermes/skills/impeccable/reference/audit.md
index f1e25d6a7..615370e8b 100644
--- a/.hermes/skills/impeccable/reference/audit.md
+++ b/.hermes/skills/impeccable/reference/audit.md
@@ -11,7 +11,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
### 1. Accessibility (A11y)
**Check for**:
-- **Contrast issues**: Text contrast ratios < 4.5:1 (or 7:1 for AAA)
+- **Contrast issues**: Text contrast ratios < 4.5:1, or < 3:1 for large text (or 7:1 for AAA)
- **Motion sensitivity**: `prefers-reduced-motion` needs an intentional alternative that preserves state change and hierarchy; flag a global `0.01ms` kill that destroys useful feedback, flashing above threshold, and motion that blocks focus, reading, or task completion
- **Missing ARIA**: Interactive elements without proper roles, labels, or states
- **Keyboard navigation**: Missing focus indicators, illogical tab order, keyboard traps
@@ -47,7 +47,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
**Check for**:
- **Fixed widths**: Hard-coded widths that break on mobile
-- **Touch targets**: Interactive elements < 44x44px
+- **Touch targets**: Interactive elements < 44x44px. WCAG AA (SC 2.5.8) requires at least 24x24 CSS px unless an exception applies: spacing, an equivalent control, inline text, user-agent styling, or an essential size. Spacing passes when a 24 CSS px circle centered on the target's bounding box overlaps no other target and no other undersized target's circle
- **Broken touch interaction**: Custom sliders, drag surfaces, and scrollable control strips whose primary gesture fails under touch, that swallow page scroll or lose the drag to it, or that stay stuck after an interrupted gesture. Code tells: mouse-only handlers, no `touch-action` on a pointer-event drag surface, drag state that nothing clears on cancel, lost capture, or blur. Exercise the gesture when a browser tool can synthesize touch (a rendered viewport proves layout, not the gesture), then say what produced the evidence (emulated viewport, synthesized touch, which engine, physical device) and what stayed untested
- **Horizontal scroll**: Content overflow on narrow viewports
- **Text scaling**: Layouts that break when text size increases
diff --git a/.hermes/skills/impeccable/reference/distill.md b/.hermes/skills/impeccable/reference/distill.md
index 757630fae..a49697136 100644
--- a/.hermes/skills/impeccable/reference/distill.md
+++ b/.hermes/skills/impeccable/reference/distill.md
@@ -41,7 +41,7 @@ Expect to say no to good ideas to make room for great execution.
Systematically remove complexity across these dimensions:
### Information Architecture
-- **Reduce scope**: Remove secondary actions, optional features, redundant information
+- **Reduce scope**: Remove secondary actions, redundant information
- **Progressive disclosure**: Hide complexity behind clear entry points (accordions, modals, step-through flows)
- **Combine related actions**: Merge similar buttons, consolidate forms, group related content
- **Clear hierarchy**: ONE primary action, few secondary actions, everything else tertiary or hidden
@@ -70,11 +70,11 @@ Systematically remove complexity across these dimensions:
- **Clear next action**: ONE obvious next action, not five competing ones
### Content Simplification
-- **Shorter copy**: Cut every sentence in half, then do it again
+- **Shorter copy**: Cut filler, not meaning
- **Active voice**: "Save changes" not "Changes will be saved"
- **Remove jargon**: Plain language always wins
- **Scannable structure**: Short paragraphs, bullet points, clear headings
-- **Essential information only**: Remove marketing fluff, legalese, hedging
+- **Essential information only**: Remove marketing fluff, hedging
- **Remove redundant copy**: No headers restating intros, no repeated explanations, say it once
### Code Simplification
diff --git a/.hermes/skills/impeccable/reference/doctor.md b/.hermes/skills/impeccable/reference/doctor.md
index ab15fedc0..5281d2216 100644
--- a/.hermes/skills/impeccable/reference/doctor.md
+++ b/.hermes/skills/impeccable/reference/doctor.md
@@ -6,7 +6,7 @@ This is maintenance, not design. Do not redesign anything, do not open files out
Three kinds of drift travel under "out of date". Keep them apart:
-- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it. Not this command's job.
+- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it, or the harness's plugin manager for a plugin install. Not this command's job.
- **Schema drift.** An artifact was written by an older Impeccable: fields nothing reads, fields now expected, files in retired locations. Mechanical, and this command repairs most of it.
- **Truth drift.** The code moved on and the document no longer describes it. No file comparison settles this. `document` owns DESIGN.md, `init` owns PRODUCT.md, and this command's job is to hand them a specific gap rather than a vague suspicion.
diff --git a/.hermes/skills/impeccable/reference/document.md b/.hermes/skills/impeccable/reference/document.md
index 9da0bc743..ec75b7cc7 100644
--- a/.hermes/skills/impeccable/reference/document.md
+++ b/.hermes/skills/impeccable/reference/document.md
@@ -17,10 +17,10 @@ colors:
typography:
display:
fontFamily: "Cormorant Garamond, Georgia, serif"
- fontSize: "clamp(2.5rem, 7vw, 4.5rem)"
+ fontSize: "4.5rem"
fontWeight: 300
lineHeight: 1
- letterSpacing: "normal"
+ letterSpacing: "0em"
body:
# ...
rounded:
@@ -325,7 +325,7 @@ If the project has **no component library yet** (bare landing page, new project)
#### Tonal ramps
-For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue and chroma, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
+For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue, chroma reduced near white and black, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
#### Narrative mapping
diff --git a/.hermes/skills/impeccable/reference/live.md b/.hermes/skills/impeccable/reference/live.md
index f61b75be5..0f528e0a2 100644
--- a/.hermes/skills/impeccable/reference/live.md
+++ b/.hermes/skills/impeccable/reference/live.md
@@ -158,14 +158,14 @@ Sources in priority order: DESIGN.md's visual system fields; CSS custom properti
**Default:** compare each variant against the Phase A lock; palette, type voice, or rhetoric drift means it crossed into departure by accident: rework. Then confirm three different primary axes; three "tighter density" variants is failure. **Departure:** two passes, family before sentence. Family pass (non-negotiable): label each variant with a concrete family of your own choosing; shared or interchangeable labels mean rework. Sentence pass: three one-line descriptions side by side; two that rhyme mean rework. When the primary axis is color or theme, the trio must not share theme + dominant hue: three color worlds, not three shades.
-**Action-specific invocations** must vary along the action's dimension:
+**Action-specific invocations** must vary along the action's dimension; in default mode every variation stays within the available faces and existing tokens:
- `bolder`: amplify a different dimension per variant (scale / saturation / structural change).
- `quieter`: pull back a different dimension (color / ornament / spacing).
- `distill`: remove a different class of excess (visual noise / redundant content / nested structure).
- `polish`: a different refinement axis (rhythm / hierarchy / micro-details).
-- `typeset`: different pairing AND different scale ratio each.
-- `colorize`: different hue family each; vary chroma and contrast strategy.
+- `typeset`: departure varies the pairing AND the scale ratio each; default keeps the faces and varies scale ratio, case, and weight each.
+- `colorize`: departure gives each a different hue family and varies chroma and contrast strategy; default gives each a different existing palette role carrying the surface (Restrained / Committed / Full palette / Drenched) and a different contrast strategy.
- `layout`: different structural arrangement, not spacing tweaks.
- `adapt`: different target context per variant (mobile-first / tablet / desktop / print or low-data).
- `animate`: different motion vocabulary (cascade stagger / clip wipe / scale-and-focus / morph / parallax).
diff --git a/.hermes/skills/impeccable/reference/optimize.md b/.hermes/skills/impeccable/reference/optimize.md
index 5c55a1642..3f3fc7c33 100644
--- a/.hermes/skills/impeccable/reference/optimize.md
+++ b/.hermes/skills/impeccable/reference/optimize.md
@@ -38,7 +38,6 @@ Create systematic improvement plan:
src="hero.webp"
srcset="hero-400.webp 400w, hero-800.webp 800w, hero-1200.webp 1200w"
sizes="(max-width: 400px) 400px, (max-width: 800px) 800px, 1200px"
- loading="lazy"
alt="Hero image"
/>
```
diff --git a/.hermes/skills/impeccable/reference/visualize.md b/.hermes/skills/impeccable/reference/visualize.md
index f8c45c87f..a83fa50f4 100644
--- a/.hermes/skills/impeccable/reference/visualize.md
+++ b/.hermes/skills/impeccable/reference/visualize.md
@@ -26,7 +26,7 @@ Each comp is a direction test, not a screenshot specification. Core UI text, res
Show the three together on the decision page (`impeccable serve-question`, one option per comp with the comp as its hero), or in the harness only when it renders images inline; a text-only surface does not count as display. Ask what should carry forward, what feels false to the world, and whether the selected concept should be approved, combined, revised, or rejected. Then stop and wait. A structured simulated user counts as attended and receives the same question.
-Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md, and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
+Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md (the chosen direction on a new world), and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
This approval point has no substitute and no skip condition. When the structured question tool errors, fall back to the decision page; only after both fail may you treat the choice as delegated, and a delegated pick is recorded exactly as an approval is and disclosed in your first reply, not your last. The finish reviewer treats comp-round comps with no recorded approval as a material finding; decision comps under `.impeccable/mocks/decision/` are the direction round's hand, not comp-round output, and imply no approval on their own.
diff --git a/.hermes/skills/impeccable/scripts/command-metadata.json b/.hermes/skills/impeccable/scripts/command-metadata.json
index 89891ea4d..4686bb6de 100644
--- a/.hermes/skills/impeccable/scripts/command-metadata.json
+++ b/.hermes/skills/impeccable/scripts/command-metadata.json
@@ -4,7 +4,7 @@
"argumentHint": "[feature description]"
},
"init": {
- "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); offers DESIGN.md (visual: colors, typography, components) when code exists; pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
+ "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
"argumentHint": ""
},
"document": {
@@ -88,7 +88,7 @@
"argumentHint": "[target]"
},
"shape": {
- "description": "Plan UX and UI before code. Runs a required multi-round discovery interview, uses visual probes when available, and produces a user-confirmed design brief for implementation.",
+ "description": "Plan UX and UI before code. Runs a discovery interview (one round by default), uses visual probes when available, and produces a user-confirmed design brief for implementation.",
"argumentHint": "[feature to shape]"
},
"typeset": {
diff --git a/.hermes/skills/impeccable/scripts/live-browser.js b/.hermes/skills/impeccable/scripts/live-browser.js
index 504e75b9c..a63f1abe2 100644
--- a/.hermes/skills/impeccable/scripts/live-browser.js
+++ b/.hermes/skills/impeccable/scripts/live-browser.js
@@ -3271,6 +3271,14 @@
const P = paramsPanelPalette || barPaletteForTheme(detectPageTheme());
paramsPanelBody.innerHTML = '';
for (const p of params) {
+ // A knob the panel shows must be in the live values and on the variant,
+ // or accept drops it and the preview ignores it. Seed only missing keys
+ // so a reopen keeps edits.
+ if (!Object.hasOwn(paramsCurrentValues, p.id)) {
+ paramsCurrentValues[p.id] = p.default;
+ applyParamValue(variantEl, p, p.default);
+ }
+ const value = paramsCurrentValues[p.id];
const row = el('div', { display: 'flex', flexDirection: 'column', gap: '6px' });
const labelRow = el('div', {
display: 'flex', justifyContent: 'space-between',
@@ -3295,7 +3303,7 @@
input.min = String(p.min != null ? p.min : 0);
input.max = String(p.max != null ? p.max : 1);
input.step = String(p.step != null ? p.step : 0.05);
- input.value = String(p.default);
+ input.value = String(value);
Object.assign(input.style, {
width: '100%', accentColor: C.brand, cursor: 'pointer',
});
@@ -3310,7 +3318,7 @@
});
row.appendChild(input);
} else if (p.kind === 'toggle') {
- const initial = !!p.default;
+ const initial = !!value;
readout.textContent = initial ? 'On' : 'Off';
const track = el('button', {
position: 'relative', width: '36px', height: '20px',
@@ -3344,8 +3352,8 @@
const opts = (p.options || []).map(o =>
typeof o === 'string' ? { value: o, label: o } : o
);
- const activeOpt = opts.find(o => o.value === p.default) || opts[0];
- readout.textContent = activeOpt ? activeOpt.label : String(p.default);
+ const activeOpt = opts.find(o => o.value === value) || opts[0];
+ readout.textContent = activeOpt ? activeOpt.label : String(value);
const segRow = el('div', {
display: 'grid',
gridTemplateColumns: 'repeat(' + opts.length + ', 1fr)',
@@ -3354,7 +3362,7 @@
});
const segBtns = [];
opts.forEach(o => {
- const active = o.value === p.default;
+ const active = o.value === value;
const b = el('button', {
padding: '5px 4px', border: 'none', borderRadius: '3px',
background: active ? C.brand : 'transparent',
@@ -4988,8 +4996,8 @@
const variantEl = getVisibleVariantEl();
const params = parseVariantParams(variantEl);
if (!variantEl || params.length === 0) return;
- // Build fresh to ensure the current variant's controls are shown.
- applyParamDefaults(variantEl, params);
+ // Rebuild the controls from the current values. Defaults are applied
+ // when the variant is initialized, not when its Tune panel is reopened.
buildParamsPanel(variantEl, params);
tuneOpen = true;
showParamsPanel();
diff --git a/.kiro/skills/impeccable/reference/android.md b/.kiro/skills/impeccable/reference/android.md
index 1f67a6bb5..32a5cf7cc 100644
--- a/.kiro/skills/impeccable/reference/android.md
+++ b/.kiro/skills/impeccable/reference/android.md
@@ -42,5 +42,5 @@ Would a fluent Android user trust this app, or trip on off-spec components? The
## Verifying the build
- **Screenshots come from the emulator or a connected device, never a browser.** Build and install, then capture with `adb exec-out screencap -p > <path>` (pick a device with `adb -s <serial>` when several are attached). Capture every device class the app ships to, at least one phone and, when tablets are a target, one tablet, and write the files where the review flow expects them.
-- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (restore `1.0` after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
+- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (read both settings first with `adb shell cmd uimode night` and `adb shell settings get system font_scale`, and restore them after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
- **Emulators give breadth; gestures, refresh rates, and performance need hardware.** Say which one produced the evidence.
diff --git a/.kiro/skills/impeccable/reference/audit.md b/.kiro/skills/impeccable/reference/audit.md
index 94c7ba353..9fd597581 100644
--- a/.kiro/skills/impeccable/reference/audit.md
+++ b/.kiro/skills/impeccable/reference/audit.md
@@ -11,7 +11,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
### 1. Accessibility (A11y)
**Check for**:
-- **Contrast issues**: Text contrast ratios < 4.5:1 (or 7:1 for AAA)
+- **Contrast issues**: Text contrast ratios < 4.5:1, or < 3:1 for large text (or 7:1 for AAA)
- **Motion sensitivity**: `prefers-reduced-motion` needs an intentional alternative that preserves state change and hierarchy; flag a global `0.01ms` kill that destroys useful feedback, flashing above threshold, and motion that blocks focus, reading, or task completion
- **Missing ARIA**: Interactive elements without proper roles, labels, or states
- **Keyboard navigation**: Missing focus indicators, illogical tab order, keyboard traps
@@ -47,7 +47,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
**Check for**:
- **Fixed widths**: Hard-coded widths that break on mobile
-- **Touch targets**: Interactive elements < 44x44px
+- **Touch targets**: Interactive elements < 44x44px. WCAG AA (SC 2.5.8) requires at least 24x24 CSS px unless an exception applies: spacing, an equivalent control, inline text, user-agent styling, or an essential size. Spacing passes when a 24 CSS px circle centered on the target's bounding box overlaps no other target and no other undersized target's circle
- **Broken touch interaction**: Custom sliders, drag surfaces, and scrollable control strips whose primary gesture fails under touch, that swallow page scroll or lose the drag to it, or that stay stuck after an interrupted gesture. Code tells: mouse-only handlers, no `touch-action` on a pointer-event drag surface, drag state that nothing clears on cancel, lost capture, or blur. Exercise the gesture when a browser tool can synthesize touch (a rendered viewport proves layout, not the gesture), then say what produced the evidence (emulated viewport, synthesized touch, which engine, physical device) and what stayed untested
- **Horizontal scroll**: Content overflow on narrow viewports
- **Text scaling**: Layouts that break when text size increases
diff --git a/.kiro/skills/impeccable/reference/distill.md b/.kiro/skills/impeccable/reference/distill.md
index 757630fae..a49697136 100644
--- a/.kiro/skills/impeccable/reference/distill.md
+++ b/.kiro/skills/impeccable/reference/distill.md
@@ -41,7 +41,7 @@ Expect to say no to good ideas to make room for great execution.
Systematically remove complexity across these dimensions:
### Information Architecture
-- **Reduce scope**: Remove secondary actions, optional features, redundant information
+- **Reduce scope**: Remove secondary actions, redundant information
- **Progressive disclosure**: Hide complexity behind clear entry points (accordions, modals, step-through flows)
- **Combine related actions**: Merge similar buttons, consolidate forms, group related content
- **Clear hierarchy**: ONE primary action, few secondary actions, everything else tertiary or hidden
@@ -70,11 +70,11 @@ Systematically remove complexity across these dimensions:
- **Clear next action**: ONE obvious next action, not five competing ones
### Content Simplification
-- **Shorter copy**: Cut every sentence in half, then do it again
+- **Shorter copy**: Cut filler, not meaning
- **Active voice**: "Save changes" not "Changes will be saved"
- **Remove jargon**: Plain language always wins
- **Scannable structure**: Short paragraphs, bullet points, clear headings
-- **Essential information only**: Remove marketing fluff, legalese, hedging
+- **Essential information only**: Remove marketing fluff, hedging
- **Remove redundant copy**: No headers restating intros, no repeated explanations, say it once
### Code Simplification
diff --git a/.kiro/skills/impeccable/reference/doctor.md b/.kiro/skills/impeccable/reference/doctor.md
index a08e12199..0efa337eb 100644
--- a/.kiro/skills/impeccable/reference/doctor.md
+++ b/.kiro/skills/impeccable/reference/doctor.md
@@ -6,7 +6,7 @@ This is maintenance, not design. Do not redesign anything, do not open files out
Three kinds of drift travel under "out of date". Keep them apart:
-- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it. Not this command's job.
+- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it, or the harness's plugin manager for a plugin install. Not this command's job.
- **Schema drift.** An artifact was written by an older Impeccable: fields nothing reads, fields now expected, files in retired locations. Mechanical, and this command repairs most of it.
- **Truth drift.** The code moved on and the document no longer describes it. No file comparison settles this. `document` owns DESIGN.md, `init` owns PRODUCT.md, and this command's job is to hand them a specific gap rather than a vague suspicion.
diff --git a/.kiro/skills/impeccable/reference/document.md b/.kiro/skills/impeccable/reference/document.md
index 9da0bc743..ec75b7cc7 100644
--- a/.kiro/skills/impeccable/reference/document.md
+++ b/.kiro/skills/impeccable/reference/document.md
@@ -17,10 +17,10 @@ colors:
typography:
display:
fontFamily: "Cormorant Garamond, Georgia, serif"
- fontSize: "clamp(2.5rem, 7vw, 4.5rem)"
+ fontSize: "4.5rem"
fontWeight: 300
lineHeight: 1
- letterSpacing: "normal"
+ letterSpacing: "0em"
body:
# ...
rounded:
@@ -325,7 +325,7 @@ If the project has **no component library yet** (bare landing page, new project)
#### Tonal ramps
-For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue and chroma, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
+For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue, chroma reduced near white and black, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
#### Narrative mapping
diff --git a/.kiro/skills/impeccable/reference/live.md b/.kiro/skills/impeccable/reference/live.md
index ef342ab14..180b83958 100644
--- a/.kiro/skills/impeccable/reference/live.md
+++ b/.kiro/skills/impeccable/reference/live.md
@@ -158,14 +158,14 @@ Sources in priority order: DESIGN.md's visual system fields; CSS custom properti
**Default:** compare each variant against the Phase A lock; palette, type voice, or rhetoric drift means it crossed into departure by accident: rework. Then confirm three different primary axes; three "tighter density" variants is failure. **Departure:** two passes, family before sentence. Family pass (non-negotiable): label each variant with a concrete family of your own choosing; shared or interchangeable labels mean rework. Sentence pass: three one-line descriptions side by side; two that rhyme mean rework. When the primary axis is color or theme, the trio must not share theme + dominant hue: three color worlds, not three shades.
-**Action-specific invocations** must vary along the action's dimension:
+**Action-specific invocations** must vary along the action's dimension; in default mode every variation stays within the available faces and existing tokens:
- `bolder`: amplify a different dimension per variant (scale / saturation / structural change).
- `quieter`: pull back a different dimension (color / ornament / spacing).
- `distill`: remove a different class of excess (visual noise / redundant content / nested structure).
- `polish`: a different refinement axis (rhythm / hierarchy / micro-details).
-- `typeset`: different pairing AND different scale ratio each.
-- `colorize`: different hue family each; vary chroma and contrast strategy.
+- `typeset`: departure varies the pairing AND the scale ratio each; default keeps the faces and varies scale ratio, case, and weight each.
+- `colorize`: departure gives each a different hue family and varies chroma and contrast strategy; default gives each a different existing palette role carrying the surface (Restrained / Committed / Full palette / Drenched) and a different contrast strategy.
- `layout`: different structural arrangement, not spacing tweaks.
- `adapt`: different target context per variant (mobile-first / tablet / desktop / print or low-data).
- `animate`: different motion vocabulary (cascade stagger / clip wipe / scale-and-focus / morph / parallax).
diff --git a/.kiro/skills/impeccable/reference/optimize.md b/.kiro/skills/impeccable/reference/optimize.md
index 5c55a1642..3f3fc7c33 100644
--- a/.kiro/skills/impeccable/reference/optimize.md
+++ b/.kiro/skills/impeccable/reference/optimize.md
@@ -38,7 +38,6 @@ Create systematic improvement plan:
src="hero.webp"
srcset="hero-400.webp 400w, hero-800.webp 800w, hero-1200.webp 1200w"
sizes="(max-width: 400px) 400px, (max-width: 800px) 800px, 1200px"
- loading="lazy"
alt="Hero image"
/>
```
diff --git a/.kiro/skills/impeccable/reference/visualize.md b/.kiro/skills/impeccable/reference/visualize.md
index d920893e1..bb31d31ba 100644
--- a/.kiro/skills/impeccable/reference/visualize.md
+++ b/.kiro/skills/impeccable/reference/visualize.md
@@ -26,7 +26,7 @@ Each comp is a direction test, not a screenshot specification. Core UI text, res
Show the three together on the decision page (`impeccable serve-question`, one option per comp with the comp as its hero), or in the harness only when it renders images inline; a text-only surface does not count as display. Ask what should carry forward, what feels false to the world, and whether the selected concept should be approved, combined, revised, or rejected. Then stop and wait. A structured simulated user counts as attended and receives the same question.
-Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md, and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
+Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md (the chosen direction on a new world), and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
This approval point has no substitute and no skip condition. When the structured question tool errors, fall back to the decision page; only after both fail may you treat the choice as delegated, and a delegated pick is recorded exactly as an approval is and disclosed in your first reply, not your last. The finish reviewer treats comp-round comps with no recorded approval as a material finding; decision comps under `.impeccable/mocks/decision/` are the direction round's hand, not comp-round output, and imply no approval on their own.
diff --git a/.kiro/skills/impeccable/scripts/command-metadata.json b/.kiro/skills/impeccable/scripts/command-metadata.json
index 89891ea4d..4686bb6de 100644
--- a/.kiro/skills/impeccable/scripts/command-metadata.json
+++ b/.kiro/skills/impeccable/scripts/command-metadata.json
@@ -4,7 +4,7 @@
"argumentHint": "[feature description]"
},
"init": {
- "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); offers DESIGN.md (visual: colors, typography, components) when code exists; pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
+ "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
"argumentHint": ""
},
"document": {
@@ -88,7 +88,7 @@
"argumentHint": "[target]"
},
"shape": {
- "description": "Plan UX and UI before code. Runs a required multi-round discovery interview, uses visual probes when available, and produces a user-confirmed design brief for implementation.",
+ "description": "Plan UX and UI before code. Runs a discovery interview (one round by default), uses visual probes when available, and produces a user-confirmed design brief for implementation.",
"argumentHint": "[feature to shape]"
},
"typeset": {
diff --git a/.kiro/skills/impeccable/scripts/live-browser.js b/.kiro/skills/impeccable/scripts/live-browser.js
index 504e75b9c..a63f1abe2 100644
--- a/.kiro/skills/impeccable/scripts/live-browser.js
+++ b/.kiro/skills/impeccable/scripts/live-browser.js
@@ -3271,6 +3271,14 @@
const P = paramsPanelPalette || barPaletteForTheme(detectPageTheme());
paramsPanelBody.innerHTML = '';
for (const p of params) {
+ // A knob the panel shows must be in the live values and on the variant,
+ // or accept drops it and the preview ignores it. Seed only missing keys
+ // so a reopen keeps edits.
+ if (!Object.hasOwn(paramsCurrentValues, p.id)) {
+ paramsCurrentValues[p.id] = p.default;
+ applyParamValue(variantEl, p, p.default);
+ }
+ const value = paramsCurrentValues[p.id];
const row = el('div', { display: 'flex', flexDirection: 'column', gap: '6px' });
const labelRow = el('div', {
display: 'flex', justifyContent: 'space-between',
@@ -3295,7 +3303,7 @@
input.min = String(p.min != null ? p.min : 0);
input.max = String(p.max != null ? p.max : 1);
input.step = String(p.step != null ? p.step : 0.05);
- input.value = String(p.default);
+ input.value = String(value);
Object.assign(input.style, {
width: '100%', accentColor: C.brand, cursor: 'pointer',
});
@@ -3310,7 +3318,7 @@
});
row.appendChild(input);
} else if (p.kind === 'toggle') {
- const initial = !!p.default;
+ const initial = !!value;
readout.textContent = initial ? 'On' : 'Off';
const track = el('button', {
position: 'relative', width: '36px', height: '20px',
@@ -3344,8 +3352,8 @@
const opts = (p.options || []).map(o =>
typeof o === 'string' ? { value: o, label: o } : o
);
- const activeOpt = opts.find(o => o.value === p.default) || opts[0];
- readout.textContent = activeOpt ? activeOpt.label : String(p.default);
+ const activeOpt = opts.find(o => o.value === value) || opts[0];
+ readout.textContent = activeOpt ? activeOpt.label : String(value);
const segRow = el('div', {
display: 'grid',
gridTemplateColumns: 'repeat(' + opts.length + ', 1fr)',
@@ -3354,7 +3362,7 @@
});
const segBtns = [];
opts.forEach(o => {
- const active = o.value === p.default;
+ const active = o.value === value;
const b = el('button', {
padding: '5px 4px', border: 'none', borderRadius: '3px',
background: active ? C.brand : 'transparent',
@@ -4988,8 +4996,8 @@
const variantEl = getVisibleVariantEl();
const params = parseVariantParams(variantEl);
if (!variantEl || params.length === 0) return;
- // Build fresh to ensure the current variant's controls are shown.
- applyParamDefaults(variantEl, params);
+ // Rebuild the controls from the current values. Defaults are applied
+ // when the variant is initialized, not when its Tune panel is reopened.
buildParamsPanel(variantEl, params);
tuneOpen = true;
showParamsPanel();
diff --git a/.omp/skills/impeccable/reference/android.md b/.omp/skills/impeccable/reference/android.md
index 1f67a6bb5..32a5cf7cc 100644
--- a/.omp/skills/impeccable/reference/android.md
+++ b/.omp/skills/impeccable/reference/android.md
@@ -42,5 +42,5 @@ Would a fluent Android user trust this app, or trip on off-spec components? The
## Verifying the build
- **Screenshots come from the emulator or a connected device, never a browser.** Build and install, then capture with `adb exec-out screencap -p > <path>` (pick a device with `adb -s <serial>` when several are attached). Capture every device class the app ships to, at least one phone and, when tablets are a target, one tablet, and write the files where the review flow expects them.
-- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (restore `1.0` after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
+- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (read both settings first with `adb shell cmd uimode night` and `adb shell settings get system font_scale`, and restore them after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
- **Emulators give breadth; gestures, refresh rates, and performance need hardware.** Say which one produced the evidence.
diff --git a/.omp/skills/impeccable/reference/audit.md b/.omp/skills/impeccable/reference/audit.md
index 2b11041b2..856ab8958 100644
--- a/.omp/skills/impeccable/reference/audit.md
+++ b/.omp/skills/impeccable/reference/audit.md
@@ -11,7 +11,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
### 1. Accessibility (A11y)
**Check for**:
-- **Contrast issues**: Text contrast ratios < 4.5:1 (or 7:1 for AAA)
+- **Contrast issues**: Text contrast ratios < 4.5:1, or < 3:1 for large text (or 7:1 for AAA)
- **Motion sensitivity**: `prefers-reduced-motion` needs an intentional alternative that preserves state change and hierarchy; flag a global `0.01ms` kill that destroys useful feedback, flashing above threshold, and motion that blocks focus, reading, or task completion
- **Missing ARIA**: Interactive elements without proper roles, labels, or states
- **Keyboard navigation**: Missing focus indicators, illogical tab order, keyboard traps
@@ -47,7 +47,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
**Check for**:
- **Fixed widths**: Hard-coded widths that break on mobile
-- **Touch targets**: Interactive elements < 44x44px
+- **Touch targets**: Interactive elements < 44x44px. WCAG AA (SC 2.5.8) requires at least 24x24 CSS px unless an exception applies: spacing, an equivalent control, inline text, user-agent styling, or an essential size. Spacing passes when a 24 CSS px circle centered on the target's bounding box overlaps no other target and no other undersized target's circle
- **Broken touch interaction**: Custom sliders, drag surfaces, and scrollable control strips whose primary gesture fails under touch, that swallow page scroll or lose the drag to it, or that stay stuck after an interrupted gesture. Code tells: mouse-only handlers, no `touch-action` on a pointer-event drag surface, drag state that nothing clears on cancel, lost capture, or blur. Exercise the gesture when a browser tool can synthesize touch (a rendered viewport proves layout, not the gesture), then say what produced the evidence (emulated viewport, synthesized touch, which engine, physical device) and what stayed untested
- **Horizontal scroll**: Content overflow on narrow viewports
- **Text scaling**: Layouts that break when text size increases
diff --git a/.omp/skills/impeccable/reference/distill.md b/.omp/skills/impeccable/reference/distill.md
index 757630fae..a49697136 100644
--- a/.omp/skills/impeccable/reference/distill.md
+++ b/.omp/skills/impeccable/reference/distill.md
@@ -41,7 +41,7 @@ Expect to say no to good ideas to make room for great execution.
Systematically remove complexity across these dimensions:
### Information Architecture
-- **Reduce scope**: Remove secondary actions, optional features, redundant information
+- **Reduce scope**: Remove secondary actions, redundant information
- **Progressive disclosure**: Hide complexity behind clear entry points (accordions, modals, step-through flows)
- **Combine related actions**: Merge similar buttons, consolidate forms, group related content
- **Clear hierarchy**: ONE primary action, few secondary actions, everything else tertiary or hidden
@@ -70,11 +70,11 @@ Systematically remove complexity across these dimensions:
- **Clear next action**: ONE obvious next action, not five competing ones
### Content Simplification
-- **Shorter copy**: Cut every sentence in half, then do it again
+- **Shorter copy**: Cut filler, not meaning
- **Active voice**: "Save changes" not "Changes will be saved"
- **Remove jargon**: Plain language always wins
- **Scannable structure**: Short paragraphs, bullet points, clear headings
-- **Essential information only**: Remove marketing fluff, legalese, hedging
+- **Essential information only**: Remove marketing fluff, hedging
- **Remove redundant copy**: No headers restating intros, no repeated explanations, say it once
### Code Simplification
diff --git a/.omp/skills/impeccable/reference/doctor.md b/.omp/skills/impeccable/reference/doctor.md
index 46f2c5c11..f90062139 100644
--- a/.omp/skills/impeccable/reference/doctor.md
+++ b/.omp/skills/impeccable/reference/doctor.md
@@ -6,7 +6,7 @@ This is maintenance, not design. Do not redesign anything, do not open files out
Three kinds of drift travel under "out of date". Keep them apart:
-- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it. Not this command's job.
+- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it, or the harness's plugin manager for a plugin install. Not this command's job.
- **Schema drift.** An artifact was written by an older Impeccable: fields nothing reads, fields now expected, files in retired locations. Mechanical, and this command repairs most of it.
- **Truth drift.** The code moved on and the document no longer describes it. No file comparison settles this. `document` owns DESIGN.md, `init` owns PRODUCT.md, and this command's job is to hand them a specific gap rather than a vague suspicion.
diff --git a/.omp/skills/impeccable/reference/document.md b/.omp/skills/impeccable/reference/document.md
index 9da0bc743..ec75b7cc7 100644
--- a/.omp/skills/impeccable/reference/document.md
+++ b/.omp/skills/impeccable/reference/document.md
@@ -17,10 +17,10 @@ colors:
typography:
display:
fontFamily: "Cormorant Garamond, Georgia, serif"
- fontSize: "clamp(2.5rem, 7vw, 4.5rem)"
+ fontSize: "4.5rem"
fontWeight: 300
lineHeight: 1
- letterSpacing: "normal"
+ letterSpacing: "0em"
body:
# ...
rounded:
@@ -325,7 +325,7 @@ If the project has **no component library yet** (bare landing page, new project)
#### Tonal ramps
-For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue and chroma, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
+For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue, chroma reduced near white and black, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
#### Narrative mapping
diff --git a/.omp/skills/impeccable/reference/live.md b/.omp/skills/impeccable/reference/live.md
index b2f84fdab..3f416db41 100644
--- a/.omp/skills/impeccable/reference/live.md
+++ b/.omp/skills/impeccable/reference/live.md
@@ -158,14 +158,14 @@ Sources in priority order: DESIGN.md's visual system fields; CSS custom properti
**Default:** compare each variant against the Phase A lock; palette, type voice, or rhetoric drift means it crossed into departure by accident: rework. Then confirm three different primary axes; three "tighter density" variants is failure. **Departure:** two passes, family before sentence. Family pass (non-negotiable): label each variant with a concrete family of your own choosing; shared or interchangeable labels mean rework. Sentence pass: three one-line descriptions side by side; two that rhyme mean rework. When the primary axis is color or theme, the trio must not share theme + dominant hue: three color worlds, not three shades.
-**Action-specific invocations** must vary along the action's dimension:
+**Action-specific invocations** must vary along the action's dimension; in default mode every variation stays within the available faces and existing tokens:
- `bolder`: amplify a different dimension per variant (scale / saturation / structural change).
- `quieter`: pull back a different dimension (color / ornament / spacing).
- `distill`: remove a different class of excess (visual noise / redundant content / nested structure).
- `polish`: a different refinement axis (rhythm / hierarchy / micro-details).
-- `typeset`: different pairing AND different scale ratio each.
-- `colorize`: different hue family each; vary chroma and contrast strategy.
+- `typeset`: departure varies the pairing AND the scale ratio each; default keeps the faces and varies scale ratio, case, and weight each.
+- `colorize`: departure gives each a different hue family and varies chroma and contrast strategy; default gives each a different existing palette role carrying the surface (Restrained / Committed / Full palette / Drenched) and a different contrast strategy.
- `layout`: different structural arrangement, not spacing tweaks.
- `adapt`: different target context per variant (mobile-first / tablet / desktop / print or low-data).
- `animate`: different motion vocabulary (cascade stagger / clip wipe / scale-and-focus / morph / parallax).
diff --git a/.omp/skills/impeccable/reference/optimize.md b/.omp/skills/impeccable/reference/optimize.md
index 5c55a1642..3f3fc7c33 100644
--- a/.omp/skills/impeccable/reference/optimize.md
+++ b/.omp/skills/impeccable/reference/optimize.md
@@ -38,7 +38,6 @@ Create systematic improvement plan:
src="hero.webp"
srcset="hero-400.webp 400w, hero-800.webp 800w, hero-1200.webp 1200w"
sizes="(max-width: 400px) 400px, (max-width: 800px) 800px, 1200px"
- loading="lazy"
alt="Hero image"
/>
```
diff --git a/.omp/skills/impeccable/reference/visualize.md b/.omp/skills/impeccable/reference/visualize.md
index a0ed2298d..800a8ce84 100644
--- a/.omp/skills/impeccable/reference/visualize.md
+++ b/.omp/skills/impeccable/reference/visualize.md
@@ -26,7 +26,7 @@ Each comp is a direction test, not a screenshot specification. Core UI text, res
Show the three together on the decision page (`impeccable serve-question`, one option per comp with the comp as its hero), or in the harness only when it renders images inline; a text-only surface does not count as display. Ask what should carry forward, what feels false to the world, and whether the selected concept should be approved, combined, revised, or rejected. Then stop and wait. A structured simulated user counts as attended and receives the same question.
-Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md, and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
+Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md (the chosen direction on a new world), and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
This approval point has no substitute and no skip condition. When the structured question tool errors, fall back to the decision page; only after both fail may you treat the choice as delegated, and a delegated pick is recorded exactly as an approval is and disclosed in your first reply, not your last. The finish reviewer treats comp-round comps with no recorded approval as a material finding; decision comps under `.impeccable/mocks/decision/` are the direction round's hand, not comp-round output, and imply no approval on their own.
diff --git a/.omp/skills/impeccable/scripts/command-metadata.json b/.omp/skills/impeccable/scripts/command-metadata.json
index 89891ea4d..4686bb6de 100644
--- a/.omp/skills/impeccable/scripts/command-metadata.json
+++ b/.omp/skills/impeccable/scripts/command-metadata.json
@@ -4,7 +4,7 @@
"argumentHint": "[feature description]"
},
"init": {
- "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); offers DESIGN.md (visual: colors, typography, components) when code exists; pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
+ "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
"argumentHint": ""
},
"document": {
@@ -88,7 +88,7 @@
"argumentHint": "[target]"
},
"shape": {
- "description": "Plan UX and UI before code. Runs a required multi-round discovery interview, uses visual probes when available, and produces a user-confirmed design brief for implementation.",
+ "description": "Plan UX and UI before code. Runs a discovery interview (one round by default), uses visual probes when available, and produces a user-confirmed design brief for implementation.",
"argumentHint": "[feature to shape]"
},
"typeset": {
diff --git a/.omp/skills/impeccable/scripts/live-browser.js b/.omp/skills/impeccable/scripts/live-browser.js
index 504e75b9c..a63f1abe2 100644
--- a/.omp/skills/impeccable/scripts/live-browser.js
+++ b/.omp/skills/impeccable/scripts/live-browser.js
@@ -3271,6 +3271,14 @@
const P = paramsPanelPalette || barPaletteForTheme(detectPageTheme());
paramsPanelBody.innerHTML = '';
for (const p of params) {
+ // A knob the panel shows must be in the live values and on the variant,
+ // or accept drops it and the preview ignores it. Seed only missing keys
+ // so a reopen keeps edits.
+ if (!Object.hasOwn(paramsCurrentValues, p.id)) {
+ paramsCurrentValues[p.id] = p.default;
+ applyParamValue(variantEl, p, p.default);
+ }
+ const value = paramsCurrentValues[p.id];
const row = el('div', { display: 'flex', flexDirection: 'column', gap: '6px' });
const labelRow = el('div', {
display: 'flex', justifyContent: 'space-between',
@@ -3295,7 +3303,7 @@
input.min = String(p.min != null ? p.min : 0);
input.max = String(p.max != null ? p.max : 1);
input.step = String(p.step != null ? p.step : 0.05);
- input.value = String(p.default);
+ input.value = String(value);
Object.assign(input.style, {
width: '100%', accentColor: C.brand, cursor: 'pointer',
});
@@ -3310,7 +3318,7 @@
});
row.appendChild(input);
} else if (p.kind === 'toggle') {
- const initial = !!p.default;
+ const initial = !!value;
readout.textContent = initial ? 'On' : 'Off';
const track = el('button', {
position: 'relative', width: '36px', height: '20px',
@@ -3344,8 +3352,8 @@
const opts = (p.options || []).map(o =>
typeof o === 'string' ? { value: o, label: o } : o
);
- const activeOpt = opts.find(o => o.value === p.default) || opts[0];
- readout.textContent = activeOpt ? activeOpt.label : String(p.default);
+ const activeOpt = opts.find(o => o.value === value) || opts[0];
+ readout.textContent = activeOpt ? activeOpt.label : String(value);
const segRow = el('div', {
display: 'grid',
gridTemplateColumns: 'repeat(' + opts.length + ', 1fr)',
@@ -3354,7 +3362,7 @@
});
const segBtns = [];
opts.forEach(o => {
- const active = o.value === p.default;
+ const active = o.value === value;
const b = el('button', {
padding: '5px 4px', border: 'none', borderRadius: '3px',
background: active ? C.brand : 'transparent',
@@ -4988,8 +4996,8 @@
const variantEl = getVisibleVariantEl();
const params = parseVariantParams(variantEl);
if (!variantEl || params.length === 0) return;
- // Build fresh to ensure the current variant's controls are shown.
- applyParamDefaults(variantEl, params);
+ // Rebuild the controls from the current values. Defaults are applied
+ // when the variant is initialized, not when its Tune panel is reopened.
buildParamsPanel(variantEl, params);
tuneOpen = true;
showParamsPanel();
diff --git a/.opencode/skills/impeccable/reference/android.md b/.opencode/skills/impeccable/reference/android.md
index 1f67a6bb5..32a5cf7cc 100644
--- a/.opencode/skills/impeccable/reference/android.md
+++ b/.opencode/skills/impeccable/reference/android.md
@@ -42,5 +42,5 @@ Would a fluent Android user trust this app, or trip on off-spec components? The
## Verifying the build
- **Screenshots come from the emulator or a connected device, never a browser.** Build and install, then capture with `adb exec-out screencap -p > <path>` (pick a device with `adb -s <serial>` when several are attached). Capture every device class the app ships to, at least one phone and, when tablets are a target, one tablet, and write the files where the review flow expects them.
-- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (restore `1.0` after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
+- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (read both settings first with `adb shell cmd uimode night` and `adb shell settings get system font_scale`, and restore them after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
- **Emulators give breadth; gestures, refresh rates, and performance need hardware.** Say which one produced the evidence.
diff --git a/.opencode/skills/impeccable/reference/audit.md b/.opencode/skills/impeccable/reference/audit.md
index 2d81cff36..c8226387f 100644
--- a/.opencode/skills/impeccable/reference/audit.md
+++ b/.opencode/skills/impeccable/reference/audit.md
@@ -11,7 +11,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
### 1. Accessibility (A11y)
**Check for**:
-- **Contrast issues**: Text contrast ratios < 4.5:1 (or 7:1 for AAA)
+- **Contrast issues**: Text contrast ratios < 4.5:1, or < 3:1 for large text (or 7:1 for AAA)
- **Motion sensitivity**: `prefers-reduced-motion` needs an intentional alternative that preserves state change and hierarchy; flag a global `0.01ms` kill that destroys useful feedback, flashing above threshold, and motion that blocks focus, reading, or task completion
- **Missing ARIA**: Interactive elements without proper roles, labels, or states
- **Keyboard navigation**: Missing focus indicators, illogical tab order, keyboard traps
@@ -47,7 +47,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
**Check for**:
- **Fixed widths**: Hard-coded widths that break on mobile
-- **Touch targets**: Interactive elements < 44x44px
+- **Touch targets**: Interactive elements < 44x44px. WCAG AA (SC 2.5.8) requires at least 24x24 CSS px unless an exception applies: spacing, an equivalent control, inline text, user-agent styling, or an essential size. Spacing passes when a 24 CSS px circle centered on the target's bounding box overlaps no other target and no other undersized target's circle
- **Broken touch interaction**: Custom sliders, drag surfaces, and scrollable control strips whose primary gesture fails under touch, that swallow page scroll or lose the drag to it, or that stay stuck after an interrupted gesture. Code tells: mouse-only handlers, no `touch-action` on a pointer-event drag surface, drag state that nothing clears on cancel, lost capture, or blur. Exercise the gesture when a browser tool can synthesize touch (a rendered viewport proves layout, not the gesture), then say what produced the evidence (emulated viewport, synthesized touch, which engine, physical device) and what stayed untested
- **Horizontal scroll**: Content overflow on narrow viewports
- **Text scaling**: Layouts that break when text size increases
diff --git a/.opencode/skills/impeccable/reference/distill.md b/.opencode/skills/impeccable/reference/distill.md
index c949f570a..fc49d2152 100644
--- a/.opencode/skills/impeccable/reference/distill.md
+++ b/.opencode/skills/impeccable/reference/distill.md
@@ -41,7 +41,7 @@ Expect to say no to good ideas to make room for great execution.
Systematically remove complexity across these dimensions:
### Information Architecture
-- **Reduce scope**: Remove secondary actions, optional features, redundant information
+- **Reduce scope**: Remove secondary actions, redundant information
- **Progressive disclosure**: Hide complexity behind clear entry points (accordions, modals, step-through flows)
- **Combine related actions**: Merge similar buttons, consolidate forms, group related content
- **Clear hierarchy**: ONE primary action, few secondary actions, everything else tertiary or hidden
@@ -70,11 +70,11 @@ Systematically remove complexity across these dimensions:
- **Clear next action**: ONE obvious next action, not five competing ones
### Content Simplification
-- **Shorter copy**: Cut every sentence in half, then do it again
+- **Shorter copy**: Cut filler, not meaning
- **Active voice**: "Save changes" not "Changes will be saved"
- **Remove jargon**: Plain language always wins
- **Scannable structure**: Short paragraphs, bullet points, clear headings
-- **Essential information only**: Remove marketing fluff, legalese, hedging
+- **Essential information only**: Remove marketing fluff, hedging
- **Remove redundant copy**: No headers restating intros, no repeated explanations, say it once
### Code Simplification
diff --git a/.opencode/skills/impeccable/reference/doctor.md b/.opencode/skills/impeccable/reference/doctor.md
index 1f7ebe816..b8a52fc2a 100644
--- a/.opencode/skills/impeccable/reference/doctor.md
+++ b/.opencode/skills/impeccable/reference/doctor.md
@@ -6,7 +6,7 @@ This is maintenance, not design. Do not redesign anything, do not open files out
Three kinds of drift travel under "out of date". Keep them apart:
-- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it. Not this command's job.
+- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it, or the harness's plugin manager for a plugin install. Not this command's job.
- **Schema drift.** An artifact was written by an older Impeccable: fields nothing reads, fields now expected, files in retired locations. Mechanical, and this command repairs most of it.
- **Truth drift.** The code moved on and the document no longer describes it. No file comparison settles this. `document` owns DESIGN.md, `init` owns PRODUCT.md, and this command's job is to hand them a specific gap rather than a vague suspicion.
diff --git a/.opencode/skills/impeccable/reference/document.md b/.opencode/skills/impeccable/reference/document.md
index d9b0014c6..42f7d0450 100644
--- a/.opencode/skills/impeccable/reference/document.md
+++ b/.opencode/skills/impeccable/reference/document.md
@@ -17,10 +17,10 @@ colors:
typography:
display:
fontFamily: "Cormorant Garamond, Georgia, serif"
- fontSize: "clamp(2.5rem, 7vw, 4.5rem)"
+ fontSize: "4.5rem"
fontWeight: 300
lineHeight: 1
- letterSpacing: "normal"
+ letterSpacing: "0em"
body:
# ...
rounded:
@@ -325,7 +325,7 @@ If the project has **no component library yet** (bare landing page, new project)
#### Tonal ramps
-For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue and chroma, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
+For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue, chroma reduced near white and black, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
#### Narrative mapping
diff --git a/.opencode/skills/impeccable/reference/live.md b/.opencode/skills/impeccable/reference/live.md
index 8bbc0a772..14bed377e 100644
--- a/.opencode/skills/impeccable/reference/live.md
+++ b/.opencode/skills/impeccable/reference/live.md
@@ -158,14 +158,14 @@ Sources in priority order: DESIGN.md's visual system fields; CSS custom properti
**Default:** compare each variant against the Phase A lock; palette, type voice, or rhetoric drift means it crossed into departure by accident: rework. Then confirm three different primary axes; three "tighter density" variants is failure. **Departure:** two passes, family before sentence. Family pass (non-negotiable): label each variant with a concrete family of your own choosing; shared or interchangeable labels mean rework. Sentence pass: three one-line descriptions side by side; two that rhyme mean rework. When the primary axis is color or theme, the trio must not share theme + dominant hue: three color worlds, not three shades.
-**Action-specific invocations** must vary along the action's dimension:
+**Action-specific invocations** must vary along the action's dimension; in default mode every variation stays within the available faces and existing tokens:
- `bolder`: amplify a different dimension per variant (scale / saturation / structural change).
- `quieter`: pull back a different dimension (color / ornament / spacing).
- `distill`: remove a different class of excess (visual noise / redundant content / nested structure).
- `polish`: a different refinement axis (rhythm / hierarchy / micro-details).
-- `typeset`: different pairing AND different scale ratio each.
-- `colorize`: different hue family each; vary chroma and contrast strategy.
+- `typeset`: departure varies the pairing AND the scale ratio each; default keeps the faces and varies scale ratio, case, and weight each.
+- `colorize`: departure gives each a different hue family and varies chroma and contrast strategy; default gives each a different existing palette role carrying the surface (Restrained / Committed / Full palette / Drenched) and a different contrast strategy.
- `layout`: different structural arrangement, not spacing tweaks.
- `adapt`: different target context per variant (mobile-first / tablet / desktop / print or low-data).
- `animate`: different motion vocabulary (cascade stagger / clip wipe / scale-and-focus / morph / parallax).
diff --git a/.opencode/skills/impeccable/reference/optimize.md b/.opencode/skills/impeccable/reference/optimize.md
index 5c55a1642..3f3fc7c33 100644
--- a/.opencode/skills/impeccable/reference/optimize.md
+++ b/.opencode/skills/impeccable/reference/optimize.md
@@ -38,7 +38,6 @@ Create systematic improvement plan:
src="hero.webp"
srcset="hero-400.webp 400w, hero-800.webp 800w, hero-1200.webp 1200w"
sizes="(max-width: 400px) 400px, (max-width: 800px) 800px, 1200px"
- loading="lazy"
alt="Hero image"
/>
```
diff --git a/.opencode/skills/impeccable/reference/visualize.md b/.opencode/skills/impeccable/reference/visualize.md
index 66401d53a..57b9b02a0 100644
--- a/.opencode/skills/impeccable/reference/visualize.md
+++ b/.opencode/skills/impeccable/reference/visualize.md
@@ -26,7 +26,7 @@ Each comp is a direction test, not a screenshot specification. Core UI text, res
Show the three together on the decision page (`impeccable serve-question`, one option per comp with the comp as its hero), or in the harness only when it renders images inline; a text-only surface does not count as display. Ask what should carry forward, what feels false to the world, and whether the selected concept should be approved, combined, revised, or rejected. Then stop and wait. A structured simulated user counts as attended and receives the same question.
-Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md, and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
+Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md (the chosen direction on a new world), and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
This approval point has no substitute and no skip condition. When the structured question tool errors, fall back to the decision page; only after both fail may you treat the choice as delegated, and a delegated pick is recorded exactly as an approval is and disclosed in your first reply, not your last. The finish reviewer treats comp-round comps with no recorded approval as a material finding; decision comps under `.impeccable/mocks/decision/` are the direction round's hand, not comp-round output, and imply no approval on their own.
diff --git a/.opencode/skills/impeccable/scripts/command-metadata.json b/.opencode/skills/impeccable/scripts/command-metadata.json
index 89891ea4d..4686bb6de 100644
--- a/.opencode/skills/impeccable/scripts/command-metadata.json
+++ b/.opencode/skills/impeccable/scripts/command-metadata.json
@@ -4,7 +4,7 @@
"argumentHint": "[feature description]"
},
"init": {
- "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); offers DESIGN.md (visual: colors, typography, components) when code exists; pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
+ "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
"argumentHint": ""
},
"document": {
@@ -88,7 +88,7 @@
"argumentHint": "[target]"
},
"shape": {
- "description": "Plan UX and UI before code. Runs a required multi-round discovery interview, uses visual probes when available, and produces a user-confirmed design brief for implementation.",
+ "description": "Plan UX and UI before code. Runs a discovery interview (one round by default), uses visual probes when available, and produces a user-confirmed design brief for implementation.",
"argumentHint": "[feature to shape]"
},
"typeset": {
diff --git a/.opencode/skills/impeccable/scripts/live-browser.js b/.opencode/skills/impeccable/scripts/live-browser.js
index 504e75b9c..a63f1abe2 100644
--- a/.opencode/skills/impeccable/scripts/live-browser.js
+++ b/.opencode/skills/impeccable/scripts/live-browser.js
@@ -3271,6 +3271,14 @@
const P = paramsPanelPalette || barPaletteForTheme(detectPageTheme());
paramsPanelBody.innerHTML = '';
for (const p of params) {
+ // A knob the panel shows must be in the live values and on the variant,
+ // or accept drops it and the preview ignores it. Seed only missing keys
+ // so a reopen keeps edits.
+ if (!Object.hasOwn(paramsCurrentValues, p.id)) {
+ paramsCurrentValues[p.id] = p.default;
+ applyParamValue(variantEl, p, p.default);
+ }
+ const value = paramsCurrentValues[p.id];
const row = el('div', { display: 'flex', flexDirection: 'column', gap: '6px' });
const labelRow = el('div', {
display: 'flex', justifyContent: 'space-between',
@@ -3295,7 +3303,7 @@
input.min = String(p.min != null ? p.min : 0);
input.max = String(p.max != null ? p.max : 1);
input.step = String(p.step != null ? p.step : 0.05);
- input.value = String(p.default);
+ input.value = String(value);
Object.assign(input.style, {
width: '100%', accentColor: C.brand, cursor: 'pointer',
});
@@ -3310,7 +3318,7 @@
});
row.appendChild(input);
} else if (p.kind === 'toggle') {
- const initial = !!p.default;
+ const initial = !!value;
readout.textContent = initial ? 'On' : 'Off';
const track = el('button', {
position: 'relative', width: '36px', height: '20px',
@@ -3344,8 +3352,8 @@
const opts = (p.options || []).map(o =>
typeof o === 'string' ? { value: o, label: o } : o
);
- const activeOpt = opts.find(o => o.value === p.default) || opts[0];
- readout.textContent = activeOpt ? activeOpt.label : String(p.default);
+ const activeOpt = opts.find(o => o.value === value) || opts[0];
+ readout.textContent = activeOpt ? activeOpt.label : String(value);
const segRow = el('div', {
display: 'grid',
gridTemplateColumns: 'repeat(' + opts.length + ', 1fr)',
@@ -3354,7 +3362,7 @@
});
const segBtns = [];
opts.forEach(o => {
- const active = o.value === p.default;
+ const active = o.value === value;
const b = el('button', {
padding: '5px 4px', border: 'none', borderRadius: '3px',
background: active ? C.brand : 'transparent',
@@ -4988,8 +4996,8 @@
const variantEl = getVisibleVariantEl();
const params = parseVariantParams(variantEl);
if (!variantEl || params.length === 0) return;
- // Build fresh to ensure the current variant's controls are shown.
- applyParamDefaults(variantEl, params);
+ // Rebuild the controls from the current values. Defaults are applied
+ // when the variant is initialized, not when its Tune panel is reopened.
buildParamsPanel(variantEl, params);
tuneOpen = true;
showParamsPanel();
diff --git a/.pi/skills/impeccable/reference/android.md b/.pi/skills/impeccable/reference/android.md
index 1f67a6bb5..32a5cf7cc 100644
--- a/.pi/skills/impeccable/reference/android.md
+++ b/.pi/skills/impeccable/reference/android.md
@@ -42,5 +42,5 @@ Would a fluent Android user trust this app, or trip on off-spec components? The
## Verifying the build
- **Screenshots come from the emulator or a connected device, never a browser.** Build and install, then capture with `adb exec-out screencap -p > <path>` (pick a device with `adb -s <serial>` when several are attached). Capture every device class the app ships to, at least one phone and, when tablets are a target, one tablet, and write the files where the review flow expects them.
-- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (restore `1.0` after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
+- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (read both settings first with `adb shell cmd uimode night` and `adb shell settings get system font_scale`, and restore them after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
- **Emulators give breadth; gestures, refresh rates, and performance need hardware.** Say which one produced the evidence.
diff --git a/.pi/skills/impeccable/reference/audit.md b/.pi/skills/impeccable/reference/audit.md
index f553bf6a3..92362901b 100644
--- a/.pi/skills/impeccable/reference/audit.md
+++ b/.pi/skills/impeccable/reference/audit.md
@@ -11,7 +11,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
### 1. Accessibility (A11y)
**Check for**:
-- **Contrast issues**: Text contrast ratios < 4.5:1 (or 7:1 for AAA)
+- **Contrast issues**: Text contrast ratios < 4.5:1, or < 3:1 for large text (or 7:1 for AAA)
- **Motion sensitivity**: `prefers-reduced-motion` needs an intentional alternative that preserves state change and hierarchy; flag a global `0.01ms` kill that destroys useful feedback, flashing above threshold, and motion that blocks focus, reading, or task completion
- **Missing ARIA**: Interactive elements without proper roles, labels, or states
- **Keyboard navigation**: Missing focus indicators, illogical tab order, keyboard traps
@@ -47,7 +47,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
**Check for**:
- **Fixed widths**: Hard-coded widths that break on mobile
-- **Touch targets**: Interactive elements < 44x44px
+- **Touch targets**: Interactive elements < 44x44px. WCAG AA (SC 2.5.8) requires at least 24x24 CSS px unless an exception applies: spacing, an equivalent control, inline text, user-agent styling, or an essential size. Spacing passes when a 24 CSS px circle centered on the target's bounding box overlaps no other target and no other undersized target's circle
- **Broken touch interaction**: Custom sliders, drag surfaces, and scrollable control strips whose primary gesture fails under touch, that swallow page scroll or lose the drag to it, or that stay stuck after an interrupted gesture. Code tells: mouse-only handlers, no `touch-action` on a pointer-event drag surface, drag state that nothing clears on cancel, lost capture, or blur. Exercise the gesture when a browser tool can synthesize touch (a rendered viewport proves layout, not the gesture), then say what produced the evidence (emulated viewport, synthesized touch, which engine, physical device) and what stayed untested
- **Horizontal scroll**: Content overflow on narrow viewports
- **Text scaling**: Layouts that break when text size increases
diff --git a/.pi/skills/impeccable/reference/distill.md b/.pi/skills/impeccable/reference/distill.md
index 757630fae..a49697136 100644
--- a/.pi/skills/impeccable/reference/distill.md
+++ b/.pi/skills/impeccable/reference/distill.md
@@ -41,7 +41,7 @@ Expect to say no to good ideas to make room for great execution.
Systematically remove complexity across these dimensions:
### Information Architecture
-- **Reduce scope**: Remove secondary actions, optional features, redundant information
+- **Reduce scope**: Remove secondary actions, redundant information
- **Progressive disclosure**: Hide complexity behind clear entry points (accordions, modals, step-through flows)
- **Combine related actions**: Merge similar buttons, consolidate forms, group related content
- **Clear hierarchy**: ONE primary action, few secondary actions, everything else tertiary or hidden
@@ -70,11 +70,11 @@ Systematically remove complexity across these dimensions:
- **Clear next action**: ONE obvious next action, not five competing ones
### Content Simplification
-- **Shorter copy**: Cut every sentence in half, then do it again
+- **Shorter copy**: Cut filler, not meaning
- **Active voice**: "Save changes" not "Changes will be saved"
- **Remove jargon**: Plain language always wins
- **Scannable structure**: Short paragraphs, bullet points, clear headings
-- **Essential information only**: Remove marketing fluff, legalese, hedging
+- **Essential information only**: Remove marketing fluff, hedging
- **Remove redundant copy**: No headers restating intros, no repeated explanations, say it once
### Code Simplification
diff --git a/.pi/skills/impeccable/reference/doctor.md b/.pi/skills/impeccable/reference/doctor.md
index 85431c476..ce7bf6d85 100644
--- a/.pi/skills/impeccable/reference/doctor.md
+++ b/.pi/skills/impeccable/reference/doctor.md
@@ -6,7 +6,7 @@ This is maintenance, not design. Do not redesign anything, do not open files out
Three kinds of drift travel under "out of date". Keep them apart:
-- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it. Not this command's job.
+- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it, or the harness's plugin manager for a plugin install. Not this command's job.
- **Schema drift.** An artifact was written by an older Impeccable: fields nothing reads, fields now expected, files in retired locations. Mechanical, and this command repairs most of it.
- **Truth drift.** The code moved on and the document no longer describes it. No file comparison settles this. `document` owns DESIGN.md, `init` owns PRODUCT.md, and this command's job is to hand them a specific gap rather than a vague suspicion.
diff --git a/.pi/skills/impeccable/reference/document.md b/.pi/skills/impeccable/reference/document.md
index 9da0bc743..ec75b7cc7 100644
--- a/.pi/skills/impeccable/reference/document.md
+++ b/.pi/skills/impeccable/reference/document.md
@@ -17,10 +17,10 @@ colors:
typography:
display:
fontFamily: "Cormorant Garamond, Georgia, serif"
- fontSize: "clamp(2.5rem, 7vw, 4.5rem)"
+ fontSize: "4.5rem"
fontWeight: 300
lineHeight: 1
- letterSpacing: "normal"
+ letterSpacing: "0em"
body:
# ...
rounded:
@@ -325,7 +325,7 @@ If the project has **no component library yet** (bare landing page, new project)
#### Tonal ramps
-For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue and chroma, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
+For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue, chroma reduced near white and black, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
#### Narrative mapping
diff --git a/.pi/skills/impeccable/reference/live.md b/.pi/skills/impeccable/reference/live.md
index c322420e1..d576bf795 100644
--- a/.pi/skills/impeccable/reference/live.md
+++ b/.pi/skills/impeccable/reference/live.md
@@ -158,14 +158,14 @@ Sources in priority order: DESIGN.md's visual system fields; CSS custom properti
**Default:** compare each variant against the Phase A lock; palette, type voice, or rhetoric drift means it crossed into departure by accident: rework. Then confirm three different primary axes; three "tighter density" variants is failure. **Departure:** two passes, family before sentence. Family pass (non-negotiable): label each variant with a concrete family of your own choosing; shared or interchangeable labels mean rework. Sentence pass: three one-line descriptions side by side; two that rhyme mean rework. When the primary axis is color or theme, the trio must not share theme + dominant hue: three color worlds, not three shades.
-**Action-specific invocations** must vary along the action's dimension:
+**Action-specific invocations** must vary along the action's dimension; in default mode every variation stays within the available faces and existing tokens:
- `bolder`: amplify a different dimension per variant (scale / saturation / structural change).
- `quieter`: pull back a different dimension (color / ornament / spacing).
- `distill`: remove a different class of excess (visual noise / redundant content / nested structure).
- `polish`: a different refinement axis (rhythm / hierarchy / micro-details).
-- `typeset`: different pairing AND different scale ratio each.
-- `colorize`: different hue family each; vary chroma and contrast strategy.
+- `typeset`: departure varies the pairing AND the scale ratio each; default keeps the faces and varies scale ratio, case, and weight each.
+- `colorize`: departure gives each a different hue family and varies chroma and contrast strategy; default gives each a different existing palette role carrying the surface (Restrained / Committed / Full palette / Drenched) and a different contrast strategy.
- `layout`: different structural arrangement, not spacing tweaks.
- `adapt`: different target context per variant (mobile-first / tablet / desktop / print or low-data).
- `animate`: different motion vocabulary (cascade stagger / clip wipe / scale-and-focus / morph / parallax).
diff --git a/.pi/skills/impeccable/reference/optimize.md b/.pi/skills/impeccable/reference/optimize.md
index 5c55a1642..3f3fc7c33 100644
--- a/.pi/skills/impeccable/reference/optimize.md
+++ b/.pi/skills/impeccable/reference/optimize.md
@@ -38,7 +38,6 @@ Create systematic improvement plan:
src="hero.webp"
srcset="hero-400.webp 400w, hero-800.webp 800w, hero-1200.webp 1200w"
sizes="(max-width: 400px) 400px, (max-width: 800px) 800px, 1200px"
- loading="lazy"
alt="Hero image"
/>
```
diff --git a/.pi/skills/impeccable/reference/visualize.md b/.pi/skills/impeccable/reference/visualize.md
index 3ea79ead8..87652358b 100644
--- a/.pi/skills/impeccable/reference/visualize.md
+++ b/.pi/skills/impeccable/reference/visualize.md
@@ -26,7 +26,7 @@ Each comp is a direction test, not a screenshot specification. Core UI text, res
Show the three together on the decision page (`impeccable serve-question`, one option per comp with the comp as its hero), or in the harness only when it renders images inline; a text-only surface does not count as display. Ask what should carry forward, what feels false to the world, and whether the selected concept should be approved, combined, revised, or rejected. Then stop and wait. A structured simulated user counts as attended and receives the same question.
-Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md, and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
+Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md (the chosen direction on a new world), and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
This approval point has no substitute and no skip condition. When the structured question tool errors, fall back to the decision page; only after both fail may you treat the choice as delegated, and a delegated pick is recorded exactly as an approval is and disclosed in your first reply, not your last. The finish reviewer treats comp-round comps with no recorded approval as a material finding; decision comps under `.impeccable/mocks/decision/` are the direction round's hand, not comp-round output, and imply no approval on their own.
diff --git a/.pi/skills/impeccable/scripts/command-metadata.json b/.pi/skills/impeccable/scripts/command-metadata.json
index 89891ea4d..4686bb6de 100644
--- a/.pi/skills/impeccable/scripts/command-metadata.json
+++ b/.pi/skills/impeccable/scripts/command-metadata.json
@@ -4,7 +4,7 @@
"argumentHint": "[feature description]"
},
"init": {
- "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); offers DESIGN.md (visual: colors, typography, components) when code exists; pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
+ "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
"argumentHint": ""
},
"document": {
@@ -88,7 +88,7 @@
"argumentHint": "[target]"
},
"shape": {
- "description": "Plan UX and UI before code. Runs a required multi-round discovery interview, uses visual probes when available, and produces a user-confirmed design brief for implementation.",
+ "description": "Plan UX and UI before code. Runs a discovery interview (one round by default), uses visual probes when available, and produces a user-confirmed design brief for implementation.",
"argumentHint": "[feature to shape]"
},
"typeset": {
diff --git a/.pi/skills/impeccable/scripts/live-browser.js b/.pi/skills/impeccable/scripts/live-browser.js
index 504e75b9c..a63f1abe2 100644
--- a/.pi/skills/impeccable/scripts/live-browser.js
+++ b/.pi/skills/impeccable/scripts/live-browser.js
@@ -3271,6 +3271,14 @@
const P = paramsPanelPalette || barPaletteForTheme(detectPageTheme());
paramsPanelBody.innerHTML = '';
for (const p of params) {
+ // A knob the panel shows must be in the live values and on the variant,
+ // or accept drops it and the preview ignores it. Seed only missing keys
+ // so a reopen keeps edits.
+ if (!Object.hasOwn(paramsCurrentValues, p.id)) {
+ paramsCurrentValues[p.id] = p.default;
+ applyParamValue(variantEl, p, p.default);
+ }
+ const value = paramsCurrentValues[p.id];
const row = el('div', { display: 'flex', flexDirection: 'column', gap: '6px' });
const labelRow = el('div', {
display: 'flex', justifyContent: 'space-between',
@@ -3295,7 +3303,7 @@
input.min = String(p.min != null ? p.min : 0);
input.max = String(p.max != null ? p.max : 1);
input.step = String(p.step != null ? p.step : 0.05);
- input.value = String(p.default);
+ input.value = String(value);
Object.assign(input.style, {
width: '100%', accentColor: C.brand, cursor: 'pointer',
});
@@ -3310,7 +3318,7 @@
});
row.appendChild(input);
} else if (p.kind === 'toggle') {
- const initial = !!p.default;
+ const initial = !!value;
readout.textContent = initial ? 'On' : 'Off';
const track = el('button', {
position: 'relative', width: '36px', height: '20px',
@@ -3344,8 +3352,8 @@
const opts = (p.options || []).map(o =>
typeof o === 'string' ? { value: o, label: o } : o
);
- const activeOpt = opts.find(o => o.value === p.default) || opts[0];
- readout.textContent = activeOpt ? activeOpt.label : String(p.default);
+ const activeOpt = opts.find(o => o.value === value) || opts[0];
+ readout.textContent = activeOpt ? activeOpt.label : String(value);
const segRow = el('div', {
display: 'grid',
gridTemplateColumns: 'repeat(' + opts.length + ', 1fr)',
@@ -3354,7 +3362,7 @@
});
const segBtns = [];
opts.forEach(o => {
- const active = o.value === p.default;
+ const active = o.value === value;
const b = el('button', {
padding: '5px 4px', border: 'none', borderRadius: '3px',
background: active ? C.brand : 'transparent',
@@ -4988,8 +4996,8 @@
const variantEl = getVisibleVariantEl();
const params = parseVariantParams(variantEl);
if (!variantEl || params.length === 0) return;
- // Build fresh to ensure the current variant's controls are shown.
- applyParamDefaults(variantEl, params);
+ // Rebuild the controls from the current values. Defaults are applied
+ // when the variant is initialized, not when its Tune panel is reopened.
buildParamsPanel(variantEl, params);
tuneOpen = true;
showParamsPanel();
diff --git a/.qoder/skills/impeccable/reference/android.md b/.qoder/skills/impeccable/reference/android.md
index 1f67a6bb5..32a5cf7cc 100644
--- a/.qoder/skills/impeccable/reference/android.md
+++ b/.qoder/skills/impeccable/reference/android.md
@@ -42,5 +42,5 @@ Would a fluent Android user trust this app, or trip on off-spec components? The
## Verifying the build
- **Screenshots come from the emulator or a connected device, never a browser.** Build and install, then capture with `adb exec-out screencap -p > <path>` (pick a device with `adb -s <serial>` when several are attached). Capture every device class the app ships to, at least one phone and, when tablets are a target, one tablet, and write the files where the review flow expects them.
-- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (restore `1.0` after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
+- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (read both settings first with `adb shell cmd uimode night` and `adb shell settings get system font_scale`, and restore them after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
- **Emulators give breadth; gestures, refresh rates, and performance need hardware.** Say which one produced the evidence.
diff --git a/.qoder/skills/impeccable/reference/audit.md b/.qoder/skills/impeccable/reference/audit.md
index 8f31ef357..760882c19 100644
--- a/.qoder/skills/impeccable/reference/audit.md
+++ b/.qoder/skills/impeccable/reference/audit.md
@@ -11,7 +11,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
### 1. Accessibility (A11y)
**Check for**:
-- **Contrast issues**: Text contrast ratios < 4.5:1 (or 7:1 for AAA)
+- **Contrast issues**: Text contrast ratios < 4.5:1, or < 3:1 for large text (or 7:1 for AAA)
- **Motion sensitivity**: `prefers-reduced-motion` needs an intentional alternative that preserves state change and hierarchy; flag a global `0.01ms` kill that destroys useful feedback, flashing above threshold, and motion that blocks focus, reading, or task completion
- **Missing ARIA**: Interactive elements without proper roles, labels, or states
- **Keyboard navigation**: Missing focus indicators, illogical tab order, keyboard traps
@@ -47,7 +47,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
**Check for**:
- **Fixed widths**: Hard-coded widths that break on mobile
-- **Touch targets**: Interactive elements < 44x44px
+- **Touch targets**: Interactive elements < 44x44px. WCAG AA (SC 2.5.8) requires at least 24x24 CSS px unless an exception applies: spacing, an equivalent control, inline text, user-agent styling, or an essential size. Spacing passes when a 24 CSS px circle centered on the target's bounding box overlaps no other target and no other undersized target's circle
- **Broken touch interaction**: Custom sliders, drag surfaces, and scrollable control strips whose primary gesture fails under touch, that swallow page scroll or lose the drag to it, or that stay stuck after an interrupted gesture. Code tells: mouse-only handlers, no `touch-action` on a pointer-event drag surface, drag state that nothing clears on cancel, lost capture, or blur. Exercise the gesture when a browser tool can synthesize touch (a rendered viewport proves layout, not the gesture), then say what produced the evidence (emulated viewport, synthesized touch, which engine, physical device) and what stayed untested
- **Horizontal scroll**: Content overflow on narrow viewports
- **Text scaling**: Layouts that break when text size increases
diff --git a/.qoder/skills/impeccable/reference/distill.md b/.qoder/skills/impeccable/reference/distill.md
index 757630fae..a49697136 100644
--- a/.qoder/skills/impeccable/reference/distill.md
+++ b/.qoder/skills/impeccable/reference/distill.md
@@ -41,7 +41,7 @@ Expect to say no to good ideas to make room for great execution.
Systematically remove complexity across these dimensions:
### Information Architecture
-- **Reduce scope**: Remove secondary actions, optional features, redundant information
+- **Reduce scope**: Remove secondary actions, redundant information
- **Progressive disclosure**: Hide complexity behind clear entry points (accordions, modals, step-through flows)
- **Combine related actions**: Merge similar buttons, consolidate forms, group related content
- **Clear hierarchy**: ONE primary action, few secondary actions, everything else tertiary or hidden
@@ -70,11 +70,11 @@ Systematically remove complexity across these dimensions:
- **Clear next action**: ONE obvious next action, not five competing ones
### Content Simplification
-- **Shorter copy**: Cut every sentence in half, then do it again
+- **Shorter copy**: Cut filler, not meaning
- **Active voice**: "Save changes" not "Changes will be saved"
- **Remove jargon**: Plain language always wins
- **Scannable structure**: Short paragraphs, bullet points, clear headings
-- **Essential information only**: Remove marketing fluff, legalese, hedging
+- **Essential information only**: Remove marketing fluff, hedging
- **Remove redundant copy**: No headers restating intros, no repeated explanations, say it once
### Code Simplification
diff --git a/.qoder/skills/impeccable/reference/doctor.md b/.qoder/skills/impeccable/reference/doctor.md
index f1250a2e4..e2817b98d 100644
--- a/.qoder/skills/impeccable/reference/doctor.md
+++ b/.qoder/skills/impeccable/reference/doctor.md
@@ -6,7 +6,7 @@ This is maintenance, not design. Do not redesign anything, do not open files out
Three kinds of drift travel under "out of date". Keep them apart:
-- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it. Not this command's job.
+- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it, or the harness's plugin manager for a plugin install. Not this command's job.
- **Schema drift.** An artifact was written by an older Impeccable: fields nothing reads, fields now expected, files in retired locations. Mechanical, and this command repairs most of it.
- **Truth drift.** The code moved on and the document no longer describes it. No file comparison settles this. `document` owns DESIGN.md, `init` owns PRODUCT.md, and this command's job is to hand them a specific gap rather than a vague suspicion.
diff --git a/.qoder/skills/impeccable/reference/document.md b/.qoder/skills/impeccable/reference/document.md
index 9da0bc743..ec75b7cc7 100644
--- a/.qoder/skills/impeccable/reference/document.md
+++ b/.qoder/skills/impeccable/reference/document.md
@@ -17,10 +17,10 @@ colors:
typography:
display:
fontFamily: "Cormorant Garamond, Georgia, serif"
- fontSize: "clamp(2.5rem, 7vw, 4.5rem)"
+ fontSize: "4.5rem"
fontWeight: 300
lineHeight: 1
- letterSpacing: "normal"
+ letterSpacing: "0em"
body:
# ...
rounded:
@@ -325,7 +325,7 @@ If the project has **no component library yet** (bare landing page, new project)
#### Tonal ramps
-For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue and chroma, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
+For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue, chroma reduced near white and black, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
#### Narrative mapping
diff --git a/.qoder/skills/impeccable/reference/live.md b/.qoder/skills/impeccable/reference/live.md
index 1251f1ea9..547c1ee4c 100644
--- a/.qoder/skills/impeccable/reference/live.md
+++ b/.qoder/skills/impeccable/reference/live.md
@@ -158,14 +158,14 @@ Sources in priority order: DESIGN.md's visual system fields; CSS custom properti
**Default:** compare each variant against the Phase A lock; palette, type voice, or rhetoric drift means it crossed into departure by accident: rework. Then confirm three different primary axes; three "tighter density" variants is failure. **Departure:** two passes, family before sentence. Family pass (non-negotiable): label each variant with a concrete family of your own choosing; shared or interchangeable labels mean rework. Sentence pass: three one-line descriptions side by side; two that rhyme mean rework. When the primary axis is color or theme, the trio must not share theme + dominant hue: three color worlds, not three shades.
-**Action-specific invocations** must vary along the action's dimension:
+**Action-specific invocations** must vary along the action's dimension; in default mode every variation stays within the available faces and existing tokens:
- `bolder`: amplify a different dimension per variant (scale / saturation / structural change).
- `quieter`: pull back a different dimension (color / ornament / spacing).
- `distill`: remove a different class of excess (visual noise / redundant content / nested structure).
- `polish`: a different refinement axis (rhythm / hierarchy / micro-details).
-- `typeset`: different pairing AND different scale ratio each.
-- `colorize`: different hue family each; vary chroma and contrast strategy.
+- `typeset`: departure varies the pairing AND the scale ratio each; default keeps the faces and varies scale ratio, case, and weight each.
+- `colorize`: departure gives each a different hue family and varies chroma and contrast strategy; default gives each a different existing palette role carrying the surface (Restrained / Committed / Full palette / Drenched) and a different contrast strategy.
- `layout`: different structural arrangement, not spacing tweaks.
- `adapt`: different target context per variant (mobile-first / tablet / desktop / print or low-data).
- `animate`: different motion vocabulary (cascade stagger / clip wipe / scale-and-focus / morph / parallax).
diff --git a/.qoder/skills/impeccable/reference/optimize.md b/.qoder/skills/impeccable/reference/optimize.md
index 5c55a1642..3f3fc7c33 100644
--- a/.qoder/skills/impeccable/reference/optimize.md
+++ b/.qoder/skills/impeccable/reference/optimize.md
@@ -38,7 +38,6 @@ Create systematic improvement plan:
src="hero.webp"
srcset="hero-400.webp 400w, hero-800.webp 800w, hero-1200.webp 1200w"
sizes="(max-width: 400px) 400px, (max-width: 800px) 800px, 1200px"
- loading="lazy"
alt="Hero image"
/>
```
diff --git a/.qoder/skills/impeccable/reference/visualize.md b/.qoder/skills/impeccable/reference/visualize.md
index fe04c4f70..b9d9fb1f3 100644
--- a/.qoder/skills/impeccable/reference/visualize.md
+++ b/.qoder/skills/impeccable/reference/visualize.md
@@ -26,7 +26,7 @@ Each comp is a direction test, not a screenshot specification. Core UI text, res
Show the three together on the decision page (`impeccable serve-question`, one option per comp with the comp as its hero), or in the harness only when it renders images inline; a text-only surface does not count as display. Ask what should carry forward, what feels false to the world, and whether the selected concept should be approved, combined, revised, or rejected. Then stop and wait. A structured simulated user counts as attended and receives the same question.
-Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md, and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
+Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md (the chosen direction on a new world), and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
This approval point has no substitute and no skip condition. When the structured question tool errors, fall back to the decision page; only after both fail may you treat the choice as delegated, and a delegated pick is recorded exactly as an approval is and disclosed in your first reply, not your last. The finish reviewer treats comp-round comps with no recorded approval as a material finding; decision comps under `.impeccable/mocks/decision/` are the direction round's hand, not comp-round output, and imply no approval on their own.
diff --git a/.qoder/skills/impeccable/scripts/command-metadata.json b/.qoder/skills/impeccable/scripts/command-metadata.json
index 89891ea4d..4686bb6de 100644
--- a/.qoder/skills/impeccable/scripts/command-metadata.json
+++ b/.qoder/skills/impeccable/scripts/command-metadata.json
@@ -4,7 +4,7 @@
"argumentHint": "[feature description]"
},
"init": {
- "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); offers DESIGN.md (visual: colors, typography, components) when code exists; pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
+ "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
"argumentHint": ""
},
"document": {
@@ -88,7 +88,7 @@
"argumentHint": "[target]"
},
"shape": {
- "description": "Plan UX and UI before code. Runs a required multi-round discovery interview, uses visual probes when available, and produces a user-confirmed design brief for implementation.",
+ "description": "Plan UX and UI before code. Runs a discovery interview (one round by default), uses visual probes when available, and produces a user-confirmed design brief for implementation.",
"argumentHint": "[feature to shape]"
},
"typeset": {
diff --git a/.qoder/skills/impeccable/scripts/live-browser.js b/.qoder/skills/impeccable/scripts/live-browser.js
index 504e75b9c..a63f1abe2 100644
--- a/.qoder/skills/impeccable/scripts/live-browser.js
+++ b/.qoder/skills/impeccable/scripts/live-browser.js
@@ -3271,6 +3271,14 @@
const P = paramsPanelPalette || barPaletteForTheme(detectPageTheme());
paramsPanelBody.innerHTML = '';
for (const p of params) {
+ // A knob the panel shows must be in the live values and on the variant,
+ // or accept drops it and the preview ignores it. Seed only missing keys
+ // so a reopen keeps edits.
+ if (!Object.hasOwn(paramsCurrentValues, p.id)) {
+ paramsCurrentValues[p.id] = p.default;
+ applyParamValue(variantEl, p, p.default);
+ }
+ const value = paramsCurrentValues[p.id];
const row = el('div', { display: 'flex', flexDirection: 'column', gap: '6px' });
const labelRow = el('div', {
display: 'flex', justifyContent: 'space-between',
@@ -3295,7 +3303,7 @@
input.min = String(p.min != null ? p.min : 0);
input.max = String(p.max != null ? p.max : 1);
input.step = String(p.step != null ? p.step : 0.05);
- input.value = String(p.default);
+ input.value = String(value);
Object.assign(input.style, {
width: '100%', accentColor: C.brand, cursor: 'pointer',
});
@@ -3310,7 +3318,7 @@
});
row.appendChild(input);
} else if (p.kind === 'toggle') {
- const initial = !!p.default;
+ const initial = !!value;
readout.textContent = initial ? 'On' : 'Off';
const track = el('button', {
position: 'relative', width: '36px', height: '20px',
@@ -3344,8 +3352,8 @@
const opts = (p.options || []).map(o =>
typeof o === 'string' ? { value: o, label: o } : o
);
- const activeOpt = opts.find(o => o.value === p.default) || opts[0];
- readout.textContent = activeOpt ? activeOpt.label : String(p.default);
+ const activeOpt = opts.find(o => o.value === value) || opts[0];
+ readout.textContent = activeOpt ? activeOpt.label : String(value);
const segRow = el('div', {
display: 'grid',
gridTemplateColumns: 'repeat(' + opts.length + ', 1fr)',
@@ -3354,7 +3362,7 @@
});
const segBtns = [];
opts.forEach(o => {
- const active = o.value === p.default;
+ const active = o.value === value;
const b = el('button', {
padding: '5px 4px', border: 'none', borderRadius: '3px',
background: active ? C.brand : 'transparent',
@@ -4988,8 +4996,8 @@
const variantEl = getVisibleVariantEl();
const params = parseVariantParams(variantEl);
if (!variantEl || params.length === 0) return;
- // Build fresh to ensure the current variant's controls are shown.
- applyParamDefaults(variantEl, params);
+ // Rebuild the controls from the current values. Defaults are applied
+ // when the variant is initialized, not when its Tune panel is reopened.
buildParamsPanel(variantEl, params);
tuneOpen = true;
showParamsPanel();
diff --git a/.rovodev/skills/impeccable/reference/android.md b/.rovodev/skills/impeccable/reference/android.md
index 1f67a6bb5..32a5cf7cc 100644
--- a/.rovodev/skills/impeccable/reference/android.md
+++ b/.rovodev/skills/impeccable/reference/android.md
@@ -42,5 +42,5 @@ Would a fluent Android user trust this app, or trip on off-spec components? The
## Verifying the build
- **Screenshots come from the emulator or a connected device, never a browser.** Build and install, then capture with `adb exec-out screencap -p > <path>` (pick a device with `adb -s <serial>` when several are attached). Capture every device class the app ships to, at least one phone and, when tablets are a target, one tablet, and write the files where the review flow expects them.
-- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (restore `1.0` after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
+- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (read both settings first with `adb shell cmd uimode night` and `adb shell settings get system font_scale`, and restore them after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
- **Emulators give breadth; gestures, refresh rates, and performance need hardware.** Say which one produced the evidence.
diff --git a/.rovodev/skills/impeccable/reference/audit.md b/.rovodev/skills/impeccable/reference/audit.md
index 720dd75fa..736f0a682 100644
--- a/.rovodev/skills/impeccable/reference/audit.md
+++ b/.rovodev/skills/impeccable/reference/audit.md
@@ -11,7 +11,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
### 1. Accessibility (A11y)
**Check for**:
-- **Contrast issues**: Text contrast ratios < 4.5:1 (or 7:1 for AAA)
+- **Contrast issues**: Text contrast ratios < 4.5:1, or < 3:1 for large text (or 7:1 for AAA)
- **Motion sensitivity**: `prefers-reduced-motion` needs an intentional alternative that preserves state change and hierarchy; flag a global `0.01ms` kill that destroys useful feedback, flashing above threshold, and motion that blocks focus, reading, or task completion
- **Missing ARIA**: Interactive elements without proper roles, labels, or states
- **Keyboard navigation**: Missing focus indicators, illogical tab order, keyboard traps
@@ -47,7 +47,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
**Check for**:
- **Fixed widths**: Hard-coded widths that break on mobile
-- **Touch targets**: Interactive elements < 44x44px
+- **Touch targets**: Interactive elements < 44x44px. WCAG AA (SC 2.5.8) requires at least 24x24 CSS px unless an exception applies: spacing, an equivalent control, inline text, user-agent styling, or an essential size. Spacing passes when a 24 CSS px circle centered on the target's bounding box overlaps no other target and no other undersized target's circle
- **Broken touch interaction**: Custom sliders, drag surfaces, and scrollable control strips whose primary gesture fails under touch, that swallow page scroll or lose the drag to it, or that stay stuck after an interrupted gesture. Code tells: mouse-only handlers, no `touch-action` on a pointer-event drag surface, drag state that nothing clears on cancel, lost capture, or blur. Exercise the gesture when a browser tool can synthesize touch (a rendered viewport proves layout, not the gesture), then say what produced the evidence (emulated viewport, synthesized touch, which engine, physical device) and what stayed untested
- **Horizontal scroll**: Content overflow on narrow viewports
- **Text scaling**: Layouts that break when text size increases
diff --git a/.rovodev/skills/impeccable/reference/distill.md b/.rovodev/skills/impeccable/reference/distill.md
index 757630fae..a49697136 100644
--- a/.rovodev/skills/impeccable/reference/distill.md
+++ b/.rovodev/skills/impeccable/reference/distill.md
@@ -41,7 +41,7 @@ Expect to say no to good ideas to make room for great execution.
Systematically remove complexity across these dimensions:
### Information Architecture
-- **Reduce scope**: Remove secondary actions, optional features, redundant information
+- **Reduce scope**: Remove secondary actions, redundant information
- **Progressive disclosure**: Hide complexity behind clear entry points (accordions, modals, step-through flows)
- **Combine related actions**: Merge similar buttons, consolidate forms, group related content
- **Clear hierarchy**: ONE primary action, few secondary actions, everything else tertiary or hidden
@@ -70,11 +70,11 @@ Systematically remove complexity across these dimensions:
- **Clear next action**: ONE obvious next action, not five competing ones
### Content Simplification
-- **Shorter copy**: Cut every sentence in half, then do it again
+- **Shorter copy**: Cut filler, not meaning
- **Active voice**: "Save changes" not "Changes will be saved"
- **Remove jargon**: Plain language always wins
- **Scannable structure**: Short paragraphs, bullet points, clear headings
-- **Essential information only**: Remove marketing fluff, legalese, hedging
+- **Essential information only**: Remove marketing fluff, hedging
- **Remove redundant copy**: No headers restating intros, no repeated explanations, say it once
### Code Simplification
diff --git a/.rovodev/skills/impeccable/reference/doctor.md b/.rovodev/skills/impeccable/reference/doctor.md
index 7bf959566..2f6ba4527 100644
--- a/.rovodev/skills/impeccable/reference/doctor.md
+++ b/.rovodev/skills/impeccable/reference/doctor.md
@@ -6,7 +6,7 @@ This is maintenance, not design. Do not redesign anything, do not open files out
Three kinds of drift travel under "out of date". Keep them apart:
-- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it. Not this command's job.
+- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it, or the harness's plugin manager for a plugin install. Not this command's job.
- **Schema drift.** An artifact was written by an older Impeccable: fields nothing reads, fields now expected, files in retired locations. Mechanical, and this command repairs most of it.
- **Truth drift.** The code moved on and the document no longer describes it. No file comparison settles this. `document` owns DESIGN.md, `init` owns PRODUCT.md, and this command's job is to hand them a specific gap rather than a vague suspicion.
diff --git a/.rovodev/skills/impeccable/reference/document.md b/.rovodev/skills/impeccable/reference/document.md
index 9da0bc743..ec75b7cc7 100644
--- a/.rovodev/skills/impeccable/reference/document.md
+++ b/.rovodev/skills/impeccable/reference/document.md
@@ -17,10 +17,10 @@ colors:
typography:
display:
fontFamily: "Cormorant Garamond, Georgia, serif"
- fontSize: "clamp(2.5rem, 7vw, 4.5rem)"
+ fontSize: "4.5rem"
fontWeight: 300
lineHeight: 1
- letterSpacing: "normal"
+ letterSpacing: "0em"
body:
# ...
rounded:
@@ -325,7 +325,7 @@ If the project has **no component library yet** (bare landing page, new project)
#### Tonal ramps
-For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue and chroma, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
+For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue, chroma reduced near white and black, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
#### Narrative mapping
diff --git a/.rovodev/skills/impeccable/reference/live.md b/.rovodev/skills/impeccable/reference/live.md
index 7a372e443..7e508437e 100644
--- a/.rovodev/skills/impeccable/reference/live.md
+++ b/.rovodev/skills/impeccable/reference/live.md
@@ -158,14 +158,14 @@ Sources in priority order: DESIGN.md's visual system fields; CSS custom properti
**Default:** compare each variant against the Phase A lock; palette, type voice, or rhetoric drift means it crossed into departure by accident: rework. Then confirm three different primary axes; three "tighter density" variants is failure. **Departure:** two passes, family before sentence. Family pass (non-negotiable): label each variant with a concrete family of your own choosing; shared or interchangeable labels mean rework. Sentence pass: three one-line descriptions side by side; two that rhyme mean rework. When the primary axis is color or theme, the trio must not share theme + dominant hue: three color worlds, not three shades.
-**Action-specific invocations** must vary along the action's dimension:
+**Action-specific invocations** must vary along the action's dimension; in default mode every variation stays within the available faces and existing tokens:
- `bolder`: amplify a different dimension per variant (scale / saturation / structural change).
- `quieter`: pull back a different dimension (color / ornament / spacing).
- `distill`: remove a different class of excess (visual noise / redundant content / nested structure).
- `polish`: a different refinement axis (rhythm / hierarchy / micro-details).
-- `typeset`: different pairing AND different scale ratio each.
-- `colorize`: different hue family each; vary chroma and contrast strategy.
+- `typeset`: departure varies the pairing AND the scale ratio each; default keeps the faces and varies scale ratio, case, and weight each.
+- `colorize`: departure gives each a different hue family and varies chroma and contrast strategy; default gives each a different existing palette role carrying the surface (Restrained / Committed / Full palette / Drenched) and a different contrast strategy.
- `layout`: different structural arrangement, not spacing tweaks.
- `adapt`: different target context per variant (mobile-first / tablet / desktop / print or low-data).
- `animate`: different motion vocabulary (cascade stagger / clip wipe / scale-and-focus / morph / parallax).
diff --git a/.rovodev/skills/impeccable/reference/optimize.md b/.rovodev/skills/impeccable/reference/optimize.md
index 5c55a1642..3f3fc7c33 100644
--- a/.rovodev/skills/impeccable/reference/optimize.md
+++ b/.rovodev/skills/impeccable/reference/optimize.md
@@ -38,7 +38,6 @@ Create systematic improvement plan:
src="hero.webp"
srcset="hero-400.webp 400w, hero-800.webp 800w, hero-1200.webp 1200w"
sizes="(max-width: 400px) 400px, (max-width: 800px) 800px, 1200px"
- loading="lazy"
alt="Hero image"
/>
```
diff --git a/.rovodev/skills/impeccable/reference/visualize.md b/.rovodev/skills/impeccable/reference/visualize.md
index e04ff7d6f..e19d7f2f6 100644
--- a/.rovodev/skills/impeccable/reference/visualize.md
+++ b/.rovodev/skills/impeccable/reference/visualize.md
@@ -26,7 +26,7 @@ Each comp is a direction test, not a screenshot specification. Core UI text, res
Show the three together on the decision page (`impeccable serve-question`, one option per comp with the comp as its hero), or in the harness only when it renders images inline; a text-only surface does not count as display. Ask what should carry forward, what feels false to the world, and whether the selected concept should be approved, combined, revised, or rejected. Then stop and wait. A structured simulated user counts as attended and receives the same question.
-Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md, and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
+Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md (the chosen direction on a new world), and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
This approval point has no substitute and no skip condition. When the structured question tool errors, fall back to the decision page; only after both fail may you treat the choice as delegated, and a delegated pick is recorded exactly as an approval is and disclosed in your first reply, not your last. The finish reviewer treats comp-round comps with no recorded approval as a material finding; decision comps under `.impeccable/mocks/decision/` are the direction round's hand, not comp-round output, and imply no approval on their own.
diff --git a/.rovodev/skills/impeccable/scripts/command-metadata.json b/.rovodev/skills/impeccable/scripts/command-metadata.json
index 89891ea4d..4686bb6de 100644
--- a/.rovodev/skills/impeccable/scripts/command-metadata.json
+++ b/.rovodev/skills/impeccable/scripts/command-metadata.json
@@ -4,7 +4,7 @@
"argumentHint": "[feature description]"
},
"init": {
- "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); offers DESIGN.md (visual: colors, typography, components) when code exists; pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
+ "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
"argumentHint": ""
},
"document": {
@@ -88,7 +88,7 @@
"argumentHint": "[target]"
},
"shape": {
- "description": "Plan UX and UI before code. Runs a required multi-round discovery interview, uses visual probes when available, and produces a user-confirmed design brief for implementation.",
+ "description": "Plan UX and UI before code. Runs a discovery interview (one round by default), uses visual probes when available, and produces a user-confirmed design brief for implementation.",
"argumentHint": "[feature to shape]"
},
"typeset": {
diff --git a/.rovodev/skills/impeccable/scripts/live-browser.js b/.rovodev/skills/impeccable/scripts/live-browser.js
index 504e75b9c..a63f1abe2 100644
--- a/.rovodev/skills/impeccable/scripts/live-browser.js
+++ b/.rovodev/skills/impeccable/scripts/live-browser.js
@@ -3271,6 +3271,14 @@
const P = paramsPanelPalette || barPaletteForTheme(detectPageTheme());
paramsPanelBody.innerHTML = '';
for (const p of params) {
+ // A knob the panel shows must be in the live values and on the variant,
+ // or accept drops it and the preview ignores it. Seed only missing keys
+ // so a reopen keeps edits.
+ if (!Object.hasOwn(paramsCurrentValues, p.id)) {
+ paramsCurrentValues[p.id] = p.default;
+ applyParamValue(variantEl, p, p.default);
+ }
+ const value = paramsCurrentValues[p.id];
const row = el('div', { display: 'flex', flexDirection: 'column', gap: '6px' });
const labelRow = el('div', {
display: 'flex', justifyContent: 'space-between',
@@ -3295,7 +3303,7 @@
input.min = String(p.min != null ? p.min : 0);
input.max = String(p.max != null ? p.max : 1);
input.step = String(p.step != null ? p.step : 0.05);
- input.value = String(p.default);
+ input.value = String(value);
Object.assign(input.style, {
width: '100%', accentColor: C.brand, cursor: 'pointer',
});
@@ -3310,7 +3318,7 @@
});
row.appendChild(input);
} else if (p.kind === 'toggle') {
- const initial = !!p.default;
+ const initial = !!value;
readout.textContent = initial ? 'On' : 'Off';
const track = el('button', {
position: 'relative', width: '36px', height: '20px',
@@ -3344,8 +3352,8 @@
const opts = (p.options || []).map(o =>
typeof o === 'string' ? { value: o, label: o } : o
);
- const activeOpt = opts.find(o => o.value === p.default) || opts[0];
- readout.textContent = activeOpt ? activeOpt.label : String(p.default);
+ const activeOpt = opts.find(o => o.value === value) || opts[0];
+ readout.textContent = activeOpt ? activeOpt.label : String(value);
const segRow = el('div', {
display: 'grid',
gridTemplateColumns: 'repeat(' + opts.length + ', 1fr)',
@@ -3354,7 +3362,7 @@
});
const segBtns = [];
opts.forEach(o => {
- const active = o.value === p.default;
+ const active = o.value === value;
const b = el('button', {
padding: '5px 4px', border: 'none', borderRadius: '3px',
background: active ? C.brand : 'transparent',
@@ -4988,8 +4996,8 @@
const variantEl = getVisibleVariantEl();
const params = parseVariantParams(variantEl);
if (!variantEl || params.length === 0) return;
- // Build fresh to ensure the current variant's controls are shown.
- applyParamDefaults(variantEl, params);
+ // Rebuild the controls from the current values. Defaults are applied
+ // when the variant is initialized, not when its Tune panel is reopened.
buildParamsPanel(variantEl, params);
tuneOpen = true;
showParamsPanel();
diff --git a/.trae-cn/skills/impeccable/reference/android.md b/.trae-cn/skills/impeccable/reference/android.md
index 1f67a6bb5..32a5cf7cc 100644
--- a/.trae-cn/skills/impeccable/reference/android.md
+++ b/.trae-cn/skills/impeccable/reference/android.md
@@ -42,5 +42,5 @@ Would a fluent Android user trust this app, or trip on off-spec components? The
## Verifying the build
- **Screenshots come from the emulator or a connected device, never a browser.** Build and install, then capture with `adb exec-out screencap -p > <path>` (pick a device with `adb -s <serial>` when several are attached). Capture every device class the app ships to, at least one phone and, when tablets are a target, one tablet, and write the files where the review flow expects them.
-- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (restore `1.0` after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
+- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (read both settings first with `adb shell cmd uimode night` and `adb shell settings get system font_scale`, and restore them after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
- **Emulators give breadth; gestures, refresh rates, and performance need hardware.** Say which one produced the evidence.
diff --git a/.trae-cn/skills/impeccable/reference/audit.md b/.trae-cn/skills/impeccable/reference/audit.md
index c617e5637..7e4e19f1c 100644
--- a/.trae-cn/skills/impeccable/reference/audit.md
+++ b/.trae-cn/skills/impeccable/reference/audit.md
@@ -11,7 +11,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
### 1. Accessibility (A11y)
**Check for**:
-- **Contrast issues**: Text contrast ratios < 4.5:1 (or 7:1 for AAA)
+- **Contrast issues**: Text contrast ratios < 4.5:1, or < 3:1 for large text (or 7:1 for AAA)
- **Motion sensitivity**: `prefers-reduced-motion` needs an intentional alternative that preserves state change and hierarchy; flag a global `0.01ms` kill that destroys useful feedback, flashing above threshold, and motion that blocks focus, reading, or task completion
- **Missing ARIA**: Interactive elements without proper roles, labels, or states
- **Keyboard navigation**: Missing focus indicators, illogical tab order, keyboard traps
@@ -47,7 +47,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
**Check for**:
- **Fixed widths**: Hard-coded widths that break on mobile
-- **Touch targets**: Interactive elements < 44x44px
+- **Touch targets**: Interactive elements < 44x44px. WCAG AA (SC 2.5.8) requires at least 24x24 CSS px unless an exception applies: spacing, an equivalent control, inline text, user-agent styling, or an essential size. Spacing passes when a 24 CSS px circle centered on the target's bounding box overlaps no other target and no other undersized target's circle
- **Broken touch interaction**: Custom sliders, drag surfaces, and scrollable control strips whose primary gesture fails under touch, that swallow page scroll or lose the drag to it, or that stay stuck after an interrupted gesture. Code tells: mouse-only handlers, no `touch-action` on a pointer-event drag surface, drag state that nothing clears on cancel, lost capture, or blur. Exercise the gesture when a browser tool can synthesize touch (a rendered viewport proves layout, not the gesture), then say what produced the evidence (emulated viewport, synthesized touch, which engine, physical device) and what stayed untested
- **Horizontal scroll**: Content overflow on narrow viewports
- **Text scaling**: Layouts that break when text size increases
diff --git a/.trae-cn/skills/impeccable/reference/distill.md b/.trae-cn/skills/impeccable/reference/distill.md
index 757630fae..a49697136 100644
--- a/.trae-cn/skills/impeccable/reference/distill.md
+++ b/.trae-cn/skills/impeccable/reference/distill.md
@@ -41,7 +41,7 @@ Expect to say no to good ideas to make room for great execution.
Systematically remove complexity across these dimensions:
### Information Architecture
-- **Reduce scope**: Remove secondary actions, optional features, redundant information
+- **Reduce scope**: Remove secondary actions, redundant information
- **Progressive disclosure**: Hide complexity behind clear entry points (accordions, modals, step-through flows)
- **Combine related actions**: Merge similar buttons, consolidate forms, group related content
- **Clear hierarchy**: ONE primary action, few secondary actions, everything else tertiary or hidden
@@ -70,11 +70,11 @@ Systematically remove complexity across these dimensions:
- **Clear next action**: ONE obvious next action, not five competing ones
### Content Simplification
-- **Shorter copy**: Cut every sentence in half, then do it again
+- **Shorter copy**: Cut filler, not meaning
- **Active voice**: "Save changes" not "Changes will be saved"
- **Remove jargon**: Plain language always wins
- **Scannable structure**: Short paragraphs, bullet points, clear headings
-- **Essential information only**: Remove marketing fluff, legalese, hedging
+- **Essential information only**: Remove marketing fluff, hedging
- **Remove redundant copy**: No headers restating intros, no repeated explanations, say it once
### Code Simplification
diff --git a/.trae-cn/skills/impeccable/reference/doctor.md b/.trae-cn/skills/impeccable/reference/doctor.md
index b890d7088..21752af00 100644
--- a/.trae-cn/skills/impeccable/reference/doctor.md
+++ b/.trae-cn/skills/impeccable/reference/doctor.md
@@ -6,7 +6,7 @@ This is maintenance, not design. Do not redesign anything, do not open files out
Three kinds of drift travel under "out of date". Keep them apart:
-- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it. Not this command's job.
+- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it, or the harness's plugin manager for a plugin install. Not this command's job.
- **Schema drift.** An artifact was written by an older Impeccable: fields nothing reads, fields now expected, files in retired locations. Mechanical, and this command repairs most of it.
- **Truth drift.** The code moved on and the document no longer describes it. No file comparison settles this. `document` owns DESIGN.md, `init` owns PRODUCT.md, and this command's job is to hand them a specific gap rather than a vague suspicion.
diff --git a/.trae-cn/skills/impeccable/reference/document.md b/.trae-cn/skills/impeccable/reference/document.md
index 9da0bc743..ec75b7cc7 100644
--- a/.trae-cn/skills/impeccable/reference/document.md
+++ b/.trae-cn/skills/impeccable/reference/document.md
@@ -17,10 +17,10 @@ colors:
typography:
display:
fontFamily: "Cormorant Garamond, Georgia, serif"
- fontSize: "clamp(2.5rem, 7vw, 4.5rem)"
+ fontSize: "4.5rem"
fontWeight: 300
lineHeight: 1
- letterSpacing: "normal"
+ letterSpacing: "0em"
body:
# ...
rounded:
@@ -325,7 +325,7 @@ If the project has **no component library yet** (bare landing page, new project)
#### Tonal ramps
-For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue and chroma, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
+For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue, chroma reduced near white and black, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
#### Narrative mapping
diff --git a/.trae-cn/skills/impeccable/reference/live.md b/.trae-cn/skills/impeccable/reference/live.md
index 785c494bf..891989a60 100644
--- a/.trae-cn/skills/impeccable/reference/live.md
+++ b/.trae-cn/skills/impeccable/reference/live.md
@@ -158,14 +158,14 @@ Sources in priority order: DESIGN.md's visual system fields; CSS custom properti
**Default:** compare each variant against the Phase A lock; palette, type voice, or rhetoric drift means it crossed into departure by accident: rework. Then confirm three different primary axes; three "tighter density" variants is failure. **Departure:** two passes, family before sentence. Family pass (non-negotiable): label each variant with a concrete family of your own choosing; shared or interchangeable labels mean rework. Sentence pass: three one-line descriptions side by side; two that rhyme mean rework. When the primary axis is color or theme, the trio must not share theme + dominant hue: three color worlds, not three shades.
-**Action-specific invocations** must vary along the action's dimension:
+**Action-specific invocations** must vary along the action's dimension; in default mode every variation stays within the available faces and existing tokens:
- `bolder`: amplify a different dimension per variant (scale / saturation / structural change).
- `quieter`: pull back a different dimension (color / ornament / spacing).
- `distill`: remove a different class of excess (visual noise / redundant content / nested structure).
- `polish`: a different refinement axis (rhythm / hierarchy / micro-details).
-- `typeset`: different pairing AND different scale ratio each.
-- `colorize`: different hue family each; vary chroma and contrast strategy.
+- `typeset`: departure varies the pairing AND the scale ratio each; default keeps the faces and varies scale ratio, case, and weight each.
+- `colorize`: departure gives each a different hue family and varies chroma and contrast strategy; default gives each a different existing palette role carrying the surface (Restrained / Committed / Full palette / Drenched) and a different contrast strategy.
- `layout`: different structural arrangement, not spacing tweaks.
- `adapt`: different target context per variant (mobile-first / tablet / desktop / print or low-data).
- `animate`: different motion vocabulary (cascade stagger / clip wipe / scale-and-focus / morph / parallax).
diff --git a/.trae-cn/skills/impeccable/reference/optimize.md b/.trae-cn/skills/impeccable/reference/optimize.md
index 5c55a1642..3f3fc7c33 100644
--- a/.trae-cn/skills/impeccable/reference/optimize.md
+++ b/.trae-cn/skills/impeccable/reference/optimize.md
@@ -38,7 +38,6 @@ Create systematic improvement plan:
src="hero.webp"
srcset="hero-400.webp 400w, hero-800.webp 800w, hero-1200.webp 1200w"
sizes="(max-width: 400px) 400px, (max-width: 800px) 800px, 1200px"
- loading="lazy"
alt="Hero image"
/>
```
diff --git a/.trae-cn/skills/impeccable/reference/visualize.md b/.trae-cn/skills/impeccable/reference/visualize.md
index 139989f1e..3b519a6ff 100644
--- a/.trae-cn/skills/impeccable/reference/visualize.md
+++ b/.trae-cn/skills/impeccable/reference/visualize.md
@@ -26,7 +26,7 @@ Each comp is a direction test, not a screenshot specification. Core UI text, res
Show the three together on the decision page (`impeccable serve-question`, one option per comp with the comp as its hero), or in the harness only when it renders images inline; a text-only surface does not count as display. Ask what should carry forward, what feels false to the world, and whether the selected concept should be approved, combined, revised, or rejected. Then stop and wait. A structured simulated user counts as attended and receives the same question.
-Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md, and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
+Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md (the chosen direction on a new world), and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
This approval point has no substitute and no skip condition. When the structured question tool errors, fall back to the decision page; only after both fail may you treat the choice as delegated, and a delegated pick is recorded exactly as an approval is and disclosed in your first reply, not your last. The finish reviewer treats comp-round comps with no recorded approval as a material finding; decision comps under `.impeccable/mocks/decision/` are the direction round's hand, not comp-round output, and imply no approval on their own.
diff --git a/.trae-cn/skills/impeccable/scripts/command-metadata.json b/.trae-cn/skills/impeccable/scripts/command-metadata.json
index 89891ea4d..4686bb6de 100644
--- a/.trae-cn/skills/impeccable/scripts/command-metadata.json
+++ b/.trae-cn/skills/impeccable/scripts/command-metadata.json
@@ -4,7 +4,7 @@
"argumentHint": "[feature description]"
},
"init": {
- "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); offers DESIGN.md (visual: colors, typography, components) when code exists; pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
+ "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
"argumentHint": ""
},
"document": {
@@ -88,7 +88,7 @@
"argumentHint": "[target]"
},
"shape": {
- "description": "Plan UX and UI before code. Runs a required multi-round discovery interview, uses visual probes when available, and produces a user-confirmed design brief for implementation.",
+ "description": "Plan UX and UI before code. Runs a discovery interview (one round by default), uses visual probes when available, and produces a user-confirmed design brief for implementation.",
"argumentHint": "[feature to shape]"
},
"typeset": {
diff --git a/.trae-cn/skills/impeccable/scripts/live-browser.js b/.trae-cn/skills/impeccable/scripts/live-browser.js
index 504e75b9c..a63f1abe2 100644
--- a/.trae-cn/skills/impeccable/scripts/live-browser.js
+++ b/.trae-cn/skills/impeccable/scripts/live-browser.js
@@ -3271,6 +3271,14 @@
const P = paramsPanelPalette || barPaletteForTheme(detectPageTheme());
paramsPanelBody.innerHTML = '';
for (const p of params) {
+ // A knob the panel shows must be in the live values and on the variant,
+ // or accept drops it and the preview ignores it. Seed only missing keys
+ // so a reopen keeps edits.
+ if (!Object.hasOwn(paramsCurrentValues, p.id)) {
+ paramsCurrentValues[p.id] = p.default;
+ applyParamValue(variantEl, p, p.default);
+ }
+ const value = paramsCurrentValues[p.id];
const row = el('div', { display: 'flex', flexDirection: 'column', gap: '6px' });
const labelRow = el('div', {
display: 'flex', justifyContent: 'space-between',
@@ -3295,7 +3303,7 @@
input.min = String(p.min != null ? p.min : 0);
input.max = String(p.max != null ? p.max : 1);
input.step = String(p.step != null ? p.step : 0.05);
- input.value = String(p.default);
+ input.value = String(value);
Object.assign(input.style, {
width: '100%', accentColor: C.brand, cursor: 'pointer',
});
@@ -3310,7 +3318,7 @@
});
row.appendChild(input);
} else if (p.kind === 'toggle') {
- const initial = !!p.default;
+ const initial = !!value;
readout.textContent = initial ? 'On' : 'Off';
const track = el('button', {
position: 'relative', width: '36px', height: '20px',
@@ -3344,8 +3352,8 @@
const opts = (p.options || []).map(o =>
typeof o === 'string' ? { value: o, label: o } : o
);
- const activeOpt = opts.find(o => o.value === p.default) || opts[0];
- readout.textContent = activeOpt ? activeOpt.label : String(p.default);
+ const activeOpt = opts.find(o => o.value === value) || opts[0];
+ readout.textContent = activeOpt ? activeOpt.label : String(value);
const segRow = el('div', {
display: 'grid',
gridTemplateColumns: 'repeat(' + opts.length + ', 1fr)',
@@ -3354,7 +3362,7 @@
});
const segBtns = [];
opts.forEach(o => {
- const active = o.value === p.default;
+ const active = o.value === value;
const b = el('button', {
padding: '5px 4px', border: 'none', borderRadius: '3px',
background: active ? C.brand : 'transparent',
@@ -4988,8 +4996,8 @@
const variantEl = getVisibleVariantEl();
const params = parseVariantParams(variantEl);
if (!variantEl || params.length === 0) return;
- // Build fresh to ensure the current variant's controls are shown.
- applyParamDefaults(variantEl, params);
+ // Rebuild the controls from the current values. Defaults are applied
+ // when the variant is initialized, not when its Tune panel is reopened.
buildParamsPanel(variantEl, params);
tuneOpen = true;
showParamsPanel();
diff --git a/.trae/skills/impeccable/reference/android.md b/.trae/skills/impeccable/reference/android.md
index 1f67a6bb5..32a5cf7cc 100644
--- a/.trae/skills/impeccable/reference/android.md
+++ b/.trae/skills/impeccable/reference/android.md
@@ -42,5 +42,5 @@ Would a fluent Android user trust this app, or trip on off-spec components? The
## Verifying the build
- **Screenshots come from the emulator or a connected device, never a browser.** Build and install, then capture with `adb exec-out screencap -p > <path>` (pick a device with `adb -s <serial>` when several are attached). Capture every device class the app ships to, at least one phone and, when tablets are a target, one tablet, and write the files where the review flow expects them.
-- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (restore `1.0` after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
+- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (read both settings first with `adb shell cmd uimode night` and `adb shell settings get system font_scale`, and restore them after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
- **Emulators give breadth; gestures, refresh rates, and performance need hardware.** Say which one produced the evidence.
diff --git a/.trae/skills/impeccable/reference/audit.md b/.trae/skills/impeccable/reference/audit.md
index 8309a1dfb..9ea9e2b0b 100644
--- a/.trae/skills/impeccable/reference/audit.md
+++ b/.trae/skills/impeccable/reference/audit.md
@@ -11,7 +11,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
### 1. Accessibility (A11y)
**Check for**:
-- **Contrast issues**: Text contrast ratios < 4.5:1 (or 7:1 for AAA)
+- **Contrast issues**: Text contrast ratios < 4.5:1, or < 3:1 for large text (or 7:1 for AAA)
- **Motion sensitivity**: `prefers-reduced-motion` needs an intentional alternative that preserves state change and hierarchy; flag a global `0.01ms` kill that destroys useful feedback, flashing above threshold, and motion that blocks focus, reading, or task completion
- **Missing ARIA**: Interactive elements without proper roles, labels, or states
- **Keyboard navigation**: Missing focus indicators, illogical tab order, keyboard traps
@@ -47,7 +47,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
**Check for**:
- **Fixed widths**: Hard-coded widths that break on mobile
-- **Touch targets**: Interactive elements < 44x44px
+- **Touch targets**: Interactive elements < 44x44px. WCAG AA (SC 2.5.8) requires at least 24x24 CSS px unless an exception applies: spacing, an equivalent control, inline text, user-agent styling, or an essential size. Spacing passes when a 24 CSS px circle centered on the target's bounding box overlaps no other target and no other undersized target's circle
- **Broken touch interaction**: Custom sliders, drag surfaces, and scrollable control strips whose primary gesture fails under touch, that swallow page scroll or lose the drag to it, or that stay stuck after an interrupted gesture. Code tells: mouse-only handlers, no `touch-action` on a pointer-event drag surface, drag state that nothing clears on cancel, lost capture, or blur. Exercise the gesture when a browser tool can synthesize touch (a rendered viewport proves layout, not the gesture), then say what produced the evidence (emulated viewport, synthesized touch, which engine, physical device) and what stayed untested
- **Horizontal scroll**: Content overflow on narrow viewports
- **Text scaling**: Layouts that break when text size increases
diff --git a/.trae/skills/impeccable/reference/distill.md b/.trae/skills/impeccable/reference/distill.md
index 757630fae..a49697136 100644
--- a/.trae/skills/impeccable/reference/distill.md
+++ b/.trae/skills/impeccable/reference/distill.md
@@ -41,7 +41,7 @@ Expect to say no to good ideas to make room for great execution.
Systematically remove complexity across these dimensions:
### Information Architecture
-- **Reduce scope**: Remove secondary actions, optional features, redundant information
+- **Reduce scope**: Remove secondary actions, redundant information
- **Progressive disclosure**: Hide complexity behind clear entry points (accordions, modals, step-through flows)
- **Combine related actions**: Merge similar buttons, consolidate forms, group related content
- **Clear hierarchy**: ONE primary action, few secondary actions, everything else tertiary or hidden
@@ -70,11 +70,11 @@ Systematically remove complexity across these dimensions:
- **Clear next action**: ONE obvious next action, not five competing ones
### Content Simplification
-- **Shorter copy**: Cut every sentence in half, then do it again
+- **Shorter copy**: Cut filler, not meaning
- **Active voice**: "Save changes" not "Changes will be saved"
- **Remove jargon**: Plain language always wins
- **Scannable structure**: Short paragraphs, bullet points, clear headings
-- **Essential information only**: Remove marketing fluff, legalese, hedging
+- **Essential information only**: Remove marketing fluff, hedging
- **Remove redundant copy**: No headers restating intros, no repeated explanations, say it once
### Code Simplification
diff --git a/.trae/skills/impeccable/reference/doctor.md b/.trae/skills/impeccable/reference/doctor.md
index 1d2d5d191..01e6c0b6e 100644
--- a/.trae/skills/impeccable/reference/doctor.md
+++ b/.trae/skills/impeccable/reference/doctor.md
@@ -6,7 +6,7 @@ This is maintenance, not design. Do not redesign anything, do not open files out
Three kinds of drift travel under "out of date". Keep them apart:
-- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it. Not this command's job.
+- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it, or the harness's plugin manager for a plugin install. Not this command's job.
- **Schema drift.** An artifact was written by an older Impeccable: fields nothing reads, fields now expected, files in retired locations. Mechanical, and this command repairs most of it.
- **Truth drift.** The code moved on and the document no longer describes it. No file comparison settles this. `document` owns DESIGN.md, `init` owns PRODUCT.md, and this command's job is to hand them a specific gap rather than a vague suspicion.
diff --git a/.trae/skills/impeccable/reference/document.md b/.trae/skills/impeccable/reference/document.md
index 9da0bc743..ec75b7cc7 100644
--- a/.trae/skills/impeccable/reference/document.md
+++ b/.trae/skills/impeccable/reference/document.md
@@ -17,10 +17,10 @@ colors:
typography:
display:
fontFamily: "Cormorant Garamond, Georgia, serif"
- fontSize: "clamp(2.5rem, 7vw, 4.5rem)"
+ fontSize: "4.5rem"
fontWeight: 300
lineHeight: 1
- letterSpacing: "normal"
+ letterSpacing: "0em"
body:
# ...
rounded:
@@ -325,7 +325,7 @@ If the project has **no component library yet** (bare landing page, new project)
#### Tonal ramps
-For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue and chroma, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
+For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue, chroma reduced near white and black, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
#### Narrative mapping
diff --git a/.trae/skills/impeccable/reference/live.md b/.trae/skills/impeccable/reference/live.md
index ace029f71..9b5604d72 100644
--- a/.trae/skills/impeccable/reference/live.md
+++ b/.trae/skills/impeccable/reference/live.md
@@ -158,14 +158,14 @@ Sources in priority order: DESIGN.md's visual system fields; CSS custom properti
**Default:** compare each variant against the Phase A lock; palette, type voice, or rhetoric drift means it crossed into departure by accident: rework. Then confirm three different primary axes; three "tighter density" variants is failure. **Departure:** two passes, family before sentence. Family pass (non-negotiable): label each variant with a concrete family of your own choosing; shared or interchangeable labels mean rework. Sentence pass: three one-line descriptions side by side; two that rhyme mean rework. When the primary axis is color or theme, the trio must not share theme + dominant hue: three color worlds, not three shades.
-**Action-specific invocations** must vary along the action's dimension:
+**Action-specific invocations** must vary along the action's dimension; in default mode every variation stays within the available faces and existing tokens:
- `bolder`: amplify a different dimension per variant (scale / saturation / structural change).
- `quieter`: pull back a different dimension (color / ornament / spacing).
- `distill`: remove a different class of excess (visual noise / redundant content / nested structure).
- `polish`: a different refinement axis (rhythm / hierarchy / micro-details).
-- `typeset`: different pairing AND different scale ratio each.
-- `colorize`: different hue family each; vary chroma and contrast strategy.
+- `typeset`: departure varies the pairing AND the scale ratio each; default keeps the faces and varies scale ratio, case, and weight each.
+- `colorize`: departure gives each a different hue family and varies chroma and contrast strategy; default gives each a different existing palette role carrying the surface (Restrained / Committed / Full palette / Drenched) and a different contrast strategy.
- `layout`: different structural arrangement, not spacing tweaks.
- `adapt`: different target context per variant (mobile-first / tablet / desktop / print or low-data).
- `animate`: different motion vocabulary (cascade stagger / clip wipe / scale-and-focus / morph / parallax).
diff --git a/.trae/skills/impeccable/reference/optimize.md b/.trae/skills/impeccable/reference/optimize.md
index 5c55a1642..3f3fc7c33 100644
--- a/.trae/skills/impeccable/reference/optimize.md
+++ b/.trae/skills/impeccable/reference/optimize.md
@@ -38,7 +38,6 @@ Create systematic improvement plan:
src="hero.webp"
srcset="hero-400.webp 400w, hero-800.webp 800w, hero-1200.webp 1200w"
sizes="(max-width: 400px) 400px, (max-width: 800px) 800px, 1200px"
- loading="lazy"
alt="Hero image"
/>
```
diff --git a/.trae/skills/impeccable/reference/visualize.md b/.trae/skills/impeccable/reference/visualize.md
index 684d35585..c49c41146 100644
--- a/.trae/skills/impeccable/reference/visualize.md
+++ b/.trae/skills/impeccable/reference/visualize.md
@@ -26,7 +26,7 @@ Each comp is a direction test, not a screenshot specification. Core UI text, res
Show the three together on the decision page (`impeccable serve-question`, one option per comp with the comp as its hero), or in the harness only when it renders images inline; a text-only surface does not count as display. Ask what should carry forward, what feels false to the world, and whether the selected concept should be approved, combined, revised, or rejected. Then stop and wait. A structured simulated user counts as attended and receives the same question.
-Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md, and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
+Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md (the chosen direction on a new world), and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
This approval point has no substitute and no skip condition. When the structured question tool errors, fall back to the decision page; only after both fail may you treat the choice as delegated, and a delegated pick is recorded exactly as an approval is and disclosed in your first reply, not your last. The finish reviewer treats comp-round comps with no recorded approval as a material finding; decision comps under `.impeccable/mocks/decision/` are the direction round's hand, not comp-round output, and imply no approval on their own.
diff --git a/.trae/skills/impeccable/scripts/command-metadata.json b/.trae/skills/impeccable/scripts/command-metadata.json
index 89891ea4d..4686bb6de 100644
--- a/.trae/skills/impeccable/scripts/command-metadata.json
+++ b/.trae/skills/impeccable/scripts/command-metadata.json
@@ -4,7 +4,7 @@
"argumentHint": "[feature description]"
},
"init": {
- "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); offers DESIGN.md (visual: colors, typography, components) when code exists; pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
+ "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
"argumentHint": ""
},
"document": {
@@ -88,7 +88,7 @@
"argumentHint": "[target]"
},
"shape": {
- "description": "Plan UX and UI before code. Runs a required multi-round discovery interview, uses visual probes when available, and produces a user-confirmed design brief for implementation.",
+ "description": "Plan UX and UI before code. Runs a discovery interview (one round by default), uses visual probes when available, and produces a user-confirmed design brief for implementation.",
"argumentHint": "[feature to shape]"
},
"typeset": {
diff --git a/.trae/skills/impeccable/scripts/live-browser.js b/.trae/skills/impeccable/scripts/live-browser.js
index 504e75b9c..a63f1abe2 100644
--- a/.trae/skills/impeccable/scripts/live-browser.js
+++ b/.trae/skills/impeccable/scripts/live-browser.js
@@ -3271,6 +3271,14 @@
const P = paramsPanelPalette || barPaletteForTheme(detectPageTheme());
paramsPanelBody.innerHTML = '';
for (const p of params) {
+ // A knob the panel shows must be in the live values and on the variant,
+ // or accept drops it and the preview ignores it. Seed only missing keys
+ // so a reopen keeps edits.
+ if (!Object.hasOwn(paramsCurrentValues, p.id)) {
+ paramsCurrentValues[p.id] = p.default;
+ applyParamValue(variantEl, p, p.default);
+ }
+ const value = paramsCurrentValues[p.id];
const row = el('div', { display: 'flex', flexDirection: 'column', gap: '6px' });
const labelRow = el('div', {
display: 'flex', justifyContent: 'space-between',
@@ -3295,7 +3303,7 @@
input.min = String(p.min != null ? p.min : 0);
input.max = String(p.max != null ? p.max : 1);
input.step = String(p.step != null ? p.step : 0.05);
- input.value = String(p.default);
+ input.value = String(value);
Object.assign(input.style, {
width: '100%', accentColor: C.brand, cursor: 'pointer',
});
@@ -3310,7 +3318,7 @@
});
row.appendChild(input);
} else if (p.kind === 'toggle') {
- const initial = !!p.default;
+ const initial = !!value;
readout.textContent = initial ? 'On' : 'Off';
const track = el('button', {
position: 'relative', width: '36px', height: '20px',
@@ -3344,8 +3352,8 @@
const opts = (p.options || []).map(o =>
typeof o === 'string' ? { value: o, label: o } : o
);
- const activeOpt = opts.find(o => o.value === p.default) || opts[0];
- readout.textContent = activeOpt ? activeOpt.label : String(p.default);
+ const activeOpt = opts.find(o => o.value === value) || opts[0];
+ readout.textContent = activeOpt ? activeOpt.label : String(value);
const segRow = el('div', {
display: 'grid',
gridTemplateColumns: 'repeat(' + opts.length + ', 1fr)',
@@ -3354,7 +3362,7 @@
});
const segBtns = [];
opts.forEach(o => {
- const active = o.value === p.default;
+ const active = o.value === value;
const b = el('button', {
padding: '5px 4px', border: 'none', borderRadius: '3px',
background: active ? C.brand : 'transparent',
@@ -4988,8 +4996,8 @@
const variantEl = getVisibleVariantEl();
const params = parseVariantParams(variantEl);
if (!variantEl || params.length === 0) return;
- // Build fresh to ensure the current variant's controls are shown.
- applyParamDefaults(variantEl, params);
+ // Rebuild the controls from the current values. Defaults are applied
+ // when the variant is initialized, not when its Tune panel is reopened.
buildParamsPanel(variantEl, params);
tuneOpen = true;
showParamsPanel();
diff --git a/.veto/skills/impeccable/reference/android.md b/.veto/skills/impeccable/reference/android.md
index 1f67a6bb5..32a5cf7cc 100644
--- a/.veto/skills/impeccable/reference/android.md
+++ b/.veto/skills/impeccable/reference/android.md
@@ -42,5 +42,5 @@ Would a fluent Android user trust this app, or trip on off-spec components? The
## Verifying the build
- **Screenshots come from the emulator or a connected device, never a browser.** Build and install, then capture with `adb exec-out screencap -p > <path>` (pick a device with `adb -s <serial>` when several are attached). Capture every device class the app ships to, at least one phone and, when tablets are a target, one tablet, and write the files where the review flow expects them.
-- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (restore `1.0` after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
+- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (read both settings first with `adb shell cmd uimode night` and `adb shell settings get system font_scale`, and restore them after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
- **Emulators give breadth; gestures, refresh rates, and performance need hardware.** Say which one produced the evidence.
diff --git a/.veto/skills/impeccable/reference/audit.md b/.veto/skills/impeccable/reference/audit.md
index 4d2b8ec84..d4aa97622 100644
--- a/.veto/skills/impeccable/reference/audit.md
+++ b/.veto/skills/impeccable/reference/audit.md
@@ -11,7 +11,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
### 1. Accessibility (A11y)
**Check for**:
-- **Contrast issues**: Text contrast ratios < 4.5:1 (or 7:1 for AAA)
+- **Contrast issues**: Text contrast ratios < 4.5:1, or < 3:1 for large text (or 7:1 for AAA)
- **Motion sensitivity**: `prefers-reduced-motion` needs an intentional alternative that preserves state change and hierarchy; flag a global `0.01ms` kill that destroys useful feedback, flashing above threshold, and motion that blocks focus, reading, or task completion
- **Missing ARIA**: Interactive elements without proper roles, labels, or states
- **Keyboard navigation**: Missing focus indicators, illogical tab order, keyboard traps
@@ -47,7 +47,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
**Check for**:
- **Fixed widths**: Hard-coded widths that break on mobile
-- **Touch targets**: Interactive elements < 44x44px
+- **Touch targets**: Interactive elements < 44x44px. WCAG AA (SC 2.5.8) requires at least 24x24 CSS px unless an exception applies: spacing, an equivalent control, inline text, user-agent styling, or an essential size. Spacing passes when a 24 CSS px circle centered on the target's bounding box overlaps no other target and no other undersized target's circle
- **Broken touch interaction**: Custom sliders, drag surfaces, and scrollable control strips whose primary gesture fails under touch, that swallow page scroll or lose the drag to it, or that stay stuck after an interrupted gesture. Code tells: mouse-only handlers, no `touch-action` on a pointer-event drag surface, drag state that nothing clears on cancel, lost capture, or blur. Exercise the gesture when a browser tool can synthesize touch (a rendered viewport proves layout, not the gesture), then say what produced the evidence (emulated viewport, synthesized touch, which engine, physical device) and what stayed untested
- **Horizontal scroll**: Content overflow on narrow viewports
- **Text scaling**: Layouts that break when text size increases
diff --git a/.veto/skills/impeccable/reference/distill.md b/.veto/skills/impeccable/reference/distill.md
index 757630fae..a49697136 100644
--- a/.veto/skills/impeccable/reference/distill.md
+++ b/.veto/skills/impeccable/reference/distill.md
@@ -41,7 +41,7 @@ Expect to say no to good ideas to make room for great execution.
Systematically remove complexity across these dimensions:
### Information Architecture
-- **Reduce scope**: Remove secondary actions, optional features, redundant information
+- **Reduce scope**: Remove secondary actions, redundant information
- **Progressive disclosure**: Hide complexity behind clear entry points (accordions, modals, step-through flows)
- **Combine related actions**: Merge similar buttons, consolidate forms, group related content
- **Clear hierarchy**: ONE primary action, few secondary actions, everything else tertiary or hidden
@@ -70,11 +70,11 @@ Systematically remove complexity across these dimensions:
- **Clear next action**: ONE obvious next action, not five competing ones
### Content Simplification
-- **Shorter copy**: Cut every sentence in half, then do it again
+- **Shorter copy**: Cut filler, not meaning
- **Active voice**: "Save changes" not "Changes will be saved"
- **Remove jargon**: Plain language always wins
- **Scannable structure**: Short paragraphs, bullet points, clear headings
-- **Essential information only**: Remove marketing fluff, legalese, hedging
+- **Essential information only**: Remove marketing fluff, hedging
- **Remove redundant copy**: No headers restating intros, no repeated explanations, say it once
### Code Simplification
diff --git a/.veto/skills/impeccable/reference/doctor.md b/.veto/skills/impeccable/reference/doctor.md
index 1523d8ff7..03c64e923 100644
--- a/.veto/skills/impeccable/reference/doctor.md
+++ b/.veto/skills/impeccable/reference/doctor.md
@@ -6,7 +6,7 @@ This is maintenance, not design. Do not redesign anything, do not open files out
Three kinds of drift travel under "out of date". Keep them apart:
-- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it. Not this command's job.
+- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it, or the harness's plugin manager for a plugin install. Not this command's job.
- **Schema drift.** An artifact was written by an older Impeccable: fields nothing reads, fields now expected, files in retired locations. Mechanical, and this command repairs most of it.
- **Truth drift.** The code moved on and the document no longer describes it. No file comparison settles this. `document` owns DESIGN.md, `init` owns PRODUCT.md, and this command's job is to hand them a specific gap rather than a vague suspicion.
diff --git a/.veto/skills/impeccable/reference/document.md b/.veto/skills/impeccable/reference/document.md
index 9da0bc743..ec75b7cc7 100644
--- a/.veto/skills/impeccable/reference/document.md
+++ b/.veto/skills/impeccable/reference/document.md
@@ -17,10 +17,10 @@ colors:
typography:
display:
fontFamily: "Cormorant Garamond, Georgia, serif"
- fontSize: "clamp(2.5rem, 7vw, 4.5rem)"
+ fontSize: "4.5rem"
fontWeight: 300
lineHeight: 1
- letterSpacing: "normal"
+ letterSpacing: "0em"
body:
# ...
rounded:
@@ -325,7 +325,7 @@ If the project has **no component library yet** (bare landing page, new project)
#### Tonal ramps
-For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue and chroma, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
+For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue, chroma reduced near white and black, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
#### Narrative mapping
diff --git a/.veto/skills/impeccable/reference/live.md b/.veto/skills/impeccable/reference/live.md
index 15eec19ce..40f56e989 100644
--- a/.veto/skills/impeccable/reference/live.md
+++ b/.veto/skills/impeccable/reference/live.md
@@ -158,14 +158,14 @@ Sources in priority order: DESIGN.md's visual system fields; CSS custom properti
**Default:** compare each variant against the Phase A lock; palette, type voice, or rhetoric drift means it crossed into departure by accident: rework. Then confirm three different primary axes; three "tighter density" variants is failure. **Departure:** two passes, family before sentence. Family pass (non-negotiable): label each variant with a concrete family of your own choosing; shared or interchangeable labels mean rework. Sentence pass: three one-line descriptions side by side; two that rhyme mean rework. When the primary axis is color or theme, the trio must not share theme + dominant hue: three color worlds, not three shades.
-**Action-specific invocations** must vary along the action's dimension:
+**Action-specific invocations** must vary along the action's dimension; in default mode every variation stays within the available faces and existing tokens:
- `bolder`: amplify a different dimension per variant (scale / saturation / structural change).
- `quieter`: pull back a different dimension (color / ornament / spacing).
- `distill`: remove a different class of excess (visual noise / redundant content / nested structure).
- `polish`: a different refinement axis (rhythm / hierarchy / micro-details).
-- `typeset`: different pairing AND different scale ratio each.
-- `colorize`: different hue family each; vary chroma and contrast strategy.
+- `typeset`: departure varies the pairing AND the scale ratio each; default keeps the faces and varies scale ratio, case, and weight each.
+- `colorize`: departure gives each a different hue family and varies chroma and contrast strategy; default gives each a different existing palette role carrying the surface (Restrained / Committed / Full palette / Drenched) and a different contrast strategy.
- `layout`: different structural arrangement, not spacing tweaks.
- `adapt`: different target context per variant (mobile-first / tablet / desktop / print or low-data).
- `animate`: different motion vocabulary (cascade stagger / clip wipe / scale-and-focus / morph / parallax).
diff --git a/.veto/skills/impeccable/reference/optimize.md b/.veto/skills/impeccable/reference/optimize.md
index 5c55a1642..3f3fc7c33 100644
--- a/.veto/skills/impeccable/reference/optimize.md
+++ b/.veto/skills/impeccable/reference/optimize.md
@@ -38,7 +38,6 @@ Create systematic improvement plan:
src="hero.webp"
srcset="hero-400.webp 400w, hero-800.webp 800w, hero-1200.webp 1200w"
sizes="(max-width: 400px) 400px, (max-width: 800px) 800px, 1200px"
- loading="lazy"
alt="Hero image"
/>
```
diff --git a/.veto/skills/impeccable/reference/visualize.md b/.veto/skills/impeccable/reference/visualize.md
index 02ac29f7f..3b8b572e9 100644
--- a/.veto/skills/impeccable/reference/visualize.md
+++ b/.veto/skills/impeccable/reference/visualize.md
@@ -26,7 +26,7 @@ Each comp is a direction test, not a screenshot specification. Core UI text, res
Show the three together on the decision page (`impeccable serve-question`, one option per comp with the comp as its hero), or in the harness only when it renders images inline; a text-only surface does not count as display. Ask what should carry forward, what feels false to the world, and whether the selected concept should be approved, combined, revised, or rejected. Then stop and wait. A structured simulated user counts as attended and receives the same question.
-Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md, and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
+Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md (the chosen direction on a new world), and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
This approval point has no substitute and no skip condition. When the structured question tool errors, fall back to the decision page; only after both fail may you treat the choice as delegated, and a delegated pick is recorded exactly as an approval is and disclosed in your first reply, not your last. The finish reviewer treats comp-round comps with no recorded approval as a material finding; decision comps under `.impeccable/mocks/decision/` are the direction round's hand, not comp-round output, and imply no approval on their own.
diff --git a/.veto/skills/impeccable/scripts/command-metadata.json b/.veto/skills/impeccable/scripts/command-metadata.json
index 89891ea4d..4686bb6de 100644
--- a/.veto/skills/impeccable/scripts/command-metadata.json
+++ b/.veto/skills/impeccable/scripts/command-metadata.json
@@ -4,7 +4,7 @@
"argumentHint": "[feature description]"
},
"init": {
- "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); offers DESIGN.md (visual: colors, typography, components) when code exists; pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
+ "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
"argumentHint": ""
},
"document": {
@@ -88,7 +88,7 @@
"argumentHint": "[target]"
},
"shape": {
- "description": "Plan UX and UI before code. Runs a required multi-round discovery interview, uses visual probes when available, and produces a user-confirmed design brief for implementation.",
+ "description": "Plan UX and UI before code. Runs a discovery interview (one round by default), uses visual probes when available, and produces a user-confirmed design brief for implementation.",
"argumentHint": "[feature to shape]"
},
"typeset": {
diff --git a/.veto/skills/impeccable/scripts/live-browser.js b/.veto/skills/impeccable/scripts/live-browser.js
index 504e75b9c..a63f1abe2 100644
--- a/.veto/skills/impeccable/scripts/live-browser.js
+++ b/.veto/skills/impeccable/scripts/live-browser.js
@@ -3271,6 +3271,14 @@
const P = paramsPanelPalette || barPaletteForTheme(detectPageTheme());
paramsPanelBody.innerHTML = '';
for (const p of params) {
+ // A knob the panel shows must be in the live values and on the variant,
+ // or accept drops it and the preview ignores it. Seed only missing keys
+ // so a reopen keeps edits.
+ if (!Object.hasOwn(paramsCurrentValues, p.id)) {
+ paramsCurrentValues[p.id] = p.default;
+ applyParamValue(variantEl, p, p.default);
+ }
+ const value = paramsCurrentValues[p.id];
const row = el('div', { display: 'flex', flexDirection: 'column', gap: '6px' });
const labelRow = el('div', {
display: 'flex', justifyContent: 'space-between',
@@ -3295,7 +3303,7 @@
input.min = String(p.min != null ? p.min : 0);
input.max = String(p.max != null ? p.max : 1);
input.step = String(p.step != null ? p.step : 0.05);
- input.value = String(p.default);
+ input.value = String(value);
Object.assign(input.style, {
width: '100%', accentColor: C.brand, cursor: 'pointer',
});
@@ -3310,7 +3318,7 @@
});
row.appendChild(input);
} else if (p.kind === 'toggle') {
- const initial = !!p.default;
+ const initial = !!value;
readout.textContent = initial ? 'On' : 'Off';
const track = el('button', {
position: 'relative', width: '36px', height: '20px',
@@ -3344,8 +3352,8 @@
const opts = (p.options || []).map(o =>
typeof o === 'string' ? { value: o, label: o } : o
);
- const activeOpt = opts.find(o => o.value === p.default) || opts[0];
- readout.textContent = activeOpt ? activeOpt.label : String(p.default);
+ const activeOpt = opts.find(o => o.value === value) || opts[0];
+ readout.textContent = activeOpt ? activeOpt.label : String(value);
const segRow = el('div', {
display: 'grid',
gridTemplateColumns: 'repeat(' + opts.length + ', 1fr)',
@@ -3354,7 +3362,7 @@
});
const segBtns = [];
opts.forEach(o => {
- const active = o.value === p.default;
+ const active = o.value === value;
const b = el('button', {
padding: '5px 4px', border: 'none', borderRadius: '3px',
background: active ? C.brand : 'transparent',
@@ -4988,8 +4996,8 @@
const variantEl = getVisibleVariantEl();
const params = parseVariantParams(variantEl);
if (!variantEl || params.length === 0) return;
- // Build fresh to ensure the current variant's controls are shown.
- applyParamDefaults(variantEl, params);
+ // Rebuild the controls from the current values. Defaults are applied
+ // when the variant is initialized, not when its Tune panel is reopened.
buildParamsPanel(variantEl, params);
tuneOpen = true;
showParamsPanel();
diff --git a/.vibe/skills/impeccable/reference/android.md b/.vibe/skills/impeccable/reference/android.md
index 1f67a6bb5..32a5cf7cc 100644
--- a/.vibe/skills/impeccable/reference/android.md
+++ b/.vibe/skills/impeccable/reference/android.md
@@ -42,5 +42,5 @@ Would a fluent Android user trust this app, or trip on off-spec components? The
## Verifying the build
- **Screenshots come from the emulator or a connected device, never a browser.** Build and install, then capture with `adb exec-out screencap -p > <path>` (pick a device with `adb -s <serial>` when several are attached). Capture every device class the app ships to, at least one phone and, when tablets are a target, one tablet, and write the files where the review flow expects them.
-- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (restore `1.0` after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
+- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (read both settings first with `adb shell cmd uimode night` and `adb shell settings get system font_scale`, and restore them after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
- **Emulators give breadth; gestures, refresh rates, and performance need hardware.** Say which one produced the evidence.
diff --git a/.vibe/skills/impeccable/reference/audit.md b/.vibe/skills/impeccable/reference/audit.md
index d7e54cbb0..17aaaf693 100644
--- a/.vibe/skills/impeccable/reference/audit.md
+++ b/.vibe/skills/impeccable/reference/audit.md
@@ -11,7 +11,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
### 1. Accessibility (A11y)
**Check for**:
-- **Contrast issues**: Text contrast ratios < 4.5:1 (or 7:1 for AAA)
+- **Contrast issues**: Text contrast ratios < 4.5:1, or < 3:1 for large text (or 7:1 for AAA)
- **Motion sensitivity**: `prefers-reduced-motion` needs an intentional alternative that preserves state change and hierarchy; flag a global `0.01ms` kill that destroys useful feedback, flashing above threshold, and motion that blocks focus, reading, or task completion
- **Missing ARIA**: Interactive elements without proper roles, labels, or states
- **Keyboard navigation**: Missing focus indicators, illogical tab order, keyboard traps
@@ -47,7 +47,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
**Check for**:
- **Fixed widths**: Hard-coded widths that break on mobile
-- **Touch targets**: Interactive elements < 44x44px
+- **Touch targets**: Interactive elements < 44x44px. WCAG AA (SC 2.5.8) requires at least 24x24 CSS px unless an exception applies: spacing, an equivalent control, inline text, user-agent styling, or an essential size. Spacing passes when a 24 CSS px circle centered on the target's bounding box overlaps no other target and no other undersized target's circle
- **Broken touch interaction**: Custom sliders, drag surfaces, and scrollable control strips whose primary gesture fails under touch, that swallow page scroll or lose the drag to it, or that stay stuck after an interrupted gesture. Code tells: mouse-only handlers, no `touch-action` on a pointer-event drag surface, drag state that nothing clears on cancel, lost capture, or blur. Exercise the gesture when a browser tool can synthesize touch (a rendered viewport proves layout, not the gesture), then say what produced the evidence (emulated viewport, synthesized touch, which engine, physical device) and what stayed untested
- **Horizontal scroll**: Content overflow on narrow viewports
- **Text scaling**: Layouts that break when text size increases
diff --git a/.vibe/skills/impeccable/reference/distill.md b/.vibe/skills/impeccable/reference/distill.md
index 757630fae..a49697136 100644
--- a/.vibe/skills/impeccable/reference/distill.md
+++ b/.vibe/skills/impeccable/reference/distill.md
@@ -41,7 +41,7 @@ Expect to say no to good ideas to make room for great execution.
Systematically remove complexity across these dimensions:
### Information Architecture
-- **Reduce scope**: Remove secondary actions, optional features, redundant information
+- **Reduce scope**: Remove secondary actions, redundant information
- **Progressive disclosure**: Hide complexity behind clear entry points (accordions, modals, step-through flows)
- **Combine related actions**: Merge similar buttons, consolidate forms, group related content
- **Clear hierarchy**: ONE primary action, few secondary actions, everything else tertiary or hidden
@@ -70,11 +70,11 @@ Systematically remove complexity across these dimensions:
- **Clear next action**: ONE obvious next action, not five competing ones
### Content Simplification
-- **Shorter copy**: Cut every sentence in half, then do it again
+- **Shorter copy**: Cut filler, not meaning
- **Active voice**: "Save changes" not "Changes will be saved"
- **Remove jargon**: Plain language always wins
- **Scannable structure**: Short paragraphs, bullet points, clear headings
-- **Essential information only**: Remove marketing fluff, legalese, hedging
+- **Essential information only**: Remove marketing fluff, hedging
- **Remove redundant copy**: No headers restating intros, no repeated explanations, say it once
### Code Simplification
diff --git a/.vibe/skills/impeccable/reference/doctor.md b/.vibe/skills/impeccable/reference/doctor.md
index df72b483d..7b55ac4da 100644
--- a/.vibe/skills/impeccable/reference/doctor.md
+++ b/.vibe/skills/impeccable/reference/doctor.md
@@ -6,7 +6,7 @@ This is maintenance, not design. Do not redesign anything, do not open files out
Three kinds of drift travel under "out of date". Keep them apart:
-- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it. Not this command's job.
+- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it, or the harness's plugin manager for a plugin install. Not this command's job.
- **Schema drift.** An artifact was written by an older Impeccable: fields nothing reads, fields now expected, files in retired locations. Mechanical, and this command repairs most of it.
- **Truth drift.** The code moved on and the document no longer describes it. No file comparison settles this. `document` owns DESIGN.md, `init` owns PRODUCT.md, and this command's job is to hand them a specific gap rather than a vague suspicion.
diff --git a/.vibe/skills/impeccable/reference/document.md b/.vibe/skills/impeccable/reference/document.md
index 9da0bc743..ec75b7cc7 100644
--- a/.vibe/skills/impeccable/reference/document.md
+++ b/.vibe/skills/impeccable/reference/document.md
@@ -17,10 +17,10 @@ colors:
typography:
display:
fontFamily: "Cormorant Garamond, Georgia, serif"
- fontSize: "clamp(2.5rem, 7vw, 4.5rem)"
+ fontSize: "4.5rem"
fontWeight: 300
lineHeight: 1
- letterSpacing: "normal"
+ letterSpacing: "0em"
body:
# ...
rounded:
@@ -325,7 +325,7 @@ If the project has **no component library yet** (bare landing page, new project)
#### Tonal ramps
-For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue and chroma, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
+For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue, chroma reduced near white and black, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
#### Narrative mapping
diff --git a/.vibe/skills/impeccable/reference/live.md b/.vibe/skills/impeccable/reference/live.md
index a48437be7..6c406bade 100644
--- a/.vibe/skills/impeccable/reference/live.md
+++ b/.vibe/skills/impeccable/reference/live.md
@@ -158,14 +158,14 @@ Sources in priority order: DESIGN.md's visual system fields; CSS custom properti
**Default:** compare each variant against the Phase A lock; palette, type voice, or rhetoric drift means it crossed into departure by accident: rework. Then confirm three different primary axes; three "tighter density" variants is failure. **Departure:** two passes, family before sentence. Family pass (non-negotiable): label each variant with a concrete family of your own choosing; shared or interchangeable labels mean rework. Sentence pass: three one-line descriptions side by side; two that rhyme mean rework. When the primary axis is color or theme, the trio must not share theme + dominant hue: three color worlds, not three shades.
-**Action-specific invocations** must vary along the action's dimension:
+**Action-specific invocations** must vary along the action's dimension; in default mode every variation stays within the available faces and existing tokens:
- `bolder`: amplify a different dimension per variant (scale / saturation / structural change).
- `quieter`: pull back a different dimension (color / ornament / spacing).
- `distill`: remove a different class of excess (visual noise / redundant content / nested structure).
- `polish`: a different refinement axis (rhythm / hierarchy / micro-details).
-- `typeset`: different pairing AND different scale ratio each.
-- `colorize`: different hue family each; vary chroma and contrast strategy.
+- `typeset`: departure varies the pairing AND the scale ratio each; default keeps the faces and varies scale ratio, case, and weight each.
+- `colorize`: departure gives each a different hue family and varies chroma and contrast strategy; default gives each a different existing palette role carrying the surface (Restrained / Committed / Full palette / Drenched) and a different contrast strategy.
- `layout`: different structural arrangement, not spacing tweaks.
- `adapt`: different target context per variant (mobile-first / tablet / desktop / print or low-data).
- `animate`: different motion vocabulary (cascade stagger / clip wipe / scale-and-focus / morph / parallax).
diff --git a/.vibe/skills/impeccable/reference/optimize.md b/.vibe/skills/impeccable/reference/optimize.md
index 5c55a1642..3f3fc7c33 100644
--- a/.vibe/skills/impeccable/reference/optimize.md
+++ b/.vibe/skills/impeccable/reference/optimize.md
@@ -38,7 +38,6 @@ Create systematic improvement plan:
src="hero.webp"
srcset="hero-400.webp 400w, hero-800.webp 800w, hero-1200.webp 1200w"
sizes="(max-width: 400px) 400px, (max-width: 800px) 800px, 1200px"
- loading="lazy"
alt="Hero image"
/>
```
diff --git a/.vibe/skills/impeccable/reference/visualize.md b/.vibe/skills/impeccable/reference/visualize.md
index be75fb4e7..3076d9826 100644
--- a/.vibe/skills/impeccable/reference/visualize.md
+++ b/.vibe/skills/impeccable/reference/visualize.md
@@ -26,7 +26,7 @@ Each comp is a direction test, not a screenshot specification. Core UI text, res
Show the three together on the decision page (`impeccable serve-question`, one option per comp with the comp as its hero), or in the harness only when it renders images inline; a text-only surface does not count as display. Ask what should carry forward, what feels false to the world, and whether the selected concept should be approved, combined, revised, or rejected. Then stop and wait. A structured simulated user counts as attended and receives the same question.
-Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md, and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
+Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md (the chosen direction on a new world), and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
This approval point has no substitute and no skip condition. When the structured question tool errors, fall back to the decision page; only after both fail may you treat the choice as delegated, and a delegated pick is recorded exactly as an approval is and disclosed in your first reply, not your last. The finish reviewer treats comp-round comps with no recorded approval as a material finding; decision comps under `.impeccable/mocks/decision/` are the direction round's hand, not comp-round output, and imply no approval on their own.
diff --git a/.vibe/skills/impeccable/scripts/command-metadata.json b/.vibe/skills/impeccable/scripts/command-metadata.json
index 89891ea4d..4686bb6de 100644
--- a/.vibe/skills/impeccable/scripts/command-metadata.json
+++ b/.vibe/skills/impeccable/scripts/command-metadata.json
@@ -4,7 +4,7 @@
"argumentHint": "[feature description]"
},
"init": {
- "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); offers DESIGN.md (visual: colors, typography, components) when code exists; pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
+ "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
"argumentHint": ""
},
"document": {
@@ -88,7 +88,7 @@
"argumentHint": "[target]"
},
"shape": {
- "description": "Plan UX and UI before code. Runs a required multi-round discovery interview, uses visual probes when available, and produces a user-confirmed design brief for implementation.",
+ "description": "Plan UX and UI before code. Runs a discovery interview (one round by default), uses visual probes when available, and produces a user-confirmed design brief for implementation.",
"argumentHint": "[feature to shape]"
},
"typeset": {
diff --git a/.vibe/skills/impeccable/scripts/live-browser.js b/.vibe/skills/impeccable/scripts/live-browser.js
index 504e75b9c..a63f1abe2 100644
--- a/.vibe/skills/impeccable/scripts/live-browser.js
+++ b/.vibe/skills/impeccable/scripts/live-browser.js
@@ -3271,6 +3271,14 @@
const P = paramsPanelPalette || barPaletteForTheme(detectPageTheme());
paramsPanelBody.innerHTML = '';
for (const p of params) {
+ // A knob the panel shows must be in the live values and on the variant,
+ // or accept drops it and the preview ignores it. Seed only missing keys
+ // so a reopen keeps edits.
+ if (!Object.hasOwn(paramsCurrentValues, p.id)) {
+ paramsCurrentValues[p.id] = p.default;
+ applyParamValue(variantEl, p, p.default);
+ }
+ const value = paramsCurrentValues[p.id];
const row = el('div', { display: 'flex', flexDirection: 'column', gap: '6px' });
const labelRow = el('div', {
display: 'flex', justifyContent: 'space-between',
@@ -3295,7 +3303,7 @@
input.min = String(p.min != null ? p.min : 0);
input.max = String(p.max != null ? p.max : 1);
input.step = String(p.step != null ? p.step : 0.05);
- input.value = String(p.default);
+ input.value = String(value);
Object.assign(input.style, {
width: '100%', accentColor: C.brand, cursor: 'pointer',
});
@@ -3310,7 +3318,7 @@
});
row.appendChild(input);
} else if (p.kind === 'toggle') {
- const initial = !!p.default;
+ const initial = !!value;
readout.textContent = initial ? 'On' : 'Off';
const track = el('button', {
position: 'relative', width: '36px', height: '20px',
@@ -3344,8 +3352,8 @@
const opts = (p.options || []).map(o =>
typeof o === 'string' ? { value: o, label: o } : o
);
- const activeOpt = opts.find(o => o.value === p.default) || opts[0];
- readout.textContent = activeOpt ? activeOpt.label : String(p.default);
+ const activeOpt = opts.find(o => o.value === value) || opts[0];
+ readout.textContent = activeOpt ? activeOpt.label : String(value);
const segRow = el('div', {
display: 'grid',
gridTemplateColumns: 'repeat(' + opts.length + ', 1fr)',
@@ -3354,7 +3362,7 @@
});
const segBtns = [];
opts.forEach(o => {
- const active = o.value === p.default;
+ const active = o.value === value;
const b = el('button', {
padding: '5px 4px', border: 'none', borderRadius: '3px',
background: active ? C.brand : 'transparent',
@@ -4988,8 +4996,8 @@
const variantEl = getVisibleVariantEl();
const params = parseVariantParams(variantEl);
if (!variantEl || params.length === 0) return;
- // Build fresh to ensure the current variant's controls are shown.
- applyParamDefaults(variantEl, params);
+ // Rebuild the controls from the current values. Defaults are applied
+ // when the variant is initialized, not when its Tune panel is reopened.
buildParamsPanel(variantEl, params);
tuneOpen = true;
showParamsPanel();
diff --git a/cursor-plugin/skills/impeccable/reference/android.md b/cursor-plugin/skills/impeccable/reference/android.md
index 1f67a6bb5..32a5cf7cc 100644
--- a/cursor-plugin/skills/impeccable/reference/android.md
+++ b/cursor-plugin/skills/impeccable/reference/android.md
@@ -42,5 +42,5 @@ Would a fluent Android user trust this app, or trip on off-spec components? The
## Verifying the build
- **Screenshots come from the emulator or a connected device, never a browser.** Build and install, then capture with `adb exec-out screencap -p > <path>` (pick a device with `adb -s <serial>` when several are attached). Capture every device class the app ships to, at least one phone and, when tablets are a target, one tablet, and write the files where the review flow expects them.
-- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (restore `1.0` after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
+- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (read both settings first with `adb shell cmd uimode night` and `adb shell settings get system font_scale`, and restore them after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
- **Emulators give breadth; gestures, refresh rates, and performance need hardware.** Say which one produced the evidence.
diff --git a/cursor-plugin/skills/impeccable/reference/audit.md b/cursor-plugin/skills/impeccable/reference/audit.md
index 896ac8c61..b082c5a63 100644
--- a/cursor-plugin/skills/impeccable/reference/audit.md
+++ b/cursor-plugin/skills/impeccable/reference/audit.md
@@ -11,7 +11,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
### 1. Accessibility (A11y)
**Check for**:
-- **Contrast issues**: Text contrast ratios < 4.5:1 (or 7:1 for AAA)
+- **Contrast issues**: Text contrast ratios < 4.5:1, or < 3:1 for large text (or 7:1 for AAA)
- **Motion sensitivity**: `prefers-reduced-motion` needs an intentional alternative that preserves state change and hierarchy; flag a global `0.01ms` kill that destroys useful feedback, flashing above threshold, and motion that blocks focus, reading, or task completion
- **Missing ARIA**: Interactive elements without proper roles, labels, or states
- **Keyboard navigation**: Missing focus indicators, illogical tab order, keyboard traps
@@ -47,7 +47,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
**Check for**:
- **Fixed widths**: Hard-coded widths that break on mobile
-- **Touch targets**: Interactive elements < 44x44px
+- **Touch targets**: Interactive elements < 44x44px. WCAG AA (SC 2.5.8) requires at least 24x24 CSS px unless an exception applies: spacing, an equivalent control, inline text, user-agent styling, or an essential size. Spacing passes when a 24 CSS px circle centered on the target's bounding box overlaps no other target and no other undersized target's circle
- **Broken touch interaction**: Custom sliders, drag surfaces, and scrollable control strips whose primary gesture fails under touch, that swallow page scroll or lose the drag to it, or that stay stuck after an interrupted gesture. Code tells: mouse-only handlers, no `touch-action` on a pointer-event drag surface, drag state that nothing clears on cancel, lost capture, or blur. Exercise the gesture when a browser tool can synthesize touch (a rendered viewport proves layout, not the gesture), then say what produced the evidence (emulated viewport, synthesized touch, which engine, physical device) and what stayed untested
- **Horizontal scroll**: Content overflow on narrow viewports
- **Text scaling**: Layouts that break when text size increases
diff --git a/cursor-plugin/skills/impeccable/reference/distill.md b/cursor-plugin/skills/impeccable/reference/distill.md
index 757630fae..a49697136 100644
--- a/cursor-plugin/skills/impeccable/reference/distill.md
+++ b/cursor-plugin/skills/impeccable/reference/distill.md
@@ -41,7 +41,7 @@ Expect to say no to good ideas to make room for great execution.
Systematically remove complexity across these dimensions:
### Information Architecture
-- **Reduce scope**: Remove secondary actions, optional features, redundant information
+- **Reduce scope**: Remove secondary actions, redundant information
- **Progressive disclosure**: Hide complexity behind clear entry points (accordions, modals, step-through flows)
- **Combine related actions**: Merge similar buttons, consolidate forms, group related content
- **Clear hierarchy**: ONE primary action, few secondary actions, everything else tertiary or hidden
@@ -70,11 +70,11 @@ Systematically remove complexity across these dimensions:
- **Clear next action**: ONE obvious next action, not five competing ones
### Content Simplification
-- **Shorter copy**: Cut every sentence in half, then do it again
+- **Shorter copy**: Cut filler, not meaning
- **Active voice**: "Save changes" not "Changes will be saved"
- **Remove jargon**: Plain language always wins
- **Scannable structure**: Short paragraphs, bullet points, clear headings
-- **Essential information only**: Remove marketing fluff, legalese, hedging
+- **Essential information only**: Remove marketing fluff, hedging
- **Remove redundant copy**: No headers restating intros, no repeated explanations, say it once
### Code Simplification
diff --git a/cursor-plugin/skills/impeccable/reference/doctor.md b/cursor-plugin/skills/impeccable/reference/doctor.md
index d21b8c452..89440db3e 100644
--- a/cursor-plugin/skills/impeccable/reference/doctor.md
+++ b/cursor-plugin/skills/impeccable/reference/doctor.md
@@ -6,7 +6,7 @@ This is maintenance, not design. Do not redesign anything, do not open files out
Three kinds of drift travel under "out of date". Keep them apart:
-- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it. Not this command's job.
+- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it, or the harness's plugin manager for a plugin install. Not this command's job.
- **Schema drift.** An artifact was written by an older Impeccable: fields nothing reads, fields now expected, files in retired locations. Mechanical, and this command repairs most of it.
- **Truth drift.** The code moved on and the document no longer describes it. No file comparison settles this. `document` owns DESIGN.md, `init` owns PRODUCT.md, and this command's job is to hand them a specific gap rather than a vague suspicion.
diff --git a/cursor-plugin/skills/impeccable/reference/document.md b/cursor-plugin/skills/impeccable/reference/document.md
index 9da0bc743..ec75b7cc7 100644
--- a/cursor-plugin/skills/impeccable/reference/document.md
+++ b/cursor-plugin/skills/impeccable/reference/document.md
@@ -17,10 +17,10 @@ colors:
typography:
display:
fontFamily: "Cormorant Garamond, Georgia, serif"
- fontSize: "clamp(2.5rem, 7vw, 4.5rem)"
+ fontSize: "4.5rem"
fontWeight: 300
lineHeight: 1
- letterSpacing: "normal"
+ letterSpacing: "0em"
body:
# ...
rounded:
@@ -325,7 +325,7 @@ If the project has **no component library yet** (bare landing page, new project)
#### Tonal ramps
-For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue and chroma, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
+For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue, chroma reduced near white and black, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
#### Narrative mapping
diff --git a/cursor-plugin/skills/impeccable/reference/live.md b/cursor-plugin/skills/impeccable/reference/live.md
index ed02659a8..8f0e0d1f5 100644
--- a/cursor-plugin/skills/impeccable/reference/live.md
+++ b/cursor-plugin/skills/impeccable/reference/live.md
@@ -158,14 +158,14 @@ Sources in priority order: DESIGN.md's visual system fields; CSS custom properti
**Default:** compare each variant against the Phase A lock; palette, type voice, or rhetoric drift means it crossed into departure by accident: rework. Then confirm three different primary axes; three "tighter density" variants is failure. **Departure:** two passes, family before sentence. Family pass (non-negotiable): label each variant with a concrete family of your own choosing; shared or interchangeable labels mean rework. Sentence pass: three one-line descriptions side by side; two that rhyme mean rework. When the primary axis is color or theme, the trio must not share theme + dominant hue: three color worlds, not three shades.
-**Action-specific invocations** must vary along the action's dimension:
+**Action-specific invocations** must vary along the action's dimension; in default mode every variation stays within the available faces and existing tokens:
- `bolder`: amplify a different dimension per variant (scale / saturation / structural change).
- `quieter`: pull back a different dimension (color / ornament / spacing).
- `distill`: remove a different class of excess (visual noise / redundant content / nested structure).
- `polish`: a different refinement axis (rhythm / hierarchy / micro-details).
-- `typeset`: different pairing AND different scale ratio each.
-- `colorize`: different hue family each; vary chroma and contrast strategy.
+- `typeset`: departure varies the pairing AND the scale ratio each; default keeps the faces and varies scale ratio, case, and weight each.
+- `colorize`: departure gives each a different hue family and varies chroma and contrast strategy; default gives each a different existing palette role carrying the surface (Restrained / Committed / Full palette / Drenched) and a different contrast strategy.
- `layout`: different structural arrangement, not spacing tweaks.
- `adapt`: different target context per variant (mobile-first / tablet / desktop / print or low-data).
- `animate`: different motion vocabulary (cascade stagger / clip wipe / scale-and-focus / morph / parallax).
diff --git a/cursor-plugin/skills/impeccable/reference/optimize.md b/cursor-plugin/skills/impeccable/reference/optimize.md
index e747f6f7d..79acc428c 100644
--- a/cursor-plugin/skills/impeccable/reference/optimize.md
+++ b/cursor-plugin/skills/impeccable/reference/optimize.md
@@ -38,7 +38,6 @@ Create systematic improvement plan:
src="hero.webp"
srcset="hero-400.webp 400w, hero-800.webp 800w, hero-1200.webp 1200w"
sizes="(max-width: 400px) 400px, (max-width: 800px) 800px, 1200px"
- loading="lazy"
alt="Hero image"
/>
```
diff --git a/cursor-plugin/skills/impeccable/reference/visualize.md b/cursor-plugin/skills/impeccable/reference/visualize.md
index 731165e74..e93be4ba0 100644
--- a/cursor-plugin/skills/impeccable/reference/visualize.md
+++ b/cursor-plugin/skills/impeccable/reference/visualize.md
@@ -26,7 +26,7 @@ Each comp is a direction test, not a screenshot specification. Core UI text, res
Show the three together on the decision page (`impeccable serve-question`, one option per comp with the comp as its hero), or in the harness only when it renders images inline; a text-only surface does not count as display. Ask what should carry forward, what feels false to the world, and whether the selected concept should be approved, combined, revised, or rejected. Then stop and wait. A structured simulated user counts as attended and receives the same question.
-Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md, and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
+Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md (the chosen direction on a new world), and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
This approval point has no substitute and no skip condition. When the structured question tool errors, fall back to the decision page; only after both fail may you treat the choice as delegated, and a delegated pick is recorded exactly as an approval is and disclosed in your first reply, not your last. The finish reviewer treats comp-round comps with no recorded approval as a material finding; decision comps under `.impeccable/mocks/decision/` are the direction round's hand, not comp-round output, and imply no approval on their own.
diff --git a/cursor-plugin/skills/impeccable/scripts/command-metadata.json b/cursor-plugin/skills/impeccable/scripts/command-metadata.json
index 89891ea4d..4686bb6de 100644
--- a/cursor-plugin/skills/impeccable/scripts/command-metadata.json
+++ b/cursor-plugin/skills/impeccable/scripts/command-metadata.json
@@ -4,7 +4,7 @@
"argumentHint": "[feature description]"
},
"init": {
- "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); offers DESIGN.md (visual: colors, typography, components) when code exists; pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
+ "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
"argumentHint": ""
},
"document": {
@@ -88,7 +88,7 @@
"argumentHint": "[target]"
},
"shape": {
- "description": "Plan UX and UI before code. Runs a required multi-round discovery interview, uses visual probes when available, and produces a user-confirmed design brief for implementation.",
+ "description": "Plan UX and UI before code. Runs a discovery interview (one round by default), uses visual probes when available, and produces a user-confirmed design brief for implementation.",
"argumentHint": "[feature to shape]"
},
"typeset": {
diff --git a/cursor-plugin/skills/impeccable/scripts/live-browser.js b/cursor-plugin/skills/impeccable/scripts/live-browser.js
index 504e75b9c..a63f1abe2 100644
--- a/cursor-plugin/skills/impeccable/scripts/live-browser.js
+++ b/cursor-plugin/skills/impeccable/scripts/live-browser.js
@@ -3271,6 +3271,14 @@
const P = paramsPanelPalette || barPaletteForTheme(detectPageTheme());
paramsPanelBody.innerHTML = '';
for (const p of params) {
+ // A knob the panel shows must be in the live values and on the variant,
+ // or accept drops it and the preview ignores it. Seed only missing keys
+ // so a reopen keeps edits.
+ if (!Object.hasOwn(paramsCurrentValues, p.id)) {
+ paramsCurrentValues[p.id] = p.default;
+ applyParamValue(variantEl, p, p.default);
+ }
+ const value = paramsCurrentValues[p.id];
const row = el('div', { display: 'flex', flexDirection: 'column', gap: '6px' });
const labelRow = el('div', {
display: 'flex', justifyContent: 'space-between',
@@ -3295,7 +3303,7 @@
input.min = String(p.min != null ? p.min : 0);
input.max = String(p.max != null ? p.max : 1);
input.step = String(p.step != null ? p.step : 0.05);
- input.value = String(p.default);
+ input.value = String(value);
Object.assign(input.style, {
width: '100%', accentColor: C.brand, cursor: 'pointer',
});
@@ -3310,7 +3318,7 @@
});
row.appendChild(input);
} else if (p.kind === 'toggle') {
- const initial = !!p.default;
+ const initial = !!value;
readout.textContent = initial ? 'On' : 'Off';
const track = el('button', {
position: 'relative', width: '36px', height: '20px',
@@ -3344,8 +3352,8 @@
const opts = (p.options || []).map(o =>
typeof o === 'string' ? { value: o, label: o } : o
);
- const activeOpt = opts.find(o => o.value === p.default) || opts[0];
- readout.textContent = activeOpt ? activeOpt.label : String(p.default);
+ const activeOpt = opts.find(o => o.value === value) || opts[0];
+ readout.textContent = activeOpt ? activeOpt.label : String(value);
const segRow = el('div', {
display: 'grid',
gridTemplateColumns: 'repeat(' + opts.length + ', 1fr)',
@@ -3354,7 +3362,7 @@
});
const segBtns = [];
opts.forEach(o => {
- const active = o.value === p.default;
+ const active = o.value === value;
const b = el('button', {
padding: '5px 4px', border: 'none', borderRadius: '3px',
background: active ? C.brand : 'transparent',
@@ -4988,8 +4996,8 @@
const variantEl = getVisibleVariantEl();
const params = parseVariantParams(variantEl);
if (!variantEl || params.length === 0) return;
- // Build fresh to ensure the current variant's controls are shown.
- applyParamDefaults(variantEl, params);
+ // Rebuild the controls from the current values. Defaults are applied
+ // when the variant is initialized, not when its Tune panel is reopened.
buildParamsPanel(variantEl, params);
tuneOpen = true;
showParamsPanel();
diff --git a/plugin/skills/impeccable/reference/android.md b/plugin/skills/impeccable/reference/android.md
index 1f67a6bb5..32a5cf7cc 100644
--- a/plugin/skills/impeccable/reference/android.md
+++ b/plugin/skills/impeccable/reference/android.md
@@ -42,5 +42,5 @@ Would a fluent Android user trust this app, or trip on off-spec components? The
## Verifying the build
- **Screenshots come from the emulator or a connected device, never a browser.** Build and install, then capture with `adb exec-out screencap -p > <path>` (pick a device with `adb -s <serial>` when several are attached). Capture every device class the app ships to, at least one phone and, when tablets are a target, one tablet, and write the files where the review flow expects them.
-- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (restore `1.0` after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
+- **Dark theme and font scale belong in the pass.** `adb shell cmd uimode night yes` flips the theme; `adb shell settings put system font_scale 1.3` (read both settings first with `adb shell cmd uimode night` and `adb shell settings get system font_scale`, and restore them after) catches the clipped labels a fixed layout hides; with several targets attached, the capture's `-s <serial>` goes on these commands too.
- **Emulators give breadth; gestures, refresh rates, and performance need hardware.** Say which one produced the evidence.
diff --git a/plugin/skills/impeccable/reference/audit.md b/plugin/skills/impeccable/reference/audit.md
index 896ac8c61..b082c5a63 100644
--- a/plugin/skills/impeccable/reference/audit.md
+++ b/plugin/skills/impeccable/reference/audit.md
@@ -11,7 +11,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
### 1. Accessibility (A11y)
**Check for**:
-- **Contrast issues**: Text contrast ratios < 4.5:1 (or 7:1 for AAA)
+- **Contrast issues**: Text contrast ratios < 4.5:1, or < 3:1 for large text (or 7:1 for AAA)
- **Motion sensitivity**: `prefers-reduced-motion` needs an intentional alternative that preserves state change and hierarchy; flag a global `0.01ms` kill that destroys useful feedback, flashing above threshold, and motion that blocks focus, reading, or task completion
- **Missing ARIA**: Interactive elements without proper roles, labels, or states
- **Keyboard navigation**: Missing focus indicators, illogical tab order, keyboard traps
@@ -47,7 +47,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
**Check for**:
- **Fixed widths**: Hard-coded widths that break on mobile
-- **Touch targets**: Interactive elements < 44x44px
+- **Touch targets**: Interactive elements < 44x44px. WCAG AA (SC 2.5.8) requires at least 24x24 CSS px unless an exception applies: spacing, an equivalent control, inline text, user-agent styling, or an essential size. Spacing passes when a 24 CSS px circle centered on the target's bounding box overlaps no other target and no other undersized target's circle
- **Broken touch interaction**: Custom sliders, drag surfaces, and scrollable control strips whose primary gesture fails under touch, that swallow page scroll or lose the drag to it, or that stay stuck after an interrupted gesture. Code tells: mouse-only handlers, no `touch-action` on a pointer-event drag surface, drag state that nothing clears on cancel, lost capture, or blur. Exercise the gesture when a browser tool can synthesize touch (a rendered viewport proves layout, not the gesture), then say what produced the evidence (emulated viewport, synthesized touch, which engine, physical device) and what stayed untested
- **Horizontal scroll**: Content overflow on narrow viewports
- **Text scaling**: Layouts that break when text size increases
diff --git a/plugin/skills/impeccable/reference/distill.md b/plugin/skills/impeccable/reference/distill.md
index 6943c965b..d7c525d92 100644
--- a/plugin/skills/impeccable/reference/distill.md
+++ b/plugin/skills/impeccable/reference/distill.md
@@ -41,7 +41,7 @@ Expect to say no to good ideas to make room for great execution.
Systematically remove complexity across these dimensions:
### Information Architecture
-- **Reduce scope**: Remove secondary actions, optional features, redundant information
+- **Reduce scope**: Remove secondary actions, redundant information
- **Progressive disclosure**: Hide complexity behind clear entry points (accordions, modals, step-through flows)
- **Combine related actions**: Merge similar buttons, consolidate forms, group related content
- **Clear hierarchy**: ONE primary action, few secondary actions, everything else tertiary or hidden
@@ -70,11 +70,11 @@ Systematically remove complexity across these dimensions:
- **Clear next action**: ONE obvious next action, not five competing ones
### Content Simplification
-- **Shorter copy**: Cut every sentence in half, then do it again
+- **Shorter copy**: Cut filler, not meaning
- **Active voice**: "Save changes" not "Changes will be saved"
- **Remove jargon**: Plain language always wins
- **Scannable structure**: Short paragraphs, bullet points, clear headings
-- **Essential information only**: Remove marketing fluff, legalese, hedging
+- **Essential information only**: Remove marketing fluff, hedging
- **Remove redundant copy**: No headers restating intros, no repeated explanations, say it once
### Code Simplification
diff --git a/plugin/skills/impeccable/reference/doctor.md b/plugin/skills/impeccable/reference/doctor.md
index d21b8c452..89440db3e 100644
--- a/plugin/skills/impeccable/reference/doctor.md
+++ b/plugin/skills/impeccable/reference/doctor.md
@@ -6,7 +6,7 @@ This is maintenance, not design. Do not redesign anything, do not open files out
Three kinds of drift travel under "out of date". Keep them apart:
-- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it. Not this command's job.
+- **Tool version.** The installed skill is older than the published one. `impeccable context` reports that at boot as `UPDATE_AVAILABLE` and `npx impeccable update` fixes it, or the harness's plugin manager for a plugin install. Not this command's job.
- **Schema drift.** An artifact was written by an older Impeccable: fields nothing reads, fields now expected, files in retired locations. Mechanical, and this command repairs most of it.
- **Truth drift.** The code moved on and the document no longer describes it. No file comparison settles this. `document` owns DESIGN.md, `init` owns PRODUCT.md, and this command's job is to hand them a specific gap rather than a vague suspicion.
diff --git a/plugin/skills/impeccable/reference/document.md b/plugin/skills/impeccable/reference/document.md
index b5e50d5ed..879ba4e86 100644
--- a/plugin/skills/impeccable/reference/document.md
+++ b/plugin/skills/impeccable/reference/document.md
@@ -17,10 +17,10 @@ colors:
typography:
display:
fontFamily: "Cormorant Garamond, Georgia, serif"
- fontSize: "clamp(2.5rem, 7vw, 4.5rem)"
+ fontSize: "4.5rem"
fontWeight: 300
lineHeight: 1
- letterSpacing: "normal"
+ letterSpacing: "0em"
body:
# ...
rounded:
@@ -325,7 +325,7 @@ If the project has **no component library yet** (bare landing page, new project)
#### Tonal ramps
-For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue and chroma, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
+For each color token, generate an 8-step `tonalRamp` array: dark to light, same hue, chroma reduced near white and black, stepped lightness from ~15% to ~95%. The panel renders this as a strip under the swatch. If the project already defines a tonal scale (Material `surface-container-low` family, Tailwind-style `blue-50..blue-900`), use those values. Otherwise synthesize in OKLCH.
#### Narrative mapping
diff --git a/plugin/skills/impeccable/reference/live.md b/plugin/skills/impeccable/reference/live.md
index ed02659a8..8f0e0d1f5 100644
--- a/plugin/skills/impeccable/reference/live.md
+++ b/plugin/skills/impeccable/reference/live.md
@@ -158,14 +158,14 @@ Sources in priority order: DESIGN.md's visual system fields; CSS custom properti
**Default:** compare each variant against the Phase A lock; palette, type voice, or rhetoric drift means it crossed into departure by accident: rework. Then confirm three different primary axes; three "tighter density" variants is failure. **Departure:** two passes, family before sentence. Family pass (non-negotiable): label each variant with a concrete family of your own choosing; shared or interchangeable labels mean rework. Sentence pass: three one-line descriptions side by side; two that rhyme mean rework. When the primary axis is color or theme, the trio must not share theme + dominant hue: three color worlds, not three shades.
-**Action-specific invocations** must vary along the action's dimension:
+**Action-specific invocations** must vary along the action's dimension; in default mode every variation stays within the available faces and existing tokens:
- `bolder`: amplify a different dimension per variant (scale / saturation / structural change).
- `quieter`: pull back a different dimension (color / ornament / spacing).
- `distill`: remove a different class of excess (visual noise / redundant content / nested structure).
- `polish`: a different refinement axis (rhythm / hierarchy / micro-details).
-- `typeset`: different pairing AND different scale ratio each.
-- `colorize`: different hue family each; vary chroma and contrast strategy.
+- `typeset`: departure varies the pairing AND the scale ratio each; default keeps the faces and varies scale ratio, case, and weight each.
+- `colorize`: departure gives each a different hue family and varies chroma and contrast strategy; default gives each a different existing palette role carrying the surface (Restrained / Committed / Full palette / Drenched) and a different contrast strategy.
- `layout`: different structural arrangement, not spacing tweaks.
- `adapt`: different target context per variant (mobile-first / tablet / desktop / print or low-data).
- `animate`: different motion vocabulary (cascade stagger / clip wipe / scale-and-focus / morph / parallax).
diff --git a/plugin/skills/impeccable/reference/optimize.md b/plugin/skills/impeccable/reference/optimize.md
index 5c55a1642..3f3fc7c33 100644
--- a/plugin/skills/impeccable/reference/optimize.md
+++ b/plugin/skills/impeccable/reference/optimize.md
@@ -38,7 +38,6 @@ Create systematic improvement plan:
src="hero.webp"
srcset="hero-400.webp 400w, hero-800.webp 800w, hero-1200.webp 1200w"
sizes="(max-width: 400px) 400px, (max-width: 800px) 800px, 1200px"
- loading="lazy"
alt="Hero image"
/>
```
diff --git a/plugin/skills/impeccable/reference/visualize.md b/plugin/skills/impeccable/reference/visualize.md
index 731165e74..e93be4ba0 100644
--- a/plugin/skills/impeccable/reference/visualize.md
+++ b/plugin/skills/impeccable/reference/visualize.md
@@ -26,7 +26,7 @@ Each comp is a direction test, not a screenshot specification. Core UI text, res
Show the three together on the decision page (`impeccable serve-question`, one option per comp with the comp as its hero), or in the harness only when it renders images inline; a text-only surface does not count as display. Ask what should carry forward, what feels false to the world, and whether the selected concept should be approved, combined, revised, or rejected. Then stop and wait. A structured simulated user counts as attended and receives the same question.
-Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md, and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
+Do not begin code until the user approves a direction or explicitly delegates the choice. If they delegate, choose using the task brief, PRODUCT.md, and DESIGN.md (the chosen direction on a new world), and state the evidence. Approval refines the task concept; it does not modify DESIGN.md.
This approval point has no substitute and no skip condition. When the structured question tool errors, fall back to the decision page; only after both fail may you treat the choice as delegated, and a delegated pick is recorded exactly as an approval is and disclosed in your first reply, not your last. The finish reviewer treats comp-round comps with no recorded approval as a material finding; decision comps under `.impeccable/mocks/decision/` are the direction round's hand, not comp-round output, and imply no approval on their own.
diff --git a/plugin/skills/impeccable/scripts/command-metadata.json b/plugin/skills/impeccable/scripts/command-metadata.json
index 89891ea4d..4686bb6de 100644
--- a/plugin/skills/impeccable/scripts/command-metadata.json
+++ b/plugin/skills/impeccable/scripts/command-metadata.json
@@ -4,7 +4,7 @@
"argumentHint": "[feature description]"
},
"init": {
- "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); offers DESIGN.md (visual: colors, typography, components) when code exists; pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
+ "description": "Sets up a project for impeccable. Runs a multi-round discovery interview when context is missing and writes PRODUCT.md (strategic: users, brand, principles); pre-configures live mode; then recommends the best commands to run next. Every other command reads these files before doing work. Use once per project.",
"argumentHint": ""
},
"document": {
@@ -88,7 +88,7 @@
"argumentHint": "[target]"
},
"shape": {
- "description": "Plan UX and UI before code. Runs a required multi-round discovery interview, uses visual probes when available, and produces a user-confirmed design brief for implementation.",
+ "description": "Plan UX and UI before code. Runs a discovery interview (one round by default), uses visual probes when available, and produces a user-confirmed design brief for implementation.",
"argumentHint": "[feature to shape]"
},
"typeset": {
diff --git a/plugin/skills/impeccable/scripts/live-browser.js b/plugin/skills/impeccable/scripts/live-browser.js
index 504e75b9c..a63f1abe2 100644
--- a/plugin/skills/impeccable/scripts/live-browser.js
+++ b/plugin/skills/impeccable/scripts/live-browser.js
@@ -3271,6 +3271,14 @@
const P = paramsPanelPalette || barPaletteForTheme(detectPageTheme());
paramsPanelBody.innerHTML = '';
for (const p of params) {
+ // A knob the panel shows must be in the live values and on the variant,
+ // or accept drops it and the preview ignores it. Seed only missing keys
+ // so a reopen keeps edits.
+ if (!Object.hasOwn(paramsCurrentValues, p.id)) {
+ paramsCurrentValues[p.id] = p.default;
+ applyParamValue(variantEl, p, p.default);
+ }
+ const value = paramsCurrentValues[p.id];
const row = el('div', { display: 'flex', flexDirection: 'column', gap: '6px' });
const labelRow = el('div', {
display: 'flex', justifyContent: 'space-between',
@@ -3295,7 +3303,7 @@
input.min = String(p.min != null ? p.min : 0);
input.max = String(p.max != null ? p.max : 1);
input.step = String(p.step != null ? p.step : 0.05);
- input.value = String(p.default);
+ input.value = String(value);
Object.assign(input.style, {
width: '100%', accentColor: C.brand, cursor: 'pointer',
});
@@ -3310,7 +3318,7 @@
});
row.appendChild(input);
} else if (p.kind === 'toggle') {
- const initial = !!p.default;
+ const initial = !!value;
readout.textContent = initial ? 'On' : 'Off';
const track = el('button', {
position: 'relative', width: '36px', height: '20px',
@@ -3344,8 +3352,8 @@
const opts = (p.options || []).map(o =>
typeof o === 'string' ? { value: o, label: o } : o
);
- const activeOpt = opts.find(o => o.value === p.default) || opts[0];
- readout.textContent = activeOpt ? activeOpt.label : String(p.default);
+ const activeOpt = opts.find(o => o.value === value) || opts[0];
+ readout.textContent = activeOpt ? activeOpt.label : String(value);
const segRow = el('div', {
display: 'grid',
gridTemplateColumns: 'repeat(' + opts.length + ', 1fr)',
@@ -3354,7 +3362,7 @@
});
const segBtns = [];
opts.forEach(o => {
- const active = o.value === p.default;
+ const active = o.value === value;
const b = el('button', {
padding: '5px 4px', border: 'none', borderRadius: '3px',
background: active ? C.brand : 'transparent',
@@ -4988,8 +4996,8 @@
const variantEl = getVisibleVariantEl();
const params = parseVariantParams(variantEl);
if (!variantEl || params.length === 0) return;
- // Build fresh to ensure the current variant's controls are shown.
- applyParamDefaults(variantEl, params);
+ // Rebuild the controls from the current values. Defaults are applied
+ // when the variant is initialized, not when its Tune panel is reopened.
buildParamsPanel(variantEl, params);
tuneOpen = true;
showParamsPanel();