@litfamily/litclaude 1.0.21 → 1.0.22

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 1.0.22 - 2026-10-11
+
+- The README is shorter for first-time readers. It says what LitClaude does, how to install it and what to type first, and the detailed material now lives in docs pages (guide, skills, Jev, development) in English and Korean. The GitHub page also plays a short film of a real session.
+- The status line is more compact and shows the reasoning effort next to the model: `[🔥LIT v…] | O5.5 [xhigh] │ ctx … │ 5h … │ 1w …`. When the context use cannot be read, the line shows `?` where it used to show a made-up number, and long sessions now report their real usage to the status line and to automatic handoff.
+- The second status row keeps showing what you typed. After a skill loaded, it used to show the text of that skill.
+- On Claude Code 2.1.287 and later, a LIT band sits above the prompt while LitClaude work is active. It shows the phase, a progress bar, the running subagents, gate notices and a short completion moment, and `/lit-evidence` opens a pane with the goal's evidence, the subagents and the gates. The `motion`, `glyphs` and `band` settings control it. Older Claude Code releases keep the existing hooks.
+- `litclaude install --icon-font` adds the symbols-only Nerd Font to your user font folder so the band can draw its pills and icons. An interactive install asks instead, with No as the default. Uninstall removes only the font files it added and left unchanged, and doctor reports the font.
+- Automatic update now refreshes its own record of the latest version from the session, so new releases arrive without a terminal install, update or doctor run. It skips a version that is already installed and waits a day before it tries a failed version again.
+- "Turn notes.md into slides" and similar requests go to the office skills. Before, any `.md` file counted as code documentation and the request fell back to lit-loop.
+- Piped output longer than 64 KiB is no longer cut off. `--dry-run` also works after the subcommand, so `uninstall --dry-run` no longer runs a real uninstall, and unknown options are refused before anything runs.
+- LitClaude writes a `.gitignore` inside its `.litclaude` folder, so its project state stays out of Git without any change to your own `.gitignore`.
+
 ## 1.0.21 - 2026-10-09
 
 - The deck and document looks no longer list settings that nothing applied. The eight deck looks carried entries for chart annotations, image cropping and bleed, letter case, tabular figures and table style names, and the six document looks carried page-fill targets, but the build never read any of them. Those entries are gone, and the reference pages for each look no longer promise them. Decks and documents come out exactly as before.

package/README.md

@@ -1,62 +1,40 @@
-<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.21/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.21/docs/assets/cover-motion.webp" width="100%" alt="LitFamily motion cover: five armored robots power on one by one, the LitClaude robot wakes with glowing eyes and a lit frame, then LITFAMILY and KEEP THE WORK LIT. light up." /></picture></p>
+<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.22/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.22/docs/assets/cover-motion.webp" width="100%" alt="LitFamily motion cover: five armored robots power on one by one, the LitClaude robot wakes with glowing eyes and a lit frame, then LITFAMILY and KEEP THE WORK LIT. light up." /></picture></p>
 
 <h1 align="center">LitClaude</h1>
 <p align="center"><strong>Keep the work lit.</strong></p>
-<p align="center">Plan, build, and check your work in Claude Code. Leave the next session a place to begin.</p>
+<p align="center">A Claude Code plugin that helps every session plan the work, build it, check it, and leave a note the next session can pick up.</p>
 <p align="center">
-  <img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.21/docs/assets/readme/badge-version.svg" alt="1.0.21" />
-  <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.21/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.21/docs/assets/readme/badge-license.svg" alt="MIT license" /></a>
+  <img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.22/docs/assets/readme/badge-version.svg" alt="1.0.22" />
+  <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.22/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.22/docs/assets/readme/badge-license.svg" alt="MIT license" /></a>
 </p>
 <p align="center">
-  <a href="https://github.com/wjgoarxiv/litclaude#readme">Full guide and skills gallery on GitHub</a> · <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.21/README_ko-KR.md">한국어</a>
+  <a href="https://github.com/wjgoarxiv/litclaude#readme">Full guide and skills gallery on GitHub</a> · <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.22/README_ko-KR.md">한국어</a>
 </p>
 
-LitClaude is a Claude Code plugin. Add `lit` to a request and Claude pins the goal, writes a
-failing test first, checks the real surface and leaves a record in your project. The next
-session reads that record and picks up where this one stopped.
+Add `lit` to a Claude Code prompt and Claude pins the goal, writes a failing test first,
+checks the real result and leaves a record in your project. Type `handoff` when you stop, and
+the next session reads that record and picks up where this one left off.
 
 ## Install
 
 You need Node.js with npm, and Claude Code.
 
 ```bash
-npm exec --yes --package @litfamily/litclaude@latest -- litclaude install --yes
+npx @litfamily/litclaude@latest install
 ```
 
