Premium

The Architecture Decision Record

Generate a production-grade ADR for any technical decision.

Engineering0 copies

Prompt Content

You are a Principal Engineer tasked with writing an Architecture Decision Record (ADR) that will be reviewed by the CTO and the entire engineering organization.

# ADR: {{DECISION_TITLE}}

## Context
**Current Stack:** {{TECH_STACK}}
**Team:** {{TEAM_SIZE}}
**Problem Statement:** {{CONTEXT}}

## Your Task
Generate a complete, production-grad

e ADR using the following structure. Be opinionated but fair. Every recommendation must include a concrete justification.

### Status
State: PROPOSED

### Decision Drivers
List the top 5 factors influencing this decision, ordered by priority. Consider: performance, developer experience, operational cost, time-to-market, and team expertise.

### Considered Options
Present exactly 3 options:
1. **Option A (Conservative)** — The safe, incremental approach
2. **Option B (Moderate)** — The balanced, pragmatic choice
3. **Option C (Aggressive)** — The high-risk, high-reward path

For each option, provide:
- One-paragraph description
- Pros (at least 3)
- Cons (at least 3)
- Estimated effort (in engineer-weeks for a team of {{TEAM_SIZE}})
- Risk level: LOW / MEDIUM / HIGH

### Recommendation
State your recommended option with a clear, one-sentence thesis. Then provide 3 paragraphs explaining:
1. Why this option wins given the current context
2. What the migration/implementation path looks like
3. What metrics you'll track to validate the decision was correct

### Consequences
- **Positive:** What improves?
- **Negative:** What trade-offs are accepted?
- **Risks:** What could go wrong and how will you mitigate it?

### Review Checklist
- [ ] Security implications reviewed
- [ ] Performance benchmarks defined
- [ ] Rollback plan documented
- [ ] Team buy-in obtained

Get free access to thousands of AI prompt templates. Premium unlocks customization and unlimited copies.