PL1-decision-records · Focus
Decision records (ADRs). architecture and technology decisions captured with reasoning, alternatives considered, and context at time of decision; retrievable before related changes
Where does your codebase stand?
Click a level to mark your current maturity. 0
Absent Your level
No decision history; agents re-derive or contradict past choices
1
Nascent Your level
Some decisions documented informally (Slack, meeting notes)
2
Operational Your level
ADRs are a first-class artifact; agent retrieves relevant ADRs before making architecture-adjacent changes
3
Compounding Your level
ADR retrieval is logged; decisions that get re-litigated despite existing ADRs are flagged; decision-recurrence rate trends toward zero
← Previous PL1-primary-source-access Primary source access Next → PL1-design-intent Design intent accessible