Communitygithub.com

Council — Multi-Perspektiven-Analyse

Ein Multi-Perspektiven-Analyse-Framework für objektive, entzerrte Bewertung von Codebasen, Projekten und Dokumentation. Nutzt mehrere Standpunkte und Debiasing-Techniken, um die Tendenz zur Verankerung an bestehendem Code zu überwinden.

Was ist Council — Multi-Perspektiven-Analyse?

Council ist ein Multi-Perspektiven-Analyse-Framework, das speziell dafür entwickelt wurde, die kognitive Verankerung (Anchoring Bias) zu überwinden, die sowohl KI-Assistenten als auch Menschen daran hindert, über den bestehenden Code hinauszudenken. Es bewertet Codebasen, Projekte und Dokumentation objektiv, indem es strukturierte Debiasing-Techniken und mehrere Perspektiven (wie Architekt, Herausforderer, Opportunist und mehr) anwendet. Das Framework unterstützt sowohl einfache sequenzielle Analysen als auch komplexe, parallele Auswertungen mit Unteragenten, um Gruppendenken zu vermeiden. Es ist plattformunabhängig und kann in jede Entwicklerumgebung integriert werden, die über eine Shell verfügt, z. B. Claude Code, Cursor oder Codex. Der typische Ablauf umfasst vier Phasen: Scout (Datensammlung ohne Wertung), Generate Perspectives (Anwendung von 3-5 Perspektiven mit Debiasing), Synthesize (strukturierte Zusammenführung von Übereinstimmungen, Widersprüchen und neuen Erkenntnissen) und Validate (Überprüfung auf Widersprüche und unbestätigte Annahmen). Das Ergebnis ist ein detaillierter Bericht mit priorisierten Empfehlungen, der Entwicklern hilft, bessere Entscheidungen zu treffen, bevor sie wesentliche Änderungen vornehmen oder neue Richtungen einschlagen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add adulari/forge

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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:

  1. Debiasing-Techniken — Methoden, die frisches Denken erzwingen
  2. Mehrere Perspektiven — Unterschiedliche mentale Modelle, die verschiedene Dinge erfassen
  3. 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:

PerspektiveFokusAm besten geeignet für
ArchitektStruktur, Muster, Kopplung, KohäsionSystemdesign, Refactoring
HerausfordererAnnahmen, Risiken, AlternativenEntscheidungsvalidierung, Risikominderung
OpportunistNeue Technik, Abkürzungen, VereinfachungOptimierung, Schuldenabbau
SicherheitVertrauensgrenzen, FehlermodiSicherheit, Zuverlässigkeit
ÖkonomKosten, Komplexität, ROIRessourcenzuweisung, Priorisierung
BenutzerBenutzerfreundlichkeit, Wert, ReibungUX, Produktentscheidungen
ArchäologeLegacy, Schulden, GeschichteVerständnis, Migration
FuturistTrends, Skalierung, EvolutionLangfristige 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:

  1. 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?"
  2. Herausforderungsmodus: Jede Annahme hinterfragen. Warum existiert diese Komponente? Was passiert, wenn wir sie entfernen? Was wäre, wenn das Gegenteil wahr wäre?
  3. 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:

  1. Übereinstimmungen: Worauf sich mehrere Perspektiven einigen (hohe Sicherheit)
  2. Widersprüche: Wo Perspektiven kollidieren (tiefer graben – diese offenbaren Kompromisse)
  3. Neue Erkenntnisse: Dinge, die nur eine Perspektive entdeckt hat
  4. 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 Perspektiventyp
  • agents/perspective.md — Anweisungen für Unteragenten, die einzelne Perspektivenanalysen durchführen
  • agents/synthesizer.md — Anweisungen für einen Synthese-Unteragenten, der mehrere Perspektivenausgaben kombiniert

Verwandte Skills