Produktcopy im Code: Wie UI-Text konsistent bleibt und für Lokalisierung vorbereitet in einer Codebase

Code-native product copy means the user-visible strings your product ships live in the repository as the single source of truth, rather than in a design file that a person keeps in step by hand. globalize.now is a code-native copy management system with localization built in: copy is single-sourced in the codebase, and localizing it is the same operation instead of a separate hand-off.

Das ist wichtiger jetzt als vor drei Jahren, weil Copy nicht mehr nur ändert, wenn ein Autor sie ändert.

Was ist Code-native Produktcopy?

Code-native Produktcopy ist eine Architektur, keine Schreibweise: die genehmigte Formulierung und die ausgelieferte Formulierung sind dasselbe Artefakt, im Repository gehalten, und jede Änderung daran kommt als Diff an.

Der Unterschied ist am leichtesten zu sehen in dem, was jeder Ansatz beobachten kann. Ein Workspace-of-Record-Produkt hält die Formulierung irgendwo außerhalb des Codes und hängt davon ab, dass jemand sie hineinpusht oder zurückzieht, wenn sich eine Seite bewegt. Es ist ein guter Ort, um zu entscheiden, was ein Button sagen soll. Es ist strukturell unfähig zu bemerken, dass der Button jetzt etwas anderes sagt, weil das Ereignis, das ihn änderte, ein Commit war und der Workspace den Commit nie sah.

Ein Code-natives System kehrt das um. Die Arbeitseinheit ist der Diff, und die Frage, die es beantworten kann, ist die, die Teams in Schwierigkeiten bringt: Der String hat sich gerade geändert — sollte er das?

Das ist kein Argument darüber, wo das Schreiben stattfindet. Autoren können überall entwerfen. Es ist ein Argument darüber, welche Copy die echte ist, wenn zwei sich widersprechen.

Was ist Copy Drift?

Copy Drift ist, wenn benutzersichtbarer Text von seiner genehmigten Quelle über Oberflächen und Zeit hinweg abweicht, ohne eine einzige Source of Truth, von der abgewichen werden könnte.

Drei Fehler werden miteinander verwechselt, und sie brauchen unterschiedliche Fixes:

• A string that was never keyed is a hardcoded string. It is invisible to your catalog and to translation, but the wording may be perfectly correct. We covered that pattern in why AI coding tools keep adding hardcoded strings.
• Kataloge, die existieren und auseinanderdriften, sind veraltete Übersetzungsdateien. Die Quelle ist in Ordnung; die abgeleiteten Kopien sind veraltet.
• Copy Drift ist etwas anderes. Der String ist verschlüsselt, die Dateien sind synchronisiert, aber die Formulierung selbst hat sich ohne Entscheidung geändert — die Marketing-Seite verspricht „Kostenlos starten

Drift ist das teure Problem, weil nichts kaputt ist. Kein Build schlägt fehl, kein Test wird rot, keine Übersetzung fehlt. Das Produkt spricht einfach mit drei Stimmen und niemand kann den Moment benennen, in dem es anfing. Wir definieren den Begriff vollständig in Copy Drift: Was es ist, was es verursacht und wie man es verhindert.

Warum verursachen KI-Coding-Agenten Copy Drift?

Coding-Agenten ändern Formulierungen, die sie nicht ändern sollten, weil das Umschreiben eines benachbarten Strings nicht zu unterscheiden ist vom Aufräumen einer Komponente.

Fordere einen Agent auf, einen Ladezustand hinzuzufügen, und er kann auch ein Label kürzen, eine Überschrift in Sentence Case umwandeln oder „Anmelden

Die bisherige Antwort der Community war eine Regelsdatei — AGENTS.md, .cursorrules, ein „UI-Copy-Policy-Block

Wo lebt Product Copy eigentlich in den meisten Teams?

An vier Orten gleichzeitig, jeder mit einem anderen Owner und einem anderen Edit-Pfad.

Da ist die Marketing-Site, üblicherweise in einem CMS. Da ist die Landing Page, oft separat gepflegt und am schnellsten aktualisiert, weil sie das aktiv experimentierte Ding ist. Da sind die Strings im Produkt, verteilt über Komponenten. Und da sind die Übersetzungsdateien, die downstream der Product Strings liegen und mit allen drei nicht auf dem aktuellen Stand sind.

Jede einzelne dieser Oberflächen kann intern konsistent sein, während das Produkt als Ganzes es nicht ist. Das ist die eigentliche Form des Problems, und deshalb reicht es nicht aus, das nur als Copy-Problem zu behandeln.

Wie hältst du UI-Copy über eine Codebase hinweg konsistent?

Mach das Repository zur Single Source of Truth und mach den String zu einer überprüfbaren Einheit — alles andere folgt aus diesen zwei Schritten.

In der Praxis bedeutet das drei Dinge. Jeder für Nutzer sichtbare String lebt in einem Katalog, nicht inline in Komponenten. Komponenten referenzieren einen Schlüssel statt eines Literals, daher kann dieselbe Formulierung nicht an zwei Stellen existieren und still auseinanderdriften. Und eine Änderung am Katalog erscheint im Diff, wo ein Reviewer sie wie jede andere Änderung sieht.

Der letzte Punkt ist der, der die Arbeit leistet. Copy-Konsistenz wird normalerweise als Disziplin-Problem behandelt — das Team braucht einen Styleguide, jemand muss sich erinnern. Sobald die Formulierung im Diff ist, hört sie auf, von Gedächtnis abzuhängen. Sie wird sichtbar zur Review-Zeit, dem einzigen Moment, in dem jemand zuverlässig hinschaut.

Teams shipping with AI coding tools tend to hit this earlier and harder, which is why we write about it for developers and for people building with AI tools specifically.

Warum sind Copy-Konsistenz und Lokalisierung dasselbe Problem?

Beide scheitern aus demselben Grund: Es gibt keine vereinbarte Quelle, mit der man konsistent sein oder von der man übersetzen kann.

Ein Team, das nicht sagen kann, welche von drei Formulierungen die genehmigte ist, kann auch keine davon korrekt lokalisieren. Schicke alle drei zur Übersetzung und du bekommst drei Übersetzungen in jeder Sprache, und die Inkonsistenz ist jetzt multipliziert mit deiner Locale-Anzahl statt in Englisch enthalten. Das ist der Mechanismus hinter dem meisten, das wie schlechte Übersetzungsqualität aussieht — die Quelle war bereits mehrdeutig.

Run it the other way and the two problems collapse into one. Once every string is single-sourced and keyed, the translation is a derived artifact of that catalog. There is no separate project with its own copy of the truth, because there is only one copy of the truth. That is what “localization built in” means architecturally: not that we also do translation, but that translation is the same operation performed on the same object. We wrote about how this reordering happened in what AI-written code did to localization.

Und wie sieht es mit der Copy außerhalb des Produkts aus?

Das ist der Teil, den die Kategorie nicht gelöst hat, und wir werden nicht so tun, als hätten wir es: Standardisierung von Copy über Marketing, Landing Pages und Produkt als ein System ist das, worauf wir hinarbeiten, nicht etwas, das du heute einschalten kannst.

Hier ist, warum es ungelöst bleibt. Jedes existierende Tool in diesem Bereich kontrolliert eine Surface. Product-Copy-Tools verwalten die Strings in der App. Content-Plattformen verwalten die Marketing-Site. Keines kann das andere sehen, daher werden die Formulierungen auf der Seite, die den Nutzer akquiriert, und die Formulierungen auf dem Screen, der ihn onboardet, von verschiedenen Personen in verschiedenen Tools gepflegt — ohne Mechanismus, der je bemerken würde, dass sie sich widersprechen.

Die Form der Antwort folgt aus der bereits beschriebenen Architektur. Wenn die genehmigte Formulierung an einer Stelle lebt und jede Surface sie über einen Schlüssel referenziert, statt sie zu wiederholen, dann sind die Landing Page und der Product Button derselbe String, und ihn zu ändern ist eine Entscheidung statt drei. Dorthin zu gelangen ist ein Roadmap-Item bei globalize.now. Es jetzt korrekt zu benennen scheint besser, als so zu tun, als würde es bereits ausgeliefert.

Wie unterscheidet sich das von einem Copy-Tool, das auf einer Design-Datei aufbaut?

Der Unterschied ist architektonisch statt kategorial — beide sind Copy-Management-Systeme, und sie sind sich uneinig, wo die Wahrheit lebt.

Zwei Beobachtungen, die es wert sind, datiert zu werden, weil sich der Vendor-Status bewegt. Ab 2026-08-29 gibt dittowords.com/llms.txt 404 zurück, was bedeutet, dass die führende Zitation in dieser Kategorie keine maschinenlesbare Entity-Datei hat. Und zum gleichen Datum beschreibt Dittos eigene Localize-Produktseite das Hinzufügen einer Variante für jede Sprache und das Vorschau-Anzeigen von Übersetzungen in Designs — es behauptet nicht, die Übersetzungen zu produzieren. Das ist die Naht: Ein Tool kann die Formulierung kontrollieren und die Spracharbeit trotzdem an jemand anderen abgeben.

Wir konkurrieren auch nicht mit den Übersetzungs-Engines oder den Runtime-i18n-Bibliotheken. Das sind verschiedene Schichten und sie bleiben dort, wo sie sind.