fix: restore the pinned AAR template, move the addendum rule to the project section

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 <noreply@anthropic.com>
This commit is contained in:
Thore Cimbal
2026-08-15 12:00:00 +00:00
co-authored by Claude Opus 4.8
parent 320657b1d5
commit cffb507310
2 changed files with 18 additions and 14 deletions
+18
View File
@@ -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.
-14
View File
@@ -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. -->
<!-- ## Nachtrag YYYY-MM-DD — <Thema> (optional, append-only)
Nachträge sind erlaubt und haben sich bewährt (Korrekturen, spätere
Auflösung eines offenen Punktes). Regeln:
- ANHÄNGEN, nie oben im Text nachbessern: der ursprüngliche Stand bleibt
lesbar, sonst verschwindet genau der Irrtum, aus dem man lernen wollte.
- Datiert überschreiben 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 nachträglich um Issue-Referenzen ergänzt werden
(reine Vervollständigung, kein Nachtrag nötig).
Wächst ein AAR über ~drei Nachträge hinaus, gehört das Thema in ein
eigenes Folge-AAR statt in den vierten Anhang. -->