mixdog 1.0.11 → 1.1.0

package/src/defaults/skills/pptx/references/concepts.md

@@ -0,0 +1,168 @@
+# Design concepts
+
+Optional inspiration for decks, Word documents, PDFs, and Excel report sheets. The model designs from the request and content; it does not have to select an entry here. These examples group palette, type, headings, tables, emphasis, charts, chrome, and density to illustrate possibilities, not to prescribe templates or acceptable styles.
+
+Every palette formula, face menu, ratio, and treatment below is a reference example. Adapt, combine, or ignore it; no catalogue id, prescribed colour scheme, or difference from an unrelated document is required.
+
+## 1. How to use the examples
+- Start with what the reader needs to understand, decide, or fill in and how they will use the file.
+- Preserve supplied templates, brand requirements, and the conventions of files being edited.
+- `concept:` may describe a design intent in free text or be omitted; it is not a quality gate.
+- Share facts and requested identity across a package, while adapting each format's structure to its job.
+- Reuse a layout when it helps comparison or a series; vary it when the content needs a different reading path. Novelty alone is not a goal.
+- If comparing directions resolves a real uncertainty, compare representative rendered pages for reader understanding, not catalogue membership.
+- Names such as `ink`, `line`, and `accent` in recipes mean roles in the author's palette, not compulsory values from this file.
+
+## 2. Palette roles and deriving them
+Roles: `paper` (the page ground), `ink` (body and headings), `muted` (captions, labels, sources), `line` (rules and hairlines), `tint` (a quiet field behind a callout, band, or banded row), `accent` (the one colour with one job — the claim, the key figure, the subject's mark), and optionally `accent2` (a second voice with its own job: the alert, the comparison series, the second subject). Hex is six digits; in CSS `#`, in office operations without. Contrast: body ink on paper ≥ 4.5:1, `muted` ≥ 4.5:1 for text, accent as text ≥ 4.5:1 (`direction.md` §5).
+
+Start from a **seed hue** (the subject, the brand, the mood), then pick a scheme — vary it between concepts and artifacts, do not always take the complement:
+| Scheme | accent hue vs seed | Reads as | Fits |
+|---|---|---|---|
+| mono | the seed itself, one saturation step above the neutrals | calm, disciplined | quiet-minimal, letter-memo, formal-report |
+| analogous | seed ± 20-40° | cohesive, warm or cool throughout | formal-report, technical-reference, data-dashboard |
+| complement | seed + 180° | high contrast, one loud mark | keynote-statement, brand-campaign, editorial-magazine |
+| split | seed + 150° and + 210° (accent and accent2) | lively, still ordered | data-dashboard, brand-campaign, dark-tech |
+
+Derivation, with the seed hue h: `paper` = h at S 2-8%, L 97-100% (a dark concept: S 10-25%, L 5-10%); `ink` = h at S 15-30%, L 8-16% (dark concept: L 90-96%); `muted` = h at S 10-20%, L 38-46% (dark: L 60-68%); `line` = h at S 8-15%, L 84-90% (dark: L 16-22%); `tint` = the accent's hue at S 25-45%, L 93-96% (dark: L 10-14%); `accent` = S 55-85%, L 32-48% for text use, the same hue a step brighter (L ≈ 50%) for a mark that carries no type; `accent2` the same recipe at its own hue. Neutrals are tinted toward the seed, never pure 000000/FFFFFF unless the concept is a statement or a form. A state colour (good / caution / bad) is a separate, fixed hue pair — green and red words beside their glyph — not the accent.
+
+## 3. The concepts
+Each entry: **Fits** (signals) · **Palette** (scheme and one example) · **Type** (Korean / Latin) · **Heading** · **Table** · **Emphasis** · **Chart** · **Chrome** · **Density**. Faces are installed with Windows/Office or are the provisioned Noto families (§5).
+
+### formal-report
+- **Fits**: a board, regulator, client, or committee reading at a desk; decisions, audits, annual or quarterly reports, proposals with evidence; the reader may file it.
+- **Palette**: mono or analogous. `paper FFFFFF · ink 1C2321 · muted 5E6A66 · line D3DAD6 · tint E8F0ED · accent 1F5E4B` (seed 160°).
+- **Type**: Korean Noto Sans KR or Malgun Gothic, headings bold; Latin Calibri or Segoe UI. A serif body (Noto Serif KR / Cambria) suits a legal or academic variant.
+- **Heading**: numbered assertion headings, bold, a step per level; title block left-aligned with a rule under it.
+- **Table**: bold header on a rule, hairlines between rows, figures right-aligned, a total row set apart; a tint band only on the header when the callout uses the same tint.
+- **Emphasis**: a boxed note or tinted band for the conclusion — or none; the finding can lead as the first paragraph in bold.
+- **Chart**: quiet bars/lines, direct value labels, the subject in `accent`, the rest `muted`/`line`.
+- **Chrome**: running head and "n / N" folio are right for a long, filed document; a short one needs only a folio or nothing.
+- **Density**: dense, 30-40 Hangul characters per line, generous heading space.
+
+### editorial-magazine
+- **Fits**: features, newsletters, thought-leadership, annual-review stories, explainers written to be read for pleasure; a point of view and a narrative, not a decision table.
+- **Palette**: complement or split, one saturated accent used large. `paper FFFFFF · ink 161616 · muted 6A6A6A · line CFCFCB · tint F1EEE8 · accent C8102E · accent2 0B3C5D`.
+- **Type**: serif display over sans body — Korean Noto Serif KR headings, Noto Sans KR body; Latin Georgia or Cambria headings, Calibri body. A large size contrast (headline 4× body on the opener).
+- **Heading**: oversized opener, a deck line, section heads in the serif; drop cap or a numeral as the anchor; a short kicker is allowed where it names something, not over every heading.
+- **Table**: open — no vertical rules, thin rule under the header only, generous row space; used sparingly.
+- **Emphasis**: pull quote across the column, a margin note, an oversized numeral; no callout box.
+- **Chart**: annotated on the data (a labelled event, a bracket), accent on the point the story turns on.
+- **Chrome**: folio and section name small at the foot, or only on the inside edge; none on the opener.
+- **Density**: airy, 2-column or measure-limited text with side column; images carry pages.
+
+### data-dashboard
+- **Fits**: operational status, KPI reviews, monitoring, a surface scanned in under a minute and returned to; many figures, few paragraphs.
+- **Palette**: analogous with a warm `accent2` reserved for the alert. `paper F4F6F8 (canvas) · card FFFFFF · ink 0F1B2D · muted 5A677A · line DCE1E8 · tint E6EEF8 · accent 0A7EA4 · accent2 F2A33A`.
+- **Type**: Korean Noto Sans KR / Malgun Gothic; Latin Segoe UI with tabular figures (`font-variant-numeric: tabular-nums`); big numerals in bold.
+- **Heading**: small, functional labels over modules; the page title short.
+- **Table**: compact rows, zebra or hairline, sparkline/bar cells, status cell with word + glyph; figures right-aligned.
+- **Emphasis**: KPI cards (figure over label, delta beside it), the one off-target figure in `accent2`.
+- **Chart**: several small charts on a grid sharing scales; direct labels; light grid allowed.
+- **Chrome**: a header strip with period and refresh date; a footer source line; no folio on a one-screen sheet.
+- **Density**: high; cards on a grid with a consistent gutter.
+
+### quiet-minimal
+- **Fits**: considered internal notes, design or research write-ups, product principles, anything where restraint signals confidence and the content is short.
+- **Palette**: mono; the accent is barely above the neutrals or equals ink. `paper FFFFFF · ink 222222 · muted 8A8A8A · line E6E6E6 · tint F6F6F6 · accent 3A5A78`.
+- **Type**: one family — Korean Noto Sans KR (regular body, bold heading); Latin Calibri Light / Segoe UI Light for headings where light weights exist, regular elsewhere.
+- **Heading**: modest size, weight and space do the work; no rules, no labels.
+- **Table**: no fills, one hairline under the header, wide row spacing; or a list instead of a table.
+- **Emphasis**: a bold sentence or an indented paragraph; no boxes.
+- **Chart**: single series, one accent point, no axis lines.
+- **Chrome**: none, or a lone page number in `muted`.
+- **Density**: low; wide margins, short lines, more white than ink.
+
+### keynote-statement
+- **Fits**: a pitch, a launch, a vision or all-hands deck, a poster or one-page announcement; one claim per page, read from a distance or in seconds.
+- **Palette**: complement, high contrast, large flat fields. `paper FFFFFF · ink 0B0B0B · muted 6B6B6B · line E2E2E2 · tint FFF1EB · accent FF4F1F · accent2 FFD400` (or the inverted dark field with `ink` as paper).
+- **Type**: Korean Noto Sans KR ExtraBold (its own family) for display, regular for support; Latin Arial Black or Bahnschrift display with Calibri support; headline-to-body ratio 4-5 on the statement pages only.
+- **Heading**: the claim is the page; one or two lines, broken at a phrase.
+- **Table**: avoided; a three-row comparison at most, large type.
+- **Emphasis**: one phrase of the headline in `accent`, a numeral at hero size, a colour field behind a single sentence.
+- **Chart**: one chart per page, one highlighted bar or point, the takeaway stated in the title.
+- **Chrome**: none, or a tiny brand mark and number in the corner.
+- **Density**: very low; 40-60% of the page deliberately empty.
+
+### letter-memo
+- **Fits**: correspondence, memos, notices, cover letters, minutes, policy statements; a person writes to a person and the text is the point.
+- **Palette**: mono and nearly colourless; one restrained accent for the letterhead only. `paper FFFFFF · ink 202020 · muted 666666 · line BBBBBB · tint F3F3F3 · accent 6B2D3C`.
+- **Type**: serif or conventional — Korean Noto Serif KR or 바탕 (Batang) body, or Malgun Gothic for a modern memo; Latin Cambria, Georgia, or Times New Roman.
+- **Heading**: letterhead/sender block, then the subject line in bold; section labels (if any) are run-in bold.
+- **Table**: a plain ruled grid for a schedule or a list of attendees; top and bottom rule only for short ones.
+- **Emphasis**: bold or underline in the sentence; a numbered list for actions; no callouts.
+- **Chart**: normally none.
+- **Chrome**: sender block and date at the top, "n / N" only past one page; no running head.
+- **Density**: moderate; letter proportions, 1.5-1.7 line height, signature space.
+
+### technical-reference
+- **Fits**: manuals, specs, API or process documentation, runbooks, standards, anything looked up rather than read through, with code, parameters, and warnings.
+- **Palette**: analogous, cool-neutral with a warning hue. `paper FFFFFF · ink 1A1F24 · muted 5C6670 · line C9D1D9 · tint F0F3F6 (code ground) · accent 00796B · accent2 C2410C (warning)`.
+- **Type**: Korean Noto Sans KR / Malgun Gothic; Latin Segoe UI body, Consolas for code, names, and parameters (the Korean text stays in its own face).
+- **Heading**: numbered sections (1.2.3), bold, stable levels; every section findable.
+- **Table**: full grid or banded rows, a header fill, a parameter / type / meaning layout; monospace in the name column.
+- **Emphasis**: labelled notes (Note / Warning) as boxed notes with a left rule or glyph, code blocks on `tint`.
+- **Chart**: schematic diagrams and flow charts in line work; value charts rare.
+- **Chrome**: running head with document and version, folio "n / N", section name; contents list at the front.
+- **Density**: high and regular; consistent rhythm so the eye can scan.
+
+### form-intake
+- **Fits**: applications, intake and registration forms, checklists, order sheets, inspection records, anything a person fills in.
+- **Palette**: mostly neutral, high contrast, field fills that read as "type here". `paper FFFFFF · ink 1E1E1E · muted 666666 · line 8C8C8C · tint EAF2E3 (fill-in) · accent 2E6B34`.
+- **Type**: Korean Malgun Gothic or Noto Sans KR; Latin Arial or Calibri; labels in `muted` small caps-free sentence case, entered values in `ink`.
+- **Heading**: numbered groups of fields with a short instruction line.
+- **Table**: the form is a table — label cell and entry cell, visible rules (`line`), entry cells on `tint`; checkboxes as real squares.
+- **Emphasis**: required marks, a single instruction box, a signature line.
+- **Chart**: none.
+- **Chrome**: form title and id at top, page "n / N", a return-to line at the foot.
+- **Density**: moderate; entry cells tall enough to write in; nothing decorative.
+
+### brand-campaign
+- **Fits**: brochures, campaign one-pagers, event programmes, product launches, invitations, certificates; the look is the message and a brand or mood exists.
+- **Palette**: the brand's own colours as roles, else complement or split, with a large colour field. `paper FFFDFB · ink 1D1A31 · muted 635F78 · line E9E4EE · tint FDE9E1 · accent E4572E · accent2 17BEBB`.
+- **Type**: the brand face when the recipient has it; otherwise Korean Noto Sans KR ExtraBold display over Noto Sans KR, or Noto Serif KR for a gentler brand; Latin Trebuchet MS, Century Gothic, or Georgia.
+- **Heading**: display type with personality, set against a picture or colour field; sections can change field colour.
+- **Table**: a styled list or two-column spec, a pricing grid with an accented column; rarely a data table.
+- **Emphasis**: a colour field, a badge, a large numeral, a tilted or cropped shape; the call to action as a button-shaped block.
+- **Chart**: infographic-style, illustrated, few numbers, brand colours.
+- **Chrome**: logo/wordmark placement, a footer with contact; no running head.
+- **Density**: varied by page; one page may be a single picture and a line.
+
+### dark-tech
+- **Fits**: engineering and product-technology audiences, developer tools, security, AI or infrastructure briefings, night-mode dashboards; screens rather than paper.
+- **Palette**: dark ground, one luminous accent, `accent2` for a second series. `paper 0B0F14 · ink E8EDF2 · muted 8B97A5 · line 222B36 · tint 131A22 · accent 3DDC97 · accent2 7C5CFF`. Keep the accent off large fields and body text: it is the mark.
+- **Type**: Korean Noto Sans KR; Latin Bahnschrift or Segoe UI, Consolas for labels, figures, and code.
+- **Heading**: bold sans, tight leading, a short monospace label where it names a module or version (not over every heading).
+- **Table**: no fills, `line` rules only, monospaced figures; header in `muted`.
+- **Emphasis**: the accent on one figure or phrase, a thin bracket frame or glow behind one metric; a callout is a `tint` card with a 1 px `line` border.
+- **Chart**: luminous lines on the dark ground, accent for the subject, `muted` for the rest.
+- **Chrome**: small status line at the top or foot (version, date); page number in `muted`.
+- **Density**: medium-high with generous dark margins. For print, invert to a light ground rather than printing the dark field.
+
+## 4. Translation per format
+For the chosen concept, the format carries the same roles with its own anatomy. `STYLE` is the nearest `kit.md` `STYLES` id for the script route (`deck({ style })`), and the HTML route's visual language to start from (`direction.md` §3).
+| Concept | Deck (HTML, 1920 × 1080) | Word document | Flowing PDF | Designed PDF (`section.slide` pages) | Excel report sheet | STYLE |
+|---|---|---|---|---|---|---|
+| formal-report | assertion titles on paper, evidence slides with chart + commentary, text mode; accent on one object per page | numbered headings, boxed note or lead paragraph, ruled tables, running head + folio when long | `@page` running head + folio margin boxes, ruled tables, narrow column + side rail for captions | cover, key-figures page, evidence pages in the sheet's margins; folio in the slide | title block, metric strip, ruled table, one native chart; print area one page wide | data-journalism |
+| editorial-magazine | serif headline over sans, rail or column text, pull-quote and numeral pages, one picture-led page | serif headings, pull quote, two-column section, open tables | `@page` folio at the foot only, columns, drop cap, no boxed notes | full-bleed opener, feature spreads with image and margin note | story-led report: headline cell, short insight cells beside the chart, few tables | editorial |
+| data-dashboard | KPI card rows, small multiples, table + chart, balanced mode | landscape sections with KPI table strip, compact zebra tables, small charts | landscape `@page`, KPI strip, compact tables, header strip | one-screen dashboard page on a grid of cards | KPI cards, charts beside tables, conditional formats; the default archetype for a dashboard | data-journalism |
+| quiet-minimal | few words per slide, wide margins, one accent point | one family, no boxes, space-only hierarchy, no running head | wide margins, no `@page` boxes or a lone folio | sparse pages, one idea each | plain title, a table with one hairline, gridlines off | swiss-minimal |
+| keynote-statement | one claim per slide at display size, colour fields, hero numerals | a poster-like cover page then plain text; rarely long | one-page announcement: large type, a colour band; no margin boxes | full-bleed claim pages, a numeral or phrase in accent | a summary sheet with 3-4 oversized figures; no more | swiss-minimal |
+| letter-memo | rarely a deck; a single "message" slide at most | letterhead block, subject line, plain paragraphs, signature, no running head | the same on letter/A4 with `@page` margins and a folio only past one page | rarely designed; a one-page notice with letterhead | rarely a sheet; a cover note row above a table | swiss-minimal |
+| technical-reference | blueprint diagrams, code panels, text mode | numbered headings, labelled notes, monospace cells, contents field | running head with version, folio, contents list, code blocks on `tint` | architecture diagram pages, reference cards | parameter table, change log, one summary sheet; formulas stay native | blueprint |
+| form-intake | rarely; a checklist slide | fields as tables (label / entry), real checkboxes, instruction box; fill with the native route when it is a template | printed form with ruled entry cells | not used for fillable forms (the browser prints controls as pictures) | input sheet: legend, example row, validation, unlocked fill cells | soft-rounded |
+| brand-campaign | colour-field pages, picture-led, badge and big numeral, CTA closing | brochure-like cover, colour band headings, styled lists; limited by Word's flow | folded-leaflet style with named cover `@page`, bands, no margin boxes | full-bleed designed pages, field colours change per spread | a branded summary sheet with colour header and a few charts | photo-editorial |
+| dark-tech | dark theme throughout, glow behind one metric, bracket frames | light variant: dark title band, light body (Word prints on white); `tint` code panels | light ground for print; dark cover page via named `@page` | dark pages for screen reading | dark header band and light grid, accent on the KPIs | dark-tech |
+If the nearest STYLE does not fit the page, use `custom` and write the five columns of `direction.md` §3 yourself.
+
+## 5. Face menu per script
+Faces named here are installed with Windows/Office or are the provisioned Noto families. A PDF embeds the fonts it drew with, so any installed face is safe there. Word, PowerPoint, and Excel write the face name into the file: the runtime warns when a face is not one the recipient is sure to have (an advisory, not a block), and a recipient without it sees a substitute — say so in the delivery, or choose from the safe column.
+| Script / pairing | Display / heading | Body | Figures, code | Notes |
+|---|---|---|---|---|
+| Korean sans | Noto Sans KR (700), Noto Sans KR ExtraBold, Malgun Gothic (bold) | Noto Sans KR, Malgun Gothic | same family; Consolas for code | one face for Hangul and digits so the two share a baseline |
+| Korean serif | Noto Serif KR (700), 바탕 (Batang) | Noto Serif KR, 바탕 | same family | Hangul has no italic: use weight, colour, or a rule |
+| Korean mixed | Noto Serif KR headings | Noto Sans KR body | Noto Sans KR | serif display over sans body (editorial); keep the two Latin faces in step with them |
+| Latin sans | Segoe UI Semibold, Bahnschrift, Arial, Trebuchet MS, Century Gothic, Calibri | Calibri, Segoe UI, Arial | tabular figures; Consolas for code | Calibri and Segoe UI are in every Office install |
+| Latin serif | Georgia, Cambria, Palatino Linotype, Times New Roman, Bookman Old Style | Cambria, Georgia | Georgia has old-style figures: use Cambria for tables | serif body suits letters and essays |
+| Latin mixed | Georgia or Cambria heading | Calibri or Segoe UI body | Consolas for labels | the editorial pairing |
+Set Latin and East Asian faces together (Word `name` + `nameEastAsia`, CSS `font-family` listing both). Pair them deliberately: a Latin face beside a Korean face renders figures in the Latin one, and a Hangul line next to Latin digits can print at two apparent sizes — in a Korean-led document with many figures, set both in the Korean face; a distinct Latin face is for headings and Latin-led content.

package/src/defaults/skills/pptx/references/direction.md

@@ -2,7 +2,7 @@
 
 Owns what the deck decides before full-deck composition: who reads it and how (§1), how it argues (§2), how it looks (§3), which direction the representative trial supports (§4), its colors (§5) and type (§6). `composition.md` owns the page, `kit.md` owns the code.
 
-Rule strength: **Hard rule** (objective failure, with its check: `→ runtime \`code\`` when the review raises that code, `→ manual` when only the render shows it), **Default** (a sensible choice; override with a reason), **Reference** (vocabulary; no single right answer). An unlabeled line is a Default.
+This is an optional design reference. Reading modes, palettes, type scales, style menus, and numeric composition targets are examples, not required selections or acceptance criteria. Existing brand requirements, faithful content, legibility, and format constraints take precedence. No style score can replace inspection of the converted pages.
 
 ## 1. Reading mode — decides density before anything else
 **Default — derive from delivery**: live projection and launches lean presentation; async review, approval, and leave-behinds lean text; hybrid review leans balanced.
@@ -45,7 +45,8 @@ A style is shape language, composition geometry, decoration density, whitespace,
 | brutalist | raw structure, heavy rules, irregular columns | masthead numeral crossing column rules; heavy full-bleed rule bars; one grid cell inverted to solid ink as the focal cell | none; weight is the decoration | flat, hard |
 | custom | write the five columns yourself | — | — | — |
 
-**Reference — choosing**: compare the subject's own edge, corner, opening, angle, or layering logic with each style's shape language before settling on rectangles and circles; a topic word never selects a row. Expressive print or hand-drawn looks (zine, memphis, chalkboard, pixel) need prepared artwork the runtime does not have.
+**Reference — choosing**: compare the subject's own edge, corner, opening, angle, or layering logic with each style's shape language before settling on rectangles and circles; a topic word never selects a row. On the script route, expressive print or hand-drawn looks (zine, memphis, chalkboard, pixel) need prepared artwork the kit does not draw; on the HTML route they are CSS, inline SVG, and `images:` plans, and are available (`html.md` §8).
+**Default — a concept is optional guidance, not a gate**: `concepts.md` offers design concepts as a vocabulary. The plan's `concept:` line is optional free text (a concept id and a reason from subject, audience, purpose, or your own words); the runtime does not require it. When you name one, it fixes palette scheme, type pairing, heading, table, emphasis, and chrome; the style below is the nearest kit vocabulary for the script route (`concepts.md` §4 names it per concept). A deck, document, and workbook of one package share whatever direction is chosen.
 
 ## 4. Select from a representative visual trial
 **Default — compare the open decisions on actual pages**: for a new direction, render two materially different compositions of the same representative content before building the whole deck (`review.md`). Each has a coherent reading mode, argument, palette, type, and treatment, but differs in how the message becomes visible. Choose by fidelity and reading clarity, or reject both; do not force a winner or rebuild every page twice. A supplied template, approved direction, or small factual edit skips the trial. Record the candidates and visible reason in the brief (`SKILL.md` §3); runtime candidate-count readings remain advisory.
@@ -57,13 +58,13 @@ A style is shape language, composition geometry, decoration density, whitespace,
 ## 5. Palette — from the subject, through one seed
 **Hard rule — contrast**: body text ≥ 4.5:1; text ≥ 18 pt or bold ≥ 14 pt ≥ 3:1; white on an accent block ≥ 3:1. Accent is never body text. Meaning never rides on color alone. → runtime `low_contrast` (saved colors), `low_visual_contrast` (render); color-only meaning → manual
 **Hard rule — colors are 6 hex digits without `#`**; alpha in the hex corrupts the file (`transparency: 0-100` on fills and images, `opacity: 0-1` on shadows). → runtime package validation fails at finalize
-**Default — one hue family for the neutrals, the accent on its counter hue**: the kit's `palette({ hue })` derives the whole ladder from one seed hue — ink, body, muted, the three lines (lineSubtle, line, lineStrong — `composition.md` §6), paper, paperAlt, dark, darkAlt, onDark, onDarkMuted — with adjacent steps 10-25% apart in lightness and backgrounds within ±20° of the hue, and puts the accent (accent, accentDeep, tint, onDarkAccent) on `counterHue(hue)`: navy 225 → coral 15, indigo 250 → gold 40, forest 125 → amber 25, teal 185 → amber 30, berry 335 → gold 40, terracotta 8 → teal 198. The accent is the deck's second hue and its only saturated color on type and fields, on small areas; a state mark (below) is the one other saturated form. `accentHue: hue` keeps a single-hue deck (swiss-minimal, brutalist, blueprint, a brand that owns one color), and a brief may name any accent hue. Proportion starts at 60/30/10 (field / support / accent). The extremes are tinted, never 000000/FFFFFF.
+**Default — one hue family for the neutrals, the accent on its counter hue**: the kit's `palette({ hue })` derives the whole ladder from one seed hue — ink, body, muted, the three lines (lineSubtle, line, lineStrong — `composition.md` §6), paper, paperAlt, dark, darkAlt, onDark, onDarkMuted — with adjacent steps 10-25% apart in lightness and backgrounds within ±20° of the hue, and puts the accent (accent, accentDeep, tint, onDarkAccent) on `counterHue(hue)` — the complement scheme; `accentHue` overrides it for an analogous, split, or mono scheme, which `concepts.md` §2 says when each fits, so the complement is one choice and not the default of every deck. The accent is the deck's second hue and its only saturated color on type and fields, on small areas; a state mark (below) is the one other saturated form. `accentHue: hue` keeps a single-hue deck (swiss-minimal, brutalist, blueprint, a brand that owns one color), and a brief may name any accent hue. Proportion starts at 60/30/10 (field / support / accent). The extremes are tinted, never 000000/FFFFFF.
 **Default — four state colors, each with a word**: `T.state.positive | warning | critical | informative` say better / caution / worse / note — a verdict cell, a delta, a badge, a callout — and each comes in three forms: `solid` fills a mark (a dot, a delta arrow, a bar), `weak` is the field under a state word, `text` is the word on paper, paperAlt, or its own weak field (each ≥ 4.5:1; solid ≥ 3:1 on paper). The state hues are fixed (green 150, amber 40, red 5, blue 215), not derived from the seed, so a state means the same thing in every deck; a deck uses the states its content has, never all four for variety; a state's word or glyph always stands beside its color (the kit's `tone('positive')` pairs the field and the word for `badge()`, `callout()`, and `table({ verdict, tones })`).
 **Hard rule — a state's solid form never sits under type**: type takes the `text` form (dark, restrained) on the `weak` field; the saturated form is the mark, so the deck's saturated hue on type stays the accent. → runtime `accent_hue_overuse` (saturated hue families on text-bearing shapes)
 **Default — the accent has a type form and a mark form**: `T.accent` is the word (darkened to 4.5:1 on paper — a kicker, an emphasis run, a hero numeral); `T.accentFill` is the mark (S ≥ 0.78, L ≈ 0.5, ≥ 2:1 on paper — the reference marks sit at 1.3-2.6:1) that the one bar, disc, dot, or band takes; a mark that carries type (a badge, an active chevron, a numbered node) takes the `T.accentLabel` pair — the bright fill where white or ink reads on it at 4.5:1, else the type form under white. A bar painted with the type form reads as mud; a word set on a mid amber fails contrast. `T.accentFill` covers 3-20% of a content page and belongs to the object the title names; everything else it could have coloured is `T.mark` gray.
 **Reference — measured colour** (ten frontier decks, September 2026, saturated pixels of every page): each deck has one bright accent that carries 53-98% of its saturated ink (Sequoia green 165°/S 1.0/L 0.3 98%, Evans red 0°/0.75/0.6 94%, Coatue blue 210°/0.75/0.5 93%, Naver green 135°/0.75/0.6 87%, Samsung navy 225°/0.5/0.2 83%, NVIDIA green 75°/0.75/0.4 67%, Kakao yellow 60°/1.0/0.6 39% + a pink 28%); at most two hues exceed 10% of it (Kakao four — a brand with a mascot). Saturated pixels cover 3-22% of a page (median 10%); dark pages are 0-33% of a deck (Samsung a third, NVIDIA 13%, Coatue 10%, most under 5%); pale tinted fields cover under 2% of a page.
 **Default — saturation by area**: large fields S ≤ 20%, text S ≤ 25%, the accent S 60-90% and only on small areas; projected decks read 10-15% more saturated than the screen.
