Skip to content

feat: assign tiers to new anchors and regenerate all metadata #209

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
rdmueller merged 1 commit into from
Mar 17, 2026
Merged

feat: assign tiers to new anchors and regenerate all metadata #209

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
108 changes: 99 additions & 9 deletions docs/all-anchors.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,25 +11,83 @@ include::about.adoc[leveloffset=+1]

include::anchors/bluf.adoc[leveloffset=+2]

include::anchors/chatham-house-rule.adoc[leveloffset=+2]
include::anchors/gutes-deutsch-wolf-schneider.adoc[leveloffset=+2]

include::anchors/mece.adoc[leveloffset=+2]

include::anchors/myers-briggs-type-indicator.adoc[leveloffset=+2]

include::anchors/plain-english-strunk-white.adoc[leveloffset=+2]

include::anchors/problem-space-nvc.adoc[leveloffset=+2]

include::anchors/pyramid-principle.adoc[leveloffset=+2]

<<<

== Design Principles & Patterns

include::anchors/dry-principle.adoc[leveloffset=+2]

include::anchors/fowler-patterns.adoc[leveloffset=+2]

include::anchors/gof-abstract-factory-pattern.adoc[leveloffset=+2]

include::anchors/gof-adapter-pattern.adoc[leveloffset=+2]

include::anchors/gof-bridge-pattern.adoc[leveloffset=+2]

include::anchors/gof-builder-pattern.adoc[leveloffset=+2]

include::anchors/gof-chain-of-responsibility-pattern.adoc[leveloffset=+2]

include::anchors/gof-command-pattern.adoc[leveloffset=+2]

include::anchors/gof-composite-pattern.adoc[leveloffset=+2]

include::anchors/gof-decorator-pattern.adoc[leveloffset=+2]

include::anchors/gof-design-patterns.adoc[leveloffset=+2]

include::anchors/gof-facade-pattern.adoc[leveloffset=+2]

include::anchors/gof-factory-method-pattern.adoc[leveloffset=+2]

include::anchors/gof-flyweight-pattern.adoc[leveloffset=+2]

include::anchors/gof-interpreter-pattern.adoc[leveloffset=+2]

include::anchors/gof-iterator-pattern.adoc[leveloffset=+2]

include::anchors/gof-mediator-pattern.adoc[leveloffset=+2]

include::anchors/gof-memento-pattern.adoc[leveloffset=+2]

include::anchors/gof-observer-pattern.adoc[leveloffset=+2]

include::anchors/gof-prototype-pattern.adoc[leveloffset=+2]

include::anchors/gof-proxy-pattern.adoc[leveloffset=+2]

include::anchors/gof-singleton-pattern.adoc[leveloffset=+2]

include::anchors/gof-state-pattern.adoc[leveloffset=+2]

include::anchors/gof-strategy-pattern.adoc[leveloffset=+2]

include::anchors/gof-template-method-pattern.adoc[leveloffset=+2]

include::anchors/gof-visitor-pattern.adoc[leveloffset=+2]

include::anchors/solid-dip.adoc[leveloffset=+2]

include::anchors/solid-isp.adoc[leveloffset=+2]

include::anchors/solid-lsp.adoc[leveloffset=+2]

include::anchors/solid-ocp.adoc[leveloffset=+2]

include::anchors/solid-principles.adoc[leveloffset=+2]

include::anchors/spot-principle.adoc[leveloffset=+2]
include::anchors/solid-srp.adoc[leveloffset=+2]

include::anchors/ssot-principle.adoc[leveloffset=+2]

Expand All @@ -43,8 +101,16 @@ include::anchors/bem-methodology.adoc[leveloffset=+2]

include::anchors/conventional-commits.adoc[leveloffset=+2]

include::anchors/definition-of-done.adoc[leveloffset=+2]

include::anchors/github-flow.adoc[leveloffset=+2]

Comment on lines +104 to +107

@coderabbitai coderabbitai Bot Mar 17, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
set -euo pipefail

CATALOG="skill/semantic-anchor-translator/references/catalog.md"

if [ ! -f "$CATALOG" ]; then
  echo "Datei fehlt: $CATALOG"
  exit 1
fi

missing=0
for id in definition-of-done fagan-inspection github-flow invest prd; do
  if ! rg -n --fixed-strings "$id" "$CATALOG" >/dev/null; then
    echo "Fehlt im Katalog: $id"
    missing=1
  fi
done

if [ "$missing" -eq 0 ]; then
  echo "Alle erwarteten Anchors sind im Katalog vorhanden."
fi

Repository: LLM-Coding/Semantic-Anchors

