oh-my-design-cli 0.1.0

package/skills/omd-learn/SKILL.md

@@ -0,0 +1,81 @@
+---
+name: omd:learn
+description: "누적된 preference 교정사항을 DESIGN.md에 반영합니다. '프리퍼런스 정리해줘', 'DESIGN.md 업데이트', 'preference 반영', 'fold preferences', 'learn from corrections' 같은 요청에 트리거됩니다."
+---
+
+# omd:learn — Preference Fold into DESIGN.md
+
+`.omd/preferences.md`에 누적된 `status: pending` 교정사항을 DESIGN.md에 반영하고, 반영된 엔트리의 상태를 `applied`로 플립한다.
+
+## Phase 1 — 검토
+
+Bash 툴로:
+
+```bash
+omd learn
+```
+
+실행하면 pending 엔트리를 scope별로 그룹화해서 보여준다. 출력을 읽고 사용자에게 **그룹별 요약**을 제시한다 (각 엔트리를 나열하지 말고, scope당 2-3줄로 의도 정리).
+
+예시 출력 형식:
+```
+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)
+```
+
+## Phase 2 — 사용자 확인
+
+"이 교정들을 DESIGN.md에 반영할까요?" 묻는다. 사용자가 동의하면 Phase 3.
+
+## Phase 3 — 적용
+
+1. **DESIGN.md를 Read 툴로 로드**한다.
+2. scope별로 묶어서 **하나의 coherent edit**을 생성한다 (엔트리당 하나의 edit이 아니라, 한 scope의 교정들을 종합).
+3. Edit 툴로 DESIGN.md의 해당 섹션을 수정.
+4. **voice 섹션이나 내러티브를 수정할 때는 DESIGN.md의 기존 문체를 preserve**한다 — 교정 내용만 반영하되 문장 스타일, 길이, 톤은 유지.
+5. 수정 후 `DESIGN.md`의 새 hash를 계산. Bash:
+   ```bash
+   omd sync --force  # shim들의 hash 갱신 (DESIGN.md 해시는 pointer라 바뀌지 않지만 lock만 업데이트)
+   ```
+
+## Phase 4 — 상태 플립
+
+반영한 각 엔트리에 대해:
+
+```bash
+omd learn --mark-applied <pref_id>
+```
+
+반영 안 한 엔트리(충돌, 거부)는:
+
+```bash
+omd learn --mark-rejected <pref_id> --reason "<짧은 이유>"
+```
+
+## Phase 5 — 결과 요약
+
+한 문단으로:
+- 반영된 교정 수 (scope별)
+- 거부된 교정 수 + 이유
+- 사용자에게 `.omd/preferences.md` 직접 확인 링크 안내
+
+예시:
+```
+✓ 4 preferences applied to DESIGN.md
+  - components.button: CTAs never uppercase, primary brand-500
+  - spacing: 8pt grid
+✗ 1 rejected (conflicts with base reference radius)
+
+Review .omd/preferences.md for details.
+```
+
+## 금지
+
+- LLM으로 엔트리별 개별 diff를 생성하지 말 것 — scope별 합쳐서 하나의 coherent edit.
+- DESIGN.md의 section 구조(heading 계층)를 바꾸지 말 것.
+- 교정과 관계없는 부분을 "개선"하지 말 것.
+- pending을 건너뛰지 말 것 — 모든 pending에 대해 applied or rejected 플립해야 한다.

package/skills/omd-remember/SKILL.md

