Skip to content

feat: catalog curation — tier system, removals, and improvements#192

Merged
rdmueller merged 1 commit into
LLM-Coding:mainfrom
raifdmueller:feat/catalog-curation
Mar 14, 2026
Merged

feat: catalog curation — tier system, removals, and improvements#192
rdmueller merged 1 commit into
LLM-Coding:mainfrom
raifdmueller:feat/catalog-curation

Conversation

@raifdmueller

@raifdmueller raifdmueller commented Mar 14, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Introduced three-tier quality rating (★★★/★★☆/★☆☆) for all semantic anchors based on how reliably they improve LLM communication
  • All anchors now carry an internal :tier: attribute
  • Updated issue template with tier-based review criteria for new proposals

Removed (4)

  • Rubber Duck Debugging — covered by Socratic Method
  • DRY — too vague as LLM instruction
  • SPOT — consolidated into SSOT
  • Chatham House Rule — no practical LLM application

Renamed & upgraded

  • Mental Model (Naur)Programming as Theory Building (Naur) (tier 1→2)
  • Problem Space NVCNonviolent Communication (Rosenberg) (tier 2→3)
  • Test Double (Meszaros) → tier 3 umbrella + 5 new sub-anchors: Dummy, Stub, Spy, Mock, Fake
  • Jobs To Be Done → tier 3
  • SOTA → tier 3

Downgraded

  • Regulated Environment → tier 2

New umbrella

  • SPC with Control Chart + Nelson Rules as sub-anchors

Test plan

  • Verify all anchor files have :tier: attribute
  • Verify removed anchors no longer appear in catalog
  • Verify new Test Double sub-anchors render correctly
  • Verify renamed anchors (NVC, Naur) display with new titles
  • Verify issue template shows tier criteria

🤖 Generated with Claude Code

Summary by CodeRabbit

Release Notes

  • Dokumentation
    • Neues Tier-Rating-System für Anchors eingeführt (★★★)
    • Mehrere Anchors umbenannt für bessere Klarheit (z. B. „Programming as Theory Building", „Nonviolent Communication")
    • Test Double Anchor erweitert mit fünf neuen speziellen Unterkategorien
    • Veraltete Anchors aus dem Katalog entfernt
    • Qualitätskriterien für Anchor-Vorschläge aktualisiert

Introduce three-tier quality rating for all semantic anchors based on
how reliably they improve LLM communication:
- ★★★ (tier 3): Self-standing, actionable
- ★★☆ (tier 2): Needs qualification
- ★☆☆ (tier 1): Descriptive only (legacy, no new additions)

Removed (4):
- Rubber Duck Debugging (covered by Socratic Method)
- DRY (too vague as LLM instruction)
- SPOT (consolidated into SSOT)
- Chatham House Rule (no practical LLM application)

Renamed & upgraded (3):
- Mental Model (Naur) → Programming as Theory Building (Naur) (tier 2)
- Problem Space NVC → Nonviolent Communication (Rosenberg) (tier 3)
- Test Double (Meszaros) → tier 3 umbrella + 5 sub-anchors

Upgraded: JTBD, SOTA (both to tier 3)
Downgraded: Regulated Environment (to tier 2)
New umbrella: SPC with Control Chart + Nelson Rules as sub-anchors

Updated issue template with tier-based review criteria.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Mar 14, 2026

Copy link
Copy Markdown
Contributor

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yml

Review profile: CHILL

Plan: Pro

Run ID: eb3f2b1f-1de3-4471-b2e1-dc91d960afeb

📥 Commits

Reviewing files that changed from the base of the PR and between 72d4f78 and 8f80c8e.

