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
| ID | Decision | Status | Date |
|---|---|---|---|
| 0010 | Vocabulary Hub v0.3.0 decisions (DP-1..DP-14), open questions (Q18..Q22) and specification observations | Accepted | 2026-11-11 |
The full texts live in DECISIONS.md and OPEN_QUESTIONS.md.
Superseded
| ID | Decision | Status | Date |
|---|---|---|---|
| 0009 | Vocabulary Hub v0.2.1 decisions (DP-1..DP-15) and open questions (Q1..Q17) | Superseded by 0010 | 2026-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.
| ID | Decision | Date |
|---|---|---|
| 0001 | Bounded contexts are in-process modules, not services | 2026-08-29 |
| 0002 | One configuration document, overridden from the environment | 2026-08-29 |
| 0003 | Key material lives in an external wallet | 2026-08-31 |
| 0004 | Authentication is terminated at the node, not at the client | 2026-09-01 |
| 0005 | TLS is terminated by a proxy, in development too | 2026-09-02 |
| 0006 | One image, three deployment shapes | 2026-09-02 |
| 0007 | Unified wallet port and pluggable IdentityHub adapter | 2026-09-07 |
| 0008 | Enriched domain models, mutation-and-query pattern, and structured upstream errors | 2026-09-09 |
Writing One
Copy docs/adr/template.md, give it the next number, start with Status: Proposed and add a row above.