-**Reference — temperature by subject**: tech/finance cool blues (hue 205-240), education/growth greens (100-160), health cyans (170-190), creative/marketing warm oranges and pinks (10-40), academic indigos (230-260). Seeds that have worked: navy 225 + ice accent 210; forest 125 + moss 90; coral 358 + navy 230; terracotta 8 + sage 150; teal 185 + mint 165; berry 335 + cream 40; slate 210 + cherry 350. If the colors would work on any other deck, choose again.
+**Default — how to choose the seed and the scheme**: the seed hue comes from what exists first — the brand's own colour, the product or place the deck is about, a colour in the supplied pictures or screenshots, the mood the concept calls for (`concepts.md`) — and only then from taste. Pick the scheme (mono, analogous, complement, split; `concepts.md` §2) for the concept, not from a subject-to-hue table: no subject owns a hue, and a hue chosen because "finance means blue" is how decks come to look alike. Check it by asking whether the same colours would work on any other deck; if so, choose again. Record the seed, scheme, and reason in the brief's `palette:` field.
 
 ## 6. Typography
 **Default — reliable families first**: Noto Sans/Serif (including KR, SC, TC, JP), Arial, Calibri, Cambria, Times New Roman, Courier New, Bookman Old Style, Century Schoolbook, Malgun Gothic, Microsoft YaHei, and Yu Gothic are practical starting points. Brand fonts are allowed when available to the recipient and renderer. If substitution changes metrics, use a compatible face or leave extra room and disclose the preview limitation; do not claim reliable fit from an approximate render. → runtime `unsafe_font_family`, `font_family_overuse` are compatibility diagnostics

