# DESIGN.md Setup Guides

> Agent-specific setup guides with step-by-step configuration for AI coding tools.

## TL;DR

Copy a DESIGN.md from the library, place it at your project root, and add a one-line reference in your agent config. Each guide below shows the exact steps for your specific AI coding tool.

## Quick Reference

| Agent | Config File | Setup |
|-------|-------------|-------|
| Claude Code | CLAUDE.md | Add reference to DESIGN.md |
| Cursor | .cursor/rules | Create rule pointing to DESIGN.md |
| Kiro | .kiro/steering/ | Place DESIGN.md in steering directory |
| Windsurf | global_rules.md | Add reference to DESIGN.md |
| Google Stitch | Native | Export directly from Stitch |

## What Each Guide Covers

Each setup guide includes:

1. **Prerequisites** — What you need before starting
2. **Step-by-step setup** — Exact commands and file locations
3. **Verification** — How to confirm the agent reads the DESIGN.md
4. **Troubleshooting** — Common issues and solutions

## Do I need a different setup for each AI agent?

Yes. Each AI agent reads project files differently. Claude Code uses CLAUDE.md, Cursor uses .cursor/rules, Kiro uses .kiro/steering. The DESIGN.md file is the same, but the reference path varies.

## How long does it take to set up DESIGN.md?

About 5 minutes. Copy a DESIGN.md from the library, place it at your project root, and add a one-line reference in your agent configuration file.

## Getting Started

1. Browse the library at https://designmd.app/library
2. Choose a style that matches your project
3. Copy the DESIGN.md content
4. Place it at your project root
5. Follow the guide for your specific agent

## Related Resources

- https://designmd.app/library — 759+ documented DESIGN.md files
- https://designmd.app/integrations — Integration details for each agent
- https://designmd.app/faq — Common questions about DESIGN.md
- https://designmd.app/developers — API documentation

---
Source: https://designmd.app/guides