@litfamily/litclaude 1.0.13 → 1.0.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (17) hide show
  1. package/CHANGELOG.md +14 -0
  2. package/README.md +88 -985
  3. package/README_ko-KR.md +83 -977
  4. package/bin/install-ownership.mjs +2 -0
  5. package/docs/assets/readme/badge-version.svg +1 -1
  6. package/docs/hooks.md +10 -7
  7. package/docs/privacy.md +2 -2
  8. package/package.json +4 -1
  9. package/plugins/litclaude/.claude-plugin/plugin.json +1 -1
  10. package/plugins/litclaude/bin/litclaude-hud.js +22 -10
  11. package/plugins/litclaude/bin/litclaude-mcp.js +1 -1
  12. package/plugins/litclaude/lib/canonical-skill-resources.mjs +3 -3
  13. package/plugins/litclaude/lib/hud-accent-palette.mjs +16 -4
  14. package/plugins/litclaude/lib/jev-skill-hint.mjs +25 -7
  15. package/plugins/litclaude/lib/office-runtime.mjs +14 -0
  16. package/plugins/litclaude/lib/secret-shapes.mjs +5 -1
  17. package/plugins/litclaude/skills/lit-typographic-motion/engine/node/runtime.mjs +17 -4
package/README_ko-KR.md CHANGED
@@ -1,1019 +1,125 @@
1
- <p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/cover-motion.webp" width="100%" alt="LitFamily 모션 커버: 다섯 로봇 패널이 차례로 켜지고, LitClaude 로봇의 눈과 테두리가 빛난 뒤 LITFAMILY와 KEEP THE WORK LIT. 문구가 밝아지는 영상" /></picture></p>
1
+ <p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.15/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.15/docs/assets/cover-motion.webp" width="100%" alt="LitFamily 모션 커버: 다섯 로봇 패널이 차례로 켜지고, LitClaude 로봇의 눈과 테두리가 빛난 뒤 LITFAMILY와 KEEP THE WORK LIT. 문구가 밝아지는 영상" /></picture></p>
2
2
 
3
3
  <h1 align="center">LitClaude</h1>
4
4
  <p align="center"><strong>Keep the work lit.</strong></p>
5
5
  <p align="center">Claude Code에서 계획하고, 만들고, 확인한 일을 다음 세션으로 이어가세요.</p>
6
6
  <p align="center">
7
- <a href="#설치">설치</a> · <a href="#빠른-시작">빠른 시작</a> · <a href="#주요-라우트">주요 경로</a> · <a href="#스킬-한눈에-보기">스킬</a> · <a href="#링크">링크</a> · <a href="./README.md">English</a>
7
+ <img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.15/docs/assets/readme/badge-version.svg" alt="1.0.15" />
8
+ <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.15/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.15/docs/assets/readme/badge-license.svg" alt="MIT license" /></a>
8
9
  </p>
9
-
10
- <p align="center"><img src="./docs/assets/readme/ascii-readme.svg" width="480" alt="LIT ASCII B mark" /></p>
11
-
12
- <details>
13
- <summary>ASCII 로고 복사</summary>
14
-
15
- ```text
16
- ▄▄▄▄
17
- ▗███▌ ▗██████▖
18
- ▗▄▄▄▄▄ ▗▟████▌ ▝██████▘
19
- ▐█████ ▗▟██████▌ ▝▀▜█▀▘
20
- ▐█████ ▗▟███████▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
21
- ▐█████ ▗▟█████████████████████████ ▐█▀
22
- ▐█████ ████████████████████████████▀
23
- ▐█████ ██▛▘ ▄ ▄▄▄▄▖▄▄▄▄▄▄▄▄▄▄▄▄▄▖
24
- ▐█████ ▀ ▄██ ████▌█████████████▌
25
- ▐█████ ▄████ ████▌█████████████▌
26
- ▐█████ ▄█████▛ claude
27
- ▐█████ ▗▟█████▀▘ ▄▄▄▄▄ ▗▖ ──────────────
28
- ▐█████ ▐█████▀ █████ ▐▛▀ hermes · codex
29
- ▐█████ ▐███▀ █████ opencode · grok
30
- ▐█████ ▐█▀ █████
31
- ▐█████ ▝ █████
32
- ▐█████▄▄▄▄▄▄▄▖ █████
33
- ▐███████████▛ █████
34
- ▐██████████▀ █████
35
-
36
- ```
37
-
38
- </details>
39
-
40
- <p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/litclaude-wordmark.svg" width="480" alt="LITCLAUDE 디스플레이 타입" /></p>
41
- <p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/litclaude-clay-icon.png" width="160" alt="LitClaude 클레이 마크" /></p>
42
-
43
10
  <p align="center">
44
- <img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/readme/badge-version.svg" alt="1.0.13" />
45
- <a href="./LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/readme/badge-license.svg" alt="MIT license" /></a>
11
+ <a href="https://github.com/wjgoarxiv/litclaude/blob/main/README_ko-KR.md">전체 안내, 스킬 갤러리, A/B 결과는 GitHub에서</a> · <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.15/README.md">English</a>
46
12
  </p>
47
13
 
48
- <p align="center">
49
- <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>
50
- </p>
14
+ LitClaude는 Claude Code 플러그인입니다. 요청 끝에 `lit`을 붙이면 Claude가 목표를 먼저
15
+ 고정하고, 실패하는 테스트부터 쓰고, 실제 화면에서 확인한 뒤 프로젝트에 기록을 남깁니다.
16
+ 다음 세션은 그 기록을 읽고 멈춘 자리에서 이어갑니다.
51
17
 
52
18
  ## 설치
53
19
 
