Paket C aus #185. #187 (Gerüst) ist abgeschlossen, #188/#189 (generierte Referenz: Kommandos, Exit-Codes, Skills, Seitentypen) ebenfalls – wo deren Seiten existieren, wird verlinkt statt beschrieben. #191 (Tutorials) baut auf diesem Paket auf.
Stand: abgeschlossen. Gebaut und publiziert als 9.0.0-beta.6 in f9056c0 (Kandidat von 9.0.0-beta.5, --minor), verifiziert durch CI-Lauf 587 und Release-Lauf 588 (Veröffentlichung für den Beta-Kandidaten korrekt übersprungen). Die Abschlussprüfung fand eine Abweichung in docs/how-to/update-an-instance.md und hat sie als #195 erfasst (§ Abschlussprüfung). Ein Release ist nicht geschnitten – das entscheidet der Betreiber.
Was gebaut wurde
Die Aufgaben- und Erklärteile der großen Wurzeldokumente sind einzelne Seiten unter docs/how-to/, docs/reference/ und docs/explanation/, ins Englische übersetzt (E3), und die Wurzeldokumente haben sie verloren. Die Tutorial-Teile (Installation, erste Quelle) bleiben für #191 stehen.
Leitplanke 1 aus #185 gilt für jede Seite: Ein How-to sagt, was der Mensch vorbereitet, was er dem Agenten sagt, was er zurückbekommt und wo der Agent anhält – nie die Schritte, die eine Instruktion oder ein Skill dem Agenten vorgibt. Wo Text eine Agenten-Prozedur nacherzählte, steht jetzt ein Link auf den Skill-Katalog bzw. die Instruktion.
INSTALL.md § Konfiguration – handgeschrieben, bis #193 eine Quelle schafft
docs/explanation/architecture.md
README.md § Architecture, § What is this (Teil ohne Wegweiserfunktion), § IT-Specific Features
docs/explanation/telemetry-and-evaluation.md
EVALS.md § Why, § Architecture, § The trace, § Whether it runs at all, § What never reaches a trace, § Evaluation levels, § Scoring a session, § Status, § The agent runner
Alle vierzehn Seiten existieren unter genau diesen Namen; keine wurde zusammengelegt.
Zuschnitt-Entscheidungen im Bau
EVALS.md § „How much of the stack the suite reaches" (Coverage) ging nach docs/dev/development.md, nicht in die ausgelieferte Erklärseite. Er beschreibt nur die Testsuite und die CI-Artefakte des Ursprungs-Repos, die dist export beide nicht ausliefert, und trug schon einen Strip-Block mit Issue-Verweis. Verweise darauf (testing-conventions.md, .gitea/workflows/ci.yml, tools/.coveragerc, tools/README.md) zeigen auf docs/dev/development.md; die ausgelieferte tools/CONTRACT.md verlinkt nichts unter docs/dev/ (wäre in einer Instanz ein toter Link), sondern sagt den Grund selbst.
README-Abschnitte, die die Tabelle nicht nennt – Page Types, Workflows, Tools Integration (wikitool, MCP-Leseserver, Git), Files Created Automatically, Telemetry and evaluation: die erklärenden Teile stehen in docs/explanation/architecture.md, der Telemetrie-Abschnitt ist ein Link. Changelog, Resources und License bleiben in README.md (Landeseite).
commonplace/-Links aus EVALS.md sind in der Erklärseite als Name plus Link auf das Upstream-Repo geführt: commonplace/ wird nicht ausgeliefert, und docs/-Seiten liegen im Geltungsbereich von check_reference_targets.
Der Issue-Link für das Container-Image aus INSTALL-MCP.md entfiel (Leitplanke 4); die Seite sagt nur, dass es noch keins gibt.
set-up-the-mcp-server.md nummeriert die Schritte aus instructions/mcp-read-server.md nicht nach (Leitplanke 1): sie trägt, was die Instruktion ausdrücklich ausschließt – Client-Anbindung, Authentifizierung, submit-Freischaltung, Verifikation, Troubleshooting – und verlinkt die Instruktion für Installation, Start und Sync.
Zusätzlich gefunden:version check druckte zur Laufzeit noch „see INSTALL.md § 'Eine Instanz aktualisieren'"; ebenso die dist upgrade-/version check-Datensätze und doctors „See also" (INSTALL.md § "Konfiguration") – vom grep-Muster der Planung nicht erfasst, jetzt auf docs/how-to/update-an-instance.md bzw. docs/reference/configuration.md. git_publish.FILE_GROUPS führt docs/ statt EVALS.md unter „Human docs" (Test ergänzt). test_instructions_shell.py prüft die PowerShell-Bypass-Regel jetzt auch über alle ausgelieferten docs/-Seiten.
kb/: Die zwei Stellen in kb/entities/tools/wikitool.md und kb/entities/codebases/Chemenu.md sind datierte Historie-Einträge (2.4.x) und bleiben als Beleg, ebenso die Source-Seite; keine kb/-Änderung.
Wurzeldateien danach
INSTALL-MCP.md und EVALS.mdentfallen; aus dist_cmd.ROOT_FILES gestrichen, Zeile EVALS.md in AGENTS.md § File naming gestrichen, Sprachregel (Punkt 3) und § Changelog-Liste angepasst.
README.md behält Einleitung (kurz), Getting started, Your first ingestion (bis #191) und den Wegweiser aus #187 – dazu Changelog, Resources, License.
INSTALL.md behält nur, was #191 braucht (§ Was vorher da sein muss, § Der Satz für den Agenten, § Was der Agent dich fragt, § Wenn der Agent anhält, § Verifikation), plus einen kurzen Abschnitt „Danach" mit Links auf die neuen Seiten. Generierte Regionen und setup-question-Marker unangetastet. INSTALL.md ist weiterhin deutsch – das übersetzt #191.
Verweise nachgezogen
Neu erhoben 2026-10-06 im Bau und nachgezogen: AGENTS.md, README.md, INSTALL.md, .vibe/hooks.toml, .gitignore (Kommentare), tools/README.md, tools/CONTRACT.md (über Datensätze, dann docs contract --apply; dazu der handgeschriebene Testabschnitt), tools/.coveragerc, reports/CONTRACT.md, instructions/setup-instance.md, instructions/upgrade-instance.md, instructions/dev/{doc-pull-through,dev-setup,testing-conventions,version-parts}.md, instructions/dev/stack-build/SKILL.md, docs/dev/development.md, docs/how-to/README.md, docs/explanation/language-boundaries.md, docs/reference/commands/* (über docs reference --apply), .gitea/workflows/ci.yml (Kommentare), Laufzeittexte/Docstrings in tools/chemenu/{telemetry/policy.py,evals/*.py,commands/{docs_verify,git_publish,dist_cmd,upload_cmd,doctor,eval_cmd,version_cmd}.py,toc.py}, Tests (test_dist_cmd.py, test_git_publish.py, test_instructions_shell.py, test_pipeline_l0.py). instructions/dev/doc-pull-through.md: Konfigurationszeile auf docs/reference/configuration.md, Installationszeile nennt docs/how-to/update-an-instance.md als menschliches Gegenstück zu upgrade-instance.md.
Abschlussprüfung (stack-close)
Verweise auf entfallene README-Abschnitte: gesucht (README.md §, README.md#, die alten Abschnittsnamen) – außerhalb von commonplace/ keine Fundstelle.
Aussagen über README.md/INSTALL.md in docs/explanation/, instructions/, types/, den Contracts und tools/README.md: gelesen; keine ist durch diese Änderung falsch geworden. AGENTS.md § File naming („Six explanation pages are reached from this file") stimmt weiterhin – die zwei neuen Erklärseiten sind nur aus docs/explanation/README.md verlinkt.
Installationsinstruktionen: Der Diff berührt setup-instance.md und upgrade-instance.md (nur Links). INSTALL.md gegen setup-instance.md gelesen: keine Abweichung. docs/how-to/update-an-instance.md gegen upgrade-instance.md gelesen: eine Abweichung – „A required migration is simply carried out" übergeht den Entscheidungspunkt „A required migration cannot be completed now? Stop after step 10". Als #195 erfasst, nicht hier korrigiert, weil die Durchsicht vor dem Publish sie übersehen hat.
Kein Nachzieh-Publish in dieser Phase, daher kein weiterer Bump.
Version
MINOR – zwei Wurzeldateien fallen weg, Pfade in Meldungen ändern sich; keine instanzeigene Datei verweist auf sie (geprüft: nur kb/CONVENTIONS.md.template verlinkt in docs/, keine Vorlage auf EVALS.md/INSTALL-MCP.md), dist upgrade räumt die zwei Dateien als „retired" ab. Drop-in in beide Richtungen. Auf dem laufenden Kandidaten (MAJOR aus #187) erhöhte der --minor-Bump nur die Bump-Zahl: 9.0.0-beta.6. CHANGES.md: Bump-Titel plus Themenabschnitt „The root documents split into docs/ pages (#190)".
Akzeptanzkriterien
Jede Zeile der Tabelle hat ihre Zielseite (oder ist begründet zusammengelegt), auf Englisch; jede Seite ist unter docs/how-to/README.md, docs/reference/README.md bzw. docs/explanation/README.md verlinkt.
INSTALL-MCP.md und EVALS.md existieren nicht mehr; grep -rnE "INSTALL-MCP\.md|EVALS\.md" außerhalb von CHANGES.md, kb/, raw/, reports/, commonplace/ findet nichts – einzige Ausnahmetools/chemenu/tests/test_dist_cmd.py::test_plan_ships_no_retired_root_docs, der die beiden Dateien absichtlich anlegt, um zu belegen, dass sie nicht mehr ausgeliefert werden.
Keine How-to-Seite enthält eine nummerierte Schrittfolge, die eine Instruktion oder ein Skill bereits vorgibt (Lesekontrolle im Build gegen instructions/; die How-to-Seiten enthalten überhaupt keine nummerierte Liste).
dist export + docs verify im Zielbaum grün (nach dist adopt und kb/CONVENTIONS.md aus der Vorlage ohne Platzhalter; vorher nur die bekannten nicht übernommenen Vorlagen, nichts zu docs/). In CI zusätzlich der Schritt „The distribution works as a fresh instance" in Lauf 587.
Paket C aus #185. #187 (Gerüst) ist abgeschlossen, #188/#189 (generierte Referenz: Kommandos, Exit-Codes, Skills, Seitentypen) ebenfalls – wo deren Seiten existieren, wird verlinkt statt beschrieben. #191 (Tutorials) baut auf diesem Paket auf.
**Stand: abgeschlossen.** Gebaut und publiziert als **9.0.0-beta.6** in `f9056c0` (Kandidat von `9.0.0-beta.5`, `--minor`), verifiziert durch CI-Lauf [587](https://gitea.nehmer.net/torben/chemenu/actions/runs/587) und Release-Lauf [588](https://gitea.nehmer.net/torben/chemenu/actions/runs/588) (Veröffentlichung für den Beta-Kandidaten korrekt übersprungen). Die Abschlussprüfung fand eine Abweichung in `docs/how-to/update-an-instance.md` und hat sie als #195 erfasst (§ Abschlussprüfung). Ein Release ist nicht geschnitten – das entscheidet der Betreiber.
## Was gebaut wurde
Die Aufgaben- und Erklärteile der großen Wurzeldokumente sind einzelne Seiten unter `docs/how-to/`, `docs/reference/` und `docs/explanation/`, ins Englische übersetzt (E3), und die Wurzeldokumente haben sie verloren. Die Tutorial-Teile (Installation, erste Quelle) bleiben für #191 stehen.
**Leitplanke 1 aus #185 gilt für jede Seite:** Ein How-to sagt, was der Mensch vorbereitet, was er dem Agenten sagt, was er zurückbekommt und wo der Agent anhält – nie die Schritte, die eine Instruktion oder ein Skill dem Agenten vorgibt. Wo Text eine Agenten-Prozedur nacherzählte, steht jetzt ein Link auf den Skill-Katalog bzw. die Instruktion.
### Zielseiten
| Neue Seite | Quelle |
|---|---|
| `docs/how-to/ingest-a-source.md` | `README.md` § Adding Knowledge (Datei, Ordner, URL, `mcp-upload/`) |
| `docs/how-to/capture-repository-docs.md` | `README.md` § Adding Knowledge (`raw capture`/`raw status`, „Update the captured repositories") |
| `docs/how-to/export-guidelines.md` | `README.md` § Adding Knowledge (Leitlinien-Export, Guideline Push Gate) |
| `docs/how-to/query-the-wiki.md` | `README.md` § Querying Knowledge, § Search |
| `docs/how-to/maintain-the-wiki.md` | `README.md` § Maintaining Knowledge, § Maintenance |
| `docs/how-to/run-the-weekly-review.md` | `README.md` § Reviewing Commitments |
| `docs/how-to/browse-with-obsidian.md` | `README.md` § Obsidian, § Tips |
| `docs/how-to/update-an-instance.md` | `INSTALL.md` § Version und Updates |
| `docs/how-to/troubleshoot.md` | `INSTALL.md` § Troubleshooting |
| `docs/how-to/set-up-the-mcp-server.md` | `INSTALL-MCP.md` vollständig |
| `docs/how-to/trace-and-score-sessions.md` | `EVALS.md` § Harness support, § Using it today |
| `docs/reference/configuration.md` | `INSTALL.md` § Konfiguration – handgeschrieben, bis #193 eine Quelle schafft |
| `docs/explanation/architecture.md` | `README.md` § Architecture, § What is this (Teil ohne Wegweiserfunktion), § IT-Specific Features |
| `docs/explanation/telemetry-and-evaluation.md` | `EVALS.md` § Why, § Architecture, § The trace, § Whether it runs at all, § What never reaches a trace, § Evaluation levels, § Scoring a session, § Status, § The agent runner |
Alle vierzehn Seiten existieren unter genau diesen Namen; keine wurde zusammengelegt.
### Zuschnitt-Entscheidungen im Bau
1. **`EVALS.md` § „How much of the stack the suite reaches" (Coverage) ging nach `docs/dev/development.md`, nicht in die ausgelieferte Erklärseite.** Er beschreibt nur die Testsuite und die CI-Artefakte des Ursprungs-Repos, die `dist export` beide nicht ausliefert, und trug schon einen Strip-Block mit Issue-Verweis. Verweise darauf (`testing-conventions.md`, `.gitea/workflows/ci.yml`, `tools/.coveragerc`, `tools/README.md`) zeigen auf `docs/dev/development.md`; die ausgelieferte `tools/CONTRACT.md` verlinkt nichts unter `docs/dev/` (wäre in einer Instanz ein toter Link), sondern sagt den Grund selbst.
2. **README-Abschnitte, die die Tabelle nicht nennt** – *Page Types*, *Workflows*, *Tools Integration* (wikitool, MCP-Leseserver, Git), *Files Created Automatically*, *Telemetry and evaluation*: die erklärenden Teile stehen in `docs/explanation/architecture.md`, der Telemetrie-Abschnitt ist ein Link. *Changelog*, *Resources* und *License* bleiben in `README.md` (Landeseite).
3. **`commonplace/`-Links aus `EVALS.md`** sind in der Erklärseite als Name plus Link auf das Upstream-Repo geführt: `commonplace/` wird nicht ausgeliefert, und `docs/`-Seiten liegen im Geltungsbereich von `check_reference_targets`.
4. **Der Issue-Link für das Container-Image aus `INSTALL-MCP.md`** entfiel (Leitplanke 4); die Seite sagt nur, dass es noch keins gibt.
5. **`set-up-the-mcp-server.md` nummeriert die Schritte aus `instructions/mcp-read-server.md` nicht nach** (Leitplanke 1): sie trägt, was die Instruktion ausdrücklich ausschließt – Client-Anbindung, Authentifizierung, `submit`-Freischaltung, Verifikation, Troubleshooting – und verlinkt die Instruktion für Installation, Start und Sync.
6. **Zusätzlich gefunden:** `version check` druckte zur Laufzeit noch „see INSTALL.md § 'Eine Instanz aktualisieren'"; ebenso die `dist upgrade`-/`version check`-Datensätze und `doctor`s „See also" (`INSTALL.md` § "Konfiguration") – vom grep-Muster der Planung nicht erfasst, jetzt auf `docs/how-to/update-an-instance.md` bzw. `docs/reference/configuration.md`. `git_publish.FILE_GROUPS` führt `docs/` statt `EVALS.md` unter „Human docs" (Test ergänzt). `test_instructions_shell.py` prüft die PowerShell-Bypass-Regel jetzt auch über alle ausgelieferten `docs/`-Seiten.
7. **`kb/`:** Die zwei Stellen in `kb/entities/tools/wikitool.md` und `kb/entities/codebases/Chemenu.md` sind datierte Historie-Einträge (2.4.x) und bleiben als Beleg, ebenso die Source-Seite; keine `kb/`-Änderung.
### Wurzeldateien danach
- `INSTALL-MCP.md` und `EVALS.md` **entfallen**; aus `dist_cmd.ROOT_FILES` gestrichen, Zeile `EVALS.md` in `AGENTS.md` § File naming gestrichen, Sprachregel (Punkt 3) und § Changelog-Liste angepasst.
- `README.md` behält Einleitung (kurz), *Getting started*, *Your first ingestion* (bis #191) und den Wegweiser aus #187 – dazu *Changelog*, *Resources*, *License*.
- `INSTALL.md` behält nur, was #191 braucht (§ Was vorher da sein muss, § Der Satz für den Agenten, § Was der Agent dich fragt, § Wenn der Agent anhält, § Verifikation), plus einen kurzen Abschnitt „Danach" mit Links auf die neuen Seiten. Generierte Regionen und `setup-question`-Marker unangetastet. `INSTALL.md` ist weiterhin deutsch – das übersetzt #191.
### Verweise nachgezogen
Neu erhoben 2026-10-06 im Bau und nachgezogen: `AGENTS.md`, `README.md`, `INSTALL.md`, `.vibe/hooks.toml`, `.gitignore` (Kommentare), `tools/README.md`, `tools/CONTRACT.md` (über Datensätze, dann `docs contract --apply`; dazu der handgeschriebene Testabschnitt), `tools/.coveragerc`, `reports/CONTRACT.md`, `instructions/setup-instance.md`, `instructions/upgrade-instance.md`, `instructions/dev/{doc-pull-through,dev-setup,testing-conventions,version-parts}.md`, `instructions/dev/stack-build/SKILL.md`, `docs/dev/development.md`, `docs/how-to/README.md`, `docs/explanation/language-boundaries.md`, `docs/reference/commands/*` (über `docs reference --apply`), `.gitea/workflows/ci.yml` (Kommentare), Laufzeittexte/Docstrings in `tools/chemenu/{telemetry/policy.py,evals/*.py,commands/{docs_verify,git_publish,dist_cmd,upload_cmd,doctor,eval_cmd,version_cmd}.py,toc.py}`, Tests (`test_dist_cmd.py`, `test_git_publish.py`, `test_instructions_shell.py`, `test_pipeline_l0.py`). `instructions/dev/doc-pull-through.md`: Konfigurationszeile auf `docs/reference/configuration.md`, Installationszeile nennt `docs/how-to/update-an-instance.md` als menschliches Gegenstück zu `upgrade-instance.md`.
### Abschlussprüfung (`stack-close`)
- **Verweise auf entfallene README-Abschnitte:** gesucht (`README.md §`, `README.md#`, die alten Abschnittsnamen) – außerhalb von `commonplace/` keine Fundstelle.
- **Aussagen über `README.md`/`INSTALL.md` in `docs/explanation/`, `instructions/`, `types/`, den Contracts und `tools/README.md`:** gelesen; keine ist durch diese Änderung falsch geworden. `AGENTS.md` § File naming („Six explanation pages are reached from this file") stimmt weiterhin – die zwei neuen Erklärseiten sind nur aus `docs/explanation/README.md` verlinkt.
- **Installationsinstruktionen:** Der Diff berührt `setup-instance.md` und `upgrade-instance.md` (nur Links). `INSTALL.md` gegen `setup-instance.md` gelesen: keine Abweichung. `docs/how-to/update-an-instance.md` gegen `upgrade-instance.md` gelesen: **eine Abweichung** – „A required migration is simply carried out" übergeht den Entscheidungspunkt „A required migration cannot be completed now? Stop after step 10". Als **#195** erfasst, nicht hier korrigiert, weil die Durchsicht vor dem Publish sie übersehen hat.
- Kein Nachzieh-Publish in dieser Phase, daher kein weiterer Bump.
## Version
**MINOR** – zwei Wurzeldateien fallen weg, Pfade in Meldungen ändern sich; keine instanzeigene Datei verweist auf sie (geprüft: nur `kb/CONVENTIONS.md.template` verlinkt in `docs/`, keine Vorlage auf `EVALS.md`/`INSTALL-MCP.md`), `dist upgrade` räumt die zwei Dateien als „retired" ab. Drop-in in beide Richtungen. Auf dem laufenden Kandidaten (MAJOR aus #187) erhöhte der `--minor`-Bump nur die Bump-Zahl: **9.0.0-beta.6**. `CHANGES.md`: Bump-Titel plus Themenabschnitt „The root documents split into `docs/` pages (#190)".
## Akzeptanzkriterien
- [x] Jede Zeile der Tabelle hat ihre Zielseite (oder ist begründet zusammengelegt), auf Englisch; jede Seite ist unter `docs/how-to/README.md`, `docs/reference/README.md` bzw. `docs/explanation/README.md` verlinkt.
- [x] `INSTALL-MCP.md` und `EVALS.md` existieren nicht mehr; `grep -rnE "INSTALL-MCP\.md|EVALS\.md"` außerhalb von `CHANGES.md`, `kb/`, `raw/`, `reports/`, `commonplace/` findet nichts – **einzige Ausnahme** `tools/chemenu/tests/test_dist_cmd.py::test_plan_ships_no_retired_root_docs`, der die beiden Dateien absichtlich anlegt, um zu belegen, dass sie nicht mehr ausgeliefert werden.
- [x] Keine How-to-Seite enthält eine nummerierte Schrittfolge, die eine Instruktion oder ein Skill bereits vorgibt (Lesekontrolle im Build gegen `instructions/`; die How-to-Seiten enthalten überhaupt keine nummerierte Liste).
- [x] `install_doc`-Checks (Voraussetzungsregionen, Setup-Fragen-Marker) bleiben grün; `docs prerequisites` meldet „already current".
- [x] `dist export` + `docs verify` im Zielbaum grün (nach `dist adopt` und `kb/CONVENTIONS.md` aus der Vorlage ohne Platzhalter; vorher nur die bekannten nicht übernommenen Vorlagen, nichts zu `docs/`). In CI zusätzlich der Schritt „The distribution works as a fresh instance" in Lauf 587.
- [x] `pytest` (2430 bestanden, 3 übersprungen), `docs verify`, `instructions verify` lokal grün; CI-Lauf 587 (`f9056c0`) grün, Release-Lauf 588 grün mit übersprungener Veröffentlichung.
Changelog: Gebaut und publiziert als 9.0.0-beta.6 in f9056c0, CI-Lauf 587 und Release-Lauf 588 grün; alle Kriterien abgehakt. status/blocked entfernt (#187 geschlossen). Neu im Body: § Zuschnitt-Entscheidungen im Bau (Coverage-Abschnitt nach docs/dev/development.md, README-Reste in architecture.md, commonplace/-Links aufs Upstream-Repo, Issue-Link für das Container-Image entfallen, MCP-How-to verlinkt statt nachnummeriert, zusätzlich gefundene INSTALL.md-§-Verweise in version check/dist upgrade/doctor, kb/ bewusst unangetastet). Die grep-Ausnahme beim zweiten Kriterium ist benannt (absichtlicher Test). Offen: stack-close.
**Changelog:** Gebaut und publiziert als 9.0.0-beta.6 in `f9056c0`, CI-Lauf 587 und Release-Lauf 588 grün; alle Kriterien abgehakt. `status/blocked` entfernt (#187 geschlossen). Neu im Body: § Zuschnitt-Entscheidungen im Bau (Coverage-Abschnitt nach `docs/dev/development.md`, README-Reste in `architecture.md`, `commonplace/`-Links aufs Upstream-Repo, Issue-Link für das Container-Image entfallen, MCP-How-to verlinkt statt nachnummeriert, zusätzlich gefundene `INSTALL.md`-§-Verweise in `version check`/`dist upgrade`/`doctor`, `kb/` bewusst unangetastet). Die grep-Ausnahme beim zweiten Kriterium ist benannt (absichtlicher Test). Offen: `stack-close`.
Changelog: Abschlussprüfung durchgeführt, Body im Endzustand (Stand „abgeschlossen", neuer Abschnitt § Abschlussprüfung). Gefunden: update-an-instance.md übergeht den Stopp-Fall einer Pflichtmigration aus upgrade-instance.md – als #195 erfasst. Sonst nichts veraltet; kein Nachzieh-Publish. Geschlossen.
**Changelog:** Abschlussprüfung durchgeführt, Body im Endzustand (Stand „abgeschlossen", neuer Abschnitt § Abschlussprüfung). Gefunden: `update-an-instance.md` übergeht den Stopp-Fall einer Pflichtmigration aus `upgrade-instance.md` – als #195 erfasst. Sonst nichts veraltet; kein Nachzieh-Publish. Geschlossen.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Paket C aus #185. #187 (Gerüst) ist abgeschlossen, #188/#189 (generierte Referenz: Kommandos, Exit-Codes, Skills, Seitentypen) ebenfalls – wo deren Seiten existieren, wird verlinkt statt beschrieben. #191 (Tutorials) baut auf diesem Paket auf.
Stand: abgeschlossen. Gebaut und publiziert als 9.0.0-beta.6 in
f9056c0(Kandidat von9.0.0-beta.5,--minor), verifiziert durch CI-Lauf 587 und Release-Lauf 588 (Veröffentlichung für den Beta-Kandidaten korrekt übersprungen). Die Abschlussprüfung fand eine Abweichung indocs/how-to/update-an-instance.mdund hat sie als #195 erfasst (§ Abschlussprüfung). Ein Release ist nicht geschnitten – das entscheidet der Betreiber.Was gebaut wurde
Die Aufgaben- und Erklärteile der großen Wurzeldokumente sind einzelne Seiten unter
docs/how-to/,docs/reference/unddocs/explanation/, ins Englische übersetzt (E3), und die Wurzeldokumente haben sie verloren. Die Tutorial-Teile (Installation, erste Quelle) bleiben für #191 stehen.Leitplanke 1 aus #185 gilt für jede Seite: Ein How-to sagt, was der Mensch vorbereitet, was er dem Agenten sagt, was er zurückbekommt und wo der Agent anhält – nie die Schritte, die eine Instruktion oder ein Skill dem Agenten vorgibt. Wo Text eine Agenten-Prozedur nacherzählte, steht jetzt ein Link auf den Skill-Katalog bzw. die Instruktion.
Zielseiten
docs/how-to/ingest-a-source.mdREADME.md§ Adding Knowledge (Datei, Ordner, URL,mcp-upload/)docs/how-to/capture-repository-docs.mdREADME.md§ Adding Knowledge (raw capture/raw status, „Update the captured repositories")docs/how-to/export-guidelines.mdREADME.md§ Adding Knowledge (Leitlinien-Export, Guideline Push Gate)docs/how-to/query-the-wiki.mdREADME.md§ Querying Knowledge, § Searchdocs/how-to/maintain-the-wiki.mdREADME.md§ Maintaining Knowledge, § Maintenancedocs/how-to/run-the-weekly-review.mdREADME.md§ Reviewing Commitmentsdocs/how-to/browse-with-obsidian.mdREADME.md§ Obsidian, § Tipsdocs/how-to/update-an-instance.mdINSTALL.md§ Version und Updatesdocs/how-to/troubleshoot.mdINSTALL.md§ Troubleshootingdocs/how-to/set-up-the-mcp-server.mdINSTALL-MCP.mdvollständigdocs/how-to/trace-and-score-sessions.mdEVALS.md§ Harness support, § Using it todaydocs/reference/configuration.mdINSTALL.md§ Konfiguration – handgeschrieben, bis #193 eine Quelle schafftdocs/explanation/architecture.mdREADME.md§ Architecture, § What is this (Teil ohne Wegweiserfunktion), § IT-Specific Featuresdocs/explanation/telemetry-and-evaluation.mdEVALS.md§ Why, § Architecture, § The trace, § Whether it runs at all, § What never reaches a trace, § Evaluation levels, § Scoring a session, § Status, § The agent runnerAlle vierzehn Seiten existieren unter genau diesen Namen; keine wurde zusammengelegt.
Zuschnitt-Entscheidungen im Bau
EVALS.md§ „How much of the stack the suite reaches" (Coverage) ging nachdocs/dev/development.md, nicht in die ausgelieferte Erklärseite. Er beschreibt nur die Testsuite und die CI-Artefakte des Ursprungs-Repos, diedist exportbeide nicht ausliefert, und trug schon einen Strip-Block mit Issue-Verweis. Verweise darauf (testing-conventions.md,.gitea/workflows/ci.yml,tools/.coveragerc,tools/README.md) zeigen aufdocs/dev/development.md; die ausgeliefertetools/CONTRACT.mdverlinkt nichts unterdocs/dev/(wäre in einer Instanz ein toter Link), sondern sagt den Grund selbst.docs/explanation/architecture.md, der Telemetrie-Abschnitt ist ein Link. Changelog, Resources und License bleiben inREADME.md(Landeseite).commonplace/-Links ausEVALS.mdsind in der Erklärseite als Name plus Link auf das Upstream-Repo geführt:commonplace/wird nicht ausgeliefert, unddocs/-Seiten liegen im Geltungsbereich voncheck_reference_targets.INSTALL-MCP.mdentfiel (Leitplanke 4); die Seite sagt nur, dass es noch keins gibt.set-up-the-mcp-server.mdnummeriert die Schritte ausinstructions/mcp-read-server.mdnicht nach (Leitplanke 1): sie trägt, was die Instruktion ausdrücklich ausschließt – Client-Anbindung, Authentifizierung,submit-Freischaltung, Verifikation, Troubleshooting – und verlinkt die Instruktion für Installation, Start und Sync.version checkdruckte zur Laufzeit noch „see INSTALL.md § 'Eine Instanz aktualisieren'"; ebenso diedist upgrade-/version check-Datensätze unddoctors „See also" (INSTALL.md§ "Konfiguration") – vom grep-Muster der Planung nicht erfasst, jetzt aufdocs/how-to/update-an-instance.mdbzw.docs/reference/configuration.md.git_publish.FILE_GROUPSführtdocs/stattEVALS.mdunter „Human docs" (Test ergänzt).test_instructions_shell.pyprüft die PowerShell-Bypass-Regel jetzt auch über alle ausgeliefertendocs/-Seiten.kb/: Die zwei Stellen inkb/entities/tools/wikitool.mdundkb/entities/codebases/Chemenu.mdsind datierte Historie-Einträge (2.4.x) und bleiben als Beleg, ebenso die Source-Seite; keinekb/-Änderung.Wurzeldateien danach
INSTALL-MCP.mdundEVALS.mdentfallen; ausdist_cmd.ROOT_FILESgestrichen, ZeileEVALS.mdinAGENTS.md§ File naming gestrichen, Sprachregel (Punkt 3) und § Changelog-Liste angepasst.README.mdbehält Einleitung (kurz), Getting started, Your first ingestion (bis #191) und den Wegweiser aus #187 – dazu Changelog, Resources, License.INSTALL.mdbehält nur, was #191 braucht (§ Was vorher da sein muss, § Der Satz für den Agenten, § Was der Agent dich fragt, § Wenn der Agent anhält, § Verifikation), plus einen kurzen Abschnitt „Danach" mit Links auf die neuen Seiten. Generierte Regionen undsetup-question-Marker unangetastet.INSTALL.mdist weiterhin deutsch – das übersetzt #191.Verweise nachgezogen
Neu erhoben 2026-10-06 im Bau und nachgezogen:
AGENTS.md,README.md,INSTALL.md,.vibe/hooks.toml,.gitignore(Kommentare),tools/README.md,tools/CONTRACT.md(über Datensätze, danndocs contract --apply; dazu der handgeschriebene Testabschnitt),tools/.coveragerc,reports/CONTRACT.md,instructions/setup-instance.md,instructions/upgrade-instance.md,instructions/dev/{doc-pull-through,dev-setup,testing-conventions,version-parts}.md,instructions/dev/stack-build/SKILL.md,docs/dev/development.md,docs/how-to/README.md,docs/explanation/language-boundaries.md,docs/reference/commands/*(überdocs reference --apply),.gitea/workflows/ci.yml(Kommentare), Laufzeittexte/Docstrings intools/chemenu/{telemetry/policy.py,evals/*.py,commands/{docs_verify,git_publish,dist_cmd,upload_cmd,doctor,eval_cmd,version_cmd}.py,toc.py}, Tests (test_dist_cmd.py,test_git_publish.py,test_instructions_shell.py,test_pipeline_l0.py).instructions/dev/doc-pull-through.md: Konfigurationszeile aufdocs/reference/configuration.md, Installationszeile nenntdocs/how-to/update-an-instance.mdals menschliches Gegenstück zuupgrade-instance.md.Abschlussprüfung (
stack-close)README.md §,README.md#, die alten Abschnittsnamen) – außerhalb voncommonplace/keine Fundstelle.README.md/INSTALL.mdindocs/explanation/,instructions/,types/, den Contracts undtools/README.md: gelesen; keine ist durch diese Änderung falsch geworden.AGENTS.md§ File naming („Six explanation pages are reached from this file") stimmt weiterhin – die zwei neuen Erklärseiten sind nur ausdocs/explanation/README.mdverlinkt.setup-instance.mdundupgrade-instance.md(nur Links).INSTALL.mdgegensetup-instance.mdgelesen: keine Abweichung.docs/how-to/update-an-instance.mdgegenupgrade-instance.mdgelesen: eine Abweichung – „A required migration is simply carried out" übergeht den Entscheidungspunkt „A required migration cannot be completed now? Stop after step 10". Als #195 erfasst, nicht hier korrigiert, weil die Durchsicht vor dem Publish sie übersehen hat.Version
MINOR – zwei Wurzeldateien fallen weg, Pfade in Meldungen ändern sich; keine instanzeigene Datei verweist auf sie (geprüft: nur
kb/CONVENTIONS.md.templateverlinkt indocs/, keine Vorlage aufEVALS.md/INSTALL-MCP.md),dist upgraderäumt die zwei Dateien als „retired" ab. Drop-in in beide Richtungen. Auf dem laufenden Kandidaten (MAJOR aus #187) erhöhte der--minor-Bump nur die Bump-Zahl: 9.0.0-beta.6.CHANGES.md: Bump-Titel plus Themenabschnitt „The root documents split intodocs/pages (#190)".Akzeptanzkriterien
docs/how-to/README.md,docs/reference/README.mdbzw.docs/explanation/README.mdverlinkt.INSTALL-MCP.mdundEVALS.mdexistieren nicht mehr;grep -rnE "INSTALL-MCP\.md|EVALS\.md"außerhalb vonCHANGES.md,kb/,raw/,reports/,commonplace/findet nichts – einzige Ausnahmetools/chemenu/tests/test_dist_cmd.py::test_plan_ships_no_retired_root_docs, der die beiden Dateien absichtlich anlegt, um zu belegen, dass sie nicht mehr ausgeliefert werden.instructions/; die How-to-Seiten enthalten überhaupt keine nummerierte Liste).install_doc-Checks (Voraussetzungsregionen, Setup-Fragen-Marker) bleiben grün;docs prerequisitesmeldet „already current".dist export+docs verifyim Zielbaum grün (nachdist adoptundkb/CONVENTIONS.mdaus der Vorlage ohne Platzhalter; vorher nur die bekannten nicht übernommenen Vorlagen, nichts zudocs/). In CI zusätzlich der Schritt „The distribution works as a fresh instance" in Lauf 587.pytest(2430 bestanden, 3 übersprungen),docs verify,instructions verifylokal grün; CI-Lauf 587 (f9056c0) grün, Release-Lauf 588 grün mit übersprungener Veröffentlichung.Changelog: Gebaut und publiziert als 9.0.0-beta.6 in
f9056c0, CI-Lauf 587 und Release-Lauf 588 grün; alle Kriterien abgehakt.status/blockedentfernt (#187 geschlossen). Neu im Body: § Zuschnitt-Entscheidungen im Bau (Coverage-Abschnitt nachdocs/dev/development.md, README-Reste inarchitecture.md,commonplace/-Links aufs Upstream-Repo, Issue-Link für das Container-Image entfallen, MCP-How-to verlinkt statt nachnummeriert, zusätzlich gefundeneINSTALL.md-§-Verweise inversion check/dist upgrade/doctor,kb/bewusst unangetastet). Die grep-Ausnahme beim zweiten Kriterium ist benannt (absichtlicher Test). Offen:stack-close.Changelog: Abschlussprüfung durchgeführt, Body im Endzustand (Stand „abgeschlossen", neuer Abschnitt § Abschlussprüfung). Gefunden:
update-an-instance.mdübergeht den Stopp-Fall einer Pflichtmigration ausupgrade-instance.md– als #195 erfasst. Sonst nichts veraltet; kein Nachzieh-Publish. Geschlossen.