methodatlas
MethodenanleitungArchitecture

ARID (Active Reviews for Intermediate Designs)

Die Anleitung zur Methode: Voraussetzungen und Materialien klären, den gesamten Ablauf verstehen und Ergebnisse, Stolperfallen sowie Abbruchkriterien nachschlagen.

KomplexitätMittel
Zeit2–4 h Review als Planungsrahmen; Vorbereitung und Auswertung zusätzlich
TeilnehmendeEntwurfsverantwortliche, Entwickler als Anwender und Moderation
FormatWorkshop + Async
ReifegradEstablished
Arbeitsplan erstellen
01

Vorbedingung

Was vorher fertig sein muss

Vorher abschließenAnwendbarer Teilentwurf

Schnittstellen, Datentypen und ihr erwartetes Verhalten sind so weit beschrieben, dass Entwickler damit Aufgaben bearbeiten können. Einzelne Fragen dürfen noch offen sein.

Ergänze eine grobe Architekturidee zunächst um Schnittstellen und Beispiele für die gemeinsame Codeübung.
Vorher abschließenEntwickler als Nutzer des Entwurfs

Die Personen, die den Entwurf verwenden sollen, können typische Aufgaben benennen und gemeinsam programmieren.

Eine Durchsicht allein hilft bei der Vorbereitung. Für das aktive Review üben die künftigen Nutzer gemeinsam mit dem Entwurf.
02

Vorbereitung

Was vor Start vorliegen muss

Materialien

Versionierter Teilentwurf mit Schnittstellen, Datentypen, erwartetem Verhalten und Beispielen; Szenarioliste, gemeinsamer Editor und Befundprotokoll.

Personen / Rollen

Entwurfsverantwortliche, künftige Nutzer als Reviewer, Moderation und Protokoll. Kläre, wer Szenariofragen beantwortet. Die Reviewer brauchen Programmier- und Fachkenntnisse.

Vorabinfos

Teile Zweck und Grenzen des Entwurfs, Schnittstellen sowie Beispiele. Erläutere die aktive Rolle der Reviewer.

Zeitbedarf

Für einen begrenzten Review-Termin dienen 2 bis 4 Stunden als Planungsrahmen. Plane Vorbereitung und Auswertung zusätzlich; der Gesamtaufwand richtet sich nach Entwurf und Szenarien.

Setup

Halte Code oder Pseudocode und Befunde gleichzeitig sichtbar. Trenne Verständnisfragen von Diskussionen über neue Entwurfsoptionen.

03

Kernfrage

Die eine Frage, die diese Methode beantwortet

Können Entwickler ihre wichtigen Aufgaben mit diesem vorläufigen Entwurf lösen?

04

Ablauf

Phasen mit Ziel, Durchführung, Ergebnis und Stolperfalle

ARID hilft, Schnittstellen zu erproben, während sich ein Entwurf noch ändern lässt. Die Entwickler, die später damit arbeiten sollen, wählen typische Aufgaben aus und lösen sie gemeinsam. Dafür schreiben sie Code oder Pseudocode, also einen vereinfachten Programmablauf. So zeigt sich, welche Schnittstellen gut nutzbar sind und wo Angaben zum Verhalten fehlen oder sich widersprechen.

ARID-Review-Protokoll

Fiktives Lehrbeispiel

Dokumentvorlage für das eigene Review. Ein separates fiktives Beispiel zeigt die Arbeit an einer Reservierungsbibliothek.

Entwurf und Reviewer

Entwurfsversion, Grenzen, beteiligte Entwickler und Review-Rollen eintragen.

Reservierungsbibliothek v0.3; zwei aufrufende Teams; Moderation Alex.

Szenarien und Auswahl

Aufgaben, Prioritäten, Auswahlgründe und noch offene Szenarien dokumentieren.

Sichere Wiederholung nach Timeout hat höchste Priorität; Stornierung bleibt offen.

Code und Beobachtungen

Code oder Pseudocode mit verwendeten Schnittstellen, Rückfragen und Annahmen verknüpfen.

