---
name: entscheidung-festhalten
description: Dokumentiert eine dauerhafte und folgenreiche Projektentscheidung als Architecture Decision Record. Verwenden, wenn Kontext, gewählte Lösung und Konsequenzen für spätere Arbeiten nachvollziehbar bleiben müssen oder eine frühere Entscheidung ersetzt wird.
---

# Entscheidung festhalten

Erstelle ein kurzes ADR für genau eine bedeutsame Entscheidung. Dokumentiere
keine gewöhnliche Task-Ausführung als ADR.

## Fachliche Grundlage

- [Michael Nygard – Documenting Architecture Decisions](https://cognitect.com/blog/2011/11/15/documenting-architecture-decisions):
  kleine, versionierte Aufzeichnungen mit Status, Kontext, Entscheidung und
  Konsequenzen.
- [MADR – Markdown Architectural Decision Records](https://adr.github.io/madr/):
  schlanke Markdown-Struktur und sichtbare Alternativen.

## Wann ein ADR sinnvoll ist

Erstelle ein ADR, wenn die Entscheidung mindestens eines davon erfüllt:

- Sie beeinflusst Struktur, Schnittstellen, Abhängigkeiten oder wesentliche
  Qualitätsmerkmale.
- Sie lenkt mehrere spätere Tasks oder Beteiligte.
- Eine Umkehr wäre teuer, riskant oder erklärungsbedürftig.
- Der Entscheidungsgrund wäre für eine spätere Person nicht mehr erkennbar.

Erstelle kein ADR für leicht umkehrbare Detailentscheidungen, reine
Arbeitsresultate oder noch offene Fragen.

## Ablauf

1. Prüfe vorhandene ADRs, damit keine bestehende Entscheidung dupliziert wird.
2. Verwende `docs/templates/adr-template.md` und die nächste freie Nummer.
3. Beschreibe den Kontext wertneutral und benenne die wirkenden
   Randbedingungen.
4. Formuliere genau eine Entscheidung und führe positive, negative sowie
   neutrale Folgen auf. Benenne Auswirkungen auf Sicherheit und Datenschutz,
   auch wenn keine erwartet werden.
5. Nenne ernsthaft betrachtete Alternativen. Erfinde keine Scheinoptionen.
6. Setze den Status auf `vorgeschlagen`, solange der zuständige Mensch nicht
   zugestimmt hat.
7. Lösche ersetzte ADRs nicht. Markiere sie als `ersetzt` und verlinke das neue
   ADR.
8. Verknüpfe das ADR in `PLAN.md` oder im betroffenen Task.

## Fertig, wenn

- genau eine dauerhafte, folgenreiche Entscheidung dokumentiert ist;
- Status, Kontext, Entscheidung, Alternativen und Folgen nachvollziehbar sind;
- Sicherheits- und Datenschutzfolgen benannt sind;
- ersetzte Entscheidungen erhalten und miteinander verknüpft bleiben.