Schnittstellen, Datentypen und ihr erwartetes Verhalten sind so weit beschrieben, dass Entwickler damit Aufgaben bearbeiten können. Einzelne Fragen dürfen noch offen sein.
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.
Vorbedingung
Was vorher fertig sein muss
Die Personen, die den Entwurf verwenden sollen, können typische Aufgaben benennen und gemeinsam programmieren.
Vorbereitung
Was vor Start vorliegen muss
Versionierter Teilentwurf mit Schnittstellen, Datentypen, erwartetem Verhalten und Beispielen; Szenarioliste, gemeinsamer Editor und Befundprotokoll.
Entwurfsverantwortliche, künftige Nutzer als Reviewer, Moderation und Protokoll. Kläre, wer Szenariofragen beantwortet. Die Reviewer brauchen Programmier- und Fachkenntnisse.
Teile Zweck und Grenzen des Entwurfs, Schnittstellen sowie Beispiele. Erläutere die aktive Rolle der Reviewer.
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.
Halte Code oder Pseudocode und Befunde gleichzeitig sichtbar. Trenne Verständnisfragen von Diskussionen über neue Entwurfsoptionen.
Kernfrage
Die eine Frage, die diese Methode beantwortet
Können Entwickler ihre wichtigen Aufgaben mit diesem vorläufigen Entwurf lösen?
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
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
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
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
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
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.
Artefakt
Was am Ende rauskommt
Versioniertes Protokoll mit Szenarien, Code oder Pseudocode, Nutzungshürden, offenen Fragen und nächsten Prüfungen.
Verknüpfe jeden Befund mit Entwurfsversion, Szenario und betroffener Stelle im Code oder Pseudocode. Bewahre frühere Reviews auf.
- 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
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.
Stolperfallen
Symptome erkennen, gegensteuern
Kurzüberblick, vollständiger Text steht in der jeweiligen Phase im Ablauf
- Entwickler einladen und Unterlagen vorbereitenDie Präsentation zeigt nur interne Architekturdiagramme.In der Phase ansehen
- Methode und Entwurf vorstellenDie Sitzung springt direkt zu einem Alternativentwurf.In der Phase ansehen
- Anwendungsszenarien sammeln und priorisierenNur die vorbereiteten Erfolgsbeispiele werden bewertet.In der Phase ansehen
- Szenarien gemeinsam in Code durchspielenDie Entwurfsverantwortlichen schreiben die Lösung für die Reviewer.In der Phase ansehen
- Befunde und nächste Überarbeitung vereinbarenEin gelöstes Szenario wird als Freigabe für alle Qualitätsziele verstanden.In der Phase ansehen
Entwickler einladen und Unterlagen vorbereiten
Die Präsentation zeigt nur interne Architekturdiagramme.
Ergänze nutzbare Schnittstellen und Beispiele aus Sicht der aufrufenden Anwendung.
Methode und Entwurf vorstellen
Die Sitzung springt direkt zu einem Alternativentwurf.
Lenke die Diskussion auf die Frage, wie die Entwickler die vorliegenden Schnittstellen nutzen können.
Anwendungsszenarien sammeln und priorisieren
Nur die vorbereiteten Erfolgsbeispiele werden bewertet.
Lass die Reviewer eigene Aufgaben ergänzen und die Auswahl selbst gewichten.
Szenarien gemeinsam in Code durchspielen
Die Entwurfsverantwortlichen schreiben die Lösung für die Reviewer.
Lass die Reviewer selbst weiterarbeiten und halte fest, welche Unterstützung sie benötigen.
Befunde und nächste Überarbeitung vereinbaren
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.
Abbruchkriterien
Wann du anhalten, Voraussetzungen klären oder einen anderen Ansatz wählen solltest
Methodenanleitung durchgearbeitet?
Zum Steckbrief für Zweck, ähnliche Methoden und Quellen oder direkt zur nächsten Methode im Katalog.

