methodatlas
Architecture

arc42

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

ArchitectureLowBoth1-2 Tage
Zweck

Ziele, Kontext, Bausteine, Laufzeit, Deployment, Risiken und Entscheidungen konsistent dokumentieren.

Funktionsweise

Die Template-Kapitel werden bedarfsgerecht befüllt und mit Diagrammen, ADRs und Constraints verbunden.

Visuelle Orientierung

Methodenskizze für ein schnelles Grundgefühl.

Visuelle MethodenskizzeArchitekturdokumentation über zwölf klar verbundene Kapitel strukturieren
arc42
1. Einführung und Ziele
2. Randbedingungen
3. Kontextabgrenzung
4. Lösungsstrategie
5. Bausteinsicht
6. Laufzeitsicht
7. Verteilungssicht
8. Konzepte
9. Architekturentscheidungen
10. Qualitätsszenarien
11. Risiken und technische Schulden
12. Glossar
wesentliche Anforderungen, insb. Qualitätsziele
Umsysteme und externe Schnittstellen
Kernideen der Lösung
Struktur des Sourcecodes, Modularisierung
wesentliche Abläufe
Hardware, Infrastruktur und Deployment
Querschnittsthemen, technisch und detailliert
Wichtige Entscheidungen
Qualitätsbaum, Qualitätsanforderungen
bekannte Probleme und Risiken
wesentliche Begriffe

Ablauf

  1. 1Ziele und Stakeholder erfassen
  2. 2Kontext abgrenzen
  3. 3Building Blocks dokumentieren
  4. 4Runtime und Deployment beschreiben
  5. 5Risiken und Entscheidungen verlinken

Ideal für

  • Living Architecture Docs
  • Team Handover
  • Komplexe Systeme

Nicht gut für

  • Wegwerfprojekte
  • Teams ohne Dokumentationsbedarf

Vertiefung

Im Detail

arc42 folgt einer klaren Arbeitslogik: Ziele und Stakeholder erfassen, Kontext abgrenzen, Building Blocks dokumentieren, Runtime und Deployment beschreiben und Risiken und Entscheidungen verlinken. Dadurch wird die Methode nicht nur als Gespräch geführt, sondern als sichtbarer Denkprozess aufgebaut. Die Beteiligten bewegen sich schrittweise von Rohmaterial, Beobachtungen oder Optionen zu einer gemeinsamen Struktur. Als Ergebnis entstehen Architecture Document, Context View und Runtime View, die Entscheidungen, Lernen oder weitere Planung anschlussfähig machen.

Einordnung

arc42 eignet sich besonders für Living Architecture Docs, Team Handover und Komplexe Systeme. Die Methode unterstützt Arbeit rund um architecture, documentation und template und hilft, implizite Annahmen explizit zu machen. Vorsicht ist in Kontexten wie Wegwerfprojekte und Teams ohne Dokumentationsbedarf geboten; dann sollte vorher geklärt werden, ob genug Kontext, Beteiligung und Entscheidungsspielraum vorhanden sind.

Durchführung

Bereite eine klare Leitfrage, die passenden Informationen und eine sichtbare Arbeitsfläche vor. Plane etwa 1-2 Tage mit 1-4 Personen und nutze das Format wahlweise im Workshop oder asynchron. Die Durchführung bleibt leichtgewichtig; hilfreich sind kurze Timeboxes, sichtbare Zwischenergebnisse und ein Parkplatz für offene Fragen.

Output-Artefakte
Architecture DocumentContext ViewRuntime ViewDeployment View
Artefakt-Vorlagen
arc42 ArbeitsvorlageKompakte Arbeitsvorlage für arc42 mit Kontext, Input, Ergebnisartefakten und nächstem Schritt.
markdown
# 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.

Ähnliche Methoden

Alle Methoden