recenter the docs site on gather

[nahiyankhan]

Category: improvement
User Impact: Visitors get a simpler explanation of ghost centered on gather, with one onboarding path and a more legible technical-document interface.
Problem: The site split its introduction across overlapping pages and presented ghost from its internal mechanics outward. The visual system also obscured the product’s strongest bet: showing the full guidance menu compactly, selecting in the open, and pulling only what the task needs.
Solution: Rebuild the homepage around the cross-medium guidance problem and an interactive gather demonstration, consolidate onboarding into Getting Started, and replace the generic docs chrome with a marked-document system. Add an explicit pre-1.0 warning to the docs index and Getting Started.

Stack: This draft targets nahiyankhan/ghost-package-api and should merge after #236. Once #236 lands, retarget this PR to main.

Validation:

• pnpm check: passed
• pnpm test: 177 passed, 1 skipped
• pnpm build: passed
• pnpm --filter ghost-docs build: passed during implementation
• Browser review: desktop, mobile, light mode, dark mode, interactive Gather selection

Changeset: not needed because the docs app is private; public package terminology and API changes are covered by #236.

ghost Review:

• Not run because the docs package has advisory checks but the current CLI review workflow requires a diff invocation outside this PR-creation path; visual and interaction checks were performed in-browser.

File changes

apps/docs/.ghost/anti-goal.generated-docs-site.md
Updates the docs package guidance and checks to match the new IA, vocabulary, and visual stance.

apps/docs/.ghost/asset.docs-materials.md
Updates the docs package guidance and checks to match the new IA, vocabulary, and visual stance.

apps/docs/.ghost/checks/cli-examples-match-manifest.md
Updates the docs package guidance and checks to match the new IA, vocabulary, and visual stance.

apps/docs/.ghost/checks/no-generic-ai-ornament.md
Updates the docs package guidance and checks to match the new IA, vocabulary, and visual stance.

apps/docs/.ghost/checks/review-stays-advisory.md
Updates the docs package guidance and checks to match the new IA, vocabulary, and visual stance.

apps/docs/.ghost/decision.feed-forward-over-review.md
Updates the docs package guidance and checks to match the new IA, vocabulary, and visual stance.

apps/docs/.ghost/exemplar.home-thesis.md
Updates the docs package guidance and checks to match the new IA, vocabulary, and visual stance.

apps/docs/.ghost/glossary.md
Updates the docs package guidance and checks to match the new IA, vocabulary, and visual stance.

apps/docs/.ghost/index.md
Updates the docs package guidance and checks to match the new IA, vocabulary, and visual stance.

apps/docs/.ghost/pattern.landing-thesis.md
Updates the docs package guidance and checks to match the new IA, vocabulary, and visual stance.

apps/docs/.ghost/principle.product-model.md
Updates the docs package guidance and checks to match the new IA, vocabulary, and visual stance.

apps/docs/.ghost/principle.visual-composition.md
Updates the docs package guidance and checks to match the new IA, vocabulary, and visual stance.

apps/docs/.ghost/voice.docs-language.md
Updates the docs package guidance and checks to match the new IA, vocabulary, and visual stance.

apps/docs/README.md
Aligns the docs application with the Gather-centered presentation.

apps/docs/index.html
Aligns the docs application with the Gather-centered presentation.

apps/docs/package.json
Removes unused entrance-animation dependencies.

apps/docs/src/App.tsx
Updates docs routing, MDX integration, or content loading for the simplified site.

apps/docs/src/app/docs/page.tsx
Reduces the docs index to one canonical learning path and adds the shared pre-1.0 warning.

apps/docs/src/app/page.tsx
Rewrites the marketing homepage around fragmented brand guidance, purpose-coherent nodes, and gather as the primary product bet.

apps/docs/src/app/tools/drift/page.tsx
Removes standalone tool landing pages so gather is explained in the main narrative and docs.

apps/docs/src/app/tools/page.tsx
Removes standalone tool landing pages so gather is explained in the main narrative and docs.

