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:
co-authored by
Claude Fable 5
parent
10c5ffb931
commit
01b836a4d4
+13
-5
@@ -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
@@ -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.
|
||||
|
||||
@@ -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)
|
||||
|
||||
Reference in New Issue
Block a user