Decision Records¶
This directory contains decision records for StartMeUp.nz — documenting key choices about governance, tooling, infrastructure, partnerships, and project direction.
While the format is based on Architecture Decision Records, these records capture decisions well beyond architecture: fiscal hosting, legal structure, platform choices, funding models, and operational strategy. If a decision shapes how the project operates or what it commits to, it belongs here.
Each record includes the context, the decision, and its consequences. This keeps our reasoning transparent, traceable, and recoverable — especially as the project grows and contributors change.
Format¶
Records are numbered chronologically and follow a consistent structure:
# N: Title
## Status
(Proposed, Accepted, Deprecated, Superseded)
## Context
Why this decision needed to be made.
## Decision
What we decided and why.
## Consequences
What changed as a result — both positive and negative.
Creating a New Record¶
Create a new Markdown file in this directory with the next available number. There is no required tooling — a text editor and a clear record is all you need. Look at existing records for examples of tone and structure.