@design-ai/cli 4.55.0

package/docs/announcements/hashnode-post.ko.md

@@ -0,0 +1,232 @@
+# hashnode 블로그 포스트 초안
+
+대상: hashnode.com (개인 블로그) — `#korea`, `#design`, `#ai`, `#claude`, `#opensource` 태그.
+
+## 제목
+
+```
+AI 코딩 도구를 시니어 프로덕트 디자이너로 — design-ai v4.0 회고
+```
+
+부제 (subtitle):
+```
+한국 시장 컨벤션 내장된 디자인 지식 베이스를 32 단계에 걸쳐 만들고
+v4.0 stable에 도달한 이야기
+```
+
+## 본문
+
+```markdown
+지난 몇 개월, 개인 사이드 프로젝트로 시작한 design-ai가 v4.0 stable에
+도달했어요. v2.0(55개 지식 파일 / 1개 배포 채널)에서 v4.0(91개 / 4개
+채널 / EN+KO 2개 언어 / 6개 CI 감사)까지 32 단계로 진화한 과정을
+정리해 봐요.
+
+## TL;DR
+
+design-ai는 모든 AI 코딩 에이전트(Claude Code / Codex CLI / Cursor /
+Aider)를 시니어 프로덕트 디자이너처럼 동작하게 만드는 모델 무관
+지식 베이스예요. 한국 핀테크 / SaaS 컨벤션이 기본 내장돼 있어요.
+
+```bash
+npx @design-ai/cli install
+```
+
+GitHub: https://github.com/sungjin9288/design-ai
+라이선스: MIT.
+
+## 동기 — 왜 만들었나
+
+기존 디자인 시스템 자료(Material 3, Polaris, Carbon, Ant Design)는
+훌륭하지만 한국 시장 디테일이 거의 없어요:
+
+- Toss / KakaoPay / NaverPay 결제 흐름 차이
+- 본인인증(PASS / NICE / KCB) 통합 패턴
+- Pretendard 폰트 fallback 체인
+- 해요체 vs 합쇼체 챗봇 톤 분기
+- 확률 표시 / GRAC 등급 (게임 UI)
+- 분리배출 표시 / KFDA / KATS 규제 (인쇄)
+
+AI 도구로 디자인 작업할 때마다 이걸 다시 알려줘야 했어요. 한 번
+정리해서 모든 도구가 참조하게 만들면 좋겠다는 생각에서 시작했어요.
+
+## 4 계층 아키텍처
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  에이전트 인터페이스 (AGENTS.md, CLAUDE.md)                 │
+└────────────────────────────────┬────────────────────────────┘
+                                 │
+┌────────────────────────────────▼────────────────────────────┐
+│  스킬 + 에이전트 + 커맨드 (skills/ agents/ commands/)        │
+└────────────────────────────────┬────────────────────────────┘
+                                 │
+┌────────────────────────────────▼────────────────────────────┐
+│  지식 베이스 (knowledge/) — 91개, 모두 stable / versioned    │
+└────────────────────────────────┬────────────────────────────┘
+                                 │
+┌────────────────────────────────▼────────────────────────────┐
+│  소스 자료 (refs/) — Ant + MUI + shadcn sparse-clone         │
+└─────────────────────────────────────────────────────────────┘
+```
+
+핵심: **마크다운이 진실의 원천**. Claude 전용 스킬 파일이 아닌
+일반 마크다운으로 인코딩해서, Codex CLI / Cursor / Aider / VS Code
+에서 모두 살아남아요.
+
+## 4 가지 전략적 선택
+
+### 1. 지식 우선, 스킬 다음
+
+초기에는 스킬을 더 많이 추가하고 싶었어요. 하지만 스킬은 얇아요 —
+지식을 가리키는 플레이북이에요. 지식 깊이 없이는 스킬이 일반적인
+출력만 내요.
+
+v2.x는 도메인 깊이(모션 / 일러스트 / 인쇄 / 영상 / 게임 UI / 음성 /
+공간)에 집중했고, v2.7 이후 새 스킬은 거의 추가 안 했어요. 결과:
+출력 품질이 ~~생성형 AI 답변~~ → ~~디자인 시스템 가이드~~ → 시니어
+디자인 리뷰 수준으로 올라갔어요.
+
+### 2. 컨텐츠 양 늘리기 전에 배포 가능하게 만들기
+
+v3.0–3.4는 코퍼스를 *설치 가능하게* 만드는 데 집중했어요:
+
+- npm CLI (`@design-ai/cli`)
+- Homebrew formula
+- 공개 doc 사이트 (mkdocs-material)
+- VS Code 확장
+- Claude Code plugin manifest
+
+당시 컴포넌트 커버리지는 30% 정도였어요. 70%까지 올리고 싶은
+유혹이 있었지만, **adopters가 설치할 수 있는 30%** > **private repo
+에 갇힌 70%** 라는 판단이었어요.
+
+이후 v3.x에서 커버리지를 55%까지 올렸어요.
+
+### 3. 한국 시장을 처음부터 일등 시민으로
+
+도메인 단계마다 한국 컨벤션을 *추가로 첨부*가 아니라 *동등한 깊이로*
+포함했어요. v3.6에서 영문 → 한국어 번역(README, QUICKSTART, AGENTS,
+DISTRIBUTION)이 자연스럽게 이어졌고, v3.10에서 5개 통합 워크스루
+도, v4.1에서 USING / CONTRIBUTING / ARCHITECTURE까지 한국어로 갖춰
+졌어요.
+
+번역 원칙:
+- 직역 거부 — 자연스러운 한국어 우선.
+- 어댑터 대상은 해요체, 법적 / 공식은 합쇼체.
+- 코드 / 명령어는 영문 그대로.
+- 한국 브랜드 / 컨벤션은 한국어 유지.
+- `korean-copy-check.py` 감사가 영문 UI 문구 유출을 자동 검사.
+
+### 4. 감사 주도 품질
+
+PR마다 6개 감사가 게이팅:
+
+| # | 감사 | 목적 |
+|---|---|---|
+| 1 | frontmatter-check | YAML + 버전 필드 |
+| 2 | link-check | 내부 링크 360+ 해석 |
+| 3 | korean-copy-check | 한국어 voice / typography |
+| 4 | check-coverage | 컴포넌트 커버리지 리포트 |
+| 5 | integration-check | 통합 워크스루 완전성 |
+| 6 | stale-check | 지식 신선도 (>12개월 = CI 실패) |
+
+감사 개수가 4개 → 6개로 늘어난 만큼 회귀(regression) 사례가
+줄었어요. v3.12에서 추가한 stale-check은 v3.11의 versioned
+frontmatter 위에 만들어진 것 — 인프라가 인프라를 만들어요.
+
+## v2.0 → v4.0 한눈에
+
+| 표면 | v2.0 | v4.0 |
+|---|---|---|
+| 지식 파일 | 55 | 91 |
+| 워크드 예제 | 83 | 160 |
+| 스킬 | 12 | 19 |
+| 슬래시 커맨드 | 8 | 15 |
+| 컴포넌트 커버리지 | ~24% | 55.3% |
+| 배포 채널 | 1 | 4 |
+| 통합 워크스루 | 0 | 5 (각각 EN+KO) |
+| 사이트 언어 | 0 | 2 |
+| CI 감사 | 4 | 6 |
+
+## 실패한 패턴
+
+### 일반 영문 우선 → 자동 번역
+
+초기 한국어 콘텐츠는 영문 작성 후 자동 번역으로 시도했는데,
+어색해서 폐기했어요. 지금은 한국어 파일을 처음부터 한국어로 작성.
+korean-copy-check가 자동 번역 흔적을 잡아내요.
+
+### 커버리지 push 피로
+
+v3.3 / v3.5 / v3.7 / v3.9 — 4 번의 커버리지 push 후 한계 효용이
+줄었어요. 남은 캐노니컬은 대부분 sub-component(Step.Item, Form.Field
+등)나 transition primitive 라 한 번에 큰 진전이 어려워요. v3.11에서
+여섯 번째 커버리지 push 대신 versioned frontmatter(인프라)로
+전환한 게 결과적으로 옳았어요.
+
+## v4.0 — 안정 약속
+
+v4.0은 그래듀에이션 릴리스예요. 8 개 표면(지식 파일 / 스킬 / 커맨드
+/ 에이전트 / CLI / plugin / VS Code / doc 사이트)이 API stable.
+deprecation 정책: 4.x에서 deprecate → 4.x 동안 유지 → 5.0에서 제거.
+
+## 다음 — 4.x 로드맵
+
+- VS Code marketplace 게시 (1.0.0).
+- 커버리지 push 55% → 70%.
+- 시맨틱 검색 인덱스 (Algolia / Typesense).
+- 컴포넌트 spec 추출기 v2 (TS AST 파싱).
+- 분기별 stability 재검토 의식 (Q마다).
+
+## 시작하기
+
+```bash
+# 가장 빠른 방법
+npx @design-ai/cli install
+
+# 또는 git clone
+git clone https://github.com/sungjin9288/design-ai
+cd design-ai && ./install.sh
+
+# Homebrew (macOS)
+brew tap sungjin9288/design-ai
+brew install design-ai
+```
+
+설치 후:
+- Claude Code: `/design-design-review`, `/design-palette-from-brand`
+  등 슬래시 커맨드 사용 가능.
+- Codex CLI: `cd /path/to/design-ai && codex "..."`.
+- Cursor / Aider: `docs/integrations/` 워크스루 참고.
+
+## 의견 환영해요
+
+- GitHub Issues: 버그 / 제안 / KR 컨벤션 추가 요청.
+- 한국어 번역 / 콘텐츠 기여 (`docs/CONTRIBUTING.ko.md`).
+- 사용 후기 / Figma + Cursor 워크플로 등 케이스 공유 환영.
+
+긴 글 읽어 주셔서 감사해요.
+
+— [@sungjin9288](https://github.com/sungjin)
+```
+
+## 카드 / 썸네일 (소셜 미디어용)
+
+hashnode가 자동으로 og:image 생성하지만, 직접 만들면 좋아요:
+
+- 1200×630 px
+- 좌측: design-ai 로고(미정 — 임시로 큰 monospace `design-ai`)
+- 우측: stats card (91 knowledge / 19 skills / 4 channels / 2 languages)
+- 하단: `npx @design-ai/cli install`
+- 배경: 브랜드 컬러 (TBD — 임시 dark navy + cyan accent)
+
+## 태그
+
+`#korea` `#design` `#ai` `#claude` `#opensource` `#designsystem`
+`#typescript` `#cli`
+
+## 발행 시기
+
+한국 시간 오전 9-11시 (KST UTC+9). 화 / 수 / 목 추천. 발행 직후
+Twitter / X에 링크 공유 (별도 thread 초안 참고).

package/docs/announcements/okky-post.ko.md

@@ -0,0 +1,158 @@
+# OKKY 포스트 초안
+
+대상: <https://okky.kr/community/qna> (질문/답변) 또는 자유게시판.
+
+## 제목 후보
+
+1. `[공유] AI 코딩 도구를 시니어 프로덕트 디자이너로 만드는 오픈소스 — design-ai v4.0`
+2. `Claude Code / Cursor / Codex에서 한국 시장 디자인 작업 자동화하기 (오픈소스)`
+3. `한국 핀테크 컨벤션 내장된 디자인 지식 베이스 만들었어요 (model-agnostic, MIT)`
+
+가장 안전한 선택: **1번** (자랑형 아닌 공유형, 결과물 명시).
+
+## 본문 (해요체)
+
+```
+안녕하세요, OKKY 여러분.
+
+지난 몇 개월 동안 만들어 온 오픈소스 프로젝트가 v4.0 stable에
+도달해서 공유드려요.
+
+# design-ai
+
+design-ai는 AI 코딩 에이전트(Claude Code / Codex CLI / Cursor /
+Aider 등)를 시니어 프로덕트 디자이너처럼 동작하게 만드는 지식
+베이스예요. 한국 시장 컨벤션이 기본 내장되어 있어요.
+
+## 뭐가 들어 있나요
+
+- 지식 파일 91개 — Ant Design + MUI + shadcn-ui에서 종합한 토큰 /
+  컴포넌트 / 모션 / 일러스트 / 인쇄 / 영상 / 게임 UI / 음성 /
+  공간 디자인.
+- 워크드 예제 160개 — 컬러 팔레트, 컴포넌트 스펙, 디자인 시스템
+  부트스트랩 등.
+- 스킬 19개 + 슬래시 커맨드 15개 + 리뷰 에이전트 4개.
+- 통합 워크스루 5개 (Codex / Cursor / Aider / SDK / VS Code) —
+  영문 + 한국어 둘 다.
+
+## 한국 시장 깊이
+
+이 부분이 다른 디자인 시스템 자료와 차별점이에요:
+
+- **결제**: Toss / KakaoPay / NaverPay 비교, 본인인증
+  (PASS / NICE / KCB), 청약철회, 표시광고법.
+- **타이포그래피**: Pretendard 우선, fallback 체인, 한글 광학
+  보정.
+- **음성 / 챗봇**: 해요체 vs 합쇼체 분기, Bixby / Clova / NUGU /
+  카카오 i 컨벤션.
+- **게임 UI**: 확률 표시 의무, GRAC 등급, PC방 사용성.
+- **영상**: KFDA / KFTC 광고 표시, 자막 컨벤션.
+- **인쇄**: 명함 90×50, 분리배출 표시, KFDA / KATS 규제.
+
+## 모델 무관 (model-agnostic)
+
+같은 마크다운 파일이 다음 환경에서 모두 작동해요:
+
+- Claude Code (스킬 + 커맨드 + 에이전트)
+- Codex CLI (AGENTS.md 컨벤션)
+- Cursor (.cursorrules에 경로 추가)
+- Aider (--read 플래그)
+- VS Code 확장 (사이드바 탐색)
+- 또는 그냥 시스템 프롬프트로 LLM에 직접 주입
+
+## 시작하기
+
+가장 빠른 방법:
+
+```
+npx @design-ai/cli install
+```
+
+이러면 Claude Code에 심볼릭 링크로 설치돼서 슬래시 커맨드와
+스킬 자동 로딩이 바로 동작해요.
+
+수동 설치 / Cursor / Codex / Aider 가이드는 README에 있어요:
+https://github.com/sungjin9288/design-ai
+
+한국어 문서:
+- README.ko.md
+- QUICKSTART.ko.md
+- USING.ko.md (사용 가이드)
+- AGENTS.ko.md
+- DISTRIBUTION.ko.md
+- 5개 도구 통합 워크스루 .ko.md
+
+## 왜 만들었나요
+
+기존 디자인 시스템 자료(Material 3, Polaris 등)는 훌륭하지만
+한국 시장 컨벤션이 거의 없어요. 한국 디자이너 / 개발자가 AI 도구
+로 디자인 작업할 때 매번 "Toss는 어떻게 하지?", "Pretendard
+fallback은?", "본인인증 UX는?"을 직접 알려줘야 했어요.
+
+design-ai는 그걸 한 번 정리해서 어떤 AI 도구든 바로 쓸 수
+있게 만들어요.
+
+## 라이선스
+
+MIT — 상업용 사용 / 포크 / 번역 모두 자유.
+
+## 피드백
+
+- GitHub Issues에 버그 / 제안 환영해요.
+- 한국 디자인 시스템에서 빠진 컨벤션 (예: 특정 핀테크 패턴, 특정
+  규제) 있으면 말씀해 주세요.
+- 한국어 번역 / 콘텐츠 기여도 환영해요 (CONTRIBUTING.ko.md
+  참고).
+
+긴 글 읽어 주셔서 감사합니다. 의견 / 질문 댓글로 부탁드려요.
+
+— Sungjin Park
+```
+
+## 답글 준비 (예상 질문)
+
+### "Claude만 쓰는 사람 입장에서는 그냥 Claude 스킬만 있어도 충분하지 않나요?"
+
+> 충분해요. design-ai의 스킬들도 Claude Code 스킬 시스템으로
+> 구현되어 있어서 Claude만 쓰시면 그대로 활용 가능합니다.
+>
+> 모델 무관 설계는 회사 / 팀 단위에서 의미가 커요 — 디자이너는
+> Cursor를 쓰고 개발자는 Claude Code를 쓰는 팀에서, 같은 지식
+> 베이스를 둘 다 참조할 수 있어요.
+
+### "한국 컨벤션 부분이 정확한가요? 출처는?"
+
+> 모든 한국 관련 파일은 핸드라이팅이고, 출처를 frontmatter에
+> 명시하거나 본문에 링크해요. KFDA / KFTC / GRAC는 공식
+> 가이드라인 문서, 핀테크 컨벤션은 실제 Toss / Kakao / Naver
+> 앱 분석 + 공시 자료에서 가져왔어요.
+>
+> 틀린 부분 발견하시면 GitHub Issues에 부탁드려요 — 즉시
+> 수정할게요.
+
+### "Cursor에서 어떻게 쓰면 가장 좋아요?"
+
+> docs/integrations/cursor-walkthrough.ko.md에 5개 워크드 세션이
+> 있어요 (인라인 spec / 기존 감사 / Figma 비평 / 토큰 생성 /
+> Cmd+K 인플레이스 편집). 거기서 시작하시면 가장 빨라요.
+
+### "디자이너 일자리 뺏는 거 아닌가요?"
+
+> 아니에요. design-ai는 LLM이 시니어 디자이너 *수준의 출력을*
+> 내도록 돕는 도구지, 디자이너를 대체하는 게 아니에요. 실무
+> 시니어가 봐야 할 디자인 결정 (브랜드 정체성, 사용자 연구,
+> 우선순위) 은 여전히 사람의 영역이고, design-ai는 그 결정에
+> 따른 *세부 산출물* (토큰 / 컴포넌트 / 워크플로) 생성을
+> 자동화해요.
+>
+> 1인 / 소규모 스타트업에서는 시간 절약 효과가 크고, 큰 팀에서는
+> "주니어 디자이너 + design-ai = 시니어 수준" 패턴으로 활용
+> 가능해요.
+
+## 포스팅 팁
+
+- **한국 시간 오전 9-11시**가 OKKY 트래픽 피크.
+- 첫 30분 내 댓글 5개 이상이면 추천글 영역 진입 확률 높음.
+- 코드 블록은 OKKY 마크다운 지원 확인 후 (안 되면 인라인 코드로
+  대체).
+- 답글에서 자랑하지 말기. "도움 됐다면 좋겠어요" 톤 유지.

package/docs/announcements/press-kit.md

@@ -0,0 +1,101 @@
+# Press kit
+
+Reusable assets for the v4.0 launch. Pick whichever fits the channel; don't reuse all of them in one post.
+
+## One-liner
+
+**EN**: design-ai turns any AI coding agent into a senior product designer with Korean market depth.
+
+**KO**: design-ai는 모든 AI 코딩 에이전트를 한국 시장에 강한 시니어 프로덕트 디자이너로 바꿔 줘요.
+
+## Two-liner
+
+**EN**: design-ai is a model-agnostic knowledge base — 91 design files, 19 skills, 15 commands — that plugs into Claude Code, Codex CLI, Cursor, Aider, or any LLM. Korean fintech / SaaS conventions baked in.
+
+**KO**: design-ai는 모델 무관 지식 베이스예요 — 디자인 파일 91개, 스킬 19개, 커맨드 15개 — Claude Code / Codex CLI / Cursor / Aider 어디든 연결돼요. 한국 핀테크 / SaaS 컨벤션이 기본 내장돼 있어요.
+
+## Three-bullet summary
+
+**EN**:
+- **91 hand-curated knowledge files** synthesized from Ant Design + MUI + shadcn-ui — covers tokens, components, motion, illustration, print, video, game UI, conversational, spatial.
+- **Korean market depth** — Toss / KakaoPay / Pretendard / 본인인증 / 합쇼체 vs 해요체 / KFDA / GRAC / 분리배출 conventions baked into every relevant domain.
+- **Plugs into 5 AI tools** — Claude Code (skills + commands + agents), Codex CLI (AGENTS.md), Cursor (.cursorrules), Aider (--read), VS Code (sidebar extension), or plain prompts.
+
+**KO**:
+- **수작업 큐레이션 지식 91개** — Ant Design + MUI + shadcn-ui에서 종합. 토큰 / 컴포넌트 / 모션 / 일러스트 / 인쇄 / 영상 / 게임 UI / 음성 / 공간 모두 다뤄요.
+- **한국 시장 깊이** — Toss / KakaoPay / Pretendard / 본인인증 / 합쇼체 vs 해요체 / KFDA / GRAC / 분리배출 컨벤션이 도메인마다 내장.
+- **5개 AI 도구 연동** — Claude Code (스킬 + 커맨드 + 에이전트), Codex CLI (AGENTS.md), Cursor (.cursorrules), Aider (--read), VS Code (사이드바 확장).
+
+## Stats card (v4.0.0)
+
+```
+design-ai v4.0.0 — Stable
+─────────────────────────────────────
+  91  knowledge files (all stable, all versioned)
+ 160  worked examples
+  19  skills with playbooks
+  15  slash commands
+   4  review agents
+55.3%  canonical component coverage
+   4  distribution channels (npm / Homebrew / git / VS Code)
+   5  integration walkthroughs (each EN + KO)
+   2  site languages
+   6  CI audits
+─────────────────────────────────────
+  npx @design-ai/cli install
+```
+
+## Origin / journey (300 words)
+
+design-ai started as a personal Korean fintech design system. Over 32 phases (v2.0 → v4.0), it grew into a model-agnostic corpus that any AI coding agent can pick up.
+
+The strategic moves that shaped it:
+- **Knowledge first, skills second.** Skills without knowledge produce generic output. v2.x focused on depth (motion, illustration, print, video, game UI, conversational, spatial) before adding skills.
+- **Distribution before mass content.** v3.0–3.4 made the corpus installable (npm CLI, Homebrew, doc site, plugin manifest) before pushing further coverage. A 30% corpus that adopters can install beats a 70% corpus locked in a private repo.
+- **Korean primary audience early.** Every domain phase included Korean conventions (typography, voice, regulatory). Translations followed naturally.
+- **Audit-driven quality.** 6 audits gate every PR. The audit count grew from 4 → 6 over the project; each new audit prevented a regression class.
+- **One concern per phase.** Not "v2.1: motion + illustration + print" — separate phases. Easier to commit, easier to revert, easier to explain.
+
+v4.0 graduates the corpus to API-stable. From v4.0 forward, deprecation cycles protect adopters: deprecate in 4.x, remove in 5.0.
+
+What's next: VS Code marketplace publish, KR community feedback, coverage push 55% → 70%, semantic search index.
+
+See [`docs/SESSION-LOG.md`](../SESSION-LOG.md) for the full narrative.
+
+## FAQ
+
+**Q: Is this a tool I install, or content I read?**
+Both. The CLI installs symlinks into Claude Code so skills auto-load and slash commands work. Or read the markdown directly for any LLM.
+
+**Q: Why "model-agnostic"?**
+Knowledge is encoded as plain markdown + JSON. Same files work in Claude Code (skills), Codex CLI (AGENTS.md), Cursor (.cursorrules), Aider (--read), VS Code extension, or as system prompt for any LLM.
+
+**Q: How is this different from Anthropic's Skills?**
+Skills are the runtime; design-ai is the corpus. design-ai's skills are *implemented* using Claude Code's skill system, but the underlying knowledge files are vendor-neutral.
+
+**Q: Why Korean focus?**
+Author is Korean; primary audience is Korean designers / B2B / fintech. KR conventions are deep (Toss, Kakao, Pretendard, 본인인증, regulatory) and underserved by Western design systems.
+
+**Q: Is the Korean content machine-translated?**
+No. All Korean content is hand-written in natural Korean. The `korean-copy-check.py` audit specifically catches machine-translation artifacts.
+
+**Q: Coverage is 55%. Why not 100%?**
+Remaining canonicals are mostly sub-components (e.g., `Step.Item` of `Steps`) or transition primitives. The 55% covers all flagship primitives across Ant + MUI + shadcn. Coverage push to 70% is on the 4.x roadmap.
+
+**Q: License?**
+MIT. Use it commercially. Fork it. Translate it.
+
+**Q: Can I contribute?**
+Yes — see [`docs/CONTRIBUTING.md`](../CONTRIBUTING.md) (or [`docs/CONTRIBUTING.ko.md`](https://github.com/sungjin9288/design-ai/blob/main/docs/CONTRIBUTING.ko.md)).
+
+## Links
+
+- **Repo**: https://github.com/sungjin9288/design-ai
+- **NPM**: https://www.npmjs.com/package/@design-ai/cli
+- **Docs**: (deployed mkdocs URL — fill in after `docs.yml` workflow runs)
+- **Changelog**: https://github.com/sungjin9288/design-ai/blob/main/CHANGELOG.md
+- **License**: MIT
+
+## Author
+
+Sungjin Park — sungjin9288@gmail.com

package/docs/announcements/reddit-r-korea.md

@@ -0,0 +1,196 @@
+# Reddit drafts
+
+Two parallel posts:
+- **r/programming** (English, technical) — 2.5M members
+- **r/korea** (Korean / English mix, KR-focused) — 250k members
+- **r/ClaudeAI** (English, Claude-specific) — niche but high-affinity
+
+Reddit moderation can be strict — read each subreddit's rules before posting. Avoid promotional language; lead with value.
+
+## r/programming draft
+
+### Title
+
+```
+design-ai v4.0: open-source design knowledge base that plugs into Claude Code, Codex CLI, Cursor, and Aider
+```
+
+### Body
+
+```markdown
+After working on this for a few months, my open-source design knowledge
+base hit v4.0 stable. Sharing the architectural choices since some
+go against AI-tooling norms.
+
+**What it is**: a model-agnostic markdown corpus (91 knowledge files,
+160 worked examples, 19 skills, 15 slash commands) that any AI coding
+agent can pick up.
+
+**Why model-agnostic**: most AI design tools encode content as
+vendor-specific skill files. design-ai uses plain markdown + JSON, so
+the same content works in:
+
+- Claude Code (skills + commands + agents)
+- Codex CLI (AGENTS.md convention)
+- Cursor (.cursorrules)
+- Aider (--read flag)
+- VS Code sidebar extension
+- or as a system prompt for any LLM
+
+**Korean market depth**: this is the part that distinguishes it from
+generic AI design tools. Western design system docs treat non-English
+markets as "localization concerns." design-ai treats Korean conventions
+as deep domain knowledge — Toss/KakaoPay payment flows, 본인인증
+integration, Pretendard typography, 해요체 vs 합쇼체 chatbot register,
+KFDA/GRAC/분리배출 regulatory.
+
+**Audit-driven quality**: 6 audits gate every PR — frontmatter shape,
+360+ internal links, Korean voice/register, component coverage diff,
+walkthrough completeness, stale-content (>12mo files fail CI).
+
+**Try it**:
+
+    npx @design-ai/cli install
+
+GitHub: https://github.com/sungjin9288/design-ai
+License: MIT
+
+Questions, feedback, contributions welcome.
+```
+
+### Reply prep
+
+- "Why not just use [some other tool]?" → "design-ai is corpus,
+  others are runtime. Most aren't mutually exclusive."
+- "55% coverage seems low" → "covers all flagship primitives across
+  Ant + MUI + shadcn. 70% is on roadmap."
+- "Korean focus" → "Western corpus is exhaustive; KR is additive."
+
+### r/programming rules check
+
+- ✅ Self-promotion: allowed if tool is open-source + adds technical value.
+- ✅ Title: descriptive, not clickbait.
+- ⚠️ Posting freq: max 1 self-promo per week.
+- ❌ Don't link to NPM directly — link GitHub.
+
+## r/korea draft
+
+### Title
+
+```
+[OC] AI 코딩 도구를 시니어 디자이너로 만드는 오픈소스 (한국 시장 중심) v4.0
+```
+
+Or English-friendly:
+
+```
+[OSS] design-ai v4.0 — design knowledge base with deep Korean conventions (Toss/Kakao/Pretendard)
+```
+
+### Body
+
+Two-language post (Reddit allows mixed):
+
+```markdown
+**한국어 (Korean)**
+
+지난 몇 개월 만든 오픈소스 design-ai가 v4.0 stable에 도달해서 공유드려요.
+
+design-ai는 Claude Code / Codex CLI / Cursor / Aider 같은 AI 코딩
+도구를 시니어 프로덕트 디자이너처럼 동작하게 만드는 지식 베이스예요.
+
+**한국 시장 컨벤션이 깊게 내장**:
+- Toss / KakaoPay / NaverPay 결제 흐름
+- 본인인증 (PASS / NICE / KCB) 통합 패턴
+- Pretendard 폰트 fallback
+- 해요체 vs 합쇼체 챗봇 톤 분기
+- 확률 표시, GRAC 등급 (게임)
+- KFDA, KFTC, 분리배출 표시 (규제)
+
+**한국어 문서**: README / QUICKSTART / AGENTS / DISTRIBUTION /
+USING / CONTRIBUTING / ARCHITECTURE 모두 한국어 버전 있어요.
+
+설치: `npx @design-ai/cli install`
+
+GitHub: https://github.com/sungjin9288/design-ai · MIT 라이선스
+
+---
+
+**English**
+
+design-ai v4.0 — open-source design knowledge base with deep Korean
+market conventions baked in (Toss, KakaoPay, Pretendard, 본인인증,
+해요체/합쇼체, KFDA/GRAC/분리배출).
+
+Plugs into Claude Code, Codex CLI, Cursor, Aider, or any LLM.
+
+Install: `npx @design-ai/cli install`
+
+GitHub: https://github.com/sungjin9288/design-ai · MIT
+```
+
+### r/korea rules check
+
+- ⚠️ Self-promotion: stricter than r/programming. Lead with KR value.
+- ⚠️ Use `[OC]` flair for original content.
+- ✅ Bilingual posts allowed and encouraged.
+
+## r/ClaudeAI draft
+
+### Title
+
+```
+design-ai v4.0 — 91 knowledge files + 19 skills + 15 commands for Claude Code (and other agents)
+```
+
+### Body
+
+```markdown
+Sharing my open-source design corpus that's optimized for Claude Code
+but works in any AI coding agent.
+
+**Claude Code specifics**:
+- 19 skills auto-loaded via the skill system
+- 15 slash commands (`/design-design-review`, `/design-palette-from-brand`,
+  etc.)
+- 4 review agents (design-critic, a11y-reviewer, component-architect,
+  token-extractor)
+- Plugin manifest at `.claude-plugin/plugin.json`
+
+**Install**:
+
+    npx @design-ai/cli install
+
+This symlinks everything into `~/.claude/{skills,commands,agents}` so
+slash commands and skill auto-loading just work.
+
+**Worth highlighting for r/ClaudeAI**:
+- All 91 knowledge files have versioned frontmatter
+  (`version`, `last_updated`, `stability`).
+- Skills include verification phases (output must cite ≥2 references,
+  cover all states, satisfy a11y).
+- Korean fintech / SaaS conventions baked in for KR adopters.
+
+GitHub: https://github.com/sungjin9288/design-ai · MIT
+```
+
+## Don't (for all subs)
+
+- Don't post on weekends — weekday traffic is higher and quality
+  comments more likely.
+- Don't reply to comments in the first 10 minutes — let the thread
+  organic-rank first.
+- Don't use the exact same body across subs (Reddit shadow-bans
+  cross-posters).
+- Don't include promotional language ("Check out my new tool!"). Just
+  describe what it is.
+
+## Posting cadence
+
+- Day 1: HN + dev.to.
+- Day 2: r/programming.
+- Day 3: r/korea + r/ClaudeAI.
+- Day 4-7: Twitter threads, hashnode, OKKY.
+
+Spread out so each post gets full discussion cycle without competing
+with the previous.