diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.yml index 1157c97..4187ad8 100644 --- a/.github/workflows/pages.yml +++ b/.github/workflows/pages.yml @@ -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 diff --git a/CLAUDE.md b/CLAUDE.md index 440cb7b..c9df6af 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -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) diff --git a/docs/DECISIONS.md b/docs/DECISIONS.md index a6150a4..2a98e45 100644 --- a/docs/DECISIONS.md +++ b/docs/DECISIONS.md @@ -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. diff --git a/docs/SPEC.md b/docs/SPEC.md index 9d11259..2f53ccb 100644 --- a/docs/SPEC.md +++ b/docs/SPEC.md @@ -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. diff --git a/docs/examples/werkbaum.werkbaum b/docs/examples/werkbaum.werkbaum index 0be9408..6512f4c 100644 --- a/docs/examples/werkbaum.werkbaum +++ b/docs/examples/werkbaum.werkbaum @@ -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) diff --git a/frontend/index.html b/frontend/index.html index eb78d3b..1893fbb 100644 --- a/frontend/index.html +++ b/frontend/index.html @@ -198,7 +198,7 @@ - + diff --git a/frontend/public/llms.txt b/frontend/public/llms.md similarity index 100% rename from frontend/public/llms.txt rename to frontend/public/llms.md diff --git a/scripts/deploy-prod.sh b/scripts/deploy-prod.sh index 25a9b35..8b1d8e5 100755 --- a/scripts/deploy-prod.sh +++ b/scripts/deploy-prod.sh @@ -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