Claude Code Repo Map im ersten Durchlauf: vorhandenen Code sicher lesen

In einem unbekannten Repository ist der erste Fehler nicht schlechter Code. Der erste Fehler ist eine Implementierung, bevor Einstiegspunkte, Befehle, Risiken und kleinster Beweis bekannt sind.

Warum dieses Muster wichtig ist

Eine Repo-Map spart Kontext und schafft ein gemeinsames Betriebsdokument. Sie, ein Reviewer und die nächste Person müssen nicht dieselbe Struktur erneut erforschen. Für Einsteiger verbindet dieser Moment Gratis-PDF, Setup Guide und Beratung.

Weiterlesen: Weiterlesen 1, Weiterlesen 2, Weiterlesen 3.

Praktischer Ablauf

Verbieten Sie im ersten Prompt Änderungen. Claude Code soll README, Package-Daten, Routen, Tests und Deploy-Konfiguration lesen. Vor dem Ausführen trennen Sie sichere Befehle von riskanten Bereichen. Danach wählen Sie eine kleine Aufgabe mit schnellem Beweis ohne Auth oder Billing.

Kopierbares Minimalset

Read this repository for orientation only.
Do not edit files yet.
Return:
1. the main app entry points
2. the commands that appear safe to run
3. the files that define content, routes, and tests
4. three small first tasks ranked by verification cost
5. one risk that should block a larger change

repo_map:
  entry_points:
    - package.json
    - src/main.ts
  safe_commands:
    - npm run build
    - npm test
  first_task_rule:
    max_files: 3
    proof_required: true
    avoid_auth_and_billing: true

export function rankFirstTask(task) {
  const risk = task.touchesAuth || task.touchesBilling ? 10 : 0;
  const scope = task.filesChanged * 2;
  const proof = task.hasFastProof ? -3 : 4;
  return risk + scope + proof;
}

Echte Beispiele

Bei einer Astro-Seite zuerst src/content, src/pages, BlogPostLayout und Build-Befehl kartieren.
Bei SaaS auth, billing und migrations als Risiko markieren, dann mit README oder Tests beginnen.
Im Team die Repo-Map in CLAUDE.md zusammenfassen, damit die nächste Person direkt anschließen kann.

Operative Checkliste

Dieses Muster ist für wiederholte Claude-Code-Arbeit gedacht. Wenn Artikel, Produktseite oder Anfragepfad geändert werden, nutzen Sie die Liste als kompakten Kontrollpunkt.

Ziel in einem Satz notieren und Dateien oder Funktionen außerhalb des Scopes benennen.
Dateien trennen, die Claude Code lesen soll, von Dateien, die gemieden werden sollen.
Mindestens einen Nachweisbefehl hinterlassen. Bei Content zusätzlich die öffentliche URL prüfen.
Gratis-PDF, Gumroad und Beratung im Text und in der finalen CTA auf Konsistenz prüfen.
Bei lokalisierten Posts title, h1, Textanfang und CTA-Sprache prüfen.
Keine fremden Dirty Files stagen. Den Diff vor Commit erneut trennen, wenn nötig.
Restliches Risiko und nächste Kennzahl notieren, damit die nächste Session sauber startet.

Zu welchem Angebot führen

Wenn Leser noch unsicher mit Befehlen sind, ist das kostenlose Cheatsheet der erste Ausgang. Wiederholt sich der Ablauf wöchentlich, standardisieren Prompt Templates Review, Debugging und Artikelpflege. Bei permissions, CLAUDE.md, hooks, MCP oder CI/CD passt der Setup Guide. Wenn Teamverantwortung, öffentliche Prüfung und Umsatzpfad gestaltet werden müssen, führt der Weg zur Beratung.

Was ins Handoff gehört

Claude-Code-Arbeit ist nicht fertig, nur weil der Patch fertig aussieht. Sie ist erst nützlich, wenn die nächste Person die Entscheidung versteht, ohne die Session zu wiederholen. Das Handoff braucht Scope, Grund für den Scope, Prüfbefehle, öffentliche URL, CTA-Ziele und Rest Risiko. Bei Content gehören heroImage, interne Links, externe Links, Sprachprüfung sowie Gratis-PDF, Gumroad und Beratung im Text dazu. Bei produktnahen Seiten sollte auch klar sein, welcher Leser kostenlos startet, welcher einen Guide kauft und welcher Beratung braucht.

Welche Zahlen danach zählen

PV allein reicht nicht. Nach Veröffentlichung zählen Indexierung, Länder, Klicks an der finalen CTA, Gumroad-Klicks und Formularbesuche. Bei beliebten bestehenden Artikeln vergleichen Sie Bounce Rate und nächste Seite vor und nach der Änderung. Wenn die nächste Claude-Code-Session diese Zahlen zuerst sieht, entscheidet sie nach Umsatzpfad statt nur mehr Text zu schreiben.

Fehlerfälle

Mit einer Feature-Anfrage zu starten lässt Änderungen über Modulgrenzen laufen.
Ohne sichere Befehle bleibt unklar, welcher Nachweis zählt.
Ohne gespeicherte Map verschwendet die nächste Session Kontext für dieselbe Suche.

Pfad zu Gratis-PDF, Gumroad und Beratung

Starten Sie mit dem kostenlosen PDF für Befehlssicherheit. Nutzen Sie Gumroad bei wiederholbaren Abläufen und Beratung, wenn Team, Rechte oder Umsatzpfad gestaltet werden müssen.

Prüfnotiz

Der Artikel verlinkt bestehende Inhalte zu Codebase Map, Context Management und First Task Runbook und enthält CTAs zu Gratis-PDF, Gumroad und Beratung.