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

Breaking release. The CLI surface collapsed from 9 user-facing commands down to 1 (install-skills). All operational logic moved to skill markdown + agent prose. See MIGRATION.md.

Removed

CLI commands: generate, init recommend, init prepare, learn, remember, sync, context, harness, setup-blender, reference list/show, preview.
Public API exports (src/index.ts): detectContext, extractUrl, renderPlan, applyOverrides, loadReference, appendEntry, writeAllShims, all v4 modules. The package no longer ships a programmatic API; use the skill markdown directly.
TypeScript modules (≈ 7000 lines): customizer, preview-generator, recommend, vocabulary, init-deprecate, apply-delta-stub, preferences, shims, sync-lock, sync-marker, run-archive, memory, code-introspect, context-detect, url-token-extractor, plan-emitter, signal-classifier, budget-tracker, visual-anchor, trace, and supporting utility / preset modules.
Tests for removed surface (≈ 480 of 545 retired).

Added

omd-asset-curator agent: stack-aware asset medium selection. Detects framework (Next/Vue/Svelte/etc.), CSS framework, icon libs (lucide/heroicons), chart libs (recharts/chartjs/nivo/etc.), animation libs (framer-motion/lottie/rive). Recommends the best matching medium per asset (inline SVG / chart library / Lottie / Rive / Unsplash / 3D dispatch). Inline SVG recipes for liquid fills, progress indicators, simple icons, empty-state illustrations.
omd-apply skill: explicit dispatch decision tree. Complex requests (assets, charts, screens, a11y, microcopy, persona) now route to specialized sub-agents instead of being handled inline.
scripts/context.cjs: 80-line deterministic project scan helper invoked by master Phase A as a fast cache, optional but preserved for repeatability.
omd-3d-blender agent: just-in-time install walkthrough (uv check → brew install / brew --cask blender → claude mcp add → addon prompt). No longer bundled into install-skills.
MIGRATION.md, this CHANGELOG.md.

Changed

npm tarball ~60% smaller (no preview templates, no stale src/, no preset library).
Dependencies: 9 → 3 (@clack/prompts, commander, picocolors).
package.json: removed main, types, exports fields. Bin-only package.
README rewritten around the single-command flow + agent natural-language pattern.
Skill activation rules: omd-apply triggers tightened (39 → 23) so high-intent requests like "에셋 / 차트 / 아이콘" route to omd-asset-curator instead of being absorbed by omd-apply inline. Orphan omd-add-reference rule removed.

Migration

cd my-project
npx oh-my-design-cli@latest install-skills

Then restart your agent (Cmd+Q + relaunch for Claude Code).

Skill-first

Removed

Added

Changed

Migration