Orchestrator/bahn/wissensdatenbank/.kiro/steering/changelog-versioning.md

Changelog & Versionierung (verbindlich)

Diese Regel steuert, wann und wie CHANGELOG.md und VERSION zu pflegen sind. Sie gilt fuer jede Code-/Config-/Doku-Aenderung in diesem Repo.

Single Source of Truth

• VERSION (Repo-Root): genau eine Zeile, MAJOR.MINOR.PATCH (SemVer).
• CHANGELOG.md (Repo-Root): Format „Keep a Changelog". Oben steht immer ein Abschnitt ## [Unreleased].
• Die GitLab-Pages-Seite „Changelog" (changelog.html) wird aus CHANGELOG.md erzeugt; src/site.py zeigt die VERSION in der Navigation an. Beides wird beim Pages-Build automatisch aktuell – es ist also keine HTML-Datei von Hand zu pflegen, nur CHANGELOG.md und VERSION.

Bei JEDER inhaltlichen Aenderung (vor dem Commit)

Trage einen kurzen, nutzerverstaendlichen Eintrag unter ## [Unreleased] ein, gruppiert in Added / Changed / Fixed (bei Bedarf Removed):

## [Unreleased]
### Added
- <was neu ist>
### Fixed
- <was korrigiert wurde>

Reine interne Nebensaechlichkeiten (Tippfehler in Kommentaren o.ae.) muessen nicht ins Changelog.

Beim Abschluss eines Merge Requests (Release schneiden)

Wenn ein MR gemergt werden soll und [Unreleased] Eintraege enthaelt:

1. Version bestimmen (SemVer, ausgehend vom aktuellen VERSION):
   • MAJOR +1: inkompatible Aenderung an Datenmodell/Frontmatter/Output-Struktur (output/processed/<scope>/<domaene>), an Strategien-Semantik oder Pipeline-Verhalten.
   • MINOR +1: neue Strategie/Quelle/Funktion/Seite, abwaertskompatibel.
   • PATCH +1: Bugfix, Doku, kleine Korrektur.
2. VERSION auf die neue Nummer setzen.
3. In CHANGELOG.md den Block ## [Unreleased] in ## [X.Y.Z] - JJJJ-MM-TT umbenennen (Datum = heute) und einen neuen leeren ## [Unreleased] darueber anlegen.
4. Commit-Message: chore(release): vX.Y.Z.

Hinweise

• Im Zweifel die kleinere Erhoehung waehlen (lieber MINOR als MAJOR), aber inkompatible Aenderungen ehrlich als MAJOR markieren.
• Den automatischen Daten-Commit des Bots (chore(data): ...) NICHT versionieren – er aendert nur data/, nicht Code/Verhalten.
• Wird die Output-/Frontmatter-Struktur geaendert, zusaetzlich .kiro/steering/architecture.md, README.md und Tests anpassen (siehe AGENTS.md).