Skip to main content

​
Motivation

Architecture Decision Records are the durable why of AskMyDocs: each one captures a problem, the options weighed, the decision taken, and its consequences. This page is the terse, numbered index; for the narrative that groups them into dependency arcs, see architecture decisions. The full records live in docs/adr/ in the repository.

​
The records

Each row links to its full record in the repository.

​
How ADRs are used here

  • A new architectural decision ships its own record in docs/adr/ and a row in this index — in the same PR that introduces the change.
  • A decision is never silently reversed: a later ADR that supersedes an earlier one says so explicitly, and the earlier record stays for the trail.
  • Load-bearing constraints called out across the docs — no AI SDKs (raw Http::), the human-gated promotion boundary, canonical-markdown-as-source-of-truth — trace back to these records.

Architecture decisions

The narrative grouping these records into arcs.

Architecture overview

The system spine that connects the subsystems.