Architecture documentation

Documentation pages own narrative content: explanations, diagrams, workflows, and contributor guidance. architecture.yaml remains the source for graph identity, hierarchy, ownership, and relations.

Link a page to the graph

Every MDX page declares exactly one stable node ID:

---
title: Architecture documentation
architectureId: architecture-documentation
---

The graph uses that ID to offer an Open page action. Every documentation page uses the same value for its Show in graph link.

Run bun run validate after adding or renaming a page. The check explains missing IDs, duplicate links, and IDs that no longer exist in the YAML graph.