@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.
- package/CHANGELOG.md +11 -0
- package/README.md +177 -139
- package/README_ko-KR.md +173 -119
- package/docs/agents.md +30 -8
- package/docs/assets/cover-motion-still.webp +0 -0
- package/docs/assets/cover-motion.webp +0 -0
- package/docs/assets/litclaude-continuity-1600.webp +0 -0
- package/docs/assets/litclaude-ignition-1600.webp +0 -0
- package/docs/assets/litfamily-machines.png +0 -0
- package/docs/assets/readme/JetBrainsMono-OFL.txt +93 -0
- package/docs/assets/readme/Lucide-LICENSE.txt +43 -0
- package/docs/assets/readme/ascii-readme.svg +5 -0
- package/docs/assets/readme/badge-version.svg +1 -1
- package/docs/assets/readme/ignition-film.mp4 +0 -0
- package/docs/assets/readme/ignition-poster.png +0 -0
- package/docs/assets/readme/ignition-readme.gif +0 -0
- package/docs/assets/readme/lucide-book-open.svg +14 -0
- package/docs/assets/readme/lucide-play.svg +13 -0
- package/docs/assets/readme/lucide-shield-check.svg +14 -0
- package/docs/hooks.md +16 -0
- package/package.json +14 -1
- package/plugins/litclaude/.claude-plugin/plugin.json +1 -1
- package/plugins/litclaude/bin/litclaude-hook.js +4 -2
- package/plugins/litclaude/bin/litclaude-mcp.js +1 -1
- package/plugins/litclaude/lib/canonical-skill-catalog.mjs +1 -0
- package/plugins/litclaude/lib/canonical-skill-resources.mjs +25 -2
- package/plugins/litclaude/skills/frontend-ui-ux/SKILL.md +21 -12
- package/plugins/litclaude/skills/frontend-ui-ux/references/complete-contract.md +8 -9
- package/plugins/litclaude/skills/frontend-ui-ux/references/default-editorial-pixel.json +21 -0
- package/plugins/litclaude/skills/frontend-ui-ux/references/production-interview.md +17 -0
- package/plugins/litclaude/skills/readme-studio/SKILL.md +86 -0
- package/plugins/litclaude/skills/readme-studio/references/decoration-and-navigation.md +55 -0
- package/plugins/litclaude/skills/readme-studio/references/facts-and-assembly.md +19 -0
- package/plugins/litclaude/skills/readme-studio/references/production-interview.md +11 -0
- package/plugins/litclaude/skills/readme-studio/references/render-and-deliver.md +44 -0
- package/plugins/litclaude/skills/readme-studio/references/type-and-background.md +23 -0
- package/plugins/litclaude/skills/readme-studio/scripts/validate-readme-facts.mjs +28 -0
- package/plugins/litclaude/skills/readme-studio/templates/cover-source.json +21 -0
- package/plugins/litclaude/skills/readme-studio/templates/hyperframes-cover/index.html +30 -0
- package/plugins/litclaude/skills/readme-studio/templates/hyperframes-cover/index.motion.json +1 -0
- package/plugins/litclaude/skills/readme-studio/templates/hyperframes-cover/package-lock.json +1969 -0
- package/plugins/litclaude/skills/readme-studio/templates/hyperframes-cover/package.json +8 -0
- package/plugins/litclaude/skills/readme-studio/templates/readme-cover-section.md +75 -0
- package/plugins/litclaude/skills/readme-studio/templates/readme-facts.json +4 -0
- package/plugins/litclaude/skills/readme-studio/templates/remotion-cover/package-lock.json +3783 -0
- package/plugins/litclaude/skills/readme-studio/templates/remotion-cover/package.json +7 -0
- package/plugins/litclaude/skills/readme-studio/templates/remotion-cover/src/index.tsx +36 -0
- package/plugins/litclaude/skills/readme-studio/templates/typography/package-lock.json +133 -0
- package/plugins/litclaude/skills/readme-studio/templates/typography/package.json +6 -0
- package/plugins/litclaude/skills/readme-studio/templates/typography/safe-files.mjs +57 -0
- package/plugins/litclaude/skills/readme-studio/templates/typography/shape-text-to-svg.mjs +47 -0
- 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.
|
|
2
|
-
<p align="center"><
|
|
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="#
|
|
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="
|
|
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.
|
|
43
|
-
<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.
|
|
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.
|
|
47
|
-
<a href="
|
|
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="
|
|
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](
|
|
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
|
-
##
|
|
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
|
-
##
|
|
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](
|
|
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](
|
|
198
|
-
and [goal recording reference](
|
|
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
|
-

|
|
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
|
-
##
|
|
284
|
+
## Design and README production
|
|
211
285
|
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
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
|
-
|
|
231
|
-
|
|
232
|
-
`
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
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.
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
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.
|
|
394
|
+
npm view @litfamily/litclaude@1.0.10 version
|
|
359
395
|
```
|
|
360
396
|
|
|
361
|
-
If that lookup returns `1.0.
|
|
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.
|
|
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
|
|
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["
|
|
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
|
-
[](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
|
-
|
|
636
|
+
</details>
|