Claude Code Harness Lite : une petite structure pour changer sans dériver

La première erreur avec Claude Code dans un vrai dépôt n’est pas toujours un mauvais prompt. C’est de laisser l’agent toucher trop de choses avant d’avoir un cadre. Harness Lite est ce cadre minimum : lire, modifier, prouver, ouvrir l’URL publique, puis vérifier le CTA de revenus.

C’est la version débutante de Claude Code harness engineering. Sur un dépôt inconnu, combinez-la avec repo map first pass et permission receipt pattern pour garder un périmètre explicable.

Écrire la limite avant la tâche

Harness Lite ne rend pas Claude Code moins capable. Il rend le changement explicable. Avant la modification, il faut dire quels fichiers lire, quels fichiers éditer, quelles zones exclure, quelle commande prouve le résultat et quelle page publique contrôler après publication.

Sur un site de contenu ou de produits, l’ordre compte. L’article, le formulaire PDF gratuit, le lien Gumroad et la consultation sont souvent proches. Une petite modification de texte peut casser le chemin entre recherche, inscription, achat et prise de contact.

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"

Prompt de départ copiable

Je veux faire exactement un petit changement sûr dans ce dépôt.
Ne modifie pas encore les fichiers.
Retourne:
1. les fichiers à lire
2. les fichiers sûrs à modifier
3. les zones hors périmètre
4. la plus petite commande de preuve
5. les checks d'URL publique pour h1, canonical, hero image et CTA
6. les notes pour préserver PDF gratuit, Gumroad et consultation

Le bon geste consiste à demander une limite, pas une implémentation. Une fois la limite claire, la demande suivante peut être étroite : un changement, une commande de preuve et un reçu.

Transformer la preuve en petit objet

Après le changement, demandez à Claude Code de remplir un proof receipt. Le JavaScript ci-dessous est volontairement simple : il rend visible la définition minimale de terminé avant commit.

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 signifie que le seuil minimal avant commit est atteint

Cela repère les états inachevés : build réussi sans URL publique, 200 OK qui affiche le mauvais article, corps correct avec CTA Gumroad ou consultation vers la mauvaise destination.

Trois cas réels

• Pour un article Astro, limitez le périmètre à un MDX, une image hero et une page produit liée. Après déploiement, vérifiez h1, début du corps, canonical, formulaire PDF, bouton Gumroad et lien consultation.
• Pour un petit correctif React, gardez le composant ciblé, un test proche et une capture ou Storybook. Auth, billing, secrets et migrations restent hors du premier passage.
• Pour une adoption d’équipe, inscrivez dans CLAUDE.md les commandes sûres, zones protégées, format de reçu et note de rollback. La personne suivante ne repart pas de zéro.

Échecs fréquents

L’échec courant est de commencer par “vérifie et corrige tout”. Claude Code aide largement, le diff grossit et la preuve devient floue. Autre échec : prendre le build local pour une publication. Une route publique peut renvoyer HTTP 200 tout en montrant une page fallback ou un ancien article.

Le chemin de revenus peut aussi casser. Le corps recommande le PDF gratuit mais le CTA final envoie vers un autre produit. L’article multilingue n’explique pas que Gumroad est aujourd’hui surtout centré sur l’anglais. Le lien de consultation existe, mais le texte ne dit pas quand une session vaut mieux qu’un guide. Harness Lite met ces contrôles dans la tâche.

PDF gratuit, Gumroad et consultation

Utilisez le free cheatsheet si vous apprenez encore les commandes et habitudes sûres. Utilisez 50 Prompt Templates si vous répétez les prompts de review, debug et refactor. Utilisez le Setup Guide si permissions, CLAUDE.md, hooks, MCP ou CI/CD bloquent. Utilisez la consultation quand le workflow, l’équipe ou le revenu demandent du jugement.

Vérification de cet article

Cet article contient un objet de preuve, des liens internes vers harness, repo map et permission receipt, ainsi que le chemin PDF gratuit, Gumroad et consultation. Les prochains chiffres à suivre sont les inscriptions PDF, clics Gumroad et visites consultation depuis ce slug.

Note d’exploitation après publication

En production, ne terminez pas à “le fichier existe”. Le travail est terminé quand l’URL publique permet au lecteur de choisir l’étape suivante. En largeur mobile, vérifiez h1, début du corps, hero image, formulaire PDF gratuit, liens Gumroad et lien consultation. Si le corps est correct mais le CTA final vise le mauvais produit, le chemin de revenus reste incomplet.

Pour les articles localisés, le même slug ne suffit pas. Vérifiez le début du corps et le CTA en japonais, anglais, chinois, coréen, espagnol, français, allemand, portugais, hindi et indonésien. Un titre traduit avec corps ou CTA anglais est une localisation ratée, car le lecteur ne peut pas faire confiance à l’étape suivante.

Pour la prochaine amélioration, regardez plus que les PV. Mettez dans le même brief débuts d’inscription PDF, clics Gumroad, visites Products, visites Training, pays et source de recherche. Claude Code décide mieux quand les chiffres indiquent s’il faut renforcer l’actif gratuit, Prompt Templates, Setup Guide ou consultation.