NCA Social Media
Aktualisiert:
Autor:
Roland Golla
Grünes Banner Ubiquitous Language zwischen zwei Figuren

Ubiquitous Language: Definition und Einordnung

Ubiquitous Language ist die gemeinsame Sprache von Fachbereich und Entwicklung. Jeder Begriff hat genau eine Bedeutung und taucht unverändert im Gespräch, im Ticket, im Test und im Quelltext auf.
Der Nutzen zeigt sich in der Übersetzungsarbeit, die wegfällt. Wenn der Fachbereich von einer Stornierung spricht und im Code eine Methode cancelOrder mit einem Statusfeld auf 7 steht, übersetzt jedes Teammitglied bei jedem Gespräch neu. Diese Übersetzung kostet Zeit und produziert Missverständnisse.
Ubiquitous Language ist der erste Baustein von Domain Driven Design und gilt immer innerhalb eines Bounded Context. Eine Sprache für das gesamte Unternehmen ist kein Ziel, sondern ein Warnzeichen.

Inhalt

Ubiquitous Language mit NCA: Schnelle Hilfe vom Experten

Wir arbeiten seit über zwanzig Jahren an Systemen, in denen Begriffe historisch gewachsen sind. Never Code Alone moderiert die Klärung und bringt sie danach in den Code: Klassennamen, Methodennamen, Testnamen. Unsere Basis dafür ist täglicher Betrieb mit Symfony, Sulu CMS und einer Testsuite aus PHPUnit und Cypress.
Der Weg führt über Werkzeuge, die Sprache sichtbar machen: Rector für konsistente Umbenennungen im gesamten Projekt, PHPStan für Typen, die Bedeutung tragen, Deptrac für die Grenzen, in denen eine Sprache gilt. Wie Begriffe in KI Anweisungen wirken, ordnen wir bei Vibe Coding Consulting ein.
Begriffe klären mit NCA
Finde das passende Angebot für dein Projekt
Anfrage-Konfiguration
Starten Sie Ihre Anfrage
Projektart
Infos
Nachricht

Eliminierung technischer Schulden mit PHPStan, Rector PHP und PHPUnit. Über 20 Jahre Praxiserfahrung in skalierbaren Backends.

CORE EXPERTISE

Gesetzliche Konformität & Inklusion. Optimierung von Performance und Conversion durch radikal nutzerzentriertes, universelles Design.

BFSG COMPLIANT

Skalierbare KI-Systeme mit echtem Code Ownership. CI/CD, Backup-Strategien und Infrastruktur, die mit deinem Team wächst.

ENTERPRISE READY

So entsteht eine gemeinsame Sprache

Eine Ubiquitous Language wird nicht definiert, sie wird gefunden. Der beste Startpunkt ist ein Gespräch über einen echten Ablauf, nicht über Klassen.
  • Zuhören: Welche Wörter benutzen die Fachleute von selbst? Diese Wörter sind Kandidaten.
  • Nachfragen: Meint jeder dasselbe? Wenn zwei Personen zögern, steckt dahinter meistens ein fehlender Begriff.
  • Festhalten: Eine kurze Liste mit Begriff und Bedeutung reicht. Sie lebt im Repository, nicht im Wiki, das niemand öffnet.
  • Übernehmen: Der Begriff wandert in Klassen, Methoden und Tests. Erst dann ist er echt.
  • Korrigieren: Passt ein Wort nicht mehr, wird umbenannt. Sprache, die nicht gepflegt wird, verfällt.
Der wichtigste Moment ist der Widerspruch. Sagt ein Fachexperte, das heißt bei uns anders, ist das kein Detail, sondern ein Fund. Fast immer steckt dahinter ein Unterschied im Modell, der bisher niemandem aufgefallen ist.

Sprache im PHP Code sichtbar machen

Der Unterschied zwischen technischer und fachlicher Sprache lässt sich an einer einzigen Methode zeigen. Technisch korrekt ist beides, verständlich nur eines.
Code: 
          
// technisch gedacht
$bestellung->setStatus(7);
$bestellung->setFlag('cx', true);

// fachlich gedacht
$bestellung->stornieren(new Stornogrund('Kunde hat abgesagt'));
Die zweite Variante beantwortet eine fachliche Frage, ohne dass jemand in die Dokumentation schaut. Sie erzwingt außerdem einen Grund, weil eine Stornierung ohne Grund im Geschäft nicht vorkommt. Das Modell verhindert damit einen Zustand, den ein Statusfeld problemlos zulassen würde.
Dieselbe Sprache gehört in die Tests. Ein Testname wie storniert_bestellung_mit_grund liest sich wie eine Regel und lässt sich einem Fachexperten vorlesen. PHPUnit und Functional Tests werden so zur lebenden Beschreibung des Geschäfts.
Für konsistente Umbenennungen im laufenden Projekt hilft Rector. Eine Umbenennung über hunderte Dateien wird damit zum Skript statt zur Handarbeit, und PHPStan zeigt sofort, was übersehen wurde.

Klare Begriffe machen KI Anweisungen besser

Wer mit einem Coding Agent arbeitet, merkt schnell, wo die Sprache unklar ist. Ein Auftrag wie ändere die Stornologik funktioniert nur, wenn im System eindeutig ist, was eine Stornierung bedeutet. Gibt es drei Varianten mit drei Namen, rät das Modell.
Eine gepflegte Begriffsliste im Repository ist damit doppelt wertvoll. Menschen lesen sie beim Onboarding, Agents bekommen sie als Teil der Projektregeln. Beide arbeiten danach mit denselben Wörtern, und Ergebnisse werden vergleichbar.
Die Grenze bleibt klar: Modelle schlagen Namen vor, die Bedeutung legt der Fachbereich fest. Ein Agent kann eine Umbenennung ausführen, aber er kann nicht entscheiden, ob ein Auftrag im Unternehmen eine Bestellung oder ein Vorgang ist. Mehr dazu in den Vibe Coding Best Practices.

Typische Stolpersteine bei der gemeinsamen Sprache

Stolperstein Woran man ihn erkennt Was hilft
Englisch gegen Deutsch Fachbegriff deutsch, Klassenname englisch übersetzt Fachbegriffe im Original lassen, auch im Code
Ein Wort, zwei Bedeutungen Dauernde Rückfragen in Reviews Grenze ziehen und je Kontext eigenen Begriff nutzen
Glossar ohne Code Liste im Wiki, Code heißt weiter anders Begriffe direkt umbenennen, mit Rector automatisiert
Technische Namen Status 7, Flag cx, Manager Klassen Fachliche Methoden mit Absicht statt Setter

Listen to the language the domain experts use.

Eric Evans, Autor von Domain Driven Design – Domain-Driven Design: Tackling Complexity in the Heart of Software

Die NCA Erfahrung mit Begriffen in gewachsenen Projekten

In alten Systemen steckt die Sprache meistens in Statusfeldern und Abkürzungen. Wir holen sie heraus, bevor umbenannt wird. Churn PHP zeigt die Stellen mit der höchsten Änderungsrate, DePHPend die Abhängigkeiten dahinter. Dort lohnt sich Klarheit zuerst.
Umbenennen ohne Netz ist riskant. Deshalb stehen Characterization Tests und Symfony KernelTestCase vorher, Infection zeigt, ob diese Tests wirklich greifen. Danach übernimmt Rector die mechanische Arbeit und Easy Coding Standard hält das Ergebnis einheitlich.
Grenzen und Sprache gehören zusammen. Wer den Schnitt sucht, findet ihn oft genau dort, wo ein Begriff kippt. Die passenden Bausteine dazu stehen bei Bounded Context und Anti Corruption Layer, weitere Werkzeuge im NCA PHP Glossar.
CYPRESS.IO Ambassador und IT Consultant für QA Engenieering und Qualität in PHP Projekten.

Erreichen Sie unsere PHP Consultant Spezialisten

Wir sind Experten für PHP und helfen Ihnen, Ihre digitalen Herausforderungen zu meistern. Unser erfahrenes Team unterstützt Sie bei PHP Updates, PHP Refactoring und berät Sie remote zu allen Fragen rund um PHP. Mit unseren vollautomatischen CI/CD Deployments und einer robusten Docker-Infrastruktur bringen wir Ihre PHP-Projekte auf das nächste Level. Vertrauen Sie auf unsere Expertise für zuverlässige und skalierbare PHP-Lösungen.

Demo Team Workshop Anrufen

Häufige Fragen zu Ubiquitous Language

Die Fragen, die beim Thema gemeinsame Sprache regelmäßig kommen, kurz beantwortet.

Was ist Ubiquitous Language 2026 einfach erklärt?

Ubiquitous Language ist die gemeinsame Sprache von Fachbereich und Entwicklung. Jeder fachliche Begriff hat genau eine Bedeutung und steht unverändert im Gespräch, im Ticket, im Test und im Code. Dadurch entfällt die ständige Übersetzung zwischen Fachsprache und technischer Sprache, die sonst in jedem Meeting neu stattfindet.

