Research and record an architecture choice
Move from an unfamiliar option space to a cited decision record grounded in the current repository.
Use when
An architecture decision involves current technology, meaningful tradeoffs, and future constraints.
Outcome
A recommendation and ADR that preserve both the choice and the forces behind it.
The sequence
4 deliberate steps
- 01Open prompt
Understand the current system
Map the affected domain path and existing ownership boundaries.
- 02Open prompt
Learn the candidate models
Use official sources to understand state, failure, deployment, and operational ownership.
- 03Open prompt
Compare against project criteria
Include adoption, migration, operation, and eventual removal costs.
- 04Open prompt
Record the decision
Write context, alternatives, consequences, uncertainty, and revisit triggers.