DESIGN.md, OmD, vibe coding

DESIGN.md는 프로젝트 루트에 두는 휴대 가능한 디자인 계약입니다. Core v2는 경험, foundations, typography·assets, components·states, layout·platforms, content·locales, governance의 7개 영역만 간결하게 보여 줍니다. 파일 자체에는 특정 도구 메타데이터가 없어 Claude Design, Open Design, 일반 채팅과 코딩 에이전트에 그대로 전달할 수 있고, 더 정밀한 자동화가 필요할 때만 .omd/system의 구조화 그래프와 provenance·coverage가 옆에서 보강합니다.

oh-my-design(OmD)은 DESIGN.md 스펙과 그 스펙을 실제 제품 작업에 적용하는 워크플로 번들입니다. `npx oh-my-design-cli@latest`를 실행하면 사용 중인 도구를 감지해 22개 제품 스킬, 19개 전문 역할 정의, 440개 레퍼런스 중 각 채널이 지원하는 구성을 설치합니다. /docs 페이지에서 결과별 사용법과 전체 파이프라인을 볼 수 있습니다.

보통의 디자인 시스템은 사람이 읽고 컴포넌트를 직접 구현하기 위한 문서지만, DESIGN.md는 AI agent가 매 prompt마다 읽고 코드로 번역하는 단일 source of truth입니다. 토큰뿐 아니라 voice·tone·persona·motion까지 한 파일에 묶어 agent가 "브랜드 없는 평균 UI"로 회귀하지 않도록 막습니다.

Claude Code, Codex, OpenCode, Cursor가 1차 타깃이고 Gemini CLI도 동작합니다. skill 파일은 agent-agnostic markdown이라 새 agent가 등장해도 동일한 DESIGN.md를 그대로 읽도록 설계됐습니다. Cursor 2.4+에는 전용 채널(`--agent cursor`)로 호환 스킬 21개, 작은 DESIGN.md bootstrap rule, 공용 레퍼런스 카탈로그가 설치됩니다.

Vibe coding은 정확한 코드 지시 대신 "이런 느낌으로 만들어줘"라는 자연어 의도만 던지고 agent가 알아서 구현하는 흐름을 가리킵니다. 이 방식은 빠르지만 brand context가 없으면 결과물이 평균값에 수렴합니다. DESIGN.md는 vibe coding의 그 "느낌"을 검증 가능한 형태로 고정해 두는 장치입니다.

프로젝트 루트에서 `npx oh-my-design-cli@latest`를 실행하고 감지된 코딩 에이전트 채널을 고르세요. 설치 중 외부 AI API 호출은 발생하지 않습니다. 이어서 `npx oh-my-design-cli@latest doctor`로 구성을 확인하고 에이전트를 한 번 재시작하면 됩니다. 자세한 흐름은 /docs를 참조하세요.

네. Cursor 2.4+ 채널은 `.cursor/skills/`에 호환 Agent Skills 21개를 설치하고, 작은 `.cursor/rules/omd-design.mdc` bootstrap과 공유 레퍼런스 카탈로그를 더합니다. 별도 전문 에이전트 정의와 hooks는 설치하지 않습니다. 구형 Cursor는 `--cursor-rule-only` 호환 모드를 쓸 수 있고, doctor가 두 구성을 각각 검사합니다.

네. MIT 라이선스 오픈소스이며 npm 패키지 하나로 끝납니다. 유료 tier는 존재하지 않고 만들 계획도 없습니다. 440 reference는 각 회사 자산이며 교육용 reference로만 수록돼 있습니다.

아니요. OmD는 추론 layer가 아니라 skill·markdown 파일을 사용자 머신에 복사하는 CLI일 뿐입니다. 모든 디자인 생성은 사용자가 이미 쓰고 있는 AI agent(Claude Code, Cursor 등) 안에서 일어나고, OmD 자체는 어떤 텔레메트리도 수집하지 않습니다.

shadcn/ui는 React 컴포넌트를 복사-붙여넣기하는 라이브러리고, brand opinion이 거의 없습니다. DESIGN.md는 컴포넌트가 아니라 "브랜드가 어떻게 생기고·들리고·움직여야 하는가"를 정의하는 스펙입니다. 둘은 충돌하지 않고 함께 씁니다 — shadcn 컴포넌트를 DESIGN.md token으로 채색하는 식이 가장 흔합니다.

