~/blog/2015/06/technische-schulden-sichtbar-mache.md

Technische Schulden sichtbar machen

5 min
Titelgrafik: Technische Schulden sichtbar machen – Zinsen zahlt man immer

Keine Zeit? Hier die Kurzversion in 30 Sekunden.

  • Technische Schulden sind ein Bild von Ward Cunningham: Man nimmt eine Abkürzung und zahlt dafür Zinsen in Form von langsamerer Entwicklung.
  • Bewusste Schulden können vernünftig sein, unbewusste entstehen aus Unwissen und bleiben unsichtbar.
  • Sichtbar werden sie über eine Schuldenliste mit Zinsen-Beschreibung, mit Vorsicht eingesetzte Metriken, Boy-Scout-Rule und Refactoring im Zuge von Features.
  • Mit Nicht-Technikern spricht man über Risiken und Kosten, nicht über Code.

Es gibt Projekte, in denen jede Änderung ein bisschen länger dauert als die davor. Niemand kann genau sagen, warum. Der Code ist nicht kaputt, die Tests laufen meistens, und trotzdem fühlt es sich an, als würde man durch Sirup waten. In solchen Situationen taucht irgendwann das Wort „technische Schulden“ auf, oft als Seufzer. Ich finde den Begriff nützlich, aber nur, wenn man mehr damit macht, als ihn auszusprechen.

Woher der Begriff kommt

Ward Cunningham hat das Bild vor langer Zeit geprägt, 1992 in einem Erfahrungsbericht. Seine Idee war nicht, schlechten Code zu entschuldigen. Er beschrieb, dass man beim ersten Wurf ein Verständnis der Fachlichkeit einbaut, das später nicht mehr stimmt. Wenn man den Code dann nicht an das neue Verständnis anpasst, nimmt man eine Art Kredit auf: Es geht jetzt schneller, aber man zahlt Zinsen, solange der Code nicht zum Problem passt. Die Zinsen sind die Mehrarbeit bei jeder künftigen Änderung. Zahlt man nie zurück, frisst der Zins irgendwann die ganze Entwicklungszeit.

Das Bild ist deshalb gut, weil es zwei Dinge klarmacht. Erstens sind Schulden nicht per se schlecht. Ein Kredit, der ein Produkt rechtzeitig auf den Markt bringt, kann vernünftig sein. Zweitens hat jeder Kredit Zinsen, und die ignoriert man auf eigene Gefahr.

Bewusst und unbewusst

Martin Fowler hat das später sortiert und unterscheidet unter anderem bewusste und unbewusste Schulden. Bewusste Schulden entstehen, wenn man sich entscheidet: Wir verzichten jetzt auf die saubere Lösung, weil der Termin zählt, und räumen später auf. Das ist unbequem, aber ehrlich. Gefährlich ist, dass das „später“ oft nie kommt, wenn man es nirgends festhält.

Die unbewussten Schulden sind die tückischeren. Sie entstehen, weil man es nicht besser wusste, weil sich Anforderungen verschoben haben oder weil man eine Struktur gewählt hat, die erst ein Jahr später als unglücklich auffällt. Niemand hat sie aufgenommen, also steht auch keine Zahl auf einem Konto. Man merkt sie erst an den Zinsen.

Warum sie unsichtbar bleiben

Schulden bleiben unsichtbar, weil ihre Kosten verteilt anfallen. Eine Änderung dauert zwei Stunden länger, ein Fehler braucht einen halben Tag mehr zum Suchen, neue Leute im Projekt brauchen länger zum Einarbeiten. Nichts davon hat ein eigenes Etikett, das Ticket heißt trotzdem „Feld hinzufügen“. Dazu kommt, dass sich Menschen schnell an Zustände gewöhnen. Was am Anfang nervt, wird nach einem halben Jahr zur Normalität, und was Normalität ist, fällt nicht mehr auf.

Es gibt noch einen zweiten Grund: Fertige Features sieht jeder, aufgeräumten Code sieht niemand. Wer mit Fachbereichen oder Auftraggebern zu tun hat, kennt die Frage, warum etwas Zeit kostet, das nach außen nichts ändert. Solange die Schulden nicht greifbar sind, ist die Antwort schwach.

Greifbar machen

