Skip to content

docs: align docs site IA with five-tool decomposition#65

Merged
nahiyankhan merged 1 commit intomainfrom
docs/five-tool-ia
Apr 27, 2026
Merged

docs: align docs site IA with five-tool decomposition#65
nahiyankhan merged 1 commit intomainfrom
docs/five-tool-ia

Conversation

@nahiyankhan
Copy link
Copy Markdown
Collaborator

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: /tools is 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/*.

  • Content rewrite — root README, CLAUDE.md, packages/ghost-drift/README.md, and a new packages/ghost-expression/README.md all reflect per-tool verb scoping. docs/generation-loop.md switches the context-bundle invocations from ghost-drift to ghost-expression; docs/expression-format.md drops the dropped-from-scope generate recipe.
  • Docs site IA — five new per-tool landing pages (/tools/{map,expression,drift,fleet,ui}), a new /docs hub, and a guide frontmatter section that routes shared MDX to /docs/<slug>. Old /tools/drift/{getting-started,cli} URLs redirect to /docs/*. Dock command palette restructured into Tools + Docs groups. Home thesis lightly tweaked to soften drift-as-flagship framing and tease the elevation lens / world-model concept that ghost-fleet operationalizes. The ghost-ui card naturally hooks into the existing /ui catalogue.
  • Toolingscripts/dump-cli-help.mjs walks all four CLIs (drift, expression, map, fleet); manifest is now keyed by tool, each command carries its tool prefix. The <CliHelp> component takes a tool prop and renders the correct prefix dynamically. check-docs-frontmatter.mjs accepts the new guide section and updated known-routes list. Includes a patch changeset for ghost-drift (README rewrite is user-visible on npm).

Test plan

  • pnpm check clean (biome, typecheck, file-sizes, docs-frontmatter, cli-manifest drift)
  • pnpm test — 262 passing across all four packages
  • pnpm -F ghost-docs build — clean Vite build
  • pnpm -F ghost-docs dev — manually walk the IA in a browser:
    • /tools shows five cards (map, expression, drift, fleet, ui)
    • each /tools/<name> landing renders with the right copy
    • /docs hub renders; /docs/getting-started and /docs/cli render with correct tool prefixes in <CliHelp> blocks
    • /tools/drift/getting-started and /tools/drift/cli redirect to /docs/*
    • /tools/drift/workflow still renders with the new ghost-expression references
    • dock command palette shows Tools + Docs groups
  • verify the changeset bumps ghost-drift patch on the next Version Packages PR

🤖 Generated with Claude Code

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>
@nahiyankhan nahiyankhan merged commit 58f93e0 into main Apr 27, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant