Wird geladen

Claude Code Plan-Modus als Standard-Ausgangspunkt

Lektion 46 Min.

Ingenieure starten Claude-Code-Sitzungen im Plan-Modus, geben Claude die genehmigte spec.md aus Stufe 2: Design und lassen sie sich interviewen, wobei der Plan so lange überarbeitet wird, bis sie damit zufrieden sind.

Was sich ändert

TraditionellKI-nativ
Ein Ingenieur liest das Design und beginnt mit dem Schreiben von Code. Wie die Änderung vorgenommen wird, bis hin zu welchen Dateien und welchen Tests, bleibt im Kopf des Ingenieurs oder bestenfalls in einem Ticket-Kommentar. Niemand sonst kann es überprüfen. Das Erste, was ein Reviewer sieht, ist der fertige Diff, und bis dahin ist Nacharbeit langsam.Die Arbeit beginnt mit einem schriftlichen Plan, den Claude im Plan-Modus erstellt, wo es die Codebasis lesen kann, ohne etwas zu ändern. Der Ingenieur korrigiert den Plan, bevor Code geschrieben wird, und die genehmigte Version wird als plan.md committet, damit spätere Stufen sie überprüfen können.

Erste Schritte

  • Voraussetzungen: Das Intent-Artefakt (intent.md oder spec.md), sofern vorhanden, und die Datei CLAUDE.md helfen.
  • Infrastruktur: Claude Code mit Zugriff auf das Repository.

Wie man es umsetzt

  1. Der Ingenieur startet die Sitzung im Plan-Modus mit Claude.
  2. Der Ingenieur gibt Claude die intent.md und die spec.md und bittet um einen Implementierungsplan, der die zu ändernden Dateien, die Reihenfolge der Arbeit und die Tests, die dies belegen, benennt.
  3. Befrage den Plan, indem du fragst, was die Änderung kaputt machen könnte, welcher Schritt am riskantesten ist und welche anderen Optionen Claude nicht gewählt hat.
  4. Iteriere, bis ein Ingenieur, der die Unterhaltung nie gesehen hat, die Änderung allein anhand des Plans umsetzen könnte.
  5. Committe den genehmigten Plan als plan.md. Der Plan wird Teil des Audit-Trails, und das PR-Review-Play (Stufe 5: Deploy) prüft den endgültigen Diff dagegen.
  6. Akzeptiere den Plan und lass Claude implementieren. Mit einem soliden Plan ist die Implementierung oft ein einziger Durchgang.
  7. Wenn die Implementierung vom Plan abweicht, aktualisiere plan.md im selben Commit. Erwäge, einen Hook zu verwenden, um die Synchronisierung zwischen beiden zu erzwingen.

So sieht es aus

Der folgende Plan ist für eine Änderung bei einem Versicherer: ein Panel im Kundenportal, das den Status eines Schadensfalls anzeigt. Das Panel ruft das Backend des Portals auf, claims-api, das von claims-core, einem älteren internen System, liest.

plan.md:

markdown
# Plan: claims status self-service (from intent.md and spec.md)

## Files that change

portal/src/claims/StatusPanel.tsx (new), claims-api/routes/status.py, claims-api/tests/test_status.py

## Order of work

1. Add the status endpoint behind existing auth (R1, R2, R3).
2. Panel against the endpoint, with the 60-second cache (R1, R4).
3. Wire into the portal nav.

## Risks

The claims-core API rate-limits at 50 rps; the panel must cache (spec concern 3).

## Proof

test_status.py covers the four claim states (R2) and fails on any extra field (R3); screenshot matches the approved mock.

R1 bis R4 sind die nummerierten Anforderungen in spec.md, und Bedenken 3 ist ein Risiko, auf das spec.md hingewiesen hat. Da der Plan sie zitiert, kann ein Reviewer den Plan Zeile für Zeile gegen die Spec prüfen.

Governance-Überlegungen

Das Design-Review findet statt, bevor Code generiert wird, zu einem Zeitpunkt, an dem ein Kurswechsel noch eine Frage des Bearbeitens eines Dokuments ist. Der Plan-Modus erzwingt dies von selbst, da Claude keine Dateien bearbeiten kann, bis der Ingenieur den Plan akzeptiert. Der Plan und seine Überarbeitungen werden zusammen mit der Person protokolliert, die ihn akzeptiert hat. Routinemäßige Änderungen werden vom Ingenieur genehmigt, und alles, was die Organisation als höheres Risiko einstuft, geht an einen Tech Lead oder Architekten.

