Alexandria
Decisions (ADRs)

Decisions

Architecture Decision Records of Alexandria, the current Vocabulary Hub v0.3.0 decisions and the historical records of the removed identity prototype.

Architecture Decision Records (ADRs)

A record captures a decision that was expensive to make and would be expensive to reverse: its context, the decision, its consequences and what would change it.

Records are never rewritten once accepted. A decision that no longer holds is superseded by a later record and keeps its original text.


Current

IDDecisionStatusDate
0010Vocabulary Hub v0.3.0 decisions (DP-1..DP-14), open questions (Q18..Q22) and specification observationsAccepted2026-11-11

The full texts live in DECISIONS.md and OPEN_QUESTIONS.md.


Superseded

IDDecisionStatusDate
0009Vocabulary Hub v0.2.1 decisions (DP-1..DP-15) and open questions (Q1..Q17)Superseded by 00102026-11-09

Historical: Identity and Wallet Prototype

These records were written for the identity, OIDC and external-wallet prototype that preceded the Vocabulary Hub. That code was removed from the repository; the records are kept unchanged for context.

IDDecisionDate
0001Bounded contexts are in-process modules, not services2026-08-29
0002One configuration document, overridden from the environment2026-08-29
0003Key material lives in an external wallet2026-08-31
0004Authentication is terminated at the node, not at the client2026-09-01
0005TLS is terminated by a proxy, in development too2026-09-02
0006One image, three deployment shapes2026-09-02
0007Unified wallet port and pluggable IdentityHub adapter2026-09-07
0008Enriched domain models, mutation-and-query pattern, and structured upstream errors2026-09-09

Writing One

Copy docs/adr/template.md, give it the next number, start with Status: Proposed and add a row above.

On this page