Design

Architecture notes, ADRs, and audits

What lives here

This section is the why behind the code. If the Guide tells you how to use hwpapi, the Design section tells you how it got to be shaped this way.

Architecture

  • Architecture overview โ€” the v2 import tree, the two-layer model, the collection protocol, and how they fit together.

Architecture Decision Records

Each ADR documents one accepted decision, its context, alternatives, and consequences. They are the primary historical record for v2 design choices.

Audits and design notes (archived)

These pre-v2 documents led to the redesign. They are kept for provenance โ€” the authoritative current spec is the ADRs plus the live codebase.

Back to top