Was ich am hilfreichsten finde, ist banal: eine Liste. Jede bekannte Schuld kommt als Eintrag in den Backlog oder in eine eigene Übersicht, mit kurzer Beschreibung und, das ist der entscheidende Teil, mit den Zinsen. Nicht „Modul X ist schlecht“, sondern: „Jede Änderung an den Preisregeln erfordert Anpassungen an vier Stellen, was erfahrungsgemäß zu vergessenen Stellen und Nachbesserungen führt.“ Das lässt sich einschätzen und gegen andere Aufgaben abwägen. Ich schreibe mir gern auch eine Zeile zum Aufwand der Rückzahlung dazu, eine grobe Schätzung reicht.

Metriken können unterstützen, aber ich gehe vorsichtig damit um. Werkzeuge wie SonarQube sammeln Komplexität, Duplikate, Verstöße gegen Regeln und Testabdeckung an einem Ort und zeigen Entwicklungen über die Zeit. Das ist nützlich, um Auffälligkeiten zu finden. Sobald eine Zahl zum Ziel wird, verliert sie aber ihren Wert: Eine hohe Testabdeckung sagt nichts darüber, ob die richtigen Dinge getestet werden, und Tests, die nur geschrieben wurden, um die Zahl zu erreichen, kosten Pflege und schützen kaum. Ich sehe Metriken eher als Wetterbericht denn als Zielvorgabe: Sie verraten, wo man hinschauen sollte, nicht, was man tun muss.

Zurückzahlen im Alltag

Große Aufräumprojekte haben es schwer, genehmigt zu werden, und scheitern oft am Umfang. Realistischer ist es, kleine Rückzahlungen in den Alltag einzubauen. Die Boy-Scout-Rule, die Robert C. Martin populär gemacht hat, ist dafür eine hübsche Faustregel: Hinterlasse den Platz ein bisschen sauberer, als du ihn vorgefunden hast. Wer ohnehin an einer Stelle arbeitet, benennt eine verwirrende Variable um, zieht eine Methode auseinander oder löscht toten Code. Keine Großtat, aber über Monate summiert es sich.

Ähnlich funktioniert Refactoring im Zuge von Features. Wenn ein neues Feature an eine Stelle mit alten Schulden stößt, ist das der günstigste Moment zum Aufräumen, weil man den Code ohnehin gerade versteht und testen muss. Ich plane dafür gern gleich einen Anteil in der Schätzung ein, statt es als getrennte Aufgabe zu verhandeln. Die Voraussetzung sind brauchbare Tests, sonst wird aus dem Aufräumen ein Risiko. Und es gibt Schulden, die sich so nicht abtragen lassen, weil sie die Architektur betreffen. Die gehören auf die Liste, brauchen aber ein eigenes Vorhaben mit klarem Ziel.

Über Risiken reden, nicht über Code

Der vielleicht wichtigste Punkt betrifft die Sprache. Wer einem Auftraggeber erklärt, dass „die Klasse zu viele Abhängigkeiten hat“, bekommt freundliches Nicken und keine Zeit. Wer sagt, dass sich neue Tarife in diesem Bereich nur noch langsam und mit höherem Fehlerrisiko einbauen lassen, wird verstanden. Nicht-Techniker müssen keine Muster kennen, aber sie kennen Termine, Kosten und Ausfälle. Also übersetze ich Schulden in diese Währung: Was wird teurer, was wird langsamer, was kann schiefgehen, und was kostet es, das zu beheben?

Das hat einen angenehmen Nebeneffekt. Man wird gezwungen, die Schulden wirklich zu verstehen, statt sie nur zu fühlen. Manche Dinge, die sich unangenehm anfühlen, haben bei näherem Hinsehen kaum Zinsen, und die lässt man getrost, wie sie sind. Perfekter Code ist nicht das Ziel. Ziel ist, dass man weiß, wo man Kredit aufgenommen hat, und dass man es sich bewusst leisten kann.

Beitragsbild: eigene Grafik mit Logo von Wikimedia Commons (SonarQube-Logo: SonarSource, CC BY 3.0); die Marke gehört ihrem Inhaber.

$ whoami
Christian Ackermann

Softwareentwickler (C++, C, Java, C#) aus der Oberpfalz, bloggt seit 2001 über Linux, Technik und Kochen.