Claude Code Repo-Audit-Checkliste vor der ersten Änderung

Die erste Claude-Code-Sitzung in einem bestehenden Repository sollte nicht mit einer Änderung beginnen. Sie sollte mit einer Karte beginnen. Der Agent liest schnell, aber Tempo hilft nur, wenn Einstiegspunkte, Schutzbereiche, Prüfbefehle und Geschäftswege klar sind.

Die Suchabsicht ist klar: Einsteiger wollen Claude Code in echtem Code nutzen, ohne Kontrolle zu verlieren. Noch geht es nicht um ein Feature, sondern um Scope, Risiko, Prüfung und Umsatz-CTA in 20 Minuten.

Weiterführende Artikel: claude-code-getting-started-complete, claude-code-existing-codebase-map, claude-code-harness-lite-workflow.

Warum dieses Muster vor die erste Änderung gehört

Claude Code ist am stärksten, wenn die Aufgabe klare Grenzen hat. Eine gute Grenze nennt lesbare Dateien, editierbare Dateien, verbotene Aktionen und den Nachweis, der die Arbeit beendet. Ohne diese Grenze kann ein kleiner Anfänger-Prompt zu einer großen Umschreibung werden, und eine Content-Änderung kann PDF, Gumroad oder Beratung beschädigen.

Dieses Muster hilft auch beim Umsatz, weil es technischen Nachweis mit Leser-Nachweis verbindet. Eine Seite, die lokal baut, aber Leser zum falschen Produkt schickt, ist nicht fertig. Wer Scope, Befehl, öffentliche URL und CTA notiert, verbessert morgen aus Belegen statt aus Erinnerung.

Praktischer Ablauf

1. Zuerst nur README, package.json und Routing-Einstiege lesen
2. generated, billing, auth, migrations und .env als geschützt markieren
3. Die erste editierbare Fläche auf maximal drei Dateien begrenzen
4. Vor jedem Patch einen Prüfbefehl wählen
5. Bei Content oder Landingpages auch PDF, Gumroad und Beratung prüfen

Situation	Sicherer Schritt	Nachweis
Astro-Content-Site	Vor einem Artikel collection, slug-Regeln, heroImage und CTA-Muster prüfen. Text und Bezahlroute gehören beide zum Audit.	build, diff, URL
React-Dashboard	Bei kleinem Layoutfehler nur Komponente, CSS und Screenshot prüfen. Auth und Billing bleiben geschützt.	screenshot, test
API-Repository	Zuerst Route und Testbefehl lesen. Migrationen und Secrets bleiben aus der ersten Aufgabe heraus.	log, command, handoff

Der erste Durchlauf bleibt kurz. Das Audit soll eine Entscheidung erzeugen, keinen Riesenbericht. Wenn nach 20 Minuten keine Entscheidung klar ist, liest man eine weitere Datei, statt mit Änderungen zu beginnen.

Kopierbarer Prompt und Code

Prüfe dieses Repository vor der ersten Änderung. Noch nichts bearbeiten. Gib Einstiegspunkte, Schutzbereiche, sichere Dateien, kleinsten Prüfbefehl sowie öffentliche URL- und CTA-Checks zurück.

const audit = {
  repo: "customer-portal",
  intent: "first safe Claude Code session",
  scope: ["README.md", "package.json", "src/routes"],
  protected: [".env", "billing/", "migrations/"],
  proof: ["npm.cmd run build", "git diff --stat"],
};

export function readyForFirstEdit(report) {
  return report.scope.length > 0 &&
    report.protected.length > 0 &&
    report.proof.some((command) => command.includes("build"));
}

console.log(readyForFirstEdit(audit));

Der Code ist absichtlich klein. Er macht aus einer Betriebsregel ein prüfbares Objekt: Scope existiert, Schutzbereiche existieren, ein Prüfbefehl ist verbunden. Die Form passt für Artikel, Apps, Debugging oder Team-Handoff.

Drei reale Beispiele

Astro-Content-Site

Vor einem Artikel collection, slug-Regeln, heroImage und CTA-Muster prüfen. Text und Bezahlroute gehören beide zum Audit.

Wichtig ist der Nachweis. Bewahren Sie einen Befehl, eine sichtbare Seite oder eine Notiz auf, die zeigt, dass die Arbeit den Leser erreicht hat.

React-Dashboard

Bei kleinem Layoutfehler nur Komponente, CSS und Screenshot prüfen. Auth und Billing bleiben geschützt.

Wichtig ist der Nachweis. Bewahren Sie einen Befehl, eine sichtbare Seite oder eine Notiz auf, die zeigt, dass die Arbeit den Leser erreicht hat.

API-Repository

Zuerst Route und Testbefehl lesen. Migrationen und Secrets bleiben aus der ersten Aufgabe heraus.

Wichtig ist der Nachweis. Bewahren Sie einen Befehl, eine sichtbare Seite oder eine Notiz auf, die zeigt, dass die Arbeit den Leser erreicht hat.

Fehlerfälle, die man vermeiden sollte

• Alles sofort reparieren zu lassen vermischt Audit und Umsetzung.
• Lokaler Build reicht nicht, wenn öffentliche URL oder CTA falsch zeigen.
• Ohne Schutzbereiche kann eine hilfreiche Änderung zum Incident werden.

Ein weiterer Fehler ist Lokalisierungsdrift. Der englische Artikel kann den richtigen Produktpfad erklären, während eine andere Sprache einen alten CTA behält. Darum prüft man öffentlich h1, Einstieg und CTA je Sprache, nicht nur frontmatter lang.

Leser zu PDF, Gumroad und Beratung führen

Wenn Leser noch Befehlssicherheit brauchen, passt das kostenlose Cheatsheet. Wenn Setup, Rechte, CLAUDE.md, Hooks, MCP oder CI/CD blockieren, ist der Setup Guide der beste nächste Kauf. Wer wiederholt Review-, Debugging- und Refactoring-Prompts schreibt, sollte 50 Prompt Templates nutzen. Für Team-Rollout, Workflow-Design oder Umsatzpfade ist Beratung sinnvoll. Einen Vergleich gibt es auf products.

Nicht jeder Leser soll sofort zum bezahlten Produkt. Anfänger brauchen oft zuerst ein reibungsarmes PDF. Wer Prompts wiederholt, ist näher an Templates. Wer bei permissions, CLAUDE.md, hooks, MCP oder CI/CD blockiert, ist näher am Setup Guide. Teams mit Prozessfragen sind näher an Beratung.

Was vor und nach der Veröffentlichung geprüft wird

Prüfung bedeutet hier mehr als HTTP 200. h1, Einstieg, heroImage, interne Links, Gumroad-Links und Beratungspfad müssen zur gleichen Leserabsicht passen.

Bei mehrsprachiger Veröffentlichung werden Japanisch, Englisch, Chinesisch, Koreanisch, Spanisch, Französisch, Deutsch, Portugiesisch, Hindi und Indonesisch einzeln geprüft. Der slug kann stimmen, obwohl der Text alt ist. Mobile Screenshots zeigen Einstieg und CTA gemeinsam.

Zahlen, die als Nächstes wichtig sind

Beobachten Sie PDF-Starts, Gumroad-Klicks, product-page visits, training-page visits, Suchquelle, Länder-Mix und Klickrate von Artikel zu CTA. Steigen PV ohne Gumroad-Klicks, muss der Produktfit stärker werden. Steigen Beratungsbesuche aus technischen Artikeln, braucht der Leser wahrscheinlich Workflow-Design.