20260910-0347-breadcrumb-navigation Add breadcrumb navigation with a clickable page at every level

• status: completed
• priority: P1
• owner: claude/session-pages
• createdAt: 2026-09-10 03:47

Description

Removing the sidebar left deep pages with no way back up the hierarchy. Add a breadcrumb trail (Home / Products / Core / P01-core) rendered above every document, where each ancestor is a real, clickable page.

Acceptance criteria:

• Every directory that can appear in a breadcrumb has an index.md, so no level is a dead label.
• The trail is derived from the page path at build time; adding a document does not require editing a navigation list.
• The home page (layout: home) renders no breadcrumb.
• bun run docs:build passes with dead-link checking enabled and the deployed pages show the trail.

ActiveForm

Adding breadcrumb navigation with a clickable page at every level.

Dependencies

• blocked by: (none)
• blocks: (none)

Notes

• 17 directories currently lack an index.md: the 13 product-line directories, the three air-key-vendors/ category directories and docs/.

• data/ and sources/ hold CSV and PDF assets only, contain no Markdown page, and never appear in a breadcrumb.

• complete: Breadcrumb shipped with an index page at every level