@renoxar/koolie 1.25.0 → 2.0.0

package/.koolie/core/tests/scripts/validate-framework.py

@@ -182,7 +182,7 @@ Prüft (statisch, ohne laufenden KI-Client):
      `claude-code` bildet die fehlende Modellzulassung auf `disable-model-invocation`
      ab. Ein nicht-interaktiver Messlauf bekommt sonst eine Abweisung statt des
      Ablaufs, und der Testfall misst etwas anderes als seinen Gegenstand. Gemessen am
-     2026-09-18 an `FW-SC-01`: Der Hauptlauf rief `fw-change-small` auf, wurde
+     2026-09-18 an `FW-SC-01`: Der Hauptlauf rief `koolie-change-small` auf, wurde
      abgewiesen, arbeitete den Ablauf nicht nach - und damit fiel Schritt 3 des Skills
      aus, der die Verwender der geaenderten Einheit erhebt. Neun von zwoelf Skills
      betroffen, vier Fundstellen im Katalog
@@ -256,7 +256,7 @@ Prüft (statisch, ohne laufenden KI-Client):
      Testfall ist nur in einem Baum fahrbar, den der Validator beanstandet. Gemessen am
      2026-09-18: RE-001-N09 verlangte das Uebungs-Overlay "ohne gesetztes
      <ISSUE_TRACKER>", und Pruefung 55b war im SELBEN Release entstanden. Gegen den Skill
-     gehalten trifft die Zelle etwas anderes: role-re-ticket nennt den Fall
+     gehalten trifft die Zelle etwas anderes: koolie-ticket nennt den Fall
      "<ISSUE_TRACKER> unbekannt", also Bindung OHNE Wert - ein Ausfuellschlitz, kein
      fehlender Platzhalter. Der Zuschnitt arbeitet auf TEILSAETZEN, nicht auf Zellen: Eine
      Vorbedingung, die den Platzhalter in einem Teilsatz fordert und in einem anderen eine
@@ -295,7 +295,7 @@ Prüft (statisch, ohne laufenden KI-Client):
      AUSFUEHRT (Exec(<..._COMMAND>) unter permissions), nennt diesen Schlitz in ihrer
      VORBEDINGUNG. ANLASS: FW-SC-01 ist am 2026-09-18 zum dritten Mal gefahren worden
      und zum dritten Mal nicht abnehmbar gewesen - der Lauf hat NICHTS geaendert, weil
-     fw-change-small den Testbefehl VOR dem ersten Schreibzugriff verlangt und der
+     koolie-change-small den Testbefehl VOR dem ersten Schreibzugriff verlangt und der
      Befehl im Messbaum im ask-Korb stand; ask ist nicht-interaktiv eine Abweisung
      (D-134). Derselbe Fehler kostete FW-PO-02 einen Durchgang. GRENZE: Geprueft wird
      die NENNUNG des Schlitzes, nicht die Aussage darueber - die Pruefung faengt das
@@ -442,7 +442,7 @@ Prüft (statisch, ohne laufenden KI-Client):
      Namenseintraegen der Berechtigungsdatei - in beide Richtungen. ANLASS, und er
      ist gemessen: Der Messbaum von Buendel 5 trug nach der Aktivierung WORTGETREU
      nach framework/role-packs/README.md dreizehn Skillverzeichnisse und zwoelf
-     Skill(...)-Eintraege; role-re-ticket fehlte, und der Validator meldete 0 Fehler.
+     Skill(...)-Eintraege; koolie-ticket fehlte, und der Validator meldete 0 Fehler.
      Ein nicht genannter Aufruf faellt in den Rueckfragekorb und im
      rueckfragefreien Betrieb in die Abweisung - die Sitzung liest die SKILL.md dann
      ersatzweise als Datei, OHNE die Werkzeugbeschraenkung des Skills (D-81).
@@ -853,7 +853,14 @@ Prüft (statisch, ohne laufenden KI-Client):
      ANLASS: pip, npm und Chocolatey geben dem Installationsschritt kein Terminal
      (gemessen 2026-09-30). GRENZE: ob eine Paketquelle dem Befehl ein Terminal gibt
      (gemessen, nicht geprueft); die Veroeffentlichung
-Der Wirksamkeitsnachweis nach D-23 fuer die Pruefungen 4, 6, 8, 14, 18 bis 66 und 68 bis 112 laeuft als eigenes
+113. Keine Kennung in der Produktdokumentation (D-540), nur im Quellrepositorium: Fehler
+     je Markdown-Datei, die eine Kennung der Form CR-JJJJ-NNN, D-N oder K-N ausserhalb der
+     Nachweisschicht nennt. Nachweisschicht sind CHANGELOG, Decision Log, Roadmap,
+     Aenderungsantraege, Protokolle, Erhebungen und build/, in einem Produkttraeger die
+     Ergebnis- und Belegspalten der Testblaetter und Grenzfaelle, die Belegspalte der Faehigkeitsmatrix und
+     die Zeilen eines Versionsverlaufs. ANLASS: Rueckmeldung zum oeffentlichen
+     Repositorium (2026-10-02). GRENZE: die Kennung, nicht die Begruendungsprosa
+Der Wirksamkeitsnachweis nach D-23 fuer die Pruefungen 4, 6, 8, 14, 18 bis 66 und 68 bis 113 laeuft als eigenes
 Skript: .koolie/core/tests/scripts/probe-pruefungen.py (je Pruefung eine Sonde und eine
 Gegenprobe, auf einer Kopie des Repositoriums).
 
