Anomalica records every significant decision as a numbered Architecture Decision Record. Each record captures the context behind the choice, what was decided, and the consequences. Once accepted, records are immutable - to change a decision, a new record supersedes the old one.
Why record decisions
Decisions are made through conversation and research. Without a written record, the reasoning is lost. Future contributors would need to rediscover the same ground. Recording decisions makes them searchable, persistent, and auditable.
What is recorded
Architectural choices (how the pipeline works, what database to use), organisational choices (licensing, language selection, naming conventions), and policy choices (how AI is constrained, how content is verified). Each record follows the same format: Context, Decision, Consequences.
Where to find them
The full set of Architecture Decision Records is maintained on GitHub in the anomalica repository. Anyone can read them, and anyone can propose a new decision or challenge an existing one by opening an issue.