프로젝트 소개

oh-my-design은 디자인 시스템을 AI 코딩 에이전트에 가져오는 오픈소스 CLI 도구입니다. 재사용 가능한 스킬, 전문가 역할, 등급 매겨진 회사 디자인 레퍼런스를 기존 코딩 에이전트 워크플로우에 직접 설치하며, 추가 API 키나 데몬, MCP 서버가 필요하지 않습니다. 지원되는 에이전트에는 Claude Code, Codex, OpenCode, Cursor가 포함됩니다. 설치 시 프로젝트에 28개의 스킬, 20개의 전문가 서브에이전트, 440개 이상의 회사 DESIGN.md 레퍼런스가 추가됩니다. 핵심 출력물은 디자인 철학, 고유 ID가 있는 의사결정 테이블, 시맨틱 토큰, 컴포넌트 계약을 담은 휴대용 DESIGN.md 파일입니다. 각 토큰은 그것이 생성된 의사결정으로 거슬러 올라가며, 일관성을 보장합니다. 이 시스템은 상태 행렬을 포함한 컴포넌트 계약(이유와 함께 고의로 제외된 상태 포함)과 접근성 계약도 생성합니다. `omd book` 명령어는 미리보기와 핸드오프를 위해 로컬에서 디자인 시스템을 제공합니다. 파생 체인은 각 디자인 결정이 다음을 제한하도록 보장합니다: 철학 → 의사결정 테이블 → 토큰 → 컴포넌트 계약 → 레이아웃 문법 → 빌드 → 렌더링 비판 → DESIGN.md. 두 개의 번호 지정 게이트가 시스템을 정확히 유지합니다. GS7은 의사결정 참조가 없는 토큰을 거부하고, GS8은 일치하는 프리셋이 존재할 때 처음부터 구축된 컴포넌트를 거부합니다. 54개의 slop 게이트와 8개의 시스템 무결성 게이트가 포함되어 있습니다. 기존 참조 형식은 마이그레이션 중에 읽을 수 있습니다. 이 패키지는 벤더 중립적이고 휴대용인 계약인 DESIGN.md Core v2로 마이그레이션을 지원합니다. 이 형식은 일반 채팅에 붙여넣거나 디자인 도구에 첨부할 때 작동합니다. 설치는 단일 명령어로 가능합니다: `npx oh-my-design-cli@latest`. 설치 후 에이전트를 재시작하고 `doctor` 명령을 실행하여 검증합니다. 워크플로우는 슬래시 명령어가 아닌 자연어 프롬프트를 통해 시작됩니다.