Skip to main content
command CX Codex

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

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/commands/create-design-md.md
Open on GitHub

What 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-md command 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.md

Call it with /create-design-md. For all projects use ~/.claude/commands/

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/.

Similar slash commands

All slash commands for Design →

From the same set26

The whole set →
visual The visual command turns a discussion into a self-contained HTML document with diagrams, wireframes and matrices the agent implements from in plan mode. CX Codex +1 ★ 406repo stars oneshotapp oneshotapp builds a functioning app from a brief idea in Claude Code without human intervention. It logs architecture choices and verifies implementation slices on the fly. CX Codex +1 ★ 406repo stars analyzer analyzer examines blind skill comparisons to explain the winner’s advantage and suggest changes to the losing skill. Run it after the comparator finishes. CX Codex ★ 406repo stars free-will free-will makes the agent stop at a costly fork, lay out real options, test each against evidence and pick one on purpose. CX Codex +1 ★ 406repo stars design Defines visual identity tokens and styling rationale following Google Stitch. Keeps coding agents aligned with design tokens when building user interfaces. CX Codex +1 ★ 406repo stars prototype Turn an early idea into a clickable, multi-screen React prototype through an interview. Use it to test a concept before committing to production work. CX Codex +1 ★ 406repo stars super-product-owner super-product-owner turns vague product ideas into a one-page brief, an interactive prototype, and concrete acceptance criteria. It narrows project scope before any production code gets written. CX Codex +1 ★ 406repo stars super-ui-ux-design The super-ui-ux-design skill guides UI design and critique through UX principles and visual design concepts. Use it when working on websites, apps, or individual components. CX Codex +1 ★ 406repo stars

Project sponsors

Companies that keep this analytics open