-`--yes` skips the install questions. A new install uses the `safe` permission mode, which
-adds no permission rules, and leaves your other Claude settings as they are. If you want
-Claude to ask less often, choose a wider mode yourself:
-
-```bash
-npm exec --yes --package @litfamily/litclaude@latest -- litclaude install --permission-mode balanced
-npm exec --yes --package @litfamily/litclaude@latest -- litclaude install --yolo
-```
-
-`balanced` allows limited reading and searching plus routine Git, npm and Node commands;
-`yolo` also allows broad edit and write patterns. LitClaude tracks the rules it inserted and
-removes only those.
-
-The install downloads a little more than the plugin. The video skill needs a rendering
-engine and fonts and never downloads them mid-render, so the installer fetches them up
-front: `npm ci` for the pinned engine packages, and pinned fonts checked against their
-sha256. If that download fails, the install still finishes and tells you what to run later.
-
-- To put off just the video tools, set `LITCLAUDE_MOTION_PREWARM=0` and run
-  `litclaude-ai motion-runtime install` when you need them.
-- `npm install -g @litfamily/litclaude` runs this whole setup by itself, from its
-  postinstall hook. To switch that off, set `LITCLAUDE_AUTO_INSTALL=0` (or
-  `LITCLAUDE_POSTINSTALL_SKIP=1`), or add `--ignore-scripts`; then run `litclaude install`
-  yourself when you're ready.
+On the first run npx asks whether to install the package; answer `y`. The installer registers
+the plugin, adds the LitClaude status line and asks for its colour and an optional output style.
+`install --yes` keeps the defaults, and `npx @litfamily/litclaude@latest --dry-run install` only
+prints the changes. A
+new install uses the `safe` permission mode, which adds no permission rules, and leaves your
+other Claude settings as they are. It also fetches the video skill's rendering engine and
+fonts up front. The [guide](https://github.com/wjgoarxiv/litclaude/blob/main/docs/guide.md#installation-reference)
+covers permission modes, version pins, global installs and every switch.
 
 ## First steps
 
-Start Claude Code as usual:
-
-```bash
-claude
-```
-
-Type `lit`. After the activation notice, give it something small:
+Start `claude` in a project, type `lit`, and after the activation notice give it something small:
 
 ```text
 Build a to-do list in a single HTML file with no external dependencies.
@@ -65,8 +43,6 @@ Implement add, complete, and delete. Record what you checked and the next step.
 
 Then open the file and try the three actions yourself. That is how you find out it works.
 
-## What people type
-
 | Type this | What you get |
 | --- | --- |
 | `lit`, or end any prompt with `lit` | The evidence-first work loop |
@@ -77,61 +53,27 @@ Then open the file and try the three actions yourself. That is how you find out
 | `handoff` | A continuation file for the next session |
 | `<make slides …> lit`, `<write a report …> lit` | Editable `.pptx` and `.docx` files |
 
-At the end of a session, type `handoff` and keep the file path it gives you. Next time, open
-the same project and ask Claude to read that file, check the current state and name the next
-step.
-
-Slides and reports come out as Office files you can keep editing. Before building, the skill
-works out who will read the file and picks a look for that reader, one of eight for decks and
-six for documents. The reply names the look and two others that would also fit. Decks get
-short noun-label titles on well-filled pages; documents keep a restrained, print-grade page
-and follow Korean conventions for dates, tables and captions.
-
-LitClaude ships 35 skills you start yourself, from `deep-interview` and `lit-crucible` for
-unclear briefs to `lit-diagram-drawer`, `lit-scientific-visualization`, `debugging`,
-`refactor` and `lit-commit`, plus three that run on their own: `rules`, `lsp` and
-`comment-checker`. The GitHub page shows each one with a picture.
-
-## What changes after install
-
-- Claude Code gets the LitClaude plugin: its skills, commands, agents and hooks.
-- The status line shows the LitClaude HUD: `[🔥LITCLAUDE vX.Y.Z]`, a `ctx [▎░░]` context bar
-  and a `5h [▏░] 4% ↻` rate-limit reset countdown.
-- Permission rules change only if you choose `--permission-mode balanced` or `--yolo`. An
-  output style is written only if you pick one.
-- Work bound to a goal keeps its state in the project's `.litclaude/litgoal/`. When a
-  session closes, everything stops; the next one starts when you open it.
-
-There is also an optional Jev skill hint, which can suggest a skill that fits your prompt.
-It is off by default, and turning it on sends your prompts off your machine. With `LITCLAUDE_JEV=1`
-and your own `TYPESAFE_API_KEY` set, each eligible prompt goes to TypeSafe, cut to 2,000
-characters, with home paths, e-mail addresses and token-shaped strings redacted. The rest
-of the prompt goes as written, and TypeSafe bills your account. The agent's own tools can
-read the exported key too, so give this feature a key of its own with a low spend limit.
-Read the GitHub guide before you enable it; it also shows what each state looks like on
-screen.
-
-## Safety and uninstall
-
-The hooks read only the limited event data Claude Code passes them, and your prompt text is
-something to route, never something to run. LitClaude's state in your project is gitignored
-and never part of the npm package. Update checks run automatically; to turn them off, use
-`--no-auto-update`, `LITCLAUDE_NO_AUTO_UPDATE`, `NO_UPDATE_NOTIFIER` or
-`LITCLAUDE_NO_UPDATE_CHECK`.
+The optional Jev skill hint is off by default; turning it on sends your prompts to a third
+party, TypeSafe, so read [its page](https://github.com/wjgoarxiv/litclaude/blob/main/docs/jev.md) first.
+
+## Check, update and remove
 
 ```bash
-npm exec --yes --package @litfamily/litclaude@latest -- litclaude doctor
-npm exec --yes --package @litfamily/litclaude@latest -- litclaude uninstall
+npx @litfamily/litclaude@latest doctor
+npx @litfamily/litclaude@latest update
+npx @litfamily/litclaude@latest uninstall
 ```
 
-`uninstall` removes only the plugin, HUD, permission and local state entries that LitClaude
-manages, and leaves the rest of your Claude settings in place. If an installation was
-changed by hand or doesn't look like one LitClaude made, it refuses to touch it.
+LitClaude keeps project state in `.litclaude/`, which carries its own `.gitignore` so Git skips
+it, and that state never goes into the npm package. `uninstall` removes only the entries
+LitClaude manages and refuses to touch an install that was changed by hand. A plugin added
+through the Claude Code marketplace instead has no status line and is updated or removed from
+the `/plugin` menu.
 
 ## More
 
 - [Full guide and skills gallery on GitHub](https://github.com/wjgoarxiv/litclaude#readme)
-- [Privacy and network behavior](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.21/docs/privacy.md)
-- [Migration and ownership conflicts](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.21/docs/migration.md)
-- [Release history](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.21/CHANGELOG.md)
-- [MIT license](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.21/LICENSE)
+- [Privacy and network behavior](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.22/docs/privacy.md)
+- [Migration and ownership conflicts](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.22/docs/migration.md)
+- [Release history](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.22/CHANGELOG.md)
+- [MIT license](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.22/LICENSE)

package/README_ko-KR.md

@@ -1,130 +1,77 @@
-<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.21/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.21/docs/assets/cover-motion.webp" width="100%" alt="LitFamily 모션 커버: 다섯 로봇 패널이 차례로 켜지고, LitClaude 로봇의 눈과 테두리가 빛난 뒤 LITFAMILY와 KEEP THE WORK LIT. 문구가 밝아지는 영상" /></picture></p>
+<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.22/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.22/docs/assets/cover-motion.webp" width="100%" alt="LitFamily 모션 커버: 다섯 로봇 패널이 차례로 켜지고, LitClaude 로봇의 눈과 테두리가 빛난 뒤 LITFAMILY와 KEEP THE WORK LIT. 문구가 밝아지는 영상" /></picture></p>
 
 <h1 align="center">LitClaude</h1>
 <p align="center"><strong>Keep the work lit.</strong></p>
-<p align="center">Claude Code에서 계획하고, 만들고, 확인한 일을 다음 세션으로 이어가세요.</p>
+<p align="center">Claude Code에서 세션마다 계획하고, 만들고, 확인한 뒤 다음 세션이 이어받을 기록을 남기게 돕는 플러그인입니다.</p>
 <p align="center">
-  <img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.21/docs/assets/readme/badge-version.svg" alt="1.0.21" />
-  <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.21/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.21/docs/assets/readme/badge-license.svg" alt="MIT license" /></a>
+  <img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.22/docs/assets/readme/badge-version.svg" alt="1.0.22" />
+  <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.22/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.22/docs/assets/readme/badge-license.svg" alt="MIT license" /></a>
 </p>
 <p align="center">
-  <a href="https://github.com/wjgoarxiv/litclaude/blob/main/README_ko-KR.md">전체 안내와 스킬 갤러리는 GitHub에서</a> · <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.21/README.md">English</a>
+  <a href="https://github.com/wjgoarxiv/litclaude/blob/main/README_ko-KR.md">전체 안내와 스킬 갤러리는 GitHub에서</a> · <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.22/README.md">English</a>
 </p>
 
-LitClaude는 Claude Code 플러그인입니다. 요청 끝에 `lit`을 붙이면 Claude가 목표를 먼저
-고정하고, 실패하는 테스트부터 쓰고, 실제 화면에서 확인한 뒤 프로젝트에 기록을 남깁니다.
-다음 세션은 그 기록을 읽고 멈춘 자리에서 이어갑니다.
+Claude Code 프롬프트에 `lit`을 붙이면 Claude가 목표를 고정하고, 실패하는 테스트를 먼저 쓰고,
+실제 결과를 확인한 뒤 프로젝트에 기록을 남깁니다. 작업을 멈출 때 `handoff`를 입력하면 다음
+세션이 그 기록을 읽고 이어갑니다.
 
 ## 설치
 
 Node.js와 npm, 그리고 Claude Code가 있으면 됩니다.
 
 ```bash
-npm exec --yes --package @litfamily/litclaude@latest -- litclaude install --yes
+npx @litfamily/litclaude@latest install
 ```
 
-`--yes`는 설치 질문을 건너뜁니다. 새로 설치하면 권한 규칙을 하나도 더하지 않는 `safe`
-권한 모드가 적용되고, 다른 Claude 설정은 그대로 둡니다. Claude가 덜 자주 묻게 하고 싶다면
-더 넓은 모드를 직접 고르세요.
-
-```bash
-npm exec --yes --package @litfamily/litclaude@latest -- litclaude install --permission-mode balanced
-npm exec --yes --package @litfamily/litclaude@latest -- litclaude install --yolo
-```
-
-`balanced`는 제한된 읽기·검색과 일상적인 Git, npm, Node 명령을 허용하고, `yolo`는 넓은
-편집·쓰기 패턴까지 허용합니다. LitClaude는 자신이 넣은 규칙만 기억해 두었다가 그것만 지웁니다.
-
-설치할 때는 플러그인 말고도 조금 더 내려받습니다. 영상 만들기 스킬에는 렌더링 엔진과 글꼴이
-필요한데, 영상을 만드는 도중에는 이것을 내려받지 않기 때문에 미리 받아 둡니다. 버전을 고정한 엔진
-패키지를 `npm ci`로 설치하고, 고정된 글꼴을 내려받아 sha256으로 확인합니다. 이 준비가 실패해도
-설치는 끝나고, 나중에 실행할 명령을 알려 줍니다.
-
-- 영상 도구만 나중으로 미루려면 `LITCLAUDE_MOTION_PREWARM=0`을 설정하세요. 필요해지면
-  `litclaude-ai motion-runtime install`로 받으면 됩니다.
-- `npm install -g @litfamily/litclaude`로 전역 설치하면 설치 뒤에 도는 스크립트가 이 설정을
-  자동으로 실행합니다. 이것까지 끄려면 `LITCLAUDE_AUTO_INSTALL=0`(또는
-  `LITCLAUDE_POSTINSTALL_SKIP=1`)을 설정하거나 `--ignore-scripts`를 붙이고, 준비가 되면
-  `litclaude install`을 직접 실행하세요.
+처음 실행하면 npx가 패키지를 설치할지 묻는데, `y`로 답하면 됩니다. 설치 프로그램은 플러그인을
+등록하고 LitClaude 상태 줄을 붙인 뒤, 상태 줄 색상과 쓰고 싶은 출력 스타일을 묻습니다.
+`install --yes`는 기본값으로 진행하고, `npx @litfamily/litclaude@latest --dry-run install`은 바뀔
+내용만 보여 줍니다. 새로
+설치하면 권한 규칙을 더하지 않는 `safe` 권한 모드로 시작하고 나머지 Claude 설정은 그대로 둡니다.
+영상 스킬에 필요한 렌더링 엔진과 글꼴도 미리 받아 둡니다. 권한 모드, 버전 고정, 전역 설치와 모든
+스위치는 [안내서](https://github.com/wjgoarxiv/litclaude/blob/main/docs/guide_ko-KR.md#설치-상세)에 있습니다.
 
 ## 처음 해 볼 일
 
-평소처럼 Claude Code를 실행합니다.
-
-```bash
-claude
-```
-
-`lit`을 입력하고, 활성화 안내가 나오면 작은 작업 하나를 맡겨 보세요.
+프로젝트에서 `claude`를 실행하고 `lit`을 입력한 뒤, 활성화 안내가 나오면 작은 작업을 맡겨 보세요.
 
 ```text
 외부 의존성 없이 HTML 파일 하나로 할 일 목록을 만들어줘.
 추가·완료·삭제 동작을 구현하고, 확인한 내용과 다음 행동을 남겨줘.
 ```
 
-끝나면 파일을 직접 열어 세 동작을 눌러 보세요. 제대로 작동하는지는 그렇게 해 봐야 압니다.
+끝나면 파일을 열어 세 동작을 직접 눌러 보세요. 제대로 작동하는지는 그렇게 확인합니다.
 
-## 자주 쓰는 입력
-
-| 입력 | 얻는 것 |
+| 이렇게 입력하면 | 이런 결과가 나옵니다 |
 | --- | --- |
-| `lit`, 또는 프롬프트 끝에 `lit` | 근거 중심 작업 루프 |
-| `lit plan <what>` | 파일을 고치기 전에 세우는 계획과 확인 기준 |
-| `/litclaude:start-work <승인된 계획>` | 승인한 계획의 실행 |
-| `lit review <scope>` | 확인한 점과 남은 일 |
-| `lit research <question>` | 출처를 밝힌 public-source 조사 |
-| `handoff` | 다음 세션에 건넬 파일 |
-| `<발표자료 만들어줘 …> lit`, `<보고서 써줘 …> lit` | 바로 고칠 수 있는 `.pptx`, `.docx` 파일 |
-
-세션을 마칠 때 `handoff`를 입력하고, 알려 준 파일 경로를 챙겨 두세요. 다음에 같은 프로젝트를
-열어 그 파일을 읽고 현재 상태와 다음 할 일을 확인해 달라고 하면 됩니다.
-
-발표자료와 보고서는 계속 고칠 수 있는 Office 파일로 나옵니다. 만들기 전에 누가 읽을 파일인지
-따져 그 독자에게 맞는 모양을 고르는데, 발표자료는 여덟 가지, 문서는 여섯 가지 가운데서 고릅니다.
-답에서는 고른 모양과 함께 어울릴 다른 두 가지를 알려 줍니다. 발표자료는 짧은 명사형 제목과 꽉
-찬 페이지로, 문서는 인쇄물처럼 절제된 지면으로 만들고 날짜·표·캡션은 한국 문서 관례를 따릅니다.
-
-LitClaude에는 직접 부르는 스킬 35개가 들어 있습니다. 모호한 요청을 다듬는 `deep-interview`와
-`lit-crucible`부터 `lit-diagram-drawer`, `lit-scientific-visualization`, `debugging`,
-`refactor`, `lit-commit`까지 있고, 따로 부르지 않아도 도는 `rules`, `lsp`, `comment-checker`
-세 개가 더 있습니다. GitHub 페이지에서 스킬마다 그림을 붙여 보여 줍니다.
-
-## 설치 후 달라지는 것
-
-- Claude Code에 LitClaude 플러그인이 들어옵니다. 스킬, 명령, 에이전트, hook이 함께 들어옵니다.
-- 상태 줄에 LitClaude HUD가 나타납니다. `[🔥LITCLAUDE vX.Y.Z]`, `ctx [▎░░]` 컨텍스트 막대,
-  `5h [▏░] 4% ↻` 사용 한도 리셋 카운트다운을 보여 줍니다.
-- 권한 규칙은 `--permission-mode balanced`나 `--yolo`를 고를 때만 바뀝니다. 출력 스타일도
-  직접 고를 때만 기록합니다.
-- 목표를 연결한 작업은 프로젝트의 `.litclaude/litgoal/`에 상태를 남깁니다. 세션을 닫으면 모든
-  것이 멈추고, 다음 세션은 직접 열어야 이어집니다.
-
-프롬프트에 맞는 스킬을 추천해 주는 Jev 스킬 힌트도 있습니다. 선택 기능이라 기본으로 꺼져 있고,
-켜면 프롬프트가 컴퓨터 밖으로 나갑니다. `LITCLAUDE_JEV=1`과 본인의 `TYPESAFE_API_KEY`를
-설정하면, 해당하는 프롬프트를 2,000자로 자르고 홈 경로, 이메일 주소, 토큰 모양의 문자열을 가린
-뒤 TypeSafe로 보냅니다. 나머지는 적힌 그대로 가고, 비용은 본인의 TypeSafe 계정에 청구됩니다.
-셸에 넣어 둔 키는 에이전트의 도구도 읽을 수 있으니, 이 기능 전용 키를 만들고 사용 한도를 낮게
-잡아 두세요. 켜기 전에 GitHub 안내를 먼저 읽어 주세요. 각 상태가 화면에 어떻게 보이는지도 그 안내에 있습니다.
-
-## 안전과 제거
-
-hook은 Claude Code가 넘겨 주는 제한된 이벤트 데이터만 읽고, 입력한 프롬프트는 작업 흐름을 고르는
-데 쓸 뿐 명령으로 실행하지 않습니다. 프로젝트 안에 생기는 LitClaude 상태는 gitignore되며 npm 패키지에
-들어가지 않습니다. 업데이트는 자동으로 확인하는데, 끄고 싶다면 `--no-auto-update`,
-`LITCLAUDE_NO_AUTO_UPDATE`, `NO_UPDATE_NOTIFIER`, `LITCLAUDE_NO_UPDATE_CHECK` 중 하나를 쓰세요.
+| `lit`, 또는 프롬프트 끝에 `lit` | 근거를 남기며 일하는 작업 루프 |
+| `lit plan <내용>` | 아무것도 고치기 전에 세우는 계획과 확인 항목 |
+| `/litclaude:start-work <승인한 계획>` | 승인한 계획의 실행 |
+| `lit review <범위>` | 찾은 문제와 남은 일 |
+| `lit research <질문>` | 출처를 밝힌 공개 자료 조사 |
+| `handoff` | 다음 세션을 위한 이어가기 파일 |
+| `<발표자료 만들어줘 …> lit`, `<보고서 써줘 …> lit` | 편집할 수 있는 `.pptx`, `.docx` 파일 |
+
+선택 기능인 Jev 스킬 힌트는 기본으로 꺼져 있습니다. 켜면 프롬프트가 외부 서비스 TypeSafe로
+전송되니 [설명 페이지](https://github.com/wjgoarxiv/litclaude/blob/main/docs/jev_ko-KR.md)를 먼저 읽어 주세요.
+
+## 확인, 업데이트, 제거
 
 ```bash
-npm exec --yes --package @litfamily/litclaude@latest -- litclaude doctor
-npm exec --yes --package @litfamily/litclaude@latest -- litclaude uninstall
+npx @litfamily/litclaude@latest doctor
+npx @litfamily/litclaude@latest update
+npx @litfamily/litclaude@latest uninstall
 ```
 
-`uninstall`은 LitClaude가 관리하는 플러그인, HUD, 권한, 로컬 상태 항목만 지우고 나머지 Claude
-설정은 그대로 둡니다. 누가 손을 댔거나 LitClaude가 만든 것으로 알아볼 수 없는 설치는 거절합니다.
+LitClaude는 프로젝트 상태를 `.litclaude/`에 두고, 그 안의 `.gitignore`로 Git이 이 폴더를 건너뛰게
+합니다. 이 상태는 npm 패키지에 들어가지 않습니다. `uninstall`은 LitClaude가 관리하는 항목만 지우고,
+누가 손댄 설치는 건드리지 않습니다. Claude Code 마켓플레이스로 추가한 플러그인에는 상태 줄이 없고,
+업데이트와 제거는 `/plugin` 메뉴에서 합니다.
 
 ## 더 보기
 
 - [전체 안내와 스킬 갤러리 (GitHub)](https://github.com/wjgoarxiv/litclaude/blob/main/README_ko-KR.md)
-- [개인정보와 네트워크](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.21/docs/privacy.md)
-- [이전 안내와 소유권 충돌](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.21/docs/migration.md)
-- [Release history](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.21/CHANGELOG.md)
-- [MIT 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.21/LICENSE)
+- [개인정보와 네트워크 동작](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.22/docs/privacy.md)
+- [이전과 소유권 충돌](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.22/docs/migration.md)
+- [변경 이력](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.22/CHANGELOG.md)
+- [MIT 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.22/LICENSE)