Nach einem Timeout bleibt offen, ob reserve(request) erfolgreich war; ein erneuter Aufruf könnte doppelt reservieren.

Befunde und Überarbeitung

Nutzungshürde, betroffene Stelle, Verantwortliche und erneute Prüfung erfassen.

Auftrag durch Idempotency-Key eindeutig kennzeichnen und Statusabfrage ergänzen; anschließend das Szenario erneut erproben.

Das Beispiel veranschaulicht die Methode mit erfundenen Angaben.

Paul C. Clements: Active Reviews for Intermediate Designs (SEI, 2000)

  1. 1

    Vorbereiten

    Entwickler einladen und Unterlagen vorbereiten

    Ziel

    Entwickler können mit den Unterlagen eine typische Aufgabe beginnen.

    Voraussetzungen für diesen Schritt

    • Abgegrenzter Teilentwurf
    • Entwurfsverantwortliche und Entwickler, die den Entwurf nutzen werden

    Durchführung

    • Lade Entwickler ein, die den Entwurf später nutzen sollen. Sie übernehmen die Prüfung als Reviewer. Verteile Moderation, Protokoll und Unterstützung bei Szenariofragen.
    • Beschreibe Schnittstellen, Datentypen und erwartetes Verhalten anhand kurzer Beispiele. Probe die Präsentation mit der Moderation.
    • Erstelle erste Szenarien als Anregung und teile Einladung, Unterlagen und Agenda.

    Ergebnis

    Nutzbare Unterlagen und verteilte Rollen

    Prüfe, ob Unterlagen, Beispiel und Rollen für den Termin bereitstehen.

    Qualitätscheck

    Können Entwickler mit den Unterlagen eine typische Aufgabe beginnen?

    Stolperfalle

    Die Präsentation zeigt nur interne Architekturdiagramme. Ergänze nutzbare Schnittstellen und Beispiele aus Sicht der aufrufenden Anwendung.

    Zeitlicher Rahmen: Vor dem Termin vorbereiten; Zeit nach Umfang einplanen.

  2. 2

    Einführen

    Methode und Entwurf vorstellen

    Ziel

    Alle kennen das Vorgehen und den angebotenen Entwurf.

    Voraussetzungen für diesen Schritt

    • Entwurfsunterlagen und erste Szenarien

    Durchführung

    • Erkläre, dass Reviewer den Entwurf aktiv verwenden und dabei Befunde festhalten.
    • Lass die Entwurfsverantwortlichen Schnittstellen und Beispiele zeigen. Kläre Verständnisfragen und protokolliere fehlende Informationen.
    • Sammle Fragen zur internen Umsetzung, zu Entwurfsentscheidungen und zu Alternativen für die Nacharbeit.

    Ergebnis

    Gemeinsames Verständnis und offene Fragen

    Halte Verständnisfragen fest und kennzeichne Angaben, die noch ergänzt werden müssen.

    Qualitätscheck

    Sind die Schnittstellen und ihr erwartetes Verhalten verständlich?

    Stolperfalle

    Die Sitzung springt direkt zu einem Alternativentwurf. Lenke die Diskussion auf die Frage, wie die Entwickler die vorliegenden Schnittstellen nutzen können.

    Zeitlicher Rahmen: Zeit für die Einführung nach Umfang des Entwurfs planen.

  3. 3

    Auswählen

    Anwendungsszenarien sammeln und priorisieren

    Ziel

    Die Entwickler bestimmen die relevanten Aufgaben für das Review.

    Voraussetzungen für diesen Schritt

    • Verstandener Entwurf
    • Erste Szenarien als Anregung

    Durchführung

    • Sammle Aufgaben, die Entwickler mit dem Entwurf lösen müssen, einschließlich Fehler- und Grenzfällen.
    • Fasse doppelte Szenarien zusammen. Lass die Reviewer bestimmen, welche Aufgaben für ihre Arbeit am wichtigsten sind.
    • Halte fest, welche Szenarien ihr auswählt und welche für spätere Reviews offenbleiben.

    Ergebnis

    Priorisierte Anwendungsszenarien

    Notiere zu jeder ausgewählten Aufgabe, warum sie für die spätere Nutzung wichtig ist.

    Qualitätscheck

    Stammen die priorisierten Aufgaben von Entwicklern, die den Entwurf später nutzen?

    Stolperfalle

    Nur die vorbereiteten Erfolgsbeispiele werden bewertet. Lass die Reviewer eigene Aufgaben ergänzen und die Auswahl selbst gewichten.

    Zeitlicher Rahmen: Gemeinsamer Terminabschnitt für die Auswahl.

  4. 4

    Anwenden

    Szenarien gemeinsam in Code durchspielen

    Ziel

    Konkrete Nutzungshürden werden bei der Anwendung sichtbar.

    Voraussetzungen für diesen Schritt

    • Priorisierte Szenarien
    • Schnittstellen und Beispiele

    Durchführung

    • Beginne mit dem höchst priorisierten Szenario und lass die Reviewer gemeinsam Code oder Pseudocode verfassen.
    • Verwende die angebotenen Schnittstellen und halte Rückfragen, Annahmen, fehlende Dienste und unklare Fehlerbehandlung direkt an der betroffenen Stelle fest.
    • Lass die Entwurfsverantwortlichen Sachfragen klären. Die Reviewer schreiben selbst die nötigen Aufrufe. Bearbeite so die weiteren priorisierten Szenarien.

    Ergebnis

    Code oder Pseudocode mit Befunden

    Ordne jede Frage oder Hürde der betroffenen Stelle im Code oder Pseudocode zu.

    Qualitätscheck

    Lösen die Reviewer die Aufgabe mit den angebotenen Schnittstellen?

    Stolperfalle

    Die Entwurfsverantwortlichen schreiben die Lösung für die Reviewer. Lass die Reviewer selbst weiterarbeiten und halte fest, welche Unterstützung sie benötigen.

    Zeitlicher Rahmen: Hier liegt der Schwerpunkt; komplexe Szenarien können Stunden dauern.

  5. 5

    Sichern

    Befunde und nächste Überarbeitung vereinbaren

    Ziel

    Die Entwurfsverantwortlichen erhalten nachvollziehbare Ergebnisse.

    Voraussetzungen für diesen Schritt

    • Code oder Pseudocode und Befunde

    Durchführung

    • Fasse bearbeitete Szenarien, erfolgreiche Wege und Hindernisse zusammen. Bestätige die Formulierung der Befunde mit das Reviewern.
    • Benenne Verantwortliche für jede Überarbeitung, fachliche Klärung und technische Prüfung.
    • Dokumentiere offene Szenarien und vereinbare die erneute Erprobung geänderter Schnittstellen.

    Ergebnis

    Review-Protokoll mit Überarbeitung und erneuter Prüfung

    Verknüpfe Überarbeitungen mit den betroffenen Szenarien und vereinbare deren erneute Prüfung.

    Qualitätscheck

    Zeigt jeder Befund, bei welcher Aufgabe und an welcher Stelle er entstanden ist?

    Stolperfalle

    Ein gelöstes Szenario wird als Freigabe für alle Qualitätsziele verstanden. Benenne die erfolgreich bearbeiteten Szenarien und die Qualitätsziele, die weitere technische Prüfungen erfordern.

    Zeitlicher Rahmen: Abschlussblock und spätere erneute Prüfung.

