Skip to main content

Architecture Decision Records

These record the design decisions you can't infer from the code — the trade-offs, the roads not taken, and why. Each is short: Context → Decision → Consequences. New structural decision → add an ADR here (next number) so the next engineer (human or AI) inherits the reasoning, not just the result.

#Decision
0001Strict DDD with a pure Core
0002Instance state is TPH; a transition replaces the entity
0003cTrader CLI nodes are HTTP + JWT, no SSH/shell
0004CBotBuilder runs on the web host in a sandbox container
0005The AI client uses raw HTTP, not the Anthropic SDK
0006Copy hosting is coordinated by an atomic DB lease