Architecture Planungstool

arc42

Strukturiert Architekturwissen über Ziele, Kontext, Laufzeit und Deployment zu einer lebendigen Systemdokumentation.

Arc42 strukturiert Architekturwissen so, dass Teams System, Entscheidungen und Risiken konsistent dokumentieren können. Die Vorlage baut ein lebendiges Architekturverständnis statt verstreuter Notizen auf.

Kernfrage

Welchen Systemkontext, welche Randbedingungen und Entscheidungen muss die Architektur vermitteln?

arc42 planen Methodenanleitung

Vergleich starten

Feedback gebenHilft dir diese Methode?

Teilnehmende: 1-4
Zeit: 1-2 Tage

Die Schritte bilden einen möglichen Arbeitsweg. Passe sie an Zweck und verfügbare Belege der Methode an.

Papierillustration zu arc42 mit den zentralen Arbeitsschritten und einem sichtbaren Ergebnis.

Umfang
System und Dokumentationsbedarf festlegen
Benenne System, Stakeholder, zentrale Qualitätsziele und den Zweck der Dokumentation; wähle relevante arc42-Abschnitte.
Ziele
Ziele, Constraints und Kontext dokumentieren
Schreibe Qualitätsziele als priorisierte Szenarien, Constraints mit Quelle sowie Systemkontext und Schnittstellen.
Sichten
Lösungsstrategie und Sichten entwickeln
Beschreibe leitende Entscheidungen und die dafür nötigen Building Block-, Runtime- und Deployment-Sichten. Verknüpfe Diagramme mit ihrem Text.
Pflege
Qualität, Entscheidungen und Pflege sichern
Halte wichtige Decisions mit Status, Risiken und Annahmen fest; verknüpfe Szenarien und definiere Auslöser für Aktualisierung.

Überarbeite das Ergebnis, wenn sich Belege, Kontext oder Wirkung ändern. Halte fest, was sich geändert hat und warum.

Geeignet, wenn

Geeignet für: „Living Architecture Docs“, „Team Handover“. Beteiligte können die nötigen Belege und Entscheidungen einbringen.

Ideal für

Living Architecture Docs
Team Handover
Komplexe Systeme

Nicht gut für

Wegwerfprojekte
Teams ohne Dokumentationsbedarf

Ergebnisse

arc42-Architekturdokumentation
Ausgewählte Architekturabschnitte mit Qualitätsszenarien, Kontext, Entscheidungen und Pflegehinweisen.
Lebende arc42-Dokumentation
Das Artefakt hält Umfang, Datum, Beteiligte, Quellenstand und Verantwortung fest und dokumentiert geänderte Annahmen mit Änderungsgrund.

arc42-Architekturdokumentation

Fiktives Arbeitsbeispiel

Fiktiv, System „Praxisportal“: Top-Qualitätsziel ist Verfügbarkeit während der Praxiszeiten. Kontext: Patient:innen und Praxisverwaltung; keine direkte Zahlungsabwicklung. Strategie: Buchungen zunächst über synchronisierte Verfügbarkeitskopie. Laufzeitfall: Slot reservieren, Bestätigung abwarten, bei Konflikt Alternativen anzeigen. Risiko: verspätete Synchronisierung. Kapitel 1, 3, 4, 6 und 10 zuerst pflegen; übrige Kapitel als bewusst markierte Lücken.

Einführung und Ziele

Stakeholder, Anforderungen und wichtigste Qualitätsziele festhalten.

Fiktiv: Verfügbarkeit während Praxiszeiten priorisiert.

Randbedingungen

Technische, organisatorische und regulatorische Vorgaben benennen.

Datenschutzvorgaben und vorhandenes Praxisverwaltungssystem.

Kontext und Abgrenzung

Systemgrenze, externe Partner und Schnittstellen erklären.

Patient:innen und Praxisverwaltung; keine Zahlungsabwicklung.

Lösungsstrategie

Leitende Ansätze und wichtige Architekturentscheidungen begründen.

Verfügbarkeitskopie mit Konfliktprüfung.

Bausteinsicht

Relevante Bausteine und ihre Verantwortung zeigen.

Booking API, Web-App, Termindatenbank.

Laufzeitsicht

Kritische Szenarien und Interaktionen beschreiben.

Slot reservieren; Bestätigung abwarten.

Verteilungssicht

Infrastruktur und Zuordnung von Softwarebausteinen abbilden.

Hosting und Praxisintegration als noch zu klärende Punkte.

Querschnittliche Konzepte

Wiederkehrende Konzepte und Regeln dokumentieren.

Authentifizierung und Audit-Protokollierung.

Architekturentscheidungen

Wichtige Entscheidungen mit Status und Begründung verknüpfen.

Synchronisationsstrategie in Prüfung.

Qualitätsanforderungen

Qualitätsszenarien messbar formulieren.

Fiktives Szenario: Bei verfügbarer Kalenderkopie beantworten 95 % der Slot-Suchen während der Praxisöffnungszeit die Verfügbarkeit in höchstens 2 Sekunden.