package/src/defaults/skills/pptx/references/html.md

@@ -38,7 +38,7 @@ So the CSS techniques that make a page — a gradient field, a diagonal band, an
 
 ## 4. Text
 - Set `word-break: keep-all; overflow-wrap: break-word` on the slide and `text-wrap: balance` on headlines, `text-wrap: pretty` on prose; wrap a name that must not break (`GPT-5.6 Sol`, `macOS x64와 ARM64`) in `white-space: nowrap`.
-- Faces present on this machine and in Office: `'Noto Sans KR'` (400, 700), `'Noto Sans KR ExtraBold'` (as its own family at weight 400), `'Noto Serif KR'` (700), `'Malgun Gothic'`; Latin safe faces per `direction.md` §6. A recipient without Noto gets a substitute: say so, or use `fonts: safe` faces.
+- Choose installed faces that cover the language and fit the intended use. The optional face examples in `concepts.md` §5 are not a whitelist. A recipient without a face gets a substitute: disclose the risk or use portable faces, then check the actual render.
 - Weight has two steps in PowerPoint: 400 and 700 (a 500 becomes regular).
 - Line height: the converter places every line on the browser's baseline within 1 px for Noto Sans KR, Noto Serif KR and Malgun Gothic from `line-height` 0.9 to 1.5; tighter than 0.9 is unmeasured. Tight display type (0.9-1.05 on 100 px+ headlines, −0.01 to −0.02 em tracking on Latin only) is available; body copy keeps 1.4-1.6.
 - Sizes: body 24 px (12 pt) or more, captions and chrome 20 px (10 pt) or more; no tracking on Hangul beyond 0.05 em.