05

Artefakt

Was am Ende rauskommt

Form

Versioniertes Protokoll mit Szenarien, Code oder Pseudocode, Nutzungshürden, offenen Fragen und nächsten Prüfungen.

Versionierung / Ownership

Verknüpfe jeden Befund mit Entwurfsversion, Szenario und betroffener Stelle im Code oder Pseudocode. Bewahre frühere Reviews auf.

Tool-Alternativen
  • Gemeinsamer Editor für Code oder Pseudocode
  • Szenario- und Befundliste
  • Versionierte Entwurfsunterlagen

arid-markdown.md

Plane Zeit für die Vorbereitung und einen gemeinsamen Review-Termin ein. Richte den Umfang an den wichtigsten Anwendungsszenarien aus.

ARID (Active Reviews for Intermediate Designs): Arbeitsvorlage

Fragestellung

Noch zu klären

Gewünschtes Ergebnis

Noch zu klären

Rahmen

Gesamtes Review Zeit: Für einen begrenzten Review-Termin dienen 2 bis 4 Stunden als Planungsrahmen. Plane Vorbereitung und Auswertung zusätzlich; der Gesamtaufwand richtet sich nach Entwurf und Szenarien.

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

Vorbereitung für diesen Umfang

Methodische Grundausstattung

  • Materialien: Versionierter Teilentwurf mit Schnittstellen, Datentypen, erwartetem Verhalten und Beispielen; Szenarioliste, gemeinsamer Editor und Befundprotokoll.
  • Rollen: Entwurfsverantwortliche, künftige Nutzer als Reviewer, Moderation und Protokoll. Kläre, wer Szenariofragen beantwortet. Die Reviewer brauchen Programmier- und Fachkenntnisse.
  • Vorab-Infos: Teile Zweck und Grenzen des Entwurfs, Schnittstellen sowie Beispiele. Erläutere die aktive Rolle der Reviewer.
  • Gesamter Zeitbedarf: Für einen begrenzten Review-Termin dienen 2 bis 4 Stunden als Planungsrahmen. Plane Vorbereitung und Auswertung zusätzlich; der Gesamtaufwand richtet sich nach Entwurf und Szenarien.
  • Setup: Halte Code oder Pseudocode und Befunde gleichzeitig sichtbar. Trenne Verständnisfragen von Diskussionen über neue Entwurfsoptionen.

