@design-ai/cli 4.55.0

package/docs/announcements/show-hn.md

@@ -0,0 +1,114 @@
+# Show HN draft
+
+Submission target: <https://news.ycombinator.com/submit>
+
+## Title (max 80 chars)
+
+```
+Show HN: design-ai – senior product designer for any AI coding agent
+```
+
+Alt titles (rotate if first doesn't catch):
+- `Show HN: Design knowledge base for Claude Code, Codex, Cursor, Aider`
+- `Show HN: design-ai – 91 design files, 19 skills, model-agnostic`
+
+## URL field
+
+`https://github.com/sungjin9288/design-ai`
+
+## Text field (Show HN body, optional but recommended)
+
+```
+Hey HN —
+
+design-ai is a hand-curated design knowledge base that turns any AI
+coding agent into a senior product designer. It plugs into Claude
+Code (skills + commands + agents), Codex CLI (AGENTS.md), Cursor
+(.cursorrules), Aider (--read), or any LLM via plain prompts.
+
+What's in it:
+- 91 knowledge files synthesized from Ant Design + MUI + shadcn-ui
+- Tokens, components, motion, illustration, print, video, game UI,
+  conversational, and spatial design
+- 19 skills with playbooks, 15 slash commands, 4 review agents
+- 160 worked examples
+- 6 CI audits gating every PR
+
+What makes it different:
+- Model-agnostic — markdown is the source of truth, not vendor-
+  specific skill files
+- Korean fintech / SaaS conventions baked in (Toss, KakaoPay,
+  Pretendard, 본인인증, KFDA, GRAC, 분리배출)
+- All knowledge files versioned (semver + last_updated + stability)
+- Stale-content audit fails CI on files >12 months old
+
+Try it:
+  npx @design-ai/cli install
+
+License: MIT.
+
+This is v4.0 — the API is now stable across 8 surfaces. Deprecation
+policy: deprecate in 4.x, remove in 5.0.
+
+Happy to answer questions about the architecture choices, the
+audit setup, or why I went corpus-first instead of model-fine-tuning.
+```
+
+## Comment-prep notes (for replying in thread)
+
+Likely questions and prepared responses:
+
+### "How is this different from just asking Claude to be a designer?"
+
+> The corpus is the difference. A bare LLM produces generic design output —
+> reasonable but not opinionated, not Korean-aware, not citing real design
+> system precedent. design-ai's knowledge files cite Ant / MUI / shadcn for
+> every claim, encode KR conventions (Pretendard, 본인인증, 합쇼체 vs
+> 해요체), and the skills enforce verification phases (output must cite
+> ≥2 references, cover all states, satisfy a11y).
+
+### "Why model-agnostic? Just use Claude Code skills."
+
+> Same content needs to work in Codex CLI (AGENTS.md convention), Cursor
+> (.cursorrules), Aider (--read flag), VS Code extension. Encoding it
+> only as Claude skill files locks adopters in. Markdown + JSON is the
+> source of truth; the skill system is just one ergonomic surface on top.
+
+### "55% component coverage seems low."
+
+> 55% covers every flagship primitive across Ant + MUI + shadcn. Remaining
+> 45% is mostly sub-components (Step.Item, Form.Field) and transition
+> primitives. Coverage push to 70% is on the 4.x roadmap. I prioritized
+> distribution + audit infrastructure over chasing 100% coverage on a
+> private repo.
+
+### "Korean-focused — does it work for English markets?"
+
+> Yes. The non-Korean portions cover Western design systems exhaustively.
+> Korean material is additive, in dedicated files (e.g.,
+> korean-payments.md, korean-typography.md). Adopters who don't load
+> KR-specific files get the Western corpus only.
+
+### "Why no fine-tuning?"
+
+> Fine-tuning means re-training every time a design system updates.
+> Markdown is grep-able, human-auditable, version-controllable, and
+> works with any LLM. If knowledge grows past ~100K tokens I'd add an
+> embedding index — but it currently fits comfortably in context.
+
+## After-submission tasks
+
+- Refresh the HN tab every 10 min in the first 90 minutes — early
+  upvote velocity decides front page.
+- Reply to *every* substantive comment within 30 min. Show HN's
+  ranking partly considers author engagement.
+- If frontpaged: tag the moment in `docs/announcements/posted.md`
+  with screenshot + final position.
+
+## Don't
+
+- Don't ask friends to upvote — HN flags vote rings.
+- Don't reply defensively to criticism. Acknowledge, then offer
+  evidence or roadmap.
+- Don't post during US night (KST morning) — HN audience is mostly
+  US/EU; aim Tuesday-Thursday 8-10am PT.

package/docs/announcements/twitter-thread.md

@@ -0,0 +1,255 @@
+# X / Twitter thread drafts
+
+Two parallel threads — one English, one Korean. Post 2 hours apart so they don't compete for retweets.
+
+## English thread (8 tweets)
+
+### 1/8 (hook)
+
+```
+After 32 phases, design-ai hit v4.0 stable today.
+
+It turns any AI coding agent (Claude Code, Codex, Cursor, Aider) into
+a senior product designer. With Korean market depth baked in.
+
+  npx @design-ai/cli install
+
+Architecture choices that shaped it 🧵
+```
+
+(images: stats card from press-kit.md)
+
+### 2/8 (model-agnostic)
+
+```
+1/ Markdown is the source of truth, not vendor-specific skills.
+
+Same content runs in Claude Code (skills + commands), Codex CLI
+(AGENTS.md), Cursor (.cursorrules), Aider (--read), VS Code sidebar
+extension, or as a system prompt for any LLM.
+
+Lock-in costs adopters. Markdown costs nothing.
+```
+
+### 3/8 (Korean depth)
+
+```
+2/ Korean conventions aren't a footnote, they're domain depth:
+
+• Toss / KakaoPay payment flow trees
+• 본인인증 (PASS / NICE / KCB) integration
+• Pretendard fallback chains
+• 해요체 vs 합쇼체 chatbot register
+• 확률 표시 (game UI)
+• KFDA / GRAC / 분리배출 (regulatory)
+```
+
+### 4/8 (distribution before content)
+
+```
+3/ Distribution before mass content.
+
+At 30% component coverage I built:
+• npm CLI
+• Homebrew formula
+• mkdocs site (EN + KO)
+• Claude plugin manifest
+• VS Code extension
+
+A 30% corpus adopters can install > 70% locked in a private repo.
+Coverage caught up later (now 55%).
+```
+
+### 5/8 (audit-driven quality)
+
+```
+4/ 6 audits gate every PR:
+
+• frontmatter shape
+• 360+ internal links
+• Korean voice/register
+• component coverage diff
+• integration walkthrough completeness
+• stale-content (>12mo = CI failure)
+
+Each new audit prevented a regression class.
+```
+
+### 6/8 (the journey)
+
+```
+v2.0 → v4.0 in numbers:
+
+  Knowledge files     55 → 91
+  Worked examples     83 → 160
+  Skills              12 → 19
+  Slash commands       8 → 15
+  Coverage           24% → 55%
+  Channels             1 → 4
+  Languages            0 → 2
+  Audits               4 → 6
+```
+
+### 7/8 (what v4.0 means)
+
+```
+v4.0 is a graduation release.
+
+8 surfaces (knowledge / skills / commands / agents / CLI / plugin /
+VS Code / docs) are now API-stable.
+
+Deprecation policy: deprecate in 4.x → maintain in 4.x → remove in 5.0.
+
+Adopters can pin and trust.
+```
+
+### 8/8 (CTA)
+
+```
+Try it:
+
+  npx @design-ai/cli install
+
+GitHub: https://github.com/sungjin9288/design-ai
+Docs: (mkdocs URL)
+License: MIT
+
+Questions, feedback, or contributions: GitHub Issues.
+
+Especially curious about your Cursor + Figma + Korean fintech setups.
+```
+
+## Korean thread (8 tweets, 한국어)
+
+### 1/8 (훅)
+
+```
+오늘 design-ai가 v4.0 stable에 도달했어요.
+
+모든 AI 코딩 에이전트 (Claude Code / Codex / Cursor / Aider)를 시니어
+프로덕트 디자이너로 만드는 오픈소스. 한국 시장 컨벤션이 기본 내장.
+
+  npx @design-ai/cli install
+
+만들면서 한 선택들 🧵
+```
+
+### 2/8 (모델 무관)
+
+```
+1/ 마크다운이 진실의 원천. 벤더 전용 스킬 파일 아님.
+
+같은 콘텐츠가 Claude Code (스킬 + 커맨드), Codex CLI (AGENTS.md),
+Cursor (.cursorrules), Aider (--read), VS Code 확장에서 모두 동작.
+
+Lock-in은 adopter한테 비용. 마크다운은 공짜.
+```
+
+### 3/8 (한국 시장 깊이)
+
+```
+2/ 한국 컨벤션은 footnote가 아니라 도메인 깊이:
+
+• Toss / KakaoPay 결제 흐름 트리
+• 본인인증 (PASS / NICE / KCB) 통합
+• Pretendard fallback 체인
+• 해요체 vs 합쇼체 챗봇 톤 분기
+• 확률 표시 (게임 UI)
+• KFDA / GRAC / 분리배출 (규제)
+```
+
+### 4/8 (배포 우선)
+
+```
+3/ 컨텐츠 양 늘리기 전에 배포 가능하게.
+
+커버리지 30%일 때 만들어 놓은 것:
+• npm CLI
+• Homebrew formula
+• mkdocs 사이트 (EN + KO)
+• Claude plugin manifest
+• VS Code 확장
+
+설치 가능한 30% > private repo의 70%. 커버리지는 나중에 따라잡았어요
+(현재 55%).
+```
+
+### 5/8 (감사 주도 품질)
+
+```
+4/ PR마다 6개 감사 게이팅:
+
+• frontmatter 형식
+• 360+ 내부 링크
+• 한국어 voice / register
+• 컴포넌트 커버리지 diff
+• 통합 워크스루 완전성
+• stale-content (>12개월 = CI 실패)
+
+각 감사가 회귀 케이스 한 종류씩 막아 줘요.
+```
+
+### 6/8 (여정)
+
+```
+v2.0 → v4.0 숫자로:
+
+  지식 파일      55 → 91
+  워크드 예제    83 → 160
+  스킬           12 → 19
+  슬래시 커맨드   8 → 15
+  커버리지      24% → 55%
+  배포 채널       1 → 4
+  언어            0 → 2
+  CI 감사         4 → 6
+```
+
+### 7/8 (v4.0 의미)
+
+```
+v4.0은 그래듀에이션 릴리스.
+
+8개 표면 (지식 / 스킬 / 커맨드 / 에이전트 / CLI / plugin / VS Code /
+docs) 이 API stable.
+
+deprecation 정책: 4.x에서 deprecate → 4.x 유지 → 5.0에서 제거.
+
+adopter가 pin하고 믿을 수 있어요.
+```
+
+### 8/8 (CTA)
+
+```
+시작하기:
+
+  npx @design-ai/cli install
+
+GitHub: https://github.com/sungjin9288/design-ai
+문서 (한국어): docs/USING.ko.md
+라이선스: MIT
+
+질문 / 피드백 / 기여: GitHub Issues.
+
+Cursor + Figma + 한국 핀테크 워크플로 케이스 특히 궁금해요.
+```
+
+## Posting timing
+
+- **English thread**: Tuesday-Thursday 8am PT (16:00 UTC).
+- **Korean thread**: same day, KST 9am (00:00 UTC) — 8 hours offset
+  from English to hit different timezones.
+- Reply to first 5 comments in each thread within 30 minutes.
+
+## Hashtags (last tweet only — clutters earlier ones)
+
+EN: `#opensource #design #ai #claude #korea #cursor`
+KO: `#오픈소스 #디자인 #AI #한국 #코드 #프론트엔드`
+
+## Don't
+
+- Don't use the same image in both threads (algorithm dedupe).
+- Don't @-mention Anthropic / Claude unless tagged organically.
+- Don't post both threads at the same minute — algorithm flags
+  duplicates.
+- Don't auto-translate the Korean thread from English. It's written
+  in natural Korean.

package/docs/external-status.md

@@ -0,0 +1,34 @@
+# External Publication Status
+
+> Checked: 2026-06-23
+> Scope: npm registry, GitHub Pages, VS Code Marketplace
+
+## Summary
+
+Local release readiness is verified and GitHub Pages docs are publicly reachable. The npm package name in `package.json` and the VS Code Marketplace extension id still returned no public listing at the time of this check.
+
+## Results
+
+| Surface | Checked target | Result | Evidence |
+|---|---|---|---|
+| npm registry | `@design-ai/cli` | Not published or not publicly accessible: npm returned `E404` | `evidence/cli-logs/npm-registry-status.log` |
+| GitHub Pages | `https://sungjin9288.github.io/design-ai/` | Published and reachable: HTTP `200`, design-ai MkDocs page rendered | `evidence/cli-logs/github-pages-status.log` |
+| VS Code Marketplace | `sungjin.design-ai-vscode` | No public Marketplace listing found for the publisher/extension id | `evidence/cli-logs/vscode-marketplace-status.log` |
+
+## Interpretation
+
+- The repository is locally release-ready based on `npm run release:check`.
+- GitHub Pages docs can now be described as publicly deployed.
+- Public npm install and Marketplace install claims should not be used in portfolio or README copy until those surfaces are published and rechecked.
+- For portfolio wording, describe npm/package/Marketplace as "prepared for" or "local/package smoke verified", not "publicly shipped".
+
+## Recheck Commands
+
+```bash
+npm view @design-ai/cli version name time.modified dist-tags --json
+curl -sS -L -o /tmp/design-ai-pages.html -w 'http_code=%{http_code}\nurl_effective=%{url_effective}\n' https://sungjin9288.github.io/design-ai/
+curl -sS -H 'Content-Type: application/json' \
+  -H 'Accept: application/json;api-version=7.2-preview.1' \
+  -X POST https://marketplace.visualstudio.com/_apis/public/gallery/extensionquery \
+  -d '{"filters":[{"criteria":[{"filterType":7,"value":"sungjin.design-ai-vscode"}]}],"flags":914}'
+```

package/docs/integrations/aider-walkthrough.ko.md

@@ -0,0 +1,275 @@
+# Aider 워크스루
+
+[Aider](https://aider.chat) (터미널 기반 AI 페어 프로그래머)에서 design-ai를 사용하는 구체적인 가이드. [`docs/AIDER-INTEGRATION.md`](../AIDER-INTEGRATION.md)는 설치를, 이 문서는 워크플로를 다뤄요.
+
+## 사전 준비
+
+```bash
+pip install aider-chat
+git clone https://github.com/sungjin9288/design-ai.git ~/dev/design-ai
+```
+
+Aider는 모델 API 키 (Anthropic, OpenAI 등) 필요:
+
+```bash
+export ANTHROPIC_API_KEY=...
+# 또는
+export OPENAI_API_KEY=...
+```
+
+## 설치 (60초)
+
+```bash
+cd ~/projects/my-app
+aider --read ~/dev/design-ai/AGENTS.md \
+      --read ~/dev/design-ai/knowledge/PRINCIPLES.md \
+      --model claude-sonnet-4-6
+```
+
+`--read`는 파일을 읽기 전용 컨텍스트로 추가해요 (Aider가 수정 안 함). 영구 설정은 `.aider.conf.yml`에 추가:
+
+```yaml
+# ~/projects/my-app/.aider.conf.yml
+read:
+  - /Users/sungjin/dev/design-ai/AGENTS.md
+  - /Users/sungjin/dev/design-ai/knowledge/PRINCIPLES.md
+model: claude-sonnet-4-6
+```
+
+## 워크스루 1: 스펙에서 컴포넌트 구현 생성
+
+**목표**: Aider가 design-ai Banner spec을 읽고 프로젝트에 작동하는 React 구현 생성.
+
+### 세션
+
+```
+$ aider src/components/Banner.tsx \
+        --read ~/dev/design-ai/examples/component-banner.md \
+        --read ~/dev/design-ai/knowledge/i18n/korean-document-style.md
+
+Aider v0.x — claude-sonnet-4-6 사용 중
+Read: examples/component-banner.md
+Read: knowledge/i18n/korean-document-style.md
+편집 중: src/components/Banner.tsx (새 파일)
+
+> spec에 따라 Banner 구현 주세요. 변형 info / success / warning /
+  error / promo. 닫기 가능. 토큰 시스템 (var(--color-...)) 사용.
+  기본값에 한국어 인식 카피.
+
+[Aider가 구현 생성]
+
+[Aider가 diff 제안하고 적용 요청]
+
+> y
+
+적용됨: src/components/Banner.tsx
+```
+
+`--read` 플래그는 Aider에게 design-ai 파일을 컨텍스트로 사용하되 수정하지 말라고 알려요. 편집은 작업 파일 (`src/components/Banner.tsx`)에만 들어가요.
+
+## 워크스루 2: 기존 컴포넌트를 spec에 맞춰 리팩토링
+
+**목표**: 오래된 `Alert.tsx`를 design-ai spec에 맞게 끌어올리기.
+
+### 세션
+
+```
+$ aider src/components/Alert.tsx \
+        --read ~/dev/design-ai/examples/component-alert.md \
+        --read ~/dev/design-ai/knowledge/a11y/contrast.md
+
+> 두 파일 다 읽어 주세요. Alert.tsx를 spec에 맞추기 위해 필요한 구체적
+  diff 나열. 그리고 적용해 주세요.
+
+[Aider가 읽고 5개 diff 나열, 각 적용 요청]
+
+> 1, 3, 5만 적용. 2와 4는 건너뛰기 (제품 승인 필요).
+
+[Aider가 부분 적용]
+```
+
+Aider의 diff별 적용은 spec 컴플라이언스에 좋아요 — 크리티컬 수정은 받아들이고 주관적인 변경은 미룰 수 있어요.
+
+## 워크스루 3: 완전한 디자인 시스템 생성
+
+**목표**: 브리프에서 디자인 토큰 부트스트랩, 파일로 머터리얼라이즈.
+
+### 세션
+
+```
+$ aider \
+    --read ~/dev/design-ai/skills/design-system-builder/PLAYBOOK.md \
+    --read ~/dev/design-ai/skills/color-palette/PLAYBOOK.md \
+    --read ~/dev/design-ai/knowledge/colors/color-theory.md \
+    --read ~/dev/design-ai/knowledge/i18n/korean-typography.md \
+    src/tokens/colors.css \
+    src/tokens/typography.css \
+    src/tokens/spacing.css \
+    tailwind.config.ts
+
+> design-system-builder 적용. 브리프: 프리랜서를 위한 한국 핀테크.
+  브랜드: 신뢰감, 차분함, 모던. Seed: oklch(56% 0.16 244).
+  Pretendard 타이포그래피. 4개 열린 파일에 출력. colors.css
+  맨 위에 주석 블록으로 대비 매트릭스.
+
+[Aider가 한 번의 적용 패스에서 4개 파일 모두 생성]
+```
+
+여러 파일 산출물의 경우, Aider의 "여러 파일을 한 번에 열기 + 원자적 diff 적용" 패턴이 순차적 단일 파일 생성보다 효율적이에요.
+
+## 워크스루 4: 한 세션에서 감사 + 수정
+
+**목표**: 화면을 a11y 감사하고, 수정 생성, 적용.
+
+### 세션
+
+```
+$ aider \
+    --read ~/dev/design-ai/agents/a11y-reviewer.md \
+    --read ~/dev/design-ai/knowledge/a11y/contrast.md \
+    --read ~/dev/design-ai/knowledge/a11y/keyboard-and-focus.md \
+    src/screens/PricingScreen.tsx \
+    src/screens/PricingScreen.css
+
+> PricingScreen을 a11y 감사. 발견사항을 CRITICAL / HIGH / MEDIUM / LOW
+  로 보고. 그리고 CRITICAL과 HIGH는 자동 수정.
+
+[Aider가 감사하고 7개 발견사항 나열]
+[CRITICAL/HIGH 4개 자동 수정]
+[저우선 3개에 대해 질문]
+
+> 일단 건너뛰기.
+
+[Aider가 명확한 메시지로 수정 커밋]
+```
+
+## Aider 전용 패턴
+
+### 읽기 전용 vs 편집 가능
+
+```
+aider [편집 가능 파일들] --read [읽기 전용 컨텍스트 파일들]
+```
+
+design-ai 파일은 항상 `--read` (Aider가 절대 수정 안 함). 프로젝트 파일은 편집 가능.
+
+전형적인 세션:
+- 1-3개 편집 대상 파일 (컴포넌트, CSS, 테스트)
+- 5-15개 읽기 전용 design-ai 파일 (스킬 플레이북 + 관련 지식)
+
+### 동적 컨텍스트의 `/add` and `/drop`
+
+세션 중에:
+
+```
+> /add src/components/Button.tsx     # 편집 가능에 추가
+> /read ~/dev/design-ai/examples/component-button.md   # 읽기 전용에 추가
+> /drop src/components/Button.tsx    # 세션에서 제거
+```
+
+작업 범위가 중간에 바뀔 때 유용.
+
+### 복잡한 spec을 위한 Architect 모드
+
+Aider의 `--architect` 모드는 계획에 강력한 모델, 편집에 빠른 모델 사용:
+
+```bash
+aider --architect \
+      --architect-model claude-opus-4 \
+      --editor-model claude-sonnet-4-6 \
+      --read ~/dev/design-ai/skills/design-system-builder/PLAYBOOK.md \
+      [files...]
+```
+
+Architect 모드가 spec을 계획; editor 모델이 적용. 큰 리팩토링에 좋음.
+
+### 변경별 자동 커밋
+
+Aider는 기본적으로 각 적용을 자동 커밋. design-ai 워크플로에서:
+- Commit 1: "design-ai spec에 맞춰 Banner 컴포넌트 추가"
+- Commit 2: "브리프에서 시맨틱 컬러 토큰 추가"
+- Commit 3: "a11y 리뷰에 따라 CTA 대비를 WCAG AA로 수정"
+
+각 커밋이 작게 범위 잡힘. 리뷰 / revert / cherry-pick 쉬움.
+
+비활성화: `--no-auto-commits`.
+
+### 테스트 모드
+
+```bash
+aider --test-cmd "pnpm test" --auto-test
+```
+
+Aider가 각 변경 후 테스트 명령 실행. 컴포넌트 구현 시 유용 — 구현 패스 중 회귀 catch.
+
+## 팁
+
+### design-ai PRINCIPLES를 시스템 리마인더로 사용
+
+```bash
+aider --read ~/dev/design-ai/knowledge/PRINCIPLES.md ...
+```
+
+해당 파일은 30개 핵심 규칙을 단일 페이지로 요약. 항상 로드; 저렴.
+
+### 스킬별 alias
+
+흔한 워크플로용 bash alias 추가:
+
+```bash
+# ~/.bashrc
+alias aider-design='aider --read ~/dev/design-ai/AGENTS.md --read ~/dev/design-ai/knowledge/PRINCIPLES.md --model claude-sonnet-4-6'
+alias aider-spec='aider-design --read ~/dev/design-ai/skills/component-spec-writer/PLAYBOOK.md'
+alias aider-palette='aider-design --read ~/dev/design-ai/skills/color-palette/PLAYBOOK.md'
+```
+
+이후:
+```bash
+aider-spec src/components/NewComponent.tsx
+```
+
+### 한국어 기본값
+
+```bash
+aider --read ~/dev/design-ai/AGENTS.md \
+      --read ~/dev/design-ai/knowledge/i18n/korean-typography.md \
+      --read ~/dev/design-ai/knowledge/i18n/korean-document-style.md \
+      --read ~/dev/design-ai/knowledge/i18n/korean-product-conventions.md \
+      [files...]
+```
+
+한국 B2C 팀의 경우 위의 read를 `.aider.conf.yml`에 굽기.
+
+## 문제 해결
+
+### Aider가 큰 스킬에서 컨텍스트 한도에 부딪힘
+
+Aider는 `--read` 파일을 매 턴 컨텍스트에 보내요. 매우 큰 플레이북 + 많은 지식 파일의 경우:
+- 작업당 관련 항목만 `--read`.
+- `/drop`으로 컨텍스트 비우기.
+- 매우 큰 세션은 더 큰 컨텍스트 모델 사용 (Claude Sonnet 4.6 ≥ 200K 토큰, GPT-4o ~ 128K).
+
+### 출력이 design-ai 컨벤션 무시
+
+Aider에 명시적 리마인더 (세션 중간):
+
+```
+> 제가 드린 읽기 전용 파일의 design-ai 컨벤션을 따라:
+  destructive 변형 적용해 주세요.
+```
+
+또는 `AGENTS.md`가 `--read`로 로드되었는지 확인.
+
+### 한국어 텍스트가 깨짐
+
+Aider는 모든 주요 모델에서 한국어 작동. 한글이 `?`나 박스로 렌더링되면:
+- 터미널이 UTF-8 지원하는지 확인 (대부분 지원, Windows cmd는 기본 아닐 수 있음).
+- UTF-8 강제: `export PYTHONIOENCODING=utf-8`.
+
+## 다음
+
+- [`docs/AIDER-INTEGRATION.md`](../AIDER-INTEGRATION.md) — 전체 설치 레퍼런스
+- [`docs/integrations/codex-walkthrough.ko.md`](codex-walkthrough.ko.md) — Codex CLI 변형
+- [`docs/integrations/cursor-walkthrough.ko.md`](cursor-walkthrough.ko.md) — Cursor 변형
+- [`docs/integrations/sdk-walkthrough.ko.md`](sdk-walkthrough.ko.md) — Anthropic / OpenAI SDK
+- [`docs/integrations/vscode-walkthrough.ko.md`](vscode-walkthrough.ko.md) — VS Code 확장