ADR (Architecture Decision Record)
Records a lasting architecture decision: context, options, decision and consequences.
Command: /sf:adr · Methodology: Is2Be Software · Phase: Phase 2 · Design
When to use it
Section titled “When to use it”For every hard-to-reverse decision: architecture, testing, observability, platform.
It’s working if
Section titled “It’s working if”- It compares at least two real options.
- If the decision isn’t made, it says ‘Pending’ with the recommendation.
- It states which decisions or phases it unblocks.
- ADR-001 fixes the full decision sheet and copies it to PROYECTO.md.
Where it fits
Section titled “Where it fits”- Before: To-be architecture options
- After: Build or migration plan, Technical sequence diagrams, Technical stories
Requirements
Section titled “Requirements”-
Your AI connected to the service with your licence key (how to connect).
-
The project set up once with
/sf:setup. -
The outputs of the previous steps (see Where it fits).
When does a decision deserve an ADR?
When it’s hard to reverse, would surprise someone without context, and involved a real trade-off between options.
Can it stay pending?
Yes: it says ‘Pending’ with the technical recommendation and the criteria for deciding.