ADR-NNN: [Short Title]
🤖 Generated with Claude Code
✅ Reviewed by [Name], [YYYY-MM-DD]
Co-Authored-By: Claude (noreply@anthropic.com)
Status: Proposed | Accepted | Rejected | Superseded | Deprecated Date: YYYY-MM-DD Deciders: [Namen der Entscheider] Context: [Projekt/Komponente]
Context​
Welches Problem/welche Situation führt zu dieser Entscheidung?
- Background: [Technischer/Business-Context]
- Forces: [Treibende Faktoren, Constraints]
- Assumptions: [Annahmen, die dieser Entscheidung zugrunde liegen]
Decision​
Was wurde entschieden?
Wir werden: [Klare, eindeutige Aussage der Entscheidung]
Begründung:
- [Grund 1]
- [Grund 2]
- [Grund 3]
Considered Options​
Option 1: [Gewählte Option] ✅​
Pro:
- [Vorteil 1]
- [Vorteil 2]
Contra:
- [Nachteil 1]
- [Nachteil 2]
Evaluation: [Warum diese Option gewählt wurde]
Option 2: [Verworfene Alternative]​
Pro:
- [Vorteil 1]
Contra:
- [Nachteil 1 - Deal-Breaker]
- [Nachteil 2]
Warum verworfen: [Klare Begründung]
Option 3: [Weitere Alternative]​
...analog zu Option 2...
Consequences​
Positive​
- [Vorteil 1: Was wird besser]
- [Vorteil 2: Gewinn]
Negative​
- [Nachteil 1: Trade-off, den wir akzeptieren]
- [Nachteil 2: Kosten]
Neutral​
- [Auswirkung 1: Weder gut noch schlecht]
Risks​
- [Risiko 1: Was könnte schiefgehen]
- [Risiko 2: Mitigationsplan]
Implementation Notes​
Wie wird die Entscheidung umgesetzt?
- Aufwand: [Schätzung: Story Points, Personentage]
- Timeline: [Wann wird umgesetzt]
- Dependencies: [Was muss vorher passieren]
- Breaking Changes: [Ja/Nein, Details]
Verification​
Wie wird überprüft, dass die Entscheidung richtig war?
- [Metrik 1: z.B. Performance-Benchmark]
- [Metrik 2: z.B. Developer-Feedback nach 3 Monaten]
- [Metrik 3: z.B. Support-Tickets < X]
Review Date: [YYYY-MM-DD - wann wird Entscheidung evaluiert]
Related​
- ADR-XXX: Vorheriges ADR (
./adr-xxx.md) - Technical Design: Project XYZ (
../project-xyz/technical-design.md) - [Jira Epic: PROJ-123]
Notes​
Weitere Anmerkungen, Diskussionspunkte aus Reviews
Changelog​
| Date | Change | Author |
|---|---|---|
| YYYY-MM-DD | Initial draft | [Name] |
| YYYY-MM-DD | Accepted after team review | [Name] |