roast-my-design-system 3.9.0 → 3.10.0

package/README.md

@@ -25,11 +25,11 @@ Your AI agent (Claude, Cursor, Copilot) builds UI by imitating what's already in
 
 The full report for vercel/ai-chatbot, top to bottom:
 
-![The full diagnosis report for vercel/ai-chatbot in dark mode: health score, three-yardstick tiles, palette forensics, spacing receipts, typography, offenders, duplicates, and the where-to-start close](https://raw.githubusercontent.com/pencilrebel/roast-my-design-system/main/assets/report-full-dark.png?v=3.9.0)
+![The full diagnosis report for vercel/ai-chatbot in dark mode: health score, three-yardstick tiles, palette forensics, spacing receipts, typography, offenders, duplicates, and the where-to-start close](https://raw.githubusercontent.com/pencilrebel/roast-my-design-system/main/assets/report-full-dark.png?v=3.10.0)
 
 The same report in light mode (one file, built-in toggle):
 
-![The diagnosis report in light mode](https://raw.githubusercontent.com/pencilrebel/roast-my-design-system/main/assets/report-light-hero.png?v=3.9.0)
+![The diagnosis report in light mode](https://raw.githubusercontent.com/pencilrebel/roast-my-design-system/main/assets/report-light-hero.png?v=3.10.0)
 
 ## What makes the numbers trustworthy
 
@@ -38,7 +38,7 @@ The same report in light mode (one file, built-in toggle):
 - **No network, no telemetry.** Everything runs locally. Nothing about your code leaves your machine.
 - **Honest exclusions.** Test files, Storybook stories, docs sites, example apps, SVG artwork, and email templates (which *must* inline styles) are excluded, so you can't discredit the numbers on a technicality.
 - **Intent-aware counting (v3).** Runtime-computed inline styles, compound-component APIs and wrapper components are not crimes and are not counted as ones. Token-led repos are judged on their hardcoded strays, not their token architecture. Repeated arbitrary values are read as decisions without names, not drift.
-- **A real benchmark.** The "Avg Design System" yardstick comes from scanning 30 public React repos (cal.com, excalidraw, outline, twenty, dub, langfuse…). Median: 96 colours, 14 greys, 14 duplicated components, 42 inline style blocks, 91 arbitrary Tailwind values.
+- **A real benchmark.** The "Avg Design System" yardstick comes from scanning 30 public React repos (cal.com, excalidraw, outline, twenty, dub, langfuse…). Median: 96 colours, 14 greys, 14 duplicated components, 45 inline style blocks, 91 arbitrary Tailwind values.
 - **A second yardstick: reputable systems.** Curated, scoped scans of 10 well-known design systems (shadcn/ui, Primer, Polaris, Carbon, Material UI, Chakra, Ant Design, GOV.UK, Spectrum, Cloudscape) show what disciplined looks like at scale.
 
 ## Install
@@ -119,9 +119,9 @@ Three real roasts of public repos, hosted as-is (the same self-contained HTML th
 | Typefaces | 2–3 | 2 | 1 |
 | Border radii | up to 10 | 12 | 2 |
 | Duplicated components | 0 | 14 | 10 |
-| Inline style blocks | 0 | 42 | 12 |
+| Inline style blocks | 0 | 45 | 12 |
 | Arbitrary Tailwind values | ~20 | 91 | 0 |
-| Near-identical colour pairs | 0 | 2 | 1 |
+| Near-identical colour pairs | 0 | 3 | 1 |
 | !important declarations | 0 | 5 | 3 |
 | Components never imported | 0 | 0 | 0 |
 
@@ -133,4 +133,4 @@ MIT. The code is yours to fork, modify and redistribute; the copyright notice tr
 
 **roast-my-design-system**™ and the GK mark are trademarks of Greg Kozakiewicz. Forking is welcome, republishing under this name is not: see [brand and attribution](https://pencilrebel.github.io/roast-my-design-system/brand.html).
 
-Built and designed by <a href="https://gregkozakiewicz.com"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/pencilrebel/roast-my-design-system/main/assets/gk-mark-dark.png?v=3.9.0"><img src="https://raw.githubusercontent.com/pencilrebel/roast-my-design-system/main/assets/gk-mark.png?v=3.9.0" height="15" alt="GK mark"></picture> Greg Kozakiewicz</a>.
+Built and designed by <a href="https://gregkozakiewicz.com"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/pencilrebel/roast-my-design-system/main/assets/gk-mark-dark.png?v=3.10.0"><img src="https://raw.githubusercontent.com/pencilrebel/roast-my-design-system/main/assets/gk-mark.png?v=3.10.0" height="15" alt="GK mark"></picture> Greg Kozakiewicz</a>.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "roast-my-design-system",
-  "version": "3.9.0",
+  "version": "3.10.0",
   "description": "Roast your design system with real data. A deterministic, zero-dependency scanner that counts everything that betrays a design system, from colours and their near-identical twins to greys, spacing values, typefaces, duplicated and never-imported components, inline styles, !important and arbitrary Tailwind values, scores it 0-100 against Ideal Design System norms and a 30-repo benchmark, generates a shareable HTML diagnosis, and with --rules writes the agent rules file (CLAUDE.md, .cursor/rules) that stops the mess coming back.",
   "keywords": [
     "design-system",

package/skills/roast-my-design-system/scripts/benchmark/benchmark.json

@@ -1,5 +1,5 @@
 {
-  "builtAt": "2026-08-03T16:33:32.652Z",
+  "builtAt": "2026-08-03T22:23:05.232Z",
   "repoCount": 30,
   "ideal2026": {
     "colors": {
@@ -103,12 +103,12 @@
         50,
         61,
         69,
-        78,
+        87,
         89,
-        102,
+        103,
         112,
         137,
-        142,
+        145,
         154,
         169,
         169,
@@ -119,7 +119,7 @@
         303,
         385,
         403,
-        1645
+        1649
       ],
       "p25": 38,
       "median": 96,
@@ -133,10 +133,10 @@
         0,
         0,
         2,
-        2,
         3,
         4,
         4,
+        4,
         5,
         8,
         8,
@@ -186,12 +186,12 @@
         34,
         37,
         50,
-        51,
-        54,
+        52,
         55,
+        58,
         59,
         61,
-        64,
+        70,
         78,
         82,
         84,
@@ -199,7 +199,7 @@
       ],
       "p25": 9,
       "median": 27,
-      "p75": 55,
+      "p75": 57,
       "p90": 78
     },
     "typefaces": {
@@ -268,7 +268,7 @@
         28,
         33,
         35,
-        37,
+        39,
         39,
         49,
         61
@@ -276,7 +276,7 @@
       "p25": 8,
       "median": 16,
       "p75": 27,
-      "p90": 37
+      "p90": 39
     },
     "radii": {
       "values": [
@@ -303,8 +303,8 @@
         20,
         20,
         21,
-        22,
-        24,
+        25,
+        25,
         25,
         26,
         26,
@@ -372,25 +372,25 @@
         8,
         10,
         17,
-        17,
         19,
         20,
         21,
-        22,
         23,
+        23,
+        30,
         38,
-        45,
-        59,
+        61,
+        65,
         92,
-        95,
+        99,
         103,
         115,
-        189
+        208
       ],
       "p25": 1,
       "median": 14,
-      "p75": 34,
-      "p90": 96
+      "p75": 36,
+      "p90": 99
     },
     "inlineStyles": {
       "values": [
@@ -403,16 +403,16 @@
         5,
         7,
         11,
-        18,
-        22,
+        20,
         23,
         23,
-        37,
+        26,
         41,
         43,
         46,
-        47,
+        48,
         51,
+        57,
         69,
         71,
         76,
@@ -420,15 +420,15 @@
         82,
         117,
         119,
-        122,
+        168,
         173,
         1178,
-        2923
+        3033
       ],
       "p25": 8,
-      "median": 42,
+      "median": 45,
       "p75": 78,
-      "p90": 127
+      "p90": 169
     },
     "arbitrary": {
       "values": [
@@ -444,29 +444,29 @@
         4,
         16,
         26,
-        27,
+        28,
         60,
         78,
         103,
         125,
         148,
-        164,
-        164,
+        175,
+        196,
         234,
         271,
         321,
         380,
         407,
-        468,
-        470,
         492,
-        561,
-        1751
+        574,
+        621,
+        642,
+        1753
       ],
       "p25": 0,
       "median": 91,
       "p75": 309,
-      "p90": 472
+      "p90": 579
     },
     "nearPairs": {
       "values": [
@@ -480,16 +480,16 @@
         0,
         0,
         0,
-        0,
         1,
         1,
         2,
         2,
         2,
+        4,
         9,
         12,
         13,
-        13,
+        14,
         15,
         16,
         23,
@@ -499,10 +499,10 @@
         47,
         49,
         70,
-        146
+        152
       ],
       "p25": 0,
-      "median": 2,
+      "median": 3,
       "p75": 21,
       "p90": 47
     },
@@ -567,9 +567,9 @@
         5,
         7,
         10,
+        11,
         13,
-        22,
-        22,
+        16,
         26,
         36,
         39,
@@ -579,7 +579,7 @@
       ],
       "p25": 0,
       "median": 0,
-      "p75": 20,
+      "p75": 13,
       "p90": 40
     },
     "components": {
@@ -597,35 +597,35 @@
         342,
         350,
         417,
-        555,
+        606,
         637,
         777,
         796,
         836,
         936,
-        940,
         962,
         970,
+        1046,
         1052,
         1081,
-        1216,
-        1379,
         1414,
-        1619,
-        2134,
-        2566
+        1456,
+        1551,
+        1708,
+        2530,
+        2669
       ],
       "p25": 233,
       "median": 707,
-      "p75": 1032,
-      "p90": 1435
+      "p75": 1051,
+      "p90": 1567
     }
   },
   "repos": [
     {
       "repo": "calcom/cal.com",
       "designSystem": "custom",
-      "codeFiles": 4341,
+      "codeFiles": 4389,
       "metrics": {
         "colors": 385,
         "greys": 77,
@@ -877,52 +877,52 @@
     {
       "repo": "dubinc/dub",
       "designSystem": "custom",
-      "codeFiles": 3526,
+      "codeFiles": 3974,
       "metrics": {
-        "colors": 102,
+        "colors": 103,
         "greys": 14,
-        "spacing": 54,
+        "spacing": 58,
         "typefaces": 3,
-        "fontSizes": 37,
-        "radii": 22,
+        "fontSizes": 39,
+        "radii": 25,
         "shadows": 0,
-        "exactDuplicates": 17,
-        "inlineStyles": 47,
-        "arbitrary": 470,
-        "nearPairs": 13,
+        "exactDuplicates": 23,
+        "inlineStyles": 48,
+        "arbitrary": 621,
+        "nearPairs": 14,
         "important": 1,
-        "neverImported": 22,
-        "components": 1379
+        "neverImported": 16,
+        "components": 1551
       }
     },
     {
       "repo": "formbricks/formbricks",
       "designSystem": "custom",
-      "codeFiles": 2051,
+      "codeFiles": 2336,
       "metrics": {
-        "colors": 142,
+        "colors": 145,
         "greys": 18,
-        "spacing": 51,
+        "spacing": 52,
         "typefaces": 2,
         "fontSizes": 28,
         "radii": 25,
         "shadows": 6,
-        "exactDuplicates": 59,
-        "inlineStyles": 18,
-        "arbitrary": 164,
+        "exactDuplicates": 61,
+        "inlineStyles": 20,
+        "arbitrary": 196,
         "nearPairs": 13,
         "important": 83,
         "neverImported": 0,
-        "components": 940
+        "components": 1046
       }
     },
     {
       "repo": "openstatusHQ/openstatus",
       "designSystem": "custom",
-      "codeFiles": 1916,
+      "codeFiles": 1948,
       "metrics": {
-        "colors": 78,
-        "greys": 2,
+        "colors": 87,
+        "greys": 4,
         "spacing": 9,
         "typefaces": 3,
         "fontSizes": 14,
@@ -930,8 +930,8 @@
         "shadows": 0,
         "exactDuplicates": 92,
         "inlineStyles": 119,
-        "arbitrary": 164,
-        "nearPairs": 0,
+        "arbitrary": 175,
+        "nearPairs": 4,
         "important": 0,
         "neverImported": 5,
         "components": 1081
@@ -940,7 +940,7 @@
     {
       "repo": "lukevella/rallly",
       "designSystem": "custom",
-      "codeFiles": 692,
+      "codeFiles": 734,
       "metrics": {
         "colors": 26,
         "greys": 4,
@@ -951,17 +951,17 @@
         "shadows": 0,
         "exactDuplicates": 10,
         "inlineStyles": 23,
-        "arbitrary": 27,
+        "arbitrary": 28,
         "nearPairs": 2,
         "important": 0,
-        "neverImported": 22,
-        "components": 555
+        "neverImported": 11,
+        "components": 606
       }
     },
     {
       "repo": "mfts/papermark",
       "designSystem": "shadcn",
-      "codeFiles": 1354,
+      "codeFiles": 1365,
       "metrics": {
         "colors": 42,
         "greys": 9,
@@ -982,7 +982,7 @@
     {
       "repo": "elie222/inbox-zero",
       "designSystem": "custom",
-      "codeFiles": 1821,
+      "codeFiles": 1822,
       "metrics": {
         "colors": 154,
         "greys": 24,
@@ -1045,28 +1045,28 @@
     {
       "repo": "twentyhq/twenty",
       "designSystem": "library",
-      "codeFiles": 15132,
+      "codeFiles": 17131,
       "metrics": {
-        "colors": 1645,
+        "colors": 1649,
         "greys": 100,
         "spacing": 24,
         "typefaces": 7,
         "fontSizes": 20,
         "radii": 26,
         "shadows": 19,
-        "exactDuplicates": 22,
-        "inlineStyles": 122,
+        "exactDuplicates": 30,
+        "inlineStyles": 168,
         "arbitrary": 0,
-        "nearPairs": 146,
+        "nearPairs": 152,
         "important": 9,
         "neverImported": 0,
-        "components": 2134
+        "components": 2530
       }
     },
     {
       "repo": "langfuse/langfuse",
       "designSystem": "custom",
-      "codeFiles": 2774,
+      "codeFiles": 2780,
       "metrics": {
         "colors": 170,
         "greys": 4,
@@ -1087,28 +1087,28 @@
     {
       "repo": "teableio/teable",
       "designSystem": "custom",
-      "codeFiles": 4742,
+      "codeFiles": 5100,
       "metrics": {
         "colors": 246,
         "greys": 34,
-        "spacing": 64,
+        "spacing": 70,
         "typefaces": 3,
         "fontSizes": 35,
-        "radii": 24,
+        "radii": 25,
         "shadows": 10,
-        "exactDuplicates": 45,
-        "inlineStyles": 37,
-        "arbitrary": 468,
+        "exactDuplicates": 65,
+        "inlineStyles": 57,
+        "arbitrary": 642,
         "nearPairs": 70,
         "important": 42,
         "neverImported": 0,
-        "components": 1216
+        "components": 1456
       }
     },
     {
       "repo": "makeplane/plane",
       "designSystem": "custom",
-      "codeFiles": 3086,
+      "codeFiles": 3271,
       "metrics": {
         "colors": 403,
         "greys": 32,
@@ -1117,13 +1117,13 @@
         "fontSizes": 24,
         "radii": 21,
         "shadows": 4,
-        "exactDuplicates": 95,
-        "inlineStyles": 22,
-        "arbitrary": 561,
+        "exactDuplicates": 99,
+        "inlineStyles": 26,
+        "arbitrary": 574,
         "nearPairs": 16,
         "important": 74,
         "neverImported": 7,
-        "components": 1619
+        "components": 1708
       }
     },
     {
@@ -1150,7 +1150,7 @@
     {
       "repo": "lobehub/lobe-chat",
       "designSystem": "library",
-      "codeFiles": 8344,
+      "codeFiles": 8458,
       "metrics": {
         "colors": 303,
         "greys": 37,
@@ -1159,13 +1159,13 @@
         "fontSizes": 2,
         "radii": 1,
         "shadows": 0,
-        "exactDuplicates": 189,
-        "inlineStyles": 2923,
+        "exactDuplicates": 208,
+        "inlineStyles": 3033,
         "arbitrary": 0,
         "nearPairs": 9,
         "important": 0,
         "neverImported": 0,
-        "components": 2566
+        "components": 2669
       }
     },
     {
@@ -1192,7 +1192,7 @@
     {
       "repo": "midday-ai/midday",
       "designSystem": "custom",
-      "codeFiles": 1762,
+      "codeFiles": 1775,
       "metrics": {
         "colors": 169,
         "greys": 31,
@@ -1203,7 +1203,7 @@
         "shadows": 2,
         "exactDuplicates": 103,
         "inlineStyles": 117,
-        "arbitrary": 1751,
+        "arbitrary": 1753,
         "nearPairs": 12,
         "important": 0,
         "neverImported": 26,
@@ -1213,7 +1213,7 @@
     {
       "repo": "triggerdotdev/trigger.dev",
       "designSystem": "custom",
-      "codeFiles": 2366,
+      "codeFiles": 2369,
       "metrics": {
         "colors": 137,
         "greys": 18,
@@ -1254,7 +1254,7 @@
     }
   ],
   "referenceSystems": {
-    "builtAt": "2026-08-03T16:33:34.617Z",
+    "builtAt": "2026-08-03T22:23:19.377Z",
     "count": 10,
     "note": "Curated scoped scans of reputable public design systems. Not comparable head-to-head with product repos: see per-system notes.",
     "stats": {

package/skills/roast-my-design-system/scripts/diagnose/index.mjs

@@ -36,7 +36,7 @@ const GK_MASK = 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAYAAACqa
 const GK_MARK = 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAIAAAD8GO2jAAAACXBIWXMAAAAAAAAAAQCEeRdzAAACPklEQVR4nOVWTYh5URR/PlJYEKV8LKwkZalsmI2dZmMnK8pKmaZ87JSanexEkayUhSxsZyfJNBQ7UYqVhSShfM+v/6mXmtU81+p/Frfze+/d3++ce88993Hcf2cikehZ1GazWafTPUVDLBZjLBQKnU6HMTVvcrl8Op3ebrdsNgsokUiYUVP4Pp/v9s96vd79cwZGK95sNkkgGAwC2u12lhrY3u12C/b1ei2TyV5eXjabjV6vZ6BBa51MJin8arUKWKlU4H99fSkUCo5JUQ2HQxJwuVzIYLVawcdIVSs8CQoNpMQ+Go0Aw+EwwXw+D+h2u4Vr0LRSqUSMqVQKsN1uE3Q4HEql8ng8BgIBTnDhqlSqxWIBuvP5bDAYLBbL5XIBHAwGeBuJRODvdjun0/nnPOjraDRK8TYaDcBMJkMwFosBfn9/E0wkEn9OgjYgnU6fTidQwAGcTCbw9/u9VqvFUYB/vV5RskajkRNcTiaTKR6PI9j5fE7xlstlPM/lcgTr9ToneJ/5oOB4PB70O8Tb7/f9fv9sNqPkXl9fhQsQ9f1ktVqNvUVCxA6ZRxsf5pMAxnsuVBSOwvv7+6Phk0PsBNn0OOLC9haLReqdvBL/wUNKNPnt7Q0LjeVutVqhUEij0TwU9W8BVA4JUEUul8tarcZGhpbIarWiSeA0HQ4Hkvn4+GB56VMvov6DA+z1eplR89btdsE+Ho9tNhv3jOv+8/MTFz06M3ypVMqMnTfcwPhn4djG/tue+Mf4RGom9gMt6lAx16huIwAAAABJRU5ErkJggg==';
 
 // Shown in the report footer; keep in step with plugin.json when releasing.
-const VERSION = '3.9.0';
+const VERSION = '3.10.0';
 
 // Report identity. The scan id is a stable digest of this scan's shape, salted
 // with the report namespace, so the same repo scanned twice reads the same and

package/skills/roast-my-design-system/scripts/harvest/walk.mjs

@@ -29,8 +29,17 @@ const TEST_FILE_RE = /\.(test|spec|stories|story|cy)\.[cm]?[jt]sx?$/;
 const CODE_EXTS = new Set(['.tsx', '.jsx', '.ts', '.js', '.mjs', '.cjs']);
 const STYLE_EXTS = new Set(['.css', '.scss', '.sass', '.less']);
 
-/** Walk the repo, returning relative paths bucketed by role. Depth-capped. */
-export function walkRepo(root, maxDepth = 8) {
+/**
+ * Walk the repo, returning relative paths bucketed by role.
+ *
+ * Depth-capped as a guard against pathological trees, not as a scoping choice.
+ * The cap has to clear a monorepo's own overhead: two levels are spent reaching
+ * apps/web before the app's routes even begin, and a Next.js route can nest six
+ * deep on its own. At 8 that silently dropped 11-12% of the files in dub,
+ * twenty and formbricks. Measured across the fleet, file counts stop growing at
+ * 12; 14 leaves headroom. Single-package repos are unaffected either way.
+ */
+export function walkRepo(root, maxDepth = 14) {
   const files = { code: [], styles: [], other: [] };
   const recurse = (dir, depth) => {
     if (depth > maxDepth) return;