kb/concepts/ bekommt Areas: layout: fuer concept, Area-Titel aus jedem Type-Spec, Schwellen-Empfehlung im lint (schliesst #59)

Files changed:
- CHANGES.md
- README.md
- VERSION
- kb/concepts/Ambient Environment Dependency.md
- kb/concepts/Anti-Cramming Heuristic.md
- kb/concepts/Audit Trail.md
- kb/concepts/BM25.md
- kb/concepts/Bulk Operations.md
- kb/concepts/CI Integration.md
- kb/concepts/COLLECTION.md
- kb/concepts/CPPC.md
- kb/concepts/Checkpoint Audit.md
- kb/concepts/Claude Code Auto Mode.md
- kb/concepts/Command Round-Trip Integrity.md
- kb/concepts/Confidence Scoring.md
- kb/concepts/Consolidation Tiers.md
- kb/concepts/Content Quality Control.md
- kb/concepts/Context Isolation.md
- kb/concepts/Contradiction Resolution.md
- kb/concepts/Cross-platform Agent Skills.md
- kb/concepts/Crystallization.md
- kb/concepts/Delete Rather Than Anonymize.md
- kb/concepts/Denylist over Allowlist.md
- kb/concepts/Detect-Repair Asymmetry.md
- kb/concepts/Diff-Reviewable Agent Edits.md
- kb/concepts/Dual Licensing by File Plan.md
- kb/concepts/Entity Extraction.md
- kb/concepts/Episodic Memory.md
- kb/concepts/Event-Driven Automation.md
- kb/concepts/Filter on Ingest.md
- kb/concepts/Forgetting.md
- kb/concepts/Graph Traversal.md
- kb/concepts/Green Suite Blind Spot.md
- kb/concepts/Hooks.md
- kb/concepts/Hybrid Search.md
- kb/concepts/INDEX.md
- kb/concepts/Implementation Spectrum.md
- kb/concepts/Index Scaling.md
- kb/concepts/Issue Label Scheme.md
- kb/concepts/Iteration and Cost Limits.md
- kb/concepts/KB Migration.md
- kb/concepts/KB Stack Versioning.md
- kb/concepts/Knowledge Compounding.md
- kb/concepts/Knowledge Graph.md
- kb/concepts/LLM Wiki Pattern.md
- kb/concepts/Lint Workflow.md
- kb/concepts/MCP-Leseserver.md
- kb/concepts/Mass-Update Gate.md
- kb/concepts/Memory Lifecycle.md
- kb/concepts/Mesh Sync.md
- kb/concepts/Modbus.md
- kb/concepts/Multi-Agent Collaboration.md
- kb/concepts/Naming Convention Conflict.md
- kb/concepts/OKF Compatibility.md
- kb/concepts/Optional Instance Context File.md
- kb/concepts/Personalization Plane.md
- kb/concepts/Privacy and Governance.md
- kb/concepts/Procedural Memory.md
- kb/concepts/Publish-Remote Gate.md
- kb/concepts/Quality Scoring.md
- kb/concepts/Quality and Self-Correction.md
- kb/concepts/RAG.md
- kb/concepts/Reciprocal Rank Fusion.md
- kb/concepts/SSD TRIM.md
- kb/concepts/Scale Ceiling.md
- kb/concepts/Self-Healing.md
- kb/concepts/Semantic Lint Automation.md
- kb/concepts/Semantic Memory.md
- kb/concepts/Session Orientation.md
- kb/concepts/Shared vs Private.md
- kb/concepts/Split Merge Reclassify.md
- kb/concepts/Split Threshold.md
- kb/concepts/Structural Enforcement over Documented Rule.md
- kb/concepts/Stub Threshold.md
- kb/concepts/Supersession.md
- kb/concepts/Three-Layer Architecture.md
- kb/concepts/Token Economics.md
- kb/concepts/Typed Relationships.md
- kb/concepts/User Management.md
- kb/concepts/Vector Search.md
- kb/concepts/Work Coordination.md
- kb/concepts/Workflow Extraction.md
- kb/concepts/Workflow Orchestration.md
- kb/concepts/Working Memory.md
- kb/concepts/Write-Once Frontmatter Fields.md
- kb/concepts/architectures/Consolidation Tiers.md
- kb/concepts/architectures/Context Isolation.md
- kb/concepts/architectures/Cross-platform Agent Skills.md
- kb/concepts/architectures/Episodic Memory.md
- kb/concepts/architectures/Hybrid Search.md
- kb/concepts/architectures/Implementation Spectrum.md
- kb/concepts/architectures/Knowledge Graph.md
- kb/concepts/architectures/LLM Wiki Pattern.md
- kb/concepts/architectures/MCP-Leseserver.md
- kb/concepts/architectures/Memory Lifecycle.md
- kb/concepts/architectures/OKF Compatibility.md
- kb/concepts/architectures/Optional Instance Context File.md
- kb/concepts/architectures/Personalization Plane.md
- kb/concepts/architectures/Procedural Memory.md
- kb/concepts/architectures/RAG.md
- kb/concepts/architectures/Scale Ceiling.md
- kb/concepts/architectures/Semantic Memory.md
- kb/concepts/architectures/Three-Layer Architecture.md
- kb/concepts/architectures/Token Economics.md
- kb/concepts/architectures/Working Memory.md
- kb/concepts/decisions/Delete Rather Than Anonymize.md
- kb/concepts/decisions/Denylist over Allowlist.md
- kb/concepts/decisions/Diff-Reviewable Agent Edits.md
- kb/concepts/decisions/Dual Licensing by File Plan.md
- kb/concepts/decisions/Issue Label Scheme.md
- kb/concepts/decisions/KB Stack Versioning.md
- kb/concepts/decisions/Structural Enforcement over Documented Rule.md
- kb/concepts/patterns/Audit Trail.md
- kb/concepts/patterns/BM25.md
- kb/concepts/patterns/Command Round-Trip Integrity.md
- kb/concepts/patterns/Confidence Scoring.md
- kb/concepts/patterns/Contradiction Resolution.md
- kb/concepts/patterns/Entity Extraction.md
- kb/concepts/patterns/Filter on Ingest.md
- kb/concepts/patterns/Forgetting.md
- kb/concepts/patterns/Graph Traversal.md
- kb/concepts/patterns/Mesh Sync.md
- kb/concepts/patterns/Quality Scoring.md
- kb/concepts/patterns/Reciprocal Rank Fusion.md
- kb/concepts/patterns/Self-Healing.md
- kb/concepts/patterns/Shared vs Private.md
- kb/concepts/patterns/Typed Relationships.md
- kb/concepts/patterns/Vector Search.md
- kb/concepts/patterns/Work Coordination.md
- kb/concepts/problems/Ambient Environment Dependency.md
- kb/concepts/problems/Detect-Repair Asymmetry.md
- kb/concepts/problems/Green Suite Blind Spot.md
- kb/concepts/problems/Naming Convention Conflict.md
- kb/concepts/problems/Write-Once Frontmatter Fields.md
- kb/concepts/protocols/CPPC.md
- kb/concepts/protocols/Modbus.md
- kb/concepts/protocols/SSD TRIM.md
- kb/concepts/workflows/Anti-Cramming Heuristic.md
- kb/concepts/workflows/Bulk Operations.md
- kb/concepts/workflows/CI Integration.md
- kb/concepts/workflows/Checkpoint Audit.md
- kb/concepts/workflows/Claude Code Auto Mode.md
- kb/concepts/workflows/Content Quality Control.md
- kb/concepts/workflows/Crystallization.md
- kb/concepts/workflows/Event-Driven Automation.md
- kb/concepts/workflows/Hooks.md
- kb/concepts/workflows/Index Scaling.md
- kb/concepts/workflows/Iteration and Cost Limits.md
- kb/concepts/workflows/KB Migration.md
- kb/concepts/workflows/Knowledge Compounding.md
- kb/concepts/workflows/Lint Workflow.md
- kb/concepts/workflows/Mass-Update Gate.md
- kb/concepts/workflows/Multi-Agent Collaboration.md
- kb/concepts/workflows/Privacy and Governance.md
- kb/concepts/workflows/Publish-Remote Gate.md
- kb/concepts/workflows/Quality and Self-Correction.md
- kb/concepts/workflows/Semantic Lint Automation.md
- kb/concepts/workflows/Session Orientation.md
- kb/concepts/workflows/Split Merge Reclassify.md
- kb/concepts/workflows/Split Threshold.md
- kb/concepts/workflows/Stub Threshold.md
- kb/concepts/workflows/Supersession.md
- kb/concepts/workflows/User Management.md
- kb/concepts/workflows/Workflow Extraction.md
- kb/concepts/workflows/Workflow Orchestration.md
- kb/index.md
- kb/log.md
- tools/CONTRACT.md
- tools/README.md
- tools/chemenu/catalog.py
- tools/chemenu/commands/index_build.py
- tools/chemenu/lint_core.py
- tools/chemenu/tests/conftest.py
- tools/chemenu/tests/test_cite_cmd.py
- tools/chemenu/tests/test_git_publish.py
- tools/chemenu/tests/test_index_build.py
- tools/chemenu/tests/test_lint.py
- tools/chemenu/tests/test_new_page.py
- tools/chemenu/tests/test_provenance.py
- tools/chemenu/tests/test_type_resolver.py
- tools/chemenu/tests/test_xref.py
- types/concept.md
- types/type-spec.md

kb/concepts/workflows/KB Migration.md

@@ -0,0 +1,134 @@
+---
+type: types/concept.md
+concept_type: workflow
+tags: [migration, versioning, corpus-diff, workflow]
+created: 2026-08-30
+modified: 2026-08-31
+related:
+  - mechanism: wikitool
+  - rests-on: KB Stack Versioning
+  - see-also: Mass-Update Gate
+  - see-also: Iteration and Cost Limits
+sources: [Source - Conversation - Versioning CI-CD and Content Migration Session 2026-08-30]
+confidence: 0.70
+confidence_base: 0.70
+provenance: sourced
+summary: Migration des KB-Inhalts entlang einer geordneten Versionskette; abgegrenzt gegen offene Instanz-Aktionen, die in den doctor-Check gehoeren statt in die Kette
+---
+# KB Migration
+
+**Typ:** Workflow
+
+## Definition
+
+KB Migration ist der Ablauf, mit dem der **Inhalt** einer Wissensbasis auf die Form gebracht
+wird, die eine neuere Stack-Version erwartet. Die Form des Inhalts hat eine eigene Version in
+`.wikitool-kb.json`, unabhängig von der Stack-Version in `VERSION`
+([[KB Stack Versioning]])[^s-conversation-versioning-ci-cd-and-content-migration-session-2026-08-30].
+Eine Instanz kann Maschinerie `1.4.0` tragen, während ihr Inhalt noch in `1.2.0`-Form vorliegt;
+genau diesen Zustand durchläuft jedes Upgrade, und er ist der Grund für die Trennung.
+
+Migrationen selbst sind `manual: true`-Anweisungen unter `instructions/migrations/`. Damit
+werden sie von `dist export` ohne zweiten Exportpfad
+mitgeliefert[^s-conversation-versioning-ci-cd-and-content-migration-session-2026-08-30].
+
+## Kernpunkte
+
+- **Die Kette ist ein Intervall, keine Fallunterscheidung.** `migrate status` bildet
+  `(kb_version, VERSION]` aus den vorhandenen Migrationsdokumenten und ordnet aufsteigend. Von
+  `1.3.1` nach `2.0.0` laufen `1.4.0`, dann `1.7.0`, dann `2.0.0`. Dass keine Migration auf
+  `1.3.x` zielt, ist kein Sonderfall, sondern schlicht nicht im
+  Intervall[^s-conversation-versioning-ci-cd-and-content-migration-session-2026-08-30].
+- **`migrate done` verweigert jede Version, die nicht das nächste Glied ist.** Ein Sprung wird
+  dadurch unmöglich, und ein unterbrochenes mehrstufiges Upgrade ist an der Stelle fortsetzbar,
+  an der es
+  abbrach[^s-conversation-versioning-ci-cd-and-content-migration-session-2026-08-30].
+- **`1.0.0` ist die Basis.** Alles Ältere wird neu exportiert, nicht
+  migriert[^s-conversation-versioning-ci-cd-and-content-migration-session-2026-08-30]. Eine
+  bestehende Instanz ohne `.wikitool-kb.json` erhält ihren Startwert über `migrate baseline`;
+  der Entwicklungsbaum selbst war der erste Fall und bekam `1.0.0`, weil sein Inhalt seiner
+  Maschinerie nie
+  hinterherhing[^s-conversation-versioning-ci-cd-and-content-migration-session-2026-08-30].
+- **Zählen, nie Mengen vergleichen.** `kb_scan.extract_wikilinks()` liefert ein Set. Für `lint`
+  ist das richtig - die Frage lautet, ob ein Verweis auflöst. Für eine Migrationsprüfung ist es
+  falsch, denn dort lautet die Frage, ob einer verschwunden ist. Drei der vier Defekte, die die
+  frühere Übersetzung des Korpus fand, hatten unveränderte Link-Mengen und nur veränderte
+  Zählungen[^s-conversation-versioning-ci-cd-and-content-migration-session-2026-08-30].
+- **`lint` kann eine Migration nicht absichern.** Die Negativkontrolle: eines von zwei
+  `[[Docker]]`-Vorkommen aus `kb/entities/tools/Act Runner.md` entfernt, die Link-*Menge* damit
+  unverändert. `migrate verify --from HEAD --fail-on-error` meldet
+  `'Docker' 2->1`, `lint --fail-on-error` endet mit Exit 0 und schweigt über alle 21
+  Checks[^s-conversation-versioning-ci-cd-and-content-migration-session-2026-08-30]. `lint` liest
+  eine einzige Revision; ein verschwundener Verweis hinterlässt ein Korpus, das in sich
+  vollkommen stimmig ist. Darauf ruht die gesamte Strategie.
+- **„Seite" muss überall dasselbe heißen.** Der erste Lauf von `migrate verify` über 248 Seiten
+  meldete 13 „entfernte Seiten", die keine sind: Die historische Seite listete jede `.md` unter
+  `kb/`, die Arbeitsbaum-Seite benutzte `iter_kb_pages`, das `COLLECTION.md`, `INDEX.md` und die
+  Meta-Dateien der kb-Wurzel überspringt. Behoben durch ein gemeinsames
+  `kb_scan.is_page_path`, festgehalten durch einen
+  Regressionstest[^s-conversation-versioning-ci-cd-and-content-migration-session-2026-08-30].
+- **Kanonischer Name plus Aliase ist das Migrationsmuster.** `sections.py` dokumentiert es im
+  eigenen Docstring: Es ist das, was ein Korpus Seite für Seite statt auf einen Schlag migrieren
+  lässt - und das Entfernen eines Alias ist eine Breaking Change, keine
+  Aufräumarbeit[^s-conversation-versioning-ci-cd-and-content-migration-session-2026-08-30].
+- **Zwei Größen, zwei Regeln.** Einheiten werden nach dem Iterationsbudget geschnitten,
+  Batches getrennt davon nach dem [[Mass-Update Gate]]. Beides zu verwechseln kostete im ersten
+  Schnitt des Plans elf unnötige
+  Freigaben[^s-conversation-versioning-ci-cd-and-content-migration-session-2026-08-30].
+- **Pro Einheit zuerst die Struktur:** Frontmatter, H1, Wikilink-Ziele und Cite-IDs gegen `HEAD`
+  vergleichen, bevor irgendetwas anderes geprüft wird. `lint` wird über jede Einheit vollständig
+  gelesen, nicht nur über die vermeintlich betroffenen Abschnitte - der Frontmatter-Fehler der
+  ersten Einheit tauchte als Schema-Fehler in einem Feld auf, das niemand bearbeitet
+  hatte[^s-conversation-versioning-ci-cd-and-content-migration-session-2026-08-30].
+- **Zusammenfassungen schreibt die orchestrierende Sitzung**, nie aus einem Subagenten
+  übernommen: Sie schmücken aus, etwa „measuring application performance and responsiveness" zu
+  „Latenz und Durchsatz unter
+  Lastbedingungen"[^s-conversation-versioning-ci-cd-and-content-migration-session-2026-08-30].
+
+## Beispiele
+
+- [[wikitool]] - stellt `migrate list`/`status`/`verify`/`done`/`baseline` bereit und trägt die
+  Prüfung `corpus diff`.
+- [[Chemenu]] - erster Fall für `migrate baseline`; `1.0.0` wurde ohne Migrationsdokument
+  gesetzt, mit ausdrücklicher Begründung.
+
+## Wann zu verwenden
+
+Sobald eine semantische Änderung am Inhalt ansteht, die eine bestehende Instanz nicht durch ein
+bloßes Stack-Update mitbekommt - eine geänderte Abschnittsbenennung, ein umbenanntes
+Frontmatter-Feld, ein umgezogenes Verzeichnis. Der `MAJOR`-Bump ohne Migrationsdokument wird von
+`version bump`
+verweigert[^s-conversation-versioning-ci-cd-and-content-migration-session-2026-08-30].
+
+## Wann NICHT zu verwenden
+
+- Nicht für Änderungen, die nur die Maschinerie betreffen. Ein neuer Befehl ohne Wirkung auf die
+  Form des Inhalts braucht kein Migrationsdokument.
+- Nicht mit einem mechanischen Runner für Null-Migrationen. Eine DSL dafür wurde bewusst nicht
+  gebaut, solange es nichts zu automatisieren
+  gibt[^s-conversation-versioning-ci-cd-and-content-migration-session-2026-08-30].
+- Nicht mit `lint` als Absicherung - siehe die Negativkontrolle oben.
+- **Nicht für eine offene Instanz-Aktion.** Die Maschinerie ist durchgehend auf Korpus-Form
+  verdrahtet: `kb_version` beschreibt die Form des Inhalts, `migrate done` nimmt `--pages`,
+  `migrate verify` vergleicht `kb/`. Eine Anforderung, die eine Instanz erfüllen muss, ohne
+  dass sich eine Seite ändert - etwa das Anlegen von `USER.md`/`SOUL.md` aus der
+  [[Personalization Plane]] - ist deshalb keine Migration, sondern ein Fall für einen
+  `doctor`-Check. Ein Migrationsdokument dafür hätte zwei Kosten: `migrate done` würde
+  `kb_version` heben und damit über den Inhalt etwas behaupten, das nicht über ihn gilt, und
+  eine frische Instanz bekäme die Migration nie zu sehen, weil `dist export` ihr
+  `kb_version = VERSION` mitgibt. Der Health-Check ist hier zudem das schärfere
+  Werkzeug, weil er selbstprüfend ist: er meldet `FAIL`, bis die Sache erledigt ist, während
+  `migrate done` eine Behauptung ist, die man ohne die Arbeit aufstellen kann.
+
+## Fußnoten
+
+[^s-conversation-versioning-ci-cd-and-content-migration-session-2026-08-30]: [[Source - Conversation - Versioning CI-CD and Content Migration Session 2026-08-30]]
+
+<!-- wikitool:links -->
+## Beziehungen
+
+- **mechanism:** [[wikitool]]
+- **rests-on:** [[KB Stack Versioning]]
+- **see-also:** [[Mass-Update Gate]]
+- **see-also:** [[Iteration and Cost Limits]]
+<!-- /wikitool:links -->