We use Architecture Decision Records.
You can read about the general approach on the GDS Way page on Architecture Decisions and specifics about our implementation at ADR000 - Record Architecture Decisions. Our template ADR is ADRXXX.
In general we will follow the GDS Way, so these records will cover decisions that:
- are not already covered in the GDS Way
- are covered in the GDS Way, but have specific implementation details which need to be captured
- diverge from the guidance in the GDS Way