JM Family Design System
AI Toolkit

Agent Kit

A portable bundle of design tokens, principles, and agent directives that product teams drop into their own repos. It lets coding agents build UI that conforms to this design system, even when they can't see the source.

v1.0.0Generated 2026-05-3115 files51.0 KB zipped
Download agent-kit.zip

What’s inside

Every file in the kit is generated from the same source of truth that powers this web app. When the design system changes, re-download the kit to refresh your product’s copy.

  • accessibility-basics.mdWCAG 2.2 AA rules with concrete wrong → right examples.3.0 KB
  • AGENTS.mdSection to append to your repo’s AGENTS.md. Concrete read-X-then-do-Y directives.3.4 KB
  • anti-patterns-by-category.jsonAnti-pattern catalog grouped by category for browse contexts.31.7 KB
  • anti-patterns.jsonFlat anti-pattern catalog for review and generation guardrails.27.4 KB
  • CHANGELOG.mdWhat changed in each release of the kit.843 B
  • compliance-checklist.mdPreconditions an agent must verify before producing UI.2.6 KB
  • content-standards.mdVoice, tone, terminology, and inclusive language rules.2.4 KB
  • design-principles.mdThe principles every UI decision must defend against.2.2 KB
  • design-tokens.cssCompiled CSS custom properties for light and dark themes. Drop into a global stylesheet.11.4 KB
  • design-tokens.jsonAll tokens (color, typography, spacing, shadow, motion, layout) as machine-readable JSON.66.9 KB
  • pattern-registry.jsonComposition patterns with anatomy, variants, examples, accessibility, and implementation rules.57.0 KB
  • principles.jsonStructured design-principle metadata for machine-readable cross-references.3.2 KB
  • README.mdOverview of the kit, what is inside, and how to install.2.6 KB
  • ux-workflow.mdHow features move from empathy to implementation.2.2 KB
  • version.jsonKit version and generation timestamp.117 B

Install in a product repo

  1. Download and unzip the bundle into docs/design-system/ at the root of your product repo.
  2. Open AGENTS.md from the kit and copy its contents into theAGENTS.md at your repo root. Create the file if it does not exist. It is written as an appendable section.
  3. Commit. The next time any coding agent runs in your repo, it will see the kit and the directives in AGENTS.md.

Keeping it up to date

The kit is a snapshot. Re-download it whenever you start a new feature or whenever the version in your product’s version.json is older than 90 days. Check CHANGELOG.md first to see what changed. A future release will distribute the kit as npx @company/ds-agent-kit update so updates are one command.

Not in this release

  • Component registry. The design system does not yet ship a component package, so the kit cannot point agents at real imports. Coming when components ship.
  • npm distribution. The downloadable zip is v1. An npx installer is on the roadmap.