Skip to content

feat: add Bloom's Taxonomy anchor#572

Merged
rdmueller merged 2 commits into
LLM-Coding:mainfrom
raifdmueller:feat/bloom-taxonomy-anchor
Jun 2, 2026
Merged

feat: add Bloom's Taxonomy anchor#572
rdmueller merged 2 commits into
LLM-Coding:mainfrom
raifdmueller:feat/bloom-taxonomy-anchor

Conversation

@raifdmueller

@raifdmueller raifdmueller commented Jun 2, 2026

Copy link
Copy Markdown
Contributor

Adds Bloom's Taxonomy to the catalog. Verified against the four quality criteria (Precise, Rich, Consistent, Attributable) and the recognition test.

Why this anchor

It completes the teaching/learning cluster — 4MAT (lesson sequence), Feynman Technique (explain-it-back), Socratic Method (questioning), ELI5 (depth) — by adding the one axis they lack: the cognitive level of mastery. That lets "demonstrated understanding" be defined precisely (gate at Apply/Analyze, not Remember) instead of by a vague nod.

Consistency note

"Bloom's Taxonomy" is ambiguous between the 1956 original and the 2001 revision, and people misremember the top of the ladder. The anchor pins the Revised 2001 version (Anderson & Krathwohl) — verb levels ending in Create, plus the knowledge dimension — and explicitly flags that the hierarchy is a design heuristic, not a strict linear ladder. It also bounds scope: cognitive domain only (not affective/psychomotor).

Changes

  • docs/anchors/blooms-taxonomy.adoc + .de.adoc (EN + DE)
  • Regenerated website/public/data/*.json (additive — 158 → 159 anchors)
  • docs/changelog.adoc — 2026-06-02 section
  • skill/.../catalog.md (+ synced plugins/ copy)

Category: Communication & Presentation. Proponents: Benjamin Bloom (1956); Anderson & Krathwohl (2001).

Summary by CodeRabbit

  • Dokumentation

    • Neuer Anchor „Bloom's Taxonomy“ mit sechs kognitiven Lernebenen, Action-Verben, Einsatz‑/Nicht‑Einsatz‑Richtlinien und verknüpften Related Anchors; verfügbar in Englisch und Deutsch.
    • Changelog-Eintrag hinzugefügt.
  • Chores

    • Anchor in Website‑Katalogen, Kategorien- und Rollenlisten integriert (Berater, Pädagogen, Team‑Leads, Technical Writer).
    • Validierungsregel für Anchor‑Dokumente ergänzt.

Six-level hierarchy of cognitive learning objectives (Remember,
Understand, Apply, Analyze, Evaluate, Create), pinned to the Revised
2001 version (Anderson & Krathwohl) with its knowledge dimension.

Completes the teaching cluster (4MAT, Feynman, Socratic, ELI5): Bloom
grades the cognitive level a step targets, so 'demonstrated
understanding' can be set at Apply/Analyze rather than recall.

EN + DE content, regenerated metadata (158 to 159), changelog and
catalog entries.
@coderabbitai

coderabbitai Bot commented Jun 2, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Warning

Ignoring CodeRabbit configuration file changes. For security, only the configuration from the base branch is applied for open source repositories.

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: a0d6195f-e6d8-4f48-9869-c813d76ef787

📥 Commits

Reviewing files that changed from the base of the PR and between a1b3557 and aabf28e.

📒 Files selected for processing (1)
  • .coderabbit.yml

Walkthrough

Der PR fügt den neuen Semantic Anchor "Bloom's Taxonomy" inklusive englischer und deutscher AsciiDoc-Dokumentation, Katalog- und Changelog-Einträgen, Website-JSON-Updates (anchors/categories/roles/metadata) und einer AsciiDoc‑Review-Regel hinzu.

Changes

Bloom's Taxonomy Anchor Integration

Layer / File(s) Summary
Anker-Dokumentation (Englisch und Deutsch)
docs/anchors/blooms-taxonomy.adoc, docs/anchors/blooms-taxonomy.de.adoc
Neue AsciiDoc-Dokumente mit Metadaten (Kategorien, Rollen, Tags, Tier), einem kollabierbaren Kernbereich der sechs kognitiven Ebenen (inkl. Action-Verbs und 2001-Revision) sowie Sektionen zu Verwendung, Nicht-Verwendung und verwandten Anchors.
Katalog- und Changelog-Einträge
docs/changelog.adoc, plugins/semantic-anchors/skills/semantic-anchor-translator/references/catalog.md, skill/semantic-anchor-translator/references/catalog.md
Eintrag für "Bloom's Taxonomy" im Changelog (2026-06-02) und neue Katalogeinträge in beiden Referenzdateien (Synonyme, Proponenten, Kerndefinition).
JSON-Datenintegration
website/public/data/anchors.json, website/public/data/categories.json, website/public/data/roles.json, website/public/data/metadata.json
Neuer Anchor-Eintrag in anchors.json (id: blooms-taxonomy) mit Metadaten und Datei‑Pfad; Verknüpfung zur Kategorie communication-presentation; Zuweisung zu vier Rollen; aktualisierte Generierungs‑Metriken in metadata.json.
AsciiDoc-Review-Regel
.coderabbit.yml
Neue Pflichtprüfung in reviews.path_instructions für docs/anchors/**/*.adoc, die den Level‑0-Titel auf genau ein = festlegt und auf extract-metadata.js-Probleme mit == hinweist.