📒 Files selected for processing (103)
  • .github/ISSUE_TEMPLATE/propose-anchor.yml
  • docs/anchors/_template.adoc
  • docs/anchors/adr-according-to-nygard.adoc
  • docs/anchors/arc42.adoc
  • docs/anchors/atam.adoc
  • docs/anchors/bdd-given-when-then.adoc
  • docs/anchors/bem-methodology.adoc
  • docs/anchors/bluf.adoc
  • docs/anchors/c4-diagrams.adoc
  • docs/anchors/chain-of-thought.adoc
  • docs/anchors/chatham-house-rule.adoc
  • docs/anchors/chatham-house-rule.de.adoc
  • docs/anchors/clean-architecture.adoc
  • docs/anchors/control-chart-shewhart.adoc
  • docs/anchors/conventional-commits.adoc
  • docs/anchors/cqrs.adoc
  • docs/anchors/cynefin-framework.adoc
  • docs/anchors/devils-advocate.adoc
  • docs/anchors/diataxis-framework.adoc
  • docs/anchors/docs-as-code.adoc
  • docs/anchors/domain-driven-design.adoc
  • docs/anchors/dry-principle.adoc
  • docs/anchors/dry-principle.de.adoc
  • docs/anchors/ears-requirements.adoc
  • docs/anchors/event-driven-architecture.adoc
  • docs/anchors/feynman-technique.adoc
  • docs/anchors/five-whys.adoc
  • docs/anchors/fowler-patterns.adoc
  • docs/anchors/gherkin.adoc
  • docs/anchors/gof-abstract-factory-pattern.adoc
  • docs/anchors/gof-adapter-pattern.adoc
  • docs/anchors/gof-bridge-pattern.adoc
  • docs/anchors/gof-builder-pattern.adoc
  • docs/anchors/gof-chain-of-responsibility-pattern.adoc
  • docs/anchors/gof-command-pattern.adoc
  • docs/anchors/gof-composite-pattern.adoc
  • docs/anchors/gof-decorator-pattern.adoc
  • docs/anchors/gof-design-patterns.adoc
  • docs/anchors/gof-facade-pattern.adoc
  • docs/anchors/gof-factory-method-pattern.adoc
  • docs/anchors/gof-iterator-pattern.adoc
  • docs/anchors/gof-mediator-pattern.adoc
  • docs/anchors/gof-observer-pattern.adoc
  • docs/anchors/gof-prototype-pattern.adoc
  • docs/anchors/gof-proxy-pattern.adoc
  • docs/anchors/gof-singleton-pattern.adoc
  • docs/anchors/gof-state-pattern.adoc
  • docs/anchors/gof-strategy-pattern.adoc
  • docs/anchors/gof-template-method-pattern.adoc
  • docs/anchors/gom.adoc
  • docs/anchors/gutes-deutsch-wolf-schneider.adoc
  • docs/anchors/hexagonal-architecture.adoc
  • docs/anchors/iec-61508-sil-levels.adoc
  • docs/anchors/impact-mapping.adoc
  • docs/anchors/jobs-to-be-done.adoc
  • docs/anchors/lasr.adoc
  • docs/anchors/madr.adoc
  • docs/anchors/mece.adoc
  • docs/anchors/mental-model-according-to-naur.adoc
  • docs/anchors/morphological-box.adoc
  • docs/anchors/moscow.adoc
  • docs/anchors/mutation-testing.adoc
  • docs/anchors/myers-briggs-type-indicator.adoc
  • docs/anchors/nelson-rules.adoc
  • docs/anchors/owasp-top-10.adoc
  • docs/anchors/plain-english-strunk-white.adoc
  • docs/anchors/problem-space-nvc.adoc
  • docs/anchors/property-based-testing.adoc
  • docs/anchors/pugh-matrix.adoc
  • docs/anchors/pyramid-principle.adoc
  • docs/anchors/regulated-environment.adoc
  • docs/anchors/rubber-duck-debugging.adoc
  • docs/anchors/rubber-duck-debugging.de.adoc
  • docs/anchors/semantic-versioning.adoc
  • docs/anchors/socratic-method.adoc
  • docs/anchors/solid-dip.adoc
  • docs/anchors/solid-isp.adoc
  • docs/anchors/solid-lsp.adoc
  • docs/anchors/solid-ocp.adoc
  • docs/anchors/solid-principles.adoc
  • docs/anchors/solid-srp.adoc
  • docs/anchors/sota.adoc
  • docs/anchors/spc.adoc
  • docs/anchors/spot-principle.adoc
  • docs/anchors/spot-principle.de.adoc
  • docs/anchors/ssot-principle.adoc
  • docs/anchors/swot.adoc
  • docs/anchors/tdd-chicago-school.adoc
  • docs/anchors/tdd-london-school.adoc
  • docs/anchors/test-double-dummy.adoc
  • docs/anchors/test-double-fake.adoc
  • docs/anchors/test-double-meszaros.adoc
  • docs/anchors/test-double-mock.adoc
  • docs/anchors/test-double-spy.adoc
  • docs/anchors/test-double-stub.adoc
  • docs/anchors/testing-pyramid.adoc
  • docs/anchors/timtowtdi.adoc
  • docs/anchors/todotxt-flavoured-markdown.adoc
  • docs/anchors/user-story-mapping.adoc
  • docs/anchors/wardley-mapping.adoc
  • docs/anchors/what-qualifies-as-a-semantic-anchor.adoc
  • docs/anchors/yagni.adoc
  • docs/changelog.adoc

