Was macht Schnittstelle entwerfen?
Basierend auf „Design It Twice“ aus „A Philosophy of Software Design“: Deine erste Idee ist selten die beste. Erzeuge mehrere radikal unterschiedliche Designs und vergleiche sie dann.
Workflow
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 soll im Inneren verborgen vs. nach außen sichtbar sein?
Frage: „Was muss dieses Modul tun? Wer wird es nutzen?“
2. Designs erzeugen (parallele Sub-Agenten)
Starte gleichzeitig 3+ Sub-Agenten mit dem Task-Tool. Jeder muss einen radikal anderen Ansatz liefern.
Prompt-Vorlage für jeden Sub-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 Methodenanzahl – maximal 1-3 Methoden“
- Agent 2: „Maximiere die Flexibilität – unterstütze viele Anwendungsfälle“
- Agent 3: „Optimiere für den häufigsten Fall“
- Agent 4: „Lass dich von [bestimmtem Paradigma/Bibliothek] inspirieren“
Ausgabeformat:
1. Schnittstellensignatur (Typen/Methoden)
2. Nutzungsbeispiel (wie der Aufrufer sie verwendet)
3. Was dieser Entwurf intern verbirgt
4. Abwägungen dieses Ansatzes
3. Designs präsentieren
Zeige jedes Design mit:
- Schnittstellensignatur – Typen, Methoden, Parameter
- Nutzungsbeispiele – wie Aufrufer es in der Praxis verwenden
- Was es verbirgt – intern gehaltene Komplexität
Präsentiere die Designs nacheinander, damit der Benutzer jeden Ansatz vor dem Vergleich aufnehmen kann.
4. Designs vergleichen
Nachdem alle Designs gezeigt wurden, vergleiche sie anhand:
- Schnittstelleneinfachheit: weniger Methoden, einfachere Parameter
- Allgemein vs. spezialisiert: Flexibilität im Vergleich zum Fokus
- Implementierungseffizienz: Ermöglicht die Form effiziente interne Abläufe?
- Tiefe: Kleines Interface, das erhebliche Komplexität verbirgt (gut) vs. großes Interface mit dünner Implementierung (schlecht)
- Leichte korrekte Nutzung vs. leichte Fehlnutzung
Diskutiere Abwägungen in Prosa, nicht in Tabellen. Hebe hervor, wo sich die Designs am meisten unterscheiden.
5. Synthese
Oft kombiniert das beste Design Erkenntnisse aus mehreren Optionen. Frage:
- „Welches Design passt am besten zu deinem primären Anwendungsfall?“
- „Gibt es Elemente aus anderen Designs, die es wert sind, integriert zu werden?“
Bewertungskriterien
Aus „A Philosophy of Software Design“:
Schnittstelleneinfachheit: Weniger Methoden, einfachere Parameter = leichter zu lernen und korrekt zu nutzen.
Allgemein nutzbar: 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: Kleines Interface, das erhebliche Komplexität verbirgt = tiefes Modul (gut). Großes Interface mit dünner Implementierung = flaches Modul (vermeiden).
Anti-Patterns
- Lasse Sub-Agenten keine ähnlichen Designs erstellen – erzwinge radikale Unterschiede
- Überspringe den Vergleich nicht – der Wert liegt im Kontrast
- Implementiere nicht – dies betrifft ausschließlich die Schnittstellenform
- Bewerte nicht auf Grundlage des Implementierungsaufwands