Decision Record
A free architecture decision record (ADR) tool: capture the context, options, and reasoning behind a decision as clean Markdown.
Decision Record is a free tool for writing architecture decision records (ADRs). Fill in the context, the options you considered with their pros and cons, what you chose and why, and the consequences. It produces a clean Markdown record you can copy or download and keep next to your code or in your docs.
Opens in a new tab, as its own standalone app.
Open Decision Record ↗How it works
Give the decision a title and describe the context and the drivers behind it. Add each option you considered with its pros and cons, mark the one you chose, and explain why. The Markdown record updates as you type; copy it or download it as a .md file. Your draft is saved automatically in your browser.
Why I built it
Six months after a technical decision, the question is almost always 'why did we do it this way?', and the answer is usually lost. Writing a short record at the time costs ten minutes. I built this to make that the path of least resistance, using a simple structure based on common ADR formats.
Limitations
Drafts are stored only in your browser (no account, no server), and only one draft is kept at a time - download or copy each record before starting a new one. Clearing your browser site data clears the draft.