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
|
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
|
||||||
|
|||||||
@@ -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
@@ -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
@@ -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.
|
||||||
|
|||||||
@@ -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
@@ -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> <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>
|
<script type="module" src="./src/app.js"></script>
|
||||||
</body>
|
</body>
|
||||||
|
|||||||
@@ -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
|
||||||
|
|||||||
Reference in New Issue
Block a user