feat: add BDD and YAGNI semantic anchors

[raifdmueller]

Summary

Adds two new semantic anchors from @Nantero1's original PRs, rebased on current main to resolve merge conflicts:

• BDD (Given-When-Then) (feat: Add BDD (Behavior-Driven Development) semantic anchor #138) — Dan North's Behavior-Driven Development with Gherkin syntax, three amigos, living documentation
• YAGNI (feat: Add YAGNI semantic anchor #139) — Ron Jeffries/Kent Beck's principle against speculative generality

Both were reviewed and approved in #149. The original PRs had merge conflicts in all-anchors.adoc and catalog.md after merging #137, #140, #142, #143.

Changes

• docs/anchors/bdd-given-when-then.adoc — new anchor file (from feat: Add BDD (Behavior-Driven Development) semantic anchor #138)
• docs/anchors/yagni.adoc — new anchor file (from feat: Add YAGNI semantic anchor #139)
• docs/all-anchors.adoc — added includes in correct categories
• skill/semantic-anchor-translator/references/catalog.md — added catalog entries

Post-merge TODO

• Add German translations (bdd-given-when-then.de.adoc, yagni.de.adoc)
• Close original PRs feat: Add BDD (Behavior-Driven Development) semantic anchor #138 and feat: Add YAGNI semantic anchor #139 with reference to this PR

🤖 Generated with Claude Code

Summary by CodeRabbit

Release Notes

• Dokumentation
  • Neue Dokumentation für das YAGNI-Prinzip (You Aren't Gonna Need It) mit Kernelementen, praktischen Anwendungsszenarien und Verknüpfungen zu verwandten Design-Konzepten hinzugefügt
  • Neue Dokumentation für BDD (Behavior-Driven Development) mit dem Given-When-Then-Framework, Anwendungsrichtlinien und Konzepten zur Verbesserung der Softwarequalität hinzugefügt
  • Dokumentationskatalog um beide Referenzen erweitert

[coderabbitai]

Caution

Review failed

Pull request was closed or merged during review

Walkthrough

Der Pull Request fügt zwei neue Ankerdateien (YAGNI und BDD) zur Dokumentation hinzu und aktualisiert die entsprechenden Referenzkataloge. Es werden vier neue Include-Zeilen in die Masterkonfiguration eingefügt sowie zwei neue AsciiDoc-Dateien mit Prinzipien und Best Practices erstellt.

Changes

Cohort / File(s)	Summary
Dokumentationsstruktur docs/all-anchors.adoc	Hinzufügung von zwei neuen Include-Direktiven für die Anker YAGNI und BDD mit entsprechendem Leveloffset.
Ankerdateien docs/anchors/yagni.adoc, docs/anchors/bdd-given-when-then.adoc	Neue Ankerdateien mit detaillierten Erklärungen, Kernkonzepten, Anwendungsfällen und verwandten Ankern für YAGNI und BDD.
Referenzkatalog skill/semantic-anchor-translator/references/catalog.md	Erweiterung des Katalogs um neue Einträge für BDD und YAGNI mit Proponenten, alternativen Namen und Kernkonzepten.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related issues

• Review and process new anchor PRs #137-#143 #149: Dieses Problem deckt sich direkt mit den Änderungen ab, da es die Hinzufügung von BDD- und YAGNI-Ankerdateien sowie Updates für all-anchors und den Katalog fordert.

Possibly related PRs

• feat: add AgentSkill for bi-directional anchor translation #132: Der PR aktualisiert die gleiche Datei skill/semantic-anchor-translator/references/catalog.md, um BDD- und YAGNI-Einträge hinzuzufügen, während dieser PR den Katalog ursprünglich für die AgentSkill etabliert hat.
• feat: Render all-anchors.adoc in frontend via inlined web version #113: Die neuen Ankerdateien und Include-Zeilen beeinflussen direkt die Inlining- und Generierungslogik, die in diesem PR eingeführt wurde.

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	Der Titel beschreibt präzise die Hauptänderung: Hinzufügen von zwei neuen semantischen Ankern (BDD und YAGNI). Er ist prägnant, spezifisch und vermittelt klar die primäre Änderung des Commits.
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
• Post copyable unit tests in a comment

Tip

Try Coding Plans. Let us write the prompt for your AI agent so you can ship faster (with fewer bugs).
Share your feedback on Discord.

---

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.}