v0는 prompt에서 즉석으로 UI snippet을 합성하는 서비스로, 설치되는 spec이 없고 결과물은 prompt마다 휘발됩니다. DESIGN.md는 repo에 영구히 박혀 매 요청마다 같은 brand context를 강제합니다. v0로 만든 결과물을 DESIGN.md token으로 다시 칠하는 워크플로도 가능합니다.

Anima·Locofy는 Figma 디자인을 코드로 변환하는 transcoder입니다. Figma 파일이 source of truth고 코드는 산출물입니다. DESIGN.md는 그 반대로 markdown spec이 source of truth고 코드·Figma·UI 모두 산출물입니다. Figma → 코드 일회성 변환이 아니라 매 요청마다 갱신되는 살아있는 spec입니다.

Google이 공개한 DESIGN.md 제안은 중요한 호환 대상이지만 Core v2와 같은 공식 규격이거나 단순한 상위집합은 아닙니다. OmD는 Google 계열 문서를 읽고 내보낼 수 있는 compatibility profile을 유지하면서, 보이는 DESIGN.md는 도구 중립적인 7개 영역으로 줄이고 구조화 토큰·근거·플랫폼 profile은 sidecar에 둡니다. 그래서 Google 도구에 전달하기 쉽고, 다른 에이전트에서도 한 업체의 확장 문법에 묶이지 않습니다.

getdesign.md는 여러 브랜드의 DESIGN.md를 빠르게 둘러보고 복사하는 데 강합니다. oh-my-design은 한국·글로벌 레퍼런스를 증거 수준과 surface별로 분리하고, 알려지지 않은 값은 채우지 않은 채 Core v2로 이식합니다. 여기에 기존 코드에서 시스템을 추출하거나 새 시스템을 구축하는 skills·전문 역할·검증 하네스를 연결하고, 구조화 graph와 locale·platform·asset coverage까지 검사합니다. 즉 카탈로그의 넓이보다 참고 근거에서 실제 구현과 검증까지 이어지는 경로에 초점을 둡니다.

네. oh-my-design은 한국 브랜드 디자인 시스템을 핵심으로 다룹니다. 토스·당근(Karrot)·배민·카카오·네이버·쿠팡·무신사·뱅크샐러드·29CM·컬리 등 국내 브랜드의 DESIGN.md를 한국어 문서로 제공합니다. 서구권 브랜드 위주의 영어 카탈로그(getdesign.md 등)에는 대부분 없는 부분이며, 이 한국 브랜드 깊이가 oh-my-design의 가장 큰 차별점입니다.

네. `/omd-add-reference <URL>` skill이 3-tier 검증 파이프라인으로 라이브 사이트를 읽어 `references/<id>/DESIGN.md`를 새로 만듭니다. Tier 1은 공식 design system, Tier 2는 보조 inspect, Tier 3은 cross-check입니다. 자체 brand면 자기 회사 사이트 URL만 넘기면 됩니다.

권장합니다. DESIGN.md는 사람과 agent 모두 읽도록 만든 markdown입니다. 직접 수정한 부분은 `omd-sync`가 보존하고, agent가 새로 생성한 부분만 갱신됩니다. 별도 빌드 단계는 없습니다 — 저장 즉시 다음 prompt부터 반영됩니다.

OmD 자체는 MCP server를 띄우지 않습니다. skill·sub-agent·hook으로 동작하는 게 의도된 아키텍처입니다. 다만 `omd-3d-blender` 같은 일부 sub-agent가 외부 MCP server(blender-mcp 등) 설치를 안내할 수 있습니다.

네. `/omd-harness <task>` 명령이 10-phase 파이프라인을 돌면서 16개 sub-agent를 dispatch하고, Discovery·Components·Handoff 3개 checkpoint에서 사용자 확인을 받습니다. 각 phase의 산출물은 `.omd/runs/<id>/`에 남아 다음 턴에서 그대로 재사용됩니다.

있습니다. `omd-kr-writer` skill이 12개 한국어 voice preset(toss-tech-design / karrot-neighborly / brunch-maker / naver-d2 / biz-report / academic 등)을 가지고 있고, 각 preset마다 9-field voice spec이 정의돼 있습니다. "토스 톤으로", "당근 톤으로" 같은 자연어로 호출하면 됩니다.