feat: add IOSP anchor and TDD Hamburg Style contract

[JensGrote]

Changes

IOSP Anchor (#556)

• New anchor: Integration Operation Segregation Principle (IOSP)
• EN and DE versions in docs/anchors/
• Registered in docs/all-anchors.adoc, docs/metadata/roles.yml, and AgentSkill catalog.md
• LLM Activation Test: ✅ passed (Recognition: strong, Accuracy: high, Depth: rich, Specificity: very high)

TDD Hamburg Style Contract (#557)

• New semantic contract in website/public/data/contracts.json
• Composes: Red-Green-Refactor, London School, Chicago School, IOSP
• Based on draft from Ralf Westphal via @kuerm in [Anchor Proposal]: TDD Hamburg School according to Ralf Westphal #458

Infrastructure

• pre-commit hooks installed and tested locally
• asciidoc-linter installed from docToolchain
• All hooks passed before commit

Closes #556, Closes #557

Summary by CodeRabbit

Release Notes

• Documentation
  • Neue Dokumentation zum Integration Operation Segregation Principle (IOSP) verfügbar – sowohl in Englisch als auch in Deutsch
  • Neuer TDD-Vertrag „TDD, Hamburg Style" in den Katalog aufgenommen
  • Katalog und Metadaten zur Unterstützung neuer Design-Prinzipien aktualisiert

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yml

Review profile: CHILL

Plan: Pro

Run ID: eb559428-e5d1-46ab-baf8-da5dc6a4e5f6

📥 Commits

Reviewing files that changed from the base of the PR and between 14015fc and 7de820a.

📒 Files selected for processing (8)

• .pre-commit-config.yaml
• docs/all-anchors.adoc
• docs/anchors/iosp.adoc
• docs/anchors/iosp.de.adoc
• docs/changelog.adoc
• docs/metadata/roles.yml
• skill/semantic-anchor-translator/references/catalog.md
• website/public/data/contracts.json

---

Walkthrough

Die PR führt einen neuen Semantic Anchor für das Integration Operation Segregation Principle (IOSP) mit vollständiger englischer und deutscher Dokumentation ein, registriert ihn im Katalog, fügt einen neuen Semantic Contract für TDD Hamburg Style hinzu und aktualisiert entsprechende Release-Dokumentation sowie Pre-Commit-Konfiguration.

Changes

IOSP-Anker und TDD-Vertrag einführen

Layer / File(s)	Summary
IOSP-Anchor-Dokumentation und Metadaten docs/anchors/iosp.adoc, docs/anchors/iosp.de.adoc, docs/metadata/roles.yml	Vollständige englische und deutschsprachige Dokumentation des IOSP definiert Kern­konzepte (Operation als Logik, Integration als Zusammensetzung, Hybrid-Anti-Pattern), erläutert DIP-Bezug, Testbarkeit und Codebase-Struktur; Rollenmapping für Developer, Architect, Educator und Consultant.
IOSP-Katalog-Registrierung docs/all-anchors.adoc, skill/semantic-anchor-translator/references/catalog.md	IOSP wird in die zentrale All-Anchors-Referenz und den semantischen Anchor-Katalog aufgenommen; Katalog-Eintrag mit Synonymen und Kerndefinition zwischen SLAP und Code Smells positioniert.
TDD, Hamburg Style – Semantic Contract website/public/data/contracts.json	Neuer Vertrag mit ID tdd-hamburg-style definiert Design-LED TDD-Methodik (ACD-Zyklus, Service-Level-Testing, minimales Mocking, IOSP-Integration, Deep Work); englische und deutsche Titel, Beschreibungen und Templates; Kategorie Development.
Changelog und Pre-Commit-Konfiguration docs/changelog.adoc, .pre-commit-config.yaml	Changelog-Eintrag für 2026-06-03 dokumentiert neue Anchors (IOSP) und Contracts (TDD, Hamburg Style); asciidoc-linter-Hook wird von commit-Stage auf pre-commit-Stage verschoben.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

• LLM-Coding/Semantic-Anchors#561: Beide PRs aktualisieren die Anchor-Katalog-Pipeline in skill/semantic-anchor-translator/references/catalog.md um neue semantische Anker (IOSP vs. SRE).
• LLM-Coding/Semantic-Anchors#193: Beide PRs aktualisieren docs/changelog.adoc durch Hinzufügen neuer Einträge für neu eingeführte semantische Anker und Verträge.
• LLM-Coding/Semantic-Anchors#367: Beide PRs fügen neue Vertragsobjekte in das Contracts-Array in website/public/data/contracts.json ein (mit unterschiedlichen Contract-IDs).

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	Der Titel fasst prägnant die zwei Hauptänderungen zusammen: Hinzufügen des IOSP-Ankers und des TDD-Hamburg-Style-Vertrags.
Linked Issues check	✅ Passed	Die PR erfüllt alle Anforderungen aus den verknüpften Issues #556 und #557: IOSP-Anker (EN/DE) mit Registrierung und TDD-Hamburg-Style-Vertrag wurden vollständig implementiert.
Out of Scope Changes check	✅ Passed	Die Änderung an .pre-commit-config.yaml (stages-Anpassung) ist eine unterstützende Infrastrukturänderung für lokales Testen und liegt daher im Scope.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[rdmueller]

thanx!