Was macht Council — Multi-Perspektiven-Analyse?
Ein Multi-Perspektiven-Analyse-Framework, das eine objektive, entzerrte Bewertung von Codebasen, Projekten und Dokumentation ermöglicht. Es nutzt mehrere Standpunkte und Debiasing-Techniken, um die Tendenz zur Verankerung an bestehendem Code zu überwinden.
Das Problem, das es löst
KI-Tools (und Menschen) neigen dazu, sich an bestehendem Code zu verankern. Sie sehen, WAS IST, und haben Schwierigkeiten, sich vorzustellen, WAS SEIN KÖNNTE. Sie validieren statt zu erkunden. Council verwendet:
- Debiasing-Techniken — Methoden, die frisches Denken erzwingen
- Mehrere Perspektiven — Unterschiedliche mentale Modelle, die verschiedene Dinge erfassen
- Strukturierte Synthese — Kombinieren von Erkenntnissen unter Berücksichtigung von Widersprüchen
Wann zu verwenden
- Bewertung, ob der aktuelle Ansatz noch optimal ist
- Erkundung von Alternativen zur bestehenden Implementierung
- Identifizierung versteckter Annahmen in Ihrem Projekt
- Einholen objektiven Feedbacks vor wichtigen Entscheidungen
- Wenn Sie in einem lokalen Optimum feststecken
- Wenn Sie vermuten, dass es einen besseren Weg gibt, ihn aber nicht sehen können
- Wenn KI-Tools ständig Ihre bestehenden Muster zurückspiegeln
Eingabe
Der Benutzer gibt vor:
- Ziel: Repository-Pfad, Dokumentation oder eine spezifische Problembeschreibung
- Ziel (optional): Wie Erfolg aussieht (z. B. "Gewinn maximieren")
- Einschränkungen (optional): Was erhalten bleiben muss (z. B. "muss das bestehende Datenmodell verwenden")
Ausführungsablauf
Phase 1: Scout
Das Ziel gründlich lesen und verstehen. Dokumentieren:
- Was das Projekt tut
- Wie es derzeit strukturiert ist
- Welche Einschränkungen bestehen
- Was die genannten Ziele sind
Noch keine Meinungen bilden. Nur Tatsachen sammeln.
Phase 2: Perspektiven generieren
3-5 relevante Perspektiven basierend auf dem Ziel auswählen:
| Perspektive | Fokus | Am besten geeignet für |
|---|---|---|
| Architekt | Struktur, Muster, Kopplung, Kohäsion | Systemdesign, Refactoring |
| Herausforderer | Annahmen, Risiken, Alternativen | Entscheidungsvalidierung, Risikominderung |
| Opportunist | Neue Technik, Abkürzungen, Vereinfachung | Optimierung, Schuldenabbau |
| Sicherheit | Vertrauensgrenzen, Fehlermodi | Sicherheit, Zuverlässigkeit |
| Ökonom | Kosten, Komplexität, ROI | Ressourcenzuweisung, Priorisierung |
| Benutzer | Benutzerfreundlichkeit, Wert, Reibung | UX, Produktentscheidungen |
| Archäologe | Legacy, Schulden, Geschichte | Verständnis, Migration |
| Futurist | Trends, Skalierung, Evolution | Langfristige Planung |
Für komplexe Ziele spawn_agents verwenden, um Perspektiven parallel auszuführen – jeder Agent arbeitet unabhängig, um Gruppendenken zu vermeiden, dann werden die Ergebnisse in Phase 3 kombiniert.
Für einfachere Ziele die Perspektiven sequenziell in einem einzigen Agenten ausführen.
Jede Perspektive wendet diese Debiasing-Techniken an:
- Frische-Augen-Modus: Die bestehende Implementierung bewusst ignorieren. Fragen: "Was würde ich bauen, wenn ich bei Null anfangen würde, nur mit dem Ziel vor Augen?"
- Herausforderungsmodus: Jede Annahme hinterfragen. Warum existiert diese Komponente? Was passiert, wenn wir sie entfernen? Was wäre, wenn das Gegenteil wahr wäre?
- Neuerstellungsmodus: "Wenn ich das mit heutigem Wissen von Grund auf neu lösen müsste, was würde ich anders machen?"
Siehe references/debiasing.md für detaillierte Debiasing-Techniken und Prompts.
Phase 3: Synthese
Perspektiven in strukturierte Ausgabe kombinieren:
- Übereinstimmungen: Worauf sich mehrere Perspektiven einigen (hohe Sicherheit)
- Widersprüche: Wo Perspektiven kollidieren (tiefer graben – diese offenbaren Kompromisse)
- Neue Erkenntnisse: Dinge, die nur eine Perspektive entdeckt hat
- Priorisierte Empfehlungen: Nach Wirkung und Sicherheit geordnet
Siehe agents/synthesizer.md für detaillierte Syntheseanweisungen bei Verwendung von Unteragenten.
Phase 4: Validierung
- Prüfen, ob Empfehlungen sich nicht widersprechen
- Annahmen kennzeichnen, die nicht validiert wurden
- Identifizieren, welche Informationen die Schlussfolgerungen ändern würden
Ausgabeformat
# Council-Bericht: [Ziel]
## Zusammenfassung
[2-3 Sätze objektive Bewertung – keine Zusammenfassung dessen, was getan wurde, sondern ein Urteil]
## Wichtigste Erkenntnisse
### [Erkenntnisname]
- **Was**: [Klare Beschreibung der Erkenntnis]
- **Zustimmende Perspektiven**: [Liste]
- **Widersprechende Perspektiven**: [Liste + kurzer Grund]
- **Sicherheit**: [Hoch/Mittel/Niedrig]
- **Nachweis**: [Spezifische Datei:Zeile, Metrik oder Beobachtung]
## Empfehlungen
### [HOHE WIRKUNG] [Empfehlungstitel]
- **Behobenes Problem**: [Die Erkenntnis, die dies behebt]
- **Lösung**: [Konkrete Aktion]
- **Erwartete Wirkung**: [Was verbessert sich und um wie viel]
- **Aufwand**: [Niedrig/Mittel/Hoch]
- **Risiko**: [Niedrig/Mittel/Hoch]
- **Unterstützende Perspektiven**: [Liste]
### [MITTLERE WIRKUNG] ...
### [NIEDRIGE WIRKUNG] ...
## Betrachtete Alternativen
| Ansatz | Vorteile | Nachteile | Urteil |
|--------|----------|-----------|--------|
| ... | ... | ... | Behalten/Ersetzen/Weiter untersuchen |
## Was diese Bewertung ändern würde
- Wenn [X] wahr ist, dann ändert sich [Empfehlung Y]
- [Unvalidierte Annahme, die von Bedeutung ist]
Mitgelieferte Ressourcen
references/debiasing.md— Detaillierte Debiasing-Techniken und Prompts pro Perspektiventypagents/perspective.md— Anweisungen für Unteragenten, die einzelne Perspektivenanalysen durchführenagents/synthesizer.md— Anweisungen für einen Synthese-Unteragenten, der mehrere Perspektivenausgaben kombiniert