@litfamily/litclaude 1.0.8 → 1.0.10

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 (52) hide show
  1. package/CHANGELOG.md +11 -0
  2. package/README.md +177 -139
  3. package/README_ko-KR.md +173 -119
  4. package/docs/agents.md +30 -8
  5. package/docs/assets/cover-motion-still.webp +0 -0
  6. package/docs/assets/cover-motion.webp +0 -0
  7. package/docs/assets/litclaude-continuity-1600.webp +0 -0
  8. package/docs/assets/litclaude-ignition-1600.webp +0 -0
  9. package/docs/assets/litfamily-machines.png +0 -0
  10. package/docs/assets/readme/JetBrainsMono-OFL.txt +93 -0
  11. package/docs/assets/readme/Lucide-LICENSE.txt +43 -0
  12. package/docs/assets/readme/ascii-readme.svg +5 -0
  13. package/docs/assets/readme/badge-version.svg +1 -1
  14. package/docs/assets/readme/ignition-film.mp4 +0 -0
  15. package/docs/assets/readme/ignition-poster.png +0 -0
  16. package/docs/assets/readme/ignition-readme.gif +0 -0
  17. package/docs/assets/readme/lucide-book-open.svg +14 -0
  18. package/docs/assets/readme/lucide-play.svg +13 -0
  19. package/docs/assets/readme/lucide-shield-check.svg +14 -0
  20. package/docs/hooks.md +16 -0
  21. package/package.json +14 -1
  22. package/plugins/litclaude/.claude-plugin/plugin.json +1 -1
  23. package/plugins/litclaude/bin/litclaude-hook.js +4 -2
  24. package/plugins/litclaude/bin/litclaude-mcp.js +1 -1
  25. package/plugins/litclaude/lib/canonical-skill-catalog.mjs +1 -0
  26. package/plugins/litclaude/lib/canonical-skill-resources.mjs +25 -2
  27. package/plugins/litclaude/skills/frontend-ui-ux/SKILL.md +21 -12
  28. package/plugins/litclaude/skills/frontend-ui-ux/references/complete-contract.md +8 -9
  29. package/plugins/litclaude/skills/frontend-ui-ux/references/default-editorial-pixel.json +21 -0
  30. package/plugins/litclaude/skills/frontend-ui-ux/references/production-interview.md +17 -0
  31. package/plugins/litclaude/skills/readme-studio/SKILL.md +86 -0
  32. package/plugins/litclaude/skills/readme-studio/references/decoration-and-navigation.md +55 -0
  33. package/plugins/litclaude/skills/readme-studio/references/facts-and-assembly.md +19 -0
  34. package/plugins/litclaude/skills/readme-studio/references/production-interview.md +11 -0
  35. package/plugins/litclaude/skills/readme-studio/references/render-and-deliver.md +44 -0
  36. package/plugins/litclaude/skills/readme-studio/references/type-and-background.md +23 -0
  37. package/plugins/litclaude/skills/readme-studio/scripts/validate-readme-facts.mjs +28 -0
  38. package/plugins/litclaude/skills/readme-studio/templates/cover-source.json +21 -0
  39. package/plugins/litclaude/skills/readme-studio/templates/hyperframes-cover/index.html +30 -0
  40. package/plugins/litclaude/skills/readme-studio/templates/hyperframes-cover/index.motion.json +1 -0
  41. package/plugins/litclaude/skills/readme-studio/templates/hyperframes-cover/package-lock.json +1969 -0
  42. package/plugins/litclaude/skills/readme-studio/templates/hyperframes-cover/package.json +8 -0
  43. package/plugins/litclaude/skills/readme-studio/templates/readme-cover-section.md +75 -0
  44. package/plugins/litclaude/skills/readme-studio/templates/readme-facts.json +4 -0
  45. package/plugins/litclaude/skills/readme-studio/templates/remotion-cover/package-lock.json +3783 -0
  46. package/plugins/litclaude/skills/readme-studio/templates/remotion-cover/package.json +7 -0
  47. package/plugins/litclaude/skills/readme-studio/templates/remotion-cover/src/index.tsx +36 -0
  48. package/plugins/litclaude/skills/readme-studio/templates/typography/package-lock.json +133 -0
  49. package/plugins/litclaude/skills/readme-studio/templates/typography/package.json +6 -0
  50. package/plugins/litclaude/skills/readme-studio/templates/typography/safe-files.mjs +57 -0
  51. package/plugins/litclaude/skills/readme-studio/templates/typography/shape-text-to-svg.mjs +47 -0
  52. package/tools/check-model-routing.mjs +6 -6
