@litfamily/litclaude 1.0.7 → 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.
- package/CHANGELOG.md +15 -2
- package/README.md +186 -139
- package/README_ko-KR.md +182 -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 +26 -10
- package/package.json +14 -1
- package/plugins/litclaude/.claude-plugin/plugin.json +1 -1
- package/plugins/litclaude/bin/litclaude-hook.js +55 -10
- package/plugins/litclaude/bin/litclaude-hud.js +5 -1
- package/plugins/litclaude/bin/litclaude-mcp.js +1 -1
- package/plugins/litclaude/commands/lit-handoff.md +3 -3
- package/plugins/litclaude/commands/lit-scientific-visualization.md +2 -2
- package/plugins/litclaude/lib/canonical-skill-catalog.mjs +1 -0
- package/plugins/litclaude/lib/canonical-skill-resources.mjs +26 -3
- package/plugins/litclaude/lib/hud-accent-palette.mjs +2 -2
- package/plugins/litclaude/lib/hud-ignition.mjs +74 -0
- 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/lit-handoff/SKILL.md +2 -2
- package/plugins/litclaude/skills/lit-scientific-visualization/SKILL.md +3 -3
- package/plugins/litclaude/skills/litwork/SKILL.md +2 -2
- 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/scripts/qa-real-surface-lib.mjs +3 -2
- package/scripts/strip-ansi.mjs +1 -0
- package/tools/check-model-routing.mjs +6 -6
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,18 @@
|
|
|
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
|
+
|
|
10
|
+
## 1.0.8
|
|
11
|
+
|
|
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.
|
|
13
|
+
- Show a bold, ignition-orange `🔥 LIT IGNITED · <discipline> 🔥` mark in the HUD status line whenever the prompt hook activates a LitClaude discipline. The prompt hook records the selected discipline per session under `litclaude-hud/` in the per-user temp directory (`LITCLAUDE_HUD_STATE_ROOT` overrides it; the repository state root and home directory stay untouched), and the HUD reads that record back, so the mark reflects the hook's decision rather than model output. Turns without an activation clear the record and the mark disappears.
|
|
14
|
+
- Ask model replies to start with `🔥 **LIT IGNITED · <discipline>** 🔥`, while hook messages and the HUD render the same activation mark without Markdown.
|
|
15
|
+
|
|
3
16
|
## 1.0.7
|
|
4
17
|
|
|
5
18
|
- Add the animated cover to both README pages, with a static cover for reduced-motion settings.
|
|
@@ -85,9 +98,9 @@
|
|
|
85
98
|
fallback, and plain text for non-UTF-8 or dumb terminals. Keep the install-plan
|
|
86
99
|
frame and add `--help`. Respect NO_COLOR, piped output, JSON, and CI.
|
|
87
100
|
- Render a standard mark once per session through the SessionStart system message
|
|
88
|
-
and
|
|
101
|
+
and an ignition mark with the discipline on prompt activation. Preserve the session
|
|
89
102
|
receipt across resume and compaction. Model replies begin with exactly one
|
|
90
|
-
|
|
103
|
+
`🔥 **LIT IGNITED · <discipline>** 🔥` probe line; the model does not redraw the harness logo.
|
|
91
104
|
Refresh skill-resource pins and verify runtime closures before the major version transition.
|
|
92
105
|
|
|
93
106
|
- Rename skills: `hyperplan` → `lit-crucible`, `init-deep` → `lit-init`,
|
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"><a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.
|
|
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="#
|
|
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="
|
|
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.
|
|
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.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.
|
|
47
|
-
<a href="
|
|
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="
|
|
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](
|
|
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
|
-
##
|
|
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.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](
|
|
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](
|
|
198
|
-
and [goal recording reference](
|
|
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
|
-

|
|
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
|
-
##
|
|
286
|
+
## Design and README production
|
|
211
287
|
|
|
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 |
|
|
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
|
-
|
|
231
|
-
|
|
232
|
-
`
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
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.
|
|
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)
|
|
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.
|
|
396
|
+
npm view @litfamily/litclaude@1.0.9 version
|
|
359
397
|
```
|
|
360
398
|
|
|
361
|
-
If that lookup returns `1.0.
|
|
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.
|
|
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
|
|
@@ -413,6 +451,13 @@ Interactive installation previews the available HUD accents. The LitClaude HUD
|
|
|
413
451
|
uses `[🔥LITCLAUDE vX.Y.Z]`, a compact `ctx [▎░░]` bar, and a `5h [▏░] 4% ↻`
|
|
414
452
|
rate-limit reset countdown. Set `LITCLAUDE_HUD_ACCENT` before installation to
|
|
415
453
|
choose an accent.
|
|
454
|
+
When the prompt hook activates a LitClaude discipline, the HUD adds a bold,
|
|
455
|
+
ignition-orange `🔥 LIT IGNITED · lit-loop 🔥` mark right after the brand until
|
|
456
|
+
the next turn without an activation; the hook records the selected discipline
|
|
457
|
+
per session under `litclaude-hud/` in the per-user temp directory, never in the
|
|
458
|
+
repository or your home directory (`LITCLAUDE_HUD_STATE_ROOT` overrides the location).
|
|
459
|
+
The reply starts with `🔥 **LIT IGNITED · <discipline>** 🔥`; the hook system
|
|
460
|
+
message and HUD display the same mark without Markdown.
|
|
416
461
|
|
|
417
462
|
HUD appearance and color capability are independent. By default (`dark`) the
|
|
418
463
|
model, context, usage, reset, and Git text carry the selected accent, usage
|
|
@@ -437,7 +482,7 @@ litclaude install
|
|
|
437
482
|
|
|
438
483
|
## Claude Code integration
|
|
439
484
|
|
|
440
|
-
**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
|
|
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.
|
|
441
486
|
|
|
442
487
|
```mermaid
|
|
443
488
|
flowchart LR
|
|
@@ -458,7 +503,7 @@ flowchart LR
|
|
|
458
503
|
H5 --> LEDGER
|
|
459
504
|
H6 --> LEDGER
|
|
460
505
|
H7 --> LEDGER
|
|
461
|
-
LC --> S["
|
|
506
|
+
LC --> S["34 skills · 16 commands · 11 agents"]
|
|
462
507
|
```
|
|
463
508
|
|
|
464
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.
|
|
@@ -586,6 +631,8 @@ Reload plugin metadata inside Claude Code with:
|
|
|
586
631
|
|
|
587
632
|
This is a brand film, not a recording of the plugin in use. Select the static poster to play it.
|
|
588
633
|
|
|
589
|
-
[](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)
|
|
590
637
|
|
|
591
|
-
|
|
638
|
+
</details>
|