docs: merge live and compact into one badge format

Two visual formats (badge + share card); auto vs pinned is wiring only.

Author: paladini

README.md

@@ -134,16 +134,17 @@ deterministic scanner can claim.
 
 ## Show your maturity in your README
 
-Harness Score ships **three branded SVG artifacts** — free, self-contained, no
+Harness Score ships **two branded SVG formats** — free, self-contained, no
 shields.io subscription:
 
-| Artifact | Shows | Best for |
+| Format | Shows | Best for |
 |---|---|---|
-| **Live badge** (`harness-badge.svg`) | `harness` · `L4` | README row — updates when your level changes |
-| **Compact badge** (`badge-l0`–`l4`) | `harness` · `L3` | Pin a level (no long name) |
+| **Badge** (`harness-badge.svg` or `badge-l0`–`l4`) | `harness` · `L4` | README row (112×20) |
 | **Share card** (`card-l0`–`l4`) | Full banner with level name | Social posts, repo hero |
 
-**Live badge (recommended)** — updates itself when your level changes:
+The pill looks the same whether CI regenerates it or you pin a static file.
+
+**Auto-updating badge (recommended)** — CI writes `harness-badge.svg` on every run:
 
 ```yaml
 # .github/workflows/harness.yml
@@ -156,13 +157,13 @@ shields.io subscription:
 <img alt="Harness Score" src="https://raw.githubusercontent.com/<you>/<repo>/badges/harness-badge.svg" height="20">
 ```
 
-**Compact badge** — pin a level (`l0`–`l4`); same pill, static file:
+**Pinned badge** — same pill, static `badge-lN.svg`:
 
 ```md
 <img alt="Harness Score L3" src="https://paladini.github.io/harness-score/maturity/badge-l3.svg" height="20">
 ```
 
-All five compact badges:
+All five badge levels:
 
 <p align="center">
   <img alt="L0" src="https://paladini.github.io/harness-score/maturity/badge-l0.svg" height="20">

action/README.md

