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:
co-authored by
Claude Opus 4.8
parent
320657b1d5
commit
cffb507310
@@ -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.
|
||||
|
||||
@@ -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. -->
|
||||
|
||||
Reference in New Issue
Block a user