Wie startet ein Team 2026 mit einer gemeinsamen Sprache?

Mit einem Gespräch über einen echten Ablauf statt über Klassen. Die Begriffe, die Fachleute von selbst benutzen, sind die Kandidaten. Sie werden kurz mit ihrer Bedeutung festgehalten, am besten im Repository neben dem Code. Danach wandern sie Schritt für Schritt in Klassen, Methoden und Testnamen.

Warum hilft eine klare Sprache 2026 bei KI Agents?

Weil ein Modell den Kontext bekommt, mit dem es arbeitet. Sind Begriffe eindeutig, versteht der Agent den Auftrag ohne Raten. Eine gepflegte Begriffsliste im Repository dient Menschen beim Onboarding und Agents als Teil der Projektregeln. Die Bedeutung selbst legt weiterhin der Fachbereich fest.

Deutsch oder Englisch im Code 2026?

Fachbegriffe bleiben in der Sprache des Fachbereichs. Wird im Unternehmen von einer Mahnstufe gesprochen, heißt die Klasse Mahnstufe und nicht DunningLevel. Technische Begriffe bleiben englisch. Diese Mischung wirkt zuerst ungewohnt, verhindert aber genau die Übersetzungsfehler, die später teuer werden.

Wie hält man die Sprache 2026 dauerhaft sauber?

Durch Pflege im Alltag. Passt ein Begriff nicht mehr, wird umbenannt statt ergänzt. Rector macht Umbenennungen über hunderte Dateien zum Skript, PHPStan zeigt übersehene Stellen. Wichtig ist die Gewohnheit im Review: Wer einen unklaren Namen sieht, fragt nach, statt ihn zu übernehmen.

Was ist der Unterschied zu einem Glossar?

Ein Glossar ist eine Liste, eine Ubiquitous Language ist gelebte Praxis. Der Unterschied zeigt sich im Code. Steht ein Begriff im Wiki, aber die Klasse heißt anders, existiert die Sprache nicht. Erst wenn Gespräch, Ticket, Test und Quelltext dasselbe Wort benutzen, ist der Zustand erreicht.

Gilt eine Sprache für das ganze Unternehmen?

Nein, und das ist kein Mangel. Eine Ubiquitous Language gilt innerhalb eines Bounded Context. Vertrieb und Buchhaltung dürfen unter Kunde etwas anderes verstehen, solange die Grenze klar ist und an der Übergabe bewusst übersetzt wird. Eine Sprache für alles endet in Begriffen, die nichts mehr bedeuten.

Wie geht man mit Abkürzungen aus dem Altsystem um?

Sie werden aufgelöst, sobald man weiß, wofür sie stehen. Oft kennt nur noch eine Person die Bedeutung, was allein schon ein Risiko ist. Bis zur Umbenennung hilft ein Anti Corruption Layer, der die alten Kürzel an der Grenze in verständliche Begriffe übersetzt.

Was tun, wenn der Fachbereich selbst uneinig ist?

Das ist der wertvollste Fund überhaupt. Uneinigkeit über ein Wort zeigt fast immer zwei unterschiedliche Sichten auf denselben Vorgang. Statt sich auf einen Kompromissbegriff zu einigen, lohnt die Frage, ob hier zwei Bereiche mit eigenen Modellen aufeinandertreffen.

Wie viel Aufwand steckt in der Umbenennung?

Weniger als erwartet, wenn Tests und statische Analyse vorhanden sind. Rector führt die Umbenennung mechanisch durch, PHPStan und die Testsuite zeigen die Lücken. Ohne diese Basis wird es Handarbeit mit Risiko. Dann lohnt es sich, zuerst die Absicherung zu bauen und erst danach umzubenennen.

Gehört die Sprache auch in die Datenbank?

Ja, mit Augenmaß. Tabellen und Spalten mit fachlichen Namen ersparen jedem, der später eine Auswertung schreibt, die Suche im Code. Bei laufenden Systemen geschieht die Umstellung über Parallel Change, damit alte und neue Struktur eine Zeit lang nebeneinander bestehen können.

Wie begleitet NCA die Einführung?

Wir moderieren die Klärung der Begriffe zusammen mit dem Fachbereich und bringen das Ergebnis danach in den Code, abgesichert mit Tests und statischer Analyse. Jede Zusammenarbeit beginnt mit einem kostenlosen Kennenlernen, danach schätzen wir den Aufwand ein und rechnen transparent minutengenau ab.