54
- `@litfamily/litclaude`는 scoped package입니다. Node.js/npm과 Claude Code가 필요합니다.
55
- 로컬 검증을 할 때는 먼저
56
- [별도 체험 프로필](./docs/migration.md#separate-trial-profile)을 준비하세요.
57
-
58
- 다음은 기본 safe 권한 모드에서 사용할 명령입니다.
20
+ Node.js와 npm, 그리고 Claude Code가 있으면 됩니다.
59
21
 
60
22
  ```bash
61
23
  npm exec --yes --package @litfamily/litclaude@latest -- litclaude install --yes
62
24
  ```
63
25
 
64
- `--yes`는 설치 질문을 건너뜁니다. 다른 Claude 설정은 보존하며,
65
- 권한·HUD 색상·출력 스타일은 필요할 때 명시적으로 선택합니다.
66
- [설치 상세](#설치-상세)에서 옵션과 버전 고정 방법을 확인하세요.
67
-
68
- ## 빠른 시작
69
-
70
- Claude Code를 실행합니다.
26
+ `--yes`는 설치 질문을 건너뜁니다. 새로 설치하면 권한 규칙을 하나도 더하지 않는 `safe`
27
+ 권한 모드가 적용되고, 다른 Claude 설정은 그대로 둡니다. Claude가 덜 자주 묻게 하고 싶다면
28
+ 더 넓은 모드를 직접 고르세요.
71
29
 
72
30
  ```bash
73
- claude
74
- ```
75
-
76
- Claude Code 안에서 다음을 입력합니다.
77
-
78
- ```text
79
- lit
80
- ```
81
-
82
- 활성화 안내가 나온 뒤 작은 작업 하나를 맡겨보세요.
83
-
84
- ```text
85
- 외부 의존성 없이 HTML 파일 하나로 할 일 목록을 만들어줘.
86
- 추가·완료·삭제 동작을 구현하고, 확인한 내용과 다음 행동을 남겨줘.
31
+ npm exec --yes --package @litfamily/litclaude@latest -- litclaude install --permission-mode balanced
32
+ npm exec --yes --package @litfamily/litclaude@latest -- litclaude install --yolo
87
33
  ```
88
34
 
89
- 생성된 HTML을 직접 열어 세 동작을 확인하세요. 파일을 만들었다고 동작까지 확인한 것은
90
- 아닙니다. 브라우저를 사용할 수 없다면 화면과 상호작용은 미확인으로 남겨달라고 하세요.
91
- 로고는 활성화 표시이며 작업 완료를 뜻하지 않습니다.
92
-
93
- 다음 작업에는 아래 주요 route를 사용하세요. Bare prompt route는 hook이 처리하고,
94
- namespaced slash command는 Claude Code native command surface에서 처리되므로
95
- hook을 중복 활성화하지 않습니다. 명시적으로 skill을 실행하려면
96
- `/litclaude:lit-loop` 같은 route를 사용하세요.
97
-
98
- ## 주요 기능
99
-
100
- 불씨를 건네받았다. 이제, 당신의 작업에 옮길 차례다.
101
-
102
- 고치고 싶은 버그 하나. 만들고 싶은 화면 하나. 끝내고 싶은 프로젝트 하나.
103
-
104
- 시작은 짧은 한 줄이면 됩니다. 어려운 건 그다음입니다. 대화가 길어지고 세션이 바뀌면,
105
- 어디까지 했는지부터 다시 짚어야 합니다. 어떤 결정을 내렸는지, 무엇을 확인했는지,
106
- 다음에는 무엇을 해야 하는지.
107
-
108
- **LIT은 그 불씨를 남깁니다.** 목표와 계획, 확인한 결과, 다음에 할 일을 프로젝트에
109
- 기록합니다. 다음 세션에서 그 기록을 읽고 작업을 이어갈 수 있도록.
110
-
111
- **대화가 끝난 자리에서, 다음 작업이 시작되도록.**
112
-
113
- LitClaude는 Claude Code에 증거 기반 실행, 계획, 조사, 검토 흐름을 더합니다.
114
- 플러그인과 HUD를 한 번 설치하면 일반 `claude` 세션에서 사용할 수 있습니다.
115
-
116
- ## A/B 결과
117
-
118
- 프롬프트는 한 줄짜리 한국어 요청을 입력한 그대로 씁니다. LitClaude 쪽은 같은 줄 끝에 ` lit`만 붙였고, 다른 것은 더하지 않았습니다. 두 쪽 모두 2026-09-26에 Claude Code 2.1.283, Opus 5.5(`opus[1m]`), effort high로 쪽마다 한 번씩 돌렸습니다. 기준 쪽은 LitClaude 없는 Claude Code이고, LitClaude 쪽은 배포 전 로컬 빌드를 썼습니다.
119
-
120
- 블라인드 판정은 LitClaude 없는 Claude Opus 5.5가 맡았습니다. 두 결과를 A와 B로만 보았고, 도구 이름이 드러나는 단어는 지운 상태였습니다. 순서를 바꿔 두 번 물었고, 두 번이 같을 때만 승부로 셉니다. 그다음 메인테이너가 두 결과를 나란히 놓고 보고 최종 판정을 내렸습니다. 메인테이너가 보지 않은 과제는 블라인드 판정을 그대로 따르고, 표에 그렇게 적었습니다.
121
-
122
- S3와 S4는 인터페이스 개선 뒤 다시 돌린 UI 회차 결과이고, 이 회차에서 S11을 더했습니다. S5는 `lit-pptx`, `lit-docx`로 다시 돌린 오피스 회차 결과이고, 이 회차에서 S8과 S9를 더했습니다. 일부 과제는 LitClaude를 고친 뒤 LitClaude 쪽만 다시 돌렸고, 판정 이유를 그대로 옮긴 수정 위에서 돈 실행은 뺐습니다. 표의 각 줄은 남긴 LitClaude 실행 중 가장 최근 것과 한 번 돌린 기준 쪽을 비교합니다.
123
-
124
- | 과제 | 프롬프트 | 최종 판정 | 블라인드 판정(같은 회차) |
125
- | --- | --- | --- | --- |
126
- | S1 · 터미널 할 일 CLI | `터미널에서 쓰는 할 일 관리 CLI 만들어줘` | LitClaude 승 | 무승부 |
127
- | S2 · API 서버 버그 | `이 API 서버 가끔 이상하게 동작하는데 고쳐줘` | LitClaude 승 (블라인드 판정, 직접 보지 않음) | LitClaude 승 |
128
- | S3 · 개인 가계부 대시보드 (UI 회차) | `개인 가계부 대시보드 웹페이지 만들어줘` | LitClaude 승 | 기준 쪽 승 |
129
- | S4 · 동네 카페 랜딩페이지 (UI 회차) | `동네 카페 브랜드 랜딩페이지 만들어줘` | LitClaude 승 | LitClaude 승 |
130
- | S5 · 자료로 보고서와 발표자료 (오피스 회차) | `sources 폴더 자료로 보고서랑 발표자료 만들어줘` | LitClaude 승 | 기준 쪽 승 |
131
- | S6 · Node 22→24 조사 | `Node 22에서 24로 올릴 때 달라지는 거 조사해줘` | LitClaude 승 | 무승부 |
132
- | S7 · 주문·결제·배송 구조도 | `주문-결제-배송 서비스 구조도 그려줘` | LitClaude 승 (블라인드 판정, 직접 보지 않음) | LitClaude 승 |
133
- | S8 · 분기 실적 발표자료 (오피스 회차) | `분기 실적 발표자료 만들어줘` | LitClaude 승 | 기준 쪽 승 |
134
- | S9 · 신제품 기획서 (오피스 회차) | `신제품 기획서 써줘` | LitClaude 승 | LitClaude 승 |
135
- | S11 · 회의실 예약 웹앱 (UI 회차) | `회의실 예약 웹앱 만들어줘` | LitClaude 승 | LitClaude 승 |
136
- | 합계 | | LitClaude 10승 | LitClaude 5승 2무 3패 |
137
-
138
- 모션 스킬 `lit-typographic-motion`은 첫 A/B 뒤에 다시 만들었고, 아직 A/B 결과가 없습니다. 이 페이지 맨 위의 커버가 이 스킬로 만든 영상입니다.
139
-
140
- ### S1 · 터미널 할 일 CLI
141
-
142
- 기준 쪽은 마감일, 태그, 필터, 통계까지 기능을 더 넣었지만 테스트는 쓰지 않았습니다. LitClaude는 우선순위만 두는 대신 통과하는 테스트 12개와 pip로 설치되는 패키지를 냈습니다. 블라인드 판정은 무승부였고, 메인테이너는 자체 테스트까지 통과했다는 점을 들어 LitClaude 승으로 판정했습니다.
143
-
144
- ### S2 · API 서버 버그
145
-
146
- LitClaude는 숨은 버그 6개를 모두 고쳤고(기준 쪽은 5개), 고친 곳마다 회귀 테스트를 붙였으며, 심볼릭 링크 경로에서 서버가 뜨지 않는 문제와 README의 잘못된 실행 명령도 고쳤습니다. 기준 쪽은 테스트를 더하지 않았습니다. 메인테이너가 보지 않은 과제라 블라인드 판정을 그대로 따릅니다.
147
-
148
- ### S3 · 개인 가계부 대시보드
149
-
150
- 블라인드 판정은 기준 쪽을 골랐습니다. 6개월 막대, 누적 지출 차트, 큰 지출 TOP 5까지 갖춘 대시보드가 균형 잡힌 격자에 놓였고, LitClaude는 긴 거래 목록 옆에 빈 열을 남겼다는 이유입니다. LitClaude는 모든 조작을 실제 브라우저에서 해 보고 320~1440px, 다크 모드, 200% 확대를 확인했으며, 자동 검사 결과는 접근성 위반 6건 대 730건, 잘린 글자 51 대 30으로 엇갈렸습니다. 메인테이너는 두 화면을 보고 LitClaude를 골랐습니다.
151
-
152
- | 기준 쪽 | LitClaude |
153
- | --- | --- |
154
- | <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S3-baseline-desktop.webp"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S3-baseline-desktop.webp" alt="기준 쪽 가계부 대시보드, 데스크톱: 잔액, 월별 막대 차트, 카테고리별 예산" width="400" /></a> | <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S3-litclaude-desktop.webp"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S3-litclaude-desktop.webp" alt="LitClaude 가계부 대시보드, 데스크톱: 픽셀 돼지 저금통, 잔액, 거래 입력 폼, 분류별 예산" width="400" /></a> |
155
-
156
- <details>
157
- <summary>휴대폰 화면</summary>
158
-
159
- | 기준 쪽 | LitClaude |
160
- | --- | --- |
161
- | <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S3-baseline-phone.webp"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S3-baseline-phone.webp" alt="기준 쪽 가계부 대시보드, 휴대폰" width="180" /></a> | <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S3-litclaude-phone.webp"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S3-litclaude-phone.webp" alt="LitClaude 가계부 대시보드, 휴대폰" width="180" /></a> |
162
-
163
- </details>
164
-
165
- ### S4 · 동네 카페 랜딩페이지
166
-
167
- LitClaude의 페이지는 직접 그린 픽셀 아트와 다크 모드를 갖춘 절제된 디자인이고, 답에 영업시간 계산, 키보드 탭 이동, 네 가지 화면 폭, 다크 모드를 확인했다고 적었습니다. 기준 쪽은 이모지, 지어낸 별점 후기, 흐르는 띠 배너에 기대고, 전체 페이지 캡처에서 배너 아래 구역이 비어 보입니다. 블라인드 판정과 메인테이너 모두 LitClaude를 골랐습니다.
168
-
169
- | 기준 쪽 | LitClaude |
170
- | --- | --- |
171
- | <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S4-baseline-desktop.webp"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S4-baseline-desktop.webp" alt="기준 쪽 카페 랜딩페이지, 데스크톱: 제목과 그려 넣은 커피잔" width="400" /></a> | <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S4-litclaude-desktop.webp"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S4-litclaude-desktop.webp" alt="LitClaude 카페 랜딩페이지, 데스크톱: 제목과 픽셀 아트 가게 그림" width="400" /></a> |
172
-
173
- <details>
174
- <summary>휴대폰 화면</summary>
175
-
176
- | 기준 쪽 | LitClaude |
177
- | --- | --- |
178
- | <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S4-baseline-phone.webp"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S4-baseline-phone.webp" alt="기준 쪽 카페 랜딩페이지, 휴대폰" width="180" /></a> | <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S4-litclaude-phone.webp"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S4-litclaude-phone.webp" alt="LitClaude 카페 랜딩페이지, 휴대폰" width="180" /></a> |
179
-
180
- </details>
35
+ `balanced`는 제한된 읽기·검색과 일상적인 Git, npm, Node 명령을 허용하고, `yolo`는 넓은
36
+ 편집·쓰기 패턴까지 허용합니다. LitClaude는 자신이 넣은 규칙만 기억해 두었다가 그것만 지웁니다.
181
37
 
182
- ### S5 · 자료로 보고서와 발표자료
38
+ 설치할 때는 플러그인 말고도 조금 더 내려받습니다. 영상 만들기 스킬에는 렌더링 엔진과 글꼴이
39
+ 필요한데, 영상을 만드는 도중에는 이것을 내려받지 않기 때문에 미리 받아 둡니다. 버전을 고정한 엔진
40
+ 패키지를 `npm ci`로 설치하고, 고정된 글꼴을 내려받아 sha256으로 확인합니다. 이 준비가 실패해도
41
+ 설치는 끝나고, 나중에 실행할 명령을 알려 줍니다.
183
42
 
184
- 블라인드 판정은 기준 쪽을 골랐습니다. 기준 쪽은 월요일·주말 운영 공백, 자료마다 다른 집계 기준일 같은 자체 분석을 분석이라고 밝혀 더했고 11장 발표자료도 절제돼 있는 반면, LitClaude의 9장 발표자료에는 장식용 그라데이션 원, 번호 배지, 마지막 감사 슬라이드가 들어갔다는 이유입니다. 두 쪽 모두 사실은 정확했고 검사를 거쳤으며, LitClaude의 발표자료와 A4 5쪽 Word 보고서는 한 데이터 파일에서 숫자를 읽고, 발표자료는 예산 집행을 도넛 차트로 보여줍니다. 메인테이너는 실무에 쓰기에는 LitClaude 쪽 파일이 훨씬 낫다고 판정했습니다.
43
+ - 영상 도구만 나중으로 미루려면 `LITCLAUDE_MOTION_PREWARM=0`을 설정하세요. 필요해지면
44
+ `litclaude-ai motion-runtime install`로 받으면 됩니다.
45
+ - `npm install -g @litfamily/litclaude`로 전역 설치하면 설치 뒤에 도는 스크립트가 이 설정을
46
+ 자동으로 실행합니다. 이것까지 끄려면 `LITCLAUDE_AUTO_INSTALL=0`(또는
47
+ `LITCLAUDE_POSTINSTALL_SKIP=1`)을 설정하거나 `--ignore-scripts`를 붙이고, 준비가 되면
48
+ `litclaude install`을 직접 실행하세요.
185
49
 
186
- 기준 쪽 슬라이드:
50
+ ## 처음 해 볼 일
187
51
 
188
- <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S5-baseline-slides.webp"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S5-baseline-slides.webp" alt="기준 쪽 발표자료 앞 5장: 표지, 요약 카드, 사업 개요 표, 방문·탑승 건수, 현장 운영" width="100%" /></a>
52
+ 평소처럼 Claude Code를 실행합니다.
189
53
 
190
- LitClaude 슬라이드:
191
-
192
- <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S5-litclaude-slides.webp"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S5-litclaude-slides.webp" alt="LitClaude 발표자료 앞 5장: 표지, 핵심 지표 카드, 핵심 수치, 단위 해석 표, 관찰값 카드" width="100%" /></a>
193
-
194
- <details>
195
- <summary>보고서 페이지</summary>
196
-
197
- 기준 쪽:
198
-
199
- <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S5-baseline-pages.webp"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S5-baseline-pages.webp" alt="기준 쪽 Word 보고서 앞 3쪽" width="100%" /></a>
200
-
201
- LitClaude:
202
-
203
- <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S5-litclaude-pages.webp"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S5-litclaude-pages.webp" alt="LitClaude Word 보고서 앞 3쪽" width="100%" /></a>
204
-
205
- </details>
206
-
207
- ### S6 · Node 22→24 조사
208
-
209
- LitClaude는 SlowBuffer를 런타임 지원 중단으로 맞게 적었고(기준 쪽은 제거됐다고 적음), Node 24.11.0의 `Buffer.allocUnsafe` 문제, 빌드 도구 요구사항, 전체 LTS 일정표를 더했습니다. 기준 쪽은 기준 사실을 더 많이 맞혔고(10개 중 4개 대 2개) codemod 목록도 더 자세해서, 블라인드 판정은 무승부였습니다. 메인테이너는 공식 출처 비율이 훨씬 높다는 점(86% 대 43%)을 들어 LitClaude 승으로 판정했습니다.
210
-
211
- ### S7 · 주문·결제·배송 구조도
212
-
213
- LitClaude는 실제 구조도를 그려 HTML/SVG와 PNG로 저장했습니다. 경계 상자와 범례를 넣고 동기 호출은 실선, 비동기 이벤트는 점선으로 나눴으며, 내보낸 파일을 확인하고 뺀 내용을 밝혔습니다. 기준 쪽은 대화창에 ASCII 그림만 주고 파일을 남기지 않았습니다. 메인테이너가 보지 않은 과제라 블라인드 판정을 그대로 따릅니다.
214
-
215
- <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S7-litclaude-diagram.webp"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S7-litclaude-diagram.webp" alt="LitClaude 구조도: 고객 앱, API 게이트웨이, 주문 서비스, 이벤트 브로커, 결제·배송 서비스, 내부 영역 밖의 PG사와 택배사" width="640" /></a>
216
-
217
- ### S8 · 분기 실적 발표자료
218
-
219
- 두 쪽 모두 예시 수치를 지어냈고, 모든 슬라이드에 예시라고 표시했습니다. 블라인드 판정은 기준 쪽을 골랐습니다. 기준 쪽 9장은 유의사항, 전년 동기·전 분기 비교, Q&A를 갖춘 흔한 국내 실적 발표 순서를 따르고, LitClaude 8장은 표지에 장식용 그라데이션 원이 있고 유의사항 슬라이드가 없다는 이유입니다. 배치 검사에서는 기준 쪽에 겹친 글자 16쌍, LitClaude 쪽에 0쌍(넘친 글상자 1개)이 나왔고, 메인테이너는 LitClaude 쪽 발표자료가 확실히 낫다고 판정했습니다.
220
-
221
- 기준 쪽 슬라이드:
222
-
223
- <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S8-baseline-slides.webp"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S8-baseline-slides.webp" alt="기준 쪽 실적 발표자료 앞 5장: 표지, 유의사항, 실적 요약 카드, 요약 손익계산서, 매출 추이 차트" width="100%" /></a>
224
-
225
- LitClaude 슬라이드:
226
-
227
- <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S8-litclaude-slides.webp"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S8-litclaude-slides.webp" alt="LitClaude 실적 발표자료 앞 5장: 표지, 핵심 지표 카드, 분기 매출 차트, 부문별 차트, 요약 손익표" width="100%" /></a>
228
-
229
- ### S9 · 신제품 기획서
230
-
231
- LitClaude는 예시 제품을 정해 예시라고 밝히고, 숫자가 서로 맞는 손익을 담은 A4 5쪽 Word 기획서를 썼습니다. 기준 쪽은 Markdown 파일 하나만 남겼고, 손익은 없고 시장 규모 수치는 비어 있습니다. 메인테이너는 이 회차 첫 LitClaude 실행(괄호로 비워 둔 틀만 낸 결과)은 별로였지만 그 뒤 실행은 LitClaude의 압승이라고 판정했고, 블라인드 판정도 LitClaude를 골랐습니다.
232
-
233
- LitClaude 페이지(기준 쪽은 Word 파일을 만들지 않았습니다):
234
-
235
- <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S9-litclaude-pages.webp"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S9-litclaude-pages.webp" alt="LitClaude 신제품 기획서 앞 3쪽: 요약, 목표 고객과 사양 표, 경쟁 비교와 대당 손익 표" width="100%" /></a>
236
-
237
- ### S11 · 회의실 예약 웹앱
238
-
239
- LitClaude는 단위·API 테스트를 함께 냈고, 실제 브라우저에서 예약, 겹치는 예약 거부, 취소, 키보드만으로 예약하기를 해 봤습니다. 기준 쪽은 테스트가 없고, 예약 창에서 직접 제출해 보지는 않았다고 밝혔습니다. LitClaude는 다크 모드와 휴대폰용 회의실 선택도 더했고, 블라인드 판정과 메인테이너 모두 LitClaude를 골랐습니다.
240
-
241
- 화면 검사는 각 앱의 서버 없이 페이지 파일만 띄웠기 때문에, 두 화면 모두 불러오기에 실패했을 때의 모습입니다.
242
-
243
- | 기준 쪽 | LitClaude |
244
- | --- | --- |
245
- | <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S11-baseline-desktop.webp"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S11-baseline-desktop.webp" alt="기준 쪽 예약 앱, 데스크톱: 빈 화면과 404 오류 알림" width="400" /></a> | <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S11-litclaude-desktop.webp"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S11-litclaude-desktop.webp" alt="LitClaude 예약 앱, 데스크톱: 회의실 목록을 불러오지 못했다는 안내와 예약 폼" width="400" /></a> |
246
-
247
- <details>
248
- <summary>휴대폰 화면</summary>
249
-
250
- | 기준 쪽 | LitClaude |
251
- | --- | --- |
252
- | <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S11-baseline-phone.webp"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S11-baseline-phone.webp" alt="기준 쪽 예약 앱, 휴대폰" width="180" /></a> | <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S11-litclaude-phone.webp"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/ab/S11-litclaude-phone.webp" alt="LitClaude 예약 앱, 휴대폰" width="180" /></a> |
253
-
254
- </details>
255
-
256
- ## 주요 라우트
257
-
258
- ### 작은 lit 작업부터 시작하기
259
-
260
- 프롬프트 끝에 `lit`을 붙이면 Claude Code hook이 작업 루프를 시작합니다. hook은 경로 안내를 보내고 실제 작업은 Claude Code가 수행합니다.
261
-
262
- | 프롬프트 또는 경로 | 효과 |
263
- | --- | --- |
264
- | `lit` | 현재 Claude Code 대화에서 근거 중심 작업 루프를 시작합니다. |
265
- | `handoff` | 확인한 결과와 다음 할 일을 다음 세션으로 건넵니다. |
266
- | `lit-plan` | 구현 전에 범위와 확인 기준이 있는 계획을 만듭니다. |
267
- | `/litclaude:start-work <승인된 계획>` | 이미 승인한 계획을 실행합니다. |
268
- | `review-work` | 변경과 근거를 읽고 남은 일을 보고합니다. |
269
- | `litresearch` | 출처를 남기는 조사 경로로 사실과 불확실성을 나눕니다. |
270
-
271
- hook의 표시는 작업 진입을 뜻하며 작업이나 브라우저 확인이 끝났다는 증거는 아닙니다.
272
-
273
- <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>
274
-
275
- 포스터를 선택하면 선택형 Ignition 영상을 엽니다. README에서 자동 재생하지 않습니다.
54
+ ```bash
55
+ claude
56
+ ```
276
57
 
277
- ### 작업 이어가기
58
+ `lit`을 입력하고, 활성화 안내가 나오면 작은 작업 하나를 맡겨 보세요.
278
59
 
279
60
  ```text
280
- 계획하기 → 만들기 → 확인하기 → 다음 작업에 건네기
61
+ 외부 의존성 없이 HTML 파일 하나로 할 일 목록을 만들어줘.
62
+ 추가·완료·삭제 동작을 구현하고, 확인한 내용과 다음 행동을 남겨줘.
281
63
  ```
282
64
 
283
- | 할 일 | Claude Code에서 입력할 내용 | 남길 것 |
284
- | --- | --- | --- |
285
- | 범위 정하기 | `lit plan <what>` | 계획과 성공 기준 |
286
- | 승인한 계획 실행하기 | `/litclaude:start-work`에 승인한 계획 전달 | 변경과 확인 결과 |
287
- | 결과 검토하기 | `lit review <scope>` | 확인한 점과 남은 문제 |
288
- | 세션 마무리하기 | `/litclaude:lit-handoff` | 다음 세션에 건넬 파일과 경로 |
289
-
290
- 목표를 연결하면 프로젝트의 `.litclaude/litgoal/`에 작업 기록을 남깁니다.
291
- 마지막에는 handoff가 알려준 **실제 파일 경로**를 보관하세요. 다음 세션에서 같은
292
- 프로젝트를 열고 그 파일을 읽어 현재 상태와 다음 행동을 확인해달라고 요청하세요.
293
- 그 뒤 이어갈 범위를 지정하세요. [목표와 기록 안내](./docs/migration.md#review-and-litgoal-parity)에
294
- 기록 명령과 호스트 경계가 정리되어 있습니다.
65
+ 끝나면 파일을 직접 열어 세 동작을 눌러 보세요. 제대로 작동하는지는 그렇게 해 봐야 압니다.
295
66
 
296
- “꺼지지 않는 불”은 프로그램이 끝없이 돌아간다는 뜻이 아닙니다.
297
- **세션이 끝나도, 이어갈 작업을 남긴다는 뜻입니다.** 재개할 때는 새 세션에서 기록을
298
- 읽고 현재 파일 상태와 대조해야 합니다.
67
+ ## 자주 쓰는 입력
299
68
 
300
- ### 전체 경로 표
301
-
302
- | 입력 | 용도 |
69
+ | 입력 | 얻는 것 |
303
70
  | --- | --- |
304
- | `lit`, `litwork` | 증거 우선·test-first 실행 loop. `$lit-loop`, `/lit-loop`, `/litclaude:lit-loop`도 지원합니다. |
305
- | `lit plan <what>` | 계획만 작성합니다. `$lit-plan`, `/lit-plan`도 지원합니다. |
306
- | `lit review <scope>` | 계획 또는 완료한 작업을 검토합니다. `$review-work`, `/review-work`도 지원합니다. |
307
- | `lit research <question>` | 인용 가능한 public-source 조사입니다. `$litresearch`, `/litclaude:litresearch`도 지원합니다. |
308
- | `lit search <question>` | Public-source retrieval |
309
- | `lit query <question>` | durable local state에서 근거를 조회합니다. |
310
- | `lit goal <outcome>` | 하나의 목표와 검증 가능한 기준을 연결합니다. `$litgoal`, `/litgoal`도 지원합니다. |
311
- | `lit workflow <objective>` | 넓은 위임 작업을 위한 Dynamic workflow를 제안합니다. |
312
- | `lit team`, `lit teammates` | `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`이고 사용자가 승인한 경우에만 native agent team을 제안합니다. |
313
- | `$deep-interview`, `/deep-interview` | 모호한 요청을 결정 가능한 brief로 정리합니다. |
314
- | `lit recap`, `litrecap`, `$lit-recap`, `/lit-recap`, `/litclaude:lit-recap` | Read-only session recap |
315
- | `handoff`, `/litclaude:lit-handoff` | 검증된 continuation packet을 작성합니다. |
316
- | `lit-scientific-visualization` | 출판용 figure를 준비합니다. `/litclaude:lit-scientific-visualization`도 지원합니다. |
317
- | `/litclaude:lit-diagram-drawer <요청>` | 개념 다이어그램을 그리고 검사한 뒤 내보냅니다. `lit-diagram-drawer`와 `$lit-diagram-drawer`도 지원합니다. |
318
- | `<발표자료 만들어줘 …> lit`, `/litclaude:lit-pptx` | 요청이나 자료로 `.pptx` 발표자료를 만듭니다. `lit-pptx`와 `$lit-pptx`도 지원합니다. |
319
- | `<보고서 써줘 …> lit`, `/litclaude:lit-docx` | 보고서·기획서·제안서·논문 원고를 `.docx`로 만듭니다. `lit-docx`와 `$lit-docx`도 지원합니다. |
320
- | `litclaude wikify <capture/save/review/query/config>` | 검토 기반 local structured knowledge를 관리합니다. |
321
- | `browser-drive`, `$browser-drive` | `vercel-labs/agent-browser`가 0.34.0 기준 이상인지 probe한 뒤 실제 page를 조작합니다. 이후 valid version은 `beyond-verified`로 표시하며 agent가 설치 명령을 대신 실행하지 않습니다. |
322
-
323
- 이름으로 호출하는 주요 스킬은 `lit-crucible`(계획 검토), `lit-init`(저장소 지침),
324
- `lit-commit`(Git 이력), `lit-team`(네이티브 팀), `lit-burnoff`(변경 묶음 정리),
325
- `lit-burnoff-file`(단일 파일 정리), `lit-humanizer`(한국어·영어 문장),
326
- `lit-code`(구현 규율)입니다. 프롬프트 앞에 이름 또는 `$<skill-id>`를 입력합니다.
327
- 이전 이름은 한 릴리스 동안 안내 문구와 함께 새 스킬로 연결됩니다.
328
- [이름 이전 표](./docs/migration.md#one-release-rename-aliases)를 참고하세요.
329
-
330
- ## 스킬 한눈에 보기
331
-
332
- 스킬마다 한 줄입니다. 어떤 모습인지, 어떻게 시작하는지, 무엇을 얻는지 보여줍니다.
333
-
334
- <table>
335
- <tr><th>이렇게 됩니다</th><th>스킬</th><th>얻는 것</th></tr>
336
- <tr>
337
- <td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/skills/lit-loop.webp" width="240" alt="요청 끝에 lit만 붙이세요. 목표를 먼저 고정하고, 실패하는 테스트부터 쓰고, 실제 화면을 확인한 뒤 기록을 남깁니다." /></td>
338
- <td><code>lit-loop</code><br /><sub><code>lit</code></sub></td>
339
- <td>요청 끝에 <code>lit</code>만 붙이세요. 목표를 먼저 고정하고, 실패하는 테스트부터 쓰고, 실제 화면을 확인한 뒤 기록을 남깁니다.</td>
340
- </tr>
341
- <tr>
342
- <td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/skills/litwork.webp" width="240" alt="증거와 함께 끝냅니다. 기준마다 실패 테스트부터 정리까지 노트에 남습니다." /></td>
343
- <td><code>litwork</code><br /><sub><code>litwork &lt;task&gt;</code></sub></td>
344
- <td>증거와 함께 끝냅니다. 기준마다 실패 테스트부터 정리까지 노트에 남습니다.</td>
345
- </tr>
346
- <tr>
347
- <td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/skills/lit-plan.webp" width="240" alt="start-work가 그대로 실행할 수 있는 번호 붙은 작업 목록이 파일로 나옵니다. 코드는 아직 건드리지 않습니다." /></td>
348
- <td><code>lit-plan</code><br /><sub><code>lit plan &lt;what&gt;</code></sub></td>
349
- <td><code>start-work</code>가 그대로 실행할 수 있는 번호 붙은 작업 목록이 파일로 나옵니다. 코드는 아직 건드리지 않습니다.</td>
350
- </tr>
351
- <tr>
352
- <td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/skills/start-work.webp" width="240" alt="계획을 한 줄씩 실행합니다. 다섯 관문을 모두 통과해야 체크 표시가 붙습니다." /></td>
353
- <td><code>start-work</code><br /><sub><code>start-work &lt;plan&gt;</code></sub></td>
354
- <td>계획을 한 줄씩 실행합니다. 다섯 관문을 모두 통과해야 체크 표시가 붙습니다.</td>
355
- </tr>
356
- <tr>
357
- <td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/skills/review-work.webp" width="240" alt="다섯 갈래 리뷰가 같은 변경을 따로 읽고, 발견한 문제부터 보고합니다." /></td>
358
- <td><code>review-work</code><br /><sub><code>lit review &lt;scope&gt;</code></sub></td>
359
- <td>다섯 갈래 리뷰가 같은 변경을 따로 읽고, 발견한 문제부터 보고합니다.</td>
360
- </tr>
361
- <tr>
362
- <td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/skills/litgoal.webp" width="240" alt="목표 하나와 확인 가능한 기준을 디스크에 남겨, 다음 세션이 이어받을 수 있습니다." /></td>
363
- <td><code>litgoal</code><br /><sub><code>lit goal &lt;outcome&gt;</code></sub></td>
364
- <td>목표 하나와 확인 가능한 기준을 디스크에 남겨, 다음 세션이 이어받을 수 있습니다.</td>
365
- </tr>
366
- <tr>
367
- <td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/skills/lit-recap.webp" width="240" alt="읽기 전용 요약입니다. 끝난 일, 진행 중인 일, 막힌 곳, 증거 위치, 다음 단계를 보여줍니다." /></td>
368
- <td><code>lit-recap</code><br /><sub><code>lit recap</code> · <code>litrecap</code></sub></td>
369
- <td>읽기 전용 요약입니다. 끝난 일, 진행 중인 일, 막힌 곳, 증거 위치, 다음 단계를 보여줍니다.</td>
370
- </tr>
371
- <tr>
372
- <td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/skills/lit-handoff.webp" width="240" alt="handoff라고 치면 다음 세션이 읽고 이어갈 인수인계 파일이 생깁니다." /></td>
373
- <td><code>lit-handoff</code><br /><sub><code>handoff</code></sub></td>
374
- <td><code>handoff</code>라고 치면 다음 세션이 읽고 이어갈 인수인계 파일이 생깁니다.</td>
375
- </tr>
376
- <tr>
377
- <td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/skills/deep-interview.webp" width="240" alt="한 번에 한 질문씩 물어 아이디어를 만들 수 있을 만큼 분명하게 다듬습니다. 남은 모호함은 게이지로 보입니다." /></td>
378
- <td><code>deep-interview</code><br /><sub><code>deep-interview &lt;idea&gt;</code></sub></td>
379
- <td>한 번에 한 질문씩 물어 아이디어를 만들 수 있을 만큼 분명하게 다듬습니다. 남은 모호함은 게이지로 보입니다.</td>
380
- </tr>
381
- <tr>
382
- <td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/skills/litresearch.webp" width="240" alt="조사 질문을 잘게 나누고 여러 검색을 동시에 돌려, 단서를 끝까지 따라간 뒤 출처와 함께 답합니다." /></td>
383
- <td><code>litresearch</code><br /><sub><code>lit research &lt;question&gt;</code> · <code>lit search</code></sub></td>
384
- <td>조사 질문을 잘게 나누고 여러 검색을 동시에 돌려, 단서를 끝까지 따라간 뒤 출처와 함께 답합니다.</td>
385
- </tr>
386
- <tr>
387
- <td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/skills/lit-crucible.webp" width="240" alt="계획 전에 요구사항을 반박해 봅니다. 반박을 견딘 위험만 계획으로 넘어갑니다." /></td>
388
- <td><code>lit-crucible</code><br /><sub><code>lit-crucible &lt;brief&gt;</code></sub></td>
389
- <td>계획 전에 요구사항을 반박해 봅니다. 반박을 견딘 위험만 계획으로 넘어갑니다.</td>
390
- </tr>
391
- <tr>
392
- <td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/skills/lit-init.webp" width="240" alt="저장소를 훑어 루트 AGENTS.md와, 필요한 폴더에만 짧은 안내서를 만듭니다." /></td>
393
- <td><code>lit-init</code><br /><sub><code>lit-init</code></sub></td>
394
- <td>저장소를 훑어 루트 AGENTS.md와, 필요한 폴더에만 짧은 안내서를 만듭니다.</td>
395
- </tr>
396
- <tr>
397
- <td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/skills/lit-comprehend.webp" width="240" alt="에이전트가 쓴 작업을 이해하도록 돕는 설명 페이지입니다. 직관, 흐름 설명, 짧은 퀴즈 순서입니다." /></td>
398
- <td><code>lit-comprehend</code><br /><sub><code>lit-comprehend &lt;target&gt;</code></sub></td>
399
- <td>에이전트가 쓴 작업을 이해하도록 돕는 설명 페이지입니다. 직관, 흐름 설명, 짧은 퀴즈 순서입니다.</td>
400
- </tr>
401
- <tr>
402
- <td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/skills/lit-humanizer.webp" width="240" alt="딱딱한 AI 문장을 한국어나 영어로 다시 씁니다. 사실과 단서는 남기고 군더더기는 뺍니다." /></td>
403
- <td><code>lit-humanizer</code><br /><sub><code>lit-humanizer &lt;text&gt;</code></sub></td>
404
- <td>딱딱한 AI 문장을 한국어나 영어로 다시 씁니다. 사실과 단서는 남기고 군더더기는 뺍니다.</td>
405
- </tr>
406
- <tr>
407
- <td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/skills/lit-diagram-drawer.webp" width="240" alt="슬라이드와 문서에 넣을 다이어그램을 편집 가능한 형태로 그리고, 검사한 뒤 PNG와 SVG로 내보냅니다." /></td>
408
- <td><code>lit-diagram-drawer</code><br /><sub><code>/litclaude:lit-diagram-drawer &lt;brief&gt;</code></sub></td>
409
- <td>슬라이드와 문서에 넣을 다이어그램을 편집 가능한 형태로 그리고, 검사한 뒤 PNG와 SVG로 내보냅니다.</td>
410
- </tr>
411
- <tr>
412
- <td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/skills/lit-pptx.webp" width="240" alt="lit으로 발표자료를 요청하면 원본 차트와 글꼴이 들어간 편집 가능한 PowerPoint 파일이 나옵니다. 슬라이드마다 배치 검사를 통과하고, 렌더링된 화면으로 다시 확인합니다." /></td>
413
- <td><code>lit-pptx</code><br /><sub><code>/litclaude:lit-pptx &lt;request&gt;</code></sub></td>
414
- <td><code>lit</code>으로 발표자료를 요청하면 원본 차트와 글꼴이 들어간 편집 가능한 PowerPoint 파일이 나옵니다. 슬라이드마다 배치 검사를 통과하고, 렌더링된 화면으로 다시 확인합니다.</td>
415
- </tr>
416
- <tr>
417
- <td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/skills/lit-docx.webp" width="240" alt="lit으로 보고서를 요청하면 서식을 갖춘 Word 파일과 원고 Markdown이 나옵니다. 한국어는 Pretendard로 조판하고, 페이지를 렌더링해 읽어 본 뒤 넘깁니다." /></td>
418
- <td><code>lit-docx</code><br /><sub><code>/litclaude:lit-docx &lt;request&gt;</code></sub></td>
419
- <td><code>lit</code>으로 보고서를 요청하면 서식을 갖춘 Word 파일과 원고 Markdown이 나옵니다. 한국어는 Pretendard로 조판하고, 페이지를 렌더링해 읽어 본 뒤 넘깁니다.</td>
420
- </tr>
421
- <tr>
422
- <td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/skills/frontend-ui-ux.webp" width="240" alt="실제로 동작하는 화면을 만들고, 측정 프로브로 일곱 가지 보기를 렌더링합니다. 320·390·768·1440px, 다크 모드, 모션 줄이기, 200% 확대입니다." /></td>
423
- <td><code>frontend-ui-ux</code><br /><sub><code>frontend-ui-ux build &lt;target&gt;</code></sub></td>
424
- <td>실제로 동작하는 화면을 만들고, 측정 프로브로 일곱 가지 보기를 렌더링합니다. 320·390·768·1440px, 다크 모드, 모션 줄이기, 200% 확대입니다.</td>
425
- </tr>
426
- <tr>
427
- <td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/skills/readme-studio.webp" width="240" alt="사실에 맞는 README와 움직이는 커버를 만들고, 휴대폰과 데스크톱 폭, 라이트와 다크 모드에서 확인합니다." /></td>
428
- <td><code>readme-studio</code><br /><sub><code>readme-studio &lt;scope&gt;</code></sub></td>
429
- <td>사실에 맞는 README와 움직이는 커버를 만들고, 휴대폰과 데스크톱 폭, 라이트와 다크 모드에서 확인합니다.</td>
430
- </tr>
431
- <tr>
432
- <td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/skills/lit-typographic-motion.webp" width="240" alt="lit으로 영상을 요청하면 트리트먼트를 먼저 쓰고, 장면을 그리거나 글자를 움직이고, 사운드를 입힙니다. 깜빡임, 가독성, 소리를 검사한 뒤 영상을 넘깁니다." /></td>
433
- <td><code>lit-typographic-motion</code><br /><sub><code>/litclaude:lit-typographic-motion &lt;request&gt;</code></sub></td>
434
- <td><code>lit</code>으로 영상을 요청하면 트리트먼트를 먼저 쓰고, 장면을 그리거나 글자를 움직이고, 사운드를 입힙니다. 깜빡임, 가독성, 소리를 검사한 뒤 영상을 넘깁니다.</td>
435
- </tr>
436
- <tr>
437
- <td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/skills/lit-scientific-visualization.webp" width="240" alt="학술지 규격 그림을 벡터와 600 DPI로 내보냅니다. 그래프 종류는 데이터 성격에 맞춰 고릅니다." /></td>
438
- <td><code>lit-scientific-visualization</code><br /><sub><code>lit-scientific-visualization</code></sub></td>
439
- <td>학술지 규격 그림을 벡터와 600 DPI로 내보냅니다. 그래프 종류는 데이터 성격에 맞춰 고릅니다.</td>
440
- </tr>
441
- <tr>
442
- <td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/skills/visual-qa.webp" width="240" alt="실제 화면을 폭별로 확인해 결과를 정직하게 돌려줍니다. 막히면 무엇이 막았는지 정확히 알려줍니다." /></td>
443
- <td><code>visual-qa</code><br /><sub><code>visual-qa &lt;target&gt;</code></sub></td>
444
- <td>실제 화면을 폭별로 확인해 결과를 정직하게 돌려줍니다. 막히면 무엇이 막았는지 정확히 알려줍니다.</td>
445
- </tr>
446
- <tr>
447
- <td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/skills/browser-drive.webp" width="240" alt="브라우저 드라이버를 먼저 확인한 뒤 실제 페이지를 조작합니다. 드라이버가 없으면 그렇다고 말합니다." /></td>
448
- <td><code>browser-drive</code><br /><sub><code>browser-drive &lt;task&gt;</code></sub></td>
449
- <td>브라우저 드라이버를 먼저 확인한 뒤 실제 페이지를 조작합니다. 드라이버가 없으면 그렇다고 말합니다.</td>
450
- </tr>
451
- <tr>
452
- <td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/skills/structural-search.webp" width="240" alt="글자 대신 문법 구조로 코드를 찾고, 바꾸기 전에 결과를 미리 보여줍니다." /></td>
453
- <td><code>structural-search</code><br /><sub><code>structural-search &lt;pattern&gt;</code></sub></td>
454
- <td>글자 대신 문법 구조로 코드를 찾고, 바꾸기 전에 결과를 미리 보여줍니다.</td>
455
- </tr>
456
- <tr>
457
- <td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/skills/lit-team.webp" width="240" alt="여러 작업자에게 겹치지 않는 몫을 나누고, 각자 증거와 함께 보고하게 합니다." /></td>
458
- <td><code>lit-team</code><br /><sub><code>lit team</code> · <code>lit teammates</code></sub></td>
459
- <td>여러 작업자에게 겹치지 않는 몫을 나누고, 각자 증거와 함께 보고하게 합니다.</td>
460
- </tr>
461
- <tr>
462
- <td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/skills/autoresearch.webp" width="240" alt="승인된 예산 안에서 실험을 반복합니다. 한 번에 하나만 바꾸고, 결과에 따라 남기거나 되돌립니다." /></td>
463
- <td><code>autoresearch</code><br /><sub><code>autoresearch &lt;mode&gt;</code></sub></td>
464
- <td>승인된 예산 안에서 실험을 반복합니다. 한 번에 하나만 바꾸고, 결과에 따라 남기거나 되돌립니다.</td>
465
- </tr>
466
- <tr>
467
- <td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/skills/autoconference.webp" width="240" alt="예산을 정한 연구 회의입니다. 연구자와 리뷰어가 따로 일하고, 종합에는 반대 의견도 남깁니다." /></td>
468
- <td><code>autoconference</code><br /><sub><code>autoconference &lt;mode&gt;</code></sub></td>
469
- <td>예산을 정한 연구 회의입니다. 연구자와 리뷰어가 따로 일하고, 종합에는 반대 의견도 남깁니다.</td>
470
- </tr>
471
- <tr>
472
- <td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/skills/wikify.webp" width="240" alt="검토를 거친 프로젝트 지식을 디스크에 두고, 나중 질문에 출처와 함께 답합니다." /></td>
473
- <td><code>wikify</code><br /><sub><code>litclaude wikify capture|save|review|query|config</code></sub></td>
474
- <td>검토를 거친 프로젝트 지식을 디스크에 두고, 나중 질문에 출처와 함께 답합니다.</td>
475
- </tr>
476
- <tr>
477
- <td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/skills/debugging.webp" width="240" alt="버그를 재현하고, 가설을 세 개 이상 세워 확인한 뒤, 확인된 원인만 고칩니다." /></td>
478
- <td><code>debugging</code><br /><sub><code>debugging &lt;symptom&gt;</code></sub></td>
479
- <td>버그를 재현하고, 가설을 세 개 이상 세워 확인한 뒤, 확인된 원인만 고칩니다.</td>
480
- </tr>
481
- <tr>
482
- <td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/skills/refactor.webp" width="240" alt="동작을 테스트로 고정한 채 코드 구조를 바꿉니다. 단계마다 확인합니다." /></td>
483
- <td><code>refactor</code><br /><sub><code>refactor &lt;target&gt;</code></sub></td>
484
- <td>동작을 테스트로 고정한 채 코드 구조를 바꿉니다. 단계마다 확인합니다.</td>
485
- </tr>
486
- <tr>
487
- <td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/skills/lit-burnoff.webp" width="240" alt="테스트로 동작을 먼저 묶어 두고, 변경분에 붙은 AI식 군더더기를 걷어냅니다." /></td>
488
- <td><code>lit-burnoff</code><br /><sub><code>lit-burnoff &lt;scope&gt;</code></sub></td>
489
- <td>테스트로 동작을 먼저 묶어 두고, 변경분에 붙은 AI식 군더더기를 걷어냅니다.</td>
490
- </tr>
491
- <tr>
492
- <td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/skills/lit-burnoff-file.webp" width="240" alt="파일 하나만 정리합니다. 설명조 주석과 과한 방어 코드를 줄이고 중첩을 펴줍니다." /></td>
493
- <td><code>lit-burnoff-file</code><br /><sub><code>lit-burnoff-file &lt;path&gt;</code></sub></td>
494
- <td>파일 하나만 정리합니다. 설명조 주석과 과한 방어 코드를 줄이고 중첩을 펴줍니다.</td>
495
- </tr>
496
- <tr>
497
- <td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/skills/lit-code.webp" width="240" alt="엄격한 구현 규칙입니다. 테스트 먼저, 경계에서 타입 확인, 작은 파일." /></td>
498
- <td><code>lit-code</code><br /><sub><code>lit-code &lt;task&gt;</code></sub></td>
499
- <td>엄격한 구현 규칙입니다. 테스트 먼저, 경계에서 타입 확인, 작은 파일.</td>
500
- </tr>
501
- <tr>
502
- <td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/skills/lit-commit.webp" width="240" alt="변경을 저장소 스타일에 맞는 작은 커밋으로 나눕니다. 관계없는 작업은 건드리지 않습니다." /></td>
503
- <td><code>lit-commit</code><br /><sub><code>lit-commit</code></sub></td>
504
- <td>변경을 저장소 스타일에 맞는 작은 커밋으로 나눕니다. 관계없는 작업은 건드리지 않습니다.</td>
505
- </tr>
506
- <tr>
507
- <td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/skills/lsp-setup.webp" width="240" alt="사용하는 언어의 언어 서버를 설치하고, 진단이 실제로 도는지 확인합니다." /></td>
508
- <td><code>lsp-setup</code><br /><sub><code>lsp-setup &lt;language&gt;</code></sub></td>
509
- <td>사용하는 언어의 언어 서버를 설치하고, 진단이 실제로 도는지 확인합니다.</td>
510
- </tr>
511
- <tr>
512
- <td><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.13/docs/assets/skills/automatic-checks.webp" width="240" alt="알아서 돌아갑니다. 프로젝트 규칙을 읽고, 수정 뒤에는 진단을 요청하고 새 주석을 검토합니다." /></td>
513
- <td><code>rules</code> · <code>lsp</code> · <code>comment-checker</code><br /><sub>자동 실행</sub></td>
514
- <td>알아서 돌아갑니다. 프로젝트 규칙을 읽고, 수정 뒤에는 진단을 요청하고 새 주석을 검토합니다.</td>
515
- </tr>
516
- </table>
517
-
518
- ## 문제 해결
519
-
520
- 기존 설치에서 `INSTALL_OWNERSHIP_CONFLICT`가 나왔다면 반복 설치나 폴더 이동을 멈추고
521
- [소유권 충돌 안내](./docs/migration.md#ownership-conflicts)를 확인하세요.
522
-
523
- ### 검증 및 제거
524
-
525
- 설치된 package는 다음 관리 명령을 제공합니다.
71
+ | `lit`, 또는 프롬프트 끝에 `lit` | 근거 중심 작업 루프 |
72
+ | `lit plan <what>` | 파일을 고치기 전에 세우는 계획과 확인 기준 |
73
+ | `/litclaude:start-work <승인된 계획>` | 승인한 계획의 실행 |
74
+ | `lit review <scope>` | 확인한 점과 남은 일 |
75
+ | `lit research <question>` | 출처를 밝힌 public-source 조사 |
76
+ | `handoff` | 다음 세션에 건넬 파일 |
77
+ | `<발표자료 만들어줘 …> lit`, `<보고서 써줘 …> lit` | 바로 고칠 수 있는 `.pptx`, `.docx` 파일 |
78
+
79
+ 세션을 마칠 때 `handoff`를 입력하고, 알려 준 파일 경로를 챙겨 두세요. 다음에 같은 프로젝트를
80
+ 열어 그 파일을 읽고 현재 상태와 다음 할 일을 확인해 달라고 하면 됩니다.
81
+
82
+ LitClaude에는 직접 부르는 스킬 35개가 들어 있습니다. 모호한 요청을 다듬는 `deep-interview`와
83
+ `lit-crucible`부터 `lit-diagram-drawer`, `lit-scientific-visualization`, `debugging`,
84
+ `refactor`, `lit-commit`까지 있고, 따로 부르지 않아도 도는 `rules`, `lsp`, `comment-checker`
85
+ 세 개가 더 있습니다. GitHub 페이지에서 A/B 결과와 함께 스킬마다 그림을 붙여 보여 줍니다.
86
+
87
+ ## 설치 후 달라지는 것
88
+
89
+ - Claude Code에 LitClaude 플러그인이 들어옵니다. 스킬, 명령, 에이전트, hook이 함께 들어옵니다.
90
+ - 상태 줄에 LitClaude HUD가 나타납니다. `[🔥LITCLAUDE vX.Y.Z]`, `ctx [▎░░]` 컨텍스트 막대,
91
+ `5h [▏░] 4% ↻` 사용 한도 리셋 카운트다운을 보여 줍니다.
92
+ - 권한 규칙은 `--permission-mode balanced`나 `--yolo`를 고를 때만 바뀝니다. 출력 스타일도
93
+ 직접 고를 때만 기록합니다.
94
+ - 목표를 연결한 작업은 프로젝트의 `.litclaude/litgoal/`에 상태를 남깁니다. 세션을 닫으면 모든
95
+ 것이 멈추고, 다음 세션은 직접 열어야 이어집니다.
96
+
97
+ 프롬프트에 맞는 스킬을 추천해 주는 Jev 스킬 힌트도 있습니다. 선택 기능이라 기본으로 꺼져 있고,
98
+ 켜면 프롬프트가 컴퓨터 밖으로 나갑니다. `LITCLAUDE_JEV=1`과 본인의 `TYPESAFE_API_KEY`를
99
+ 설정하면, 해당하는 프롬프트를 2,000자로 자르고 홈 경로, 이메일 주소, 토큰 모양의 문자열을 가린
100
+ 뒤 TypeSafe로 보냅니다. 나머지는 적힌 그대로 가고, 비용은 본인의 TypeSafe 계정에 청구됩니다.
101
+ 셸에 넣어 둔 키는 에이전트의 도구도 읽을 수 있으니, 이 기능 전용 키를 만들고 사용 한도를 낮게
102
+ 잡아 두세요. 켜기 전에 GitHub 안내를 먼저 읽어 주세요.
103
+
104
+ ## 안전과 제거
105
+
106
+ hook은 Claude Code가 넘겨 주는 제한된 이벤트 데이터만 읽고, 입력한 프롬프트는 작업 흐름을 고르는
107
+ 데 쓸 뿐 명령으로 실행하지 않습니다. 프로젝트 안에 생기는 LitClaude 상태는 gitignore되며 npm 패키지에
108
+ 들어가지 않습니다. 업데이트는 자동으로 확인하는데, 끄고 싶다면 `--no-auto-update`,
109
+ `LITCLAUDE_NO_AUTO_UPDATE`, `NO_UPDATE_NOTIFIER`, `LITCLAUDE_NO_UPDATE_CHECK` 중 하나를 쓰세요.
526
110
 
527
111
  ```bash
528
112
  npm exec --yes --package @litfamily/litclaude@latest -- litclaude doctor
529
- npm exec --yes --package @litfamily/litclaude@latest -- litclaude --version
530
- npm exec --yes --package @litfamily/litclaude@latest -- litclaude path
531
- npm exec --yes --package @litfamily/litclaude@latest -- litclaude workflow-check --json
532
- npm exec --yes --package @litfamily/litclaude@latest -- litclaude update
533
113
  npm exec --yes --package @litfamily/litclaude@latest -- litclaude uninstall
534
114
  ```
535
115
 
536
- `uninstall`은 LitClaude가 관리한 plugin, HUD, permission, local state만
537
- 제거하며 다른 Claude 설정은 제거하지 않습니다. 수정되었거나 소유권을 확인할 수 없는
538
- 설치는 보존하고 거절합니다. [충돌 안내](./docs/migration.md#ownership-conflicts)를 따르세요.
539
- 별도 프로필 체험을 마쳤다면 해당 세션과 터미널을 닫고 원래 환경의 터미널로 돌아가면
540
- 됩니다. 이전 설치를 지우거나 재설치할 필요는 없습니다.
541
-
542
- ## 링크
543
-
544
- <a id="추가-문서"></a>
545
-
546
- - [운영 참고](#운영-참고)
547
- - [Hook trigger와 activation boundary](./docs/hooks.md)
548
- - [Agent와 orchestration 안내](./docs/agents.md)
549
- - [Workflow migration 표](./docs/migration.md)
550
- - [Native `/goal` surface matrix](./docs/native-goal-surface.md)
551
- - [Workflow compatibility audit](./docs/workflow-compatibility-audit.md)
552
- - [Release checklist](./RELEASE_CHECKLIST.md)
553
- - [Release history](./CHANGELOG.md)
554
- - [English README](./README.md)
555
-
556
- ### LITFAMILY
557
-
558
- <details>
559
- <summary>추가 흐름과 제품 참고</summary>
560
-
561
- ## 실제 경로와 편집 이미지
562
-
563
- `lit`은 근거 중심 루프를 시작하고, `handoff`는 확인한 작업을 다음 세션으로 넘깁니다. `lit-plan`은
564
- 범위와 기준이 있는 계획을 작성하며, `/litclaude:start-work <승인된 계획>`은 승인한 계획을 실행합니다.
565
- `review-work`는 변경과 근거를 검토하고, `litresearch`는 출처와 불확실성을 나누어 기록합니다. 각 경로는
566
- 프로젝트 기록에 기대한 효과를 남기며 새 슬래시 경로를 만들지 않습니다. 호스트 한계상 hook과 모델 실행은
567
- Claude Code가 담당하지만 권한, 브라우저 접근, 화면 확인은 호스트의 능력입니다. hook 표시나 정적 편집
568
- 이미지는 완료 증거가 아닙니다.
569
-
570
- <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>
571
-
572
- 소스 트리의 `docs/assets/cover.svg`는 편집 가능한 저대역폭 대체 표지로 남아 있으며, 정적 제품 강조 표지인 `docs/assets/cover.webp`는 패키지에 계속 포함되지만 이 페이지에는 더 이상 표시하지 않습니다.
573
-
574
- ## Claude Code 안에서의 흐름
575
-
576
- 짧은 prompt와 slash command는 서로 다른 입구를 사용합니다. hook은 route 안내와
577
- 편집 후 검사 안내를 Claude Code에 전달하고, Claude가 해당 skill을 따라 작업합니다.
578
-
579
- ```mermaid
580
- flowchart TD
581
- P["lit prompt"] --> H["UserPromptSubmit hook<br/>route 안내"]
582
- C["/litclaude:* command"] --> S["Claude Code가 해당 skill을 읽음"]
583
- H --> S
584
- R["SessionStart<br/>프로젝트 rules"] --> S
585
- S --> W["계획 · 승인된 작업 실행 · 검토"]
586
- T["PreToolUse / PostToolUse<br/>권한 검사 / 편집 후 안내"] -.-> W
587
- W --> F["프로젝트 파일과 확인 결과"]
588
- W --> L["목표를 연결한 경우<br/>litgoal CLI → .litclaude/litgoal/"]
589
- F --> Q["요청한 lit-handoff"]
590
- L --> Q
591
- Q --> N["다음 세션에 건넬 파일"]
592
- N -. "사용자가 새 세션에서 읽도록 요청" .-> S
593
- ```
594
-
595
- hook 안내만으로 skill 실행이 입증되지는 않습니다. 다음 세션에서는 남긴 파일을
596
- 읽고 실제 상태를 확인해야 합니다. 자세한 경계는 [hook 안내](./docs/hooks.md)와
597
- [목표 기록 안내](./docs/migration.md#review-and-litgoal-parity)를 참고하세요.
598
-
599
- <details>
600
- <summary>LITFAMILY · 다섯 아머드 머신</summary>
601
-
602
- ![다섯 LIT 제품을 아머드 머신으로 표현한 콘셉트 아트](./docs/assets/litfamily-machines.png)
603
-
604
- LitClaude, LitHermes, LitCodex, LitOpenCode, LitGrok을 아머드 머신으로 그린 콘셉트 아트입니다.
605
- 각 제품은 자신의 호스트에서 따로 동작합니다.
606
-
607
- </details>
608
-
609
- ## Jev 스킬 힌트 (선택)
610
-
611
- LitClaude는 TypeSafe가 호스팅하는 선택 모델 Jev에게 프롬프트에 맞는 LitClaude 스킬을 물어볼 수 있습니다.
612
- Jev가 스킬 하나를 고르면 `UserPromptSubmit` 훅이 그 스킬 이름을 담은 권고 한 줄을 덧붙입니다.
613
- 스킬을 불러올지는 여전히 Claude가 정합니다. 이 줄은 권한을 주지 않고 도구를 실행하지도 않습니다.
614
-
615
- 기본값은 꺼짐입니다. 켜려면 Claude Code를 실행하는 환경에 두 변수를 모두 설정합니다.
616
-
617
- ```bash
618
- export LITCLAUDE_JEV=1
619
- export TYPESAFE_API_KEY=<본인의 TypeSafe 키>
620
- ```
621
-
622
- 켜 두면 해당하는 프롬프트마다 2,000자로 자르고 홈 경로, 이메일 주소, 토큰 모양의 문자열을 가린 뒤
623
- TypeSafe(typesafe.ai)로 보냅니다. 슬래시 명령, `lit` 라우터가 이미 처리한 프롬프트, 스킬 이름을 직접 적은
624
- 프롬프트는 보내지 않습니다. 파일, 도구 출력, 대화 기록처럼 세션의 다른 내용도 보내지 않습니다.
625
- 호스트 이름, 고객 이름, `password=…` 꼴이 아닌 비밀번호처럼 토큰 모양이 아닌 내용은 적힌 그대로 전송됩니다.
626
- `TYPESAFE_API_KEY`는 Claude Code를 실행하는 셸에 export되므로 에이전트의 도구도 이 키를 읽을 수 있습니다.
627
- 이 기능 전용 키를 만들고 사용 한도를 낮게 잡아 두세요. 요청 비용은
628
- 본인의 TypeSafe 계정에 청구되며, 입력 토큰 100만 개당 약 0.04달러입니다. 요청은 최대 1.5초만 기다립니다.
629
- 실패하면 평소처럼 진행하고, 세션에서 처음 한 번만 짧게 알립니다.
630
-
631
- `litclaude doctor`는 `Jev skill hint: off`, `on`, `flag on but TYPESAFE_API_KEY missing` 중 하나를 출력합니다.
632
- 켜 두면 LitClaude HUD 상태 줄 끝에 `Jev ✓`가 붙고, 힌트가 나온 턴에는 스킬과 지연 시간(`Jev ✓ lit-humanizer 0.27s`)이,
633
- 키가 없으면 `Jev ⚠ key missing`이 표시됩니다.
634
- 색을 쓸 수 있으면 이 `Jev`가 무지개색으로 은은하게 반짝이고, 플래그와 키가 모두 설정된 세션의 첫 프롬프트에서
635
- `✦ Jev skill hint ON ✦` 한 줄이 한 번 표시됩니다(`NO_COLOR`에서는 색 없이 표시).
636
- 끄려면 `LITCLAUDE_JEV`를 해제하거나 `1`이 아닌 값으로 바꿉니다. 세부 조정 변수와 로컬 디버그 기록은
637
- `docs/hooks.md`에 설명되어 있습니다.
638
-
639
- ## 안전 모델
640
-
641
- - Hook은 제한된 Claude Code event JSON을 읽고 사용자 prompt text를 실행하지
642
- 않습니다.
643
- - Planner agent는 read-only입니다. Review route는 근거를 검사하지만 검토한
644
- 작업을 직접 구현하지 않습니다.
645
- - `public-read`는 localhost, private-network, non-HTTP(S) target을 거부하고
646
- site credential 없이 authentication과 paywall 경계에서 중단합니다.
647
- - 프로젝트 로컬 LitClaude 상태와 evidence 디렉터리는 gitignore되며 npm 패키지에서
648
- 제외됩니다.
649
- - Interactive update는 사용자에게 보이는 단계로 동작하며 unknown, rollback,
650
- verification failure에서는 fail closed합니다. `--no-auto-update`,
651
- `LITCLAUDE_NO_AUTO_UPDATE`, `NO_UPDATE_NOTIFIER`,
652
- `LITCLAUDE_NO_UPDATE_CHECK`로 automatic lane을 끌 수 있습니다.
653
- - Publish, version 변경, tag, remote marketplace 변경은 명시적 승인이
654
- 필요합니다.
655
-
656
- 모델 선택은 Claude Code가 담당합니다. Native `Workflow`와 실험적 agent team은
657
- 명시적인 opt-in이 필요합니다. Native goal tool이 없으면 local `litgoal` ledger를
658
- 기준으로 사용하며, LitClaude가 사용자를 대신해 `/goal`을 전송하지 않습니다.
659
-
660
- ## GPT 모델 기준과 LitClaude의 경계
661
-
662
- OpenAI 모델 라우팅을 지원하는 제품은 새로 설치할 때 GPT-6를 기본으로 사용합니다. 계획·검토·리드 역할에는
663
- `gpt-6-astra`, 코딩 리드 대안에는 `gpt-6-sol`, helper·일반 작업자에는 `gpt-6-luna`를 사용합니다.
664
- GPT-6 Luna는 `xhigh`를 지원하지만 `ultra` effort는 지원하지 않습니다. 호스트 카탈로그에는 이전 세대
665
- `gpt-5.6-sol`, `gpt-5.6-terra`, `gpt-5.6-luna`가 계속 표시되며 세 모델 모두 선택할 수 있습니다.
666
- 이들에 대한 지원 종료일 메타데이터는 없습니다. 카탈로그에서 `gpt-5.6-luna`도 `xhigh`를
667
- 지원하지만, LitClaude의 기존 정책 전용 제한은 이 조합을 계속 차단합니다.
668
- `gpt-6-luna`의 `xhigh`는 카탈로그에서 지원되며, 일반 작업자 경로의 기본 effort는 `max`입니다.
669
- 일반 설치와 업데이트는 이미 설정된 모델을 바꾸지 않습니다.
670
-
671
- 이 기준이 LitClaude가 OpenAI 경로를 적용한다는 뜻은 아닙니다. LitClaude에는 OpenAI 모델
672
- 카탈로그가 없고 Claude Code가 모델을 선택합니다. `tools/check-model-routing.mjs`는 지원하지
673
- 않는 Claude Code 경로를 차단하는 참조용 검사입니다.
674
-
675
- ### 모델 카탈로그 참조 갱신
676
-
677
- LitClaude 저장소에는 생성되는 OpenAI 모델 카탈로그가 없습니다. 공유 Codex 호스트 카탈로그의
678
- 캐시 파일은 `~/.codex/models_cache.json`이며, 현재 카탈로그를 새로 읽어 출력하려면
679
- `codex debug models`를 실행합니다 (`--bundled`를 지정하면 번들 데이터만 출력합니다).
680
- LitClaude의 정책 참조는 `tools/check-model-routing.mjs`에 있고, 경계 검사는
681
- `node --test test/model-routing.test.mjs`로 고정합니다. 배포하는 `SKILL.md`의 모델 안내를
682
- 바꾸면 `npm run gen:skill-resources`로 리소스 맵을 다시 만들고
683
- `npm run check:skill-resources`로 확인합니다.
684
-
685
- <details>
686
- <summary>운영 참고 — 설치 옵션, 학습, 호스트 경계와 개발</summary>
687
-
688
- <a id="운영-참고"></a>
689
-
690
- ## 무엇을 제공하나요?
691
-
692
- - 증거 기반 실행, 계획, 검토, 조사, handoff workflow
693
- - `lit-loop`, `lit-plan`, `review-work`, `deep-interview`, `litresearch`,
694
- `litgoal`, `lit-handoff`, `lit-scientific-visualization` 등의 Claude-native
695
- skill
696
- - **Claude skill**에는 `litwork`, `structural-search`, `lit-team`,
697
- `autoresearch`, `autoconference`도 포함됩니다. 핵심 순서는
698
- `lit-plan`, `lit-recap`, `lit-loop`입니다.
699
- - Auxiliary Skill-discovery entry인 `frontend-ui-ux`, `readme-studio`, `lit-commit`,
700
- `lsp-setup`, `visual-qa`는 문장 앞의 bare token이나 `$frontend-ui-ux`로
701
- 활성화되며 anywhere-token은 아닙니다.
702
- - 포함된 reference pack은 `lit-code/references`, `lit-code/scripts`,
703
- `debugging/references`입니다.
704
- - native `Workflow`와 experimental agent team에 대한 명시적 opt-in 안내,
705
- worktree 격리 안내
706
- - **Resilient public-source research**와 SSRF, private host, authentication,
707
- paywall 경계를 포함한 public-source reader
708
- - local MCP/LSP helper, 구조화된 Wikify knowledge, 안전하게 제거할 수 있는
709
- managed HUD
710
-
711
- **workflow 완료 조건입니다.** 각 계획 항목에 binary check가 있어야 다음 단계로 넘어갑니다. 하나의 slice를 마치려면 실제 Claude surface에서 evidence를 남기고 임시 QA resource도 정리해야 합니다. Test 통과만으로는 충분하지 않습니다.
712
-
713
- ```mermaid
714
- flowchart TD
715
- R["a request<br/>make it better"] --> DI["<b>deep-interview</b><br/>turn it into a decision-complete brief"]
716
- DI --> P["<b>lit-plan</b><br/>objective · non-goals<br/>action / output / <b>binary verification</b>"]
717
- P --> GATE{"user approves?"}
718
- GATE -->|no| P
719
- GATE -->|yes| SW["<b>start-work</b><br/>execute one slice"]
720
-
721
- subgraph LOOP["each slice: RED to GREEN to SURFACE to CLEAN"]
722
- SW --> RED["failing test first"]
723
- RED --> GREEN["smallest change that passes"]
724
- GREEN --> SURF["exercise the <b>real surface</b><br/>not just the test"]
725
- SURF --> CLEAN["tear down · cleanup receipt"]
726
- end
727
-
728
- CLEAN --> EV{"evidence complete?"}
729
- EV -->|"tests only"| SW
730
- EV -->|"artifact + receipt"| RW["<b>review-work</b><br/>scope · evidence · payload<br/>security · real surface"]
731
- RW -->|findings| SW
732
- RW -->|clean| HO["<b>lit-handoff</b><br/>resumable packet"]
733
-
734
- style GATE fill:#fff3cd,stroke:#856404
735
- style EV fill:#fff3cd,stroke:#856404
736
- style SURF fill:#d4edda,stroke:#155724
737
- style RW fill:#d1ecf1,stroke:#0c5460
738
- ```
739
-
740
- ## 설치 상세
741
-
742
- 다음은 공개 승인을 기다리는 scoped 배포 대상의 설치 명령입니다.
743
-
744
- ```bash
745
- npm exec --yes --package @litfamily/litclaude@latest -- litclaude install
746
- ```
747
-
748
- 설치를 재현하려면 registry에서 현재 package version을 조회한 뒤 고정합니다.
749
-
750
- ```bash
751
- npm view @litfamily/litclaude@1.0.13 version
752
- ```
753
-
754
- 조회 결과가 `1.0.13`이면 exact install을 사용할 수 있습니다.
755
-
756
- ```bash
757
- npm exec --yes --package @litfamily/litclaude@1.0.13 -- litclaude install
758
- ```
759
-
760
- 그렇지 않으면 명시적인 human publication을 기다립니다. Pin은 그 뒤에 사용합니다.
761
- 설치된 plugin은 다음 명령으로 확인합니다.
762
-
763
- ```bash
764
- npm exec --yes --package @litfamily/litclaude@latest -- litclaude doctor
765
- ```
766
-
767
- installer는 Claude Code plugin과 LitClaude status-line HUD를 설정합니다.
768
- Permission mode는 명시적으로 선택합니다.
769
-
770
- ```bash
771
- npm exec --yes --package @litfamily/litclaude@latest -- litclaude install --permission-mode safe
772
- npm exec --yes --package @litfamily/litclaude@latest -- litclaude install --permission-mode balanced
773
- npm exec --yes --package @litfamily/litclaude@latest -- litclaude install --yolo
774
- ```
775
-
776
- `safe`는 permission rule을 추가하지 않습니다. `balanced`는 제한된
777
- read/search와 routine Git, npm, Node rule을 추가하고, `yolo`는 더 넓은
778
- edit/write pattern을 추가합니다. 이 mode들은 Claude의
779
- `permissions.allow`와 `permissions.deny`에 제한된 항목을 기록합니다. 기존
780
- 설정은 보존하며 LitClaude가 삽입한 rule만 추적하고 제거합니다.
781
-
782
- Interactive 설치에서는 HUD accent 후보를 터미널에서 미리 볼 수 있습니다.
783
- `CI`나 `NO_COLOR`가 빈 값으로라도 설정되어 있거나, `TERM=dumb`, UTF-8이
784
- 아닌 locale, 출력 리디렉션 환경에서는 설치 색상과 커서 제어, 질문 스타일을
785
- 끄고 ANSI 없이 출력합니다. `LITCLAUDE_SPINNER=1`로 상세 진행 표시를 켜도
786
- 이 정책은 유지됩니다. `--yes`와 명시적으로 지정한 설정은 그대로 적용됩니다.
787
- LitClaude HUD는 `[🔥LITCLAUDE vX.Y.Z]`, `ctx [▎░░]` context bar,
788
- `5h [▏░] 4% ↻` rate-limit reset countdown을 사용합니다. 설치 전에
789
- `LITCLAUDE_HUD_ACCENT`를 지정해 accent를 선택할 수 있습니다.
790
- prompt hook이 LitClaude discipline을 활성화하면 HUD는 brand 바로 뒤에 굵은
791
- ignition-orange `🔥 LIT IGNITED · lit-loop 🔥` 표시를 붙이고, 활성화가 없는 다음
792
- 턴에서 지웁니다. hook은 선택된 discipline을 세션별로 사용자 임시 디렉터리의
793
- `litclaude-hud/`에 기록하고(저장소와 홈 디렉터리는 건드리지 않음)
794
- `LITCLAUDE_HUD_STATE_ROOT`로 위치를 바꿀 수 있습니다.
795
- 모델 응답은 `🔥 **LIT IGNITED · <discipline>** 🔥`로 시작하며, hook system
796
- message와 HUD는 Markdown 없이 같은 표시를 보여 줍니다.
797
-
798
- HUD의 배경 설정과 터미널 색상 지원 수준은 별개입니다. 기본값(`dark`)에서는 model,
799
- context, usage, reset, Git 글자에 선택한 accent가 들어가고, 사용량 퍼센트는 수준에
800
- 따라 색이 바뀌며, brand는 네온 그라데이션으로 표시됩니다.
801
- `LITCLAUDE_HUD_APPEARANCE=light` 또는 `unknown`으로 지정하면 필수 글자와 brand는
802
- 터미널의 기본 전경색을 쓰고, bar 모양과 구분선만 accent를 사용합니다.
803
- `LITCLAUDE_HUD_COLOR_DEPTH=truecolor|256|16|plain`으로 색 깊이를 지정하면 WSL
804
- truecolor 감지를 포함한 자동 감지보다 우선합니다. `NO_COLOR`는 값이 빈 문자열이어도
805
- HUD ANSI를 모두 끄며, `TERM=dumb`도 다른 색상 신호나 깊이 설정이 있어도 plain을
806
- 유지합니다. `LITCLAUDE_HUD_NO_COLOR=1`도 계속 지원합니다. HUD는 배경색을 강제로
807
- 지정하지 않고 Claude가 `--`를 보낸 rate-limit 값을 임의로 채우지 않습니다.
808
-
809
- 다음 진입점도 사용할 수 있습니다.
810
-
811
- ```bash
812
- npm exec --yes --package @litfamily/litclaude -- litclaude install
813
- npm install -g @litfamily/litclaude
814
- litclaude install
815
- ```
816
-
817
- ## Claude Code 연결 구조
818
-
819
- **Claude Code와 LitClaude의 연결 구조입니다.** Session과 tool event가 rules, routing, authority, ledger surface로 전달됩니다. 이 구조에서 35개 skill·16개 command·3개 숨김 호환 경로·11개 agent가 host 경계 안에서 연결됩니다.
820
-
821
- ```mermaid
822
- flowchart LR
823
- subgraph CC["Claude Code"]
824
- H1["SessionStart"]; H2["UserPromptSubmit"]; H3["PreToolUse"]
825
- H4["PostToolUse"]; H5["Stop"]; H6["SubagentStart / SubagentStop"]; H7["SessionEnd"]
826
- end
827
- subgraph LC["LitClaude plugin"]
828
- RULES["rules engine<br/>project rules into context"]
829
- ROUTE["trigger routing<br/><code>lit</code> · <code>/litclaude:*</code>"]
830
- AUTH["bounded authority<br/>pause on a new boundary"]
831
- LEDGER[("durable ledger<br/><code>.litclaude/</code>")]
832
- end
833
- H1 --> RULES --> LEDGER
834
- H2 --> ROUTE --> LEDGER
835
- H3 --> AUTH
836
- H4 --> LEDGER
837
- H5 --> LEDGER
838
- H6 --> LEDGER
839
- H7 --> LEDGER
840
- LC --> S["35 skills · 16 commands · 11 agents"]
841
- ```
842
-
843
- **아무것도 남아 있지 않은 machine에서도 skill이 작동하는 이유입니다.** Self-contained skill은 allowlist에 명시적인 근거가 있어야 하고, corpus를 참조하는 skill은 packed tarball 안에서 그 corpus를 찾아야 합니다. 이 payload gate가 checkout에만 남은 reference를 설치 후 장애로 만들지 않습니다.
844
-
845
- ```mermaid
846
- flowchart LR
847
- SK["a skill"] --> Q{"does it declare<br/>a capability?"}
848
- Q -->|"self-contained<br/>procedure"| AL["explicit allowlist entry<br/>with a written reason"]
849
- Q -->|"needs a corpus"| C["corpus must resolve<br/>inside the <b>packed payload</b>"]
850
- AL --> G1
851
- C --> G1["<b>payload-substance</b>"]
852
- G1 --> G2["<b>cross-product parity</b><br/>one product cannot ship a stub<br/>where the family ships substance"]
853
- G2 --> G3["<b>referenced-path resolution</b><br/>every path in a SKILL.md<br/>must exist in the tarball"]
854
- G3 --> OK["installs and works<br/>on a machine that has<br/>nothing else"]
855
- style C fill:#d4edda,stroke:#155724
856
- style OK fill:#d4edda,stroke:#155724
857
- ```
858
-
859
- `lit start work <plan>`은 의도적으로 `BLOCKED:` handoff를 반환합니다. 승인된
860
- plan과 함께 `/start-work` 또는 `/litclaude:start-work`를 사용하세요. `lit
861
- workflow`는 native `Workflow`를 먼저 제안하고, 사용자가 opt-in한 뒤에만
862
- 호출합니다. LitClaude는 사용자를 대신해 `/goal`을 입력하거나 slash-command
863
- text를 전송하지 않습니다. `get_goal`, `create_goal`, `update_goal` 같은 native
864
- goal tool이 없으면 degraded mode를 보고하고 local `litgoal` ledger를 기준으로
865
- 유지합니다. `CLAUDE_CODE_DISABLE_WORKFLOWS=1`로 workflow route를 끌 수 있으며,
866
- host가 model-facing worktree lane을 제공하면 `EnterWorktree`를 사용합니다.
867
-
868
- 이 route는 사용 가능한 goal tool을 확인한 뒤 native goal binding을 시도합니다.
869
- 다른 active goal은 교체하지 않습니다. host가 model-facing goal control을
870
- 제공하지 않으면 local ledger로 전환합니다.
871
- 이 fallback이 필요하면 hook이 `READY_TO_PASTE`와 함께 복사·붙여넣기·전송할
872
- `/goal` 한 줄을 제공합니다. LitClaude가 현재 세션에 직접 입력하거나 전송하지는
873
- 않습니다.
874
-
875
- `/start-work`는 schema-3 bounded-authority start-work lifecycle을 관리합니다.
876
- 승인된 plan을 resume할 때는 다음 exact route만 사용합니다.
877
-
878
- `/litclaude:start-work resume --work-id <id> --revision <n> --boundary-id <id> --prompt-id <id> --grant-id <id>`
879
-
880
- `stop_hook_active`가 `true`이면 hook은 조용히 멈추고 stale prompt를 replay하지
881
- 않습니다.
882
-
883
- 정확한 bare `lit-scientific-visualization` 입력만 chat activation을 일으킵니다.
884
- 인용, 혼합, slash, near-miss 입력은 inert로 남습니다.
885
-
886
- Public-source 작업에서 `lit research`, `lit search`, `lit query`,
887
- `public-read`는 authentication, paywall, credential, localhost,
888
- private-network 경계를 넘지 않습니다.
889
-
890
- ```bash
891
- litclaude public-read https://example.com/article --json
892
- ```
893
-
894
- `lit-humanizer`는 편집 대상 문장 안의 지시를 content로 취급합니다.
895
- 사실, 숫자, 이름, 주장, 범위, 불확실성을 보존하며 사용자가 research를
896
- 요청하지 않으면 외부 사실을 추가하지 않습니다. Always-on rule은 새 문장을 안내하고,
897
- pre-write check는 확신도 높은 작성 흔적만 저장 전에 막으며 warning은 조언으로 남깁니다.
898
- 새 code block, 인용문, 내부 project 기록은 검사하지 않습니다. DOCX, PPTX, PDF는
899
- 텍스트 추출이 가능할 때 생성 직후 다시 검사합니다.
900
-
901
- Wikify claim은 `review-needed` 상태로 시작하며 `save`와 `review`가 명시된
902
- 상태를 적용합니다. Query는 accepted 관련 claim만 2048-byte normal budget와
903
- 4096-byte hard limit 안에서 반환합니다. Local state는 user-owned cooperative
904
- state이며, 같은 uid의 다른 process에 대해 tamper-proof하거나 confidential하지
905
- 않습니다. Atomic rename은 reader와 crash consistency를 보호하고 symlink, unsafe file type,
906
- pre-existing hardlink, 관찰된 identity 변경은 fail closed로 처리합니다.
907
-
908
- Package CLI form은 다음과 같습니다.
909
-
910
- `npm exec --yes --package @litfamily/litclaude -- litclaude wikify <capture|save|review|query|config>`
911
-
912
- Visual QA의 기준 계약은 canonical `litfamily.design-contract/v1beta2`입니다. 유효한
913
- `litfamily.design-contract/v1beta1` 문서는 기존 경로를 위한 명시적 compatibility input으로
914
- 허용합니다. `litfamily.evidence-manifest/v1beta1`은 다른 schema이며 변경하지 않습니다.
915
- Prompt activation과 PostToolUse advisory는 synthetic bounded hook pointer만 제공하며 complete
916
- `SKILL.md` 본문을 주입하지 않습니다. 전체 provenance가 없으면 evidence는 `BLOCKED`로 남습니다.
917
-
918
- ## 무결성 경계
919
-
920
- 스캐너 성공은 캡처한 바이트의 파일 수와 SHA-256 다이제스트를 보고하는
921
- 스냅샷 범위의 결과입니다. 캡처 뒤 mutable live tree가 계속 깨끗하다는
922
- 것까지 입증하지는 않습니다. 이후 상태는 검사를 다시 실행해 확인합니다. 법적 동반 파일은
923
- 생성된 manifest 밖에 있으며 정상적으로 검사합니다. Canonical 및 runtime
924
- 캡처는 파일당 8 MiB, 전체 32 MiB로 제한합니다. 패키지 guard는
925
- `immutable expected file map`을 `verifier-to-capture interval`과 생성된
926
- tarball에서 비교하며, `0600` 같은 `non-executable` 항목은 유효합니다.
927
-
928
- ## Checkout 검증 명령
929
-
930
- 이 checkout의 주요 gate입니다.
931
-
932
- ```bash
933
- npm test
934
- npm run validate:plugin
935
- npm run doctor
936
- npm run check:version
937
- npm run scan:legacy-tokens
938
- npm run check:skill-resources
939
- npm run check:runtime-closures
940
- npm run pack:payload-guard
941
- npm run pack:dry-run
942
- ```
943
-
944
- ## 로컬 개발
945
-
946
- checkout에서 plugin을 직접 로드합니다.
947
-
948
- ```bash
949
- claude --plugin-dir ./plugins/litclaude
950
- ```
951
-
952
- Claude Code 안에서는 다음 명령으로 plugin metadata를 다시 읽습니다.
953
-
954
- ```text
955
- /reload-plugins
956
- ```
957
-
958
- ## 프로젝트 지도
959
-
960
- | Surface | Path |
961
- | --- | --- |
962
- | CLI | `bin/litclaude-ai.js` |
963
- | Claude plugin | `plugins/litclaude/` |
964
- | Skills | `plugins/litclaude/skills/` |
965
- | Agents | `plugins/litclaude/agents/` |
966
- | Hooks | `plugins/litclaude/hooks/hooks.json` |
967
- | MCP | `plugins/litclaude/.mcp.json` |
968
- | LSP | `plugins/litclaude/.lsp.json` |
969
-
970
- </details>
971
-
972
- [패키지 이름 이전](./docs/migration.md#scoped-npm-migration) · [기여](./CONTRIBUTING.md) · [지원](./SUPPORT.md) · [보안](./SECURITY.md) · [행동 강령](./CODE_OF_CONDUCT.md) · [개인정보와 네트워크](./docs/privacy.md)
973
-
974
- ## Ignition
975
-
976
- 브랜드 모션입니다. 실제 기능 실행 영상은 아닙니다. 정적 포스터를 눌러 재생하세요.
977
-
978
- [![Ignition 모션 그래픽](./docs/assets/readme/ignition-poster.png)](./docs/assets/readme/ignition-film.mp4)
979
-
980
- [애니메이션 보기 (GIF)](./docs/assets/readme/ignition-readme.gif) · [Lucide 아이콘 라이선스 (ISC)](./docs/assets/readme/Lucide-LICENSE.txt) · [JetBrains Mono 글꼴 라이선스 (OFL)](./docs/assets/readme/JetBrainsMono-OFL.txt)
981
-
982
-
983
- ## 디자인과 README 제작
984
-
985
- `frontend-ui-ux build <대상>`은 허용된 범위의 화면 구현과 실제 렌더 확인까지
986
- 진행합니다. 중요한 방향이 모호하면 하나씩 질문하고 답을 보존해 구현을 이어갑니다.
987
- 검토나 계획만 요청한 경우 파일을 수정하지 않습니다.
988
-
989
- `readme-studio <저장소 또는 README 범위>`와 `$readme-studio`는 저장소 사실을
990
- 확인하고 표지·README를 제작하는 native skill 진입점입니다. Claude Code에 실제
991
- 이미지 생성 도구가 없으면 `IMAGE_GENERATION_UNAVAILABLE`을 기록하며, 명시적으로
992
- 제공된 배경으로 합성을 이어갈 수 있습니다. Pretendard/Meslo 윤곽선 글자와 로컬
993
- 모션 템플릿을 포함하며 글꼴·렌더러 라이선스와 출력물을 확인합니다. GitHub/npm의
994
- 실제 표시 검증은 별도 공개 이후 단계입니다. 새로운 slash command는 추가하지 않습니다.
995
-
996
- `/litclaude:lit-diagram-drawer <요청>`을 쓰거나 프롬프트를 `lit-diagram-drawer`
997
- 또는 `$lit-diagram-drawer`로 시작하면 슬라이드와 문서에 넣을 구조도, 흐름도,
998
- 스키마, 일정표 같은 개념 다이어그램을 그립니다. Pretendard 글꼴을 담은 편집 가능한
999
- HTML/SVG를 만들고 겹침, 라벨 위치, 연결선, 대비, 접근성, 보이는 글자를 함께 들어
1000
- 있는 스크립트로 검사합니다. agent-browser 0.38.1 이상을 직접 설치해 두었다면
1001
- 1×–3× PNG와 Office용 SVG로 내보내고, 없으면 설치 명령과 검사를 마친 원본을
1002
- 돌려줍니다. 화면 설계는 `frontend-ui-ux`, 측정 데이터 그래프는
1003
- `lit-scientific-visualization`이 맡습니다.
116
+ `uninstall`은 LitClaude가 관리하는 플러그인, HUD, 권한, 로컬 상태 항목만 지우고 나머지 Claude
117
+ 설정은 그대로 둡니다. 누가 손을 댔거나 LitClaude가 만든 것으로 알아볼 수 없는 설치는 거절합니다.
1004
118
 
1005
- 발표자료나 보고서를 부탁하고 끝에 `lit`을 붙이면(`팀 워크숍 발표자료 만들어줘 lit`,
1006
- `사내 교육 결과 보고서 써줘 lit`) Markdown이 아니라 Office 파일을 받습니다. `lit-pptx`는
1007
- 슬라이드 원고를 Markdown으로 쓰고, 디자인된 템플릿(기본은 파란색·흰색의 AZURE-PRO,
1008
- 그 밖에 A2Z, 4:3 기본형)으로 컴파일하고, 숫자는 PowerPoint에서 바로 고칠 수 있는 차트와
1009
- 핵심 수치 카드로 그리고, Pretendard 글꼴을 넣습니다. 넘침·대비, 절반이 빈 슬라이드, 표만 있는
1010
- 발표자료, 잘린 장식, 채우지 않은 빈칸을 QA 게이트로 검사한 뒤 페이지를 그림으로 뽑아 눈으로
1011
- 확인합니다. 자료가 없는 요청이면 멈춰서 묻지 않고, 그럴듯한 예시로 끝까지 만들고 예시라고 표시합니다.
1012
- `lit-docx`는 한국어 중심 `korean-generic` 프로필(다른 언어는 기본 스타일, 요청하면
1013
- Elsevier·ACS·IEEE·Nature 프로필)로 Word 문서를 만들고 검사한 뒤 페이지를 확인합니다.
1014
- DOCX·PDF를 Markdown으로 바꾸거나 기존 `.docx`를 고치는 일도 맡습니다. `lit`만 붙인
1015
- 요청에서는 둘 다 스타일을 묻지 않습니다. 필요한 Node·Python 패키지는 처음 쓸 때 고정된
1016
- lockfile에서 `~/.cache/litclaude/office-runtime`에 설치되며, `litclaude doctor`가 그
1017
- 준비 상태와 LibreOffice·pandoc·XeLaTeX 사용 가능 여부를 보여 줍니다.
119
+ ## 더 보기
1018
120
 
1019
- </details>
121
+ - [전체 안내, 스킬 갤러리, A/B 결과 (GitHub)](https://github.com/wjgoarxiv/litclaude/blob/main/README_ko-KR.md)
122
+ - [개인정보와 네트워크](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.15/docs/privacy.md)
123
+ - [이전 안내와 소유권 충돌](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.15/docs/migration.md)
124
+ - [Release history](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.15/CHANGELOG.md)
125
+ - [MIT 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.15/LICENSE)