package/CHANGELOG.md CHANGED
@@ -1,5 +1,16 @@
1
1
  # Changelog
2
2
 
3
+ ## 1.0.10
4
+
5
+ - Show the static robot family cover image directly under the motion hero in both README pages instead of hiding it behind a "View the static cover" / "정지 표지 보기" link, and remove the now-duplicate copy that lived further down near the LITFAMILY/Links section.
6
+
7
+ ## 1.0.9
8
+
9
+ - Add README Studio with visual decoration patterns, cover depth, and a bounded multi-round design interview.
10
+ - Move new LitClaude OpenAI planning, review, lead, and helper routes to the GPT-6 family defaults.
11
+ - Align the English and Korean README pages to the family layout and pin npm-served asset URLs to this package version.
12
+ - Compare the ignition mark after stripping terminal color so the activation test checks visible text across styles.
13
+
3
14
  ## 1.0.8
4
15
 
5
16
  - Paint the activation logo and its `🔥 LIT IGNITED · <discipline> 🔥` label with a bold truecolor gradient that runs from ignition orange through the HUD hot pink to electric cyan. The hook sets the colour depth itself because its output is always piped, so terminal detection cannot drop it to monochrome; `NO_COLOR` still prints plain text, and the reply line the model is asked to print stays free of escape codes.
package/README.md CHANGED
@@ -1,15 +1,14 @@
1
- <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>
2
- <p align="center"><a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.8/docs/assets/cover.webp">View the static cover</a></p>
1
+ <p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/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>
2
+ <p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/docs/assets/cover.webp" width="100%" alt="Five LitFamily robot companions beneath the words KEEP THE WORK LIT." /></p>
3
3
 
4
4
  <h1 align="center">LitClaude</h1>
5
5
  <p align="center"><strong>Keep the work lit.</strong></p>
6
- <p align="center">A spark has been placed in your hands.<br />Give it somewhere to stay.</p>
7
6
  <p align="center">Plan, build, and check your work in Claude Code. Leave the next session a place to begin.</p>
8
7
  <p align="center">
9
- <a href="#install">Install</a> · <a href="#first-use">First result</a> · <a href="#carry-the-work-forward">Continue</a> · <a href="#core-routes">Core routes</a> · <a href="./README_ko-KR.md">한국어</a>
8
+ <a href="#install">Install</a> · <a href="#quick-start">Quick start</a> · <a href="#core-routes">Core routes</a> · <a href="#links">Links</a> · <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/README_ko-KR.md">한국어</a>
10
9
  </p>
11
10
 
12
- <p align="center"><img src="./docs/assets/readme/ascii-readme.svg" width="480" alt="LIT ASCII B mark" /></p>
11
+ <p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/docs/assets/readme/ascii-readme.svg" width="480" alt="LIT ASCII B mark" /></p>
13
12
 
14
13
  <details>
15
14
  <summary>Copy ASCII logo</summary>
@@ -39,75 +38,23 @@
39
38
 
40
39
  </details>
41
40
 
42
- <p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.8/docs/assets/litclaude-wordmark.svg" width="480" alt="LITCLAUDE display type" /></p>
43
- <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 clay mark" /></p>
41
+ <p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/docs/assets/litclaude-wordmark.svg" width="480" alt="LITCLAUDE display type" /></p>
42
+ <p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/docs/assets/litclaude-clay-icon.png" width="160" alt="LitClaude clay mark" /></p>
44
43
 
45
44
  <p align="center">
46
- <img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.8/docs/assets/readme/badge-version.svg" alt="1.0.8" />
47
- <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>
45
+ <img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/docs/assets/readme/badge-version.svg" alt="1.0.10" />
46
+ <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/docs/assets/readme/badge-license.svg" alt="MIT license" /></a>
48
47
  </p>
49
48
 
50
49
  <p align="center">
