Architecture¶

Audience: three related but distinct readers, kept visibly separate rather than merged into one undifferentiated "Architecture" page: most readers only need Current Architecture; contributors additionally want the Historical Decision Log; anyone evaluating Compono's philosophy wants Design Principles.

This section explains why Compono exists and how it works internally — tradeoffs and rejected alternatives, not just a description of the current shape. It assumes Concepts's mental model already; every page here cross-links to the ADR(s) that made the underlying decision rather than re-deriving the reasoning.

• Design Principles — current, evolving: what Compono believes (composition over object generation, predictability over magic, source-generated by default, deterministic by design).
• Current Architecture — how it works today: Source Generation, Generated Plans and Discovery, The Provider Pipeline, Deterministic Seeding, and Performance.
• Historical Decision Log — the public-facing index into every Accepted/Superseded ADR, for a reader who wants the full paper trail.

This is docs/architecture.md, docs/performance.md, docs/design-principles.md, and docs/manifesto.md's real content, consolidated here per ADR-0030 Amendment 2's "one canonical home" principle — those four pages are now short tombstones pointing back here.