Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Architectural decision records

This directory records consequential qslib design decisions and their rationale. Use an ADR when a choice is difficult to reverse, changes public semantics, introduces a major dependency, establishes a cross-cutting abstraction, or affects interoperability with another project.

Copy 0000-template.md and assign the next four-digit number. Keep one decision per file. Use one of these statuses:

  • proposed
  • accepted
  • superseded by ADR-NNNN
  • rejected

An ADR does not override docs/conventions.md silently. A decision that changes a scientific convention must update the convention schema and the normative document explicitly.

Decision index

  • ADR-0001: layered Cargo workspace boundaries
    • accepted
  • ADR-0002: linear algebra and sparse storage - accepted
  • ADR-0003: deterministic randomness and seed derivation - accepted
  • ADR-0004: versioned serialization and columnar artifacts - accepted
  • ADR-0005: Python FFI and array ownership - accepted
  • ADR-0006: public stability and feature policy - accepted
  • ADR-0007: additive standalone SSE migration - accepted
  • ADR-0008: dedicated repository ownership boundary - accepted
  • ADR-0009: registry package identifiers - accepted