@@ -0,0 +1,44 @@
+---
+name: omd:remember
+description: "디자인 선호/교정을 .omd/preferences.md 에 append합니다. 사용자가 '기억해', '앞으로는 ~해', '우리는 ~하지 않아', 'remember that' 같은 발화를 하거나 디자인 원칙을 명시할 때 트리거됩니다."
+---
+
+# omd:remember — Preference Logger
+
+사용자의 디자인 선호/교정을 `.omd/preferences.md`에 append-only로 기록한다. 나중에 `omd:learn`이 배치로 DESIGN.md에 반영.
+
+## 트리거 발화 패턴
+
+- "기억해 둬", "앞으로는 ~로 해"
+- "우리는 ~한다 / ~하지 않는다"
+- "remember that ...", "going forward ..."
+- "rule of thumb: ..."
+- 사용자가 당신의 디자인 선택을 명시적으로 교정
+
+## 실행
+
+Bash 툴로 한 번 실행:
+
+```bash
+omd remember "<사용자 발화를 한 문장 영문으로 요약>"
+```
+
+옵션:
+- `--scope <value>` — 명시적으로 지정할 때. 기본값은 note 내용에서 자동 추론. 허용: `visualTheme | color | typography | spacing | voice | motion | layout | components.<name>`
+- `--context <text>` — 관련 파일 경로나 PR 번호 (e.g. `src/components/Button.tsx`, `#1234`)
+- `--agent <name>` — 보통 생략 (환경변수 자동 감지). override 필요 시: `claude-code | codex | opencode | cursor`
+
+## 응답
+
+커맨드 출력(`Logged pref_xxx ... → ./.omd/preferences.md`)을 그대로 보여주면 된다. 사용자에게 장황한 확인 불필요.
+
+## omd:apply 스킬과의 관계
+
+- **자동 감지**: 일반 UI 작업 중 교정이 발생하면 `omd:apply` 스킬이 자동으로 이 커맨드를 호출한다.
+- **명시적 호출**: 사용자가 UI 작업 없이 디자인 원칙을 선언하는 경우, 이 스킬이 직접 트리거된다.
+
+## 금지
+
+- `.omd/preferences.md` 파일을 직접 편집하지 말 것 — 항상 `omd remember` 경유.
+- 같은 내용을 중복 기록하지 말 것 (같은 세션 내에서).
+- 사용자에게 "기록할까요?" 묻지 말 것 — 감지 즉시 기록 + 간결 알림.

package/skills/omd-sync/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: omd:sync
+description: "DESIGN.md shim 파일들(CLAUDE.md / AGENTS.md / .cursor/rules/omd-design.mdc)을 관리합니다. 'shim 업데이트', 'AGENTS.md 동기화', 'CLAUDE.md drift 확인' 같은 요청에 트리거됩니다."
+---
+
+# omd:sync — Shim Maintenance
+
+DESIGN.md가 모든 주요 AI 코딩 에이전트 (Claude Code, Codex, OpenCode, Cursor)에게 보이도록 shim 파일 3종을 관리한다.
+
+## 관리 대상
+
+- `CLAUDE.md` — Claude Code용 `@./DESIGN.md` import
+- `AGENTS.md` — Codex CLI + OpenCode 공용 pointer
+- `.cursor/rules/omd-design.mdc` — Cursor auto-attach rule
+
+각 파일은 `<!-- omd:start v=1 hash=... -->` ~ `<!-- omd:end -->` marker block으로 관리된다. Cursor mdc는 frontmatter 포함 전체 파일이 관리 단위.
+
+## 사용
+
+사용자 요청에 따라 다음 중 하나를 Bash 툴로 실행:
+
+```bash
+omd sync              # 인터랙티브 — drift 시 overwrite/skip/show/quit 프롬프트
+omd sync --force      # drift 포함 무조건 덮어쓰기
+omd sync --check      # 상태만 검사 (CI/pre-commit, unclean 시 exit 1)
+```
+
+## 언제 실행하나
+
+- `DESIGN.md` 변경 직후 (shim hash 갱신)
+- 새 프로젝트에 처음 도입 (shim 3종 생성)
+- `.claude` / `.cursor` 디렉토리 추가 후
+- CI에서 상태 확인 (`--check`)
+
+## 금지
+
+- shim 파일을 직접 편집하지 말 것. 반드시 `omd sync` 경유.
+- marker block 외부 유저 content는 보존된다 (CLAUDE.md / AGENTS.md만). mdc는 omd 전용이라 전체 덮어쓰기.