Zusammenfassung

Diese Änderung führt ein Tier-Metadaten-System für die Dokumentation von Semantic Anchors ein und reorganisiert die Anker-Katalog-Struktur durch Metadaten-Erweiterungen, Datenlöschungen und Umbenennungen.

Walkthrough

Die Pull Request führt ein Tier-Klassifizierungssystem für Semantic Anchors ein, indem :tier: Metadaten-Felder zu über 100 Anker-Dateien hinzugefügt werden. Vier Anker werden gelöscht, fünf neue Test-Double-Spezialisten werden hinzugefügt, zwei Anker werden umbenannt und umstrukturiert, sowie die Changelog- und Issue-Template-Dokumentation werden aktualisiert.

Changes

Cohort / File(s) Summary
GitHub Template für Anker-Vorschläge
.github/ISSUE_TEMPLATE/propose-anchor.yml
Ersetzt Copilot-Validierung durch Review-Agent-Flow mit neuen Qualitätskriterien, Tier-Rating-Abschnitt (★) mit drei Stufen und Rejection-Kriterien.
Anker-Template und neue Tier-3-Anker
docs/anchors/_template.adoc, docs/anchors/adr-according-to-nygard.adoc, docs/anchors/arc42.adoc, docs/anchors/atam.adoc, docs/anchors/bdd-given-when-then.adoc, docs/anchors/bem-methodology.adoc, docs/anchors/bluf.adoc, docs/anchors/c4-diagrams.adoc, docs/anchors/chain-of-thought.adoc, docs/anchors/clean-architecture.adoc, docs/anchors/conventional-commits.adoc, docs/anchors/cqrs.adoc, docs/anchors/cynefin-framework.adoc, docs/anchors/devils-advocate.adoc, docs/anchors/diataxis-framework.adoc, docs/anchors/docs-as-code.adoc, docs/anchors/domain-driven-design.adoc, docs/anchors/ears-requirements.adoc, docs/anchors/event-driven-architecture.adoc, docs/anchors/feynman-technique.adoc, docs/anchors/five-whys.adoc, docs/anchors/fowler-patterns.adoc, docs/anchors/gherkin.adoc, docs/anchors/gof-design-patterns.adoc, docs/anchors/gutes-deutsch-wolf-schneider.adoc, docs/anchors/hexagonal-architecture.adoc, docs/anchors/impact-mapping.adoc, docs/anchors/jobs-to-be-done.adoc, docs/anchors/lasr.adoc, docs/anchors/madr.adoc, docs/anchors/mece.adoc, docs/anchors/morphological-box.adoc, docs/anchors/moscow.adoc, docs/anchors/mutation-testing.adoc, docs/anchors/owasp-top-10.adoc, docs/anchors/plain-english-strunk-white.adoc, docs/anchors/property-based-testing.adoc, docs/anchors/pyramid-principle.adoc, docs/anchors/semantic-versioning.adoc, docs/anchors/socratic-method.adoc, docs/anchors/solid-principles.adoc, docs/anchors/sota.adoc, docs/anchors/swot.adoc, docs/anchors/tdd-chicago-school.adoc, docs/anchors/tdd-london-school.adoc, docs/anchors/testing-pyramid.adoc, docs/anchors/todotxt-flavoured-markdown.adoc, docs/anchors/user-story-mapping.adoc, docs/anchors/wardley-mapping.adoc, docs/anchors/what-qualifies-as-a-semantic-anchor.adoc
Hinzufügen von :tier: 3 Metadaten-Feld zu bestehenden Ankern zur Klassifizierung der Dokumentationsqualität.
Anker mit Tier-2-Klassifizierung
docs/anchors/gom.adoc, docs/anchors/pugh-matrix.adoc, docs/anchors/regulated-environment.adoc, docs/anchors/ssot-principle.adoc
Hinzufügen von :tier: 2 Metadaten-Feld zu Ankern mit moderater Dokumentationsqualität.
Anker mit Tier-1-Klassifizierung
docs/anchors/myers-briggs-type-indicator.adoc, docs/anchors/timtowtdi.adoc, docs/anchors/yagni.adoc
Hinzufügen von :tier: 1 Metadaten-Feld zu grundlegenden Ankern mit geringerer Dokumentationsqualität.
GoF-Pattern-Anker mit Tier-Upgrade
docs/anchors/gof-abstract-factory-pattern.adoc, docs/anchors/gof-adapter-pattern.adoc, docs/anchors/gof-bridge-pattern.adoc, docs/anchors/gof-builder-pattern.adoc, docs/anchors/gof-chain-of-responsibility-pattern.adoc, docs/anchors/gof-command-pattern.adoc, docs/anchors/gof-composite-pattern.adoc, docs/anchors/gof-decorator-pattern.adoc, docs/anchors/gof-facade-pattern.adoc, docs/anchors/gof-factory-method-pattern.adoc, docs/anchors/gof-iterator-pattern.adoc, docs/anchors/gof-mediator-pattern.adoc, docs/anchors/gof-observer-pattern.adoc, docs/anchors/gof-prototype-pattern.adoc, docs/anchors/gof-proxy-pattern.adoc, docs/anchors/gof-singleton-pattern.adoc, docs/anchors/gof-state-pattern.adoc, docs/anchors/gof-strategy-pattern.adoc, docs/anchors/gof-template-method-pattern.adoc
Upgrade der Tier-Klassifizierung von 1 oder 2 zu 3 für alle Gang-of-Four-Design-Pattern-Anker.
SOLID-Prinzip-Anker mit Tier-Upgrade
docs/anchors/solid-dip.adoc, docs/anchors/solid-isp.adoc, docs/anchors/solid-lsp.adoc, docs/anchors/solid-ocp.adoc, docs/anchors/solid-srp.adoc
Upgrade der Tier-Klassifizierung von 1 zu 3 für alle SOLID-Prinzip-Anker.
Anker mit Hierarchie-Metadaten
docs/anchors/control-chart-shewhart.adoc, docs/anchors/nelson-rules.adoc, docs/anchors/spc.adoc, docs/anchors/test-double-meszaros.adoc
Hinzufügen von Parent-Anchor und Sub-Anchor Beziehungs-Metadaten zur Verbesserung der Katalog-Struktur.
Umbenannte und umstrukturierte Anker
docs/anchors/mental-model-according-to-naur.adoc, docs/anchors/problem-space-nvc.adoc
Umbenennung zu "Programming as Theory Building (Naur)" und "Nonviolent Communication (Rosenberg)" mit signifikanten Inhalts-Umstrukturierungen, erweiterten Metadaten und aktualisierten Abschnitten zur Betonung von Design-Rationale und verwandten Ankern.
Neue Test-Double-Anker (Meszaros)
docs/anchors/test-double-dummy.adoc, docs/anchors/test-double-fake.adoc, docs/anchors/test-double-mock.adoc, docs/anchors/test-double-spy.adoc, docs/anchors/test-double-stub.adoc
Hinzufügen von fünf neuen detaillierten Dokumentationen für Test-Double-Spezialisierungen mit Kernkonzepten, Verwendungsszenarien und verwandten Ankern.
Gelöschte Anker
docs/anchors/chatham-house-rule.adoc, docs/anchors/chatham-house-rule.de.adoc, docs/anchors/dry-principle.adoc, docs/anchors/dry-principle.de.adoc, docs/anchors/rubber-duck-debugging.adoc, docs/anchors/rubber-duck-debugging.de.adoc, docs/anchors/spot-principle.adoc, docs/anchors/spot-principle.de.adoc
Entfernung von acht Anker-Dokumentationen (vier Konzepte mit englischen und deutschen Versionen) aus dem Katalog.
Dokumentation und Changelog
docs/changelog.adoc
Aktualisierung des Changelogs mit neuen Einträgen zu Katalog-Kuration, Tier-Klassifizierungssystem und Qualitätskriterien für Anker-Vorschläge.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
📝 Coding Plan
  • Generate coding plan for human review comments

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

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

@rdmueller rdmueller merged commit f9023cb into LLM-Coding:main Mar 14, 2026
7 of 8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants