Architecture Decision Record

Generate a proper ADR with context, alternatives, and consequences — grounded in your real constraints.

architecturedocumentationdevelopmentchatgpt

Prompt

Help me write an Architecture Decision Record (ADR) for this decision:

**Decision:** {{decision}} (e.g., "Use PostgreSQL over MongoDB for the user service")
**Context:** {{context}}
**Constraints:**
- {{constraint 1}} (e.g., "Team has strong SQL experience")
- {{constraint 2}} (e.g., "Budget: $500/month for database costs")
- {{constraint 3}} (e.g., "Must support full-text search")

Write the ADR with these sections:
1. **Status:** Proposed
2. **Context:** The business/technical context (2-3 sentences)
3. **Decision:** What we decided and why
4. **Alternatives considered:** What else we evaluated (pros/cons table)
5. **Consequences:** What changes as a result (both positive and negative)
6. **Review date:** When to revisit this decision

Variables to customize

Why this prompt works

Constraints force ChatGPT to evaluate options against your real-world limits, not theoretical ideals. The review date ensures decisions don't become permanent by default.

Save this prompt to your library

Organize, version, and access your best prompts across ChatGPT, Claude, and Cursor.

Related prompts

Code Review Assistant

Get thorough code reviews with actionable feedback tailored to your language, framework, and standards.

Code Review with Specific Criteria

Get focused code review feedback with numbered criteria that works on both ChatGPT and Claude.

Explain Complex Code

Get a clear, leveled explanation of any code snippet — calibrated to your experience level.

Debug with Context

Systematic debugging prompt that includes context, error details, and what you've already tried.