fix: llms.md statt llms.txt, Footer-Link zwischen Versionsnummer und Copyright (D43-Nachtrag)

.md ist die zum Inhalt ehrliche Endung (es IST Markdown); Link rückt zur
Werkzeug-Ecke des Footers. Pipelines, SPEC §13, CLAUDE.md und Plan
nachgezogen.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
mhoennig
2026-08-22 21:02:36 +02:00
co-authored by Claude Fable 5
parent 10c5ffb931
commit 01b836a4d4
8 changed files with 24 additions and 15 deletions
+13 -5
View File
@@ -2098,8 +2098,16 @@ URL, kein Bundle.
**Drift ist das Hauptrisiko** — dieselbe Sorge wie bei einem zweiten Parser
(D14). Gegenmittel: Die Datei erklärt selbst, dass die SPEC normativ ist, und
die Hausregel in CLAUDE.md lautet jetzt „SPEC zuerst, dann Code, **dann
llms.txt nachziehen**" (SPEC §13 verweist zurück). Inhaltlich beschreibt sie
nur die **Notation samt Semantik** (Gates, Status, Ränge, Extraktions-
reihenfolge, Schreibregeln, ein vollständiges Beispiel) — keine Editor-UI:
Die braucht ein schreibender Agent nicht, und sie ändert sich öfter.
die Hausregel in CLAUDE.md lautet jetzt „SPEC zuerst, dann Code, **dann die
Agenten-Fassung nachziehen**" (SPEC §13 verweist zurück). Inhaltlich
beschreibt sie nur die **Notation samt Semantik** (Gates, Status, Ränge,
Extraktionsreihenfolge, Schreibregeln, ein vollständiges Beispiel) — keine
Editor-UI: Die braucht ein schreibender Agent nicht, und sie ändert sich
öfter.
**Nachtrag — `llms.md` statt `llms.txt`, Link neben der Versionsnummer.**
Entschieden vom Nutzer: Die Endung `.md` ist die zum Inhalt ehrliche (es IST
Markdown; die Konvention nutzt `.txt` nur als kleinsten gemeinsamen Nenner),
und der Footer-Link rückt zwischen Versionsnummer und Copyright — zur
Werkzeug-Ecke des Footers statt ans Ende hinter die Rechtstexte. Der
Dateiname bleibt als Linktext (übersetzungsfrei), die Wurzel-Lage bleibt.
+6 -5
View File
@@ -798,11 +798,12 @@ Entscheidung und verworfene Alternativen: D34-Nachtrag, D40.
`text/plain; charset=utf-8` (dann zeigt der Browser die Datei an, statt sie
herunterzuladen). Siehe D24.
## 13. Agenten-Fassung (`llms.txt`)
## 13. Agenten-Fassung (`llms.md`)
Eine **englische Kurzfassung dieser Spezifikation für KI-Agenten** (lesen
**und** schreiben) liegt als Markdown in `frontend/public/llms.txt` und wird
**und** schreiben) liegt als Markdown in `frontend/public/llms.md` und wird
von jeder Instanz unter der Site-Wurzel ausgeliefert
(`https://werkbaum.javagil.de/llms.txt`) — die llms.txt-Konvention. **Diese
SPEC bleibt normativ**: Bei Syntaxänderungen wird die Agenten-Fassung im
selben Zug nachgezogen (CLAUDE.md). Siehe D43.
(`https://werkbaum.javagil.de/llms.md`); der Footer verlinkt sie neben der
Versionsnummer. Angelehnt an die llms.txt-Konvention, mit `.md` als der zum
Inhalt ehrlichen Endung. **Diese SPEC bleibt normativ**: Bei Syntaxänderungen
wird die Agenten-Fassung im selben Zug nachgezogen (CLAUDE.md). Siehe D43.
+1 -1
View File
@@ -23,7 +23,7 @@
- [^] A long block at the end, addressed by its id (S) %% behind a --- separator
- [-] A separate storage format for the structure (L) %% the text is the format
- [ ] Ticket references (#123) (S)
- [x] llms.txt, the notation explained to AI agents (S)
- [x] llms.md, the notation explained to AI agents (S)
- [?] Benefit per node, not only cost (M)
| [?] Another sigil next to the size (S)
| [?] Story points behind the T-shirt sizes (M)