From cffb507310a274cb6d1efb137ac1d372d761a9d9 Mon Sep 17 00:00:00 2001 From: Thore Cimbal Date: Sat, 15 Aug 2026 12:00:00 +0000 Subject: [PATCH] fix: restore the pinned AAR template, move the addendum rule to the project section MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Resolving W6 earlier today I added the addendum rule straight into docs/aar/template.md — a framework file pinned byte-identical to the neckbeard baseline, and pruefe_upstream_drift.py exists precisely to catch that. Its docstring even cites the question that prompted it: whether agents would rewrite AGENTS.md. So the check caught exactly the thing it was built for, and the fix is to put the rule where project-specific rules belong. Template restored byte-identical; the addendum practice now lives in the project section of AGENTS.md, with a note saying why it is not in the template. Co-Authored-By: Claude Opus 4.8 --- AGENTS.md | 18 ++++++++++++++++++ docs/aar/template.md | 14 -------------- 2 files changed, 18 insertions(+), 14 deletions(-) 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. --> - -