Für die Arbeitsschritte bereitstellen

Vorbereiten: Entwickler einladen und Unterlagen vorbereiten

  • Abgegrenzter Teilentwurf
  • Entwurfsverantwortliche und Entwickler, die den Entwurf nutzen werden

Einführen: Methode und Entwurf vorstellen

  • Entwurfsunterlagen und erste Szenarien

Auswählen: Anwendungsszenarien sammeln und priorisieren

  • Verstandener Entwurf
  • Erste Szenarien als Anregung

Anwenden: Szenarien gemeinsam in Code durchspielen

  • Priorisierte Szenarien
  • Schnittstellen und Beispiele

Sichern: Befunde und nächste Überarbeitung vereinbaren

  • Code oder Pseudocode und Befunde

ARID-Review-Protokoll

Entwurf und Reviewer

Entwurfsversion, Grenzen, beteiligte Entwickler und Review-Rollen eintragen.

...

Szenarien und Auswahl

Aufgaben, Prioritäten, Auswahlgründe und noch offene Szenarien dokumentieren.

...

Code und Beobachtungen

Code oder Pseudocode mit verwendeten Schnittstellen, Rückfragen und Annahmen verknüpfen.

...

Befunde und Überarbeitung

Nutzungshürde, betroffene Stelle, Verantwortliche und erneute Prüfung erfassen.

...

Reale Angaben und Belege ergänzen. Ungeklärtes ausdrücklich markieren.

Paul C. Clements: Active Reviews for Intermediate Designs (SEI, 2000)

Vorbereiten: Entwickler einladen und Unterlagen vorbereiten

Erwartetes Artefakt: Nutzbare Unterlagen und verteilte Rollen

Prüfe, ob Unterlagen, Beispiel und Rollen für den Termin bereitstehen.

Eintrag:

...

  • Können Entwickler mit den Unterlagen eine typische Aufgabe beginnen?

Einführen: Methode und Entwurf vorstellen

Erwartetes Artefakt: Gemeinsames Verständnis und offene Fragen

Halte Verständnisfragen fest und kennzeichne Angaben, die noch ergänzt werden müssen.

