oh-my-design: Skill for Claude Code

omd:init — DESIGN.md Bootstrap

프로젝트에 DESIGN.md + AI 코딩 에이전트용 shim 3종을 한 번에 세팅. 레퍼런스 톤&매너는 preserve하고, 사용자 프로젝트 맥락은 controlled-vocabulary delta_set으로만 반영.

레퍼런스 선택과 graph draft는 host agent 안에서 처리하지만, Core projection과 authority hash는 직접 만들지 않는다. 설치된 provider-free omd design-md 도구가 inspect/migrate/compile을 담당한다. omd init recommend, omd init prepare, omd sync 같은 별도 runtime subcommand는 제공하지 않는다.

전체 플로우

Phase 1: 사용자 맥락 파악 (1-2 질문)
Phase 2: 레퍼런스 추천 (fingerprint 기반 in-head 점수)
Phase 3: 사용자가 1개 선택
Phase 3.5: 적용 형태 확인 (루트 부트스트랩 / 참고용 저장 / 기존 파일 교체 여부)
Phase 4: 레퍼런스 DESIGN.md Read + delta_set 추출
Phase 4.5: 프로젝트 권위 입력 수집
Phase 5: Core v2 System Graph draft → canonical compiler → staged adopted package
Phase 6: Shim 3종 설치 (omd:sync skill 위임)
Phase 7: 요약 출력

Phase 1 — 맥락 파악

이미 충분한 description이 있으면 skip. 부족하면 최대 2개 질문:

1. 프로젝트 유형/도메인 (SaaS / 랜딩 / 대시보드 / 이커머스 / 커뮤니티 등)
2. 분위기 키워드 (warm, minimal, premium, playful, dense, airy 등)

한 번에 하나씩, 또는 통합해서 한 번에. 질문 쌓지 말 것.

Phase 2 — 레퍼런스 추천 (file-based, no CLI)

2.1 카탈로그 로드

다음 파일을 Read 툴로 전체 로드 (있는 순서대로 fallback):

1. .codex/data/reference-fingerprints.json (Codex 설치 카탈로그)
2. .claude/data/reference-fingerprints.json (Claude Code / Cursor 설치 카탈로그)
3. .opencode/data/reference-fingerprints.json (OpenCode 설치 카탈로그)
4. node_modules/oh-my-design-cli/data/reference-fingerprints.json (npm 설치 직접 경로)
5. data/reference-fingerprints.json (개발 환경)

스키마: { count, items: [{ id, primary_color_hex, category, visual_theme, voice_fingerprint, tone_keywords, antipatterns, signature_motion, has_personas, category_raw }] }.

추가 보조 파일 (있으면 같이 로드):

• 위에서 실제 선택된 data dir의 vocabulary.json — controlled vocab axes/keywords
• 같은 data dir의 reference-tags.md — human-readable keyword matrix

필수 품질 파일:

• 같은 data dir의 reference-quality.json — verified_v2 | partial | legacy_snapshot

fingerprint는 있는데 품질 파일이 없거나 두 파일의 count/id 집합이 다르면 다른 채널 파일로 섞어 보완하지 않는다. omd install-skills를 다시 실행하고 omd doctor로 확인하라고 안내한 뒤 reference 추천을 중단한다.