So misst man es

  • Frühindikator: Anteil der Änderungen, die aus dem ersten Implementierungsdurchgang gemergt werden, und die Zeit von der Plan-Genehmigung bis zum gemergten PR mit den erforderlichen Daten innerhalb der PR-Metadaten.
  • Spätindikator: Nacharbeitszyklen pro Änderung, wiederum aus den PR-Metadaten, und wie oft der gemergte Diff noch mit der committeten plan.md übereinstimmt.

Claude Code im Auto-Modus

Claude Code kann auch im Auto-Modus laufen, bei dem der Ingenieur den Plan überarbeitet und genehmigt, und Claude dann jede Änderung ohne Aufforderung pro Edit anwendet. Mit der Reifung der Leitplanken aus den späteren Plays (eine abgestimmte CLAUDE.md, Skills, die Richtlinien kodieren, Hooks, die unsichere Aktionen blockieren, und eine Testsuite, die Claude ausführen kann) wird der Auto-Modus zum Standard für Routinearbeiten: eine enge spec.md, ein kleiner Explosionsradius und Code, den die Tests bereits abdecken.

Die Verschiebung geht nun weg davon, dass der Nutzer dem Agenten beim Vornehmen der Änderungen zusieht und Aktionen überprüft, hin zur Überprüfung von Artefakten nach längeren autonomen Sitzungen. Der Auto-Modus ermöglicht darüber hinaus Parallelität über Einzelpersonen und das Team hinweg, wenn er mit Worktrees verwendet wird, und ist grundlegend dafür, den SDLC autonom auszuführen und den Kreis zu schließen, wie in Stufe 6: Maintain beschrieben.

Legacy-Systeme und die Single Source of Truth

Bestehende SDLC-Prozesse verfolgen Artefakte wahrscheinlich bereits, nur nicht in Markdown-Dateien. Arbeitselemente können in Jira liegen, Anforderungen in einem Tool mit eingebauter regulatorischer Nachverfolgbarkeit, Designs in Figma und Änderungsgenehmigungen bei einem Change Board. Diese Systeme sind schwer zu verdrängen, weil Prüfer und Regulierungsbehörden sie bereits akzeptieren und andere Teams von ihnen abhängen, sodass sich der KI-native SDLC an das Bestehende anpassen muss. Für jedes Artefakt, das der Prozess erzeugt, sollte ein System als Single Source of Truth benannt werden, und die anderen halten eine Kopie oder einen Link.

Du kannst die folgenden Konfigurationen einrichten, um eine einzige Single Source of Truth zu haben, wobei die Wahl je nach Artefakt unterschiedlich ausfällt:

  • Das Repo als Single Source of Truth. Die Markdown-Artefakte sind der maßgebliche Datensatz, und das Legacy-System verweist auf Dateien innerhalb von Commits. Dies kann eine der saubersten Konfigurationen für technikgeführte Organisationen sein, da alle Aufzeichnungen in einem Tool mit einer einzigen Zeitstempelautorität liegen.
  • Das Legacy-System ist die Wahrheit. Jira, ServiceNow oder das Anforderungstool enthält den maßgeblichen Datensatz, und die Markdown-Artefakte sind Arbeitskopien. Claude liest den Datensatz zu Beginn der Sitzung und schreibt das Ergebnis über einen Model-Context-Protocol-(MCP-)Konnektor in derselben Sitzung zurück, in der die Spec oder der Plan erstellt wurde.
  • Verknüpfung als Mindestmaß. Alle Artefakte vermerken die Datensatz-ID, und alle Legacy-Datensätze enthalten die Commit-SHA der Markdown-Datei. Die Verknüpfungsoption ist ein guter Startpunkt beim Übergang zum KI-nativen SDLC, da es zwei Single Sources of Truth gibt.

Sowohl das Legacy-System als auch das KI-native, Markdown-first-System können koexistieren, solange es eine Verknüpfung zwischen beiden gibt oder eines als Single Source of Truth erklärt wird.