@litfamily/litclaude 1.0.8 → 1.0.9

package/README_ko-KR.md

@@ -1,12 +1,11 @@
-<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.8/docs/assets/cover.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.8/docs/assets/cover-motion.webp" width="100%" alt="LitClaude cover art. An orange signal moves through orbital paths above the CLAUDE CODE wordmark. The static family cover appears for reduced-motion preference." /></picture></p>
-<p align="center"><a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.8/docs/assets/cover.webp">정지 표지 보기</a></p>
+<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@latest/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/docs/assets/cover-motion.webp" width="100%" alt="LitClaude cover art. An orange signal moves through orbital paths above the CLAUDE CODE wordmark. Reduced-motion users see a still frame from this motion cover." /></picture></p>
+<p align="center"><a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/docs/assets/cover.webp">정지 표지 보기</a></p>
 
 <h1 align="center">LitClaude</h1>
 <p align="center"><strong>Keep the work lit.</strong></p>
-<p align="center">불씨를 건네받았다.<br />이제, 당신의 작업에 옮길 차례다.</p>
 <p align="center">Claude Code에서 계획하고, 만들고, 확인한 일을 다음 세션으로 이어가세요.</p>
 <p align="center">
-  <a href="#설치">설치</a> · <a href="#처음-사용하기">첫 결과물</a> · <a href="#작업-이어가기">작업 이어가기</a> · <a href="#주요-라우트">주요 라우트</a> · <a href="./README.md">English</a>
+  <a href="#설치">설치</a> · <a href="#빠른-시작">빠른 시작</a> · <a href="#주요-라우트">주요 경로</a> · <a href="#링크">링크</a> · <a href="./README.md">English</a>
 </p>
 
 <p align="center"><img src="./docs/assets/readme/ascii-readme.svg" width="480" alt="LIT ASCII B mark" /></p>
@@ -39,73 +38,23 @@
 
 </details>
 
-<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.8/docs/assets/litclaude-wordmark.svg" width="480" alt="LITCLAUDE 디스플레이 타입" /></p>
-<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.8/docs/assets/litclaude-clay-icon.png" width="160" alt="LitClaude 클레이 마크" /></p>
+<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/docs/assets/litclaude-wordmark.svg" width="480" alt="LITCLAUDE 디스플레이 타입" /></p>
+<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/docs/assets/litclaude-clay-icon.png" width="160" alt="LitClaude 클레이 마크" /></p>
 
 <p align="center">
-  <img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.8/docs/assets/readme/badge-version.svg" alt="1.0.8" />
-  <a href="./LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.8/docs/assets/readme/badge-license.svg" alt="MIT license" /></a>
+  <img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/docs/assets/readme/badge-version.svg" alt="1.0.9" />
+  <a href="./LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/docs/assets/readme/badge-license.svg" alt="MIT license" /></a>
 </p>
 
 <p align="center">
   <a href="#추가-문서"><img src="./docs/assets/readme/lucide-book-open.svg" width="16" alt="" /> 문서</a> · <a href="./docs/assets/readme/ignition-film.mp4"><img src="./docs/assets/readme/lucide-play.svg" width="16" alt="" /> Ignition</a> · <a href="./LICENSE"><img src="./docs/assets/readme/lucide-shield-check.svg" width="16" alt="" /> MIT</a>
 </p>
 
