Skip to content

docs: promote workflow to /tools hero, add Map step#66

Merged
nahiyankhan merged 1 commit intomainfrom
docs/tools-workflow-hero
Apr 27, 2026
Merged

docs: promote workflow to /tools hero, add Map step#66
nahiyankhan merged 1 commit intomainfrom
docs/tools-workflow-hero

Conversation

@nahiyankhan
Copy link
Copy Markdown
Collaborator

Summary

  • Pulls the Working with Ghost narrative out from /tools/drift/workflow (buried two clicks deep) and onto /tools itself, behind a compact 5-card tool strip. The Tools landing now does real work — the conceptual story is the entry point, with the per-tool deep-dives a click below.
  • Adds Step 01 · Map · Map the project ahead of the existing Profile step, with a MapExcerpt mirroring the expression.md excerpt visual. Renumbers the rest (Profile 02, Compare 03, Review 04, Evolve 05, Org 06). Step 02 lead now opens "With map.md in place, …" so the dependency is explicit.
  • Workflow body extracted to apps/docs/src/components/docs/workflow-content.tsx (shared component — keeps the page file thin).
  • Drift Workflow nav entries (the /docs index card and the ⌘K palette) repoint to /tools and rename to Workflow. Old /tools/drift/{workflow,concepts} URLs redirect to /tools.
  • Header on /tools: kicker Tools (matching the dock), title Working with Ghost.

Also extends HistoryRibbon (Step 05 · Evolve) with an interactive playhead: drag the chart to set a decision moment, pick a hypothetical stance (= aligned / * accepted / ~ diverging), and the curve re-classifies points after the playhead. Demonstrates the "the curve hasn't changed shape — but the meaning of every point after has" line that the copy used to only assert.

No published-package changes — apps/docs is private, no changeset.

Test plan

  • pnpm dev, visit /tools — header reads "Tools / Working with Ghost", tool strip renders 5 chips, Step 01 · Map lands first with the map.md excerpt and the Topology / Composition / Surface perspective cards
  • Steps renumbered: 01 Map, 02 Profile, 03 Compare, 04 Review, 05 Evolve, 06 Org
  • Artifacts grid shows 5 files including map.md
  • Step 05 · Evolve: drag the History Ribbon — playhead appears, stance buttons re-classify points forward, caption rewrites, reset clears
  • /tools/drift/workflow and /tools/drift/concepts both redirect to /tools
  • /docs index → "The Workflow" card → /tools
  • ⌘K palette → "Workflow" → /tools
  • pnpm check and pnpm --filter ghost-docs build clean

🤖 Generated with Claude Code

Pulls the Working with Ghost narrative out from the buried
/tools/drift/workflow URL and onto the /tools landing page itself,
behind a compact 5-card tool strip. Adds Step 01 · Map (write a
map.md) before the existing Profile step so the workflow opens with
ghost-map, and renumbers the rest. Drift Workflow nav entries
(/docs index card and ⌘K palette) repoint to /tools; old
/tools/drift/{workflow,concepts} URLs redirect.

Also extends HistoryRibbon (Step 05 · Evolve) with an interactive
playhead — drag to set a decision moment, pick a hypothetical
stance, and the curve re-classifies forward of the playhead.
Demonstrates the "the curve hasn't changed shape — but the meaning
of every point after has" line that the page used to only assert.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@nahiyankhan nahiyankhan merged commit f4803a4 into main Apr 27, 2026
6 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