Risiken und technische Schulden

Bekannte Risiken samt Wirkung und Umgang festhalten.

Veraltete Verfügbarkeit kann Doppelbuchung auslösen.

Glossar

Domänenbegriffe konsistent definieren.

Slot bedeutet freigegebenen Zeitraum.

Der Beispieltext ist fiktiv; ersetze ihn durch belegte Projektinformationen.

arc42 at a glance

Erster Schritt

Benenne System, Stakeholder, zentrale Qualitätsziele und den Zweck der Dokumentation; wähle relevante arc42-Abschnitte.

Zur Methodenanleitung

Davor sinnvoll

Architecture

Architecture Inception Canvas

Liefert Business Case und erste Quality Goals als Ausgangspunkt der Doku.

Wie geht es weiter?

Architecture

C4 Model

Füllt das Bausteinsicht-Kapitel mit den passenden C4-Diagrammen.

Papierillustration mit zwei betrachteten Optionen, die zu einem Entscheidungsdokument mit markiertem Status und sichtbaren Konsequenzen führen.

Architecture

Architecture Decision Record

Hält jede in arc42 sichtbare Entscheidung als eigenen Datensatz fest.

Vertiefung

Zweck

Funktionsweise

Das Team füllt die relevanten Kapitel von Kontext über Bausteine bis zu Laufzeit, Deployment und Risiken. Dabei werden Inhalte knapp, referenzierbar und anschlussfähig gehalten, damit Dokumentation und Gespräche dieselbe Basis haben. Am Ende entsteht ein durchgehendes Architekturprofil, das Pflege und Übergaben erleichtert.

Im Detail

Die arc42-Struktur ordnet Architekturwissen in wiedererkennbare Kapitel und verbindet Gespräche, Onboarding und Pflege mit derselben Dokumentationslogik. Gute Anwendung befüllt nur die Abschnitte, die für das konkrete System Orientierung stiften, und verlinkt Entscheidungen statt Textmasse anzuhäufen. Der Nutzen steigt, wenn die Dokumentation laufend mit dem System mitwächst und nicht erst kurz vor einer Übergabe hektisch komplettiert wird.

Durchführung

Verankere arc42 an bestehenden Architekturgesprächen, Reviews und Änderungsanlässen, damit das Format im Alltag benutzt statt nur eröffnet wird. Der Umschlagpunkt wird sichtbar, wenn ein Kapitel erstmals eine reale Entscheidung oder Klärung beschleunigt. Schließe mit einer schlanken Startstruktur, klarer Pflegeverantwortung und wenigen priorisierten Abschnitten für die nächste Iteration.

Die Methodenanleitung führt mit 4 Phasen, Zeitrahmen, 4 Stolperfallen und klaren Abbruchkriterien durch die Umsetzung.

Methodenanleitung öffnen

Deine Einschätzung

Hilft dir diese Methode für dein Vorhaben?

Mit deinem Feedback hilfst du, den Methodatlas weiterzuentwickeln.

Quellen und Themen

Themen

Architektur Dokumentation Kommunikation

Quellen

arc42 at a glancearc42.orgarc42.org von Peter Hruschka und Gernot Starke; beschreibt die zwölf Kapitel der arc42-Vorlage für Architekturdokumentation.

In Playbooks

Architekturdokumentation aufbauenVon verstreutem Architekturwissen zu Views, Entscheidungen und kommunizierbarer Dokumentation.

Artefakt-Vorlagen

arc42: ArbeitsvorlageBereite Entscheidung, Quellenbelege und nächste Prüfung vor.

markdown

arc42-working-template.md

Bereite Entscheidung, Quellenbelege und nächste Prüfung vor.

arc42: Arbeitsvorlage

Fragestellung

Noch zu klären

Gewünschtes Ergebnis

Noch zu klären

Rahmen

Methode durchführen Zeit: Siehe Zeitrahmen im Katalog; keine allgemeine Dauer.

Diese Vorlage während der Arbeit auf Papier oder in einem eigenen Dokument ausfüllen.

Vorbereitung für diesen Umfang

Methodische Grundausstattung

Materialien: Gemeinsame Arbeitsfläche, Quellenbelege und eine abgestimmte Entscheidungsfrage.
Rollen: Architektur, Entwicklung, Betrieb, Fachbereiche, Entscheidungsverantwortung.
Vorab-Infos: Sammle vorhandene Daten, Beispiele, Rahmenbedingungen und relevante Perspektiven.
Gesamter Zeitbedarf: Mehrere fokussierte Termine; Umfang nach Komplexität und Beleglage bestimmen.
Setup: Das Team füllt die relevanten Kapitel von Kontext über Bausteine bis zu Laufzeit, Deployment und Risiken. Dabei werden Inhalte knapp, referenzierbar und anschlussfähig gehalten, damit Dokumentation und Gespräche dieselbe Basis haben. Am Ende entsteht ein durchgehendes Architekturprofil, das Pflege und Übergaben erleichtert.