Skip to main content

Architecture decision records

Decisions this app has already made, written down in a short MADR-style format (status, context, decision, consequences). Each record cites the OpenSpec design file it comes from, so the full reasoning stays one click away. Smaller decisions that only matter inside one change stay in that change's design.md under openspec/changes/.

ADRTitleStatus
0001The admin settings section is the only entry point to the UIAccepted
0002External release sources get their own installerAccepted
0003External release checksums are pinned on first useAccepted
0004Access tokens are encrypted at rest and decrypted only inside a callbackAccepted
0005Version pins are enforced by Versioniq and monitored elsewhereAccepted
0006The audit trail is its own table, written best effort and never editedAccepted
0007Lookups across all apps run as background sweeps that store a snapshotAccepted

Adding a record​

Copy the shape of an existing record, take the next number, and add it to the table above. Record only a decision the code already follows, and cite where it was made.