feat: add 8 verified semantic anchors

[raifdmueller]

Adds the eight anchor proposals that passed verification against the catalog's quality criteria (Precise / Rich / Consistent / Attributable) plus the recognition test. Each ships EN + DE docs, regenerated metadata, a changelog entry, and an AgentSkill catalog entry.

Anchor	Category	Source
Conway's Law	Software Architecture	Closes #506
CAP Theorem	Software Architecture	Closes #508
Fallacies of Distributed Computing	Software Architecture	Closes #507
Law of Demeter	Design Principles	Closes #509
First Principles Thinking	Problem-Solving	Closes #510
Postel's Law (Robustness Principle)	Design Principles	Closes #512
Goodhart's Law	Strategic Planning	Closes #513
Inverted Pyramid Style	Communication & Presentation	Closes #538 (proposed by @mhchem)

Verification notes

• All eight activate a rich, bounded, attributable knowledge domain (recognition test passed); cross-references point only to existing anchors.
• Postel's Law doc includes the modern security caveat (tolerant parsing → ambiguity); apply with a documented tolerance boundary.
• Goodhart's Law is framed as an actionable critique lens (KPIs, LLM-eval criteria), not a passive observation.
• Inverted Pyramid doc spells out the distinction from BLUF (short) and the Pyramid Principle (complete MECE argument).

Deliberately excluded (pending rework / decision)

• Inversion [Anchor Proposal]: Inversion #511 — qualifies only with a disambiguating qualifier (collides with Inversion of Control etc.).
• One sentence per line [Anchor Proposal]: One sentence per line #539 — borders on a bare instruction; would be stronger as the established "Semantic Line Breaks" convention.
• TDD Hamburg School [Anchor Proposal]: TDD Hamburg School according to Ralf Westphal #458 — "Hamburg School" not clearly established as a term; possibly "Informed TDD (Westphal)" instead — needs a source.
• YOLO [Anchor Proposal]: YOLO #443 — counter-example (a vibe, no bounded domain); belongs in Rejected Proposals.

Verification done

extract-metadata → 155 anchors, clean; all 16 .adoc render via asciidoctor; the Conway's Law modal renders correctly in a preview build (title + Core Concepts + proponents); 97 unit tests pass.

🤖 Generated with Claude Code

Summary by CodeRabbit

Versionshinweise

• Dokumentation
  • Acht neue Wissensnker hinzugefügt: CAP Theorem, Conway's Law, Fallacies of Distributed Computing, First Principles Thinking, Goodhart's Law, Inverted Pyramid Style, Law of Demeter und Postel's Law
  • Vollständige zweisprachige Unterstützung (Deutsch und Englisch) für alle neuen Anker
  • Aktualisierte Katalogverweise und Kategorisierung

