Technische Schulden mit Claude Code sichtbar machen und systematisch abbauen

„Wir wollen refaktorieren, haben aber nie Zeit.” „Wo sollen wir überhaupt anfangen?” Technische Schulden wachsen im Stillen. Mit Claude Code können Sie Schulden systematisch sichtbar machen, priorisieren und tilgen – zu einem Bruchteil der üblichen Kosten.

1. Code Smells im gesamten Codebase aufspüren

Beginnen Sie mit einem vollständigen Durchlauf.

claude -p "
Durchsuche src/ nach Code Smells. Prüfe:

- Funktionen mit mehr als 50 Zeilen
- Tiefe Verschachtelung (4+ Ebenen)
- Duplizierte Logik
- God Classes (überladene Verantwortlichkeiten)
- Magic Numbers
- Ungenutzte Exports
- Verwendung von any-Typ
- TODO / FIXME Kommentare

Ausgabe in docs/tech-debt/smells.md als:
| Datei | Zeile | Smell | Schweregrad(1-5) | Vorgeschlagene Lösung |
"

Ein nach Schweregrad sortiertes Inventar wird Ihr Ausgangspunkt.

2. Abhängigkeitsschulden messen

Veraltete Bibliotheken und Sicherheitslücken sind ebenfalls Schulden.

claude -p "
Analysiere package.json sowie npm audit und npm outdated:

1. Bibliotheken mit nötigen Major-Updates
2. Bekannte Sicherheitslücken
3. Nicht gewartete Pakete
4. Duplikate (z. B. moment + date-fns gemischt)

Ausgabe in docs/tech-debt/dependencies.md mit aktueller Version, neuester, Breaking Changes, Update-Priorität – als Tabelle.
"

3. Mit ICE-Scores priorisieren

Sie können nicht alles beheben. Bewerten Sie nach Impact × Confidence × Ease.

claude -p "
Bewerte anhand von docs/tech-debt/smells.md und dependencies.md jeden Eintrag:

- Impact (I): Auswirkung auf Business/Entwicklungsgeschwindigkeit (1-10)
- Confidence (C): Sicherheit der Auswirkung (1-10)
- Ease (E): Aufwand zur Behebung (1-10)

Sortiere absteigend nach Score = I × C × E.
Ausgabe als docs/tech-debt/backlog.md.
Füge geschätzte Personentage für die Top 10 hinzu.
"

Numerische Scores machen das Argument gegenüber Product Managern klar.

4. Kleine Tilgungs-PRs automatisch erzeugen

Teilen Sie die Tilgung in überprüfbare PRs auf.

claude -p "
Für den Eintrag #1 in docs/tech-debt/backlog.md:

1. Erstelle Branch: refactor/tech-debt-001
2. Behebe nur dieses Problem (kein Verhaltensänderung)
3. Verifiziere, dass bestehende Tests bestehen
4. Teile bei Bedarf in mehrere Commits auf
5. Führe gh pr create aus

Der PR-Body soll enthalten:
- Worum es bei der Schuld ging
- Warum jetzt tilgen
- ICE-Score
- Auswirkungsradius auf anderen Code
"

5. Ungetestete Hotspots identifizieren

Bereiche mit geringer Abdeckung werden zu zukünftigen Schulden.

npm test -- --coverage --coverageReporters=json

claude -p "
Analysiere coverage/coverage-summary.json:

- Dateien unter 50 % Coverage
- Welche davon Business-Logik enthalten
- Priorität für das Hinzufügen von Tests

Ausgabe in docs/tech-debt/coverage-gaps.md.
Schlage Testfälle für die Top-3-Dateien vor.
"

Kombinieren Sie dies mit Test-Autogenerierung für einen multiplizierenden Effekt.

6. Tilgung mit wöchentlichen Berichten sichtbar machen

Ohne Sichtbarkeit geben Teams auf.

claude -p "
Berichte über den Tech-Debt-Abbau der letzten Woche:

- Erledigte Einträge (prüfe docs/tech-debt/backlog.md)
- Neu entdeckte Schulden
- Offene Einträge mit Schweregrad 5
- Fortschritt bei Abhängigkeits-Updates

Ausgabe in docs/tech-debt/weekly-report-$(date +%Y-%m-%d).md.
Optimiert für eine 5-minütige Standup-Präsentation.
"

Per Cron Montagmorgens ausführen, um die Tilgung zu institutionalisieren.

7. Neue Schulden am Einlass stoppen

Tilgung ist sinnlos, wenn der Zufluss anhält. Kodifizieren Sie Regeln in CLAUDE.md.

## Regeln zur Vermeidung neuer technischer Schulden

### Verboten
- Neue any-typisierte Werte (verwende // @ts-expect-error mit Begründung, wenn unvermeidbar)
- Workaround-Logik ohne TODO
- Business-Logik ohne Tests

### PR-Checkliste
- [ ] Coverage neuen Codes ≥ 80 %
- [ ] Null ESLint-Fehler
- [ ] Hinzugefügte Abhängigkeiten im PR begründet

### Akzeptable Ausnahmen
- Hotfixes (mit Follow-up-Ticket)
- POC-Code (muss vor der Produktion umgeschrieben werden)

Erzwingen Sie dies via Pre-Commit-Hooks. Siehe Hooks-Leitfaden.

Anti-Patterns

❌ Ein riesiger Refactor-PR

PRs, die „alles beheben”, sind nicht überprüfbar. Ein Smell = ein PR.

❌ Verhaltensänderungen vermischen

Kombinieren Sie niemals Feature-Arbeit mit Refactoring im selben PR. Der Review-Aufwand verdoppelt sich.

❌ Refactoring ohne Tests

Bei geringer Coverage gilt: Erst Tests schreiben, dann refaktorieren. Kein Sicherheitsnetz bedeutet neue Bugs.

Fazit

• Nutzen Sie Claude Code, um Smells, Abhängigkeitsschulden und Coverage-Lücken sichtbar zu machen
• Quantifizieren Sie die Priorität mit ICE-Scoring
• Teilen Sie die Tilgung in kleine PRs auf
• Veröffentlichen Sie wöchentliche Fortschrittsberichte
• Blockieren Sie neue Schulden durch CLAUDE.md-Regeln
• Ein Smell = ein PR

Technische Schulden sind nichts, was man „irgendwann” beheben sollte. Sie sind etwas, das man jede Woche ein wenig tilgen sollte. Claude Code reduziert die Kosten dieses Rhythmus drastisch.

Verwandt: Refactoring-Automatisierung / Legacy-Code-Modernisierung / Code-Review-Checkliste

Offizielle Dokumentation: Anthropic Claude Code