Length of output: 219

Semantic-Anchor-Katalog für neue Anchors aktualisieren erforderlich.

Die neuen Anchors (definition-of-done, fagan-inspection, github-flow, invest, prd) wurden in docs/all-anchors.adoc erfasst, sind aber nicht in der AgentSkill-Katalogdatei skill/semantic-anchor-translator/references/catalog.md enthalten. Dies verhindert, dass AI-Agenten diese Anchors zuverlässig erkennen und vorschlagen können. Bitte aktualisieren Sie den Katalog entsprechend.

🤖 Prompt for AI Agents 
Verify each finding against the current code and only fix it if needed.

In `@docs/all-anchors.adoc` around lines 104 - 107, Die neuen Anchors
definition-of-done, fagan-inspection, github-flow, invest und prd wurden in
docs/all-anchors.adoc aufgenommen but are missing from the AgentSkill catalog;
update skill/semantic-anchor-translator/references/catalog.md by adding entries
for each of these anchors following the existing catalog entry format (same
heading/ID, anchor name, short description and any tags/aliases used elsewhere)
so the semantic-anchor-translator can recognize and suggest them (verify
formatting matches other entries in catalog.md).

include::anchors/mental-model-according-to-naur.adoc[leveloffset=+2]

include::anchors/mikado-method.adoc[leveloffset=+2]

include::anchors/regulated-environment.adoc[leveloffset=+2]

include::anchors/semantic-versioning.adoc[leveloffset=+2]

include::anchors/sota.adoc[leveloffset=+2]
Expand Down Expand Up @@ -87,16 +153,18 @@ include::anchors/five-whys.adoc[leveloffset=+2]

include::anchors/morphological-box.adoc[leveloffset=+2]

include::anchors/rubber-duck-debugging.adoc[leveloffset=+2]

<<<

== Requirements Engineering

include::anchors/ears-requirements.adoc[leveloffset=+2]

include::anchors/invest.adoc[leveloffset=+2]

include::anchors/moscow.adoc[leveloffset=+2]

include::anchors/prd.adoc[leveloffset=+2]

include::anchors/problem-space-nvc.adoc[leveloffset=+2]

include::anchors/user-story-mapping.adoc[leveloffset=+2]
Expand All @@ -107,8 +175,6 @@ include::anchors/user-story-mapping.adoc[leveloffset=+2]

include::anchors/adr-according-to-nygard.adoc[leveloffset=+2]

include::anchors/cqrs.adoc[leveloffset=+2]

include::anchors/arc42.adoc[leveloffset=+2]

include::anchors/atam.adoc[leveloffset=+2]
Expand All @@ -117,6 +183,8 @@ include::anchors/c4-diagrams.adoc[leveloffset=+2]

include::anchors/clean-architecture.adoc[leveloffset=+2]

include::anchors/cqrs.adoc[leveloffset=+2]

include::anchors/domain-driven-design.adoc[leveloffset=+2]

include::anchors/event-driven-architecture.adoc[leveloffset=+2]
Expand Down Expand Up @@ -151,6 +219,8 @@ include::anchors/jobs-to-be-done.adoc[leveloffset=+2]

include::anchors/pugh-matrix.adoc[leveloffset=+2]

include::anchors/swot.adoc[leveloffset=+2]

include::anchors/wardley-mapping.adoc[leveloffset=+2]

<<<
Expand All @@ -159,17 +229,37 @@ include::anchors/wardley-mapping.adoc[leveloffset=+2]

include::anchors/bdd-given-when-then.adoc[leveloffset=+2]

include::anchors/fagan-inspection.adoc[leveloffset=+2]

include::anchors/gherkin.adoc[leveloffset=+2]

include::anchors/iec-61508-sil-levels.adoc[leveloffset=+2]

include::anchors/linddun.adoc[leveloffset=+2]

include::anchors/mutation-testing.adoc[leveloffset=+2]

include::anchors/owasp-top-10.adoc[leveloffset=+2]

include::anchors/property-based-testing.adoc[leveloffset=+2]

include::anchors/stride.adoc[leveloffset=+2]

include::anchors/tdd-chicago-school.adoc[leveloffset=+2]

include::anchors/tdd-london-school.adoc[leveloffset=+2]

include::anchors/test-double-dummy.adoc[leveloffset=+2]

include::anchors/test-double-fake.adoc[leveloffset=+2]

include::anchors/test-double-meszaros.adoc[leveloffset=+2]

include::anchors/tdd-london-school.adoc[leveloffset=+2]
include::anchors/test-double-mock.adoc[leveloffset=+2]

