Decisions should belong to the system, not to whoever was in the room

Most teams do not really have a decision log. They have Slack threads, PR comments, meeting notes, random documents, and a few people who remember why something was done. Months later, the decision is still there, but the reasoning is gone (or it takes a looot time to find it) 😔

I keep one file in the project root: decisions.md. Every meaningful decision goes there with five things: what we decided, why, which alternatives we considered, what it changes, and who or what it affects. Once it is recorded, the agent memory is updated as well, so future work starts with the context instead of repeating the same discussion.

This works beyond software -> A shared decision log makes it easier for someone returning from holiday, joining a project, or investigating an old issue to understand what happened and why. Well, It also removes one of the worst organisational dependencies: people becoming “private storage” for critical context.

Decisions should belong to the system, not to whoever happened to be in the room.