Onboarding-Zeit neuer Entwickler mit Claude Code drastisch verkürzen

Die Einarbeitungszeit neuer Entwickler ist in jedem Unternehmen ein riesiger Kostenfaktor. Riesige Codebasen, verstreute Dokumentation, implizites Wissen. Wenn Sie Claude Code zum Copilot der neuen Mitarbeiter machen, schrumpft die 3-monatige Einarbeitung auf 2 Wochen.

1. Entwicklungsumgebung in einem halben Tag einrichten

Das Setup ist die erste Hürde. Statt ständig Senior-Entwickler via Slack anzuschreiben:

# Neuer Mitarbeiter führt das auf seinem Mac aus
claude -p "
Führe mich durch die Einrichtung der Entwicklungsumgebung für dieses Repo
(https://github.com/our-org/main-app) unter macOS.

Für jeden Schritt:
1. Benötigte Tools (mit Versionen)
2. Installationsbefehle
3. Zu konfigurierende Umgebungsvariablen
4. Wie man prüft, ob es läuft
5. Häufige Fehler und Lösungen

Lies .env.example und README; sei konkret.
"

Slack-DMs an Senioren sinken drastisch.

2. Codebasis in 5 Minuten erfassen

Riesige Repos werden verdaulich.

claude -p "
Erkläre die Gesamtstruktur dieses Repos:

1. Verzeichnisaufbau und Zweck jedes Ordners
2. Haupt-Einstiegspunkte
3. Datenfluss (wie eine Anfrage verarbeitet wird)
4. Externe Integrationen (DB, APIs, Queues)
5. Fünf Dateien, die ich zuerst lesen sollte

Schlage außerdem eine Lesereihenfolge vor, die es einem
neuen Mitarbeiter ermöglicht, innerhalb einer Woche mit dem Code zu arbeiten.
"

Kombiniert mit Codebase-Navigation für maximale Wirkung.

3. Implizites Wissen in Dokumentation verwandeln

Legen Sie das “Warum ist das so?” offen, das nur Veteranen kennen.

claude -p "
Leite für src/services/billing/LegacyInvoiceService.ts
aus git log --follow + blame ab:

1. Warum das Design so geworden ist
2. Fallstricke beim Ändern (historische Bug-Muster)
3. Verwandte Services
4. Was vor einer Änderung doppelt zu prüfen ist

Ausgabe nach docs/onboarding/legacy-notes.md
in einem Format, das Teamkollegen leicht ergänzen können.
"

Nutzen Sie die Ausgabe als Diskussions-Thread in GitHub Discussions — das treibt review-getriebene Dokumentation voran.

4. Erste PR-Kandidaten automatisch vorschlagen

Kleine, sichere Aufgaben für neue Mitarbeiter finden.

claude -p "
Schlage 5 erste-PR-Kandidaten aus diesem Repo vor:

Kriterien:
- Isolierte Änderungen (geringe Nebenwirkungen)
- Vorhandene Tests decken den Bereich ab
- Keine Kern-Geschäftslogik
- Diff-Umfang 30-100 Zeilen

Schau dir good-first-issue Trends,
TODO/FIXME Kommentare und kleinere Refactoring-Kandidaten an.
Für jeden: geschätzter Aufwand und was er lehrt.
"

5. Selbst-Review vor dem PR-Absenden

Reduziert Rückläufer bei neuen Mitarbeitern.

claude -p "
Prüfe git diff origin/main...HEAD.
Selbst-Review als neuer Mitarbeiter vor dem Öffnen des PRs:

1. Verstöße gegen CLAUDE.md-Regeln
2. Seltsame Benennungen
3. Fehlende Tests
4. Stilinkonsistenzen mit bestehendem Code
5. Sicherheitsbedenken

Liste nur Punkte auf, die geändert werden müssen, mit Priorität.
"

Review-Schleifen brechen ein. Siehe Code Review mit Claude.

6. “Zuerst Claude fragen”-Kultur

Halten Sie das in CLAUDE.md fest.

## Onboarding Q&A Leitfaden

### Zuerst Claude Code fragen
- Wie der Code funktioniert
- Bedeutung von Fehlermeldungen
- Design-Begründungen (via git log + blame)
- Tool-Nutzung

### Nur an Slack #dev-help eskalieren bei
- Interpretation von Geschäftsregeln
- Priorisierungs-Entscheidungen
- Zugriffs-beschränkten Aufgaben

### Bei Fragen an Senioren einschließen
1. Was du erreichen willst
2. Was du versucht hast (inkl. Claudes Antwort)
3. Wo du feststeckst

Allein das senkt Unterbrechungen von Senioren um ~30 %.

7. Wöchentliche Retrospektiven automatisch generieren

Für 1:1s mit dem Mentor.

claude -p "
Fasse meine Aktivität der letzten Woche zusammen:

- git log --author='new-hire-name' --since='1 week ago'
- Erstellte PRs + Status
- Trends im Review-Feedback
- Wo ich feststeckte (aus Commit-Messages abgeleitet)

Schlage 3 Themen für das Mentor-1:1 vor.
"

Neue Mitarbeiter bekommen eine Meta-Sicht auf ihr eigenes Wachstum.

Anti-Patterns

❌ Alles Claude überlassen

Claude leitet implizites Wissen nur ab. Verifizieren Sie geschäftliches “Warum” immer mit menschlichen Domain-Experten.

❌ Fragen zu stark unterbinden

Ein überzogenes “frag Claude” isoliert neue Mitarbeiter. Planen Sie in den ersten 2 Wochen intensive 1:1s ein.

❌ Doku-Pflege vernachlässigen

Von Claude generierte Notizen zu implizitem Wissen verrotten, wenn sie liegen bleiben. Regelmäßige Team-Reviews.

Fazit

• Umgebung in einem halben Tag selbst aufsetzen
• Codebasis in 5 Minuten verstehen
• Implizites Wissen in Doku verwandeln
• Erste PR-Kandidaten automatisch vorschlagen
• PR-Rückläufer durch Selbst-Review reduzieren
• Senior-Unterbrechungen via “Claude first”-Kultur senken
• Wöchentliche Retros automatisch generieren

Schnellere Einarbeitung = weniger Mentorenlast + mehr Team-Durchsatz.

Verwandt: Codebase-Navigation / Code Review / Team-Zusammenarbeit

Offizielle Docs: Anthropic Claude Code