create-design-md — Claude Code command: project visual identity
create-design-md — a command that produces a DESIGN.md file with the project's visual identity: interviews the user, renders three HTML design variants for browser comparison, locks in the chosen direction in Stitch format.
no license ★ 406 updated 2026-11-01
.claude/commands/create-design-md.mdWhat create-design-md does
The command runs an interface design session. The agent interviews the developer about the product and audience, then generates 2–3 self-contained HTML files with distinct visual directions — each with its own typography, colour, and density. Files open with a double-click, no build step required. The chosen variant is locked into .claude/rules/design/{name}.md in Stitch format (YAML tokens + markdown rationale), which other agents read before generating UI.
The command checks for blueprint-prep/ and reads OBJECTIVE.md, VISION.md, sketches from boss-artifacts/sketches/ if present. When .claude/rules/design/{name}.md already exists, the agent offers to refine the current file or replace it, archiving the old version under misc/design-explore/{NN}-{app-name}/PREVIOUS-DESIGN.md. The command takes the app name as an argument.
The rule loads only for files matching the specified pattern (src/**/*.{tsx,jsx,css,html} and similar), leaving backend work untouched. The command implements the Google Stitch DESIGN.md spec.
What it helps with
- lock visual identity in a machine-readable file
- prototype several design directions for side-by-side comparison
- prevent agent drift toward generic UI when generating interfaces
- create a rule that loads only when touching frontend files
- document the visual direction choice for the team
Example prompts for the agent
- Run the
create-design-mdcommand for the TaskFlow app - Generate a design system with
create-design-md dashboard - Produce three visual direction variants for the Loom project
How to install create-design-md
Manually: put the files in place
.claude/commands/create-design-md.mdCall it with /create-design-md. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/create-design-md.mdCall it with /prompts:create-design-md. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/create-design-md.prompt.mdManually: put the files in place
.gemini/commands/create-design-md.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about create-design-md
How do I install create-design-md in Claude Code?
Put the command file in .claude/commands/create-design-md.md at the repository root.
What does the create-design-md command do?
The command produces a project visual identity file: interviews about the product, generates several HTML design variants for comparison, locks the chosen direction into .claude/rules/design/{name}.md in Stitch format.
Can I refine an existing DESIGN.md instead of creating a new one?
Yes. When the file already exists, the command asks whether to refine it or replace it. On replacement, the old version is archived under misc/design-explore/.