@litfamily/litclaude 1.0.8 → 1.0.9

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 +7 -0
  2. package/README.md +179 -139
  3. package/README_ko-KR.md +175 -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,12 @@
1
1
  # Changelog
2
2
 
3
+ ## 1.0.9
4
+
5
+ - Add README Studio with visual decoration patterns, cover depth, and a bounded multi-round design interview.
6
+ - Move new LitClaude OpenAI planning, review, lead, and helper routes to the GPT-6 family defaults.
7
+ - Align the English and Korean README pages to the family layout and pin npm-served asset URLs to this package version.
8
+ - Compare the ignition mark after stripping terminal color so the activation test checks visible text across styles.
9
+
3
10
  ## 1.0.8
4
11
 
5
12
  - 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.9/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/docs/assets/cover-motion.webp" width="100%" alt="LitClaude cover art. An orange signal moves through orbital paths above the CLAUDE CODE wordmark. Reduced-motion users see a still frame from this motion cover." /></picture></p>
2
+ <p align="center"><a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/docs/assets/cover.webp">View the static cover</a></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.9/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.9/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.9/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.9/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.9/docs/assets/readme/badge-version.svg" alt="1.0.9" />
46
+ <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/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.9/docs/assets/readme/lucide-book-open.svg" width="16" alt="" /> Docs</a> · <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/docs/assets/readme/ignition-film.mp4"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/docs/assets/readme/lucide-play.svg" width="16" alt="" /> Ignition</a> · <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/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.9/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.9/docs/assets/readme/ignition-film.mp4"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/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,104 @@ 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.9/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.9/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.9/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.9/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.9/docs/hooks.md)
218
+ - [Agent and orchestration guidance](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/docs/agents.md)
219
+ - [Workflow migration table](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/docs/migration.md)
220
+ - [Native `/goal` surface matrix](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/docs/native-goal-surface.md)
221
+ - [Workflow compatibility audit](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/docs/workflow-compatibility-audit.md)
222
+ - [Package-name migration and marketplace choices](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/docs/migration.md#scoped-npm-migration)
223
+ - [Contributing](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/CONTRIBUTING.md) · [Support](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/SUPPORT.md) · [Security](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/SECURITY.md)
224
+ - [Code of conduct](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/CODE_OF_CONDUCT.md) · [Privacy and network behavior](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/docs/privacy.md)
225
+ - [Release history](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/CHANGELOG.md)
226
+ - [Korean README](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/README_ko-KR.md)
227
+
228
+ ### LITFAMILY
229
+
230
+ <p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/docs/assets/cover.webp" width="100%" alt="Five LitFamily robot companions beneath the words KEEP THE WORK LIT." /></p>
231
+
232
+ <details>
233
+ <summary>More workflows and references</summary>
234
+
235
+ ## Practical routes and visual cues
236
+
237
+ Use `lit` to activate the evidence-first loop, `handoff` to carry checked work forward,
238
+ `lit-plan` to write a bounded plan, `/litclaude:start-work <approved-plan>` to execute an
239
+ approved plan, `review-work` to inspect changes and evidence, and `litresearch` to keep sources
240
+ and uncertainty separate. Each route leaves its expected effect in the project record; no new
241
+ slash route is introduced here. Host limit: Claude Code owns the hook and model execution, while
242
+ permissions, browser access, and visual checks remain host capabilities. A hook mark or static
243
+ editorial image is not completion evidence.
244
+
245
+ <p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/docs/assets/litclaude-ignition-1600.webp" width="49%" alt="LitClaude ignition editorial cue" /> <img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/docs/assets/litclaude-continuity-1600.webp" width="49%" alt="LitClaude continuity editorial cue" /></p>
246
+
247
+ 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.
248
+
249
+
250
+
175
251
  ## Inside Claude Code
176
252
 
177
253
  A plain prompt and a slash command enter through different surfaces. Hooks pass
@@ -194,45 +270,32 @@ flowchart TD
194
270
  ```
195
271
 
196
272
  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.
273
+ the saved file and check the actual state. See the [hook reference](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/docs/hooks.md)
274
+ and [goal recording reference](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/docs/migration.md#review-and-litgoal-parity) for the boundaries.
199
275
 
200
276
  <details>
201
277
  <summary>LITFAMILY · five armored machines</summary>
202
278
 
203
- ![Concept art showing the five LIT products as armored machines](./docs/assets/litfamily-machines.png)
279
+ ![Concept art showing the five LIT products as armored machines](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/docs/assets/litfamily-machines.png)
204
280
 
205
281
  Five armored machines: LitClaude, LitHermes, LitCodex, LitOpenCode, and LitGrok.
206
282
  Concept art; each product runs in its own host.
207
283
 
208
284
  </details>
209
285
 
210
- ## Core routes
286
+ ## Design and README production
211
287
 
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 |
288
+ Use `frontend-ui-ux build <target>` for an authorized working interface and rendered
289
+ inspection. Material ambiguity prompts a targeted question; answers carry forward into
290
+ the build. Explicit review or plan requests remain read-only.
229
291
 
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).
292
+ Use `readme-studio <repository or README scope>` or `$readme-studio` for a factual
293
+ README and local cover production. Claude Code's available tools determine image
294
+ generation: `IMAGE_GENERATION_UNAVAILABLE` is explicit, and an inspected supplied
295
+ background can enable the remaining composition. Bundled helpers support outlined
296
+ Pretendard/Meslo typography and pinned local motion recipes. Fonts, renderer licenses
297
+ and actual output are checked; hosted GitHub/npm display remains a later gate.
298
+ These are native skill/leading-token routes, with no new slash-command file.
236
299
 
237
300
  ## Safety
238
301
 
@@ -250,44 +313,19 @@ for one release and emit a deprecation note; see [the alias migration table](./d
250
313
  - Publishing, version changes, tags, and remote marketplace changes require
251
314
  explicit user approval.
252
315
 
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)
316
+ Model selection is host-owned. Across LitFamily products that own OpenAI routing, new
317
+ installs default to GPT-6: `gpt-6-astra` for planning, review, and lead roles,
318
+ `gpt-6-sol` as the coding-lead alternative, and `gpt-6-luna` for helpers and ordinary
319
+ workers. GPT-6 Luna supports `xhigh` but not `ultra`. The live host catalog still lists
320
+ `gpt-5.6-sol`, `gpt-5.6-terra`, and `gpt-5.6-luna` as selectable, with no retirement
321
+ date for any of them. The catalog supports `xhigh` for `gpt-5.6-luna` too, but LitClaude
322
+ keeps a legacy policy-only block for that combination; `gpt-6-luna` at `xhigh` remains
323
+ catalog-supported while the approved ordinary-worker default stays `max`. Install and
324
+ update leave an existing model selection unchanged.
325
+ LitClaude does not apply those OpenAI routes; Claude Code owns model selection. Native
326
+ `Workflow` and experimental agent teams need explicit opt-in; the durable `litgoal` ledger
327
+ remains authoritative when native goal tools are unavailable. LitClaude never
328
+ sends `/goal` on your behalf.
291
329
 
292
330
  <details>
293
331
  <summary>Operational reference — installation options, learning, host boundaries and development</summary>
@@ -303,7 +341,7 @@ or reinstall.
303
341
  - **Claude skills** also include `litwork`, `structural-search`, `lit-team`,
304
342
  `autoresearch`, and `autoconference`. The core sequence is
305
343
  `lit-plan`, `lit-recap`, `lit-loop`.
306
- - Auxiliary Skill-discovery entries `frontend-ui-ux`, `lit-commit`, `lsp-setup`,
344
+ - Auxiliary Skill-discovery entries `frontend-ui-ux`, `readme-studio`, `lit-commit`, `lsp-setup`,
307
345
  and `visual-qa` answer to a leading bare token or `$frontend-ui-ux`; they are
308
346
  not anywhere-tokens.
309
347
  - Bundled reference packs include `lit-code/references`,
@@ -355,13 +393,13 @@ npm exec --yes --package @litfamily/litclaude@latest -- litclaude install
355
393
  For a reproducible install, pin the current package version:
356
394
 
357
395
  ```bash
358
- npm view @litfamily/litclaude@1.0.8 version
396
+ npm view @litfamily/litclaude@1.0.9 version
359
397
  ```
360
398
 
361
- If that lookup returns `1.0.8`, the exact install is available:
399
+ If that lookup returns `1.0.9`, the exact install is available:
362
400
 
363
401
  ```bash
364
- npm exec --yes --package @litfamily/litclaude@1.0.8 -- litclaude install
402
+ npm exec --yes --package @litfamily/litclaude@1.0.9 -- litclaude install
365
403
  ```
366
404
 
367
405
  Otherwise, wait for explicit human publication before using that pin. Check the
@@ -444,7 +482,7 @@ litclaude install
444
482
 
445
483
  ## Claude Code integration
446
484
 
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.
485
+ **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
486
 
449
487
  ```mermaid
450
488
  flowchart LR
@@ -465,7 +503,7 @@ flowchart LR
465
503
  H5 --> LEDGER
466
504
  H6 --> LEDGER
467
505
  H7 --> LEDGER
468
- LC --> S["33 skills · 16 commands · 11 agents"]
506
+ LC --> S["34 skills · 16 commands · 11 agents"]
469
507
  ```
470
508
 
471
509
  **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 +631,8 @@ Reload plugin metadata inside Claude Code with:
593
631
 
594
632
  This is a brand film, not a recording of the plugin in use. Select the static poster to play it.
595
633
 
596
- [![Ignition motion graphic](./docs/assets/readme/ignition-poster.png)](./docs/assets/readme/ignition-film.mp4)
634
+ [![Ignition motion graphic](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/docs/assets/readme/ignition-poster.png)](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/docs/assets/readme/ignition-film.mp4)
635
+
636
+ [Animated version (GIF)](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/docs/assets/readme/ignition-readme.gif) · [Lucide icon license (ISC)](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/docs/assets/readme/Lucide-LICENSE.txt) · [JetBrains Mono font license (OFL)](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.9/docs/assets/readme/JetBrainsMono-OFL.txt)
597
637
 
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)
638
+ </details>