oh-my-design-cli 1.6.0 → 1.6.2

package/AGENTS.md

@@ -7,7 +7,7 @@ oh-my-design itself uses Claude Code skills + subagents for its design harness.
 ## Repository quick map
 
 - `src/` — TypeScript source for the `omd` CLI (`bin/oh-my-design.ts` is the entrypoint).
-- `references/` — 67 real-company DESIGN.md files used as bundled references.
+- `web/references/<id>/DESIGN.md` — 100+ real-company DESIGN.md files; the **canonical source of truth** for the reference catalog. It lives under `web/` because the Vercel project root is `web/` (the site build can only read files beneath it). The root `references` symlink, `design-md/`, and `packages/mcp/data/references/` are all derived from here — see **Repository layout** in `README.md` for why each tree exists and which to edit. Rule: edit `web/references/` only.
 - `skills/omd-*` — Claude Code / Codex / OpenCode skill files (installed into target projects via `omd install-skills`).
 - `.claude/agents/` — Subagent definitions for the design harness (Claude Code).
 - `.codex/agents/` — Mirror TOML definitions for the design harness (Codex).

package/README.ko.md

@@ -197,6 +197,18 @@ Toss · Claude · Line · Stripe · Linear · Vercel · Notion · Airbnb · Appl
 - **디자인 시스템 디렉토리** ([oh-my-design.kr/design-systems](https://oh-my-design.kr/design-systems)) — 107개 레퍼런스 중 34개는 공식 디자인 시스템 또는 브랜드 가이드라인 페이지가 있으며, 디렉토리에서 라이브 썸네일과 함께 바로 이동할 수 있습니다.
 - **Personal Curation** ([oh-my-design.kr/curation](https://oh-my-design.kr/curation)) — MBTI 스타일의 짧은 퀴즈로 당신의 디자인 성향을 107개 레퍼런스 중 하나와 매칭해, 해당 레퍼런스가 미리 선택된 빌더로 바로 이동시켜 줍니다.
 
+## claude-design — 터미널에서 claude.ai/design 구동 (단독 스킬)
+
+코드베이스(스택·디자인 토큰·컴포넌트·실제 UI 카피·브랜드 에셋)를 분석해 **claude.ai/design** 을 끝까지 자동 구동하고, 코드 기반으로 생성된 디자인의 공유 링크를 돌려주는 Claude Code 전용 스킬입니다. 생성 전 claude.ai/design 이 명확화 질문을 띄우면, 스킬이 질문을 읽고 **코드 맥락에 맞는 답을 직접 선택**합니다(애매하면 "Decide for me" 폴백).
+
+omd 툴체인 없이 단독 설치:
+
+```bash
+npx oh-my-design-cli install-skills --skills claude-design --agent claude-code --skills-only
+```
+
+Claude Code 재시작 후 `/claude-design` (또는 "이 랜딩 디자인 만들어줘"처럼 자연어로). 요구사항: Claude Code(Chrome 자동화 + `python3` + 전역 `playwright` 필요), 스킬이 여는 창에서 claude.ai 1회 로그인. `x-omd-channels` 로 채널 제한 — Codex/OpenCode 타깃은 건너뜁니다.
+
 ## 107개 지원 레퍼런스
 
 | 카테고리 | 기업 |

package/README.md

@@ -37,6 +37,28 @@ Then restart your agent (Cmd+Q in Claude Code, then relaunch) so the new skills
 
 That is the only CLI command you will run. Everything else is natural language to your agent.
 
+## Your first 60 seconds
+
+This is the whole point: one prompt turns into a `DESIGN.md` your agent remembers across every future session.
+
+1. Install (above), then **restart your agent** (Cmd+Q, relaunch) so it loads the new skills.
+
+2. In your project, type your first prompt — copy this exactly:
+
+   > Set up our design system — Toss-style, for a family meal-tracking app.
+
+   Your agent runs **`omd:init`**: it recommends a reference from the 100+ real-company catalog, asks you to confirm, and writes **`DESIGN.md`** to your project root. (`omd:sync` then wires up the `CLAUDE.md` / `AGENTS.md` / Cursor shims so every agent reads it automatically.)
+
+   **That `DESIGN.md` is your activation — your agent now remembers your brand.**
+
+3. Now build against it:
+
+   > Design the home screen.
+
+   The agent reads `DESIGN.md` and ships brand-correct UI. No re-explaining your design system, ever again.
+
+Don't want Toss? Any brand works — `Stripe-style`, `Linear-clone B2B SaaS`, `Karrot-style marketplace`. Browse the full catalog at [oh-my-design.kr/design-systems](https://oh-my-design.kr/design-systems).
+
 ## Upgrading
 
 Skills and agents evolve every release. To pick up the latest bundle in an existing project:
@@ -75,6 +97,18 @@ Pattern adopted: Anthropic orchestrator-workers + LangGraph supervisor revision-
 
 Promotion of future skills into the bundle is governed by the [`omd-release-hygiene`](./.claude/skills/omd-release-hygiene/SKILL.md) checklist. (A deterministic Korean-orthography linter was prototyped and dropped — a 25-pattern regex heuristic had too low recall to be worth shipping; if you need automated KR spellcheck, wire an external service such as the 부산대 한국어 맞춤법 검사기.)
 
+### `claude-design` — drive claude.ai/design from your terminal
+
+A standalone skill (Claude Code only): it analyzes your codebase — stack, design tokens, components, real UI copy, brand assets — and drives **claude.ai/design** end-to-end to generate a code-grounded design, handing back a shareable link. If claude.ai/design asks clarifying questions before generating, the skill reads them and picks the appropriate answer per your codebase (falling back to "Decide for me").
+
+Install it on its own, with none of the omd toolchain:
+
+```bash
+npx oh-my-design-cli install-skills --skills claude-design --agent claude-code --skills-only
+```
+
+Then restart Claude Code and run `/claude-design` (or just ask: "generate a design for this landing page"). Requirements: Claude Code (it needs Chrome automation + `python3` + a global `playwright`), and a one-time claude.ai login in the window the skill opens. Channel-restricted via `x-omd-channels` — Codex/OpenCode targets are skipped.
+
 ## How to use omd with your AI
 
 Open Claude Code (or Codex / OpenCode) in your project. Just talk:
@@ -168,6 +202,21 @@ Works with Claude Desktop, Cursor, Cline, Continue, and Codex. Zero AI calls, ze
 - It is not an SDK. If you need the matching algorithm or shim format, look at the skill markdown directly.
 - It does not generate emojis as icons. Asset agent prefers inline SVG (Lucide-matched or custom).
 
+## Repository layout
+
+> For contributors. If you're just *using* OmD, you never touch these — the install ships everything you need.
+
+The brand `DESIGN.md` corpus lives in more than one place **on purpose**. Here's the map so nothing looks like accidental duplication:
+
+| Path | In git? | Ships to npm? | Role |
+|---|---|---|---|
+| `web/references/<id>/DESIGN.md` | ✅ | ✅ (CLI pkg) | **Canonical source of truth.** Lives under `web/` because the Vercel project root is `web/` — the site build can only read files beneath it. Everything else is derived from here. |
+| `references` → `web/references` | ❌ gitignored | — | Local convenience symlink so root-level scripts/tests resolve the same path during local dev. |
+| `design-md/<id>/DESIGN.md` | ✅ | ❌ | Public [awesome-design-md](https://github.com/VoltAgent/awesome-design-md)-style mirror — frontmatter-stripped + a "Source / Last verified" note. A different *format*, not a byte copy. |
+| `packages/mcp/data/references/` | ❌ gitignored | ✅ (MCP pkg) | Build artifact. Regenerated from `web/references` by `packages/mcp/scripts/sync-data.mjs` on every `prepublish`/`build`. Never edit by hand. |
+
+**Rule of thumb: edit `web/references/<id>/DESIGN.md` only.** `web/scripts/build-registry.mjs` regenerates the typed registry, and the pre-commit catalog-integrity gate (`web/__tests__/catalog-integrity.test.ts`) plus `sync-data.mjs` keep the derived copies honest.
+
 ## Changelog
 
 See [CHANGELOG.md](CHANGELOG.md) for release history. Migrating from 0.1.x: see [MIGRATION.md](MIGRATION.md).