Claude Code Harness Lite: ein kleiner Sicherheitsrahmen für erste Änderungen

Der erste Fehler mit Claude Code in einem echten Repository ist selten nur ein schlechter Prompt. Häufig darf der Agent zu viel tun, bevor der Rahmen steht. Harness Lite ist dieser kleinste Rahmen: lesen, ändern, belegen, öffentliche URL öffnen und den Umsatz-CTA prüfen.

Das ist die Einsteigerfassung von Claude Code harness engineering. In einem unbekannten Repository passt sie gut zu repo map first pass und permission receipt pattern, damit der Umfang erklärbar bleibt.

Grenze vor Aufgabe schreiben

Harness Lite macht Claude Code nicht schwächer. Es macht die Änderung erklärbar. Vor der Umsetzung werden Dateien zum Lesen, Dateien zum Ändern, ausgeschlossene Bereiche, Beweiskommando und öffentliche Prüfseite festgelegt.

Bei Content- und Produktseiten ist diese Reihenfolge wichtig. Artikel, Gratis-PDF-Formular, Gumroad-Link und Beratung liegen oft nah beieinander. Eine kleine Textänderung kann den Weg von Suche zu Registrierung, Kauf oder Anfrage unterbrechen.

harness_lite:
  owner: "Masa"
  scope:
    allowed:
      - "read repository"
      - "edit selected files"
      - "run build or test"
    blocked:
      - "delete unrelated files"
      - "touch secrets"
      - "hide failed verification"
  proof:
    - "git diff reviewed"
    - "build command recorded"
    - "public URL opened"
    - "CTA path checked"

Kopierbarer Start-Prompt

Ich möchte genau eine kleine sichere Änderung in diesem Repository machen.
Ändere noch keine Dateien.
Gib zurück:
1. Dateien, die du lesen musst
2. Dateien, die sicher editierbar sind
3. Bereiche außerhalb des Umfangs
4. kleinstes Beweiskommando
5. öffentliche URL-Checks für h1, canonical, hero image und CTA
6. Hinweise zum Schutz von Gratis-PDF, Gumroad und Beratung

Der wichtige Schritt ist die Grenze, nicht die Implementierung. Wenn sie klar ist, kann die nächste Anfrage eng bleiben: eine Änderung, ein Beweiskommando, ein Receipt.

Beweise als kleines Objekt erfassen

Nach der Änderung soll Claude Code ein Proof Receipt ausfüllen. Das folgende JavaScript ist bewusst einfach und macht die minimale Commit-Bedingung sichtbar.

const proof = {
  goal: "change one small thing",
  filesChanged: 2,
  commands: ["npm run build"],
  publicUrlChecked: true,
  ctaChecked: true,
};

export function isReadyToCommit(receipt) {
  return receipt.filesChanged <= 3 &&
    receipt.commands.length > 0 &&
    receipt.publicUrlChecked &&
    receipt.ctaChecked;
}

console.log(isReadyToCommit(proof)); // true bedeutet: minimale Commit-Schwelle erreicht

So werden halbfertige Zustände sichtbar: Build erfolgreich, aber öffentliche URL nicht geöffnet; 200 OK, aber falscher Artikel; richtiger Text, aber Gumroad- oder Beratungs-CTA zeigt falsch.

Drei reale Beispiele

• Bei einem Astro-Artikel bleibt der Umfang bei einer MDX-Datei, einem Hero-Bild und einer passenden Produktseite. Nach Deploy werden h1, Textanfang, canonical, PDF-Formular, Gumroad-Button und Beratung geprüft.
• Bei einem kleinen React-Fix bleiben Zielkomponente, naher Test und Screenshot oder Storybook im Umfang. Auth, Billing, Secrets und Migrationen bleiben draußen.
• Bei Team-Einführung gehören sichere Befehle, geschützte Bereiche, Receipt-Format und Rollback-Notiz in CLAUDE.md. Die nächste Person startet mit denselben Regeln.

Häufige Fehler

Der häufige Fehler lautet: “Prüfe und repariere alles.” Claude Code hilft breit, der Diff wächst und der Beweis wird unklar. Ein zweiter Fehler ist lokaler Build als Veröffentlichung. Eine öffentliche Route kann HTTP 200 liefern und trotzdem Fallback oder alten Artikel zeigen.

Auch Umsatzpfade brechen. Der Text empfiehlt das Gratis-PDF, aber der CTA am Ende führt zu einem anderen Produkt. Der mehrsprachige Artikel erklärt nicht, dass Gumroad aktuell vor allem der englische Self-Serve-Pfad ist. Es gibt einen Beratungslink, aber keine Erklärung, wann ein Call besser ist als ein Guide. Harness Lite hält diese Checks in der Aufgabe.

Gratis-PDF, Gumroad und Beratung

Nutzen Sie das free cheatsheet, wenn Befehle und sichere Gewohnheiten noch neu sind. Nutzen Sie 50 Prompt Templates, wenn Review-, Debug- und Refactor-Prompts sich wiederholen. Nutzen Sie den Setup Guide, wenn Berechtigungen, CLAUDE.md, Hooks, MCP oder CI/CD blockieren. Nutzen Sie Beratung, wenn Workflow, Team oder Umsatzpfad Urteil brauchen.

Was geprüft wurde

Dieser Artikel enthält ein ausführbares Proof-Objekt, interne Links zu Harness, Repo Map und Permission Receipt sowie den Pfad zu Gratis-PDF, Gumroad und Beratung. Die nächsten Zahlen sind PDF-Starts, Gumroad-Klicks und Beratungsbesuche von diesem Slug.

Betriebsnotiz nach Veröffentlichung

In Produktion endet die Arbeit nicht bei “Datei existiert”. Fertig ist sie erst, wenn die öffentliche URL dem Leser den nächsten Schritt klar zeigt. Prüfen Sie mobil h1, Textanfang, hero image, Gratis-PDF-Formular, Gumroad-Links und Beratung. Wenn der Text stimmt, aber der End-CTA zum falschen Produkt führt, ist der Umsatzpfad nicht fertig.

Bei lokalisierten Artikeln reicht gleicher Slug nicht aus. Prüfen Sie Textanfang und CTA für Japanisch, Englisch, Chinesisch, Koreanisch, Spanisch, Französisch, Deutsch, Portugiesisch, Hindi und Indonesisch. Nur die Überschrift zu übersetzen, während Text oder CTA Englisch bleiben, ist fehlgeschlagene Lokalisierung.

Für den nächsten Durchlauf zählen nicht nur PV. Legen Sie PDF-Starts, Gumroad-Klicks, Products-Besuche, Training-Besuche, Länder und Suchquelle in dasselbe Briefing. Claude Code entscheidet besser, wenn die Zahl zeigt, ob Gratis-Asset, Prompt Templates, Setup Guide oder Beratung gestärkt werden sollen.