51
- <a href="#deeper-docs"><img src="./docs/assets/readme/lucide-book-open.svg" width="16" alt="" /> Docs</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
+ <a href="#deeper-docs"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/docs/assets/readme/lucide-book-open.svg" width="16" alt="" /> Docs</a> · <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/docs/assets/readme/ignition-film.mp4"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/docs/assets/readme/lucide-play.svg" width="16" alt="" /> Ignition</a> · <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/docs/assets/readme/lucide-shield-check.svg" width="16" alt="" /> MIT</a>
52
51
  </p>
53
52
 
54
- ## Start with one lit task
55
-
56
- Append `lit` to the end of a prompt to activate the Claude Code hook. It supplies routing guidance; Claude Code still performs the work.
57
-
58
- | Prompt or route | Effect |
59
- | --- | --- |
60
- | `lit` | Activate the evidence-first work loop in the current Claude Code conversation. |
61
- | `handoff` | Carry the checked result and next step into another session. |
62
- | `lit-plan` | Write a bounded plan and its checks before implementation. |
63
- | `/litclaude:start-work <approved-plan>` | Execute a plan that has already been approved. |
64
- | `review-work` | Read the change and evidence, then report remaining work. |
65
- | `litresearch` | Research with sources; this route records facts and uncertainty separately. |
66
-
67
- The hook marks entry into the workflow; it does not prove that a task or browser check finished.
68
-
69
- <p align="center"><a href="./docs/assets/readme/ignition-film.mp4"><img src="./docs/assets/readme/ignition-poster.png" width="720" alt="Ignition motion poster" /></a></p>
70
-
71
- The poster opens the optional Ignition film; this README keeps motion opt-in.
72
-
73
- ## Practical routes and visual cues
74
-
75
- Use `lit` to activate the evidence-first loop, `handoff` to carry checked work forward,
76
- `lit-plan` to write a bounded plan, `/litclaude:start-work <approved-plan>` to execute an
77
- approved plan, `review-work` to inspect changes and evidence, and `litresearch` to keep sources
78
- and uncertainty separate. Each route leaves its expected effect in the project record; no new
79
- slash route is introduced here. Host limit: Claude Code owns the hook and model execution, while
80
- permissions, browser access, and visual checks remain host capabilities. A hook mark or static
81
- editorial image is not completion evidence.
82
-
83
- <p align="center"><img src="./docs/assets/litclaude-ignition-1600.webp" width="49%" alt="LitClaude ignition editorial cue" /> <img src="./docs/assets/litclaude-continuity-1600.webp" width="49%" alt="LitClaude continuity editorial cue" /></p>
84
-
85
- The retained `docs/assets/readme/ascii-readme.svg` and `docs/assets/cover.svg` remain editable or low-bandwidth fallbacks; the WebP above is the product emphasis export.
86
-
87
-
88
-
89
- ## Leave a spark
90
-
91
- A bug you want fixed. A screen you want built. A project you want to finish.
92
-
93
- Starting takes a sentence. Then the conversation grows, the session ends, and you
94
- have to work out where you left off: what you decided, what you checked, what comes next.
95
-
96
- **LIT leaves that spark with the work.** A goal, a plan, the results you checked,
97
- and the next step stay in the project for the next session to read.
98
-
99
- **Leave something the next session can pick up.**
100
-
101
- LitClaude adds evidence-first execution, planning, research and review to Claude Code.
102
- Install its plugin and managed HUD once, then work in ordinary `claude` sessions.
103
-
104
53
  ## Install
105
54
 
106
55
  `@litfamily/litclaude` is the scoped package. You need Node.js/npm and Claude Code.
107
56
  For local validation, start with the
