• Files under apps/design-library/src/app/library/ are thin route shells.
• Route shells should re-export implementations from apps/design-library/src/gallery/.
• Component docs should use: LibraryDocPageShell, LibraryPageHeader, LibraryDocAnchorNav, then section blocks with stable id values.
• Gallery docs import reusable UI from @spring/ds-react.
• Live pages may be added to libraryNav.ts; placeholder-only pages must not.
• Keep client boundaries at interactive leaves or playground components.
• Prefer Tailwind utilities and existing gallery primitives; avoid new CSS files unless already established nearby.