Workflow Obsidian vers CLAUDE.md avec Claude Code

Si votre vault Obsidian contient les notes de travail mais que chaque session Claude Code recommence par la même explication, il y a un trou entre gestion de connaissance et implémentation. Ce workflow transforme les notes libres en contexte CLAUDE.md concis.

Les lecteurs venant d’Obsidian ne cherchent pas seulement une intégration. Ils veulent que les notes améliorent la qualité d’exécution. La réponse n’est pas d’envoyer tout le vault, mais d’extraire décisions actuelles, contraintes et commandes de preuve.

À lire aussi: claude-code-obsidian-integration, claude-code-claude-md-starter-template, claude-md-best-practices.

Pourquoi ce cadre doit précéder la première modification

Claude Code est plus fiable quand la tâche a une frontière claire. Une bonne frontière nomme les fichiers lisibles, les fichiers éditables, les opérations interdites et la preuve qui termine le travail. Sans cela, un petit prompt débutant peut devenir une grande réécriture, et un changement de contenu peut casser le PDF gratuit, Gumroad ou la consultation.

Ce cadre aide aussi le revenu car il relie preuve technique et preuve lecteur. Une page qui build en local mais envoie le lecteur vers le mauvais produit n’est pas terminée. En enregistrant scope, commande, URL publique et CTA, on améliore demain depuis une preuve, pas depuis la mémoire.

Workflow pratique

1. Dans Obsidian, séparer faits, décisions, questions ouvertes et prochaines actions
2. Chaque semaine, extraire seulement le contexte utile à Claude Code
3. Mettre les règles stables dans CLAUDE.md et l’état temporaire dans un handoff
4. Pour le contenu, inclure décisions CTA et règles de routing produit
5. Supprimer les décisions périmées pour garder le contexte léger

Situation	Action sûre	Preuve
Ops contenu	Obsidian sert à penser intention, produit et CTA. CLAUDE.md garde seulement les règles récurrentes de revenus.	build, diff, URL
Équipe engineering	L’historique complet reste dans Obsidian, Claude Code reçoit règles actuelles et zones interdites.	screenshot, test
Debugging	L’historique d’hypothèses reste en notes, la session suivante reçoit faits vérifiés et prochaine commande.	log, command, handoff

La première passe doit rester courte. L’audit doit produire une décision, pas un rapport géant. Si la décision reste floue après 20 minutes, l’étape sûre est de lire un fichier de plus, pas de commencer à modifier.

Prompt et code copiables

Lis cette note Obsidian et sépare règles pour CLAUDE.md, état temporaire de handoff et informations périmées à ne pas recopier.

const note = {
  title: "Checkout copy bug",
  facts: ["mobile CTA wraps", "Gumroad link still works"],
  decisions: ["keep paid CTA after free PDF"],
  commands: ["npm.cmd run build"],
};

export function toClaudeMdBlock(item) {
  return [
    "## Current operating note",
    `- Topic: ${item.title}`,
    `- Facts: ${item.facts.join("; ")}`,
    `- Decisions: ${item.decisions.join("; ")}`,
    `- Proof command: ${item.commands[0]}`,
  ].join("\n");
}

console.log(toClaudeMdBlock(note));

Le code est volontairement petit. Il transforme une règle d’exploitation en objet vérifiable: un scope existe, des zones protégées existent et une commande de preuve est attachée. Vous pouvez l’adapter à la publication, au développement, au debug ou au handoff.

Trois exemples réels

Ops contenu

Obsidian sert à penser intention, produit et CTA. CLAUDE.md garde seulement les règles récurrentes de revenus.

Le point important est la preuve. Gardez une commande, une page visible ou une note qui montre que le travail a réellement atteint le lecteur.

Équipe engineering

L’historique complet reste dans Obsidian, Claude Code reçoit règles actuelles et zones interdites.

Le point important est la preuve. Gardez une commande, une page visible ou une note qui montre que le travail a réellement atteint le lecteur.

Debugging

L’historique d’hypothèses reste en notes, la session suivante reçoit faits vérifiés et prochaine commande.

Le point important est la preuve. Gardez une commande, une page visible ou une note qui montre que le travail a réellement atteint le lecteur.

Échecs à éviter

• Donner tout le vault mélange anciennes décisions et contraintes actuelles.
• Transformer CLAUDE.md en journal cache les règles importantes.
• Garder les décisions CTA seulement en notes décale article et produit.

Un autre échec discret est le drift de localisation. L’article anglais peut expliquer le bon chemin produit, tandis qu’une autre langue garde un ancien CTA. La vérification publique doit donc lire h1, début du corps et CTA dans chaque langue, pas seulement frontmatter lang.

Relier le lecteur au PDF, à Gumroad et à la consultation

Si le lecteur manque encore d’aisance avec les commandes, orientez-le vers le cheatsheet gratuit. Si le blocage concerne setup, permissions, CLAUDE.md, hooks, MCP ou CI/CD, le meilleur produit est le Setup Guide. Pour des prompts de review, debug et refactor répétés, proposez 50 Prompt Templates. Pour un déploiement d’équipe, un workflow ou une route de revenus, utilisez la consultation. La comparaison des offres se fait sur products.

Ne poussez pas immédiatement chaque lecteur vers un produit payant. Les débutants ont souvent besoin d’un PDF sans friction. Les lecteurs qui répètent des prompts sont proches des templates. Ceux bloqués par permissions, CLAUDE.md, hooks, MCP ou CI/CD sont proches du Setup Guide. Les équipes avec des questions de process sont proches de la consultation.

Ce qu’il faut vérifier avant et après publication

La vérification ne se limite pas au HTTP 200. Il faut lire le h1, le début du corps, l’image hero, les liens internes, les liens Gumroad et le chemin de consultation.

Pour publier en plusieurs langues, vérifiez séparément japonais, anglais, chinois, coréen, espagnol, français, allemand, portugais, hindi et indonésien. Le slug peut correspondre alors que le corps est ancien. Une capture mobile révèle plus vite le paragraphe d’ouverture et le CTA.

Chiffres à suivre ensuite

Surveillez les démarrages PDF, clics Gumroad, visites products, visites training, source de recherche, pays et taux clic article vers CTA. Si les PV montent sans clic Gumroad, il faut renforcer l’adéquation produit. Si la consultation monte depuis un article technique, le lecteur cherche sans doute un workflow.