Decision records

A step of the Cloud application tree on Gradus, in the Product area: Idea, users, decisions, feedback.

Start docs/decisions with one record per technical choice: context, options, decision, consequences. Every pick on this map ends by writing one.

Usually comes after: Project knowledge base.

Prompt for your AI assistant

Create docs/decisions/0000-decision-records.md as the first decision record, in the form context, options, decision, consequences, deciding that this project records every technical choice this way, numbered in order. Add a template file next to it and a line in docs/index.md that explains when to write one and that a record is never edited after the fact, only superseded by a new one.

• Show on map
• This step as Markdown
• Every step of the tree, for AI assistants

This is https://gradus.kazet.blog/tree/cloud-application/step/decision-records as plain HTML. In a browser the page also lets you mark the step forged and copy a message for your AI assistant.