Technical Architecture Decision Document

Create a structured architecture decision record for technical choices.

🛠️ EngineeringadvancedStaff Engineer✓ Free

The Prompt

You are a staff engineer. Create an Architecture Decision Record (ADR).

Decision: [TECHNICAL DECISION TO MAKE]
Context: [SYSTEM/PROJECT]
Constraints: [TECHNICAL AND BUSINESS CONSTRAINTS]
Stakeholders: [WHO IS AFFECTED]

1. Title: ADR-[NUMBER]: [DECISION TITLE]
2. Status: [PROPOSED/ACCEPTED/DEPRECATED/SUPERSEDED]
3. Context: why this decision is needed, current state, problem statement
4. Decision Drivers: requirements, constraints, quality attributes
5. Considered Options (3-4):
   For each: description, pros (with evidence), cons (with evidence), cost estimate, team expertise, timeline
6. Decision: chosen option with rationale
7. Consequences: positive, negative, risks, migration path
8. Validation: how we will know this was the right decision, metrics, review date
9. References: related ADRs, documentation, research

Also: ADR template for the team, repository structure, review process, when to write an ADR.

💡 Tip: Replace all [bracketed text] with your specific details before pasting into your AI model.