@@ -48,7 +48,7 @@ So the CSS techniques that make a page — a gradient field, a diagonal band, an
 ```html
 <div class="chart" style="position:absolute;left:860px;top:360px;width:964px;height:140px"
   data-chart='{"type":"bar","labels":["Mixdog","Codex CLI"],"values":[18.5,34.3],
-               "colors":["FF6B3D","B7BDC6"],"max":40,"format":"0.0\"k\"","labelColor":"14181F","size":11}'></div>
+               "colors":["<accent>","<muted>"],"max":40,"format":"0.0\"k\"","labelColor":"<ink>","size":11}'></div>
 ```
 `type`: `bar` (horizontal), `col`, `line`, `area`, `pie`, `doughnut`. `values` for one series or `series: [{ name, values }]` with `legend: true` for several. `colors` 6-digit hex per category (one series) or per series. `max`/`min` fix the value scale, `format` the label number format, `size` the label size in pt, `gap` the bar gap %, `stacked`, `valueAxis: true` to show the value axis, `grid: "HEX"` for gridlines, `hole` for a doughnut. Values are copied from the brief's facts line. Give a bar chart about 70 px of height per category so PowerPoint keeps every category label. `categoryAxis: false` hides the category labels (when the page labels the columns itself).
 
@@ -62,30 +62,9 @@ So the CSS techniques that make a page — a gradient field, a diagonal band, an
 **Hard rule — a generated picture never stands in for evidence**: figures, charts, tables, product UI, and screenshots are never generated; a generated picture is mood, metaphor, or illustration, recorded with its lane, model, and prompt in the slide's `aside.notes`.
 
 ## 8. One-shot design pass
