fix(docs): AGENTS.md-Contract-Prosa als Sitzungsarbeit klargestellt, doc-pull-through-Instruction (schliesst #90)
Files changed: - AGENTS.md - CHANGES.md - VERSION - instructions/dev/doc-pull-through.md - instructions/dev/stack-close/SKILL.md - instructions/dev/stack-dev/SKILL.md - instructions/dev/testing-conventions.md - instructions/dev/version-parts.md - tools/chemenu/commands/docs_verify.py
This commit is contained in:
+41
-1
@@ -35,7 +35,7 @@ dev-checkout concern - readable here, never shipped as something to parse.
|
||||
|
||||
---
|
||||
|
||||
## 5.0.0-beta.11 - 2026-09-11 - MCP submit-Tool: Quarantäne-Schreibpfad mit Upload Review Gate (schliesst #32)
|
||||
## 5.0.0-beta.12 - 2026-09-11 - AGENTS.md-Changelog-Absatz korrigiert: Contract-Prosa ist Sitzungsarbeit, doc-pull-through-Instruction ergaenzt
|
||||
|
||||
**Author:** Torben Nehmer
|
||||
|
||||
@@ -64,6 +64,7 @@ dev-checkout concern - readable here, never shipped as something to parse.
|
||||
- Telemetrie-Default nach Installationsform, Byte-Deckel und Session-Retention
|
||||
- tools/CONTRACT.md: raw accept Doku auf Datums-Shard und Capture-Felder nachgezogen (schliesst #89)
|
||||
- MCP submit-Tool: Quarantäne-Schreibpfad mit Upload Review Gate (schliesst #32)
|
||||
- AGENTS.md-Changelog-Absatz korrigiert: Contract-Prosa ist Sitzungsarbeit, doc-pull-through-Instruction ergaenzt
|
||||
<!-- /wikitool:bumps -->
|
||||
|
||||
|
||||
@@ -1177,6 +1178,45 @@ Geändert: `tools/chemenu/upload.py` (neu), `tools/chemenu/commands/upload_cmd.p
|
||||
`instructions/ingest-queue.md` (neu), `raw/CONTRACT.md`, `docs/why-gates-are-code.md`,
|
||||
`INSTALL-MCP.md`, `README.md`. Schließt #32.
|
||||
|
||||
**AGENTS.md behauptete, `docs verify` prüfe die Contract-Prosa selbst - das stimmt nicht (#90).**
|
||||
`check_cli_readme()` prüft nur, ob der gebacktickte Pfad einer Tabellenzeile registriert ist, nie
|
||||
den Rest der Zelle: eine ausgetauschte Kommandobeschreibung oder ein neues `--flag` bleiben
|
||||
unsichtbar, und `TABLE_CELL_RE` läuft über das ganze Dokument statt über eine abgegrenzte
|
||||
"Kommandotabelle". `AGENTS.md` § Changelog zählte trotzdem "command tables, contracts, ignore
|
||||
canaries" als maschinell geprüft auf und grenzte die Sitzungspflicht auf `README.md`/`EVALS.md`/
|
||||
`tools/README.md` ein - `tools/CONTRACT.md` und jedes `<stage>/CONTRACT.md` standen damit auf
|
||||
keiner Liste, die je jemand nachzieht.
|
||||
|
||||
Der Absatz nennt jetzt nur noch, was `docs verify`s eigene Zeile in `tools/CONTRACT.md`
|
||||
tatsächlich auflistet (Verweis statt Kopie), und macht jede Zellenprosa - Kommandotabelle,
|
||||
Fehlerkontrakt, Stage-Contract - ausdrücklich zur Sitzungsarbeit, neben den drei README-artigen
|
||||
Dateien. Die Docstring von `check_cli_readme()` behauptet nicht mehr, sie prüfe
|
||||
"tools/CONTRACT.md's command table" - sie beschreibt jetzt, dass `TABLE_CELL_RE` das ganze
|
||||
Dokument scannt und nur den gebacktickten Pfad liest, nie die restliche Zelle.
|
||||
|
||||
Neue Instruction [instructions/dev/doc-pull-through.md](instructions/dev/doc-pull-through.md)
|
||||
(dev-only) listet je berührter Fläche, welches Dokument eine Behauptung darüber trägt: beide
|
||||
Tabellen in `tools/CONTRACT.md`, der berührte `<stage>/CONTRACT.md`, `AGENTS.md` bei
|
||||
verschobener Regel/Gate/Invariante, die README-artigen Dateien, `docs/` bei verschobener
|
||||
Begründung. `stack-dev/SKILL.md` bekommt dafür einen neuen Schritt 5 zwischen Versionsbump und
|
||||
Verify/Publish (jetzt Schritt 6) - ein Satz plus Link, die Liste bleibt in der Instruction; die
|
||||
Katalog-Liste in Schritt 2 und `stack-close/SKILL.md` Schritt 3 nennen die neue Instruction bzw.
|
||||
die Contracts jetzt ebenfalls. `version-parts.md` und `testing-conventions.md` korrigieren dabei
|
||||
zwei schon vorher falsche Schrittverweise auf `stack-dev` (Schritt 3 -> 4, Schritt 4 -> 6),
|
||||
gefunden beim Nachziehen der Umnummerierung.
|
||||
|
||||
**MINOR, kein neuer Boundary-Crossing:** additiv und drop-in in beide Richtungen - eine
|
||||
bestehende Instanz kopiert die neue Instruction und die korrigierte Prosa über sich, ohne
|
||||
Migration oder Hand-Arbeit; kein Feld, kein Kommando, kein Flag ändert sich. Der Kandidat trägt
|
||||
seine `--breaking`-Zeile bereits aus einem früheren Bump; diese Änderung fügt keine neue hinzu.
|
||||
|
||||
Geändert: `AGENTS.md`, `tools/chemenu/commands/docs_verify.py`,
|
||||
`instructions/dev/doc-pull-through.md` (neu), `instructions/dev/stack-dev/SKILL.md`,
|
||||
`instructions/dev/stack-close/SKILL.md`, `instructions/dev/version-parts.md`,
|
||||
`instructions/dev/testing-conventions.md`. Verifiziert: `tools/wikitool docs verify`,
|
||||
`tools/wikitool instructions verify` (nach `instructions sync`), volle `pytest`-Suite (1185
|
||||
passed). Schließt #90.
|
||||
|
||||
---
|
||||
|
||||
## 4.7.4 - 2026-09-04 - bootstrap.md nennt den session-id-WARN nach frischem Bootstrap explizit als erwartet
|
||||
|
||||
Reference in New Issue
Block a user