Architecture Decision Record Template
Document architectural decisions with context, options, and rationale
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
- 1Copy the prompt template above
- 2Paste into Claude, ChatGPT, or Cursor
- 3Replace [bracketed placeholders] with your specific project details
- 4Iterate on the AI output to refine and customize the results
More Documentation Prompts
Related documentation templates from the vault
API Quickstart Tutorial Writer
Use this prompt to api quickstart tutorial writer with AI assistance
Architecture Decision Record (ADR) Series Generator
Generate a series of Architecture Decision Records documenting key technical choices with context, alternatives, and consequences
Onboarding Guide for New Developers
Use this prompt to onboarding guide for new developers with AI assistance
Git Commit Message Writer
Generate clear, conventional commit messages from git diffs
You Might Also Like
Prompts from other categories that share similar tags
System Design Document Generator
Generate a comprehensive system design document for a new feature or service
API Contract First Design
Design a complete API contract before writing any implementation code
Event-Driven Architecture Blueprint
Design an event-driven system with message brokers and event sourcing
Microservice Boundary Analyzer
Analyze a monolith codebase and recommend microservice boundaries
Keep Exploring the Vault