Estimated Code Review Effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly Related PRs

🚥 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 präzise und spezifisch ist und die Hauptänderung korrekt widerspiegelt: Hinzufügen der Bloom's Taxonomy als neuer semantischer Anker.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ 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

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

@coderabbitai coderabbitai Bot left a comment

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.

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/anchors/blooms-taxonomy.adoc`:
- Line 1: The top-level AsciiDoc header currently uses a single '=' ("= Bloom's
Taxonomy"); update that line to start with '==' so the top-level section begins
with "== Bloom's Taxonomy" to comply with the repository guideline that .adoc
top-level headers use '==' and maintain proper nesting.

In `@docs/anchors/blooms-taxonomy.de.adoc`:
- Line 1: The top-level AsciiDoc header currently uses a single equals sign ("=
Bloom's Taxonomy"); update this to use a double-equals top-level header ("==
Bloom's Taxonomy") so it conforms to the repo rule that top-level headers start
with "==", ensuring proper nesting for the rest of the document.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yml

Review profile: CHILL

Plan: Pro

Run ID: 769f0ecd-12ca-4dbb-aeca-3e0ed1fde4f3

📥 Commits

Reviewing files that changed from the base of the PR and between 2e8dfc4 and a1b3557.

📒 Files selected for processing (9)
  • docs/anchors/blooms-taxonomy.adoc
  • docs/anchors/blooms-taxonomy.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

@@ -0,0 +1,62 @@
= Bloom's Taxonomy

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 | 🟡 Minor | ⚡ Quick win

Top-Level-Header auf == umstellen.

Der Titel startet mit =, laut Repo-Regel für .adoc sollen Top-Level-Sections mit == beginnen.

As per coding guidelines, "**/*.adoc: ... proper nesting levels starting with == for top-level headers".

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/anchors/blooms-taxonomy.adoc` at line 1, The top-level AsciiDoc header
currently uses a single '=' ("= Bloom's Taxonomy"); update that line to start
with '==' so the top-level section begins with "== Bloom's Taxonomy" to comply
with the repository guideline that .adoc top-level headers use '==' and maintain
proper nesting.

@@ -0,0 +1,62 @@
= Bloom's Taxonomy

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 | 🟡 Minor | ⚡ Quick win

Top-Level-Header auf == vereinheitlichen.

Der Dateikopf verwendet =, die AsciiDoc-Regel im Repo fordert für Top-Level ==.

As per coding guidelines, "**/*.adoc: ... proper nesting levels starting with == for top-level headers".

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/anchors/blooms-taxonomy.de.adoc` at line 1, The top-level AsciiDoc
header currently uses a single equals sign ("= Bloom's Taxonomy"); update this
to use a double-equals top-level header ("== Bloom's Taxonomy") so it conforms
to the repo rule that top-level headers start with "==", ensuring proper nesting
for the rest of the document.

@raifdmueller

Copy link
Copy Markdown
Contributor Author

Re: CodeRabbit's two === comments — both are false positives, please do not apply the autofix

The single = Bloom's Taxonomy is the AsciiDoc level-0 document title, not a section header. This is the project-wide convention: all 292 anchor files start with = , zero with == . CodeRabbit is mis-applying the "Section headers use ==" guideline (from website/CLAUDE.md) to the doctitle, which is a different construct.

Applying the suggested fix would break the build: scripts/extract-metadata.js reads the anchor title via Asciidoctor's doc.getDocumentTitle(), which is populated only by the level-0 = title. Demote it to == and getDocumentTitle() returns undefined → the title falls back to the id → validation fails with "Missing or invalid title". The == *Core Concepts* sections below are correct level-1 headers under the level-0 title, so nesting is already valid.

No change needed here. To stop this recurring on every anchor PR, I'll propose a one-line guard in .coderabbit.yml separately.

CodeRabbit repeatedly flags the level-0 AsciiDoc document title
(= Title) as a section-header violation and suggests demoting it to
'=='. That is a false positive: all 292 anchor files use '=', and
extract-metadata.js reads the title via getDocumentTitle(), which only
the level-0 '=' populates — '==' would break the build. Add an explicit
instruction to the docs/anchors path rule so this stops recurring.
@rdmueller rdmueller merged commit a6af814 into LLM-Coding:main Jun 2, 2026
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