Concepts
Decision Records
A decision record documents an important choice, the alternatives considered, and the consequences of that choice.
A decision record documents a choice made by a team.
It should be durable enough to answer future questions such as:
- why did we choose this approach?
- what alternatives were considered?
- where does this guidance apply?
- what should reviewers or implementers do differently because of it?
Example
Title
Use Hono instead of Express
Decision
Adopt Hono for new API services.
Alternatives
- Express
- Fastify
Consequences
- better fit for edge-oriented services
- lower runtime overhead
- migration work for existing Express-heavy codebases
For the workflow detail, continue with Creating Decisions.