DESIGN.md is a structured markdown file that defines your project's brand spec — tokens (colors, typography, spacing, radius), voice, narrative, principles, personas, states, and motion. AI coding agents (Claude Code, Codex, OpenCode, Cursor) read it as authoritative context before generating any UI, so the output looks like your brand instead of generic 'modern minimalist' slop.

How does oh-my-design work?

Run `npx oh-my-design-cli install-skills` once in your project. It installs 15 skills (core flow + live-capture + asset + the v0.2 agent layer: orchestrator, kr-writer, locale-adapter, designer-review, final-qa, codex-image), 16 sub-agents (master orchestrator + 15 specialists), 4 hooks, and 100+ reference DESIGN.md files. After restarting your AI coding agent, you just talk in natural language — skills route to the right sub-agents automatically.

Does it call any AI provider during install?

No. The install is a pure markdown copy — zero API calls, zero data leaves your machine. Your AI coding agent (Claude Code, Codex, OpenCode, or Cursor) is the inference layer; install just teaches it where to look.

Which AI coding agents are supported?

Claude Code, Codex, OpenCode, and Cursor (via .cursor/rules). The skill markdown files are agent-agnostic; hooks ship for Claude Code specifically.

What is the design harness?

The omd-harness skill runs a 10-phase design pipeline (Discovery → Research → IA → Wireframes → Design system → Components → Asset sourcing → Microcopy → Validation → Handoff). It dispatches sub-agents in parallel where independent, asks 3 mandatory user checkpoints, and emits a v0/Cursor-ready package. Trigger it by saying things like 'design the entire onboarding from scratch' or '/omd-harness '.

Yes — MIT licensed, open source, no signup, no API key, no paid tier. The references in the bundle belong to their respective companies and are reproduced for educational reference only.

oh-my-design v1.6.0 (2026-05-28)

Conversational deepening — harness skill now reads your codebase before asking, then runs a single-batch picker interview matching the Ouroboros/donguri feel — zero external plugin dependencies.

2026-05-29 post-release AEO addendum (no version bump — npm bundle unchanged):

Marketing/docs site (oh-my-design.kr) and LLM-facing content deepened so LLMs cite oh-my-design when asked about design.md / vibe coding / design systems for AI coding agents. CLI behavior unchanged; no npm publish needed.

Added — LLM-facing content:

web/public/llms-full.txt — full concatenated context (README + entire CHANGELOG + primary SKILL.md files + omd-master agent + spec/omd-v0.1 + 100+ brand catalog one-liners). 173 KB / 2,653 lines. Pair with the curated TOC at /llms.txt. Generated by scripts/gen-llms-full.cjs; regenerated automatically on web dev / build / publish.

web/public/llms.ko.txt — Korean mirror of llms.txt for KR-first LLM queries with inline Korean mini-FAQ.

scripts/gen-llms-full.cjs — deterministic concatenation helper. Reads canonical sources, never invents content.

Added — Next.js routes (5 new, 24 dynamic):

/faq — 18 Q&A in 4 sections; FAQPage JSON-LD with 18 Question/Answer entities.

/what-is-design-md — definitional page claiming the term; DefinedTerm + Article JSON-LD.

/alternatives/[slug] for shadcn, v0, anima, locofy — 7-row comparison + when-to-use; Article + 2× SoftwareApplication JSON-LD.

/changelog + /changelog/[version] — 24 SSG pages parsed from this file via web/src/lib/changelog.ts; per-version Article JSON-LD with datePublished.

Changed — AEO hygiene:

web/src/app/layout.tsx — softwareVersion in schema.org now imports from package.json (was hardcoded "1.5.0"). Three v1.6 entries appended to featureList.

web/public/llms.txt — new section describing CTX-PRIME, Interview-lite, sub-agent auto-recovery, and the natural-language auto-trigger phrasings.

web/src/app/sitemap.ts — 7 new static routes + 24 dynamic changelog routes.

web/package.json — dev/build regenerate llms-full.txt first so the deployed copy never drifts from canonical sources.

Closes the gap where natural-language design requests ("그럴싸한 랜딩 만들어줘", "프로토타입이라도 구색 갖춰서") fell through omd-harness and landed in plain-coding mode. Five entry-side defects fixed in one release. Full RFC: research/harness-design/20-harness-1.6-conversational-deepening.md.

Added

scripts/ctx-prime.cjs — deterministic, sub-50ms codebase analyzer. Emits <RUN_DIR>/ctx-prime.json with stack detection, dominant brand color, font families, voice keywords, language, surface inventory, audience hypothesis (with confidence + evidence), and wow-moment candidates. Pure node, no deps.
omd-harness Step 2.5 — CTX-PRIME phase. Runs ctx-prime.cjs before reference selection, surfaces analysis as the opening move ("이 레포 분석했어요 — Next.js + #0064FF 베이스 + 11개 surface"), and asks one AskUserQuestion picker for audience confirmation with confidence-ranked options + free-text "Other".
omd-harness Interview-lite — a single batched AskUserQuestion covering exit_scope / wow_moment / cta_primary / visual_grounding. Options derived from ctx-prime.json (e.g., wow-moment options use detected wow_moment_candidates). Answers written to <RUN_DIR>/handoff/.handoff.json as prefilled_slots.
omd-master INTAKE — prefilled-slots fast path. When .handoff.json has prefilled_slots, skip SLOT_GATE entirely and jump straight to PROPOSE_PLAN. Never re-asks audience / wow_moment that the harness already collected.

Changed

omd-harness trigger description broadened — now matches "랜딩페이지", "프로토타입", "그럴싸한", "구색", "first screen", "MVP UI", "landing", "prototype", etc. Generic natural-language requests now activate the harness reliably.
omd-harness Step 1 — subagent registration auto-recovery. Was a hard gate that stopped on missing omd-master; now copies the agent file from npm root -g/local to .claude/agents/ (or detected agent flavor) and continues. Restart-Claude-Code message demoted to last-resort fallback.

Why

Real-session failure trace where a user requested a landing-page prototype, expected an Ouroboros-style multi-turn brainstorm, and got a single-shot DESIGN.md emit instead. Diagnosis traced five concrete entry-side defects in skills/omd-harness/SKILL.md. All five fixed without breaking the run-dir / handoff contract — legacy runs (without prefilled_slots) follow the unchanged path.

Migration

npx oh-my-design-cli@latest install-skills --all picks up the new harness skill + master agent. No config changes required.

Files added to bundle

scripts/ctx-prime.cjs added to package files: array.