-## 작은 lit 작업부터 시작하기
-
-프롬프트 끝에 `lit`을 붙이면 Claude Code hook이 작업 루프를 시작합니다. hook은 경로 안내를 보내고 실제 작업은 Claude Code가 수행합니다.
-
-| 프롬프트 또는 경로 | 효과 |
-| --- | --- |
-| `lit` | 현재 Claude Code 대화에서 근거 중심 작업 루프를 시작합니다. |
-| `handoff` | 확인한 결과와 다음 할 일을 다음 세션으로 건넵니다. |
-| `lit-plan` | 구현 전에 범위와 확인 기준이 있는 계획을 만듭니다. |
-| `/litclaude:start-work <승인된 계획>` | 이미 승인한 계획을 실행합니다. |
-| `review-work` | 변경과 근거를 읽고 남은 일을 보고합니다. |
-| `litresearch` | 출처를 남기는 조사 경로로 사실과 불확실성을 나눕니다. |
-
-hook의 표시는 작업 진입을 뜻하며 작업이나 브라우저 확인이 끝났다는 증거는 아닙니다.
-
-<p align="center"><a href="./docs/assets/readme/ignition-film.mp4"><img src="./docs/assets/readme/ignition-poster.png" width="720" alt="Ignition 모션 포스터" /></a></p>
-
-포스터를 선택하면 선택형 Ignition 영상을 엽니다. README에서 자동 재생하지 않습니다.
-
-## 실제 경로와 편집 이미지
-
-`lit`은 근거 중심 루프를 시작하고, `handoff`는 확인한 작업을 다음 세션으로 넘깁니다. `lit-plan`은
-범위와 기준이 있는 계획을 작성하며, `/litclaude:start-work <승인된 계획>`은 승인한 계획을 실행합니다.
-`review-work`는 변경과 근거를 검토하고, `litresearch`는 출처와 불확실성을 나누어 기록합니다. 각 경로는
-프로젝트 기록에 기대한 효과를 남기며 새 슬래시 경로를 만들지 않습니다. 호스트 한계상 hook과 모델 실행은
-Claude Code가 담당하지만 권한, 브라우저 접근, 화면 확인은 호스트의 능력입니다. hook 표시나 정적 편집
-이미지는 완료 증거가 아닙니다.
-
-<p align="center"><img src="./docs/assets/litclaude-ignition-1600.webp" width="49%" alt="LitClaude 시작 편집 이미지" /> <img src="./docs/assets/litclaude-continuity-1600.webp" width="49%" alt="LitClaude 이어가기 편집 이미지" /></p>
-
-소스 트리의 `docs/assets/cover.svg`는 편집 가능한 저대역폭 대체 표지로 남아 있으며, 위 WebP는 제품 강조 표지입니다.
-
-## 불씨를 남기는 일
-
-고치고 싶은 버그 하나. 만들고 싶은 화면 하나. 끝내고 싶은 프로젝트 하나.
-
-시작은 짧은 한 줄이면 됩니다. 어려운 건 그다음입니다. 대화가 길어지고 세션이 바뀌면,
-어디까지 했는지부터 다시 짚어야 합니다. 어떤 결정을 내렸는지, 무엇을 확인했는지,
-다음에는 무엇을 해야 하는지.
-
-**LIT은 그 불씨를 남깁니다.** 목표와 계획, 확인한 결과, 다음에 할 일을 프로젝트에
-기록합니다. 다음 세션에서 그 기록을 읽고 작업을 이어갈 수 있도록.
-
-**대화가 끝난 자리에서, 다음 작업이 시작되도록.**
-
-LitClaude는 Claude Code에 증거 기반 실행, 계획, 조사, 검토 흐름을 더합니다.
-플러그인과 HUD를 한 번 설치하면 일반 `claude` 세션에서 사용할 수 있습니다.
-
 ## 설치
 
 `@litfamily/litclaude`는 scoped package입니다. Node.js/npm과 Claude Code가 필요합니다.
 로컬 검증을 할 때는 먼저
 [별도 체험 프로필](./docs/migration.md#separate-trial-profile)을 준비하세요.
-기존 설치에서 `INSTALL_OWNERSHIP_CONFLICT`가 나왔다면 반복 설치나 폴더 이동을 멈추고
-[소유권 충돌 안내](./docs/migration.md#ownership-conflicts)를 확인하세요.
 
 다음은 기본 safe 권한 모드에서 사용할 명령입니다.
 
@@ -117,7 +66,7 @@ npm exec --yes --package @litfamily/litclaude@latest -- litclaude install --yes
 권한·HUD 색상·출력 스타일은 필요할 때 명시적으로 선택합니다.
 [설치 상세](#설치-상세)에서 옵션과 버전 고정 방법을 확인하세요.
 
-## 처음 사용하기
+## 빠른 시작
 
 Claude Code를 실행합니다.
 
@@ -147,7 +96,46 @@ namespaced slash command는 Claude Code native command surface에서 처리되
 hook을 중복 활성화하지 않습니다. 명시적으로 skill을 실행하려면
 `/litclaude:lit-loop` 같은 route를 사용하세요.
 
-## 작업 이어가기
+## 주요 기능
+
+불씨를 건네받았다. 이제, 당신의 작업에 옮길 차례다.
+
+고치고 싶은 버그 하나. 만들고 싶은 화면 하나. 끝내고 싶은 프로젝트 하나.
+
+시작은 짧은 한 줄이면 됩니다. 어려운 건 그다음입니다. 대화가 길어지고 세션이 바뀌면,
+어디까지 했는지부터 다시 짚어야 합니다. 어떤 결정을 내렸는지, 무엇을 확인했는지,
+다음에는 무엇을 해야 하는지.
+
+**LIT은 그 불씨를 남깁니다.** 목표와 계획, 확인한 결과, 다음에 할 일을 프로젝트에
+기록합니다. 다음 세션에서 그 기록을 읽고 작업을 이어갈 수 있도록.
+
+**대화가 끝난 자리에서, 다음 작업이 시작되도록.**
+
+LitClaude는 Claude Code에 증거 기반 실행, 계획, 조사, 검토 흐름을 더합니다.
+플러그인과 HUD를 한 번 설치하면 일반 `claude` 세션에서 사용할 수 있습니다.
+
+## 주요 라우트
+
+### 작은 lit 작업부터 시작하기
+
+프롬프트 끝에 `lit`을 붙이면 Claude Code hook이 작업 루프를 시작합니다. hook은 경로 안내를 보내고 실제 작업은 Claude Code가 수행합니다.
+
+| 프롬프트 또는 경로 | 효과 |
+| --- | --- |
+| `lit` | 현재 Claude Code 대화에서 근거 중심 작업 루프를 시작합니다. |
+| `handoff` | 확인한 결과와 다음 할 일을 다음 세션으로 건넵니다. |
+| `lit-plan` | 구현 전에 범위와 확인 기준이 있는 계획을 만듭니다. |
+| `/litclaude:start-work <승인된 계획>` | 이미 승인한 계획을 실행합니다. |
+| `review-work` | 변경과 근거를 읽고 남은 일을 보고합니다. |
+| `litresearch` | 출처를 남기는 조사 경로로 사실과 불확실성을 나눕니다. |
+
+hook의 표시는 작업 진입을 뜻하며 작업이나 브라우저 확인이 끝났다는 증거는 아닙니다.
+
+<p align="center"><a href="./docs/assets/readme/ignition-film.mp4"><img src="./docs/assets/readme/ignition-poster.png" width="720" alt="Ignition 모션 포스터" /></a></p>
+
+포스터를 선택하면 선택형 Ignition 영상을 엽니다. README에서 자동 재생하지 않습니다.
+
+### 작업 이어가기
 
 ```text
 계획하기 → 만들기 → 확인하기 → 다음 작업에 건네기
@@ -170,6 +158,91 @@ hook을 중복 활성화하지 않습니다. 명시적으로 skill을 실행하
 **세션이 끝나도, 이어갈 작업을 남긴다는 뜻입니다.** 재개할 때는 새 세션에서 기록을
 읽고 현재 파일 상태와 대조해야 합니다.
 
+### 전체 경로 표
+
+| 입력 | 용도 |
+| --- | --- |
+| `lit`, `litwork` | 증거 우선·test-first 실행 loop. `$lit-loop`, `/lit-loop`, `/litclaude:lit-loop`도 지원합니다. |
+| `lit plan <what>` | 계획만 작성합니다. `$lit-plan`, `/lit-plan`도 지원합니다. |
+| `lit review <scope>` | 계획 또는 완료한 작업을 검토합니다. `$review-work`, `/review-work`도 지원합니다. |
+| `lit research <question>` | 인용 가능한 public-source 조사입니다. `$litresearch`, `/litclaude:litresearch`도 지원합니다. |
+| `lit search <question>` | Public-source retrieval |
+| `lit query <question>` | durable local state에서 근거를 조회합니다. |
+| `lit goal <outcome>` | 하나의 목표와 검증 가능한 기준을 연결합니다. `$litgoal`, `/litgoal`도 지원합니다. |
+| `lit workflow <objective>` | 넓은 위임 작업을 위한 Dynamic workflow를 제안합니다. |
+| `lit team`, `lit teammates` | `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`이고 사용자가 승인한 경우에만 native agent team을 제안합니다. |
+| `$deep-interview`, `/deep-interview` | 모호한 요청을 결정 가능한 brief로 정리합니다. |
+| `lit recap`, `litrecap`, `$lit-recap`, `/lit-recap`, `/litclaude:lit-recap` | Read-only session recap |
+| `handoff`, `/litclaude:lit-handoff` | 검증된 continuation packet을 작성합니다. |
+| `lit-scientific-visualization` | 출판용 figure를 준비합니다. `/litclaude:lit-scientific-visualization`도 지원합니다. |
+| `litclaude wikify <capture/save/review/query/config>` | 검토 기반 local structured knowledge를 관리합니다. |
+| `browser-drive`, `$browser-drive` | 외부 driver capability probe가 확인된 뒤에만 실제 page를 조작합니다. fetch로 대체하지 않으며 credential 사용과 승인 없는 설치를 하지 않습니다. |
+
+이름으로 호출하는 주요 스킬은 `lit-crucible`(계획 검토), `lit-init`(저장소 지침),
+`lit-commit`(Git 이력), `lit-team`(네이티브 팀), `lit-burnoff`(변경 묶음 정리),
+`lit-burnoff-file`(단일 파일 정리), `lit-korean`(한국어 문장),
+`lit-code`(구현 규율)입니다. 프롬프트 앞에 이름 또는 `$<skill-id>`를 입력합니다.
+이전 이름은 한 릴리스 동안 안내 문구와 함께 새 스킬로 연결됩니다.
+[이름 이전 표](./docs/migration.md#one-release-rename-aliases)를 참고하세요.
+
+## 문제 해결
+
+기존 설치에서 `INSTALL_OWNERSHIP_CONFLICT`가 나왔다면 반복 설치나 폴더 이동을 멈추고
+[소유권 충돌 안내](./docs/migration.md#ownership-conflicts)를 확인하세요.
+
+### 검증 및 제거
+
+설치된 package는 다음 관리 명령을 제공합니다.
+
+```bash
+npm exec --yes --package @litfamily/litclaude@latest -- litclaude doctor
+npm exec --yes --package @litfamily/litclaude@latest -- litclaude --version
+npm exec --yes --package @litfamily/litclaude@latest -- litclaude path
+npm exec --yes --package @litfamily/litclaude@latest -- litclaude workflow-check --json
+npm exec --yes --package @litfamily/litclaude@latest -- litclaude update
+npm exec --yes --package @litfamily/litclaude@latest -- litclaude uninstall
+```
+
+`uninstall`은 LitClaude가 관리한 plugin, HUD, permission, local state만
+제거하며 다른 Claude 설정은 제거하지 않습니다. 수정되었거나 소유권을 확인할 수 없는
+설치는 보존하고 거절합니다. [충돌 안내](./docs/migration.md#ownership-conflicts)를 따르세요.
+별도 프로필 체험을 마쳤다면 해당 세션과 터미널을 닫고 원래 환경의 터미널로 돌아가면
+됩니다. 이전 설치를 지우거나 재설치할 필요는 없습니다.
+
+## 링크
+
+<a id="추가-문서"></a>
+
+- [운영 참고](#운영-참고)
+- [Hook trigger와 activation boundary](./docs/hooks.md)
+- [Agent와 orchestration 안내](./docs/agents.md)
+- [Workflow migration 표](./docs/migration.md)
+- [Native `/goal` surface matrix](./docs/native-goal-surface.md)
+- [Workflow compatibility audit](./docs/workflow-compatibility-audit.md)
+- [Release checklist](./RELEASE_CHECKLIST.md)
+- [Release history](./CHANGELOG.md)
+- [English README](./README.md)
+
+### LITFAMILY
+
+<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/docs/assets/cover.webp" width="100%" alt="LitFamily의 다섯 로봇 동료와 KEEP THE WORK LIT. 문구를 담은 정지 표지" /></p>
+
+<details>
+<summary>추가 흐름과 제품 참고</summary>
+
+## 실제 경로와 편집 이미지
+
+`lit`은 근거 중심 루프를 시작하고, `handoff`는 확인한 작업을 다음 세션으로 넘깁니다. `lit-plan`은
+범위와 기준이 있는 계획을 작성하며, `/litclaude:start-work <승인된 계획>`은 승인한 계획을 실행합니다.
+`review-work`는 변경과 근거를 검토하고, `litresearch`는 출처와 불확실성을 나누어 기록합니다. 각 경로는
+프로젝트 기록에 기대한 효과를 남기며 새 슬래시 경로를 만들지 않습니다. 호스트 한계상 hook과 모델 실행은
+Claude Code가 담당하지만 권한, 브라우저 접근, 화면 확인은 호스트의 능력입니다. hook 표시나 정적 편집
+이미지는 완료 증거가 아닙니다.
+
+<p align="center"><img src="./docs/assets/litclaude-ignition-1600.webp" width="49%" alt="LitClaude 시작 편집 이미지" /> <img src="./docs/assets/litclaude-continuity-1600.webp" width="49%" alt="LitClaude 이어가기 편집 이미지" /></p>
+
+소스 트리의 `docs/assets/cover.svg`는 편집 가능한 저대역폭 대체 표지로 남아 있으며, 위 WebP는 제품 강조 표지입니다.
+
 ## Claude Code 안에서의 흐름
 
 짧은 prompt와 slash command는 서로 다른 입구를 사용합니다. hook은 route 안내와
@@ -205,33 +278,6 @@ LitClaude, LitHermes, LitCodex, LitOpenCode, LitGrok을 아머드 머신으로
 
 </details>
 
-## 주요 라우트
-
-| 입력 | 용도 |
-| --- | --- |
-| `lit`, `litwork` | 증거 우선·test-first 실행 loop. `$lit-loop`, `/lit-loop`, `/litclaude:lit-loop`도 지원합니다. |
-| `lit plan <what>` | 계획만 작성합니다. `$lit-plan`, `/lit-plan`도 지원합니다. |
-| `lit review <scope>` | 계획 또는 완료한 작업을 검토합니다. `$review-work`, `/review-work`도 지원합니다. |
-| `lit research <question>` | 인용 가능한 public-source 조사입니다. `$litresearch`, `/litclaude:litresearch`도 지원합니다. |
-| `lit search <question>` | Public-source retrieval |
-| `lit query <question>` | durable local state에서 근거를 조회합니다. |
-| `lit goal <outcome>` | 하나의 목표와 검증 가능한 기준을 연결합니다. `$litgoal`, `/litgoal`도 지원합니다. |
-| `lit workflow <objective>` | 넓은 위임 작업을 위한 Dynamic workflow를 제안합니다. |
-| `lit team`, `lit teammates` | `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`이고 사용자가 승인한 경우에만 native agent team을 제안합니다. |
-| `$deep-interview`, `/deep-interview` | 모호한 요청을 결정 가능한 brief로 정리합니다. |
-| `lit recap`, `litrecap`, `$lit-recap`, `/lit-recap`, `/litclaude:lit-recap` | Read-only session recap |
-| `handoff`, `/litclaude:lit-handoff` | 검증된 continuation packet을 작성합니다. |
-| `lit-scientific-visualization` | 출판용 figure를 준비합니다. `/litclaude:lit-scientific-visualization`도 지원합니다. |
-| `litclaude wikify <capture/save/review/query/config>` | 검토 기반 local structured knowledge를 관리합니다. |
-| `browser-drive`, `$browser-drive` | 외부 driver capability probe가 확인된 뒤에만 실제 page를 조작합니다. fetch로 대체하지 않으며 credential 사용과 승인 없는 설치를 하지 않습니다. |
-
-이름으로 호출하는 주요 스킬은 `lit-crucible`(계획 검토), `lit-init`(저장소 지침),
-`lit-commit`(Git 이력), `lit-team`(네이티브 팀), `lit-burnoff`(변경 묶음 정리),
-`lit-burnoff-file`(단일 파일 정리), `lit-korean`(한국어 문장),
-`lit-code`(구현 규율)입니다. 프롬프트 앞에 이름 또는 `$<skill-id>`를 입력합니다.
-이전 이름은 한 릴리스 동안 안내 문구와 함께 새 스킬로 연결됩니다.
-[이름 이전 표](./docs/migration.md#one-release-rename-aliases)를 참고하세요.
-
 ## 안전 모델
 
 - Hook은 제한된 Claude Code event JSON을 읽고 사용자 prompt text를 실행하지
@@ -253,36 +299,30 @@ LitClaude, LitHermes, LitCodex, LitOpenCode, LitGrok을 아머드 머신으로
 명시적인 opt-in이 필요합니다. Native goal tool이 없으면 local `litgoal` ledger를
 기준으로 사용하며, LitClaude가 사용자를 대신해 `/goal`을 전송하지 않습니다.
 
-## 검증 및 제거
+## GPT 모델 기준과 LitClaude의 경계
 
-설치된 package는 다음 관리 명령을 제공합니다.
-
-```bash
-npm exec --yes --package @litfamily/litclaude@latest -- litclaude doctor
-npm exec --yes --package @litfamily/litclaude@latest -- litclaude --version
-npm exec --yes --package @litfamily/litclaude@latest -- litclaude path
-npm exec --yes --package @litfamily/litclaude@latest -- litclaude workflow-check --json
-npm exec --yes --package @litfamily/litclaude@latest -- litclaude update
-npm exec --yes --package @litfamily/litclaude@latest -- litclaude uninstall
-```
+OpenAI 모델 라우팅을 지원하는 제품은 새로 설치할 때 GPT-6를 기본으로 사용합니다. 계획·검토·리드 역할에는
+`gpt-6-astra`, 코딩 리드 대안에는 `gpt-6-sol`, helper·일반 작업자에는 `gpt-6-luna`를 사용합니다.
+GPT-6 Luna는 `xhigh`를 지원하지만 `ultra` effort는 지원하지 않습니다. 호스트 카탈로그에는 이전 세대
+`gpt-5.6-sol`, `gpt-5.6-terra`, `gpt-5.6-luna`가 계속 표시되며 세 모델 모두 선택할 수 있습니다.
+이들에 대한 지원 종료일 메타데이터는 없습니다. 카탈로그에서 `gpt-5.6-luna`도 `xhigh`를
+지원하지만, LitClaude의 기존 정책 전용 제한은 이 조합을 계속 차단합니다.
+`gpt-6-luna`의 `xhigh`는 카탈로그에서 지원되며, 일반 작업자 경로의 기본 effort는 `max`입니다.
+일반 설치와 업데이트는 이미 설정된 모델을 바꾸지 않습니다.
 
-`uninstall`은 LitClaude가 관리한 plugin, HUD, permission, local state만
-제거하며 다른 Claude 설정은 제거하지 않습니다. 수정되었거나 소유권을 확인할 수 없는
-설치는 보존하고 거절합니다. [충돌 안내](./docs/migration.md#ownership-conflicts)를 따르세요.
-별도 프로필 체험을 마쳤다면 해당 세션과 터미널을 닫고 원래 환경의 터미널로 돌아가면
-됩니다. 이전 설치를 지우거나 재설치할 필요는 없습니다.
+이 기준이 LitClaude가 OpenAI 경로를 적용한다는 뜻은 아닙니다. LitClaude에는 OpenAI 모델
+카탈로그가 없고 Claude Code가 모델을 선택합니다. `tools/check-model-routing.mjs`는 지원하지
+않는 Claude Code 경로를 차단하는 참조용 검사입니다.
 
-## 추가 문서
+### 모델 카탈로그 참조 갱신
 
-- [운영 참고](#운영-참고)
-- [Hook trigger와 activation boundary](./docs/hooks.md)
-- [Agent와 orchestration 안내](./docs/agents.md)
-- [Workflow migration 표](./docs/migration.md)
-- [Native `/goal` surface matrix](./docs/native-goal-surface.md)
-- [Workflow compatibility audit](./docs/workflow-compatibility-audit.md)
-- [Release checklist](./RELEASE_CHECKLIST.md)
-- [Release history](./CHANGELOG.md)
-- [English README](./README.md)
+LitClaude 저장소에는 생성되는 OpenAI 모델 카탈로그가 없습니다. 공유 Codex 호스트 카탈로그의
+캐시 파일은 `~/.codex/models_cache.json`이며, 현재 카탈로그를 새로 읽어 출력하려면
+`codex debug models`를 실행합니다 (`--bundled`를 지정하면 번들 데이터만 출력합니다).
+LitClaude의 정책 참조는 `tools/check-model-routing.mjs`에 있고, 경계 검사는
+`node --test test/model-routing.test.mjs`로 고정합니다. 배포하는 `SKILL.md`의 모델 안내를
+바꾸면 `npm run gen:skill-resources`로 리소스 맵을 다시 만들고
+`npm run check:skill-resources`로 확인합니다.
 
 <details>
 <summary>운영 참고 — 설치 옵션, 학습, 호스트 경계와 개발</summary>
@@ -298,7 +338,7 @@ npm exec --yes --package @litfamily/litclaude@latest -- litclaude uninstall
 - **Claude skill**에는 `litwork`, `structural-search`, `lit-team`,
   `autoresearch`, `autoconference`도 포함됩니다. 핵심 순서는
   `lit-plan`, `lit-recap`, `lit-loop`입니다.
-- Auxiliary Skill-discovery entry인 `frontend-ui-ux`, `lit-commit`,
+- Auxiliary Skill-discovery entry인 `frontend-ui-ux`, `readme-studio`, `lit-commit`,
   `lsp-setup`, `visual-qa`는 문장 앞의 bare token이나 `$frontend-ui-ux`로
   활성화되며 anywhere-token은 아닙니다.
 - 포함된 reference pack은 `lit-code/references`, `lit-code/scripts`,
@@ -350,13 +390,13 @@ npm exec --yes --package @litfamily/litclaude@latest -- litclaude install
 설치를 재현하려면 registry에서 현재 package version을 조회한 뒤 고정합니다.
 
 ```bash
-npm view @litfamily/litclaude@1.0.8 version
+npm view @litfamily/litclaude@1.0.9 version
 ```
 
-조회 결과가 `1.0.8`이면 exact install을 사용할 수 있습니다.
+조회 결과가 `1.0.9`이면 exact install을 사용할 수 있습니다.
 
 ```bash
-npm exec --yes --package @litfamily/litclaude@1.0.8 -- litclaude install
+npm exec --yes --package @litfamily/litclaude@1.0.9 -- litclaude install
 ```
 
 그렇지 않으면 명시적인 human publication을 기다립니다. Pin은 그 뒤에 사용합니다.
@@ -418,7 +458,7 @@ litclaude install
 
 ## Claude Code 연결 구조
 
-**Claude Code와 LitClaude의 연결 구조입니다.** Session과 tool event가 rules, routing, authority, ledger surface로 전달됩니다. 이 구조에서 33개 skill·16개 command·11개 agent가 host 경계 안에서 연결됩니다.
+**Claude Code와 LitClaude의 연결 구조입니다.** Session과 tool event가 rules, routing, authority, ledger surface로 전달됩니다. 이 구조에서 34개 skill·16개 command·11개 agent가 host 경계 안에서 연결됩니다.
 
 ```mermaid
 flowchart LR
@@ -439,7 +479,7 @@ flowchart LR
     H5 --> LEDGER
     H6 --> LEDGER
     H7 --> LEDGER
-    LC --> S["33 skills · 16 commands · 11 agents"]
+    LC --> S["34 skills · 16 commands · 11 agents"]
 ```
 
 **아무것도 남아 있지 않은 machine에서도 skill이 작동하는 이유입니다.** Self-contained skill은 allowlist에 명시적인 근거가 있어야 하고, corpus를 참조하는 skill은 packed tarball 안에서 그 corpus를 찾아야 합니다. 이 payload gate가 checkout에만 남은 reference를 설치 후 장애로 만들지 않습니다.
@@ -577,3 +617,19 @@ Claude Code 안에서는 다음 명령으로 plugin metadata를 다시 읽습니
 [![Ignition 모션 그래픽](./docs/assets/readme/ignition-poster.png)](./docs/assets/readme/ignition-film.mp4)
 
 [애니메이션 보기 (GIF)](./docs/assets/readme/ignition-readme.gif) · [Lucide 아이콘 라이선스 (ISC)](./docs/assets/readme/Lucide-LICENSE.txt) · [JetBrains Mono 글꼴 라이선스 (OFL)](./docs/assets/readme/JetBrainsMono-OFL.txt)
+
+
+## 디자인과 README 제작
+
+`frontend-ui-ux build <대상>`은 허용된 범위의 화면 구현과 실제 렌더 확인까지
+진행합니다. 중요한 방향이 모호하면 하나씩 질문하고 답을 보존해 구현을 이어갑니다.
+검토나 계획만 요청한 경우 파일을 수정하지 않습니다.
+
+`readme-studio <저장소 또는 README 범위>`와 `$readme-studio`는 저장소 사실을
+확인하고 표지·README를 제작하는 native skill 진입점입니다. Claude Code에 실제
+이미지 생성 도구가 없으면 `IMAGE_GENERATION_UNAVAILABLE`을 기록하며, 명시적으로
+제공된 배경으로 합성을 이어갈 수 있습니다. Pretendard/Meslo 윤곽선 글자와 로컬
+모션 템플릿을 포함하며 글꼴·렌더러 라이선스와 출력물을 확인합니다. GitHub/npm의
+실제 표시 검증은 별도 공개 이후 단계입니다. 새로운 slash command는 추가하지 않습니다.
+
+</details>

package/docs/agents.md

@@ -98,23 +98,45 @@ agreement are present.
 
 LitClaude does not own a Claude Code-native `model` or `effort` field for plugin
 agents. Its agents inherit model selection from Claude Code. LitClaude does not
-write a model route, an effort override, or host configuration.
+write an OpenAI model route, an effort override, or host configuration. Its installer
+has no model-selection probe or model/effort prompt.
 
 The approved family table remains a policy record only:
 
 | Route | Requested model | Requested effort | LitClaude result |
 | --- | --- | --- | --- |
-| lead | `gpt-5.6-sol` | `xhigh` | `BLOCKED: unsupported Claude-native route` |
-| ordinary worker | `gpt-5.6-luna` | `max` | `BLOCKED: unsupported Claude-native route` |
-| `momus` | `gpt-5.6-sol` | `xhigh` | `BLOCKED: unsupported Claude-native route` |
-| `litwork-reviewer` | `gpt-5.6-sol` | `xhigh` | `BLOCKED: unsupported Claude-native route` |
-
-The combination `gpt-5.6-luna` plus `xhigh` is forbidden. The local guard also
-rejects malformed route data, conflicting effort fields, and unknown models.
+| lead | `gpt-6-astra` | `xhigh` | `BLOCKED: unsupported Claude-native route` |
+| ordinary worker | `gpt-6-luna` | `max` | `BLOCKED: unsupported Claude-native route` |
+| `momus` | `gpt-6-astra` | `xhigh` | `BLOCKED: unsupported Claude-native route` |
+| `litwork-reviewer` | `gpt-6-astra` | `xhigh` | `BLOCKED: unsupported Claude-native route` |
+
+The previous-generation `gpt-5.6-sol` and `gpt-5.6-luna` ids remain accepted. The
+Codex/OpenAI host catalog also lists `gpt-5.6-terra`; all three GPT-5.6 ids are accepted and
+selectable there, with no retirement metadata for any of them. Across products that own OpenAI
+routing, fresh installs default to GPT-6: Astra for planning, review, and lead work; Sol as the
+coding-lead alternative; and Luna for helpers and ordinary workers. The OpenAI catalog lists both
+`gpt-6-luna` and `gpt-5.6-luna` with supported efforts `low`, `medium`, `high`, `xhigh`, and `max`,
+but not `ultra`. LitClaude's legacy policy-only guard blocks `gpt-5.6-luna` plus `xhigh`, despite
+that catalog support. Catalog support for GPT-6 Luna at `xhigh` does not change the approved
+default: the `ordinary-worker` route remains `gpt-6-luna` at `max`; an `xhigh` request for that
+route fails the route-table match. These defaults are host policy, not LitClaude routes: Claude
+Code owns model selection, and a normal LitClaude install or update leaves that selection untouched.
+
+The local guard still rejects the legacy `gpt-5.6-luna` plus `xhigh` combination, malformed route
+data, conflicting effort fields, and unknown models.
 Run `npm run check:model-routing` to verify that no model or effort fields were
 added and that every current agent permission remains unchanged. A guard pass
 means the unsupported route stayed blocked. It does not mean a route applied.
 
+### Refreshing the model catalog
+
+LitClaude has no generated OpenAI model catalog. The shared Codex host catalog cache is
+`~/.codex/models_cache.json`; run `codex debug models` to refresh and render the current catalog
+(`--bundled` renders only the bundled catalog). The repo-local policy reference is
+`tools/check-model-routing.mjs`, pinned by `node --test test/model-routing.test.mjs`. If a shipped
+`SKILL.md` containing model guidance changes, regenerate its resource map with
+`npm run gen:skill-resources`, then verify it with `npm run check:skill-resources`.
+
 ## Local Use
 
 Load the plugin from this checkout:

package/docs/assets/readme/JetBrainsMono-OFL.txt

@@ -0,0 +1,93 @@
+Copyright 2020 The JetBrains Mono Project Authors (https://github.com/JetBrains/JetBrainsMono)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://openfontlicense.org
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/docs/assets/readme/Lucide-LICENSE.txt

@@ -0,0 +1,43 @@
+ISC License
+
+Copyright (c) 2026 Lucide Icons and Contributors
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+---
+
+The following Lucide icons are derived from the Feather project:
+
+airplay, alert-circle, alert-octagon, alert-triangle, aperture, arrow-down-circle, arrow-down-left, arrow-down-right, arrow-down, arrow-left-circle, arrow-left, arrow-right-circle, arrow-right, arrow-up-circle, arrow-up-left, arrow-up-right, arrow-up, at-sign, calendar, cast, check, chevron-down, chevron-left, chevron-right, chevron-up, chevrons-down, chevrons-left, chevrons-right, chevrons-up, circle, clipboard, clock, code, columns, command, compass, corner-down-left, corner-down-right, corner-left-down, corner-left-up, corner-right-down, corner-right-up, corner-up-left, corner-up-right, crosshair, database, divide-circle, divide-square, dollar-sign, download, external-link, feather, frown, hash, headphones, help-circle, info, italic, key, layout, life-buoy, link-2, link, loader, lock, log-in, log-out, maximize, meh, minimize, minimize-2, minus-circle, minus-square, minus, monitor, moon, more-horizontal, more-vertical, move, music, navigation-2, navigation, octagon, pause-circle, percent, plus-circle, plus-square, plus, power, radio, rss, search, server, share, shopping-bag, sidebar, smartphone, smile, square, table-2, tablet, target, terminal, trash-2, trash, triangle, tv, type, upload, x-circle, x-octagon, x-square, x, zoom-in, zoom-out
+
+The MIT License (MIT) (for the icons listed above)
+
+Copyright (c) 2013-present Cole Bemis
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.