stack: TOC-Scope auf types/ und docs/, Sprachregeln nach AGENTS.md zentralisiert, alle Templates auf Control-Plane-Sprache, --breaking akkumuliert (schliesst #99)

Files changed:
- AGENTS.md
- CHANGES.md
- ENVIRONMENT.md.template
- SOUL.md
- SOUL.md.template
- USER.md.template
- VERSION
- docs/ownership-and-templates.md
- docs/version-model.md
- instructions/CONTRACT.md
- instructions/dev/doc-pull-through.md
- instructions/dev/stack-close/SKILL.md
- instructions/dev/stack-dev/SKILL.md
- instructions/dev/version-parts.md
- instructions/setup-instance.md
- kb/CONVENTIONS.md
- kb/CONVENTIONS.md.template
- kb/concepts/COLLECTION.md
- kb/sources/COLLECTION.md
- tools/CONTRACT.md
- tools/chemenu/commands/types_cmd.py
- tools/chemenu/commands/version_cmd.py
- tools/chemenu/tests/test_toc.py
- tools/chemenu/tests/test_version_cmd.py
- tools/chemenu/toc.py
- tools/chemenu/version.py
- types/comparison.md
- types/concept.md
- types/entity.md
- types/lint-report.md
- types/source.md

types/comparison.md

@@ -1,7 +1,7 @@
 ---
 type: types/type-spec.md
 name: comparison
-description: Strukturierter Typ für Vergleichsseiten, die mehrere Entities oder Ansätze gegenüberstellen
+description: Structured type for comparison pages that set several entities or approaches against one another
 schema: types/comparison.schema.yaml
 base_dir: comparisons
 page_ref_fields: [entities, related]
@@ -9,42 +9,46 @@ page_ref_fields: [entities, related]
 
 # Comparison
 
-`comparison` ist der Typ für Seiten, die mehrere Entities, Werkzeuge, Technologien oder Ansätze systematisch anhand festgelegter Kriterien gegenüberstellen. Vergleichsseiten stützen Entscheidungen und machen Zielkonflikte zwischen Alternativen sichtbar.
+`comparison` is the type for pages that set several entities, tools, technologies or approaches systematically against one another along fixed criteria. Comparison pages support decisions and make the trade-offs between alternatives visible.
 
-## Wann zu verwenden
+## When to use
 
-- Vergleich mehrerer Technologien oder Frameworks für einen konkreten Einsatzzweck
-- Analyse der Vor- und Nachteile verschiedener Werkzeuge oder Bibliotheken
-- Bewertung alternativer Lösungswege für ein Problem
-- Dokumentation eines Entscheidungsprozesses mit mehreren geprüften Optionen
+- Comparing several technologies or frameworks for a concrete purpose
+- Analysing the advantages and disadvantages of different tools or libraries
+- Evaluating alternative ways of solving a problem
+- Documenting a decision process with several options examined
 
-## Wann NICHT zu verwenden
+## When NOT to use
 
-- Für die Dokumentation einer einzelnen Entity oder eines Concepts (dann `entity` bzw. `concept`)
-- Für Zusammenfassungen von Quellmaterial (dann `source`)
-- Für Seiten, die einen einzelnen Gegenstand behandeln statt mehrere zu vergleichen
+- For documenting a single entity or concept (use `entity` or `concept` respectively)
+- For summaries of source material (use `source`)
+- For pages covering a single subject rather than comparing several
 
 ## Frontmatter
 
-| Feld | Pflicht | Verwendung |
+| Field | Required | Use |
 |---|---:|---|
-| `type` | Ja | `types/comparison.md` |
-| `tags` | Nein | Navigations-Tags zur Kategorisierung |
-| `created` | Ja | Erstellungsdatum (YYYY-MM-DD) |
-| `entities` | Ja | Titel der verglichenen Entities |
-| `related` | Nein | Deklarierte ausgehende Kanten - je Subjekt eine `compares-with`-Kante, geschrieben von `wikitool xref add` |
-| `summary` | Ja | Einzeiler für `kb/index.md` |
+| `type` | Yes | `types/comparison.md` |
+| `tags` | No | Navigation tags for categorization |
+| `created` | Yes | Creation date (YYYY-MM-DD) |
+| `entities` | Yes | Titles of the entities compared |
+| `related` | No | Declared outbound edges - one `compares-with` edge per subject, written by `wikitool xref add` |
+| `summary` | Yes | One-liner for `kb/index.md` |
 
-## Autorenanweisungen
+## Authoring guidance
 
-- Ein Titel, der den Vergleich benennt (z. B. "Go vs Rust", "Kubernetes vs Docker Swarm"); er folgt den etablierten Namen der verglichenen Gegenstände, nicht der KB-Sprache (`kb/CONTRACT.md` § "Titles are identifiers", `kb/CONVENTIONS.md` §§ "Naming" und "Language")
-- Klar darlegen, was verglichen wird und warum
-- Eine Vergleichstabelle mit den Kriterien als Zeilen verwenden
-- Eine Analyse, die die Tabelle auswertet statt sie zu wiederholen
-- Eine Empfehlung, wo eine begründbar ist
+- A title that names the comparison (e.g. "Go vs Rust", "Kubernetes vs Docker Swarm"); it follows the established names of the subjects compared, not the KB language (`kb/CONTRACT.md` § "Titles are identifiers", `kb/CONVENTIONS.md` §§ "Naming" and "Language")
+- State clearly what is being compared and why
+- Use a comparison table with the criteria as rows
+- An analysis that evaluates the table rather than repeating it
+- A recommendation wherever one can be justified
 
 ## Template
 
+The block below is page material, so it is written in this instance's KB language
+(`kb/CONVENTIONS.md` `language:`) rather than in the control plane's English - its headings
+become the headings of every page `wikitool new comparison` scaffolds.
+
 ```markdown
 # Comparison: {name}
 
@@ -67,16 +71,16 @@ TODO: Auswertung des Vergleichs. Welche Muster zeigen sich? Was sind die entsche
 TODO: Falls möglich - was wann und für wen zu verwenden ist. Unter welchen Umständen ist welche Option die beste?
 ```
 
-`# Comparison:` bleibt als Präfix stehen - anders als bei `source` ist es kein `title_prefix`,
-sondern reine Template-Konvention, und der Seitentitel selbst (`Go vs Rust`) trägt es nicht.
-Fügt `wikitool xref` eine Beziehung hinzu, entsteht der toolgeführte Querverweis-Abschnitt; wie
-er heißt, entscheidet die Instanz in `kb/CONVENTIONS.md` (`sections:`).
+`# Comparison:` stays as a prefix - unlike `source` it is no `title_prefix` but a pure template
+convention, and the page title itself (`Go vs Rust`) does not carry it. When `wikitool xref` adds
+a relationship, the tool-managed cross-reference section appears; what it is called is the
+instance's decision in `kb/CONVENTIONS.md` (`sections:`).
 
 ---
 
-Ergänzende Hinweise:
+Additional notes:
 
-- Vergleichsseiten stützen Technologieauswahl und Architekturentscheidungen
-- Die verglichenen Entities sollten alle als Wiki-Seiten existieren
-- Die Kriterien sollten zur anstehenden Entscheidung passen
-- Ein Vergleich bleibt auf einen konkreten Einsatzzweck oder Entscheidungskontext fokussiert
+- Comparison pages support technology selection and architecture decisions
+- The entities compared should all exist as wiki pages
+- The criteria should fit the decision at hand
+- A comparison stays focused on one concrete purpose or decision context