-The user asks once and receives the finished deck; no candidates are shown. **Default — two passes before any HTML**:
-1. **Plan** from the subject and the sources: palette of 4–6 hex values with roles (dominant surface ~60%, secondary ~25%, one accent ~10% with one job, e.g. "marks the product's own figures"); type roles in px (display, title, body, label); one signature motif that recurs cropped or rescaled; margins (96 px) and the grid; one composition per slide.
-2. **Check the plan against the defaults** below and against what any similar request would have produced; revise every axis that is a default rather than a choice for this subject, then write the HTML.
-
-**Default — compositions** (vary them; the same layout never three times in a row): asymmetric 60/40 or 70/30 split; offset grid with a colour band or a giant numeral in the narrow third; hero metric (180 px or more) beside its context; chart with direct annotations and leader lines; full-bleed field with the claim; card cluster of two or three different sizes; annotated artifact (a window, a terminal, a document) with numbered callouts and a legend. Body slides may carry colour fields too, not only the cover and the closing. Page chrome (running head, rule, page number, source line) is small and consistent.
-**Default — how a page holds attention** (principles, not layouts; apply them to whatever composition the plan chose):
-- **One anchor per page**: the first thing the eye lands on is the page's claim — a numeral, a headline, a picture, a chart's marked point — and nothing else competes at its weight. The anchor takes at most about half the canvas; the rest carries its support (the evidence, the context, the consequence).
-- **Three tiers of space**: space inside a unit < space between units < the page margin. When the three are close, grouping disappears; a unit set apart by a large field is isolated on purpose.
-- **Proximity carries relation**: a label sits nearer its value than the next value; a caption nearer its picture than the next block.
-- **Break the rectangle now and then**: about once every three or four pages, one shape that is not a card — a band bled past the edge, a diagonal cut, an edge that fades out, an oversized numeral with no box — made with the CSS in §3.
-- **Material, quietly**: grain, a pattern, or a soft gradient field reads as paper or light at 4-10 % strength; stronger, it is noise. One material per deck.
-- **Decoration never stands in for content**: if removing an ornament loses no information and no structure, remove it.
-
-**Default — the data picks its carrier**:
-| The data | Carrier |
-|---|---|
-| one figure that matters | the numeral at display size with its unit, its comparison (against what, since when), and a source line |
-| a share of a whole | a 100-cell grid, a ring, or a single stacked bar — never a pie of more than three parts |
-| a trend | a line with the event marked on it and a direct series label; no legend when one series |
-| a ranking | sorted horizontal bars, the subject's bar in the accent |
-| a comparison of two states | a split page or a dumbbell, the change written as a number |
-| places | a map or a schematic of the places, the figure on each |
-| steps or a process | connected nodes in reading order, one verb each |
-| a composition of costs | a stacked bar with the parts named in order of size |
+Start from the source material, reader, and viewing conditions. Choose the reading path, type, palette, spacing, and carriers that explain this content, then write the HTML/CSS. A concept id, signature motif, fixed margin, colour ratio, or layout rotation is not required. `concepts.md`, `direction.md`, and `composition.md` are optional inspiration, not a checklist.
+
+Preserve meaningful relationships: labels belong with their values, chart scales and units must be honest, and a comparison must retain the conditions being compared. Use repetition for comparable pages and whitespace for hierarchy where useful. A sparse statement, a dense reference page, and an intentionally repeated series are all valid when readable and complete. Do not add cards, texture, illustrations, or extra layouts just to satisfy a score.
 
 **Hard rule — related positions come from one source and are declared**: a marker on a line, a shape inside a shape, a connector between two blocks, a column that lines up with the row above it, a label centred on its shape — each is computed, never typed as a separate guess: flex or grid for rows and columns, `calc()` on shared custom properties for a gap's centre, related shapes in one SVG from one set of numbers, a line or band that carries markers drawn as an SVG `<line>`, `<polyline>` or `<path>` (a clipped box has no centre line). Then the relation is declared on the element, and the browser proves it before the deck lands:
 | Declaration | Holds when |
