You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
- Update README and AGENTS/CLAUDE init rows to the shipped skeleton starter;
add ghost export and steering-eval to command/package tables
- Document ghost export on the docs site (cli-reference)
- Rewrite entrance docs in plain language: reorder README around install and
agent prompts, cut untaught jargon from quickstart/getting-started, rebuild
the npm README with the missing beta warning
- Enforce the entrance-docs vocabulary in check-terminology.mjs
- Remove the root .ghost fingerprint; salvage its voice conventions into
CLAUDE.md conventions
- Migrate demo fingerprints from legacy haunts/ to flat checks/ (local only)
Copy file name to clipboardExpand all lines: CLAUDE.md
+11-1Lines changed: 11 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -91,6 +91,7 @@ edits and checks.
91
91
|`packages/ghost`| yes: `@design-intelligence/ghost`| The public package. Ships the `ghost` CLI, node authoring, corpus validation, gather/pull/pulse, review packet assembly, and the unified skill bundle. Shared runtime lives in `packages/ghost/src/ghost-core`. |
92
92
|`packages/vessel-react`| no | A standalone shadcn component registry plus `vessel-mcp` MCP server: the opinionated default reference body. Design-system-agnostic; nothing in Ghost requires it. |
93
93
|`packages/vessel-light`| no | Vessel's design language as a portable `.ghost/` fingerprint package for agents writing raw HTML/CSS. No build, no dependencies. |
94
+
|`packages/steering-eval`| no | Before/after evaluation harness: measures what handing an agent a `.ghost` fingerprint buys, as a deterministic `report.html`. |
94
95
|`apps/docs`| no | Docs site. |
95
96
96
97
## CLI Commands
@@ -99,13 +100,14 @@ Core workflow:
99
100
100
101
| Command | Description |
101
102
| --- | --- |
102
-
|`ghost init`| Scaffold `.ghost/` with a manifest, starterglossary, and a starter `index.md`. `--with checks` also adds the checks directory. |
103
+
|`ghost init`| Scaffold `.ghost/` with the skeleton starter: manifest, glossary, `index.md`, grammar nodes, and unanswered signature dials. `--template minimal` writes only the manifest/glossary/index starter; `--body vessel-light` installs a full inhabited fingerprint instead. `--with checks` also adds the checks directory. |
103
104
|`ghost checks init`| Scaffold `.ghost/checks/` with an example review assertion. |
104
105
|`ghost validate`| Validate the package: manifest shape, node validity, material locators, check references, and glossary kind prefixes. |
105
106
|`ghost gather [ask…]`| Emit the fingerprint menu for the agent to select from. |
106
107
|`ghost pull <id> [<id>…]`| Emit selected nodes' bodies and materials; append the selection to the local `.ghost/.events` tape. |
107
108
|`ghost review`| Emit an advisory review packet for a diff using material-backed nodes and checks (requires `.ghost/checks/`). |
108
109
|`ghost pulse`| Summarize local gather/pull events from `.ghost/.events`. |
110
+
|`ghost export`| Package the fingerprint as a portable tarball with a materials audit (`--strict` fails on stranded locators). |
109
111
|`ghost skill install`| Install the unified `ghost` skill bundle. |
110
112
111
113
Advanced/maintenance:
@@ -151,6 +153,14 @@ Use `patch` for fixes and docs, `minor` for new commands/flags/exports, and
151
153
152
154
## Conventions
153
155
156
+
- Shipped prose is plain, precise, restrained, and product-minded. When
157
+
completeness and compactness compete, compactness wins; link out for depth.
158
+
Concrete over aspirational: name the decision a truth forces, not the value
159
+
it serves. Teach terms by worked example before defining them. No em dashes,
160
+
no brand-deck filler, no exclamation points. `scripts/check-terminology.mjs`
161
+
enforces the retired-vocabulary list; run `pnpm check:terminology` before
162
+
pushing, and when renaming a concept, retire the old word everywhere in the
163
+
same change and add it to the forbidden list.
154
164
- Keep publishable runtime code self-contained in `packages/ghost`; no
155
165
`workspace:*` runtime dependencies in the packed public artifact.
156
166
- The canonical on-disk form is a flat `.ghost/` package: `manifest.yml` plus
0 commit comments