@litfamily/litgrok 1.0.6 → 1.0.7
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/.grok/skills/frontend-ui-ux/references/production.md +1 -1
- package/.grok/skills/readme-studio/references/production.md +2 -0
- package/.grok-plugin/plugin.json +1 -1
- package/CHANGELOG.md +5 -0
- package/README.md +28 -29
- package/README_ko-KR.md +27 -28
- package/docs/assets/readme/badge-version.svg +1 -1
- package/docs/reference.md +1 -1
- package/docs/reference_ko-KR.md +1 -1
- package/package.json +1 -1
- package/plugin.json +1 -1
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
Build means a user authorized interface creation or changes in a named scope. Review and plan preserve files. Ask only when two plausible answers would materially change scope, architecture, permissions or data behavior, accessibility, or visual direction. When that ambiguity matters, ask one high-impact question at a time, with concrete choices and the consequence of each. Continue for as many rounds as materially necessary to resolve the direction before implementation; there is no fixed question count. Do not bundle separate decisions into one question.
|
|
6
6
|
|
|
7
|
-
Keep a task-local decision note with the known purpose/audience, target, constraints, every prior answer, unresolved material decisions, and the next action. After each reply, retain the answer in that note across rounds, update only the affected contract fields and rationale, then ask only about the next unresolved high-impact choice. On resume, read the note and actual file state before continuing; never ask again about a recorded answer, including as a rephrased question. When the brief is already bounded, state the default assumption and continue without an interview or routine implementation approval. Delegated taste is a direction to choose and proceed. A keyword, bare target, review-only request, or plan-only request remains read-only and authorizes no writes.
|
|
7
|
+
Keep a task-local decision note with the known purpose/audience, target, constraints, every prior answer, unresolved material decisions, and the next action. After each reply, retain the answer in that note across rounds, update only the affected contract fields and rationale, then ask only about the next unresolved high-impact choice. On resume, read the note and actual file state before continuing; never ask again about a recorded answer, including as a rephrased question. A visual direction the brief names as competing options but leaves undecided stays open even when the brief marks every option acceptable — calling options acceptable is not the same as picking one or handing the pick to you. Give that axis its own question once the higher-impact choices are settled; a recommended option may sit inside the question, but do not announce which one wins or start building before the user answers. Reserve the default assumption for axes the brief actually settles or delegates and for details too small to change the outcome; a brief that names no visual direction at all still receives the authored editorial/pixel default without a question. When the brief is already bounded, state the default assumption and continue without an interview or routine implementation approval. Delegated taste is a direction to choose and proceed. A keyword, bare target, review-only request, or plan-only request remains read-only and authorizes no writes.
|
|
8
8
|
|
|
9
9
|
## Authored default direction
|
|
10
10
|
|
|
@@ -4,4 +4,6 @@ Inspect the request and relevant repository files before asking. No interview is
|
|
|
4
4
|
|
|
5
5
|
Ask one high-impact question per turn, give concrete options and their consequence, and continue for as many rounds as materially necessary. Record each answer, unresolved choice, and next action in a task-local note; read it again on resume. After each answer, retain it and ask only about the next unresolved choice. Never re-ask a settled answer, including in new wording.
|
|
6
6
|
|
|
7
|
+
A cover or layout direction the brief names as competing options but never picks stays open, even when the brief calls each option fine — acceptable is not chosen, and it is not yours to choose either. Ask that question in its own round once the higher-impact choices are answered; you may suggest a favorite inside the question, but do not state a default for it or start the cover before the answer arrives. The default direction covers only what the brief actually settles or hands to you, plus details too small to change the read; a brief silent on visual direction entirely still gets the studio's default composition without a question.
|
|
8
|
+
|
|
7
9
|
If the brief already bounds the work, state the default direction and continue. Delegated taste is permission to choose and proceed, not a reason to pause for routine approval. Review-only and plan-only requests remain read-only; a keyword or bare repository name does not authorize writes.
|
package/.grok-plugin/plugin.json
CHANGED
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,11 @@
|
|
|
2
2
|
|
|
3
3
|
## Unreleased
|
|
4
4
|
|
|
5
|
+
## 1.0.7
|
|
6
|
+
|
|
7
|
+
- Show the robot crew cover in a visible image under the motion hero in both READMEs instead of only near the LITFAMILY section, and remove the now-duplicate copy so it appears exactly once.
|
|
8
|
+
- Give a competing visual direction its own interview round in frontend-ui-ux and README Studio instead of an announced default, when the brief leaves it undecided.
|
|
9
|
+
|
|
5
10
|
## 1.0.6
|
|
6
11
|
|
|
7
12
|
- Add README Studio decoration patterns and the bounded multi-round design interview.
|
package/README.md
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
|
-
<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
1
|
+
<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/assets/cover-motion-still.webp" /><source media="(prefers-reduced-motion: no-preference)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/assets/cover-motion.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/assets/cover-motion.webp" width="100%" alt="LitGrok motion cover with an orange signal crossing orbital paths above the GROK BUILD wordmark." /></picture></p>
|
|
2
|
+
<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/assets/cover.webp" width="100%" alt="LITFAMILY static cover with five armored machines beneath the words KEEP THE WORK LIT." /></p>
|
|
2
3
|
|
|
3
|
-
<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
4
|
+
<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/assets/readme/ascii-readme.svg" width="480" alt="LIT ASCII B mark — Grok" /></p>
|
|
4
5
|
|
|
5
6
|
<details>
|
|
6
7
|
<summary>Copy ASCII logo</summary>
|
|
@@ -37,14 +38,14 @@ grok
|
|
|
37
38
|
|
|
38
39
|
Make something useful in Grok Build. Leave the checked result and the next step with your project.
|
|
39
40
|
|
|
40
|
-
[한국어](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
41
|
+
[한국어](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/README_ko-KR.md) · [Install](#install-in-30-seconds) · [Quick start](#quick-start) · [Reference](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/reference.md)
|
|
41
42
|
|
|
42
43
|
<p align="center">
|
|
43
|
-
<a href="#install-in-30-seconds"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
44
|
-
<a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
44
|
+
<a href="#install-in-30-seconds"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/assets/readme/badge-version.svg" alt="1.0.7" /></a>
|
|
45
|
+
<a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/assets/readme/badge-license.svg" alt="MIT license" /></a>
|
|
45
46
|
</p>
|
|
46
47
|
|
|
47
|
-
<p align="center"><a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
48
|
+
<p align="center"><a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/reference.md"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/assets/readme/lucide-book-open.svg" width="16" alt="" /> Docs</a> <a href="#install-in-30-seconds">Install</a> <a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/assets/cover-motion.webp"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/assets/readme/lucide-play.svg" width="16" alt="" /> Cover motion</a> <a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/assets/readme/lucide-shield-check.svg" width="16" alt="" /> MIT</a></p>
|
|
48
49
|
|
|
49
50
|
## Install in 30 seconds
|
|
50
51
|
|
|
@@ -61,7 +62,7 @@ LITGROK_PACK='/absolute/path/to/the-provided-package.tgz'
|
|
|
61
62
|
npm exec --yes --package "$LITGROK_PACK" -- litgrok install
|
|
62
63
|
```
|
|
63
64
|
|
|
64
|
-
The default destination is `<project>/.grok/`. Use `--package @litfamily/litgrok@1.0.
|
|
65
|
+
The default destination is `<project>/.grok/`. Use `--package @litfamily/litgrok@1.0.7` for a pinned install, or add `--user` to install under `~/.grok/`. [Install and upgrade details](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/reference.md#install).
|
|
65
66
|
|
|
66
67
|
The persistent Grok status row is optional and user-level only. Opt in with:
|
|
67
68
|
|
|
@@ -94,7 +95,7 @@ npm exec --yes --package @litfamily/litgrok@latest -- litgrok uninstall
|
|
|
94
95
|
npm exec --yes --package @litfamily/litgrok@latest -- litgrok uninstall --user
|
|
95
96
|
```
|
|
96
97
|
|
|
97
|
-
User-level uninstall backs up `~/.grok/config.toml` before removing the unchanged LitGrok-managed status-line keys; other settings and a user-edited status line are preserved. Match the scope used for installation. Re-run `install` to update. The installer does not grant hook trust, create a Git root, write login state or API keys, or choose a model. The hedge guard is fail-open on host errors; a passing package test does not prove live Grok behavior. Check `/hooks` and `grok inspect --json` from the repository root in your own session. [Host boundaries and verification](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
98
|
+
User-level uninstall backs up `~/.grok/config.toml` before removing the unchanged LitGrok-managed status-line keys; other settings and a user-edited status line are preserved. Match the scope used for installation. Re-run `install` to update. The installer does not grant hook trust, create a Git root, write login state or API keys, or choose a model. The hedge guard is fail-open on host errors; a passing package test does not prove live Grok behavior. Check `/hooks` and `grok inspect --json` from the repository root in your own session. [Host boundaries and verification](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/reference.md#verify).
|
|
98
99
|
|
|
99
100
|
## Quick start
|
|
100
101
|
|
|
@@ -120,7 +121,7 @@ For a larger change, start with `/lit-plan`, review the saved plan, then invoke
|
|
|
120
121
|
/lit-handoff Record what we built, what we checked, and what remains. Tell me where you saved the handoff.
|
|
121
122
|
```
|
|
122
123
|
|
|
123
|
-
In the next session, supply that returned path and ask Grok Build to read it and check the current files before continuing. The default is `.handoff/HANDOFF.md` in a new Git project or `HANDOFF.md` in a non-Git workspace. An existing root handoff is reused. [Destination and handoff guidance](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
124
|
+
In the next session, supply that returned path and ask Grok Build to read it and check the current files before continuing. The default is `.handoff/HANDOFF.md` in a new Git project or `HANDOFF.md` in a non-Git workspace. An existing root handoff is reused. [Destination and handoff guidance](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/.grok/skills/lit-handoff/SKILL.md).
|
|
124
125
|
|
|
125
126
|
**Keeping the spark means leaving work another session can pick up.** These are skill-guided steps in your session; LitGrok does not schedule background work or continue after the session ends.
|
|
126
127
|
|
|
@@ -136,7 +137,7 @@ In the next session, supply that returned path and ask Grok Build to read it and
|
|
|
136
137
|
|
|
137
138
|
It ships 34 skills, 11 agents, one project rule, and eleven hook registrations. The installer copies the complete payload into your project; Grok Build runs the session and owns model selection.
|
|
138
139
|
|
|
139
|
-
Package: **@litfamily/litgrok** · Version: **1.0.
|
|
140
|
+
Package: **@litfamily/litgrok** · Version: **1.0.7** · [MIT](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/LICENSE)
|
|
140
141
|
|
|
141
142
|
The scientific visualization corpus is packaged at `.grok/vendor/scientific-visualization/`; the numeric `045_scientific-visualization` label remains only in license and provenance filenames.
|
|
142
143
|
|
|
@@ -170,13 +171,13 @@ flowchart TD
|
|
|
170
171
|
|
|
171
172
|
The hooks' `.grok/litgrok/session-ledger/` records event order. Judge success from the artifact and its checks. The user supplies the handoff path in the next session; having a record does not automatically resume work.
|
|
172
173
|
|
|
173
|
-
[Checklist and hook boundaries](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
174
|
+
[Checklist and hook boundaries](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/.grok/skills/litwork/SKILL.md) · [Handoff destinations](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/.grok/skills/lit-handoff/SKILL.md) · [Install details](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/reference.md#install)
|
|
174
175
|
|
|
175
176
|
### Design and README production
|
|
176
177
|
|
|
177
178
|
Use `/frontend-ui-ux <surface and outcome>` to build and inspect an authorized interface. A clear brief proceeds to working code; material ambiguity prompts a focused question. Review-only and plan-only requests remain read-only.
|
|
178
179
|
|
|
179
|
-
Use `/readme-studio <repository and outcome>` for a source-checked README, outlined Pretendard/Meslo typography, and portable cover/motion recipes. Check `/skills` after installation. Native image generation depends on the tools exposed in your Grok session; `IMAGE_GENERATION_UNAVAILABLE` permits an explicitly supplied background path. Fonts and renderers are task-local prerequisites. Local output is separate from live host and GitHub/npm acceptance. [README Studio](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
180
|
+
Use `/readme-studio <repository and outcome>` for a source-checked README, outlined Pretendard/Meslo typography, and portable cover/motion recipes. Check `/skills` after installation. Native image generation depends on the tools exposed in your Grok session; `IMAGE_GENERATION_UNAVAILABLE` permits an explicitly supplied background path. Fonts and renderers are task-local prerequisites. Local output is separate from live host and GitHub/npm acceptance. [README Studio](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/.grok/skills/readme-studio/SKILL.md).
|
|
180
181
|
|
|
181
182
|
The cover is brand motion, not a recording of a Grok task execution.
|
|
182
183
|
|
|
@@ -199,20 +200,20 @@ Grok Build uses the explicit `/litwork` route for a bounded task. It owns model
|
|
|
199
200
|
|
|
200
201
|
| Need | Skill |
|
|
201
202
|
|---|---|
|
|
202
|
-
| Clarify a vague request | [`/deep-interview`](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
203
|
-
| Write a plan with concrete checks | [`/lit-plan`](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
204
|
-
| Execute an approved plan | [`/start-work`](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
205
|
-
| Keep one task bounded and verifiable | [`/litwork`](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
206
|
-
| Review a change and its evidence | [`/review-work`](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
207
|
-
| Leave a resumable handoff | [`/lit-handoff`](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
203
|
+
| Clarify a vague request | [`/deep-interview`](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/.grok/skills/deep-interview/SKILL.md) |
|
|
204
|
+
| Write a plan with concrete checks | [`/lit-plan`](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/.grok/skills/lit-plan/SKILL.md) |
|
|
205
|
+
| Execute an approved plan | [`/start-work`](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/.grok/skills/start-work/SKILL.md) |
|
|
206
|
+
| Keep one task bounded and verifiable | [`/litwork`](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/.grok/skills/litwork/SKILL.md) |
|
|
207
|
+
| Review a change and its evidence | [`/review-work`](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/.grok/skills/review-work/SKILL.md) |
|
|
208
|
+
| Leave a resumable handoff | [`/lit-handoff`](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/.grok/skills/lit-handoff/SKILL.md) |
|
|
208
209
|
|
|
209
|
-
Use `/skills` for all 34 skills. [Rename compatibility](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
210
|
+
Use `/skills` for all 34 skills. [Rename compatibility](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/reference.md#skill-rename-compatibility) covers the one-release aliases; old slash routes are not guaranteed.
|
|
210
211
|
|
|
211
212
|
### Project hooks
|
|
212
213
|
|
|
213
214
|
| Surface | Registration and boundary |
|
|
214
215
|
| --- | --- |
|
|
215
|
-
| Project hooks | Eleven registrations are declared in [`hooks/hooks.json`](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
216
|
+
| Project hooks | Eleven registrations are declared in [`hooks/hooks.json`](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/hooks/hooks.json). They require a trusted Git root and `/hooks-trust`; a plain folder may load skills and rules without hooks. |
|
|
216
217
|
|
|
217
218
|
## Troubleshooting
|
|
218
219
|
|
|
@@ -226,19 +227,17 @@ If `CI` or `NO_COLOR` is set, even to an empty value, installation is a no-write
|
|
|
226
227
|
|
|
227
228
|
**Status row missing:** the persistent row is optional and uses user or administrator configuration; project and plugin configuration are not read for this setting. See the [status-line reference](https://docs.x.ai/build/features/status-line).
|
|
228
229
|
|
|
229
|
-
For host limits and current verification steps, see the [operational reference](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
230
|
+
For host limits and current verification steps, see the [operational reference](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/reference.md#verify).
|
|
230
231
|
|
|
231
232
|
## Links
|
|
232
233
|
|
|
233
|
-
- [Operational reference](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
234
|
-
- [Project rule](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
235
|
-
- [Changelog](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
234
|
+
- [Operational reference](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/reference.md): installation, hooks, terminal output, payload checks, and source provenance.
|
|
235
|
+
- [Project rule](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/.grok/rules/00-litgrok.md) and [skill catalog](https://github.com/wjgoarxiv/litgrok/tree/main/.grok/skills).
|
|
236
|
+
- [Changelog](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/CHANGELOG.md) and [license](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/LICENSE).
|
|
236
237
|
|
|
237
|
-
- [Contributing](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
238
|
-
- [Privacy and local data](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
238
|
+
- [Contributing](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/CONTRIBUTING.md), [security](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/SECURITY.md), [conduct](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/CODE_OF_CONDUCT.md), and [support](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/SUPPORT.md).
|
|
239
|
+
- [Privacy and local data](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/privacy.md); [migration from the old npm name](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/reference.md#npm-package-migration).
|
|
239
240
|
|
|
240
241
|
### LITFAMILY
|
|
241
242
|
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
The static cover shows five armored machines representing the products. Each works independently in its own host; they do not need to be installed together or connected to one another.
|
|
243
|
+
The static cover under the hero shows five armored machines representing the products. Each works independently in its own host; they do not need to be installed together or connected to one another.
|
package/README_ko-KR.md
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
|
-
<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
1
|
+
<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/assets/cover-motion-still.webp" /><source media="(prefers-reduced-motion: no-preference)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/assets/cover-motion.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/assets/cover-motion.webp" width="100%" alt="GROK BUILD 워드마크 위로 주황색 신호가 궤도를 가로지르는 LitGrok 모션 커버." /></picture></p>
|
|
2
|
+
<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/assets/cover.webp" width="100%" alt="KEEP THE WORK LIT 문구 아래 다섯 장갑 기계가 있는 LITFAMILY 정지 표지." /></p>
|
|
2
3
|
|
|
3
|
-
<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
4
|
+
<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/assets/readme/ascii-readme.svg" width="480" alt="LIT ASCII B 마크 — Grok" /></p>
|
|
4
5
|
|
|
5
6
|
<details>
|
|
6
7
|
<summary>ASCII 로고 복사</summary>
|
|
@@ -37,14 +38,14 @@ grok
|
|
|
37
38
|
|
|
38
39
|
Grok Build에서 작은 결과물을 만들고, 확인한 내용과 다음 할 일을 프로젝트에 남기세요.
|
|
39
40
|
|
|
40
|
-
[English](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
41
|
+
[English](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/README.md) · [설치](#30초-설치) · [빠른 시작](#빠른-시작) · [상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/reference_ko-KR.md)
|
|
41
42
|
|
|
42
43
|
<p align="center">
|
|
43
|
-
<a href="#30초-설치"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
44
|
-
<a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
44
|
+
<a href="#30초-설치"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/assets/readme/badge-version.svg" alt="1.0.7" /></a>
|
|
45
|
+
<a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/assets/readme/badge-license.svg" alt="MIT 라이선스" /></a>
|
|
45
46
|
</p>
|
|
46
47
|
|
|
47
|
-
<p align="center"><a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
48
|
+
<p align="center"><a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/reference_ko-KR.md"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/assets/readme/lucide-book-open.svg" width="16" alt="" /> 상세 안내</a> <a href="#30초-설치">설치</a> <a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/assets/cover-motion.webp"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/assets/readme/lucide-play.svg" width="16" alt="" /> 커버 모션</a> <a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/assets/readme/lucide-shield-check.svg" width="16" alt="" /> MIT</a></p>
|
|
48
49
|
|
|
49
50
|
## 30초 설치
|
|
50
51
|
|
|
@@ -61,7 +62,7 @@ LITGROK_PACK='/absolute/path/to/the-provided-package.tgz'
|
|
|
61
62
|
npm exec --yes --package "$LITGROK_PACK" -- litgrok install
|
|
62
63
|
```
|
|
63
64
|
|
|
64
|
-
기본 설치 위치는 `<project>/.grok/`입니다. 버전을 고정하려면 `--package @litfamily/litgrok@1.0.
|
|
65
|
+
기본 설치 위치는 `<project>/.grok/`입니다. 버전을 고정하려면 `--package @litfamily/litgrok@1.0.7`를 사용하세요. `--user`를 붙이면 `~/.grok/`에 설치합니다. [설치·업데이트 상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/reference_ko-KR.md#설치).
|
|
65
66
|
|
|
66
67
|
Grok 상태 행의 지속 표시는 선택 사항이며 사용자 범위에서만 설정할 수 있습니다.
|
|
67
68
|
|
|
@@ -94,7 +95,7 @@ npm exec --yes --package @litfamily/litgrok@latest -- litgrok uninstall
|
|
|
94
95
|
npm exec --yes --package @litfamily/litgrok@latest -- litgrok uninstall --user
|
|
95
96
|
```
|
|
96
97
|
|
|
97
|
-
사용자 범위 제거는 `~/.grok/config.toml`을 먼저 백업하고, 변경되지 않은 LitGrok 관리 status-line key만 제거합니다. 다른 설정과 사용자가 수정한 status line은 보존합니다. 설치 범위와 같은 옵션으로 제거하세요. 업데이트는 `install`을 다시 실행합니다. Installer는 Git root를 만들거나 hook trust를 허용하거나 로그인 상태·API 키를 쓰거나 모델을 선택하지 않습니다. Hedge guard는 host 오류 시 fail-open으로 동작합니다. 패키지 테스트가 통과해도 live Grok 동작을 확인한 것은 아닙니다. Git root에서 현재 세션의 `/hooks`와 `grok inspect --json`을 확인하세요. [Host 경계와 검증](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
98
|
+
사용자 범위 제거는 `~/.grok/config.toml`을 먼저 백업하고, 변경되지 않은 LitGrok 관리 status-line key만 제거합니다. 다른 설정과 사용자가 수정한 status line은 보존합니다. 설치 범위와 같은 옵션으로 제거하세요. 업데이트는 `install`을 다시 실행합니다. Installer는 Git root를 만들거나 hook trust를 허용하거나 로그인 상태·API 키를 쓰거나 모델을 선택하지 않습니다. Hedge guard는 host 오류 시 fail-open으로 동작합니다. 패키지 테스트가 통과해도 live Grok 동작을 확인한 것은 아닙니다. Git root에서 현재 세션의 `/hooks`와 `grok inspect --json`을 확인하세요. [Host 경계와 검증](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/reference_ko-KR.md#검증).
|
|
98
99
|
|
|
99
100
|
## 빠른 시작
|
|
100
101
|
|
|
@@ -120,7 +121,7 @@ npm exec --yes --package @litfamily/litgrok@latest -- litgrok uninstall --user
|
|
|
120
121
|
/lit-handoff 지금까지 만든 것, 확인한 것, 남은 일을 기록하고 저장 경로를 알려줘.
|
|
121
122
|
```
|
|
122
123
|
|
|
123
|
-
새 세션에서는 반환된 경로를 직접 지정해 문서를 읽고 현재 파일 상태부터 확인하도록 요청하세요. 기본 경로는 새 Git 프로젝트에서 `.handoff/HANDOFF.md`, Git이 없는 작업 폴더에서 `HANDOFF.md`입니다. 기존 루트 handoff가 있으면 그 파일을 사용합니다. [경로 선택과 인수인계 안내](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
124
|
+
새 세션에서는 반환된 경로를 직접 지정해 문서를 읽고 현재 파일 상태부터 확인하도록 요청하세요. 기본 경로는 새 Git 프로젝트에서 `.handoff/HANDOFF.md`, Git이 없는 작업 폴더에서 `HANDOFF.md`입니다. 기존 루트 handoff가 있으면 그 파일을 사용합니다. [경로 선택과 인수인계 안내](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/.grok/skills/lit-handoff/SKILL.md).
|
|
124
125
|
|
|
125
126
|
**불씨를 남긴다는 것은 다음에 이어갈 일을 기록한다는 뜻입니다.** Skill이 현재 세션의 작업 절차를 안내합니다. LitGrok이 백그라운드 작업을 예약하거나 세션이 끝난 뒤 작업을 계속하지는 않습니다.
|
|
126
127
|
|
|
@@ -136,7 +137,7 @@ npm exec --yes --package @litfamily/litgrok@latest -- litgrok uninstall --user
|
|
|
136
137
|
|
|
137
138
|
skill 34개, agent 11개, project rule 하나, hook 등록 열한 개를 제공합니다. Installer가 프로젝트에 전체 파일을 복사하고, 세션 실행과 모델 선택은 Grok Build가 담당합니다.
|
|
138
139
|
|
|
139
|
-
패키지: **@litfamily/litgrok** · 버전: **1.0.
|
|
140
|
+
패키지: **@litfamily/litgrok** · 버전: **1.0.7** · [MIT](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/LICENSE)
|
|
140
141
|
|
|
141
142
|
과학 시각화 corpus는 `.grok/vendor/scientific-visualization/`에 포함되며, 숫자 `045_scientific-visualization` 표기는 라이선스와 provenance 파일명에만 남습니다.
|
|
142
143
|
|
|
@@ -170,7 +171,7 @@ flowchart TD
|
|
|
170
171
|
|
|
171
172
|
Hook의 `.grok/litgrok/session-ledger/`는 이벤트가 발생한 순서를 남깁니다. 작업 성공 여부는 결과물과 확인 기록으로 판단하세요. 다음 세션에서는 사용자가 handoff 경로를 전달합니다. 기록이 있다고 작업이 자동으로 재개되지는 않습니다.
|
|
172
173
|
|
|
173
|
-
[작업 절차와 hook의 범위](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
174
|
+
[작업 절차와 hook의 범위](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/.grok/skills/litwork/SKILL.md) · [인수인계 경로](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/.grok/skills/lit-handoff/SKILL.md) · [설치 상세](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/reference_ko-KR.md#설치)
|
|
174
175
|
|
|
175
176
|
### 화면과 README 제작
|
|
176
177
|
|
|
@@ -199,20 +200,20 @@ Grok Build에서는 명시적인 `/litwork` 경로로 작은 작업을 시작합
|
|
|
199
200
|
|
|
200
201
|
| 필요한 작업 | Skill |
|
|
201
202
|
|---|---|
|
|
202
|
-
| 모호한 요청 구체화 | [`/deep-interview`](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
203
|
-
| 검증 기준이 있는 계획 작성 | [`/lit-plan`](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
204
|
-
| 승인한 계획 실행 | [`/start-work`](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
205
|
-
| 작은 작업의 범위와 결과 확인 | [`/litwork`](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
206
|
-
| 변경 내용과 근거 검토 | [`/review-work`](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
207
|
-
| 다음 세션을 위한 인수인계 | [`/lit-handoff`](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
203
|
+
| 모호한 요청 구체화 | [`/deep-interview`](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/.grok/skills/deep-interview/SKILL.md) |
|
|
204
|
+
| 검증 기준이 있는 계획 작성 | [`/lit-plan`](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/.grok/skills/lit-plan/SKILL.md) |
|
|
205
|
+
| 승인한 계획 실행 | [`/start-work`](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/.grok/skills/start-work/SKILL.md) |
|
|
206
|
+
| 작은 작업의 범위와 결과 확인 | [`/litwork`](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/.grok/skills/litwork/SKILL.md) |
|
|
207
|
+
| 변경 내용과 근거 검토 | [`/review-work`](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/.grok/skills/review-work/SKILL.md) |
|
|
208
|
+
| 다음 세션을 위한 인수인계 | [`/lit-handoff`](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/.grok/skills/lit-handoff/SKILL.md) |
|
|
208
209
|
|
|
209
|
-
전체 skill 34개는 `/skills`에서 확인하세요. 이전 이름을 한 릴리스 동안 별칭으로 유지하는 정책은 [이름 변경과 호환성](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
210
|
+
전체 skill 34개는 `/skills`에서 확인하세요. 이전 이름을 한 릴리스 동안 별칭으로 유지하는 정책은 [이름 변경과 호환성](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/reference_ko-KR.md#skill-이름-변경과-호환성)을 보세요. 이전 slash 경로는 보장되지 않습니다.
|
|
210
211
|
|
|
211
212
|
### Project hook
|
|
212
213
|
|
|
213
214
|
| 표면 | 등록과 경계 |
|
|
214
215
|
| --- | --- |
|
|
215
|
-
| Project hook | [`hooks/hooks.json`](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
216
|
+
| Project hook | [`hooks/hooks.json`](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/hooks/hooks.json)에 열한 개 등록이 있습니다. 신뢰한 Git root와 `/hooks-trust`가 필요하며, 일반 폴더에서는 skill과 rule만 로드되고 hook은 없을 수 있습니다. |
|
|
216
217
|
|
|
217
218
|
## 문제 해결
|
|
218
219
|
|
|
@@ -226,19 +227,17 @@ Project hook은 Grok Build에서 신뢰한 Git 프로젝트 루트가 있어야
|
|
|
226
227
|
|
|
227
228
|
**상태 행이 보이지 않을 때:** 지속 상태 행은 선택 기능이며 사용자 또는 관리자 설정을 사용합니다. project/plugin 설정에서는 이 값을 읽지 않습니다. [상태 행 안내](https://docs.x.ai/build/features/status-line)를 확인하세요.
|
|
228
229
|
|
|
229
|
-
호스트 한계와 확인 절차는 [상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
230
|
+
호스트 한계와 확인 절차는 [상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/reference_ko-KR.md#검증)를 참고하세요.
|
|
230
231
|
|
|
231
232
|
## 링크
|
|
232
233
|
|
|
233
|
-
- [상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
234
|
-
- [Project rule](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
235
|
-
- [변경 이력](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
234
|
+
- [상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/reference_ko-KR.md): 설치, hook, 터미널 출력, 패키지 검증, 출처.
|
|
235
|
+
- [Project rule](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/.grok/rules/00-litgrok.md)과 [skill 목록](https://github.com/wjgoarxiv/litgrok/tree/main/.grok/skills).
|
|
236
|
+
- [변경 이력](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/CHANGELOG.md)과 [라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/LICENSE).
|
|
236
237
|
|
|
237
|
-
- [기여 안내](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
238
|
-
- [개인정보와 로컬 데이터](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.
|
|
238
|
+
- [기여 안내](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/CONTRIBUTING.md), [보안](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/SECURITY.md), [행동 규범](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/CODE_OF_CONDUCT.md), [지원](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/SUPPORT.md).
|
|
239
|
+
- [개인정보와 로컬 데이터](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/privacy.md), [기존 npm 이름에서 이전](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.7/docs/reference_ko-KR.md#npm-package-migration).
|
|
239
240
|
|
|
240
241
|
### LITFAMILY
|
|
241
242
|
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
정지 표지에는 다섯 제품을 나타내는 장갑 기계가 있습니다. 각 제품은 자기 호스트에서 독립적으로 동작하며 함께 설치하거나 서로 연결할 필요가 없습니다.
|
|
243
|
+
상단 정지 표지에는 다섯 제품을 나타내는 장갑 기계가 있습니다. 각 제품은 자기 호스트에서 독립적으로 동작하며 함께 설치하거나 서로 연결할 필요가 없습니다.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
<svg xmlns="http://www.w3.org/2000/svg" width="146" height="20" role="img" aria-label="local: 1.0.
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" width="146" height="20" role="img" aria-label="local: 1.0.7"><title>local: 1.0.7</title><g shape-rendering="crispEdges"><rect width="49" height="20" fill="#080d14"/><rect x="49" width="97" height="20" fill="#ff6337"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><text x="255" y="140" textLength="290" transform="scale(.1)">local</text><text x="965" y="140" textLength="870" transform="scale(.1)" fill="#080D14">1.0.7</text></g></svg>
|
package/docs/reference.md
CHANGED
|
@@ -76,7 +76,7 @@ npm exec --yes --package @litfamily/litgrok@latest -- litgrok install
|
|
|
76
76
|
Pin a version when you need a reproducible install:
|
|
77
77
|
|
|
78
78
|
```bash
|
|
79
|
-
npm exec --yes --package @litfamily/litgrok@1.0.
|
|
79
|
+
npm exec --yes --package @litfamily/litgrok@1.0.7 -- litgrok install
|
|
80
80
|
```
|
|
81
81
|
|
|
82
82
|
Preview without writing files:
|
package/docs/reference_ko-KR.md
CHANGED
|
@@ -76,7 +76,7 @@ npm exec --yes --package @litfamily/litgrok@latest -- litgrok install
|
|
|
76
76
|
재현 가능한 설치는 버전을 고정합니다.
|
|
77
77
|
|
|
78
78
|
```bash
|
|
79
|
-
npm exec --yes --package @litfamily/litgrok@1.0.
|
|
79
|
+
npm exec --yes --package @litfamily/litgrok@1.0.7 -- litgrok install
|
|
80
80
|
```
|
|
81
81
|
|
|
82
82
|
파일을 쓰지 않고 미리보기:
|
package/package.json
CHANGED