@@ -97,9 +76,7 @@ The user asks once and receives the finished deck; no candidates are shown. **De
 | `data-label="#disc"` | it is centred on that shape |
 Ids are the slide's own. Undeclared, the page is still read for the misses a declaration would have caught: peer blocks in one container and one column or row whose visible edges or centres sit 3-24 px apart, a shape whose centre is inside another but which reaches up to 24 px past its edge, a small connector in the gap between two blocks but off its centre, a marker (64 px or less) set on a line, band, or drawing with no relation declared, and words that run partly onto an SVG drawing or a round shape (read against its real fill and stroke, not its frame) or come within 8 px of one several times their size — words wholly on a shape are its label, and a chip or card painted under the words hides what is beneath; a drawing the size of the page is ground. Each is fixed in the HTML or, when the offset is the design, marked `data-free` on the element. Any finding refuses the deck (`reason: geometry_gate`, the findings per slide with their offsets in px); nothing lands until it holds. The eye never certifies a geometric relation the gate can measure. → runtime `geometry_gate`
 
-**Default — self-check before rendering**: *underfill* (a body page under ~120 characters with no carrier is a hollow page — add the evidence or make it a deliberate statement page), *anchor overexpansion* (the anchor swallowed the support), *decorative substitution* (texture and ornament doing the work of structure), *rhythm clone* (the same page grammar three pages running).
-
-**Default — avoid the generated look** unless the brief asks for it: cream `#F4F1EA` with a serif display and a terracotta accent; near-black with one acid-green or vermilion accent; hairlines and dense columns on every page; identical rounded cards with one soft grey shadow; an all-caps tracked label above every heading; meta strings joined with middle dots; monospace data labels; gradient washes as decoration; a glowing orb as the cover's object; icon rows of identical tiles; a uniform card grid; centred everything.
+Before rendering, check that each page answers its intended question and preserves the source content. Judge stylistic choices by this request, not a blacklist of colours, fonts, or shapes. After conversion, inspect the actual Office pages rather than treating attractive HTML or a clean lint report as proof.
 
 ## 9. Review
 `author` returns the audit, the rendered pages, and `render.compare`. Fix what the audit measures and what the pair shows (a line that broke differently, a glyph off its disc, a label PowerPoint dropped) in the HTML and author again — **Default — fix by editing the kept `<deck>.pptx.mixdog-source.html`** with the edit tool and calling `author path:<deck.pptx>` with no `script` (no `overwrite` needed); send the whole document again only when most of it changes; the two-round limit of SKILL.md §2 step 6 applies. Then finalize as SKILL.md §5.

package/src/defaults/skills/pptx/references/kit-index.md

@@ -11,7 +11,7 @@ redefine it or when a default this index does not state decides the page.
 
 Owns the code: primitives that draw what `composition.md` names, sized with `MEASURE` so text never overflows. The kit is a toolbox, not a slide catalog — no function here draws a whole slide, and every position is the author's. Draw every repeated element through one function so the deck stays consistent. Chart and table helpers are in `charts.md`, picture helpers in `pictures.md` §4.
 
-**The runtime runs every code block of this file, `charts.md`, and `pictures.md` before the script** — the script never pastes them. A script opens with the brief, then one `deck({ style, hue, accentHue?, mode, script, pairing, fonts })` call that sets the frame the style chooses, the palette, the faces, the type scale, the zones, and the masters, then the slides. Read the blocks for the signatures and defaults; redefine a helper in the script when a page needs a different one (a later declaration wins). A script that creates its own `pres` runs without the prelude.
+**The runtime runs every code block of this file, `charts.md`, and `pictures.md` before the script** — the script never pastes them. A script opens with the brief, then one `deck({ style, hue, accentHue?, accentMode?, mode, script, pairing, fonts })` call that sets the frame the style chooses, the palette, the faces, the type scale, the zones, and the masters, then the slides. Read the blocks for the signatures and defaults; redefine a helper in the script when a page needs a different one (a later declaration wins). A script that creates its own `pres` runs without the prelude.
 
 **Hard rule — paragraph options sit on the first run**: the runtime keeps one `a:pPr` per paragraph (the first). `bullet`, `align`, `paraSpaceAfter`, `lineSpacingMultiple` go on the text box or on a paragraph's first run; `breakLine: true` on a paragraph's last run. → runtime (absorbed: the normalizer keeps the first `pPr`; nothing to check)
 
@@ -89,7 +89,12 @@ function counterHue(h) { … }
 // at 4.5:1 (a yellow pill carries dark type, a green one white), else the type form of the accent under white (a mid
 // amber or blue can host neither at 12 pt). Charts, arcs, dots, and bars fill with accentFill; a word in the accent,
 // a kicker, an emphasis run, a hero numeral keep `accent`.
