Architecture Decision Record (ADR)
Document technical architecture decisions with context, options considered, and consequences
About the Architecture Decision Record (ADR) Prompt Template
This technical template assigns the AI the role of a software architect who writes clear, useful ADRs that help future engineers understand why decisions were made, so the prompt it builds is framed by genuine subject-matter expertise rather than a generic request.
What it does: Write an ADR for your decision in the context of your project.
You fill in 5 fields (3 required, 2 optional), and SurePrompts assembles a complete, structured prompt you can paste straight into ChatGPT, Claude, or Gemini.
Create technical documentation, code explanations, and developer-focused content with AI.
How to Use This Template
- 1
Fill in Decision to Document
e.g., Use PostgreSQL over MongoDB, Adopt microservices, Switch to Server Components
- 2
Fill in Project / System Context
e.g., Our payment processing service, E-commerce platform, Mobile app backend
- 3
Fill in Options Considered
What alternatives were evaluated? e.g.: - PostgreSQL - MongoDB - DynamoDB - Stick with current MySQL
- 4
Fill in Key Constraints
What limits the decision? e.g.: - Must handle 10K req/sec - Team only has SQL experience - Budget: $500/month for infra - Must be HIPAA compliant
- 5
Fill in Decision Status
Enter the decision status for your prompt.
- 6
Copy your prompt
Click the copy button to copy your generated prompt, then paste it into your preferred AI tool.
Template Fields
Every field below maps to a part of the finished Architecture Decision Record (ADR) prompt. Required fields shape the core request; optional fields add detail and control.
A required input that takes a short line of text.
Example: e.g., Use PostgreSQL over MongoDB, Adopt microservices, Switch to Server Components
A required input that takes a short line of text.
Example: e.g., Our payment processing service, E-commerce platform, Mobile app backend
A required input that takes a longer, multi-line value.
Example: What alternatives were evaluated? e.g.: - PostgreSQL - MongoDB - DynamoDB - Stick with current MySQL
An optional input that takes a longer, multi-line value.
Example: What limits the decision? e.g.: - Must handle 10K req/sec - Team only has SQL experience - Budget: $500/month for infra - Must be HIPAA compliant
An optional input that takes one option from a list. Choose from 4 preset choices.
Available choices:
Related Resources
Proof of Work: Show How AI 10x'd Your Output
Make your AI-boosted productivity visible to managers and clients without overclaiming. Honest, concrete ways to document and present the impact of your work.
5 Prompt Patterns for API Documentation and Integration
Copy-paste prompt templates for writing API docs, generating integration guides, troubleshooting endpoints, and creating SDK examples.
5 Prompt Patterns for AI-Assisted Code Review
Five prompt patterns for thorough AI code reviews. Covers security audits, performance checks, readability, bug detection, and architecture review.
Related Templates
Bug Report
Write a clear, actionable bug report that developers can act on immediately
README Generator
Create a professional README.md for any project or repository
API Endpoint Documentation
Document an API endpoint with request/response examples
Git Commit Message
Write clear, conventional commit messages with proper scope and description