methodatlas
Playbook

Architekturentscheidung vorbereiten

Von unscharfem technischen Problem zu dokumentierter, nachvollziehbarer Architekturentscheidung.

Ergebnis

Ein akzeptiertes ADR mit klarem Kontext, geprüften Optionen, Trade-offs und Folgeaktionen.

Ideal für

  • Plattform- und Architekturfragen
  • schwer rückgängig zu machende technische Entscheidungen
  • Teams mit mehreren Stakeholdern

Nicht gut für

  • triviale lokale Implementierungsdetails
  • Entscheidungen ohne echte Alternativen
Ablauf

Methodenpfad

4 Schritte
Vorlagen

Artefakte für dieses Playbook

Markdown

Decision Frame

Vorlage, um eine unklare Entscheidung in Frage, Rollen, Optionen und Evidenzbedarf zu übersetzen.

# Decision Frame: Thema

## Entscheidungsfrage

Welche Entscheidung muss jetzt getroffen werden?

## Kontext

Warum ist die Entscheidung nötig, was passiert ohne Entscheidung?

## Decider und Rollen

- Decider:
- Input:
- Reviewer:
- Informiert:

## Optionen

1. ...
2. ...
3. ...

## Kriterien

- ...

## Constraints

- ...

## Evidenzbedarf

Welche Daten, Tests oder Reviews fehlen noch?

## Nächster Schritt

Owner, Datum, Format.
Markdown

Option Frame

Einheitliche Beschreibung von Handlungsoptionen, damit sie fair vergleichbar werden.

# Option Frame: Optionstitel

## Kurzbeschreibung

Was ist die Option in einem Satz?

## Scope

Was ist enthalten, was ausdrücklich nicht?

## Nutzen

Welches Ziel unterstützt diese Option?

## Kosten und Aufwand

Welche Ressourcen, Laufzeit und Abhängigkeiten entstehen?

## Risiken

Welche negativen Folgen oder offenen Punkte bleiben?

## Annahmen

Welche Voraussetzungen müssen stimmen?

## Entscheidungssignal

Woran erkennen wir, dass diese Option bevorzugt werden sollte?
Markdown

Trade-off Matrix

Markdown-Matrix, um Optionen entlang konkurrierender Kriterien und akzeptierter Nachteile zu vergleichen.

# Trade-off Matrix: Entscheidung

| Kriterium | Gewicht | Option A | Option B | Option C |
|---|---:|---|---|---|
| Nutzen | 30 | | | |
| Kosten | 20 | | | |
| Risiko | 20 | | | |
| Time-to-Learn | 15 | | | |
| Reversibilität | 15 | | | |

## Akzeptierte Nachteile

- Option A akzeptiert:
- Option B akzeptiert:
- Option C akzeptiert:

## Empfehlung

Welche Option wird empfohlen und warum?

## Sensitivität

Welche kleine Änderung an Gewichtung oder Annahme würde die Empfehlung kippen?
Markdown

ADR Markdown Template

Kompakte Vorlage für Architecture Decision Records im Repository oder Wiki.

# ADR-0001: Titel der Entscheidung

**Status:** proposed
**Datum:** YYYY-MM-DD
**Decider:** Vorname Nachname
**Trigger:** Ticket, Incident oder RFC

## Kontext

Welche Situation macht die Entscheidung nötig? Welche Constraints, Quality Attributes oder früheren Entscheidungen sind relevant?

## Optionen

### Option 1: ...
- Pro:
- Contra:

### Option 2: ...
- Pro:
- Contra:

## Entscheidung

Wir entscheiden uns für ...

## Konsequenzen

Positive Folgen:
- ...

Negative Folgen und Risiken:
- ...

Folge-ADRs oder Tickets:
- ...
Abschlusskriterien