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
@@ -85,7 +85,7 @@ jobs:
|
||||
frontend/dist/index.html > site/index.html
|
||||
cp LICENSE site/LICENSE
|
||||
# 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
|
||||
uses: actions/configure-pages@v6
|
||||
|
||||
@@ -13,7 +13,7 @@ Integrations-Backend.
|
||||
## Verbindliche Referenzen
|
||||
- Sprachdefinition: @docs/SPEC.md — die Notation ist der gemeinsame Vertrag
|
||||
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).
|
||||
- Entscheidungen: @docs/DECISIONS.md — respektieren; Abweichungen als neuen
|
||||
Eintrag begründen, alte Einträge nie löschen. Besonders D13 (Backend-Stack)
|
||||
|
||||
+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)
|
||||
|
||||
+1
-1
@@ -198,7 +198,7 @@
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<footer class="site-footer"><a href="https://github.com/mhoennig/werkbaum" target="_blank" rel="noopener">Werkbaum</a> <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> <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>
|
||||
</body>
|
||||
|
||||
@@ -133,7 +133,7 @@ fi
|
||||
sed "${SED_ARGS[@]}" frontend/dist/index.html > "$STAGE/index.html"
|
||||
cp LICENSE "$STAGE/LICENSE"
|
||||
# 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) ----
|
||||
# --chmod=D755,F644 erzwingt web-taugliche Rechte am Ziel, unabhängig von den
|
||||
|
||||
Reference in New Issue
Block a user