@@ -926,7 +933,8 @@ from pruefungen.dokumente import (  # noqa: E402
     check_altname_restbestand, check_bestandsliste_stand, check_chronikspanne,
     check_dokumentform, check_dokumentstand, check_dokumentzahlen,
     check_gegenzeichnung, check_lizenz, check_rechtschreibung, check_steckbrief,
-    check_verirrtes_steuerzeichen, check_zeilenendeform, check_zielangabe)
+    check_kennungen_in_produktdoku, check_verirrtes_steuerzeichen, check_zeilenendeform,
+    check_zielangabe)
 from pruefungen.werkzeuge import (  # noqa: E402
     check_arbeitsplatzpfad, check_bytecode_versioniert, check_erhebungen_sauber,
     check_gitignore_erzeugnisse, check_kernlage, check_lieferumfang, check_paketquellen,
@@ -1078,6 +1086,7 @@ def main() -> int:
     check_skill_werkzeugfelder(root, man)
     check_fremde_skills(root, man)
     check_paketquellen(root)
+    check_kennungen_in_produktdoku(root)
     if args.strict_overlay:
         check_strict_overlay(root, man)
         check_platzhalterbindung(root, man)

package/.koolie/core/tests/scripts/validate-output.py

@@ -3,7 +3,7 @@
 validate-output.py – Prüft eine Ausgabe des KI-Clients gegen das Ausgabeformat eines Skills.
 
 Aufruf:
-    python3 .koolie/core/tests/scripts/validate-output.py --skill fw-repo-analyze [--file ausgabe.md]
+    python3 .koolie/core/tests/scripts/validate-output.py --skill koolie-repo-analyze [--file ausgabe.md]
     (ohne --file wird die Ausgabe von stdin gelesen)
 
 Prüft:

package/CONTRIBUTING.md

@@ -53,12 +53,12 @@ Pack** – das [Laufzeitglossar](.koolie/core/docs/RUNTIME_GLOSSARY.md) löst je
 ├── <Wurzel-Anweisungsdatei>             # Agentenanweisung (aus dem Kern installiert)
 ├── <Laufzeitschicht>/                   # vollständig erzeugt – nie von Hand schreiben
 │   ├── <Berechtigungsdatei>             # Kernregeln + Projektwerte (je Pack: samt Hooks)
-│   ├── agents/fw-reviewer.md            # nur lesendes Review-Subagentenprofil
+│   ├── agents/koolie-reviewer.md        # nur lesendes Review-Subagentenprofil
 │   ├── rules/00-, 10-, 15-*.md          # Core-Kurzfassungen ....... aus dem Kern
 │   ├── rules/20-project-overlay.md      # Overlay-Laufzeitfassung ... Projekt
 │   ├── rules/2N-overlay-*.md            # Overlay-Regelerweiterungen  Projekt
 │   ├── rules/30-, 40-*.md               # aktivierte Packs
-│   └── skills/fw-* role-* tech-* prj-*  # Kern | aktivierte Packs | Projekt
+│   └── skills/koolie-*, prj-*           # Koolie (Kern, aktivierte Packs) | Projekt
 │
 ├── .koolie/
 │   ├── core/                            # DER KERN: unveränderlich, byte-gleich
@@ -109,11 +109,17 @@ ein offener Klärungspunkt, `CR-…` ein Änderungsantrag unter `.koolie/core/go
 
 ## Konventionen
 
-Verbindlichkeit über **MUSS/SOLL/KANN/DARF NICHT**; produktbezogene Aussagen tragen einen Belegstatus
-`[DOK]`/`[EMPF]`/`[KONZ]` oder `BELEG OFFEN` mit Grund und Datum; variable Inhalte ausschließlich als
-registrierte Platzhalter ([`PLACEHOLDER_REGISTRY.md`](.koolie/core/docs/PLACEHOLDER_REGISTRY.md)); Beispiele
-sind stets als synthetisch gekennzeichnet; Personen werden nirgends genannt – nur Rollen.
-
-Die Lizenzdatei liegt an **zwei** Stellen mit demselben Inhalt – in der Wurzel und unter
-`.koolie/core/LICENSE` –, weil ein übernehmendes Projekt den Kern als Ganzes kopiert und ein Werk nicht ohne
-seine Lizenz weitergegeben werden darf. Der Validator hält beide gegeneinander.
+- **Verbindlichkeit** über MUSS, SOLL, KANN und DARF NICHT.
+- **Belegstatus:** Eine produktbezogene Aussage trägt `[DOK]`, `[EMPF]`, `[KONZ]` oder `BELEG OFFEN` mit Grund
+  und Datum.
+- **Platzhalter:** Variable Inhalte stehen nur als registrierte Platzhalter
+  ([`PLACEHOLDER_REGISTRY.md`](.koolie/core/docs/PLACEHOLDER_REGISTRY.md)). Beispiele sind als synthetisch
+  gekennzeichnet, und genannt werden Rollen, keine Personen.
+- **Skillnamen:** Mitgelieferte Skills heißen `koolie-<name>`, eindeutig über alle Packs; `prj-<name>` gehört
+  dem Projekt.
+- **Schreiben:** Die Produktdokumentation sagt, was gilt und was zu tun ist – ohne `CR-`, `D-` oder
+  `K-`-Kennung und ohne Entscheidungsgeschichte. Begründungen gehören in Änderungsantrag und Decision Log.
+  Die Regeln stehen im [Dokumentationsstandard](.koolie/core/docs/DOCUMENTATION_STANDARD.md), Abschnitt 3;
+  der Validator meldet eine Kennung am falschen Ort.
+- **Lizenz an zwei Stellen:** in der Wurzel und unter `.koolie/core/LICENSE`, weil ein Projekt nur den Kern
+  kopiert und ein Werk nicht ohne seine Lizenz weitergegeben werden darf. Der Validator hält beide gleich.

package/QUICKSTART.en.md

@@ -5,25 +5,24 @@ documentation is in German and marked (German).*
 
 This quickstart installs Koolie into an **empty practice repository** and shows what is created. It does not
 start an AI client and does not change any existing project. The client pack `claude-code` serves as the
-example; every other pack works the same way (step 3).
+example; the other packs work the same way.
 
-To adopt Koolie in an **existing** project, read the [adoption guide](.koolie/core/docs/ADOPTION_GUIDE.md)
-(German) afterwards. For the first working day in a project that already uses Koolie, start with the
+For an **existing** project, read the [adoption guide](.koolie/core/docs/ADOPTION_GUIDE.md) (German)
+afterwards. If you are new to a project that already uses Koolie, start with the
 [onboarding quick start](.koolie/core/onboarding/QUICKSTART.md) (German).
 
 ## Prerequisites
 
-- **Git** and **Python 3.8 or later** (no additional packages). If Python is called `python3` on your system,
-  use that instead of `python` in all commands below.
-- A command line with a POSIX shell – on Windows, for example, Git Bash. Step 2 can also be done with the
-  starters `install.cmd` (Windows) or `install.command` (macOS) in the root of the release archive; they ask
-  for the same information. The other steps need the command line.
-- Koolie itself: the **unpacked release archive** or a **clone** of this repository. Steps 1 to 4 run from its
-  root directory, steps 5 and 6 inside the practice repository.
-- **Or from a package source**, without archive or clone: `uvx koolie` (also `pipx run koolie`, `npx @renoxar/koolie`)
-  replaces `python .koolie/core/install.py` in steps 2 and 3, and steps 1 to 4 run from any directory; the
-  command shows the banner first. If you installed it with `pip install koolie` and `koolie` is not found, run
-  `python -m koolie`.
+- **Git** and **Python 3.8 or later**, no additional packages. If Python is called `python3` on your system,
+  use that instead of `python` in all commands.
+- A command line with a POSIX shell, on Windows for example Git Bash.
+- Koolie itself, in one of two ways:
+  - **from a package source:** `uvx koolie` (or `pipx run koolie`, `npx @renoxar/koolie`). It replaces
+    `python .koolie/core/install.py` in steps 2 and 3, and you can start from any directory. If you used
+    `pip install koolie` and `koolie` is not found, run `python -m koolie`.
+  - **from the unpacked release archive or a clone:** steps 1 to 4 then run from its root directory. Instead
+    of step 2 you can also use the starters `install.cmd` (Windows) and `install.command` (macOS); they ask
+    for the same information.
 
 All output of the installer and the validator is in German; this guide quotes the lines you need.
 
@@ -43,18 +42,15 @@ git -C ../koolie-uebung commit -m "Start"
 python .koolie/core/install.py --target ../koolie-uebung --client claude-code
 ```
 
-From a package source, the same step is `uvx koolie --target ../koolie-uebung --client claude-code`.
-Without arguments, `uvx koolie` started inside the practice repository opens the dialog with that directory as
-the default.
+From a package source: `uvx koolie --target ../koolie-uebung --client claude-code`. Without arguments,
+`uvx koolie` opens a dialog with the current directory as the default.
 
-`--target` copies only the core (`.koolie/core/`) into the practice repository and creates the files the
-client needs there. At the end, the installer lists the next steps for a real project. Its messages are in
-German.
+The installer copies the core (`.koolie/core/`) into the practice repository, creates the files the client
+needs and lists the next steps for a real project at the end.
 
-⚠️ On Windows, no copied path may exceed 259 characters. If the practice repository is nested too deeply, the
-installer stops before the first copy and states how many characters are too many. In that case, choose a
-shorter location and replace `../koolie-uebung` with it in all commands – in Git Bash, for example,
-`/c/koolie-uebung`.
+⚠️ On Windows, no path may exceed 259 characters. If the practice repository is nested too deeply, the
+installer stops before the first copy. Choose a shorter location, in Git Bash for example `/c/koolie-uebung`,
+and use it instead of `../koolie-uebung` in all commands.
 
 ## Step 3: Choose a different client (optional)
 
@@ -62,30 +58,30 @@ shorter location and replace `../koolie-uebung` with it in all commands – in G
 python .koolie/core/install.py --list-clients
 ```
 
-shows the available client packs. What each client enforces technically is recorded in its **capability
-matrix**; the [overview of the client packs](.koolie/core/clients/README.md) (German), section 6, summarises
-them. The file names in step 4 apply to `claude-code`; which files another pack creates is listed in the
-[runtime glossary](.koolie/core/docs/RUNTIME_GLOSSARY.md) (German). For this quickstart, `claude-code` is enough.
+shows the available client packs. What each client enforces technically is summarised in the
+[overview of the client packs](.koolie/core/clients/README.md) (German), section 6; which files a pack creates
+is listed in the [runtime glossary](.koolie/core/docs/RUNTIME_GLOSSARY.md) (German). For this quickstart,
+`claude-code` is enough.
 
 ## Step 4: Look at what was created
 
 | Path in the practice repository | What it is |
 |---|---|
-| `CLAUDE.md` | the **instruction file** the client loads at start – with the framework's rules, for example *"Never: `git push` …"* (in German) |
-| `.claude/settings.json` | the **permission file**: what the client blocks technically (`deny`), asks about (`ask`) or may do without asking (`allow`), plus the hooks |
-| `.claude/rules/`, `.claude/skills/`, `.claude/agents/` | short versions of the rules, the framework's skills and a read-only review profile |
+| `CLAUDE.md` | the **instruction file** the client loads at start – with Koolie's rules, for example *"Never: `git push` …"* (in German) |
+| `.claude/settings.json` | the **permission file**: what the client blocks (`deny`), asks about (`ask`) or may do without asking (`allow`), plus the hooks |
+| `.claude/rules/`, `.claude/skills/`, `.claude/agents/` | short versions of the rules, the skills (`/koolie-plan` and others) and a read-only review profile |
 | `.koolie/core/` | the **core** – identical in every project, never edit by hand |
 | `.koolie/project-overlay/` | the **project overlay** – the project configuration the team fills in |
 
-The blocked publication from the [README](README.en.md#what-is-enforced--and-what-is-not) – `git push` – is in
-`.claude/settings.json`:
+The block on `git push` from the [README](README.en.md#what-is-enforced--and-what-is-not) is in the
+permission file:
 
 ```bash
 grep -n "git push" ../koolie-uebung/.claude/settings.json
 ```
 
-The output shows `Bash(git push:*)` twice: in `permissions.deny`, where the client reads the block, and in
-`_core_rules_integrity.deny_must_contain`, the list of core rules the validator checks the file against.
+`Bash(git push:*)` appears twice: in `permissions.deny`, where the client reads the block, and in
+`_core_rules_integrity.deny_must_contain`, which the validator checks the file against.
 
 ## Step 5: Commit and check
 
@@ -98,8 +94,8 @@ python .koolie/core/tests/scripts/validate-framework.py
 ```
 
 **Expected:** `Ergebnis: 0 Fehler, 0 Warnungen` (result: 0 errors, 0 warnings). Among other things, the
-validator checks that the core rules of the permission file are complete. The `.gitignore` entry is needed
-because the core's tools create Python bytecode on every run; without it, the validator reports a warning.
+validator checks that the core rules of the permission file are complete. The `.gitignore` keeps the tools'
+Python bytecode out of the repository; without it you get a warning.
 
 ## Step 6: See what is missing for real use
 
@@ -107,29 +103,26 @@ because the core's tools create Python bytecode on every run; without it, the va
 python .koolie/core/tests/scripts/validate-framework.py --check-overlay-ready
 ```
 
-**Expected:** several lines containing `FEHLER` (error) and `enthält offene <TBD>-Werte` (contains open
-`<TBD>` values) for files under `.koolie/project-overlay/` and for the overlay rule in `.claude/rules/`. That is
-correct: the overlay has not been filled in yet. Until it has been filled in, reviewed and set to active, the
-agent works read-only in the project. Which
-values a project has to enter and who approves them is described in the
+**Expected:** several `FEHLER` (error) lines with `enthält offene <TBD>-Werte` (contains open `<TBD>` values)
+for files under `.koolie/project-overlay/` and for the overlay rule in `.claude/rules/`. That is correct: the
+overlay is still empty. Until it is filled in, reviewed and active, the agent works read-only in the project.
+Which values a project enters and who approves them is described in the
 [adoption guide](.koolie/core/docs/ADOPTION_GUIDE.md) (German).
 
 ## Step 7: Run the client against it (optional)
 
-If you have Claude Code installed, you can start a session in the practice repository and ask the assistant
-to push a commit. **Expected** (this is what was measured): the assistant declines; if it tries anyway, the
-client rejects the call. This has **not been re-checked** for this quickstart – it was measured on 2026-09-17
-with Claude Code 2.1.274 ([protocol](.koolie/core/tests/protocols/2026-09-17-sitzungstest-schranken.md),
-German). A model can behave differently – that is why the technical block exists, and why the capability
-matrix names its limit.
+With Claude Code installed, you can start a session in the practice repository and ask the assistant to push
+a commit. **Expected:** it declines; if it tries anyway, the client rejects the call. This was measured with
+Claude Code 2.1.274 ([protocol](.koolie/core/tests/protocols/2026-09-17-sitzungstest-schranken.md), German)
+and has not been re-checked for this quickstart. A model can behave differently – that is exactly what the
+technical block is for.
 
 ## Clean up
 
-The practice repository can be deleted afterwards – seen from the directory where you ran step 1, it is
-`../koolie-uebung`.
+The practice repository `../koolie-uebung` can be deleted afterwards.
 
 ## Next steps
 
-- [README](README.en.md): what Koolie is, who it is for, which clients are supported and how far.
+- [README](README.en.md): what Koolie is, who it is for and which clients it supports.
 - [Adoption guide](.koolie/core/docs/ADOPTION_GUIDE.md) (German): taking Koolie into an existing project, updates, costs, deployment architecture and coexistence with another agent framework.
 - [Overview of the client packs](.koolie/core/clients/README.md) (German): capability matrices and their evidence.

package/QUICKSTART.md

@@ -4,25 +4,24 @@
 
 Dieser Quickstart installiert Koolie in ein **leeres Übungs-Repository** und zeigt, was dabei entsteht. Er
 startet keinen KI-Client und verändert kein bestehendes Projekt. Als Beispiel dient das Client Pack
-`claude-code`; jedes andere Pack funktioniert genauso (Schritt 3).
+`claude-code`; die anderen Packs funktionieren genauso.
 
-Wer Koolie in ein **bestehendes** Projekt übernehmen will, liest danach den
-[Übernahmeleitfaden](.koolie/core/docs/ADOPTION_GUIDE.md). Wer in einem Projekt, das Koolie schon nutzt, den
-ersten Arbeitstag hat, beginnt mit dem [Quick-Start des Onboardings](.koolie/core/onboarding/QUICKSTART.md).
+Für ein **bestehendes** Projekt gilt danach der [Übernahmeleitfaden](.koolie/core/docs/ADOPTION_GUIDE.md).
+Wer in einem Projekt neu ist, das Koolie schon nutzt, beginnt mit dem
+[Quick-Start des Onboardings](.koolie/core/onboarding/QUICKSTART.md).
 
 ## Voraussetzungen
 
-- **Git** und **Python ab 3.8** (ohne Zusatzpakete). Heißt der Aufruf auf dem System `python3`, gilt er in allen
-  Befehlen unten statt `python`.
-- Eine Kommandozeile mit POSIX-Shell – unter Windows zum Beispiel Git Bash. Schritt 2 lässt sich auch mit den
-  Startern `install.cmd` (Windows) oder `install.command` (macOS) in der Wurzel des Release-Archivs erledigen;
-  sie fragen dieselben Angaben ab. Die übrigen Schritte brauchen die Kommandozeile.
-- Koolie selbst: das **entpackte Release-Archiv** oder ein **Klon** dieses Repositorys. Die Schritte 1 bis 4
-  laufen aus dessen Wurzelverzeichnis, ab Schritt 5 im Übungs-Repository.
-- **Oder über eine Paketquelle**, ohne Archiv und ohne Klon: `uvx koolie` (auch `pipx run koolie`,
-  `npx @renoxar/koolie`) ersetzt in den Schritten 2 und 3 den Aufruf `python .koolie/core/install.py`, und die
-  Schritte 1 bis 4 laufen aus einem beliebigen Verzeichnis; der Befehl gibt vorher das Banner aus. Wer ihn mit
-  `pip install koolie` installiert und `koolie` danach nicht findet, ruft `python -m koolie` auf.
+- **Git** und **Python ab 3.8**, ohne Zusatzpakete. Heißt der Aufruf auf deinem System `python3`, nimm ihn
+  in allen Befehlen statt `python`.
+- Eine Kommandozeile mit POSIX-Shell, unter Windows zum Beispiel Git Bash.
+- Koolie selbst, auf einem von zwei Wegen:
+  - **über eine Paketquelle:** `uvx koolie` (oder `pipx run koolie`, `npx @renoxar/koolie`). Es ersetzt in
+    den Schritten 2 und 3 den Aufruf `python .koolie/core/install.py`, und du kannst aus jedem Verzeichnis
+    starten. Wer `pip install koolie` nutzt und `koolie` danach nicht findet, ruft `python -m koolie` auf.
+  - **aus dem entpackten Release-Archiv oder einem Klon:** Die Schritte 1 bis 4 laufen dann aus dessen
+    Wurzelverzeichnis. Statt Schritt 2 gehen auch die Starter `install.cmd` (Windows) und `install.command`
+    (macOS); sie fragen dieselben Angaben ab.
 
 ## Schritt 1: Ein Übungs-Repository anlegen
 
@@ -40,15 +39,15 @@ git -C ../koolie-uebung commit -m "Start"
 python .koolie/core/install.py --target ../koolie-uebung --client claude-code
 ```
 
-Über eine Paketquelle lautet derselbe Schritt `uvx koolie --target ../koolie-uebung --client claude-code`.
-Ohne Argumente startet `uvx koolie` im Übungs-Repository den Dialog, mit diesem Verzeichnis als Vorgabe.
+Über eine Paketquelle: `uvx koolie --target ../koolie-uebung --client claude-code`. Ohne Argumente startet
+`uvx koolie` einen Dialog mit dem aktuellen Verzeichnis als Vorgabe.
 
-`--target` kopiert nur den Kern (`.koolie/core/`) in das Übungs-Repository und legt dort die Dateien an, die
-der Client braucht. Am Ende nennt der Installer die nächsten Schritte für ein echtes Projekt.
+Der Installer kopiert den Kern (`.koolie/core/`) ins Übungs-Repository, legt die Dateien an, die der Client
+braucht, und nennt am Ende die nächsten Schritte für ein echtes Projekt.
 
-⚠️ Unter Windows darf kein kopierter Pfad länger als 259 Zeichen werden. Liegt das Übungs-Repository zu tief,
-hält der Installer vor der ersten Kopie an und nennt, wie viele Zeichen zu viel sind – dann einen kürzeren Ort
-wählen und `../koolie-uebung` in allen Befehlen durch ihn ersetzen, in Git Bash zum Beispiel `/c/koolie-uebung`.
+⚠️ Unter Windows darf kein Pfad länger als 259 Zeichen werden. Liegt das Übungs-Repository zu tief, hält der
+Installer vor der ersten Kopie an. Dann einen kürzeren Ort wählen, in Git Bash etwa `/c/koolie-uebung`, und
+ihn in allen Befehlen statt `../koolie-uebung` einsetzen.
 
 ## Schritt 3: Einen anderen Client wählen (optional)
 
@@ -56,30 +55,29 @@ wählen und `../koolie-uebung` in allen Befehlen durch ihn ersetzen, in Git Bash
 python .koolie/core/install.py --list-clients
 ```
 
-zeigt die verfügbaren Client Packs. Welcher Client was technisch durchsetzt, steht in der
-[Übersicht der Client Packs](.koolie/core/clients/README.md), Abschnitt 6. Die Dateinamen in Schritt 4 gelten
-für `claude-code`; welche Dateien ein anderes Pack anlegt, nennt das
+zeigt die verfügbaren Client Packs. Was jeder Client technisch durchsetzt, steht in der
+[Übersicht der Client Packs](.koolie/core/clients/README.md), Abschnitt 6; welche Dateien ein Pack anlegt, im
 [Laufzeitglossar](.koolie/core/docs/RUNTIME_GLOSSARY.md). Für diesen Quickstart genügt `claude-code`.
 
 ## Schritt 4: Ansehen, was entstanden ist
 
 | Pfad im Übungs-Repository | Was es ist |
 |---|---|
-| `CLAUDE.md` | die **Anweisungsdatei**, die der Client beim Start lädt – mit den Regeln des Frameworks, zum Beispiel *„Nie: `git push` …“* |
-| `.claude/settings.json` | die **Berechtigungsdatei**: Was der Client technisch verweigert (`deny`), erfragt (`ask`) oder ohne Rückfrage darf (`allow`), dazu die Hooks |
-| `.claude/rules/`, `.claude/skills/`, `.claude/agents/` | Kurzfassungen der Regeln, die Skills des Frameworks und ein nur lesendes Review-Profil |
+| `CLAUDE.md` | die **Anweisungsdatei**, die der Client beim Start lädt – mit den Regeln von Koolie, zum Beispiel *„Nie: `git push` …“* |
+| `.claude/settings.json` | die **Berechtigungsdatei**: was der Client verweigert (`deny`), erfragt (`ask`) oder ohne Rückfrage darf (`allow`), dazu die Hooks |
+| `.claude/rules/`, `.claude/skills/`, `.claude/agents/` | Kurzfassungen der Regeln, die Skills (`/koolie-plan` und andere) und ein nur lesendes Review-Profil |
 | `.koolie/core/` | der **Kern** – in jedem Projekt gleich, nie von Hand ändern |
 | `.koolie/project-overlay/` | das **Project Overlay** – die Projektkonfiguration, die das Team ausfüllt |
 
-Die gesperrte Veröffentlichung aus der [README](README.md#was-durchgesetzt-wird--und-was-nicht) – `git push` – steht in
-`.claude/settings.json`:
+Die Sperre für `git push` aus der [README](README.md#was-durchgesetzt-wird--und-was-nicht) steht in der
+Berechtigungsdatei:
 
 ```bash
 grep -n "git push" ../koolie-uebung/.claude/settings.json
 ```
 
-Die Ausgabe nennt `Bash(git push:*)` zweimal: in `permissions.deny`, wo der Client die Sperre liest, und in
-`_core_rules_integrity.deny_must_contain`, der Liste der Kernregeln, gegen die der Validator die Datei prüft.
+`Bash(git push:*)` erscheint zweimal: in `permissions.deny`, wo der Client die Sperre liest, und in
+`_core_rules_integrity.deny_must_contain`, wogegen der Validator die Datei prüft.
 
 ## Schritt 5: Den Stand festhalten und prüfen
 
@@ -91,9 +89,9 @@ cd ../koolie-uebung
 python .koolie/core/tests/scripts/validate-framework.py
 ```
 
-**Erwartet:** `Ergebnis: 0 Fehler, 0 Warnungen`. Der Validator prüft unter anderem, dass die Kernregeln der
-Berechtigungsdatei vollständig sind. Die `.gitignore` gehört dazu, weil die Werkzeuge des Kerns bei jedem Lauf
-Python-Bytecode erzeugen; ohne sie meldet der Validator eine Warnung.
+**Erwartet:** `Ergebnis: 0 Fehler, 0 Warnungen`. Der Validator prüft unter anderem, ob die Kernregeln der
+Berechtigungsdatei vollständig sind. Die `.gitignore` hält den Python-Bytecode der Werkzeuge aus dem
+Repository; ohne sie gibt es eine Warnung.
 
 ## Schritt 6: Sehen, was für den echten Einsatz fehlt
 
@@ -101,29 +99,25 @@ Python-Bytecode erzeugen; ohne sie meldet der Validator eine Warnung.
 python .koolie/core/tests/scripts/validate-framework.py --check-overlay-ready
 ```
 
-**Erwartet:** mehrere Zeilen mit `FEHLER` und `enthält offene <TBD>-Werte` zu Dateien unter
-`.koolie/project-overlay/` und zur Overlay-Regel in `.claude/rules/`. Das ist richtig so: Das Overlay ist noch
-nicht ausgefüllt. Solange es nicht ausgefüllt, geprüft und auf aktiv gesetzt ist, arbeitet der Agent im
-Projekt nur lesend. Welche Werte
-ein Projekt eintragen muss und wer sie freigibt, beschreibt der
-[Übernahmeleitfaden](.koolie/core/docs/ADOPTION_GUIDE.md).
+**Erwartet:** mehrere `FEHLER` mit `enthält offene <TBD>-Werte` zu Dateien unter `.koolie/project-overlay/`
+und zur Overlay-Regel in `.claude/rules/`. Das ist richtig so: Das Overlay ist noch leer. Bis es ausgefüllt,
+geprüft und aktiv ist, arbeitet der Agent im Projekt nur lesend. Welche Werte ein Projekt einträgt und wer sie
+freigibt, beschreibt der [Übernahmeleitfaden](.koolie/core/docs/ADOPTION_GUIDE.md).
 
 ## Schritt 7: Den Client dagegen laufen lassen (optional)
 
-Wer Claude Code installiert hat, kann im Übungs-Repository eine Sitzung starten und den Assistenten bitten,
-einen Commit zu pushen. **Erwartet**, weil so gemessen: Der Assistent lehnt ab; versucht er es trotzdem,
-weist der Client den Aufruf zurück. Für diesen Quickstart ist das **nicht erneut geprüft** worden – gemessen
-wurde es am 2026-09-17 mit Claude Code 2.1.274
-([Protokoll](.koolie/core/tests/protocols/2026-09-17-sitzungstest-schranken.md)). Ein Modell kann sich
-anders verhalten – deshalb gibt es die technische Sperre, und deshalb nennt die Fähigkeitsmatrix ihre Grenze.
+Mit installiertem Claude Code kannst du im Übungs-Repository eine Sitzung starten und den Assistenten bitten,
+einen Commit zu pushen. **Erwartet:** Er lehnt ab; versucht er es trotzdem, weist der Client den Aufruf
+zurück. So wurde es mit Claude Code 2.1.274 gemessen
+([Protokoll](.koolie/core/tests/protocols/2026-09-17-sitzungstest-schranken.md)); für diesen Quickstart ist es
+nicht erneut geprüft. Ein Modell kann sich anders verhalten – genau dafür gibt es die technische Sperre.
 
 ## Aufräumen
 
-Das Übungs-Repository kann danach gelöscht werden – aus dem Verzeichnis, in dem Schritt 1 lief, ist es
-`../koolie-uebung`.
+Das Übungs-Repository `../koolie-uebung` kann danach gelöscht werden.
 
 ## Wie es weitergeht
 
-- [README](README.md): was Koolie ist, für wen es gedacht ist, welche Clients in welchem Stand unterstützt werden.
+- [README](README.md): was Koolie ist, für wen es gedacht ist und welche Clients es unterstützt.
 - [Übernahmeleitfaden](.koolie/core/docs/ADOPTION_GUIDE.md): Aufnahme in ein bestehendes Projekt, Aktualisierung, Kosten, Einsatzarchitektur und das Nebeneinander mit einem anderen Agenten-Rahmenwerk.
 - [Übersicht der Client Packs](.koolie/core/clients/README.md): Fähigkeitsmatrizen und ihre Belege.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@renoxar/koolie",
-  "version": "1.25.0",
+  "version": "2.0.0",
   "description": "Rules, skills and a protective hook for AI coding assistants - one rule source, installed per project.",
   "license": "GPL-3.0-only",
   "homepage": "https://github.com/Renoxar/koolie",
@@ -14,7 +14,7 @@
   "engines": {
     "node": ">=16"
   },
-  "readme": "# Koolie\n\n**Governance for AI coding assistants \u2013 one rule source for every client, enforced technically wherever the client allows it.**\n\n[![PyPI](https://img.shields.io/pypi/v/koolie)](https://pypi.org/project/koolie/)\n[![npm](https://img.shields.io/npm/v/@renoxar/koolie)](https://www.npmjs.com/package/@renoxar/koolie)\n[![License: GPL-3.0](https://img.shields.io/badge/license-GPL--3.0-blue)](https://github.com/Renoxar/koolie/blob/v1.25.0/LICENSE)\n\n*Deutsch: [README.md](https://github.com/Renoxar/koolie/blob/v1.25.0/README.md). The German documentation is authoritative; further documents are in German.*\n\nA team working with AI coding assistants needs more than an instruction file: shared rules for every\nassistant, technical blocks wherever a rule must not be broken, and clear points where a human decides.\nKoolie brings exactly that into an existing Git repository \u2013 and states openly, for each client, which rule\nit really enforces and which only acts as an instruction.\n\n## Quick start\n\nIn your project directory:\n\n```bash\nuvx koolie                  # or: pipx run koolie \u00b7 npx @renoxar/koolie\n```\n\nThe command fetches Koolie, offers the current directory as the project and asks for your AI client.\nAfterwards the project holds the instruction file, the permissions and a guard hook for that client. Without\na package registry, use the release archive and the starters `install.cmd` / `install.command`.\n\n**Want to try it first?** The [quickstart](https://github.com/Renoxar/koolie/blob/v1.25.0/QUICKSTART.en.md) installs Koolie into an empty practice repository\n\u2013 in ten minutes, without starting an AI client.\n\n## How it works\n\n```text\n  Core  .koolie/core/            Project overlay  .koolie/project-overlay/\n  rules, skills, checklists,     paths, approval routes, project documents\n  guard hook, validator          \u2013 owned by the project\n            \u2502                               \u2502\n            \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n                            \u25bc\n                Client pack per AI client\n       instruction file \u00b7 permissions \u00b7 hooks \u00b7 skills\n       (e.g. CLAUDE.md and .claude/ for Claude Code)\n```\n\n- **One core for all clients.** Rules and skills are written once, tool-neutral; a team with mixed tools shares\n  the same rules.\n- **The project stays in charge.** Project values live in the overlay. A new release updates a project with the\n  same command: it detects the existing core and offers to upgrade it; the overlay is never touched.\n- **Control levels instead of trust.** The assistant handles small tasks on its own; from \"medium\" it needs a\n  confirmed plan, at \"high\" an explicit approval.\n\n## What is enforced \u2013 and what is not\n\n| Kind of rule | What it means | Example |\n|---|---|---|\n| **Technical** | The client enforces it, whatever the model does | `git push` is blocked; secret files cannot be read |\n| **Instruction** | The rule is in the model's context; it can follow it | \"Do not change files outside the approved scope\" |\n| **Human** | Approvals, reviews, decisions | A person approves a release |\n\nEach client pack keeps a **capability matrix** that assigns every promise to one of these kinds \u2013 backed by a\nmeasurement on the client. Koolie complements a good standard setup (branch protection, CI, managed settings);\nit does not replace it.\n\n## Supported clients\n\n| Client | Pack | Status |\n|---|---|---|\n| Claude Code | [`claude-code`](https://github.com/Renoxar/koolie/blob/v1.25.0/.koolie/core/clients/claude-code/CLIENT_PACK.md) | pilot |\n| Cursor | [`cursor`](https://github.com/Renoxar/koolie/blob/v1.25.0/.koolie/core/clients/cursor/CLIENT_PACK.md) | pilot |\n| Devin Desktop | [`devin-desktop`](https://github.com/Renoxar/koolie/blob/v1.25.0/.koolie/core/clients/devin-desktop/CLIENT_PACK.md) | pilot |\n| Kiro | [`kiro`](https://github.com/Renoxar/koolie/blob/v1.25.0/.koolie/core/clients/kiro/CLIENT_PACK.md) | pilot |\n| OpenAI Codex CLI | [`openai-codex`](https://github.com/Renoxar/koolie/blob/v1.25.0/.koolie/core/clients/openai-codex/CLIENT_PACK.md) | pilot, only with approval by the security officer |\n\n*Pilot* means: fully built, measured on real installations, meant for accompanied use. The limits of each\nclient are listed in its pack (German).\n\n## Who is it for?\n\n- **Development teams** that use AI assistants every day and want shared, verifiable rules.\n- **Technical leads** \u2013 team leads, architecture, security, data protection \u2013 who must show what a tool\n  enforces technically.\n\nKoolie is not meant for running an agent fully autonomously without human approvals.\n\n## Documentation\n\n| Topic | Where |\n|---|---|\n| Try it in ten minutes | [`QUICKSTART.en.md`](https://github.com/Renoxar/koolie/blob/v1.25.0/QUICKSTART.en.md) |\n| Adopt in a project, update, costs | [Adoption guide](https://github.com/Renoxar/koolie/blob/v1.25.0/.koolie/core/docs/ADOPTION_GUIDE.md) (German) |\n| First day in a project that uses Koolie | [Onboarding](https://github.com/Renoxar/koolie/blob/v1.25.0/.koolie/core/onboarding/QUICKSTART.md) (German) |\n| Client packs and capability matrices | [`clients/README.md`](https://github.com/Renoxar/koolie/blob/v1.25.0/.koolie/core/clients/README.md) (German) |\n| The rules themselves | [`framework/core/`](https://github.com/Renoxar/koolie/blob/v1.25.0/.koolie/core/framework/core/) (German) |\n| Changes and plans | [`CHANGELOG.md`](https://github.com/Renoxar/koolie/blob/v1.25.0/.koolie/core/CHANGELOG.md) \u00b7 [`ROADMAP.md`](https://github.com/Renoxar/koolie/blob/v1.25.0/.koolie/core/docs/ROADMAP.md) (German) |\n| Contributing to the framework | [`CONTRIBUTING.md`](https://github.com/Renoxar/koolie/blob/v1.25.0/CONTRIBUTING.md) (German) |\n\n## Why \"Koolie\"?\n\nA Koolie is an Australian herding dog. It does not drive the herd and does not replace the shepherd \u2013 it keeps\nthe flock together, on course and within bounds. That is what this framework is meant to do with an AI\nassistant.\n\n## License\n\n[GPL-3.0](https://github.com/Renoxar/koolie/blob/v1.25.0/LICENSE) with an additional permission: files created from the templates and any output of the tools\nbelong to the project that creates them. Merely using Koolie \u2013 also commercially \u2013 puts no obligations on you;\nthe details are in [`LICENSE-HINWEIS.md`](https://github.com/Renoxar/koolie/blob/v1.25.0/.koolie/core/LICENSE-HINWEIS.md) (German).\nCopyright \u00a9 2026 `<FRAMEWORK_OWNER>`.\n",
+  "readme": "# Koolie\n\n**Governance for AI coding assistants \u2013 one rule source for every client, enforced technically wherever the client allows it.**\n\n[![PyPI](https://img.shields.io/pypi/v/koolie)](https://pypi.org/project/koolie/)\n[![npm](https://img.shields.io/npm/v/@renoxar/koolie)](https://www.npmjs.com/package/@renoxar/koolie)\n[![License: GPL-3.0](https://img.shields.io/badge/license-GPL--3.0-blue)](https://github.com/Renoxar/koolie/blob/v2.0.0/LICENSE)\n\n*Deutsch: [README.md](https://github.com/Renoxar/koolie/blob/v2.0.0/README.md). The German documentation is authoritative; further documents are in German.*\n\nA team working with AI coding assistants needs more than an instruction file: shared rules for every\nassistant, technical blocks wherever a rule must not be broken, and clear points where a human decides.\nKoolie brings exactly that into an existing Git repository \u2013 and states openly, for each client, which rule\nit really enforces and which only acts as an instruction.\n\n## Quick start\n\nIn your project directory:\n\n```bash\nuvx koolie                  # or: pipx run koolie \u00b7 npx @renoxar/koolie\n```\n\nThe command fetches Koolie, offers the current directory as the project and asks for your AI client.\nAfterwards the project holds the instruction file, the permissions and a guard hook for that client. Without\na package registry, use the release archive and the starters `install.cmd` / `install.command`.\n\n**Want to try it first?** The [quickstart](https://github.com/Renoxar/koolie/blob/v2.0.0/QUICKSTART.en.md) installs Koolie into an empty practice repository\n\u2013 in ten minutes, without starting an AI client.\n\n## How it works\n\n```text\n  Core  .koolie/core/            Project overlay  .koolie/project-overlay/\n  rules, skills, checklists,     paths, approval routes, project documents\n  guard hook, validator          \u2013 owned by the project\n            \u2502                               \u2502\n            \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n                            \u25bc\n                Client pack per AI client\n       instruction file \u00b7 permissions \u00b7 hooks \u00b7 skills\n       (e.g. CLAUDE.md and .claude/ for Claude Code)\n```\n\n- **One core for all clients.** Rules and skills are written once, tool-neutral; a team with mixed tools shares\n  the same rules.\n- **The project stays in charge.** Project values live in the overlay. A new release updates a project with the\n  same command: it detects the existing core and offers to upgrade it; the overlay is never touched.\n- **Control levels instead of trust.** The assistant handles small tasks on its own; from \"medium\" it needs a\n  confirmed plan, at \"high\" an explicit approval.\n\n## What is enforced \u2013 and what is not\n\n| Kind of rule | What it means | Example |\n|---|---|---|\n| **Technical** | The client enforces it, whatever the model does | `git push` is blocked; secret files cannot be read |\n| **Instruction** | The rule is in the model's context; it can follow it | \"Do not change files outside the approved scope\" |\n| **Human** | Approvals, reviews, decisions | A person approves a release |\n\nEach client pack keeps a **capability matrix** that assigns every promise to one of these kinds \u2013 backed by a\nmeasurement on the client. Koolie complements a good standard setup (branch protection, CI, managed settings);\nit does not replace it.\n\n## Supported clients\n\n| Client | Pack | Status |\n|---|---|---|\n| Claude Code | [`claude-code`](https://github.com/Renoxar/koolie/blob/v2.0.0/.koolie/core/clients/claude-code/CLIENT_PACK.md) | pilot |\n| Cursor | [`cursor`](https://github.com/Renoxar/koolie/blob/v2.0.0/.koolie/core/clients/cursor/CLIENT_PACK.md) | pilot |\n| Devin Desktop | [`devin-desktop`](https://github.com/Renoxar/koolie/blob/v2.0.0/.koolie/core/clients/devin-desktop/CLIENT_PACK.md) | pilot |\n| Kiro | [`kiro`](https://github.com/Renoxar/koolie/blob/v2.0.0/.koolie/core/clients/kiro/CLIENT_PACK.md) | pilot |\n| OpenAI Codex CLI | [`openai-codex`](https://github.com/Renoxar/koolie/blob/v2.0.0/.koolie/core/clients/openai-codex/CLIENT_PACK.md) | pilot, only with approval by the security officer |\n\n*Pilot* means: fully built, measured on real installations, meant for accompanied use. The limits of each\nclient are listed in its pack (German).\n\n## Who is it for?\n\n- **Development teams** that use AI assistants every day and want shared, verifiable rules.\n- **Technical leads** \u2013 team leads, architecture, security, data protection \u2013 who must show what a tool\n  enforces technically.\n\nKoolie is not meant for running an agent fully autonomously without human approvals.\n\n## Documentation\n\n| Topic | Where |\n|---|---|\n| Try it in ten minutes | [`QUICKSTART.en.md`](https://github.com/Renoxar/koolie/blob/v2.0.0/QUICKSTART.en.md) |\n| Adopt in a project, update, costs | [Adoption guide](https://github.com/Renoxar/koolie/blob/v2.0.0/.koolie/core/docs/ADOPTION_GUIDE.md) (German) |\n| First day in a project that uses Koolie | [Onboarding](https://github.com/Renoxar/koolie/blob/v2.0.0/.koolie/core/onboarding/QUICKSTART.md) (German) |\n| Client packs and capability matrices | [`clients/README.md`](https://github.com/Renoxar/koolie/blob/v2.0.0/.koolie/core/clients/README.md) (German) |\n| The rules themselves | [`framework/core/`](https://github.com/Renoxar/koolie/blob/v2.0.0/.koolie/core/framework/core/) (German) |\n| Changes and plans | [`CHANGELOG.md`](https://github.com/Renoxar/koolie/blob/v2.0.0/.koolie/core/CHANGELOG.md) \u00b7 [`ROADMAP.md`](https://github.com/Renoxar/koolie/blob/v2.0.0/.koolie/core/docs/ROADMAP.md) (German) |\n| Contributing to the framework | [`CONTRIBUTING.md`](https://github.com/Renoxar/koolie/blob/v2.0.0/CONTRIBUTING.md) (German) |\n\n## Why \"Koolie\"?\n\nA Koolie is an Australian herding dog. It does not drive the herd and does not replace the shepherd \u2013 it keeps\nthe flock together, on course and within bounds. That is what this framework is meant to do with an AI\nassistant.\n\n## License\n\n[GPL-3.0](https://github.com/Renoxar/koolie/blob/v2.0.0/LICENSE) with an additional permission: files created from the templates and any output of the tools\nbelong to the project that creates them. Merely using Koolie \u2013 also commercially \u2013 puts no obligations on you;\nthe details are in [`LICENSE-HINWEIS.md`](https://github.com/Renoxar/koolie/blob/v2.0.0/.koolie/core/LICENSE-HINWEIS.md) (German).\nCopyright \u00a9 2026 `<FRAMEWORK_OWNER>`.\n",
   "publishConfig": {
     "access": "public"
   }

package/paketquellen/README.md

@@ -1,10 +1,10 @@
 # Paketquellen
 
-Dieser Ordner baut Koolie für Paketquellen (`CR-2026-168`, D-518 bis D-521). **Veröffentlicht wird auf PyPI und npm** – seit `1.24.0`, als Schritt 9 von `RELEASE_PROCESS.md` 4.2 mit der Signatur der Marke als Freigabe (D-530). Scoop und Homebrew sind gebaut, nicht veröffentlicht (`K-209`).
+Dieser Ordner baut Koolie für Paketquellen. Veröffentlicht wird auf **PyPI** (`koolie`) und **npm** (`@renoxar/koolie`); das übernimmt der Workflow `.github/workflows/publish.yml` an der signierten Marke, nach Freigabe durch den Owner (`RELEASE_PROCESS.md` Abschnitt 4.2, Schritt 9). Scoop und Homebrew werden gebaut, aber nicht veröffentlicht.
 
 | Datei | Zweck |
 |---|---|
-| `koolie_befehl.py` | Der Befehl `koolie`: ohne Argumente der Installationsdialog mit dem aktuellen Verzeichnis als Vorgabe (D-532), mit Argumenten `install.py`, davor das Banner (D-519); `koolie --version` |
+| `koolie_befehl.py` | Der Befehl `koolie`: ohne Argumente der Installationsdialog mit dem aktuellen Verzeichnis als Vorgabe, mit Argumenten `install.py`, davor das Banner; `koolie --version` |
 | `koolie.cmd` | Hülle für Windows aus dem entpackten Release-Archiv (Scoop) |
 | `npm/koolie.js` | Hülle für npm: sucht Python ab 3.8 und erbt das Terminal |
 | `bauen.py` | Baut aus dem Release-Archiv Wheel, npm-Paket, Scoop-Manifest und Homebrew-Formel und prüft sie nach |
@@ -15,27 +15,27 @@ Dieser Ordner baut Koolie für Paketquellen (`CR-2026-168`, D-518 bis D-521). **
 python paketquellen/bauen.py --archiv <koolie-X.Y.Z.tar.gz> --aus <ablage>
 ```
 
-Das Archiv ist das aus `RELEASE_PROCESS.md` 4.1, Schritt 5. Die Download-Adresse der Manifeste ist das GitHub-Release der Marke; `--url-basis` setzt eine andere, etwa für eine Messung mit einem lokalen Server.
+Das Archiv entsteht nach `RELEASE_PROCESS.md` Abschnitt 4.1, Schritt 5. Die Manifeste laden vom GitHub-Release der Marke; `--url-basis` setzt eine andere Adresse, etwa einen lokalen Server.
 
-`--vorab N` baut eine Vorabversion für TestPyPI (`<V>.devN`, npm `<V>-dev.N`), vor der Signatur aus dem Arbeitsbaum (D-529):
+Eine Vorabversion für TestPyPI (`<V>.devN`, npm `<V>-dev.N`) entsteht vor der Signatur aus dem Arbeitsbaum:
 
 ```
 git -c core.eol=lf -c core.autocrlf=input archive --format=tar.gz --prefix=koolie-<V>/ -o <ablage>/koolie-<V>.tar.gz $(git stash create)
 python paketquellen/bauen.py --archiv <ablage>/koolie-<V>.tar.gz --aus <ablage> --vorab 1
 ```
 
-Die Beschreibung auf PyPI und npm ist `README.en.md` mit absoluten Links auf die Marke im GitHub-Spiegel; npm bekommt sie über das Feld `readme` der `package.json`, die Dateien im Paket bleiben die des Archivs (D-528).
+Als Beschreibung auf PyPI und npm dient `README.en.md`, mit absoluten Links auf die Marke im GitHub-Spiegel. npm bekommt sie über das Feld `readme` der `package.json`; die Dateien im Paket sind die des Archivs.
 
 ## Warum das Banner im Befehl steht
 
-Gemessen am 2026-09-30 (Protokoll `.koolie/core/tests/protocols/2026-09-30-paketquellen.md`): pip führt beim Installieren nichts aus, npm verschluckt die Ausgabe eines Installationsskripts, Chocolatey gibt ihm kein Terminal. Der Befehl `koolie` läuft dagegen immer im Terminal des Nutzers – und erst er bringt Koolie ins Projekt.
+Beim Installieren aus einer Paketquelle gibt es kein verlässliches Terminal: pip führt nichts aus, npm verschluckt die Ausgabe, Chocolatey gibt kein Terminal. Der Befehl `koolie` läuft dagegen immer im Terminal des Nutzers – und erst er bringt Koolie ins Projekt.
 
 ## Stand je Paketquelle
 
 | Paketquelle | Stand |
 |---|---|
-| PyPI (pip, pipx, uv) | **veröffentlicht** seit `1.24.1` als `koolie` (TestPyPI zuerst, D-529; `1.24.0` nur auf TestPyPI, D-534) |
-| npm | als `@renoxar/koolie` (D-535) – der Name `koolie` ist auf npm gesperrt; erste Veröffentlichung mit `1.25.0` |
-| Scoop | gebaut, lokal gemessen (`7zip` wird mitinstalliert, `K-206`), nicht veröffentlicht (`K-209`) |
-| Homebrew | gebaut, nicht gemessen (`K-205`), nicht veröffentlicht (`K-209`) |
-| Chocolatey, winget | ohne Ziel (`K-204`) |
+| PyPI (pip, pipx, uv) | veröffentlicht als `koolie` |
+| npm | veröffentlicht als `@renoxar/koolie` – der Name `koolie` ist auf npm gesperrt |
+| Scoop | gebaut, lokal geprüft (`7zip` wird mitinstalliert), nicht veröffentlicht |
+| Homebrew | gebaut, nicht geprüft, nicht veröffentlicht |
+| Chocolatey, winget | nicht geplant |