oh-my-design: Skill for Claude Code

omd:learn — Preference Fold into Core v2

.omd/preferences.md에 누적된 status: pending 교정사항을 Core v2 System Graph에 반영하고, 그 graph에서 중립적인 root DESIGN.md를 재생성한 뒤 반영된 엔트리의 상태를 applied로 플립한다. DESIGN.md를 직접 섹션 편집하는 스킬이 아니다.

Phase 1 — 검토

Read .omd/preferences.md → frontmatter + 엔트리들 파싱:

• 엔트리 분리: ## heading 기준 split
• 각 엔트리의 omd-meta 코드블록에서 id, scope, status 추출
• status: pending만 필터

scope별로 그룹화해서 사용자에게 요약:

components.button (3 pending):
  - CTAs never uppercase (pref_xxx, pref_yyy)
  - primary fill should be brand-500 not 600 (pref_zzz)

spacing (1 pending):
  - 8pt grid, not 4pt (pref_aaa)

엔트리당 한 줄이 아니라 scope당 2-3줄로 의도 정리.

Phase 2 — 사용자 확인

"이 교정들을 디자인 시스템에 반영할까요?" 묻기. 동의 → Phase 3.

거부 → 어떤 scope를 reject할지 묻고 Phase 4 reject 분기로.

Phase 3 — Core v2 graph-first 적용

3.1 포맷·권위 게이트

1. root DESIGN.md를 읽고 .omd/system/manifest.json + graph.json의 존재와 exact hash binding을 확인한다.
2. 유효한 profile: portable-core Bound Core v2이면 graph.json이 canonical이다. migration-candidate는 source DESIGN.md authority를 유지한다. visible Markdown의 heading이나 표를 직접 편집하지 않는다.
3. Portable-only Core, legacy 13/15/16-section, unmarked 문서이면 설치된 provider-free migrator로 별도 fresh staging directory에 migration을 실행한다. public CLI가 있으면 omd design-md migrate DESIGN.md --out-dir <fresh-migration-dir>를 사용한다. helper가 없으면 직접 편집으로 우회하지 말고 stale install을 보고한다.
4. report의 dropped_segments=0, synthetic_product_values_added=0, projection_roundtrip_equal=true, source_reconstruction_equal=true, opaque_extension_preserved=true가 모두 확인되어야 계속한다. unsupported_claims_review_required=true이므로 staging 결과는 migration-candidate인 non-authoritative observation이다. 곧바로 canonical authority로 승격하지 않는다. 이해하지 못한 원본은 extensions["dev.oh-my-design.migration"]에 보존한다.
5. staging에서만 수정하고 원본 bytes, source hash, migration report를 content-addressed rollback artifact로 남긴다. 실패 시 root 파일을 건드리지 않는다.