Template · Repo with templates

Architecture Decision Records: Templates and Examples

Joel Parker Henderson · GitHub (joelparkerhenderson) Free Intermediate

This is a ready-to-use set of lightweight templates for recording why technical decisions were made, so the reasoning survives even if your one developer leaves. Ask your developer to keep a simple record like this in the repo from day one. It is the cheapest, most durable form of the documentation that lowers your bus factor.

• Short written records of key decisions keep the why from living in one head
• Templates make the habit cheap enough to actually maintain
• A new engineer reads these to get up to speed without the old one