diff --git a/AGENTS.md b/AGENTS.md index 757d08d..8404690 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -193,3 +193,21 @@ Ohne Lab-Zugang: dieses Repo ist als Push-Mirror unter validieren (`docker compose config`, YAML-Parse). - Fehlschläge und übersprungene Schritte benennen, nicht glätten — „fertig" heißt verifiziert (deckungsgleich mit §1). + +### AAR-Nachträge (Projektregel) + +Die AAR-Vorlage (`docs/aar/template.md`) ist eine **Framework-Datei und byte-identisch +gepinnt** — sie wird nicht projektspezifisch erweitert (`pruefe_upstream_drift.py`). +Die hier gewachsene Nachtrag-Praxis steht deshalb an dieser Stelle: + +- **Nachträge sind erlaubt** und haben sich bewährt (Korrektur einer Annahme, spätere + Auflösung eines offenen Punktes). +- **Anhängen, nie oben nachbessern.** Der ursprüngliche Stand bleibt lesbar — sonst + verschwindet genau der Irrtum, aus dem man lernen wollte. +- Nachträge werden **datiert überschrieben** und benennen, was sich geändert hat. + Widerspricht ein Nachtrag einer früheren Aussage, dort einen Verweis setzen + („→ korrigiert im Nachtrag vom …"), statt sie umzuschreiben. +- Befunde-Tabellen dürfen ohne Nachtrag um Issue-Referenzen ergänzt werden (reine + Vervollständigung). +- Wächst ein AAR über ~drei Nachträge hinaus, gehört das Thema in ein **Folge-AAR** + statt in den vierten Anhang. diff --git a/docs/aar/template.md b/docs/aar/template.md index 743d730..b23ff59 100644 --- a/docs/aar/template.md +++ b/docs/aar/template.md @@ -32,17 +32,3 @@ related: [] # design docs, issues, ADRs involved framework issues opened, tests added. When all actions are done, set status: harvested. The refinement session walks all AARs still marked open. --> - -