-function palette({ hue = 205, accentHue = counterHue(hue), accentSat = 0.72, accentLight = 0.42 } = {}) { … } // returns { ink, body, muted, lineSubtle, line, lineStrong, mark, markSoft, paper, paperAlt, tint, dark, darkAlt, onDark, onDarkMuted, onDarkAccent, accent, accentDeep, accentFill, accentLabel, onAccent, state }
+// accentMode: where the accent sits against the seed when accentHue is not given — 'complement' (the default: counterHue),
+// 'analogous' (seed + 30°), 'split' (counterHue + 30°), 'mono' (the seed itself). warmth (-1..1, default 0) leans every
+// neutral (paper, type, lines, marks) toward amber (+) or blue (-) without moving the seed or the accent.
+function accentFor(seed, mode) { … }
+function warmHue(h, warmth) { … }
+function palette({ hue: seed = 205, accentHue: pickedHue, accentMode = 'complement', accentSat = 0.72, accentLight = 0.42, warmth = 0 } = {}) { … } // returns { ink, body, muted, lineSubtle, line, lineStrong, mark, markSoft, paper, paperAlt, tint, dark, darkAlt, onDark, onDarkMuted, onDarkAccent, accent, accentDeep, accentFill, accentLabel, onAccent, state }
 const T = { ...palette({ hue: 205 }), display: '', sans: '', light: '', data: '' };
 // deck() seeds it from the brief; faces set by typography()
 // Type scale (direction.md §6): the reading mode sets the body anchor; every role derives from it.
@@ -154,6 +159,9 @@ function darkTheme(hue, accentHue = counterHue(hue)) { … }
 // radius, the stroke a rule takes, the motif an anchor repeats, the theme, and whether the accent stays on the seed
 // hue. Passed to deck(), two decks of the same content open on visibly different pages; left out, every deck repeats
 // one frame — the title at the top left, the body under it, the source at the foot — whatever its brief called it.
+// An entry may also carry palette knobs — accentMode ('complement' | 'analogous' | 'split' | 'mono'), accentSat,
+// accentLight, warmth (-1..1) — and its type `pairing`; deck() reads them unless the call names its own. None of the
+// built-in entries sets a knob, so they keep the counter-hue accent.
 // `motifs` is the style's decoration set, not one device: an anchor that names no kind takes the next one, so the
 // cover, the section marks, and the closing of one deck are not the same drawing three times (composition.md §3).
 const STYLES = { swiss-minimal, editorial, photo-editorial, data-journalism, soft-rounded, dark-tech, glassmorphism, blueprint, brutalist, custom } each { chrome, radius, line, motifs, singleHue, pairing, titleBoost, theme };
@@ -169,7 +177,7 @@ let MOTIF_AT = 0;
 // The next device in the deck's set. `motif(s, '', …)` takes it, so two anchors in a row never carry the same
 // drawing; naming a kind (`motif(s, MOTIF, …)`) still wins when the echo is the point (a closing answering its cover).
 function nextMotif() { … }
-function deck({ style = 'custom', hue = 205, accentHue, accentSat, accentLight, mode = 'balanced', script = 'ko', pairing, fonts = 'noto', titleLines = 1, chrome, theme } = {}) { … }
+function deck({ style = 'custom', hue = 205, accentHue, accentMode, accentSat, accentLight, warmth, mode = 'balanced', script = 'ko', pairing, fonts = 'noto', titleLines = 1, chrome, theme } = {}) { … }
 // Page chrome lives on masters, not on slides: the background and, when the deck wants it, the page number.
 // The three masters are defined from the final palette when the first slide is added, never before deck() ran.
 function master(name, background, { number = true, color = T.muted } = {}) { … }

package/src/defaults/skills/pptx/references/kit.md

@@ -2,7 +2,7 @@
 
 Owns the code: primitives that draw what `composition.md` names, sized with `MEASURE` so text never overflows. The kit is a toolbox, not a slide catalog — no function here draws a whole slide, and every position is the author's. Draw every repeated element through one function so the deck stays consistent. Chart and table helpers are in `charts.md`, picture helpers in `pictures.md` §4.
 
-**The runtime runs every code block of this file, `charts.md`, and `pictures.md` before the script** — the script never pastes them. A script opens with the brief, then one `deck({ style, hue, accentHue?, mode, script, pairing, fonts })` call that sets the frame the style chooses, the palette, the faces, the type scale, the zones, and the masters, then the slides. Read the blocks for the signatures and defaults; redefine a helper in the script when a page needs a different one (a later declaration wins). A script that creates its own `pres` runs without the prelude.
+**The runtime runs every code block of this file, `charts.md`, and `pictures.md` before the script** — the script never pastes them. A script opens with the brief, then one `deck({ style, hue, accentHue?, accentMode?, mode, script, pairing, fonts })` call that sets the frame the style chooses, the palette, the faces, the type scale, the zones, and the masters, then the slides. Read the blocks for the signatures and defaults; redefine a helper in the script when a page needs a different one (a later declaration wins). A script that creates its own `pres` runs without the prelude.
 
 **Hard rule — paragraph options sit on the first run**: the runtime keeps one `a:pPr` per paragraph (the first). `bullet`, `align`, `paraSpaceAfter`, `lineSpacingMultiple` go on the text box or on a paragraph's first run; `breakLine: true` on a paragraph's last run. → runtime (absorbed: the normalizer keeps the first `pPr`; nothing to check)
 
@@ -113,7 +113,22 @@ function counterHue(h) {
 // at 4.5:1 (a yellow pill carries dark type, a green one white), else the type form of the accent under white (a mid
 // amber or blue can host neither at 12 pt). Charts, arcs, dots, and bars fill with accentFill; a word in the accent,
 // a kicker, an emphasis run, a hero numeral keep `accent`.
-function palette({ hue = 205, accentHue = counterHue(hue), accentSat = 0.72, accentLight = 0.42 } = {}) {
+// accentMode: where the accent sits against the seed when accentHue is not given — 'complement' (the default: counterHue),
+// 'analogous' (seed + 30°), 'split' (counterHue + 30°), 'mono' (the seed itself). warmth (-1..1, default 0) leans every
+// neutral (paper, type, lines, marks) toward amber (+) or blue (-) without moving the seed or the accent.
+function accentFor(seed, mode) {
+  if (mode === 'analogous') return (seed + 30) % 360;
+  if (mode === 'split') return (counterHue(seed) + 30) % 360;
+  if (mode === 'mono') return seed;
+  return counterHue(seed);
+}
+function warmHue(h, warmth) {
+  if (!warmth) return h;
+  const d = ((((warmth > 0 ? 40 : 220) - h + 540) % 360) - 180) * Math.min(1, Math.abs(warmth));
+  return (h + d + 360) % 360;
+}
+function palette({ hue: seed = 205, accentHue: pickedHue, accentMode = 'complement', accentSat = 0.72, accentLight = 0.42, warmth = 0 } = {}) {
+  const hue = warmHue(seed, warmth), accentHue = pickedHue ?? accentFor(seed, accentMode);
   const paper = hsl(hue, 0.25, 0.975), paperAlt = hsl(hue, 0.18, 0.92), tint = hsl(accentHue, 0.35, 0.89), dark = hsl(hue, 0.42, 0.10);
   const accent = darkenUntil(accentHue, accentSat, accentLight, ['FFFFFF', paper, tint], 4.5);
   const ink = hsl(hue, 0.30, 0.13);
@@ -306,6 +321,9 @@ function darkTheme(hue, accentHue = counterHue(hue)) {
 // radius, the stroke a rule takes, the motif an anchor repeats, the theme, and whether the accent stays on the seed
 // hue. Passed to deck(), two decks of the same content open on visibly different pages; left out, every deck repeats
 // one frame — the title at the top left, the body under it, the source at the foot — whatever its brief called it.
+// An entry may also carry palette knobs — accentMode ('complement' | 'analogous' | 'split' | 'mono'), accentSat,
+// accentLight, warmth (-1..1) — and its type `pairing`; deck() reads them unless the call names its own. None of the
+// built-in entries sets a knob, so they keep the counter-hue accent.
 // `motifs` is the style's decoration set, not one device: an anchor that names no kind takes the next one, so the
 // cover, the section marks, and the closing of one deck are not the same drawing three times (composition.md §3).
 const STYLES = {
@@ -330,7 +348,7 @@ let MOTIF_AT = 0;
 // The next device in the deck's set. `motif(s, '', …)` takes it, so two anchors in a row never carry the same
 // drawing; naming a kind (`motif(s, MOTIF, …)`) still wins when the echo is the point (a closing answering its cover).
 function nextMotif() { const kind = MOTIFS[MOTIF_AT % MOTIFS.length]; MOTIF_AT += 1; return kind; }
-function deck({ style = 'custom', hue = 205, accentHue, accentSat, accentLight, mode = 'balanced', script = 'ko', pairing, fonts = 'noto', titleLines = 1, chrome, theme } = {}) {
+function deck({ style = 'custom', hue = 205, accentHue, accentMode, accentSat, accentLight, warmth, mode = 'balanced', script = 'ko', pairing, fonts = 'noto', titleLines = 1, chrome, theme } = {}) {
   const preset = STYLES[style];
   if (!preset) throw new Error(`deck: unknown style "${style}" — one of ${Object.keys(STYLES).join(', ')}`);
   STYLE = { name: style, ...STYLE_DEFAULTS, ...preset };
@@ -340,8 +358,12 @@ function deck({ style = 'custom', hue = 205, accentHue, accentSat, accentLight,
   MOTIF = MOTIFS[0];
   MOTIF_AT = 0;
   // A single-hue style (swiss-minimal, brutalist, blueprint) keeps the accent on the seed; the rest take the counter hue.
-  Object.assign(T, palette({ hue, accentHue: accentHue ?? (STYLE.singleHue ? hue : undefined), accentSat, accentLight }));
-  if ((theme ?? STYLE.theme) === 'dark') darkTheme(hue, accentHue ?? (STYLE.singleHue ? hue : counterHue(hue)));
+  // A style may carry palette knobs (accentMode, accentSat, accentLight, warmth); the call's own value wins, and a style
+  // without them leaves the palette as it was (accent on the counter hue, the default saturation and lightness, no warmth).
+  const mode_ = accentMode ?? STYLE.accentMode, warm = warmth ?? STYLE.warmth;
+  const accentAt = accentHue ?? (STYLE.singleHue ? hue : accentFor(hue, mode_));
+  Object.assign(T, palette({ hue, accentHue: accentAt, accentSat: accentSat ?? STYLE.accentSat, accentLight: accentLight ?? STYLE.accentLight, warmth: warm }));
+  if ((theme ?? STYLE.theme) === 'dark') darkTheme(warmHue(hue, warm), accentAt);
   // The face pairing is the style's too (an editorial page sets its display in the serif, a masthead in the sans),
   // unless the brief names one here.
   typography({ script, pairing: pairing ?? STYLE.pairing ?? 'weight', fonts });

package/src/defaults/skills/pptx/references/review.md

@@ -1,8 +1,8 @@
 # Direction trials and independent review
 
-Use this procedure for a new visual direction, substantive redesign, or an
-explicit quality comparison. A small factual edit inside an approved deck
-keeps its existing direction; it does not need a design contest.
+Use this optional procedure when a direction trial resolves a real uncertainty
+or the user asks for a quality comparison. New documents do not require a
+design contest. A factual edit inside an approved deck keeps its direction.
 
 ## Before composition
 
@@ -16,8 +16,9 @@ condition or a misleading relationship.
 
 Pick one or two representative pages that expose the difficult work: a dense
 comparison, an explanatory diagram, or the primary evidence. Draft two materially
-different compositions of the same content at the same reading size. Change the
-reading path or carrier, not merely the palette. Render both; do not build two
+different compositions of the same content at the same reading size. Candidates
+differ in the design decision being tested — reading path, evidence treatment,
+type, or structure — rather than requiring different catalogue concepts. Render both; do not build two
 whole decks. Preserve the trials separately from the deliverable.
 
 Give the trials neutral identifiers and compare:

package/src/defaults/skills/setup/SKILL.md

@@ -70,8 +70,10 @@ that a call returned without transport error.
   background cycles. Core Memory entries
   are read and changed with the `memory` tool, not setup.
 - Built-ins have installation state separate from enabled state. Browser Use,
-  Computer Use, and voice actions require this conversation open in the local
-  Desktop window.
+  Computer Use actions require this conversation open in the local Desktop
+  window; voice runs on the runtime and needs no Desktop.
+- Hook rules are before-tool policy, separate from MCP and plugins. Deleting a
+  rule is destructive; disabling preserves it.
 - Desktop appearance changes affect the Desktop host, not a paired phone.
   Display language is independent of profile response language. A required
   reload is reported, never performed automatically.
@@ -82,7 +84,6 @@ that a call returned without transport error.
   be scoped to selected Projects.
 - User skills are machine-global. Enabled plugin skills and built-in skills are
   also discoverable; project-local `.mixdog/skills` directories are ignored.
-  Use extension scope to limit where a global skill appears.
 - `set_disabled_skills` replaces the complete disabled list; inspect the
   current list before changing one entry.
 
@@ -93,8 +94,6 @@ that a call returned without transport error.
 - For an MCP failure, inspect the reported transport error before changing
   command, arguments, directory, environment, URL, headers, or enabled state.
 - MCP reads intentionally omit raw connection values that may contain secrets.
-  Partial edits preserve those values. Use environment-variable names for
-  credentials; never request or echo their values.
 - For an unavailable built-in, distinguish not installed, installed but
   disabled, and bridge inactive.
 - Desktop requests require a single live claimant and a confirmed receipt.
@@ -107,8 +106,6 @@ that a call returned without transport error.
 
 ## Finish
 
-- Do not expose secrets or internal-only configuration as supported user
-  options.
-- Do not claim the current session changed when the receipt says next session.
+- Do not expose internal-only configuration as a supported user option.
 - Do not commit, deploy, restart, or update the app unless separately requested
   and approved.