Technical Architecture Decision Record

Prompt

Write an Architecture Decision Record (ADR) for the following technical decision at [COMPANY NAME].

Decision context:
- Decision title: [SHORT DESCRIPTIVE TITLE]
- Status: [PROPOSED / ACCEPTED / DEPRECATED]
- Decision date: [DATE]
- Deciders: [NAMES OR ROLES]
- Technical context: [DESCRIBE THE SYSTEM AND PROBLEM]
- Options considered: [LIST 2-4 OPTIONS]
- Chosen option: [WHICH OPTION WAS SELECTED]
- Reason for the decision: [WHY]

Write the ADR:

1. **Title and Status**

2. **Context** — The technical situation that necessitated this decision. Architecture constraints, existing systems, and requirements.

3. **Decision Drivers** — The key requirements and considerations that shaped the decision.

4. **Options Considered** — For each option:
   - Description
   - Pros
   - Cons
   - Effort estimate

5. **Decision** — The chosen option and the rationale. Be specific — not just "it's better" but why it better serves the decision drivers.

6. **Consequences** — What becomes easier or harder because of this decision? Technical debt incurred. Future flexibility gained or lost.

7. **Implementation Notes** — Key steps or considerations for implementing this decision.

8. **Review Date** — When this decision should be revisited.