include::anchors/test-double-spy.adoc[leveloffset=+2]

include::anchors/test-double-stub.adoc[leveloffset=+2]

include::anchors/testing-pyramid.adoc[leveloffset=+2]

Expand Down
1 change: 1 addition & 0 deletions docs/anchors/definition-of-done.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@
:related: bdd-given-when-then, user-story-mapping, moscow
:proponents: Ken Schwaber, Jeff Sutherland
:tags: dod, acceptance criteria, scrum, agile, quality gates, done, sprint, increment
:tier: 3

[%collapsible]
====
Expand Down
1 change: 1 addition & 0 deletions docs/anchors/definition-of-done.de.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@
:related: bdd-given-when-then, user-story-mapping, moscow
:proponents: Ken Schwaber, Jeff Sutherland
:tags: dod, acceptance criteria, scrum, agile, quality gates, done, sprint, increment
:tier: 3

[%collapsible]
====
Expand Down
1 change: 1 addition & 0 deletions docs/anchors/fagan-inspection.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@
:related: mutation-testing, testing-pyramid
:proponents: Michael Fagan
:tags: code-review, inspection, defect-detection, formal-review, static-analysis
:tier: 3

[%collapsible]
====
Expand Down
1 change: 1 addition & 0 deletions docs/anchors/fagan-inspection.de.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@
:related: mutation-testing, testing-pyramid
:proponents: Michael Fagan
:tags: code-review, inspection, defect-detection, formal-review, static-analysis
:tier: 3

[%collapsible]
====
Expand Down
1 change: 1 addition & 0 deletions docs/anchors/github-flow.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@
:related: conventional-commits, semantic-versioning
:proponents: Scott Chacon
:tags: git, branching, pull-request, continuous-delivery, workflow, feature-branch, code-review, main-branch
:tier: 3

[%collapsible]
====
Expand Down
1 change: 1 addition & 0 deletions docs/anchors/github-flow.de.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@
:related: conventional-commits, semantic-versioning
:proponents: Scott Chacon
:tags: git, branching, pull-request, continuous-delivery, workflow, feature-branch, code-review, main-branch
:tier: 3

@coderabbitai coderabbitai Bot Mar 17, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

Inkonsistenz zwischen PR-Beschreibung und Code!

Die PR-Beschreibung gibt "GitHub Flow — ★☆☆ — Simple workflow (branch, PR, merge, deploy); shallow activation" an, was auf Tier 1 hindeutet, aber der Code implementiert :tier: 3.

Sternbewertung vs. Tier:

  • ★☆☆ (1 Stern) = Tier 1 (flach/einfach)
  • ★★☆ (2 Sterne) = Tier 2 (moderat)
  • ★★★ (3 Sterne) = Tier 3 (tief/komplex)

Die Begründung "shallow activation" und "simple workflow" sprechen klar für Tier 1, nicht Tier 3.

🔧 Vorgeschlagene Korrektur 
-:tier: 3
+:tier: 1
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
:tier: 3
:tier: 1
🤖 Prompt for AI Agents 
Verify each finding against the current code and only fix it if needed.

In `@docs/anchors/github-flow.de.adoc` at line 7, The document shows a mismatch
between the PR description "GitHub Flow — ★☆☆ — Simple workflow (branch, PR,
merge, deploy); shallow activation" and the front-matter setting :tier: 3;
update the front-matter to match the description by changing the token ":tier:
3" to ":tier: 1" (or alternatively, if you intend a Tier 3 workflow, adjust the
PR description/stars to ★★★ and the accompanying rationale); ensure the change
is applied to the line containing the :tier: value so the star-rating and tier
are consistent.


[%collapsible]
====
Expand Down
1 change: 1 addition & 0 deletions docs/anchors/invest.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@
:related: user-story-mapping, moscow
:proponents: Bill Wake
:tags: user-stories, agile, scrum, acceptance-criteria, story-quality
:tier: 3

[%collapsible]
====
Expand Down
1 change: 1 addition & 0 deletions docs/anchors/prd.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@
:related: moscow, user-story-mapping, impact-mapping, ears-requirements
:proponents: Marty Cagan, Roman Pichler
:tags: product, requirements, specification, planning, stakeholders
:tier: 3

[%collapsible]
====
Expand Down
1 change: 1 addition & 0 deletions docs/anchors/prd.de.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@
:related: moscow, user-story-mapping, impact-mapping, ears-requirements
:proponents: Marty Cagan, Roman Pichler
:tags: product, requirements, specification, planning, stakeholders
:tier: 3

[%collapsible]
====
Expand Down
Loading
Loading