Karthick-Ramachandran/recall-os

Skill: ADR erstellen

Zweck

Dauerhafte Architekturentscheidungen aufzeichnen, damit zukünftige Menschen und Agenten sie nicht neu entdecken oder ihnen widersprechen.

Eingaben

• Entscheidungsthema.
• Kontext und Einschränkungen.
• Erwogene Optionen.
• Empfohlene oder ausgewählte Entscheidung.

Erforderliche Lektüre

• docs/10-architecture/ARCHITECTURE.md
• docs/10-architecture/FILE_WRITE_POLICY.md
• docs/20-security/SECURITY_MODEL.md
• Relevante bestehende ADRs in docs/adrs/

Ausgabedateien

• docs/adrs/ADR-####-<slug>.md

Ablauf

1. Bestimmen, ob die Änderung eine ADR benötigt.
2. Nächste ADR-Nummer finden, ohne vorhandene Nummern wiederzuverwenden.
3. Kontext, Entscheidung, Alternativen, Konsequenzen und zugehörige Dokumente schreiben.
4. Status als „Vorgeschlagen“ markieren, es sei denn, der Mensch hat die Entscheidung akzeptiert.
5. Verknüpfung zu betroffenen PRDs, Architekturdokumenten, Feature-Dokumenten und Sicherheitsdokumenten herstellen.

Stoppbedingungen

Stoppen und menschliche Entscheidung anfordern, wenn:

• Die Entscheidung das Sicherheitsprofil, das Netzwerkverhalten, die Telemetrie, Dateischreibvorgänge, die Authentifizierung, Geheimnisse, die Cloud oder das Laufzeit-MCP ändert.
• Die angeforderte Entscheidung mit einer akzeptierten ADR kollidiert.
• Die Entscheidung noch nicht tatsächlich getroffen wurde und ein Vorschlag bleiben sollte.

Qualitätsbarriere

• Die ADR erklärt, warum die Entscheidung existiert, nicht nur, was sich geändert hat.
• Alternativen und Konsequenzen sind ehrlich.
• Der Status ist klar.
• Verwandte Dokumente sind verlinkt.