[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: 475c0b17-d727-48b0-9338-a044fe82f463

📥 Commits

Reviewing files that changed from the base of the PR and between f0681df and d0d3cac.

📒 Files selected for processing (23)

• docs/anchors/cap-theorem.adoc
• docs/anchors/cap-theorem.de.adoc
• docs/anchors/conways-law.adoc
• docs/anchors/conways-law.de.adoc
• docs/anchors/fallacies-of-distributed-computing.adoc
• docs/anchors/fallacies-of-distributed-computing.de.adoc
• docs/anchors/first-principles-thinking.adoc
• docs/anchors/first-principles-thinking.de.adoc
• docs/anchors/goodharts-law.adoc
• docs/anchors/goodharts-law.de.adoc
• docs/anchors/inverted-pyramid-style.adoc
• docs/anchors/inverted-pyramid-style.de.adoc
• docs/anchors/law-of-demeter.adoc
• docs/anchors/law-of-demeter.de.adoc
• docs/anchors/postels-law.adoc
• docs/anchors/postels-law.de.adoc
• docs/changelog.adoc
• plugins/semantic-anchors/skills/semantic-anchor-translator/references/catalog.md
• skill/semantic-anchor-translator/references/catalog.md
• website/public/data/anchors.json
• website/public/data/categories.json
• website/public/data/metadata.json
• website/public/data/roles.json

---

Walkthrough

Dieser PR erweitert den Semantic-Anchors-Katalog um acht neue Wissensprinzipien. Für jeden Anchor werden englische und deutsche Dokumentationen erstellt, Changelog und Referenzkataloge aktualisiert, die Website-Metadaten regeneriert und Zuordnungen zu Rollen und Kategorien gepflegt.

Changes

Neue Semantic Anchors – Acht Prinzipien und Methoden

Layer / File(s)	Zusammenfassung
Anchor-Dokumentationen docs/anchors/cap-theorem.{adoc,de.adoc}, docs/anchors/conways-law.{adoc,de.adoc}, docs/anchors/fallacies-of-distributed-computing.{adoc,de.adoc}, docs/anchors/first-principles-thinking.{adoc,de.adoc}, docs/anchors/goodharts-law.{adoc,de.adoc}, docs/anchors/inverted-pyramid-style.{adoc,de.adoc}, docs/anchors/law-of-demeter.{adoc,de.adoc}, docs/anchors/postels-law.{adoc,de.adoc}	Für alle acht Anchors werden strukturierte AsciiDoc-Seiten mit Metadaten (Kategorien, Rollen, Tags, Stufe), Kernkonzepten, Anwendungs- und Nicht-Anwendungsfällen sowie Verweisen zu verwandten Ankern bereitgestellt (jeweils englisch und deutsch).
Changelog und Katalog-Referenzen docs/changelog.adoc, plugins/semantic-anchors/skills/.../catalog.md, skill/semantic-anchor-translator/references/catalog.md	Die acht Anchors werden in die Changelog-Einträge unter 2026-06-01 aufgenommen; parallel werden beide Katalog-Referenzdateien aktualisiert, um Synonyme, Proponenten und Kernbeschreibungen in den entsprechenden Themenbereichen (Software Architecture, Design Principles, Problem Solving, Communication & Presentation, Strategic Planning) einzutragen.
Website-Metadaten (JSON) website/public/data/anchors.json, website/public/data/categories.json, website/public/data/metadata.json	Die Haupt-Anchors-Liste wird um acht Objekte erweitert (je mit id, title, categories, roles, related, proponents, tags, filePath); Kategorieenlisten werden mit den neuen Anchor-IDs aktualisiert; Metadaten-Zähler (counts.anchors von 152 auf 155, statisticsAnchorsWithTags und -WithRelated) werden erhöht; veraltete Workflow-Anchors werden entfernt.
Rollenbasierte Zuordnungen website/public/data/roles.json	Die elf betroffenen Rollen (Business Analyst, Consultant, Data Scientist, DevOps Engineer, Educator, Product Owner, QA Engineer, Software Architect, Software Developer, Team Lead, Technical Writer) erhalten neue Anchor-IDs in ihren jeweiligen anchors-Arrays; veraltete workflow-*-Anchors werden entfernt und durch aktuelle Skill-Anchors ersetzt.

Geschätzter Code-Review-Aufwand

🎯 2 (Simple) | ⏱️ ~10 Minuten

Begründung: Die Änderungen sind überwiegend homogen und repetitiv (acht identisch strukturierte Anchor-Dokumentationen, konsistente JSON-Updates). Jede Anchor-Datei folgt demselben AsciiDoc-Template, und die Metadaten-Updates (JSON) sind mechanische Listeneinträge. Keine komplexe Logik, keine Umstrukturierungen oder Abhängigkeitskonflikt zu prüfen — nur Konsistenzvalidierung über alle acht Instanzen.

Möglicherweise verwandte PRs

• LLM-Coding/Semantic-Anchors#193: Aktualisiert ebenfalls docs/changelog.adoc mit neuen Anchor-Einträgen unter dem Datum 2026-06-01.
• LLM-Coding/Semantic-Anchors#547: Erweitert ebenfalls den Semantic-Anchors-Katalog durch neue Anchor-Einträge in website/public/data/anchors.json und zugehörige Metadaten.
• LLM-Coding/Semantic-Anchors#543: Ergänzt die Anchor-Datei docs/anchors/meaningful-human-control.de.adoc, auf die dieser PR im Changelog ebenfalls verweist.

🚥 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 'feat: add 8 verified semantic anchors' beschreibt präzise die Hauptänderung: Das Hinzufügen von 8 verifizierten semantischen Ankern als neue Funktionalität.
Linked Issues check	✅ Passed	Der Pull Request implementiert alle Anforderungen der 8 verknüpften Issues (#506, #508, #507, #509, #510, #512, #513, #538) durch das Hinzufügen vollständiger Dokumentation (EN + DE), Changelog und Metadaten-Updates.
Out of Scope Changes check	✅ Passed	Alle Änderungen beziehen sich direkt auf die 8 neuen semantischen Anker und deren Integration (Docs, JSON-Daten, Katalog). Entfernung von fünf Workflow-Ankern ist Teil der bestehenden Datenverwaltung.
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.}