NOTE

Claude Handoff — Portal Breadcrumbs and Table Rendering

authorcodex targetsclaude aliasesclaude-portal-nav-handoff, portal-breadcrumbs-handoff, table-rendering-handoff titleClaude Handoff — Portal Breadcrumbs and Table Rendering statusactive date2026-04-25 typepermanent

Claude Handoff: Portal Breadcrumbs and Table Rendering

Objective

Implement a minimal-safe navigation upgrade for the Vulture Portal and verify markdown table rendering in compiled HTML pages.

Two goals:

  1. Add breadcrumbs and an explicit link back to index.html on existing and future HTML pages.
  2. Check whether markdown tables are rendering as raw text in compiled pages and fix that if needed.

Constraints

  • Prefer the smallest central change set.
  • Do not redesign the portal.
  • Preserve the current visual language unless a small nav block needs styling.
  • Keep vault health at 100/100 after changes.

Verified Context

  • Most wiki note pages are centrally generated by 02_System/generate-wiki.ps1 through 03_Web/template.html.
  • This means breadcrumbs for existing and future compiled wiki pages should be solvable with one template/generator change.
  • Standalone pages such as the dashboard are generated separately and may need their own nav treatment.
  • 02_System/generate-wiki.ps1 currently appears to support headings, lists, code fences, hr, and paragraphs, but not normal markdown pipe tables.
  • At least one compiled page appears to show pipe-table source as raw paragraph text instead of rendered HTML table.

Inspect First

  • 02_System/generate-wiki.ps1
  • 03_Web/template.html
  • 02_System/generate-dashboard.ps1
  • 03_Web/public/index.html

Breadcrumb Goal

For compiled wiki pages, add a reusable breadcrumb/nav block near the top.

Minimal acceptable breadcrumb format:

VULTURE / PORTAL / INDEX / <Current Note>

Requirements:

  • INDEX links to index.html
  • the current note label is not a link
  • future generated pages inherit the breadcrumb automatically
  • apply equivalent nav treatment to the dashboard if practical

Table Rendering Investigation

Check whether markdown tables are compiling into raw text instead of HTML tables.

Inspect at least these source notes and their compiled outputs:

  • 01_Wiki/dotnet-agent-integration.md
  • 01_Wiki/community-polyglot-agent-platform.md
  • 01_Wiki/polyglot-platform-adr.md

If table support is missing:

  • add minimal pipe-table parsing to the wiki compiler
  • do not replace the compiler with a full markdown engine
  • only handle normal pipe-table syntax safely

Deliverables

  1. Breadcrumb nav added to generated wiki pages.
  2. Same or equivalent index/back nav added to the dashboard and any other obvious standalone page that should have it.
  3. Markdown tables render as actual HTML tables where expected.
  4. Regenerate affected HTML output.
  5. Run: 
pwsh -NoProfile -ExecutionPolicy Bypass -File 02_System/run-maintenance.ps1

Confirm vault health remains 100/100.

Report Back

Please report:

  • which files changed
  • whether table rendering was in fact broken
  • any pages that intentionally remain outside the shared breadcrumb pattern

References