Eine Schnittstelle entwerfen
Basierend auf „Design It Twice“ aus „A Philosophy of Software Design“: Deine erste Idee ist wahrscheinlich nicht die beste. Erzeuge mehrere grundlegend verschiedene Entwürfe und vergleiche sie.
Arbeitsablauf
1. Anforderungen sammeln
Vor dem Entwurf verstehen:
- Welches Problem löst dieses Modul?
- Wer sind die Aufrufer? (andere Module, externe Benutzer, Tests)
- Was sind die wichtigsten Operationen?
- Gibt es Einschränkungen? (Leistung, Kompatibilität, bestehende Muster)
- Was sollte im Modul verborgen bleiben vs. exponiert werden?
Frage: „Was muss dieses Modul tun? Wer wird es verwenden?“
2. Entwürfe generieren (parallele Unter-Agenten)
Starte 3+ Unter-Agenten gleichzeitig mit dem Aufgaben-Tool. Jeder muss einen grundlegend anderen Ansatz produzieren.
Prompt-Vorlage für jeden Unter-Agenten:
Entwirf eine Schnittstelle für: [Modulbeschreibung]
Anforderungen: [gesammelte Anforderungen]
Einschränkungen für diesen Entwurf: [weise jedem Agenten eine andere Einschränkung zu]
- Agent 1: „Minimiere die Anzahl der Methoden – Ziel: maximal 1-3 Methoden“
- Agent 2: „Maximiere Flexibilität – unterstütze viele Anwendungsfälle“
- Agent 3: „Optimiere für den häufigsten Fall“
- Agent 4: „Lass dich von [bestimmtes Paradigma/Bibliothek] inspirieren“
Ausgabeformat:
1. Schnittstellensignatur (Typen/Methoden)
2. Nutzungsbeispiel (wie der Aufrufer es verwendet)
3. Was dieser Entwurf intern verbirgt
4. Abwägungen dieses Ansatzes
3. Entwürfe präsentieren
Zeige jeden Entwurf mit:
- Schnittstellensignatur – Typen, Methoden, Parameter
- Nutzungsbeispiele – wie Aufrufer es in der Praxis tatsächlich verwenden
- Was es verbirgt – intern gehaltene Komplexität
Präsentiere die Entwürfe nacheinander, damit der Benutzer jeden Ansatz vor dem Vergleich aufnehmen kann.
4. Entwürfe vergleichen
Nachdem alle Entwürfe gezeigt wurden, vergleiche sie nach:
- Schnittstelleneinfachheit: weniger Methoden, einfachere Parameter
- Allgemein vs. spezialisiert: Flexibilität vs. Fokussierung
- Implementierungseffizienz: ermöglicht die Form effiziente interne Abläufe?
- Tiefe: kleine Schnittstelle, die erhebliche Komplexität verbirgt (gut) vs. große Schnittstelle mit dünner Implementierung (schlecht)
- Einfachheit der korrekten Nutzung vs. Anfälligkeit für Fehlgebrauch
Diskutiere Abwägungen in Prosa, nicht in Tabellen. Hebe hervor, wo sich die Entwürfe am meisten unterscheiden.
5. Synthese
Oft kombiniert das beste Design Erkenntnisse aus mehreren Optionen. Frage:
- „Welcher Entwurf passt am besten zu deinem primären Anwendungsfall?“
- „Gibt es Elemente aus anderen Entwürfen, die es wert sind, übernommen zu werden?“
Bewertungskriterien
Aus „A Philosophy of Software Design“:
Schnittstelleneinfachheit: Weniger Methoden, einfachere Parameter = einfacher zu erlernen und korrekt zu verwenden.
Allgemeingültigkeit: Kann zukünftige Anwendungsfälle ohne Änderungen bewältigen. Aber Vorsicht vor Überverallgemeinerung.
Implementierungseffizienz: Ermöglicht die Schnittstellenform eine effiziente Implementierung? Oder erzwingt sie umständliche interne Abläufe?
Tiefe: Kleine Schnittstelle, die erhebliche Komplexität verbirgt = tiefes Modul (gut). Große Schnittstelle mit dünner Implementierung = flaches Modul (vermeiden).
Anti-Patterns
- Lass Unter-Agenten keine ähnlichen Entwürfe produzieren – erzwinge grundlegende Unterschiede
- Überspringe den Vergleich nicht – der Wert liegt im Kontrast
- Implementiere nicht – dies betrifft ausschließlich die Schnittstellenform
- Bewerte nicht nach Implementierungsaufwand