# create-design-md

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.

- command · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 406 repo stars
- Author: syahiidkamil
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/syahiidkamil/Software-Engineer-AI-Agent-Atlas/tree/HEAD/.claude/commands/design/create-design-md.md
- Updated: 2026-11-01
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/commands/create-design-md

## What it 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.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/commands/create-design-md.md` — Call it with /create-design-md. For all projects use ~/.claude/commands/

### Codex

**Manually: put the files in place**
- File: `~/.codex/prompts/create-design-md.md` — Call it with /prompts:create-design-md. Codex marks this format deprecated in favour of skills

### GitHub Copilot

**Manually: put the files in place**
- File: `.github/prompts/create-design-md.prompt.md`

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/create-design-md.toml` — Gemini stores commands as TOML: the prompt text goes into the prompt field

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/syahiidkamil/Software-Engineer-AI-Agent-Atlas/tree/HEAD/.claude/commands/design/create-design-md.md

## When to use it
- 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
- 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

## Similar
- [design-system](https://affpapa.org/en/nevibecode/skills/builderos-design-system.md) — skill · 1900 installs
- [stitch::generate-design](https://affpapa.org/en/nevibecode/skills/stitchgenerate-design.md) — skill · 12500 installs
- [stitch-design](https://affpapa.org/en/nevibecode/plugins/stitch-design.md) — plugin · ★ 11481 repo stars
- [stitch-design-taste](https://affpapa.org/en/nevibecode/skills/stitch-design-taste.md) — skill · 799 installs
- [interaction-design-board](https://affpapa.org/en/nevibecode/skills/interaction-design-board.md) — skill · 213 installs
- [design-system-context](https://affpapa.org/en/nevibecode/skills/design-system-context.md) — skill · ★ 126 repo stars

From the same set: [syahiidkamil/software-engineer-ai-agent-atlas](https://affpapa.org/en/nevibecode/by/syahiidkamil/software-engineer-ai-agent-atlas.md) — 26 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
