Toolbox
Templates and checklists I use on engagements, plus my open-source tools. Download them and change what you need.
Component contract checklist
Write a machine-readable contract for one component, then let CI prove it: 63 checks, a JSON Schema and a worked Button.
Token layer rules
Lock application code to semantic tokens: 25 testable rules, DTCG 2025.10 token files and ESLint and stylelint gates that run.
Promptable docs template
Write one component page that people and agents both read reliably: 17 fixed sections, 25 writing rules and a linter.
The Moltbook Test
Find out whether agents can use your design system without guessing: 25 checks, 3 levels and a scanner that reports your level.
Decision rights template
Give every design system decision one decider and a deadline: 26 rules, a JSON matrix, a checker and a CODEOWNERS generator.
One-page RFC template
Gate substantial changes with a one-page RFC: 24 checks, five sections, a frontmatter schema and a linter that holds the 400-word page.
Monthly release cadence
Ship on a monthly release train teams can plan around: 22 checks, a calendar generator with .ics, a changeset gate and Changesets 3 config.
Deprecation policy with dates
Deprecate with dates CI enforces: 22 checks, a JSON registry, a checker that fails on overdue removals, notice generation and a codemod.
Focus ring token and usage rules
Define one focus ring as tokens and prove it on every surface: 24 rules, a contrast and area checker, a CSS lint and a pixel test.
Error message template
Write form errors that say what is wrong and how to fix it: 28 rules, a message catalogue, a lint for vague messages and tested markup.
Keyboard-only QA checklist
Test every page and widget without a mouse: 28 checks, keyboard scripts for 7 widgets as data and a Tab walk that finds traps.
Framework decision matrix
Choose between React wrappers and native web components: 25 criteria and rules, a weighted matrix and a scorer that shows its working.
Shadow DOM token scoping rules
Let tokens into shadow roots and keep styles from leaking: 24 rules, a 12-check linter for CSS and Lit templates, and a browser probe.
Lit and Storybook starter
Start a web component library that runs: a Lit 3 button, Storybook 10, 19 browser tests and 25 checks, verified from a clean install.
AARRR funnel for design systems
Measure adoption as a funnel you can act on: 25 checks, 11 metric definitions with SQL and a calculator for your event export.
Time-to-first-component benchmark
Time five new developers shipping their first component: 25 checks, a fixed protocol and a script for median, p75 and run deltas.
Component usage Slack bot
Post adoption milestones to Slack from a static scan of main: 22 checks, four zero-dependency scripts and a bot that dry-runs first.
Component doc generation prompt
Turn a component's contract, types and stories into a Field Guide 04 page: 25 checks, a filled prompt and an eval with 10 checks.
AI code review checklist
Review AI-generated UI code against your design system: 38 checks, a PR template and a checker for hallucinated imports and props.
Automation decision framework
Decide whether to automate, assist or avoid a task: 24 checks, a five-criterion rubric with vetoes, a scorer and 13 worked tasks.
Token architecture diagram
Generate the token architecture diagram from your DTCG files: 20 checks, Mermaid and SVG per mode and a CI gate against drift.
Semantic token naming convention
Name semantic tokens by one closed grammar: 22 testable rules, a vocabulary JSON, a name linter and a rename-map generator.
MCP server evaluation checklist
Vet an MCP server before you install it: 36 gated checks, a tool-list scanner with 13 rules and a scorer that says approve or reject.
Claude Desktop MCP starter config
Start Claude Desktop and Claude Code with a small, pinned MCP set: 23 rules, two verified configs and a validator that finds secrets.
MCP permission security review
Review MCP permissions with STRIDE: 27 items, an inventory check that finds the lethal trifecta and a tool diff that catches rug pulls.
MCP integration patterns
Choose single, composed or no MCP at all: 25 rules across five patterns and a working token server on the official TypeScript SDK.
CLAUDE.md structure template
Keep CLAUDE.md to what every session needs: 28 checkable rules, a template under 200 lines and a linter for stale paths and secrets.
Skill file organization
Build Agent Skills that trigger when they should: 28 rules for SKILL.md, descriptions and folders, a worked skill and a 34-check validator.
Task verification checklist
Make agents prove their work: 28 checks from definition of done to report, a verify script and Stop and PostToolUse hooks that enforce it.
Context management decision tree
Decide when to clear, compact, delegate or write notes: 24 sourced decisions, the tree as JSON, a CLI that walks it and a Mermaid diagram.
Design System Adoption Playbook (2026)New
A practical playbook for driving adoption without slowing shipping.
Governance Pack: RACI + RFC template + release checklist
The minimum governance that keeps velocity without chaos.
AI Prompt Library for Design Systems
Copy-paste prompts for documentation, audits and code generation.
For design system accessibility, I use axe-core for component-level testing, Lighthouse for page audits, and VertaaUX (opens in a new tab) for continuous WCAG monitoring across live products. The combination catches issues at different stages: build time, CI and production.
I'm adding new resources based on what teams ask for. If there's a template, checklist or spec that would help your team ship faster, let me know.