docs: align docs site IA with five-tool decomposition#65
Merged
nahiyankhan merged 1 commit intomainfrom Apr 27, 2026
Merged
Conversation
Rewrites the cross-cutting docs to match the post-PR-#64 reality where Ghost is five tools (ghost-map, ghost-expression, ghost-drift, ghost-fleet, ghost-ui) instead of one. CLI verbs are scoped to the tool that owns the artifact; per-tool skill bundles replace the single ghost-drift bundle. Content: - CLAUDE.md, root README, and ghost-drift README rewritten around the five-tool surface; new packages/ghost-expression/README for the intended-public sibling. - docs/generation-loop.md updates context-bundle invocations to ghost-expression; expression-format.md drops the dropped-from-scope generate recipe. Docs site: - /tools is now a five-card index. Each tool gets a /tools/<name> landing (hooking ghost-ui through to its existing /ui catalogue). - Cross-tool guides (Getting Started, CLI Reference) move from /tools/drift/* to /docs/* via a new "guide" frontmatter section. - Old /tools/drift/{getting-started,cli} URLs redirect to /docs/*. - Dock command palette restructured into Tools + Docs groups. - Home thesis softened from drift-centric framing; teases the elevation lens / world-model concept that ghost-fleet operationalizes. Tooling: - scripts/dump-cli-help.mjs walks all four CLIs (drift, expression, map, fleet); manifest now keyed by tool with each command carrying its tool prefix. - <CliHelp> takes a `tool` prop and renders the correct prefix. - check-docs-frontmatter accepts the new "guide" section and updated known-routes list. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Aligns the cross-cutting docs (root README, CLAUDE.md, package READMEs, docs site) with the post-PR-#64 reality where Ghost is five tools —
ghost-map,ghost-expression,ghost-drift,ghost-fleet,ghost-ui— instead of one. Most user-visible piece is the docs-site IA:/toolsis now a five-card index, each tool gets its own/tools/<name>landing, and the cross-tool guides (Getting Started, CLI Reference) move out of/tools/drift/*to a top-level/docs/*.packages/ghost-drift/README.md, and a newpackages/ghost-expression/README.mdall reflect per-tool verb scoping.docs/generation-loop.mdswitches the context-bundle invocations fromghost-drifttoghost-expression;docs/expression-format.mddrops the dropped-from-scopegeneraterecipe./tools/{map,expression,drift,fleet,ui}), a new/docshub, and aguidefrontmatter section that routes shared MDX to/docs/<slug>. Old/tools/drift/{getting-started,cli}URLs redirect to/docs/*. Dock command palette restructured intoTools+Docsgroups. Home thesis lightly tweaked to soften drift-as-flagship framing and tease the elevation lens / world-model concept thatghost-fleetoperationalizes. Theghost-uicard naturally hooks into the existing/uicatalogue.scripts/dump-cli-help.mjswalks all four CLIs (drift, expression, map, fleet); manifest is now keyed by tool, each command carries its tool prefix. The<CliHelp>component takes atoolprop and renders the correct prefix dynamically.check-docs-frontmatter.mjsaccepts the newguidesection and updated known-routes list. Includes apatchchangeset forghost-drift(README rewrite is user-visible on npm).Test plan
pnpm checkclean (biome, typecheck, file-sizes, docs-frontmatter, cli-manifest drift)pnpm test— 262 passing across all four packagespnpm -F ghost-docs build— clean Vite buildpnpm -F ghost-docs dev— manually walk the IA in a browser:/toolsshows five cards (map, expression, drift, fleet, ui)/tools/<name>landing renders with the right copy/docshub renders;/docs/getting-startedand/docs/clirender with correct tool prefixes in<CliHelp>blocks/tools/drift/getting-startedand/tools/drift/cliredirect to/docs/*/tools/drift/workflowstill renders with the new ghost-expression referencesghost-driftpatch on the next Version Packages PR🤖 Generated with Claude Code