📝

Architecture Decision Record Template

Document architectural decisions with context, options, and rationale

prompt template
Write an Architecture Decision Record (ADR) for this decision:

**Decision:** [DECISION — e.g., "Choose PostgreSQL over MongoDB for the main database"]
**Context:** [CONTEXT — e.g., "Building a multi-tenant SaaS with complex relational data"]
**Stakeholders:** [STAKEHOLDERS — e.g., "Backend team, DevOps, CTO"]

Generate an ADR following this format:
1. **Title** — ADR-[NUMBER]: [Decision title]
2. **Status** — Proposed / Accepted / Deprecated / Superseded
3. **Context** — What is the problem? Why does this decision need to be made?
4. **Decision drivers** — Key factors influencing the choice
5. **Options considered** — At least 3 alternatives with pros/cons matrix
6. **Decision** — What was decided and why
7. **Consequences** — Positive, negative, and neutral impacts
8. **Compliance** — How to verify the decision is being followed
9. **Related decisions** — Links to related ADRs

Write in clear, non-technical language that all stakeholders can understand.

How to Use This Prompt

  1. 1Copy the prompt template above
  2. 2Paste into Claude, ChatGPT, or Cursor
  3. 3Replace [bracketed placeholders] with your specific project details
  4. 4Iterate on the AI output to refine and customize the results