Architecture Decision Records
=============================

This section records key architectural decisions made during development.
Each ADR captures context, options considered, and the chosen approach.

.. toctree::
   :maxdepth: 1
   :caption: Decisions

   adr-001-direct-dict-construction
   adr-002-yaml-mapping-config
   adr-003-orjson-serialization
   adr-004-one-container-per-shape
   adr-005-optional-shacl-validation
