{"id":51451378,"url":"https://github.com/caesiumy/ko-design-md","last_synced_at":"2026-07-05T21:01:28.370Z","repository":{"id":357254200,"uuid":"1230786016","full_name":"CaesiumY/ko-design-md","owner":"CaesiumY","description":"한국 브랜드 디자인 시스템을 Stitch v0.1 마크다운으로 정리한 오픈 카탈로그 — Open catalog of Korean design systems in structured markdown.","archived":false,"fork":false,"pushed_at":"2026-06-30T13:35:31.000Z","size":6015,"stargazers_count":13,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-30T15:21:36.407Z","etag":null,"topics":["agent-skills","claude-code","codex","cursor","design-md","design-system","design-tokens","korea","korean","skills-sh","stitch","tanstack-start"],"latest_commit_sha":null,"homepage":"https://getdesign.kr","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CaesiumY.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-06T10:14:52.000Z","updated_at":"2026-06-30T13:35:34.000Z","dependencies_parsed_at":null,"dependency_job_id":"df293d33-659a-4d64-8514-5a10345e6759","html_url":"https://github.com/CaesiumY/ko-design-md","commit_stats":null,"previous_names":["caesiumy/ko-design-md"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/CaesiumY/ko-design-md","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CaesiumY%2Fko-design-md","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CaesiumY%2Fko-design-md/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CaesiumY%2Fko-design-md/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CaesiumY%2Fko-design-md/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CaesiumY","download_url":"https://codeload.github.com/CaesiumY/ko-design-md/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CaesiumY%2Fko-design-md/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35168795,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-05T02:00:06.290Z","response_time":100,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skills","claude-code","codex","cursor","design-md","design-system","design-tokens","korea","korean","skills-sh","stitch","tanstack-start"],"created_at":"2026-07-05T21:01:26.956Z","updated_at":"2026-07-05T21:01:28.362Z","avatar_url":"https://github.com/CaesiumY.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003ca href=\"https://getdesign.kr\"\u003e\n  \u003cimg src=\"./docs/catalog-home.png\" alt=\"ko-design-md — 한국 서비스의 시그니처 디자인을 LLM 컨텍스트로\" width=\"100%\"\u003e\n\u003c/a\u003e\n\n# ko-design-md\n\n**한국 브랜드 디자인 시스템을 Stitch v0.1 마크다운으로 정리한 오픈 카탈로그**\n\n[![License: MIT](https://img.shields.io/badge/Code-MIT-blue.svg)](./LICENSE)\n[![Content: CC BY 4.0](https://img.shields.io/badge/Content-CC%20BY%204.0-lightgrey.svg)](./LICENSE-CONTENT)\n[![CI](https://github.com/CaesiumY/ko-design-md/actions/workflows/ci.yml/badge.svg)](https://github.com/CaesiumY/ko-design-md/actions/workflows/ci.yml)\n[![GitHub stars](https://img.shields.io/github/stars/CaesiumY/ko-design-md?style=flat\u0026logo=github)](https://github.com/CaesiumY/ko-design-md/stargazers)\n[![GitHub last commit](https://img.shields.io/github/last-commit/CaesiumY/ko-design-md)](https://github.com/CaesiumY/ko-design-md/commits/main)\n\n**🔗 라이브 카탈로그 → [getdesign.kr](https://getdesign.kr)**\n\n\u003c/div\u003e\n\n---\n\n## ko-design-md란?\n\n한국에서 운영되는 브랜드/서비스의 디자인 시스템(컬러·타이포그래피·컴포넌트·인터랙션 원칙)을 **Stitch v0.1** 구조화 마크다운으로 정리한 오픈 카탈로그입니다. 흩어지고, 비교하기 어렵고, 시간이 지나면 사라지는 디자인 시스템 자료를 다음 세 원칙으로 한곳에 모읍니다.\n\n- **단일 형식** — 모든 항목이 동일한 frontmatter + 섹션 구조라 비교·검색·임베딩이 쉬움\n- **자동화된 기여 흐름** — AI 코딩 에이전트용 [`/design-md` 스킬](#새-항목-기여)이 13단계 파이프라인으로 새 항목을 자동 생성\n- **시각적 검증** — 항목마다 light/dark 프리뷰 HTML과 OG 이미지를 함께 보관\n\n대상은 디자인 시스템을 **다루는** 디자이너·엔지니어, 그리고 한국 브랜드의 디자인 결정을 **연구하는** 사람입니다.\n\n## 겉모습은 빌리되, 비즈니스는 베끼지 마세요\n\n각 항목은 브랜드의 **시각/디자인 언어**(색·타이포·간격·컴포넌트의 *시각 패턴*)를 기술합니다. design.md를 AI 코딩 에이전트에 넣어 자기 제품을 만들 때는, 그 시각 패턴을 **자기 도메인에 맞게 번안**하세요.\n\n- ✅ **차용**: 색 팔레트, 타이포 스케일, 간격 리듬, 컴포넌트의 시각 처리(둥글기·그림자·밀도)\n- ❌ **이식 금지**: 출처 브랜드의 제품 개념·플로우·카피 — 예) 토스의 송금 흐름, 배민의 ETA 의미를 성격이 다른 앱에 그대로 가져오기\n\n`## Components`가 도메인 특화 이름(`button-cta`=\"구매하기\", `EtaBanner`)을 쓰는 것은 출처를 정확히 기록하기 위함이지, 그 도메인을 함께 복사하라는 뜻이 아닙니다.\n\n## 카탈로그를 코딩 에이전트에서 바로 쓰기 — `use-design-md` 스킬\n\n호환되는 AI 코딩 에이전트라면 위 \"차용\" 과정을 [`use-design-md` 스킬](./.claude/skills/use-design-md/SKILL.md)로 자동화할 수 있습니다. 브랜드명만 주면 카탈로그에서 해당 `design.md`를 찾아 받아와 **지금 작업 중인 프로젝트**의 UI에 그 디자인 언어(색·타이포·간격·둥글기·컴포넌트)를 입힙니다. 카탈로그를 *읽는* 쪽이라 **어느 repo에서든 동작**합니다(새 항목을 *추가*하는 `/design-md` 생산자 스킬과 역할이 반대).\n\n### 설치 (택1)\n\n**모든 에이전트 (Claude Code·Cursor·Codex·Gemini 등) — [skills.sh](https://skills.sh)**\n\n```bash\nnpx skills add CaesiumY/ko-design-md          # use-design-md 스킬 설치\nnpx skills add CaesiumY/ko-design-md --list   # 포함 스킬 확인\n```\n\n→ 설치 후 호출: `/use-design-md`\n\n**Claude Code 플러그인 마켓플레이스 (공식 채널)**\n\n```text\n/plugin marketplace add CaesiumY/ko-design-md\n/plugin install ko-design-md@ko-design-md\n```\n\n→ 설치 후 호출: `/ko-design-md:use-design-md`\n\n설치하면 한 줄로 적용됩니다.\n\n```text\n토스 디자인으로 이 대시보드 다시 꾸며줘\n```\n\n내부적으로는 카탈로그 인덱스([`getdesign.kr/llms.txt`](https://getdesign.kr/llms.txt))로 슬러그를 찾고, 항목별 원본(`getdesign.kr/services/{slug}/llms.txt`)을 평문으로 받아 적용합니다. skills.sh를 쓰지 않는 도구라면 [`.claude/skills/use-design-md/`](./.claude/skills/use-design-md/) 디렉터리를 해당 도구의 스킬 경로로 복사하세요. 가져올 수 있는 브랜드 목록은 라이브 카탈로그 **[getdesign.kr](https://getdesign.kr)**에서 확인할 수 있습니다.\n\n## 항목 구성\n\n각 항목은 다음 4종으로 구성됩니다.\n\n| 산출물 | 위치 | 역할 |\n|--------|------|------|\n| 카탈로그 마크다운 | `services/{slug}.md` | Stitch v0.1 frontmatter + 본문 |\n| 라이트 프리뷰 | `public/preview/{slug}/light.html` | 자급자족형 single-file 미리보기 |\n| 다크 프리뷰 | `public/preview/{slug}/dark.html` | 다크 테마 미리보기 |\n| OG 이미지 | `public/og/{slug}.png` | 소셜 카드용 1200×630 |\n\n작성 규격(frontmatter 필드·카테고리 enum 등)은 [docs/PRD.md](./docs/PRD.md)와 [stitch-format.md](./.claude/skills/design-md/references/stitch-format.md)를 참고하세요.\n\n## 빠른 시작\n\n```bash\ngit clone https://github.com/CaesiumY/ko-design-md.git\ncd ko-design-md\npnpm install      # pnpm 필요\npnpm dev          # → http://localhost:3000\npnpm build        # OG 이미지 생성 + 사이트 빌드\n```\n\n요구사항: Node 20+, pnpm.\n\n## 새 항목 기여\n\n호환되는 AI 코딩 에이전트에서 [`/design-md` 스킬](./CONTRIBUTING.md#1-새-항목-추가-권장-design-md-스킬-사용)을 한 줄로 호출하면 research → draft → review → preview HTML → OG까지 13단계로 자동 생성됩니다.\n\n```text\n/design-md\n{브랜드/서비스명}을 ko-design-md에 새 카탈로그 항목으로 추가해 주세요.\n```\n\n생성된 4종(`services/{slug}.md`, light/dark `.html`, `og/{slug}.png`)을 `pnpm dev`로 확인하고, 한 커밋(`git commit -s` — DCO 서명)으로 묶어 PR을 올립니다. 사전 준비·13단계 상세·PR 체크리스트는 **[기여 가이드](./CONTRIBUTING.md)**를 참고하세요. 스킬 없이 손으로 기여하려면 [수동 PR 절차](./CONTRIBUTING.md#2-기존-항목-수정-스킬-미사용)를 따릅니다.\n\n## 라이선스\n\n본 리포는 **3-tier** 라이선스 구조를 가집니다.\n\n| 대상 | 라이선스 | 파일 |\n|------|----------|------|\n| 코드 (`src/`, `scripts/`, 설정 파일) | MIT | [LICENSE](./LICENSE) |\n| 카탈로그 콘텐츠 (`services/*.md`, `public/preview/**`, `public/og/**`) | CC BY 4.0 | [LICENSE-CONTENT](./LICENSE-CONTENT) |\n| 브랜드 자산 (`public/logos/*`) | 각 권리자 정책 | [NOTICE](./NOTICE) |\n\n브랜드 로고는 식별·참조 목적으로 포함된 것이며 카탈로그 라이선스로 재배포되지 않습니다. 로고·콘텐츠 삭제 요청은 [SECURITY.md의 Takedown 안내](./SECURITY.md#브랜드-자산콘텐츠-삭제-요청-takedown)를 따릅니다.\n\n## 링크\n\n- [기여 가이드](./CONTRIBUTING.md) · [행동 강령](./CODE_OF_CONDUCT.md) · [보안 정책](./SECURITY.md) · [변경 이력](./CHANGELOG.md)\n- [PRD](./docs/PRD.md) — 프로젝트 방향성 문서\n- [GitHub Issues](https://github.com/CaesiumY/ko-design-md/issues)\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\u003csub\u003eAI-assisted workflow · Made for Korean designers and developers\u003c/sub\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcaesiumy%2Fko-design-md","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcaesiumy%2Fko-design-md","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcaesiumy%2Fko-design-md/lists"}