ADR-Ersteller
Erstelle prägnante Architecture Decision Records, die eine Entscheidung, den Kontext, der sie erzwungen hat, die in Betracht gezogenen Optionen und die akzeptierten Konsequenzen erklären.
Aktivierungsvertrag
Verwende dieses Skill, wenn der Benutzer nach einem ADR, Architekturentscheidungsprotokoll, technischen Entscheidungsprotokoll oder einer formellen Aufzeichnung fragt, warum eine technische oder architektonische Wahl getroffen wurde.
Standardmäßig in den Interview-Modus wechseln, es sei denn, der Benutzer hat bereits genügend Informationen geliefert, um einen vollständigen ADR zu entwerfen. Stelle Interviewfragen in der Sprache des Benutzers. Die ADR-Erstellsprache ist Englisch, es sei denn, der Benutzer bittet explizit um eine andere Sprache.
Harte Regeln
- Stelle im Interview-Modus immer nur eine Frage auf einmal.
- Gib zu Beginn des Interviews einmal an, dass der Benutzer Fragen überspringen oder das Interview jederzeit beenden kann.
- Halte einen dynamischen Zähler für die geschätzte Anzahl verbleibender Fragen; aktualisiere ihn, wenn Abhängigkeiten auftauchen oder verschwinden.
- Empfehle kurze Beispielantworten, wenn sie dem Benutzer bei der Antwort helfen.
- Formatiere Interviewfragen als lesbares Markdown, nicht als Klartext.
- Hinterfrage vage, widersprüchliche oder begründungslose Antworten konstruktiv, bevor du einen Entwurf erstellst; fahre fort, wenn der Benutzer explizit sagt, dass er trotzdem weitermachen möchte.
- Erfinde keine Alternativen, Vor- und Nachteile oder Begründungen. Frage nach, wenn Alternativen fehlen.
- Verwende
Accepted, wenn die Entscheidung bereits getroffen wurde; verwendeProposedfür Vorschläge, Bewertungen oder unklare Status. - Schreibe oder ändere Dateien nur, wenn der Benutzer explizit nach einer Datei/einem Pfad fragt.
Interview-Ablauf
Sammle nur das Nötigste, abhängigkeitsbasiert:
- Entscheidungstitel und -status.
- Kontext: Problem, Einschränkungen, Zwänge und warum die Entscheidung jetzt wichtig ist.
- Gewählte Option oder Vorschlag.
- Berücksichtigte Optionen mit Vor- und Nachteilen.
- Konsequenzen: Vorteile, Nachteile, Risiken und Kompromisse.
- Nachverfolgung nur, wenn es nützliche offene Aktionen oder ungelöste Fragen gibt.
Fragenformat:
### Frage N — [fokussierte Frage]
**Empfohlene Antwort:** [kurzes Beispiel, wenn nützlich]
**Warum dies wichtig ist:** [kurzer Grund]
**Geschätzte verbleibende Fragen:** ~M
Minibeispiel:
### Frage 1 — Ist diese Entscheidung bereits getroffen oder wird sie noch vorgeschlagen?
**Empfohlene Antwort:** „Accepted – wir haben uns bereits für PostgreSQL für Abrechnungsdaten entschieden.“
**Warum dies wichtig ist:** Der Status ändert, ob der ADR eine endgültige Wahl oder einen Vorschlag zur Prüfung dokumentiert.
**Geschätzte verbleibende Fragen:** ~5
Ausgabevertrag
Lies assets/template-markdown.md vor dem Entwurf und fülle diese Struktur aus.
Standardmäßig gib den finalen ADR als genau einen Markdown-Codeblock zurück und erstelle keine Dateien. Wenn der Benutzer explizit eine Datei/einen Pfad angefordert hat, speichere den ADR dort und fasse den gespeicherten Pfad im Chat zusammen.
Hinterlasse im finalen ADR niemals Platzhalteranweisungen. Wenn der Benutzer ein erforderliches Detail absichtlich überspringt, verwende sparsam TBD und nur für dieses übersprungene Detail.
Referenz
- Vorlage:
assets/template-markdown.md