Eintrag:

...

  • Sind die Schnittstellen und ihr erwartetes Verhalten verständlich?

Auswählen: Anwendungsszenarien sammeln und priorisieren

Erwartetes Artefakt: Priorisierte Anwendungsszenarien

Notiere zu jeder ausgewählten Aufgabe, warum sie für die spätere Nutzung wichtig ist.

Eintrag:

...

  • Stammen die priorisierten Aufgaben von Entwicklern, die den Entwurf später nutzen?

Anwenden: Szenarien gemeinsam in Code durchspielen

Erwartetes Artefakt: Code oder Pseudocode mit Befunden

Ordne jede Frage oder Hürde der betroffenen Stelle im Code oder Pseudocode zu.

Eintrag:

...

  • Lösen die Reviewer die Aufgabe mit den angebotenen Schnittstellen?

Sichern: Befunde und nächste Überarbeitung vereinbaren

Erwartetes Artefakt: Review-Protokoll mit Überarbeitung und erneuter Prüfung

Verknüpfe Überarbeitungen mit den betroffenen Szenarien und vereinbare deren erneute Prüfung.

Eintrag:

...

  • Zeigt jeder Befund, bei welcher Aufgabe und an welcher Stelle er entstanden ist?

Offene Fragen und nächste Schritte

...

Methodenanleitung: https://methodatlas.meierhoff-systems.de/de/methods/arid/run-sheet

06

Beispielausgabe

Konkret gefülltes Szenario, fiktives Beispiel

Fiktives Beispiel zur Orientierung. Die genannten Mengen und Zeiten beschreiben diesen Fall und sind keine allgemeine Vorgabe.

arid-beispiel.md

Konkret gefülltes Szenario, fiktives Beispiel

Fiktiv: Zwei Teams erproben eine Reservierungsbibliothek. Nach einer Zeitüberschreitung wollen sie eine Reservierung sicher wiederholen. Im gemeinsamen Pseudocode rufen sie reserve(request) erneut auf. Dabei wird deutlich: Für eine sichere Wiederholung brauchen sie einen eindeutigen Schlüssel für denselben Auftrag, einen Idempotency-Key. Außerdem müssen sie den Status der ersten Reservierung abfragen können. Die Entwurfsverantwortliche ergänzt beides in den Schnittstellenregeln. Das Team erprobt dasselbe Szenario erneut. Laufzeit und Verhalten unter Last untersucht es in eigenen Tests.

07

Stolperfallen

Symptome erkennen, gegensteuern

Kurzüberblick, vollständiger Text steht in der jeweiligen Phase im Ablauf

  1. Entwickler einladen und Unterlagen vorbereitenDie Präsentation zeigt nur interne Architekturdiagramme.In der Phase ansehen
  2. Methode und Entwurf vorstellenDie Sitzung springt direkt zu einem Alternativentwurf.In der Phase ansehen
  3. Anwendungsszenarien sammeln und priorisierenNur die vorbereiteten Erfolgsbeispiele werden bewertet.In der Phase ansehen
  4. Szenarien gemeinsam in Code durchspielenDie Entwurfsverantwortlichen schreiben die Lösung für die Reviewer.In der Phase ansehen
  5. Befunde und nächste Überarbeitung vereinbarenEin gelöstes Szenario wird als Freigabe für alle Qualitätsziele verstanden.In der Phase ansehen
08

Abbruchkriterien

Wann du anhalten, Voraussetzungen klären oder einen anderen Ansatz wählen solltest

Für bearbeitete Szenarien liegen Code oder Pseudocode und gemeinsam bestätigte Befunde vor.
Blockieren offene Schnittstellenfragen die Übung, wird der Befund gesichert. Überarbeitung und Fortsetzung sind vereinbart.
Überarbeitung und zusätzliche technische Prüfungen haben Verantwortliche.

Methodenanleitung durchgearbeitet?

Zum Steckbrief für Zweck, ähnliche Methoden und Quellen oder direkt zur nächsten Methode im Katalog.