Skip to content
Bhargav Tibadiya

Guidelines

Ship on-spec, every time.

Everything you need to bring Agent Design Protocol into your own AI coding workflow: what each file contains, and how to wire it into your agent. For common questions, see the FAQ.

Files to download
2
Setup steps
5
Local install required
None

Are you an AI agent? Read the guidelines as Markdown at /guidelines.md.

Documentation guide

Why this exists

AI coding agents generate UI inconsistently. One prompt gives you 12px border-radius; the next gives 4px. Colours drift. Fonts randomize. Shadows become whatever the model hallucinates.

Agent Design Protocol solves that with locked-down, token-complete design systems. Each system ships as two files: a design system spec and a companion instructions file, that together act as a strict contract any agent must follow.

What you get per design system

Every theme in the catalog ships as two downloadable files:

  • design-system.md: CSS custom properties, colour palette, typography, spacing, border-radius, shadows, component specs, layout grid, animations, breakpoints, and state definitions.
  • instructions.md: design philosophy, font laws, colour rules, anti-pattern lists, AI prompting guides, component build guides, checklists, and decision trees.

Pick a theme that fits your product

Browse the Design Systems catalog and preview the live component showcase before you download. Match personality to product: brutalist for dev tools, editorial for publishing, pill UI for dark dashboards, monospace for monitoring, and so on.

  • Sharp: brutalist, zero radius, dev tools and dashboards
  • Editorial: warm cream, serif display, publishing and CMS
  • Rounded: friendly curves, SaaS and productivity apps
  • Capsule: dark pill UI, DevOps and CI/CD
  • Luxury Editorial: gold accent, fintech and enterprise
  • Mono: terminal dark mode, monitoring and API consoles

Guidelines for using Agent Design Protocol

Five steps from download to your first on-spec prompt. Work directly with the files in your own project: no local setup of this website required.

Download design-system.md and instructions.md

Open the Design Systems catalog, choose your theme, and use the two download buttons on the system detail page. Save both files locally: design-system.md is the token spec, instructions.md is the agent construction manual. Download directly from the catalog; you do not need to run this website locally.

Create the rules folder in your project

Create the folder your AI tool reads from. Cursor uses .cursor/rules/. Claude Code, Codex, Copilot Chat, and other agents typically use docs/design-system/ at the project root. Put both downloaded files in that folder.

Cursor
your-project/
  .cursor/
    rules/
      design-system.md
      instructions.md

Other tools: use docs/design-system

If you are not using Cursor, create docs/design-system/ and place the same two files there. Keep filenames exactly as downloaded so the agent can find them.

docs/design-system
your-project/
  docs/
    design-system/
      design-system.md
      instructions.md

Add the agent-design-protocol rules file

Create agent-design-protocol.md in the same folder as the two spec files. This rules file tells the agent that design-system.md and instructions.md live in the same directory, must be applied before every chat, and must be followed strictly. Copy the template below or download it.

agent-design-protocol.md
# Agent Design Protocol: Project Design Rules

> Place this file in the same folder as design-system.md and instructions.md.
> Cursor: save as .cursor/rules/agent-design-protocol.md
> Other tools: save as docs/design-system/agent-design-protocol.md

---

## Folder contents (required)

This directory must contain exactly these companion files:

Start every design chat with the rules loaded

Paste this opener at the start of any UI task. It points the agent at the three files in your rules folder and sets non-negotiable constraints before any code is generated.

Prompt opener
I'm building [describe your feature or page]. Use the design system in this project.

Before writing any UI code:
- Read agent-design-protocol.md, design-system.md, and instructions.md from the same folder
- Apply all three files to this task

Constraints:
- Follow ALL rules from design-system.md and instructions.md
- Cross-reference the anti-pattern list before finalizing
- Use only CSS custom properties from the master token sheet