methodatlas
Playbook

Architekturdokumentation aufbauen

Von verstreutem Architekturwissen zu Views, Entscheidungen und kommunizierbarer Dokumentation.

Ergebnis

Eine lebende Architekturdokumentation mit Views, Rationale, Kommunikationsplan und Pflegeverantwortung.

Ideal für

  • Onboarding
  • Architecture Reviews
  • Systeme mit gewachsener Komplexität

Nicht gut für

  • Wegwerfprototypen
  • Dokumentation ohne Wartungsowner
Ablauf

Methodenpfad

4 Schritte
  1. 1ArchitectureArchitecture Document

    arc42

    Struktur für Architekturziele, Kontext, Bausteine und Entscheidungen schaffen.

    SteckbriefRun Sheet
Vorlagen

Artefakte für dieses Playbook

Markdown

arc42 Arbeitsvorlage

Kompakte Arbeitsvorlage für arc42 mit Kontext, Input, Ergebnisartefakten und nächstem Schritt.

# arc42 Arbeitsvorlage

## Ziel

Pragmatisches Template für strukturierte, lebendige Softwarearchitektur-Dokumentation.

## Kontext

Wann und wofür nutzen wir diese Methode?

## Input

Welche Daten, Beobachtungen, Entscheidungen oder Materialien liegen vor?

## Durchführung

Kurze Notizen entlang des Run Sheets.

## Ergebnisartefakte
- Architecture Document:
- Context View:
- Runtime View:
- Deployment View:

## Annahmen und offene Fragen

- ...

## Entscheidung / Nächster Schritt

Owner, Datum und Erfolgssignal.
Canvas

C4 Model Arbeitsvorlage

Kompakte Arbeitsvorlage für C4 Model mit Kontext, Input, Ergebnisartefakten und nächstem Schritt.

# C4 Model Canvas

## Kontext

Wofür wird die Methode eingesetzt?

## Kernfrage

Welche Frage soll am Ende beantwortet sein?

## Input

Welche Daten, Beobachtungen oder Materialien liegen vor?

## Arbeitsfläche

- Bereich 1:
- Bereich 2:
- Bereich 3:
- Beziehungen / Muster:

## Ergebnisartefakte
- Context Diagram:
- Container Diagram:
- Component Diagram:

## Offene Fragen

- ...

## Nächster Schritt

Owner, Datum, Erfolgssignal.
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