KI-Skill / Strukturieren und entscheiden
Entscheidung festhalten
Dokumentiert dauerhafte Entscheidungen mit Kontext, Lösung und Konsequenzen.
Leitlinien
Kleine, versionierte Aufzeichnungen halten Status, Kontext, Entscheidung und Konsequenzen sichtbar.
Michael Nygard / Documenting Architecture Decisions ↗
MADR bietet eine schlanke Struktur für nachvollziehbare Architecture Decision Records.
MADR ↗
So setzt der Skill diese Leitlinien um
Der Skill prüft zuerst, ob eine Entscheidung dauerhaft und folgenreich genug für ein ADR ist, und dokumentiert dann Kontext, Alternativen und Folgen.
- Ist genau eine dauerhafte, folgenreiche Entscheidung beschrieben?
- Sind Kontext, Randbedingungen und ernsthaft betrachtete Alternativen erkennbar?
- Sind positive, negative sowie Sicherheits- und Datenschutzfolgen benannt?
- Ist der Status korrekt und in Plan oder Task verknüpft?
Dokumentation und Übergabe
Kontext, Entscheidung, Alternativen und Konsequenzen werden im ADR und im Task-Dokument festgehalten.
Wie bei jedem Skill referenziert der zugehörige Commit das Task-Dokument.