Was macht cs-decide?
Dokumentiert endgültige Technologieentscheidungen, Architekturentscheidungen, langfristige Einschränkungen und Codierungskonventionen als dauerhafte Entscheidungsdokumente (tech-stack / architecture / constraint / convention).
Funktion
Dieses Skill erfasst wichtige technische Entscheidungen in strukturierten Markdown-Dateien, sodass sie später leicht nachvollzogen und verstanden werden können.
Auslöser
Das Skill wird aktiviert, wenn der Benutzer einen der folgenden Befehle sagt oder schreibt:
- "Entscheidung aufzeichnen"
- "Technologieauswahl archivieren"
- "ADR"
- "Diese Einschränkung aufzeichnen"
- "Die Konvention niederschreiben"
Es wird auch automatisch ausgelöst, nachdem der Benutzer in einer Design- oder Analyse-Phase eine wichtige technische Wahl getroffen hat.
Kategorien
| Kategorie | Beschreibung |
|---|---|
| tech-stack | Auswahl von Technologien, Frameworks, Bibliotheken |
| architecture | Architekturentscheidungen, Systemdesign |
| constraint | Langfristige Einschränkungen, Randbedingungen |
| convention | Codierungskonventionen, Stilrichtlinien |
Verwendung
- Stelle sicher, dass die Entscheidung endgültig getroffen wurde (nicht mehr in Diskussion).
- Verwende einen der Auslöser, um das Skill zu aktivieren.
- Das Skill generiert eine Markdown-Datei im Format
decisions/YYYY-MM-DD-title.mdmit:- Kontext: Hintergrund und Problemstellung
- Entscheidung: Die getroffene Wahl
- Konsequenzen: Auswirkungen und Begründung
Beispiel
# Entscheidungsprotokoll: Verwendung von PostgreSQL
**Datum**: 2024-01-15
**Kategorie**: tech-stack
## Kontext
Wir benötigen eine zuverlässige, skalierbare relationale Datenbank.
## Entscheidung
Wir verwenden PostgreSQL 16 als primäre Datenbank.
## Konsequenzen
- Höhere Komplexität im Betrieb
- Bessere Datenintegrität und Transaktionsunterstützung
Hinweis
Nur endgültige Entscheidungen werden archiviert. Diskussionen und unentschiedene Optionen werden nicht dokumentiert, um die Dokumentation übersichtlich zu halten.