Kurzdefinition

Die Gesamtheit der Objekte, die ein Entwicklungsteam bereitstellt, damit ein Dritter – Mensch oder Assistent – auf der Codebase produzieren kann, ohne ihre Funktionsweise erraten zu müssen: Katalog interner APIs, wiederverwendbare Komponenten, Konventionen, abgesicherte Umgebungen, automatische Kontrollen, Anweisungsdateien und Skills.

Ausführliche Definition

Im allgemeinen Sprachgebrauch heißt „Leitplanken setzen“, verhindern, dass jemand von der Straße abkommt: Das Wort gehört zum Wortschatz der Schutzvorkehrung und bezeichnet eine Grenze, die man jemandem auferlegt, dem man misstraut.

In den Artikeln dieses Blogs behält der Begriff diese Bedeutung, geht aber nicht darin auf, und die zweite Bedeutung ist die wirksamere: Eine Leitplanke zeigt ebenso den Weg, wie sie verhindert, dass man ihn verlässt. Ein Katalog interner APIs sagt, was man aufrufen soll, eine Zuordnung zwischen Fachbegriffen und technischen Einstiegspunkten sagt, wohin man gehen soll, wiederverwendbare Oberflächenkomponenten ersparen den Nachbau. Was man gewinnt, wenn man sie setzt, ist nicht in erster Linie Sicherheit, sondern Zeit – die Zeit, die der Assistent mit Suchen verbringen würde, mit dem falschen Einstieg oder mit dem Neuschreiben dessen, was es schon gibt.

Leitplanken zeichnen sich also durch ihre Adressaten aus: Sie dienen nicht dem, der sie schreibt, sondern denen, die danach produzieren.

Gebrauch im Feld

Der Begriff kommt bei der Abwägung von Investitionen in Plattformen ins Spiel und in der Diskussion darüber, eine Codebase für Nicht-Entwickler zu öffnen. Mit ihm lässt sich die Frage anders stellen als unter dem Gesichtspunkt der Erlaubnis: nicht „Wer darf produzieren?“, sondern „Was ist vorbereitet, damit Produzieren möglich ist?“.

Synonyme und Varianten

„Interne Plattform“, „Fundament“, „Golden Path“ im Vokabular des Platform Engineering. Das Wort Leitplanken bleibt weiter gefasst: Es umfasst auch die Anweisungsdateien und Skills für Assistenten, die das Plattformvokabular nicht abdeckt.

Nicht zu verwechseln mit

• Schutzvorrichtung — eine Vorkehrung, deren einzige Funktion es ist, eine gefährliche Handlung zu verhindern. Eine Sicherheitsprüfung in der Continuous Integration ist eine Schutzvorrichtung; sie gehört zu den Leitplanken, aber die Leitplanken gehen nicht in ihr auf.
• Directive — eine schriftliche Regel, die eine Arbeitsweise für einen Agenten festhält. Eine Direktive ist eine der möglichen Leitplanken, in Form eines Textes, den der Assistent liest.
• Dokumentation — Text, den ein Mensch liest, um etwas zu verstehen. Manche Leitplanken sind Dokumentation, andere sind ausführbare Objekte: Komponenten, Umgebungen, Kontrollen.

Beispiele

Eine Umgebung, in der ein Product Manager interne Oberflächen, Abfragewerkzeuge, Listen oder Diagramme zusammensetzt und sich dabei auf dokumentierte und abgenommene APIs stützt, während die gesamte technische Infrastruktur von den Entwicklern gebaut wurde.

Mehrdeutigkeiten / Debatten

Das Wort wird fast immer im einschränkenden Sinn verstanden, und genau deshalb gehen die Abwägungen verloren: Als Schutz dargestellt, werden Leitplanken gegen einen Liefertermin verhandelt. Die Spannung zwischen beiden Bedeutungen ist im allgemeinen Gebrauch nicht aufgelöst; hier wird sie zugunsten der doppelten Bedeutung entschieden.