108
- [separate trial profile](./docs/migration.md#separate-trial-profile).
109
- If an existing installation returns `INSTALL_OWNERSHIP_CONFLICT`, stop retrying or
110
- moving directories and read the [ownership guidance](./docs/migration.md#ownership-conflicts).
57
+ [separate trial profile](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/docs/migration.md#separate-trial-profile).
111
58
 
112
59
  The default safe installation command is:
113
60
 
@@ -119,7 +66,7 @@ npm exec --yes --package @litfamily/litclaude@latest -- litclaude install --yes
119
66
  choose permissions, HUD accents or output styles explicitly when needed.
120
67
  See [installation reference](#installation-reference) for those options and a version pin.
121
68
 
122
- ## First use
69
+ ## Quick start
123
70
 
124
71
  Start Claude Code normally:
125
72
 
@@ -149,7 +96,45 @@ the hook; namespaced slash commands use Claude Code's native command surface and
149
96
  do not double-activate the hook. For an explicit skill invocation, use a route
150
97
  such as `/litclaude:lit-loop`.
151
98
 
152
- ## Carry the work forward
99
+ ## Key features
100
+
101
+ A spark has been placed in your hands. Give it somewhere to stay.
102
+
103
+ A bug you want fixed. A screen you want built. A project you want to finish.
104
+
105
+ Starting takes a sentence. Then the conversation grows, the session ends, and you
106
+ have to work out where you left off: what you decided, what you checked, what comes next.
107
+
108
+ **LIT leaves that spark with the work.** A goal, a plan, the results you checked,
109
+ and the next step stay in the project for the next session to read.
110
+
111
+ **Leave something the next session can pick up.**
112
+
113
+ LitClaude adds evidence-first execution, planning, research and review to Claude Code.
114
+ Install its plugin and managed HUD once, then work in ordinary `claude` sessions.
115
+
116
+ ## Core routes
117
+
118
+ ### Start with one lit task
119
+
120
+ Append `lit` to the end of a prompt to activate the Claude Code hook. It supplies routing guidance; Claude Code still performs the work.
121
+
122
+ | Prompt or route | Effect |
123
+ | --- | --- |
124
+ | `lit` | Activate the evidence-first work loop in the current Claude Code conversation. |
125
+ | `handoff` | Carry the checked result and next step into another session. |
126
+ | `lit-plan` | Write a bounded plan and its checks before implementation. |
127
+ | `/litclaude:start-work <approved-plan>` | Execute a plan that has already been approved. |
128
+ | `review-work` | Read the change and evidence, then report remaining work. |
129
+ | `litresearch` | Research with sources; this route records facts and uncertainty separately. |
130
+
131
+ The hook marks entry into the workflow; it does not prove that a task or browser check finished.
132
+
133
+ <p align="center"><a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/docs/assets/readme/ignition-film.mp4"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/docs/assets/readme/ignition-poster.png" width="720" alt="Ignition motion poster" /></a></p>
134
+
135
+ The poster opens the optional Ignition film; this README keeps motion opt-in.
136
+
137
+ ### Carry the work forward
153
138
 
154
139
  ```text
155
140
  Plan → Build → Check → Hand off
@@ -165,13 +150,102 @@ Plan → Build → Check → Hand off
165
150
  Goal-bound work records its state under the project's `.litclaude/litgoal/`.
166
151
  Keep the **actual file path** returned by the handoff. In a new session, open the same
167
152
  project and ask Claude to read that file, check the current state, and identify the
168
- next action. Then choose what to continue. The [goal and ledger reference](./docs/migration.md#review-and-litgoal-parity)
153
+ next action. Then choose what to continue. The [goal and ledger reference](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/docs/migration.md#review-and-litgoal-parity)
169
154
  explains the recording commands and host boundaries.
170
155
 
171
156
  The lasting spark means leaving work another session can pick up. It does not mean
172
157
  a process runs forever or automatically resumes after the session closes. Read the
173
158
  record and compare it with the current files before continuing.
174
159
 
160
+ ### Full route catalog
161
+
162
+ | Type this | Purpose |
163
+ | --- | --- |
164
+ | `lit`, `litwork` | Evidence-first, test-first execution loop; also `$lit-loop`, `/lit-loop`, and `/litclaude:lit-loop` |
165
+ | `lit plan <what>` | Planning only; also `$lit-plan` and `/lit-plan` |
166
+ | `lit review <scope>` | Review a plan or completed work; also `$review-work` and `/review-work` |
167
+ | `lit research <question>` | Cited public-source research; also `$litresearch` and `/litclaude:litresearch` |
168
+ | `lit search <question>` | Public-source retrieval |
169
+ | `lit query <question>` | Evidence lookup against durable local state |
170
+ | `lit goal <outcome>` | Bind one objective and checkable criteria; also `$litgoal` and `/litgoal` |
171
+ | `lit workflow <objective>` | Propose a Dynamic workflow for broad delegated work |
172
+ | `lit team`, `lit teammates` | Propose native agent teams when `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` is enabled and the user approves |
173
+ | `$deep-interview`, `/deep-interview` | Turn an underspecified request into a decision-complete brief |
174
+ | `lit recap`, `litrecap`, `$lit-recap`, `/lit-recap`, `/litclaude:lit-recap` | Read-only session recap |
175
+ | `handoff`, `/litclaude:lit-handoff` | Write a verified continuation packet |
176
+ | `lit-scientific-visualization` | Prepare publication figures; also `/litclaude:lit-scientific-visualization` |
177
+ | `litclaude wikify <capture/save/review/query/config>` | Manage reviewed local structured knowledge |
178
+ | `browser-drive`, `$browser-drive` | Drive a real page only after a capability probe verifies an external driver; never substitute a fetch, use credentials, or install without approval |
179
+
180
+ Named workflow skills include `lit-crucible` (adversarial planning), `lit-init`
181
+ (repository guidance), `lit-commit` (Git history), `lit-team` (native teams),
182
+ `lit-burnoff` (change-set cleanup), `lit-burnoff-file` (single-file cleanup),
183
+ `lit-korean` (Korean prose), and `lit-code` (implementation discipline).
184
+ Use the leading bare name or `$<skill-id>`. Previous typed names remain aliases
185
+ for one release and emit a deprecation note; see [the alias migration table](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/docs/migration.md#one-release-rename-aliases).
186
+
187
+ ## Troubleshooting
188
+
189
+ If an existing installation returns `INSTALL_OWNERSHIP_CONFLICT`, stop retrying or
190
+ moving directories and read the [ownership guidance](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/docs/migration.md#ownership-conflicts).
191
+
192
+ ### Verify and uninstall
193
+
194
+ The installed package also exposes these useful commands:
195
+
196
+ ```bash
197
+ npm exec --yes --package @litfamily/litclaude@latest -- litclaude doctor
198
+ npm exec --yes --package @litfamily/litclaude@latest -- litclaude --version
199
+ npm exec --yes --package @litfamily/litclaude@latest -- litclaude path
200
+ npm exec --yes --package @litfamily/litclaude@latest -- litclaude workflow-check --json
201
+ npm exec --yes --package @litfamily/litclaude@latest -- litclaude update
202
+ npm exec --yes --package @litfamily/litclaude@latest -- litclaude uninstall
203
+ ```
204
+
205
+ `uninstall` removes only LitClaude-managed plugin, HUD, permission, and local
206
+ state entries. It does not remove unrelated Claude settings. Modified or unrecognized
207
+ installations are preserved and refused; follow the [ownership guidance](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/docs/migration.md#ownership-conflicts).
208
+ After a separate-profile trial, close that Claude session and terminal and return to
209
+ your original terminal environment. Your previous installation needs no downgrade
210
+ or reinstall.
211
+
212
+ ## Links
213
+
214
+ <a id="deeper-docs"></a>
215
+
216
+ - [Operational reference](#operational-reference)
217
+ - [Hook triggers and activation boundaries](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/docs/hooks.md)
218
+ - [Agent and orchestration guidance](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/docs/agents.md)
219
+ - [Workflow migration table](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/docs/migration.md)
220
+ - [Native `/goal` surface matrix](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/docs/native-goal-surface.md)
221
+ - [Workflow compatibility audit](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/docs/workflow-compatibility-audit.md)
222
+ - [Package-name migration and marketplace choices](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/docs/migration.md#scoped-npm-migration)
223
+ - [Contributing](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/CONTRIBUTING.md) · [Support](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/SUPPORT.md) · [Security](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/SECURITY.md)
224
+ - [Code of conduct](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/CODE_OF_CONDUCT.md) · [Privacy and network behavior](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/docs/privacy.md)
225
+ - [Release history](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/CHANGELOG.md)
226
+ - [Korean README](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/README_ko-KR.md)
227
+
228
+ ### LITFAMILY
229
+
230
+ <details>
231
+ <summary>More workflows and references</summary>
232
+
233
+ ## Practical routes and visual cues
234
+
235
+ Use `lit` to activate the evidence-first loop, `handoff` to carry checked work forward,
236
+ `lit-plan` to write a bounded plan, `/litclaude:start-work <approved-plan>` to execute an
237
+ approved plan, `review-work` to inspect changes and evidence, and `litresearch` to keep sources
238
+ and uncertainty separate. Each route leaves its expected effect in the project record; no new
239
+ slash route is introduced here. Host limit: Claude Code owns the hook and model execution, while
240
+ permissions, browser access, and visual checks remain host capabilities. A hook mark or static
241
+ editorial image is not completion evidence.
242
+
243
+ <p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/docs/assets/litclaude-ignition-1600.webp" width="49%" alt="LitClaude ignition editorial cue" /> <img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/docs/assets/litclaude-continuity-1600.webp" width="49%" alt="LitClaude continuity editorial cue" /></p>
244
+
245
+ The retained `docs/assets/readme/ascii-readme.svg` and `docs/assets/cover.svg` remain editable or low-bandwidth fallbacks; the WebP above is the product emphasis export.
246
+
247
+
248
+
175
249
  ## Inside Claude Code
176
250
 
177
251
  A plain prompt and a slash command enter through different surfaces. Hooks pass
@@ -194,45 +268,32 @@ flowchart TD
194
268
  ```
195
269
 
196
270
  Hook guidance alone does not prove that a skill ran. The next session must read
197
- the saved file and check the actual state. See the [hook reference](./docs/hooks.md)
198
- and [goal recording reference](./docs/migration.md#review-and-litgoal-parity) for the boundaries.
271
+ the saved file and check the actual state. See the [hook reference](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/docs/hooks.md)
272
+ and [goal recording reference](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/docs/migration.md#review-and-litgoal-parity) for the boundaries.
199
273
 
200
274
  <details>
201
275
  <summary>LITFAMILY · five armored machines</summary>
202
276
 
203
- ![Concept art showing the five LIT products as armored machines](./docs/assets/litfamily-machines.png)
277
+ ![Concept art showing the five LIT products as armored machines](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/docs/assets/litfamily-machines.png)
204
278
 
205
279
  Five armored machines: LitClaude, LitHermes, LitCodex, LitOpenCode, and LitGrok.
206
280
  Concept art; each product runs in its own host.
207
281
 
208
282
  </details>
209
283
 
210
- ## Core routes
284
+ ## Design and README production
211
285
 
212
- | Type this | Purpose |
213
- | --- | --- |
214
- | `lit`, `litwork` | Evidence-first, test-first execution loop; also `$lit-loop`, `/lit-loop`, and `/litclaude:lit-loop` |
215
- | `lit plan <what>` | Planning only; also `$lit-plan` and `/lit-plan` |
216
- | `lit review <scope>` | Review a plan or completed work; also `$review-work` and `/review-work` |
217
- | `lit research <question>` | Cited public-source research; also `$litresearch` and `/litclaude:litresearch` |
218
- | `lit search <question>` | Public-source retrieval |
219
- | `lit query <question>` | Evidence lookup against durable local state |
220
- | `lit goal <outcome>` | Bind one objective and checkable criteria; also `$litgoal` and `/litgoal` |
221
- | `lit workflow <objective>` | Propose a Dynamic workflow for broad delegated work |
222
- | `lit team`, `lit teammates` | Propose native agent teams when `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` is enabled and the user approves |
223
- | `$deep-interview`, `/deep-interview` | Turn an underspecified request into a decision-complete brief |
224
- | `lit recap`, `litrecap`, `$lit-recap`, `/lit-recap`, `/litclaude:lit-recap` | Read-only session recap |
225
- | `handoff`, `/litclaude:lit-handoff` | Write a verified continuation packet |
226
- | `lit-scientific-visualization` | Prepare publication figures; also `/litclaude:lit-scientific-visualization` |
227
- | `litclaude wikify <capture/save/review/query/config>` | Manage reviewed local structured knowledge |
228
- | `browser-drive`, `$browser-drive` | Drive a real page only after a capability probe verifies an external driver; never substitute a fetch, use credentials, or install without approval |
286
+ Use `frontend-ui-ux build <target>` for an authorized working interface and rendered
287
+ inspection. Material ambiguity prompts a targeted question; answers carry forward into
288
+ the build. Explicit review or plan requests remain read-only.
229
289
 
230
- Named workflow skills include `lit-crucible` (adversarial planning), `lit-init`
231
- (repository guidance), `lit-commit` (Git history), `lit-team` (native teams),
232
- `lit-burnoff` (change-set cleanup), `lit-burnoff-file` (single-file cleanup),
233
- `lit-korean` (Korean prose), and `lit-code` (implementation discipline).
234
- Use the leading bare name or `$<skill-id>`. Previous typed names remain aliases
235
- for one release and emit a deprecation note; see [the alias migration table](./docs/migration.md#one-release-rename-aliases).
290
+ Use `readme-studio <repository or README scope>` or `$readme-studio` for a factual
291
+ README and local cover production. Claude Code's available tools determine image
292
+ generation: `IMAGE_GENERATION_UNAVAILABLE` is explicit, and an inspected supplied
293
+ background can enable the remaining composition. Bundled helpers support outlined
294
+ Pretendard/Meslo typography and pinned local motion recipes. Fonts, renderer licenses
295
+ and actual output are checked; hosted GitHub/npm display remains a later gate.
296
+ These are native skill/leading-token routes, with no new slash-command file.
236
297
 
237
298
  ## Safety
238
299
 
@@ -250,44 +311,19 @@ for one release and emit a deprecation note; see [the alias migration table](./d
250
311
  - Publishing, version changes, tags, and remote marketplace changes require
251
312
  explicit user approval.
252
313
 
253
- Model selection is host-owned. Native `Workflow` and experimental agent teams need
254
- explicit opt-in; the durable `litgoal` ledger remains authoritative when native goal
255
- tools are unavailable. LitClaude never sends `/goal` on your behalf.
256
-
257
- ## Verify and uninstall
258
-
259
- The installed package also exposes these useful commands:
260
-
261
- ```bash
262
- npm exec --yes --package @litfamily/litclaude@latest -- litclaude doctor
263
- npm exec --yes --package @litfamily/litclaude@latest -- litclaude --version
264
- npm exec --yes --package @litfamily/litclaude@latest -- litclaude path
265
- npm exec --yes --package @litfamily/litclaude@latest -- litclaude workflow-check --json
266
- npm exec --yes --package @litfamily/litclaude@latest -- litclaude update
267
- npm exec --yes --package @litfamily/litclaude@latest -- litclaude uninstall
268
- ```
269
-
270
- `uninstall` removes only LitClaude-managed plugin, HUD, permission, and local
271
- state entries. It does not remove unrelated Claude settings. Modified or unrecognized
272
- installations are preserved and refused; follow the [ownership guidance](./docs/migration.md#ownership-conflicts).
273
- After a separate-profile trial, close that Claude session and terminal and return to
274
- your original terminal environment. Your previous installation needs no downgrade
275
- or reinstall.
276
-
277
- ## Deeper docs
278
-
279
- - [Operational reference](#operational-reference)
280
- - [Hook triggers and activation boundaries](./docs/hooks.md)
281
- - [Agent and orchestration guidance](./docs/agents.md)
282
- - [Workflow migration table](./docs/migration.md)
283
- - [Native `/goal` surface matrix](./docs/native-goal-surface.md)
284
- - [Workflow compatibility audit](./docs/workflow-compatibility-audit.md)
285
- - [Package-name migration and marketplace choices](./docs/migration.md#scoped-npm-migration)
286
- - [Contributing](./CONTRIBUTING.md) · [Support](./SUPPORT.md) · [Security](./SECURITY.md)
287
- - [Code of conduct](./CODE_OF_CONDUCT.md) · [Privacy and network behavior](./docs/privacy.md)
288
- - [Release checklist](./RELEASE_CHECKLIST.md)
289
- - [Release history](./CHANGELOG.md)
290
- - [Korean README](./README_ko-KR.md)
314
+ Model selection is host-owned. Across LitFamily products that own OpenAI routing, new
315
+ installs default to GPT-6: `gpt-6-astra` for planning, review, and lead roles,
316
+ `gpt-6-sol` as the coding-lead alternative, and `gpt-6-luna` for helpers and ordinary
317
+ workers. GPT-6 Luna supports `xhigh` but not `ultra`. The live host catalog still lists
318
+ `gpt-5.6-sol`, `gpt-5.6-terra`, and `gpt-5.6-luna` as selectable, with no retirement
319
+ date for any of them. The catalog supports `xhigh` for `gpt-5.6-luna` too, but LitClaude
320
+ keeps a legacy policy-only block for that combination; `gpt-6-luna` at `xhigh` remains
321
+ catalog-supported while the approved ordinary-worker default stays `max`. Install and
322
+ update leave an existing model selection unchanged.
323
+ LitClaude does not apply those OpenAI routes; Claude Code owns model selection. Native
324
+ `Workflow` and experimental agent teams need explicit opt-in; the durable `litgoal` ledger
325
+ remains authoritative when native goal tools are unavailable. LitClaude never
326
+ sends `/goal` on your behalf.
291
327
 
292
328
  <details>
293
329
  <summary>Operational reference — installation options, learning, host boundaries and development</summary>
@@ -303,7 +339,7 @@ or reinstall.
303
339
  - **Claude skills** also include `litwork`, `structural-search`, `lit-team`,
304
340
  `autoresearch`, and `autoconference`. The core sequence is
305
341
  `lit-plan`, `lit-recap`, `lit-loop`.
306
- - Auxiliary Skill-discovery entries `frontend-ui-ux`, `lit-commit`, `lsp-setup`,
342
+ - Auxiliary Skill-discovery entries `frontend-ui-ux`, `readme-studio`, `lit-commit`, `lsp-setup`,
307
343
  and `visual-qa` answer to a leading bare token or `$frontend-ui-ux`; they are
308
344
  not anywhere-tokens.
309
345
  - Bundled reference packs include `lit-code/references`,
@@ -355,13 +391,13 @@ npm exec --yes --package @litfamily/litclaude@latest -- litclaude install
355
391
  For a reproducible install, pin the current package version:
356
392
 
357
393
  ```bash
358
- npm view @litfamily/litclaude@1.0.8 version
394
+ npm view @litfamily/litclaude@1.0.10 version
359
395
  ```
360
396
 
361
- If that lookup returns `1.0.8`, the exact install is available:
397
+ If that lookup returns `1.0.10`, the exact install is available:
362
398
 
363
399
  ```bash
364
- npm exec --yes --package @litfamily/litclaude@1.0.8 -- litclaude install
400
+ npm exec --yes --package @litfamily/litclaude@1.0.10 -- litclaude install
365
401
  ```
366
402
 
367
403
  Otherwise, wait for explicit human publication before using that pin. Check the
@@ -444,7 +480,7 @@ litclaude install
444
480
 
445
481
  ## Claude Code integration
446
482
 
447
- **Where Claude Code hands control to LitClaude.** Session and tool events feed the rules, routing, authority, and ledger surfaces; together they expose the package's 33 skills, 16 current commands, two hidden compatibility redirects, and 11 agents without hiding the host boundary.
483
+ **Where Claude Code hands control to LitClaude.** Session and tool events feed the rules, routing, authority, and ledger surfaces; together they expose the package's 34 skills, 16 current commands, two hidden compatibility redirects, and 11 agents without hiding the host boundary.
448
484
 
449
485
  ```mermaid
450
486
  flowchart LR
@@ -465,7 +501,7 @@ flowchart LR
465
501
  H5 --> LEDGER
466
502
  H6 --> LEDGER
467
503
  H7 --> LEDGER
468
- LC --> S["33 skills · 16 commands · 11 agents"]
504
+ LC --> S["34 skills · 16 commands · 11 agents"]
469
505
  ```
470
506
 
471
507
  **Why a fresh install can still execute the skills.** A self-contained skill needs an explicit allowlist reason, while a skill that names a corpus must carry that corpus inside the packed tarball. These payload gates prevent a checkout-only reference from becoming a user's runtime failure.
@@ -593,6 +629,8 @@ Reload plugin metadata inside Claude Code with:
593
629
 
594
630
  This is a brand film, not a recording of the plugin in use. Select the static poster to play it.
595
631
 
596
- [![Ignition motion graphic](./docs/assets/readme/ignition-poster.png)](./docs/assets/readme/ignition-film.mp4)
632
+ [![Ignition motion graphic](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/docs/assets/readme/ignition-poster.png)](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/docs/assets/readme/ignition-film.mp4)
633
+
634
+ [Animated version (GIF)](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/docs/assets/readme/ignition-readme.gif) · [Lucide icon license (ISC)](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/docs/assets/readme/Lucide-LICENSE.txt) · [JetBrains Mono font license (OFL)](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.10/docs/assets/readme/JetBrainsMono-OFL.txt)
597
635
 
598
- [Animated version (GIF)](./docs/assets/readme/ignition-readme.gif) · [Lucide icon license (ISC)](./docs/assets/readme/Lucide-LICENSE.txt) · [JetBrains Mono font license (OFL)](./docs/assets/readme/JetBrainsMono-OFL.txt)
636
+ </details>