Quartz 4

⚖️ Template 07 — Decision Log (ADR)

2 min read

Abstract

Ein Decision Log hält fest, warum du etwas so entschieden hast — nicht nur was. Das ADR-Pattern (Architecture Decision Record) kommt aus der Software-Entwicklung, funktioniert aber für jede wichtige Entscheidung: Tools, Methoden, Strukturen, Lebensbereiche.

🎯 Wofür?

  • Entscheidungen mit Kontext festhalten
  • Alternativen nicht vergessen (warum wurde X verworfen?)
  • Späteres Hinterfragen ermöglichen ohne erneute Recherche
  • Lernprozess dokumentieren

Note

Die Kernfrage: In 6 Monaten wirst du dich fragen “Warum habe ich das damals so gemacht?” — ein Decision Log beantwortet das.

📋 Frontmatter-Struktur

---
title: "⚖️ ADR-001: Entscheidungstitel"
aliases: [Kurzname der Entscheidung]
tags: [type/decision, topic/bereich, status/accepted, garden/evergreen]
description: "Was wurde entschieden und warum"
decision-date: 2026-04-21
status: accepted     # proposed | accepted | deprecated | superseded
superseded-by: ""    # Wenn eine neuere Entscheidung diese ersetzt
publish: true
---

Status-Optionen:

  • proposed — Noch in Diskussion
  • accepted — Entschieden und aktiv
  • deprecated — Nicht mehr gültig, aber historisch relevant
  • superseded — Durch neuere Entscheidung ersetzt (→ superseded-by)

🏗️ ADR-Struktur

Das klassische ADR-Format in 5 Blöcken:

1. Status & Datum
2. Kontext (Warum musste entschieden werden?)
3. Entscheidung (Was wurde entschieden?)
4. Alternativen (Was wurde erwogen und verworfen?)
5. Konsequenzen (Was folgt daraus?)

✍️ Beispiel-ADR

→ Echte Beispielnotiz: ADR-001-Quartz-als-SSG

📊 Decision-Index als MOC

Wenn du mehrere Entscheidungen dokumentierst, lohnt sich eine Übersicht:

## ⚖️ Alle Entscheidungen
 
| # | Entscheidung | Datum | Status |
|---|-------------|-------|--------|
| ADR-001 | [[ADR-001-Quartz-als-SSG]] | 2026-04-21 | ✅ Accepted |
| ADR-002 | [[ADR-002-Tag-Hierarchie]] | 2026-04-21 | ✅ Accepted |
| ADR-003 | [[ADR-003-Cloudflare-Deployment]] | 2026-04-21 | ✅ Accepted |

🔄 Status-Workflow

graph LR
    A[💭 Proposed] --> B[✅ Accepted]
    B --> C[🔄 Deprecated]
    B --> D[⬆️ Superseded]
    D --> E[Neue ADR]

Superseded-Kette:

> [!warning] Diese Entscheidung wurde ersetzt
> 
> Durch [[ADR-005-Neue-Entscheidung]] (2026-06-01) überholt.

💡 Wann ein ADR schreiben?

SituationADR?
Tool-Auswahl (A vs. B vs. C)✅ Ja
Struktur-Entscheidung✅ Ja
Methoden-Auswahl✅ Ja
Triviale Einstellung❌ Nein
Offensichtliche Wahl ohne Alternativen❌ Nein

Tip

Faustregel: Wenn du für eine Entscheidung recherchiert hast oder länger als 5 Minuten nachgedacht hast — schreib ein ADR.

🔗 ADRs mit Projekten verknüpfen

## Im Projekt: [[Projekt-Digital-Garden-Aufbau]]
Relevante Entscheidungen:
- [[ADR-001-Quartz-als-SSG]] — Tool-Wahl
- [[ADR-002-Tag-Hierarchie]] — Struktur

Und im Projekt rückverlinken:

## 🔗 Entscheidungen
Siehe [[07-decision-log]] für ADR-Übersicht.

🌱 Verwandte Notizen

  • 05-project — Projekte verlinken auf relevante ADRs
  • 06-daily — Entscheidungs-Prozesse in Tagesnotizen festhalten
  • 03-article — Wenn aus einer Entscheidung ein Essay wird

Dieser Leitfaden: Template 07 von 09

Graph View

Backlinks