apps/docs/src/app/tools/scan/page.tsx
Removes standalone tool landing pages so gather is explained in the main narrative and docs.

apps/docs/src/components/docs/animated-page-header.tsx
Removes unreliable entrance animation in favor of immediate rendering.

apps/docs/src/components/docs/beta-warning.tsx
Adds the reusable, explicit not-ready-for-reliance warning and participation invitation.

apps/docs/src/components/docs/callout.tsx
Restyles or simplifies shared docs UI for the marked-document system.

apps/docs/src/components/docs/cli-help.tsx
Restyles or simplifies shared docs UI for the marked-document system.

apps/docs/src/components/docs/doc-index.tsx
Adds numbered document indexes for navigation without card-grid ornament.

apps/docs/src/components/docs/doc-prose.tsx
Restyles or simplifies shared docs UI for the marked-document system.

apps/docs/src/components/docs/dock.tsx
Restyles or simplifies shared docs UI for the marked-document system.

apps/docs/src/components/docs/docs-mdx-layout.tsx
Restyles or simplifies shared docs UI for the marked-document system.

apps/docs/src/components/docs/docs-page-layout.tsx
Restyles or simplifies shared docs UI for the marked-document system.

apps/docs/src/components/docs/gather-demo.tsx
Adds the interactive complete-menu and selected-pull demonstration.

apps/docs/src/components/docs/hero.tsx
Restyles or simplifies shared docs UI for the marked-document system.

apps/docs/src/components/docs/marked.tsx
Adds reusable MDX primitives for files, listings, steps, repairs, and comparisons.

apps/docs/src/components/docs/page-header.tsx
Restyles or simplifies shared docs UI for the marked-document system.

apps/docs/src/components/docs/wrappers.tsx
Restyles or simplifies shared docs UI for the marked-document system.

apps/docs/src/content/docs-frontmatter.ts
Updates docs routing, MDX integration, or content loading for the simplified site.

apps/docs/src/content/docs-manifest.ts
Updates docs routing, MDX integration, or content loading for the simplified site.

apps/docs/src/content/docs/authoring.mdx
Reworks documentation content and routing around one onboarding path and current ghost package vocabulary.

apps/docs/src/content/docs/checks-and-review.mdx
Reworks documentation content and routing around one onboarding path and current ghost package vocabulary.

apps/docs/src/content/docs/cli-reference.mdx
Reworks documentation content and routing around one onboarding path and current ghost package vocabulary.

apps/docs/src/content/docs/getting-started.mdx
Reworks documentation content and routing around one onboarding path and current ghost package vocabulary.

apps/docs/src/content/docs/quickstart.mdx
Removes the competing Five-Minute ghost onboarding route in favor of one Getting Started path.

apps/docs/src/content/docs/troubleshooting.mdx
Reworks documentation content and routing around one onboarding path and current ghost package vocabulary.

apps/docs/src/main.tsx
Updates docs routing, MDX integration, or content loading for the simplified site.

apps/docs/src/mdx-components.tsx
Updates docs routing, MDX integration, or content loading for the simplified site.

apps/docs/src/styles/dev-fonts.css
Removes the external development font override in favor of the document system font stack.

apps/docs/src/styles/docs.css
Wires the docs-specific visual theme.

apps/docs/src/styles/marked-doc.css
Defines the marked technical-document visual system, responsive triptych, themes, and readable dark-mode syntax colors.

apps/docs/vite.config.ts
Aligns the docs application with the Gather-centered presentation.

docs/README.md
Points maintainers to the single Getting Started onboarding path.

pnpm-lock.yaml
Removes unused entrance-animation dependencies.

scripts/check-docs-frontmatter.mjs
Updates docs validation and terminology enforcement for the simplified route set.

scripts/check-terminology.mjs
Updates docs validation and terminology enforcement for the simplified route set.

Screenshots/Demos: The homepage and docs were reviewed locally in desktop/mobile and light/dark modes. The interactive Gather example was exercised for each task; screenshots can be added in follow-up if reviewers want them embedded.