feat(saman-skills): lock the pastel palette, add style and topic banks

Adds the supporting colour system, calibrates the craft gate against shipped
work, and gives the factory two idea banks it was missing.

PALETTE — her three locked colours are untouched. On top:
- one BRIGHT (#F2506A coral, #B0243C deep) that does all the pointing, in
  exactly three places: node rings, chip text, the closing figure
- five SOFT FILLS for card backgrounds (peach, cream, rose, orchid, and
  Material Blue 50 — which belongs because her #90CAF8 is Material Blue 200,
  one digit from #90CAF9, so the pale sky is literally her own colour's family)
- roles are not swappable: bright never fills, a pastel never carries text,
  blue never leaves the spine. That separation is what keeps ten named values
  reading as five colours.

Every fill clears 6:1 for body text and every chip pairing clears 4.5:1. The
bright blues from the source palettes (#30AFFF at 2.20, #2196F3 at 2.85 on her
ground) are documented as fill-only rather than quietly used as text.

Geometry softened throughout: card radius 14 to 20, panel 18 to 24.

CRAFT GATE recalibrated against a study of 32 shipped designs — 1-2 movers with
the chrome still, 180-320 words, 5-7 colour families, sub-8s loop, and a frame
one that is never blank. Her system already lands in those bands; the new
reference exists to catch drift, not to change the laws.

NEW BANKS:
- style-kit.md: 4 headers, 5 cards, 3 nodes, 3 chips, 4 closers, with a mixing
  table. Ten frames times these variants is why forty sheets can share one
  system without looking like one sheet forty times.
- topic-ideas.md: eight content lanes, ~40 seeded topics, and the method
  (number + verb + outcome, then the Monday, cost and swap tests) for when the
  bank runs dry.

Both templates repainted and re-verified: 10/10 grey gate, autofix clean,
2160x2700 static, GIF and MP4. Clean-room extract of the rebuilt zip runs the
whole chain with no other skill present.

The avatar is still the SA monogram placeholder, now ringed in the new bright.
It needs her real photo as a file to replace it.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0187zcyEaMFy8EeQnT1MPYpY

Author: claude

saman-skills/INSTALL.md

@@ -37,7 +37,7 @@ python -m playwright install chromium
 pip install imageio-ffmpeg     # optional: adds the MP4. GIF works without it.
 ```
 
-## 3. Her avatar
+## 3. Her avatar  ← needs her photo
 
 The bundle ships an "SA" monogram placeholder. To use her real photo, replace this file:
 
@@ -106,10 +106,10 @@ python3 ~/.claude/skills/saman-design/scripts/build.py   sheet.html motion   # G
 ## What is in the box
 
 ```
-saman-brand/   SKILL.md · brand-kit.md · spine-frames.md · design-note-format.md
-               assets/ (Inter x5, avatar)
+saman-brand/   SKILL.md · brand-kit.md · spine-frames.md · style-kit.md
+               design-note-format.md · assets/ (Inter x5, avatar)
 saman-design/  SKILL.md · build.py · greygate.py · 2 templates + specs for 8 more
-               voice.md · post-formats.md · shipped-log.md · assets/
-saman-craft/   SKILL.md · autofix.py · win-matrix.md · design-laws.md · fix-recipes.md
-               assets/
+               topic-ideas.md · voice.md · post-formats.md · shipped-log.md · assets/
+saman-craft/   SKILL.md · autofix.py · win-matrix.md · design-laws.md
+               fix-recipes.md · craft-benchmarks.md · assets/
 ```

saman-skills/bundles/saman-brand.skill

@@ -15,17 +15,49 @@ is wrong, not the law.
 
 ---
 
-## 1. The four tokens
+## 1. The palette
 
-Everything on every sheet is made of these four things. There is no fifth colour and no
-second typeface.
+Three locked colours, one bright, five soft fills. Every colour has exactly one job, and the
+jobs are not swappable — that separation is what keeps ten named values reading as a simple
+sheet instead of a busy one.
 
-| Token | Hex | What it is for |
+**LOCKED — these never change.**
+
+| Token | Hex | Job |
 |---|---|---|
 | **Sky** | `#EBF6FF` | the ground. The canvas, the page, the air between things. |
-| **Blue** | `#90CAF8` | **structure only.** The spine, rules, borders, node rings, arrows. |
-| **Ink** | `#051D2F` | type, and the one dark element per sheet. |
-| **Paper** | `#FFFFFF` | panel fills that sit on Sky. Not a brand colour — a surface. |
+| **Blue** | `#90CAF8` | **the spine, and nothing else.** Structure, never meaning. |
+| **Ink** | `#051D2F` | type, the pill, the closer. |
+| **Paper** | `#FFFFFF` | a neutral surface when content needs to stay plain. Not a brand colour. |
+
+**BRIGHT — the one saturated colour on the sheet. It points.**
+
+| Token | Hex | Job |
+|---|---|---|
+| **Bright** | `#F2506A` | node rings, the closing figure. The only thing that grabs. |
+| **Bright-deep** | `#B0243C` | chip text and small emphasis, where `Bright` would be too light to read. |
+
+**SOFT FILLS — the pastel family. Card backgrounds only.**
+
+| Token | Hex | |
+|---|---|---|
+| `--p1` | `#FFE4DE` | peach |
+| `--p2` | `#FFF2D6` | cream |
+| `--p3` | `#FFE9F3` | rose |
+| `--p4` | `#F4EBFF` | orchid |
+| `--p5` | `#E3F2FD` | pale sky — Material Blue 50, her own blue's family |
+
+Cards rotate through the fills down a sheet. They are pale on purpose: at this value they
+read as **one family**, so the sheet counts as five colours, not ten. Saturate one and the
+count breaks.
+
+**The three rules that hold it together:**
+1. Bright never fills a card.
+2. A pastel never carries text and never touches the spine.
+3. Blue never leaves the spine.
+
+*(Her blue `#90CAF8` is Material Blue 200 — one digit from `#90CAF9`. That is why the Blue-50
+pale sky belongs in the fill set: it is literally her own colour's family.)*
 
 Derived tints. Use these named values, never eyeball a new one:
 
@@ -104,6 +136,9 @@ The 7 Systems That Save Founders [ 10 HOURS ] A Week
 Pill spec: `--ink` background, `--sky` text, radius 999px, padding `.08em .42em`, same font
 size and weight as the headline around it, letter-spacing `-0.01em`.
 
+**The pill is Ink, never Bright.** Two things competing to be the loudest thing on a sheet
+means neither wins. The pill owns the headline; Bright owns the body.
+
 **The pill is not a highlighter.** It does not appear in body text, in card titles, or twice.
 If a second phrase needs emphasis, it gets `--ink` weight 700 and no pill.
 
@@ -115,10 +150,11 @@ Measured by area of the finished canvas:
 
 - **60% Sky** — the ground. Air is the brand. A cramped Saman sheet is off-brand even if every
   colour is right.
-- **30% Paper** — the panels the content actually lives in.
-- **10% Ink** — type, the pill, the footer, numbered nodes.
-- **Blue is not in the ratio.** It is structure: strokes, rings, hairlines. If Blue is filling
-  a large area, you have used it as a colour instead of as a line. Fix it.
+- **30% fills** — the pastel cards (or Paper, when the content wants to stay neutral).
+- **10% Ink** — type, the pill, the footer, the closer.
+- **Blue and Bright are not in the ratio.** Blue is structure: strokes, rings, hairlines.
+  Bright is a pointer: three small things and no more. If either is filling a large area, it
+  has stopped doing its job. Fix it.
 
 Practical floor: at least 90px of clear Sky across the top of the content area, and at least
 40px of Sky gutter on the left and right of every card.
@@ -167,7 +203,7 @@ second family, letter-spacing on body text, all-caps on anything longer than fou
 
 ```
 Spacing scale (px):   4 · 8 · 12 · 16 · 24 · 32 · 48 · 64      (nothing in between)
-Radius:               card 14 · panel 18 · node 999 · pill 999
+Radius:               card 20 · panel 24 · node 999 · pill 999   (soft — no hard corners)
 Stroke:               hairline 1 (--blue-pale) · spine 4 (--blue) · node ring 3 (--blue)
 Canvas margins:       56 left/right · 48 top · footer pinned at y=1306
 ```
@@ -251,7 +287,10 @@ The full format and worked examples: **`references/design-note-format.md`**.
 These exist because each one is a specific way a sheet stops being hers.
 
 **Brand**
-1. No colour outside the four tokens and their named tints. No red, no green, no gradient.
+1. No colour outside the named set — three locked, one bright, five fills, and their tints.
+   No gradient, ever.
+1a. No swapped roles. Bright never fills a card, a pastel never carries text, Blue never
+   leaves the spine.
 2. No second typeface. Inter does all of it.
 3. Blue never carries text, and never fills a large area.
 4. Never two Ink Pills. Never zero.
@@ -286,5 +325,6 @@ These exist because each one is a specific way a sheet stops being hers.
 - Building a sheet → `/saman-design` (it reads this file first, then the frame bank)
 - Scoring or fixing a sheet → `/saman-craft` (it enforces sections 2, 4, 6, 7, 11)
 - Picking a layout → `references/spine-frames.md`
+- Picking how the parts look → `references/style-kit.md`
 - Writing the note she approves → `references/design-note-format.md`
 - Every token, in copy-paste CSS → `references/brand-kit.md`

saman-skills/bundles/saman-craft.skill

@@ -27,15 +27,26 @@ needs a colour that is not here, the sheet is wrong.
   --ink-70:    #40566A;
   --ink-45:    #7D8D9C;
 
+  /* ---- BRIGHT: the one saturated colour. It points, nothing else does ---- */
+  --bright:      #F2506A;   /* node rings, the closing figure               */
+  --bright-deep: #B0243C;   /* chip text, small emphasis (4.5:1 on --p1)    */
+
+  /* ---- SOFT FILLS: the pastel family. Card backgrounds only ---- */
+  --p1: #FFE4DE;   /* peach   */
+  --p2: #FFF2D6;   /* cream   */
+  --p3: #FFE9F3;   /* rose    */
+  --p4: #F4EBFF;   /* orchid  */
+  --p5: #E3F2FD;   /* pale sky (Material Blue 50 — her blue's own family)   */
+
   /* ---- the only shadow ---- */
   --shadow:    0 2px 10px rgba(5,29,47,.07);
 
   /* ---- space scale ---- */
   --s1: 4px;  --s2: 8px;  --s3: 12px; --s4: 16px;
   --s5: 24px; --s6: 32px; --s7: 48px; --s8: 64px;
 
-  /* ---- radius ---- */
-  --r-card: 14px; --r-panel: 18px; --r-round: 999px;
+  /* ---- radius: soft. Nothing on her sheets has a hard corner ---- */
+  --r-card: 20px; --r-panel: 24px; --r-round: 999px;
 
   /* ---- stroke ---- */
   --w-hair: 1px; --w-ring: 3px; --w-spine: 4px;
@@ -82,6 +93,27 @@ loads and ship a sheet set in the fallback.
 Headline drops to 52px only when the line would otherwise wrap to three lines. Below 52px,
 cut words instead.
 
+## The palette in one picture
+
+```
+LOCKED           Sky #EBF6FF      Blue #90CAF8     Ink #051D2F
+   the ground       the spine        the type
+
+BRIGHT           #F2506A          #B0243C
+   points          rings, figure    chip text
+
+SOFT FILLS       #FFE4DE  #FFF2D6  #FFE9F3  #F4EBFF  #E3F2FD
+   card backgrounds only, never text, never the spine
+```
+
+**Counting colours.** The craft benchmark for this kind of sheet is 5–7 colours. Hers reads as
+five: ground, type, spine, bright, and the pastel family — because the five fills sit at the
+same value and register as one family, not five decisions. That only holds while they stay
+pale. A saturated fill breaks the count and the sheet starts to look busy.
+
+**Roles are not swappable.** Bright never fills a card. A pastel never carries text. Blue never
+leaves the spine. That separation is what keeps ten named colours reading as five.
+
 ## The Ink Pill
 
 ```css
@@ -120,10 +152,25 @@ All nodes on one sheet are the same size. Always.
 
 ## Cards and panels
 
+Cards rotate through the pastel fills down a sheet. Use `--paper` when the content needs to
+stay neutral (dense tables, a matrix) and the pastels when the sheet wants warmth.
+
 ```css
-.card{background:var(--paper); border-radius:var(--r-card);
-      border:var(--w-hair) solid var(--blue-pale);
+.card{background:var(--p1); border-radius:var(--r-card);
+      border:var(--w-hair) solid rgba(5,29,47,.07);
       box-shadow:var(--shadow); padding:var(--s5)}
+.rail > .card:nth-of-type(1){background:var(--p1)}
+.rail > .card:nth-of-type(2){background:var(--p2)}
+.rail > .card:nth-of-type(3){background:var(--p3)}
+.rail > .card:nth-of-type(4){background:var(--p4)}
+.rail > .card:nth-of-type(5){background:var(--p5)}
+
+/* BRIGHT does the pointing, and only these three things */
+.node{border-color:var(--bright)}
+.chip{background:var(--p1); color:var(--bright-deep)}
+.verdict .vnum{color:var(--bright)}
+
+.card--neutral{background:var(--paper); border-color:var(--blue-pale)}
 .panel{background:var(--paper); border-radius:var(--r-panel);
        border:var(--w-hair) solid var(--blue-pale); padding:var(--s6)}
 .well{background:var(--sky-deep); border-radius:var(--r-card); padding:var(--s4)}

saman-skills/bundles/saman-design.skill

@@ -0,0 +1,133 @@
+# STYLE KIT — component variants
+
+The Spine Bank decides the *shape* of a sheet. This file decides how the parts inside it look.
+
+Ten frames × these variants is why forty sheets can share one system without forty sheets
+looking identical. **Every variant here already obeys the laws** — the palette, the type scale,
+the soft radii. Mixing them cannot take a sheet off-brand.
+
+Pick one variant per component per sheet. Do not mix two card styles on one sheet.
+
+---
+
+## Headers — 4 variants
+
+**H1 · Stacked** *(default)*
+Headline, then deck under it. Full width. Nothing else.
+→ Use when the headline is the whole hook.
+
+**H2 · Headline + counter**
+Headline left, a large Ink figure right (`72px/800`, tabular). The number the sheet is about.
+→ Use when there is one dominant figure: "10 hrs", "£4,200", "40×".
+
+**H3 · Headline + two column labels**
+Headline, deck, then a label row that names the two sides.
+→ The Two-State Board's header. Also works on Fork.
+
+**H4 · Eyebrow + headline**
+A `.seclab` eyebrow above the headline ("THE FRIDAY PROBLEM"), then headline, then deck.
+→ Use when the topic needs one line of framing before the claim lands.
+
+---
+
+## Cards — 5 variants
+
+**C1 · Warm fill** *(default)*
+Pastel background rotating through `--p1`…`--p5`, hairline at 7% Ink, soft shadow.
+→ The workhorse. Warm, readable, unmistakably hers.
+
+**C2 · Neutral**
+`--paper` fill, `--blue-pale` hairline.
+→ Dense content, tables, matrices — anywhere the pastels would add noise to data.
+
+**C3 · Quiet well**
+`--sky-deep` fill, no border, no shadow.
+→ The losing side of a comparison. Flat on purpose.
+
+**C4 · Ink**
+`--ink` fill, `--sky` text. One per sheet, at the end of the spine.
+→ The closer. Never more than one.
+
+**C5 · Split card**
+Warm fill, with a `--sky-deep` strip down the right third holding a figure or a before-value.
+→ Use when every card carries a number worth isolating.
+
+---
+
+## Node styles — 3 variants
+
+**N1 · Numbered** *(default)*
+`--ink` fill, `--sky` numeral, `--bright` ring. 28px.
+→ Anything ordered.
+
+**N2 · Open**
+`--paper` fill, `--bright` ring, empty. 28px.
+→ Unordered stops, or the terminal node at the end of a spine.
+
+**N3 · Icon**
+`--paper` fill, `--bright` ring, one 14px Ink glyph.
+→ Only when the icon adds information the title does not. If it restates the title, use N1.
+
+All nodes on one sheet are the same size and the same variant. Always.
+
+---
+
+## Chips — 3 variants
+
+**P1 · Stat chip** *(default)*
+`--paper` fill, `--bright-deep` text, uppercase 13px/600, pill radius. "SAVES 2.5 HRS".
+
+**P2 · Tag**
+`--sky-deep` fill, `--ink-70` text, same shape. Category or tool name, no emphasis.
+
+**P3 · Bare figure**
+No chip. Just the number in `--bright-deep`, 20px/700, tabular.
+→ When every card has a figure and five chips would be five blobs.
+
+---
+
+## Closers — 4 variants
+
+**X1 · Verdict strip** *(default)*
+Ink block, sentence left, big `--bright` figure right.
+
+**X2 · Total bar**
+Ink block, a row of the sheet's figures adding to one total.
+→ When the sheet's whole argument is that the parts sum.
+
+**X3 · One line**
+Ink block, one sentence centred, no figure.
+→ When the payoff is a statement, not a number.
+
+**X4 · Next step**
+Ink block, one instruction and a time box: "Start with #2. Twenty minutes."
+→ The most useful closer for the setup lane, and underused.
+
+---
+
+## Dividers and rules
+
+- Section break: 1px `--blue-pale`, full content width, `--s5` above and below.
+- Never a heavy rule. Never a dotted or dashed one — the only dash on her sheets is the spine
+  drawing itself in the animation.
+
+---
+
+## Mixing guide — combinations that work
+
+| Sheet type | Header | Card | Node | Chip | Closer |
+|---|---|---|---|---|---|
+| Numbered systems list | H1 | C1 | N1 | P1 | X1 |
+| Big-number sheet | H2 | C1 | N1 | P3 | X2 |
+| Manual vs system | H3 | C3 + C1 | N2 | P2 | X1 |
+| Step-by-step setup | H4 | C1 | N1 | P1 | X4 |
+| Dense reference | H1 | C2 | N1 | P2 | X3 |
+| Hard truth (Ink canvas) | H4 | C1 | N2 | P3 | X3 |
+
+---
+
+## The one rule
+
+**One variant per component per sheet.** Two card styles on one sheet reads as indecision, not
+range. The variation belongs *between* sheets — that is what makes a feed look deep instead of
+repetitive.