Can I use the DESIGN.md for Codex DESIGN.md with Cursor, Claude Code, or Codex?

Yes. Copy the DESIGN.md file into your project root and reference it in your agent rules. For Cursor, add it to .cursor/rules. For Claude Code, include it as CLAUDE.md. For Codex, add it to your system prompt. The agent will read it and apply the DESIGN.md for Codex visual system to any UI it generates.

What is a DESIGN.md file?

A DESIGN.md file is a Markdown document that describes a product's visual design system — color palettes, typography, spacing, and component patterns — in a format that AI coding agents like Cursor, Claude Code, and Codex can read and follow when generating UI.

How do I add the DESIGN.md for Codex DESIGN.md to my project?

Download or copy the DESIGN.md file from this page and place it in your project root. Then instruct your AI agent: "Read the DESIGN.md file in this project and follow its design system when generating UI." The agent will pick it up automatically in Cursor, Claude Code, Codex, and most modern AI coding tools.

DESIGN.md for Codex

Editorial starterPractical workflow notes for AI coding agents

Dima Braven·Jan 15, 2026

A practical pattern for pairing AGENTS.md engineering rules with DESIGN.md visual rules.

toolscodexworkflowdesign-md

CursorClaude CodeCodexGoogle Stitch

# DESIGN.md for Codex

## What this is
This workflow pairs Codex repository instructions with a dedicated visual memory file. It is for frontend implementation tasks where the agent must understand both engineering gates and product taste.

Use it when AGENTS.md already exists and you want a clean place for visual rules without making engineering instructions too noisy.

## Editorial status
This is a DesignMD-authored starter pattern, not a file published or endorsed by OpenAI. It shows how to combine Codex repository instructions with product-owned visual rules.

## Why this page exists in DesignMD
This reference is not a scraped brand style page. It is a workflow page for teams that want to pair OpenAI Codex Help Center with a durable DESIGN.md file.
Use it when an AI builder needs visual taste before it edits Tailwind classes, creates React components, or turns a prompt into a working interface.
The goal is practical: make the agent read a small design contract before it starts guessing color, density, hierarchy, radius, and component behavior.

## How DESIGN.md fits the workflow
- Keep AGENTS.md as the operating contract for commands, safety, and close-out.
- Keep DESIGN.md as the visual contract for product screens.
- Ask Codex to inspect both files before editing UI.
- Require screenshots for visible surfaces and command gates for repo correctness.
- After completion, update memory docs if product behavior or design conventions changed.
- Keep DESIGN.md close to the source code, usually in the project root or beside the frontend app that owns the product surface.
- Treat the file as a living design contract. Update it after visual decisions change, not only after a full redesign.
- Reference the file explicitly in your coding-agent instructions so it is read before UI work begins.
- Prefer concrete values over adjectives. Agents follow `--radius-card: 8px` more reliably than "make it polished".
- Pair visual rules with acceptance checks: responsive behavior, hover states, empty states, error states, and accessibility.

## Recommended DESIGN.md structure
A useful DESIGN.md for this workflow should be readable by a human reviewer and precise enough for an agent.

### Product feel
- Define the product category and emotional target in one paragraph.
- Name what the interface should avoid, not only what it should become.
- Include the density target: sparse marketing, focused SaaS, data-heavy console, or code-first tool.

For makers

Get your product in context

Add your tool/site or create the DESIGN.md first. Every listing is reviewed before publication.

Add your tool/site · $19 Create my DESIGN.md

See full pricing

Design System Overview

This editorial starter was written by DesignMD to make an AI-agent workflow concrete. It is independent guidance, not an official product design file or an endorsement from the linked tool vendor.

Use it as a starting contract for repository instructions, visual tokens, component behavior, and review checks. Adapt the values to your product instead of copying them as a vendor-owned brand system.

Browse more developer tools and IDEs design systems or explore the full DESIGN.md directory.

Color System

Starter semantic tokens for this editorial workflow — not an official vendor palette. Click any swatch to copy the hex value.

Text / Primary

#111827

Accent

#8B5CF6

Surface / Background

#F5F3FF

Border / Subtle

#DDD6FE

Typography Specimen

Display

2.8rem / 700 / 1.04

The quick brown fox

Heading H1

2rem / 700 / 1.1

The quick brown fox jumps

Heading H2

1.5rem / 600 / 1.15

The quick brown fox jumps over

Heading H3

1.125rem / 600 / 1.2

The quick brown fox jumps over the lazy

Body

1rem / 400 / 1.5

The quick brown fox jumps over the lazy dog

Small / Caption

0.75rem / 400 / 1.5

The quick brown fox jumps over the lazy dog and sat down.

Monospace

const primary = "System";

Layout & Spacing Tokens

Spacing Scale

space-14px

space-28px

space-312px

space-416px

space-624px

space-832px

space-1248px

space-1664px

Border Radius

radius-none0px

radius-sm4px

radius-md8px

radius-lg16px

radius-xl24px

radius-full9999px

Elevation & Shadow

Flatshadow-none

XSshadow-xs

SMshadow-sm

MDshadow-md

LGshadow-lg

XLshadow-xl

Use with AI Coding Agents

Copy one of these prompts into your AI coding agent to apply the DESIGN.md for Codex design system to your project. The DESIGN.md file in your repo root is the source of truth.

# .cursor/rules (or DESIGN.md)
You are working in a project that uses the DESIGN.md for Codex design system.

Read the DESIGN.md file in this project root and follow it strictly when generating UI.
Match the brand's exact colors, typography, spacing scale, and border radius.
Do not create generic Tailwind UI — apply the visual language from DESIGN.md.

Key rules:
- Use the defined color palette, not arbitrary hex values
- Apply the correct font family and weight scale
- Follow spacing tokens (4/8/12/16/24/32px scale)
- Match component patterns: buttons, cards, inputs, badges as specified