@@ -2,8 +2,7 @@
 
 Runs the deterministic [harness-score](https://paladini.github.io/harness-score/)
 scanner in CI: reports the repository's AI-harness maturity level, writes a
-branded SVG pill (`harness` · `L4` — level only, 112×20), and (optionally)
-fails the build below a minimum level so your harness only ratchets up. Because
+branded SVG pill (`harness` · `L4`), and (optionally) fails the build below a minimum level so your harness only ratchets up. Because
 the badge is re-rendered for the detected level on every run, publishing it
 once gives you a self-updating README badge for free.
 

docs/guide/maturity-model.md

@@ -115,8 +115,8 @@ can honestly claim.
    effort (L1: write AGENTS.md → L2: rules + hygiene → L3: sensors + CI →
    L4: hooks).
 3. Gate the level in CI (`--min-level`) so maturity only ratchets up.
-4. Show it off — three branded SVGs (live pill, compact pill, share card) in
-   [Show your maturity](/guide/measure-and-improve#show-your-maturity). Badges
-   display `harness` + the level only; level names live on the share cards.
+4. Show it off — a README badge (`harness` · `L4`) and optional
+   [share card](/guide/measure-and-improve#show-your-maturity). Same pill from
+   CI (`--badge`) or a pinned static file.
 
 Chapter 7 walks each step, check by check.

docs/guide/measure-and-improve.md

@@ -80,20 +80,22 @@ Or use the packaged action, which also emits the badge:
 
 ## Show your maturity {#show-your-maturity}
 
-Harness Score ships **three branded SVG artifacts** in the same visual language
+Harness Score ships **two branded SVG formats** in the same visual language
 as the scanner's progress bars — no shields.io, no paid service, no network at
 render time:
 
-| Artifact | File | Shows | Best for |
+| Format | Files | Shows | Best for |
 |---|---|---|---|
-| **Live badge** | `harness-badge.svg` | `harness` · `L4` | README row — updates when your level changes |
-| **Compact badge** | `badge-l0.svg` … `badge-l4.svg` | `harness` · `L3` | Pin a level without the long name |
-| **Share card** | `card-l0.svg` … `card-l4.svg` | Full banner with level name | Social posts, repo hero image |
+| **Badge** | `harness-badge.svg` or `badge-l0.svg` … `badge-l4.svg` | `harness` · `L4` | README row (112×20 pill) |
+| **Share card** | `card-l0.svg` … `card-l4.svg` | Full banner with level name | Social posts, repo hero (860×240) |
 
-Compact and live badges show **only the level** (`L0`–`L4`). Level names
+The badge always shows **only the level** (`L0`–`L4`). Level names
 (Unharnessed, Guided, …) live on the share cards and in the scanner output.
 
-### Option A — live badge (recommended)
+The pill looks identical whether CI regenerates it or you pin a static file —
+only the wiring differs.
+
+### Badge — auto-updating (recommended)
 
 `harness-score --badge` writes an SVG for whatever level the scanner detects.
 Wire it into CI once; the README image updates itself as your harness improves.
@@ -127,35 +129,36 @@ the same row (112×20 SVG; level only — score percent stays in the CLI report)
 <img alt="Harness Score" src="https://paladini.github.io/harness-score/harness-badge.svg" height="20">
 ```
 
-This guide's site dogfoods the pattern — the live badge below is regenerated
-on every Pages deploy:
+This guide's site dogfoods the pattern — badge below is regenerated on every
+Pages deploy:
 
 <div class="hs-visual">
-  <p class="hs-visual-label">Live badge</p>
+  <p class="hs-visual-label">Badge (this repo)</p>
   <div class="hs-badge-row">
     <img class="hs-badge" src="/harness-badge.svg" alt="Harness Score" height="20">
   </div>
 </div>
 
-The matching banner card for the detected level is published as
+The matching share card for the detected level is published as
 `harness-card.svg` (currently L4 for this repository):
 
 <img class="hs-share-card" src="/harness-card.svg" alt="Harness Score L4 · Self-correcting">
 
-### Option B — compact badge (level only)
+### Badge — pin a level
 
-Prefer a static pill? Pick the compact badge for your level (`l0`–`l4`):
+Same pill, static file — pick `badge-l0.svg` … `badge-l4.svg` if you do not
+want CI to regenerate the image:
 
 ```md
 <img alt="Harness Score L3" src="https://paladini.github.io/harness-score/maturity/badge-l3.svg" height="20">
 ```
 
-### Option C — share card (full name)
+### Share card
 
 For a hero image or social post, use the banner card — it includes the level
 name (`Unharnessed`, `Guided`, …):
 
-| Level | Compact badge | Share card |
+| Level | Badge | Share card |
 |---|---|---|
 | L0 · Unharnessed | [badge-l0.svg](https://paladini.github.io/harness-score/maturity/badge-l0.svg) | [card-l0.svg](https://paladini.github.io/harness-score/maturity/card-l0.svg) |
 | L1 · Documented | [badge-l1.svg](https://paladini.github.io/harness-score/maturity/badge-l1.svg) | [card-l1.svg](https://paladini.github.io/harness-score/maturity/card-l1.svg) |
@@ -164,7 +167,7 @@ name (`Unharnessed`, `Guided`, …):
 | L4 · Self-correcting | [badge-l4.svg](https://paladini.github.io/harness-score/maturity/badge-l4.svg) | [card-l4.svg](https://paladini.github.io/harness-score/maturity/card-l4.svg) |
 
 <div class="hs-visual">
-  <p class="hs-visual-label">Compact badges (112×20)</p>
+  <p class="hs-visual-label">All badge levels (112×20)</p>
   <div class="hs-badge-row">
     <img class="hs-badge" alt="L0" src="/maturity/badge-l0.svg" height="20">
     <img class="hs-badge" alt="L1" src="/maturity/badge-l1.svg" height="20">

docs/index.md

@@ -31,7 +31,7 @@ features:
     details: Five levels, six dimensions, thirty-three deterministic checks. `npx harness-score` — no LLM calls, no network, no telemetry.
   - icon: 🏷️
     title: Badges you can show off
-    details: Three branded SVGs — live pill (`harness` · `L4`), compact pill per level, and share cards with full names. Wire the scanner into CI once; your README badge updates itself. Free, no shields.io.
+    details: Two SVG formats — a 20px README pill (`harness` · `L4`) and a share card with the level name. Wire `--badge` into CI for auto-update, or pin a static file. Free, no shields.io.
 ---
 
 ## One command, zero AI
@@ -48,32 +48,24 @@ the **Harness Score** plugin.
 
 ## Branded visuals
 
-Three SVG artifacts — 20px pills for README rows, banner cards for posts.
+Two SVG formats — same visual language as the scanner:
 
 <div class="hs-visual">
-  <p class="hs-visual-label">1 · Live badge</p>
-  <div class="hs-badge-row">
-    <img class="hs-badge" alt="Live badge (auto-updates)" src="/harness-badge.svg" height="20">
-  </div>
-  <p class="hs-visual-detail">Regenerated on every CI run — <code>harness</code> + detected level.</p>
-</div>
-
-<div class="hs-visual">
-  <p class="hs-visual-label">2 · Compact badges</p>
+  <p class="hs-visual-label">Badge · 112×20</p>
   <div class="hs-badge-row">
     <img class="hs-badge" alt="L0" src="/maturity/badge-l0.svg" height="20">
     <img class="hs-badge" alt="L1" src="/maturity/badge-l1.svg" height="20">
     <img class="hs-badge" alt="L2" src="/maturity/badge-l2.svg" height="20">
     <img class="hs-badge" alt="L3" src="/maturity/badge-l3.svg" height="20">
     <img class="hs-badge" alt="L4" src="/maturity/badge-l4.svg" height="20">
   </div>
-  <p class="hs-visual-detail">Static files to pin a level — same pill, no auto-update.</p>
+  <p class="hs-visual-detail">README pill: <code>harness</code> + level. Same look whether CI regenerates it (<code>--badge</code>) or you pin a static <code>badge-lN.svg</code>.</p>
 </div>
 
 <div class="hs-visual">
-  <p class="hs-visual-label">3 · Share card</p>
+  <p class="hs-visual-label">Share card · 860×240</p>
   <img class="hs-share-card" alt="L4 · Self-correcting" src="/maturity/card-l4.svg">
-  <p class="hs-visual-detail">860×240 banner with the level name for social posts and repo heroes.</p>
+  <p class="hs-visual-detail">Banner with the level name — for social posts and repo heroes.</p>
 </div>
 
 Gallery, CI recipes, and embed snippets:

packages/cli/README.md

@@ -82,9 +82,9 @@ TypeScript types.
 Or use the [packaged GitHub Action](https://github.com/paladini/harness-score/tree/main/action),
 which also emits the badge.
 
-Three branded SVG artifacts (live pill, compact pill per level, share card):
+Two branded SVG formats (README badge + share card):
 [Show your maturity](https://paladini.github.io/harness-score/guide/measure-and-improve#show-your-maturity).
-Badges show `harness` + the level only; level names live on the share cards.
+The pill is identical from CI (`--badge`) or a pinned `badge-lN.svg`.
 
 ## Cursor plugin