Architectural Decision Records For an overview, see here. You should use adr-tools to create and manage these records. It has been added to the default devshell.