kwakseongjae/oh-my-design

해결하는 문제

코딩 에이전트는 일관된 디자인 시스템을 유지하는 데 어려움을 겪는 경우가 많으며, 이는 통합된 철학이나 접근성 및 브랜드 표준에 대한 엄격한 준수 없이 UI 컴포넌트가 생성되는 '디자인 슬롭(design slop)' 현상으로 이어집니다. 이 프로젝트는 리포지토리 내에서 직접 디자인 시스템을 정의, 강제 및 문서화할 수 있는 구조화된 에이전트 네이티브 프레임워크를 제공합니다.

작동 방식

이 시스템은 AI 에이전트가 '철학 → 결정 테이블 → 토큰 → 컴포넌트 계약 → 레이아웃 문법'이라는 엄격한 도출 체인을 따르도록 강제합니다. DESIGN.md 파일을 진실의 원천(source of truth)으로 사용함으로써, 에이전트는 명시적인 규칙과 '슬롭 게이트(slop gates)'에 의해 제약되어 임의의 스타일을 생성하지 못하게 됩니다. CLI는 이러한 파일을 검증하고, 로컬 문서 사이트(omd book)를 호스팅하며, Claude Code, Cursor, OpenCode와 같은 인기 있는 코딩 에이전트와의 통합을 관리하는 도구를 제공합니다.

대상 사용자

이 도구는 AI 코딩 에이전트를 사용하여 UI를 구축하고, 해당 에이전트가 공식 디자인 시스템을 준수하는 고품질의 브랜드 일관성을 갖춘 접근 가능한 코드를 생성하도록 보장하려는 개발자 및 팀을 위해 설계되었습니다.

주요 특징

• 에이전트 네이티브 워크플로우: Claude Code, Cursor, OpenCode와 직접 통합되어 디자인 관련 기술과 전문가 역할을 제공합니다.
• 엄격한 강제성: 54개의 '슬롭 게이트'와 8개의 시스템 충실도 게이트가 포함되어 있어, 확립된 디자인 계약에서 벗어날 경우 자동으로 빌드를 실패시킵니다.
• 휴대용 문서화: 사람이 읽을 수 있고 기계가 검증할 수 있는 휴대용 계약서 역할을 하는 DESIGN.md 파일을 생성합니다.
• 풍부한 참조 라이브러리: 500개 이상의 품질이 검증된 기업 디자인 참조 자료에 대한 액세스를 제공하여 신규 프로젝트 시작을 돕습니다.
• 외부 의존성 없음: 핵심 워크플로우는 기존 에이전트 세션 내에서 로컬로 실행되며, 추가 API 키나 MCP 서버가 필요하지 않습니다.