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
+1 -1
View File
@@ -85,7 +85,7 @@ jobs:
frontend/dist/index.html > site/index.html frontend/dist/index.html > site/index.html
cp LICENSE site/LICENSE cp LICENSE site/LICENSE
# Agenten-Fassung der Notation (D43) — liegt per Vite-public/ in dist/ # Agenten-Fassung der Notation (D43) — liegt per Vite-public/ in dist/
cp frontend/dist/llms.txt site/llms.txt cp frontend/dist/llms.md site/llms.md
- name: Pages-Konfiguration - name: Pages-Konfiguration
uses: actions/configure-pages@v6 uses: actions/configure-pages@v6
+1 -1
View File
@@ -13,7 +13,7 @@ Integrations-Backend.
## Verbindliche Referenzen ## Verbindliche Referenzen
- Sprachdefinition: @docs/SPEC.md — die Notation ist der gemeinsame Vertrag - Sprachdefinition: @docs/SPEC.md — die Notation ist der gemeinsame Vertrag
von Frontend und Backend. Syntaxänderungen: SPEC **zuerst**, dann Code, von Frontend und Backend. Syntaxänderungen: SPEC **zuerst**, dann Code,
dann die Agenten-Fassung `frontend/public/llms.txt` nachziehen dann die Agenten-Fassung `frontend/public/llms.md` nachziehen
(SPEC §13, D43). (SPEC §13, D43).
- Entscheidungen: @docs/DECISIONS.md — respektieren; Abweichungen als neuen - Entscheidungen: @docs/DECISIONS.md — respektieren; Abweichungen als neuen
Eintrag begründen, alte Einträge nie löschen. Besonders D13 (Backend-Stack) Eintrag begründen, alte Einträge nie löschen. Besonders D13 (Backend-Stack)
+13 -5
View File
@@ -2098,8 +2098,16 @@ URL, kein Bundle.
**Drift ist das Hauptrisiko** — dieselbe Sorge wie bei einem zweiten Parser **Drift ist das Hauptrisiko** — dieselbe Sorge wie bei einem zweiten Parser
(D14). Gegenmittel: Die Datei erklärt selbst, dass die SPEC normativ ist, und (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 die Hausregel in CLAUDE.md lautet jetzt „SPEC zuerst, dann Code, **dann die
llms.txt nachziehen**" (SPEC §13 verweist zurück). Inhaltlich beschreibt sie Agenten-Fassung nachziehen**" (SPEC §13 verweist zurück). Inhaltlich
nur die **Notation samt Semantik** (Gates, Status, Ränge, Extraktions- beschreibt sie nur die **Notation samt Semantik** (Gates, Status, Ränge,
reihenfolge, Schreibregeln, ein vollständiges Beispiel) — keine Editor-UI: Extraktionsreihenfolge, Schreibregeln, ein vollständiges Beispiel) — keine
Die braucht ein schreibender Agent nicht, und sie ändert sich öfter. 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 `text/plain; charset=utf-8` (dann zeigt der Browser die Datei an, statt sie
herunterzuladen). Siehe D24. herunterzuladen). Siehe D24.
## 13. Agenten-Fassung (`llms.txt`) ## 13. Agenten-Fassung (`llms.md`)
Eine **englische Kurzfassung dieser Spezifikation für KI-Agenten** (lesen 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 von jeder Instanz unter der Site-Wurzel ausgeliefert
(`https://werkbaum.javagil.de/llms.txt`) — die llms.txt-Konvention. **Diese (`https://werkbaum.javagil.de/llms.md`); der Footer verlinkt sie neben der
SPEC bleibt normativ**: Bei Syntaxänderungen wird die Agenten-Fassung im Versionsnummer. Angelehnt an die llms.txt-Konvention, mit `.md` als der zum
selben Zug nachgezogen (CLAUDE.md). Siehe D43. 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 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 - [-] A separate storage format for the structure (L) %% the text is the format
- [ ] Ticket references (#123) (S) - [ ] 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) - [?] Benefit per node, not only cost (M)
| [?] Another sigil next to the size (S) | [?] Another sigil next to the size (S)
| [?] Story points behind the T-shirt sizes (M) | [?] Story points behind the T-shirt sizes (M)
+1 -1
View File
@@ -198,7 +198,7 @@
</div> </div>
</div> </div>
<footer class="site-footer"><a href="https://github.com/mhoennig/werkbaum" target="_blank" rel="noopener">Werkbaum</a>&nbsp;<a class="ver" href="https://github.com/mhoennig/werkbaum/commit/main" target="_blank" rel="noopener">1.0</a> © 2026 <a href="https://michael.hoennig.de" target="_blank" rel="noopener">Michael Hönnig</a> · <span class="vibe" title="Fable 5 and Opus 4.8">Built with Claude Code</span> <a href="../LICENSE" target="_blank" rel="noopener">License</a> · <a href="https://michael.hoennig.de/imprint.html" target="_blank" rel="noopener" data-i18n="imprint">Impressum</a> · <a id="privacyLink" href="https://michael.hoennig.de/datenschutzerklaerung.html" target="_blank" rel="noopener" data-i18n="privacy">Datenschutz</a> · <a href="llms.txt" target="_blank" rel="noopener" title="Werkbaum-Notation für KI-Agenten · Werkbaum notation for AI agents (Markdown)">llms.txt</a></footer> <footer class="site-footer"><a href="https://github.com/mhoennig/werkbaum" target="_blank" rel="noopener">Werkbaum</a>&nbsp;<a class="ver" href="https://github.com/mhoennig/werkbaum/commit/main" target="_blank" rel="noopener">1.0</a> · <a href="llms.md" target="_blank" rel="noopener" title="Werkbaum-Notation für KI-Agenten · Werkbaum notation for AI agents (Markdown)">llms.md</a> © 2026 <a href="https://michael.hoennig.de" target="_blank" rel="noopener">Michael Hönnig</a> · <span class="vibe" title="Fable 5 and Opus 4.8">Built with Claude Code</span> <a href="../LICENSE" target="_blank" rel="noopener">License</a> · <a href="https://michael.hoennig.de/imprint.html" target="_blank" rel="noopener" data-i18n="imprint">Impressum</a> · <a id="privacyLink" href="https://michael.hoennig.de/datenschutzerklaerung.html" target="_blank" rel="noopener" data-i18n="privacy">Datenschutz</a></footer>
<script type="module" src="./src/app.js"></script> <script type="module" src="./src/app.js"></script>
</body> </body>
+1 -1
View File
@@ -133,7 +133,7 @@ fi
sed "${SED_ARGS[@]}" frontend/dist/index.html > "$STAGE/index.html" sed "${SED_ARGS[@]}" frontend/dist/index.html > "$STAGE/index.html"
cp LICENSE "$STAGE/LICENSE" cp LICENSE "$STAGE/LICENSE"
# Agenten-Fassung der Notation (D43) — liegt per Vite-public/ in dist/ # Agenten-Fassung der Notation (D43) — liegt per Vite-public/ in dist/
cp frontend/dist/llms.txt "$STAGE/llms.txt" cp frontend/dist/llms.md "$STAGE/llms.md"
# ---- 3) Spiegeln (--delete: nichts Altes bleibt am Ziel) ---- # ---- 3) Spiegeln (--delete: nichts Altes bleibt am Ziel) ----
# --chmod=D755,F644 erzwingt web-taugliche Rechte am Ziel, unabhängig von den # --chmod=D755,F644 erzwingt web-taugliche Rechte am Ziel, unabhängig von den