Claude Design Md

A canonical CLAUDE.md for Claude Design

A reusable template for the CLAUDE.md file that Claude Design auto-loads at the root of every project. Scoped to **product UI design** — dashboards, apps, admin tools, SaaS interfaces, internal tools, any screen where a person interacts with a product.

Structured around how Claude Design actually parses and weighs these files, not how you might assume it does.

---

Who this is for

Anyone designing UI screens in Claude Design who wants their output to follow project-specific rules consistently. That usually means:

• Product designers working across multiple chats on the same app
• Designers setting up Claude Design for a client or a new project
• Anyone using Claude Design for product work — dashboards, admin UIs, SaaS screens — and tired of re-explaining the project every session
• Teams running Claude Design against an existing design system or codebase who want it respected, not overridden

If you're building marketing sites, editorial brand sites, or long-form content surfaces, the template still works as a starting point — you'll just want to adjust the Don'ts and add a Voice section. The skill that ships with this pack flags this when it runs.

---

What's in this repo

• claude-design-md-generator/ — a Claude skill. Install it, invoke it in any Claude chat, answer 5 questions, and it produces a ready-to-drop-in CLAUDE.md file.
• rationale.md — section-by-section justification for why the template is shaped the way it is. References the research it's built on, flags contradictions with Claude Design's own self-description, documents known limits.
• claude-design-field-notes.md — practitioner observations on using Claude Design as a specialist. Mental model of the tool, how the bias operates, working patterns, and what's worth knowing beyond the marketing page. Written PD-to-PD.

---

How to use it

1. Download the latest .skill file from GitHub Releases.
2. Install i