Entscheidungen und Review
Wie Entscheidungen vorgeschlagen, geprüft, ersetzt und aktuell gehalten werden.
Eine Entscheidung in Mios steht für eine vereinbarte technische Wahl, eine Architekturregel oder eine Projektanforderung. Mios hält den Verlauf jeder Entscheidung fest: wer sie verfasst hat und welche früheren Entscheidungen sie ersetzt.
Wie Entscheidungen vorgeschlagen werden
Entscheidungen gelangen auf zwei Wegen in Mios:
- Extraktion aus verbundenen Quellen: Wenn Mios Diskussionen in Pull Requests, Architekturdokumente oder technische Chat-Threads indiziert, erkennt die Analyse, wann sich das Team auf einen Weg geeinigt hat.
- Vorschläge von Coding-Agenten: Wenn ein Agent in Claude Code oder Codex eine Aufgabe beendet, analysiert der Stop-Hook die Änderungen der Sitzung und schlägt neu entstandene Muster an Mios vor.
Alle neu vorgeschlagenen Entscheidungen beginnen im Status „ausstehend“ und warten auf die Bestätigung durch einen Menschen.
Die Review-Warteschlange („Braucht Sie“)
Um vorgeschlagene Entscheidungen zu prüfen, öffnen Sie Review (/pages/review) unter https://app.mios-ai.com.
Jede Karte zeigt die vorgeschlagene Entscheidung, die aus der Diskussion extrahierte Begründung und direkte Links zu den Quelldokumenten. Es stehen vier Aktionen zur Verfügung:
- Adopt: Bestätigt die Entscheidung. Sie wird Teil des maßgeblichen Projektgedächtnisses und sofort an Coding-Agenten ausgeliefert.
- Reject: Verwirft die Entscheidung. Sie verschwindet aus der aktiven Warteschlange und wird Agenten nicht vorgeschlagen.
- Edit: Passt Titel oder Formulierung der Entscheidung an, bevor Sie sie übernehmen.
- Undo: Macht eine kürzliche Review-Aktion rückgängig, falls eine Entscheidung versehentlich übernommen oder abgelehnt wurde.
Automatisch übernommene Entscheidungen
Wenn mehrere voneinander unabhängige, maßgebliche Dokumente ausdrücklich dieselbe Entscheidung nennen, kann Mios sie automatisch als auto-adopted markieren.
Automatisch übernommene Entscheidungen sind sofort aktiv, bleiben aber in der Review-Warteschlange sichtbar, sodass Teammitglieder sie jederzeit prüfen oder anpassen können.
Entscheidungen ersetzen und ablösen
Technische Anforderungen entwickeln sich weiter. Wenn eine neu vorgeschlagene Entscheidung einer früheren widerspricht oder sie ersetzt, kennzeichnet Mios diese Beziehung.
Auf der Review-Karte hebt Mios die widersprüchliche frühere Entscheidung in der Liste der strittigen Einträge hervor. Wenn Sie die neue Entscheidung übernehmen:
- Wird die neue Entscheidung zur aktiven Richtlinie des Projekts.
- Wird die ältere Entscheidung als superseded markiert. So bleibt der historische Kontext erhalten, ohne Agenten zu verwirren.
- Sehen Coding-Agenten bei künftigen Aufgaben die aktualisierte Entscheidung samt Verweis auf die ersetzte.