Skip to content

Sync from fork: XY Problem + Kano + Bausteinsicht example + Rabauer video & footer#461

Merged
rdmueller merged 13 commits into
LLM-Coding:mainfrom
raifdmueller:main
May 8, 2026
Merged

Sync from fork: XY Problem + Kano + Bausteinsicht example + Rabauer video & footer#461
rdmueller merged 13 commits into
LLM-Coding:mainfrom
raifdmueller:main

Conversation

@raifdmueller
Copy link
Copy Markdown
Contributor

@raifdmueller raifdmueller commented May 8, 2026

Summary

Brings 5 merged features from the development fork (raifdmueller/Semantic-Anchors) to upstream so they land on the public site (llm-coding.github.io/Semantic-Anchors):

  1. feat: XY Problem anchor ([Anchor Proposal]: The XY Problem #457) — communication anti-pattern, EN + DE, plus catalog and changelog entries
  2. feat(about): Johannes Rabauer live-coding video — added to both About pages with the GDPR-friendly YouTube facade
  3. feat(footer): "as seen on rabauer.dev" link — mirrors the existing HMZE entry, logo stored locally
  4. feat(workflow): Bausteinsicht as fourth example project — added to spec-driven workflow page (EN + DE)
  5. feat: Kano Model anchor (Kano Modell #459) — Noriaki Kano's two-dimensional quality model, EN + DE, catalog and changelog

Kotter's 8-Step Change Model (#460) is pending in fork PR #24 and will sync in a follow-up.

Closed issues

Test plan

All five PRs passed the fork's CI (lint, format, security audit, E2E, CodeQL) before merge. The fork's GitHub Pages deployment is live at https://raifdmueller.github.io/Semantic-Anchors/ and shows 138 anchors (vs. 136 on upstream).

Summary by CodeRabbit

  • Neue Funktionen

    • YouTube-Video-Einbettung in der Dokumentation hinzugefügt
    • Externe Verlinkung zu rabauer.dev im Footer hinzugefügt
  • Dokumentation

    • Drei neue semantische Anker für Kano-Modell, Kotter's 8-Step Change Model und XY Problem hinzugefügt (jeweils in Englisch und Deutsch)
    • Changelog und Workflow-Dokumentation aktualisiert
    • Katalog mit neuen Konzepten erweitert

raifdmueller and others added 13 commits May 8, 2026 09:30
Communication anti-pattern from technical-support culture: the asker
requests help with attempted solution Y while the underlying goal X
is hidden. Coined by Mark Jason Dominus (2001 comp.lang.perl.misc),
formalised in Eric S. Raymond's 'How To Ask Questions The Smart Way'.

Categories: dialogue-interaction, problem-solving.
Roles: software-developer, team-lead, consultant, business-analyst.

Proposed by @dernerl in LLM-Coding#457.
Bumps three transitive dev dependencies to clear one high and two
moderate advisories that were failing the Dependency Security Audit
on the test workflow.
Two-hour English live-coding session with Johannes Rabauer
(youtu.be/Q_DWMayAQEQ, May 2026). Added to both the EN and DE
About pages using the existing GDPR-friendly YouTube facade pattern
(no third-party network until the user clicks).
…oding

feat(about): embed Rabauer live-coding session video
Mirrors the existing HMZE entry in the footer's 'as seen on' row.
The logo was downloaded from rabauer.dev and is stored locally in
public/ to keep the footer free of third-party network calls. Links
to rabauer.dev (Johannes Rabauer's site) where the live coding
session is featured.

The PNG is force-added because the repo root .gitignore excludes
*.png; hmze-logo.png is tracked the same way.
feat(footer): add 'as seen on rabauer.dev' link with logo
Bausteinsicht (https://doctoolchain.org/Bausteinsicht/) is a
bidirectional sync between a structured JSON architecture model and
draw.io diagrams — Architecture-as-Code meets draw.io. Built with the
spec-driven workflow on this site.

Updates 'three open source projects' / 'drei Open-Source-Projekte'
counters to four in both EN and DE workflow pages.
…cht-example

feat(workflow): add Bausteinsicht as fourth example project
Two-dimensional quality model by Noriaki Kano (1984) classifying
features as Must-be (basic), Performance (linear), Attractive
(delighter), Indifferent or Reverse. Surveyed via paired
functional/dysfunctional questions; categories decay over time
(Delighter → Performer → Must-be).

Categories: strategic-planning, requirements-engineering.
Roles: product-owner, business-analyst, ux-designer, team-lead.

Closes LLM-Coding#459.
John P. Kotter's classic transformation framework from 'Leading
Change' (HBR 1995, book 1996): urgency, guiding coalition, vision,
communication, empowerment, short-term wins, consolidation, anchor
in culture. The 8 steps invert the 8 common errors Kotter identified
in failed transformations.

Categories: strategic-planning.
Roles: team-lead, consultant, product-owner, business-analyst.

Closes LLM-Coding#460.
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 8, 2026

Review Change Stack

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: 5354932a-1968-4ea1-a8d5-d69d7462d99a

📥 Commits

Reviewing files that changed from the base of the PR and between f85efce and 858260e.

⛔ Files ignored due to path filters (2)
  • website/package-lock.json is excluded by !**/package-lock.json
  • website/public/rabauer-logo.png is excluded by !**/*.png
📒 Files selected for processing (15)
  • docs/about.adoc
  • docs/about.de.adoc
  • docs/anchors/kano-model.adoc
  • docs/anchors/kano-model.de.adoc
  • docs/anchors/kotter-8-step-change-model.adoc
  • docs/anchors/kotter-8-step-change-model.de.adoc
  • docs/anchors/xy-problem.adoc
  • docs/anchors/xy-problem.de.adoc
  • docs/changelog.adoc
  • docs/spec-driven-workflow.adoc
  • docs/spec-driven-workflow.de.adoc
  • skill/semantic-anchor-translator/references/catalog.md
  • website/src/components/footer.js
  • website/src/translations/de.json
  • website/src/translations/en.json

Walkthrough

Das PR führt drei neue Semantic Anchors (XY Problem, Kano Modell, Kotter's 8-Stufen-Änderungsmodell) mit englischer und deutscher Dokumentation ein. Zusätzlich werden Katalogeinträge und Changelog aktualisiert, ein neuer rabauer.dev Footer-Link mit i18n-Unterstützung hinzugefügt, YouTube-Embeds auf der About-Seite aktualisiert und die Workflow-Dokumentation angepasst.

Changes

Neue Semantic Anchors

Layer / Datei(en) Zusammenfassung
XY Problem Dokumentation
docs/anchors/xy-problem.adoc, docs/anchors/xy-problem.de.adoc
Neue Dokumentationen für das XY Problem Konzept mit Kernideen (X vs. Y, Lösungsfixierung, Asker's Discipline), Anwendungsfällen und Verweisen auf Socratic Method, BLUF und Problem Space NVC in Englisch und Deutsch.
Kano Modell und Kotter Modell
docs/anchors/kano-model.adoc, docs/anchors/kano-model.de.adoc, docs/anchors/kotter-8-step-change-model.adoc, docs/anchors/kotter-8-step-change-model.de.adoc
Dokumentation für Kano's zweidimensionale Qualitätsrahmen mit fünf Kategorien (Must-be, One-dimensional, Attractive, Indifferent, Reverse) und Kotter's acht Transformationsschritte mit Fehler-Katalog in beiden Sprachen.
Katalog und Changelog
skill/semantic-anchor-translator/references/catalog.md, docs/changelog.adoc
Katalogeinträge für alle drei neuen Anchors mit Aliases und Beschreibungen sowie Changelog-Einträge für Veröffentlichungen am 2026-05-07 und 2026-05-08.

Website und Dokumentation Updates

Layer / Datei(en) Zusammenfassung
Footer Link und i18n Übersetzungen
website/src/components/footer.js, website/src/translations/en.json, website/src/translations/de.json
Neuer rabauer.dev Live-Coding-Session-Link in der Fußzeile mit englischer und deutscher i18n-Unterstützung für die Alt-Text-Beschriftung footer.rabauerAlt.
About Page YouTube Embeds
docs/about.adoc, docs/about.de.adoc
Aktualisierte YouTube-Facade-Elemente mit neuen Video-IDs (Englisch: Q_DWMayAQEQ), Thumbnails und aktualisierten Captions für Mai 2026 Live-Coding-Sessions auf beiden Sprachversionen.
Workflow Dokumentation
docs/spec-driven-workflow.adoc, docs/spec-driven-workflow.de.adoc
Aktualisierung der dokumentierten AI-generierten Projekte von drei auf vier, Hinzufügung des Bausteinsicht-Links (JSON-Architektur-Modell ↔ draw.io Synchronisation) und Verstärkung der "goldenen Regel".

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

  • LLM-Coding/Semantic-Anchors#446: PR modifiziert auch die About-Seite (docs/about.de.adoc) und Footer-Einträge für externe Links mit Übersetzungen.
  • LLM-Coding/Semantic-Anchors#388: PR modifiziert die gleiche Katalogdatei (skill/semantic-anchor-translator/references/catalog.md) mit neuen Anchor-Einträgen.
  • LLM-Coding/Semantic-Anchors#437: PR fügt neue Semantic-Anchor-Inhalte hinzu und aktualisiert die gleichen Dokumentations- und Katalogdateien (docs/changelog.adoc und catalog.md).
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Tip

💬 Introducing Slack Agent: The best way for teams to turn conversations into code.

Slack Agent is built on CodeRabbit's deep understanding of your code, so your team can collaborate across the entire SDLC without losing context.

  • Generate code and open pull requests
  • Plan features and break down work
  • Investigate incidents and troubleshoot customer tickets together
  • Automate recurring tasks and respond to alerts with triggers
  • Summarize progress and report instantly

Built for teams:

  • Shared memory across your entire org—no repeating context
  • Per-thread sandboxes to safely plan and execute work
  • Governance built-in—scoped access, auditability, and budget controls

One agent for your entire SDLC. Right inside Slack.

👉 Get started


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 c6f74a8 into LLM-Coding:main May 8, 2026
6 of 7 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.

Kano Modell [Anchor Proposal]: The XY Problem

2 participants