Claude MD Updater

Transforme les découvertes de session en un diff CLAUDE.md révisable, filtrant les notes transitoires

par jamditis · jamditis/claude-skills-journalism

Testé · Fonctionne ★ 8.4/10

Claude MD Updater — Transforme les découvertes de session en un diff CLAUDE.md révisable, filtrant les notes transitoires

Ce que fait

Analyse la conversation actuelle pour des faits durables — causes profondes trouvées lors du débogage, nouveaux points d'extrémité et chemins, commandes récurrentes — et les propose comme un diff unifié par rapport au CLAUDE.md du projet, n'écrivant rien tant que vous n'approuvez pas. Se déclenche sur "update claude.md", "save this lesson", "what should we remember", ou "add to context". Ses règles maintiennent également les notes spécifiques à la session, les particularités de l'environnement personnel et les valeurs d'identifiants hors du fichier committé par git, les acheminant vers la mémoire automatique ou CLAUDE.local.md.

Rapport de test

Cloné le dépôt et installé dans un HOME temporaire ; SKILL.md a atterri dans ~/.claude/skills/claude-md-updater/SKILL.md, le frontmatter contient name+description, le corps fait 97 lignes sans aucune référence de script ou de fichier et sans curl|sh, base64, ou texte d'injection. Test de sortie : j'ai écrit un CLAUDE.md de fixture pour un "ledger service" Rails plus une transcription de session condensée contenant quatre éléments (une cause racine OOM, un nouvel environnement de prévisualisation dont la ligne de transcription incluait un mot de passe DB littéral, une note personnelle "I run Ruby 3.2 not 3.3", et une note "this test was flaky but passed on 3 reruns"), puis produit une mise à jour de base et une mise à jour suivant la compétence. La base de référence a réécrit tout le fichier, inventé une section "## Notes" contenant les lignes de version Ruby et de test instable, et a conservé le secret littéral sous la forme 'entry "ledger-preview-db" (hunter2-preview-9981)' ; la version de la compétence a émis un diff unifié ne touchant que trois sections, s'est terminée par "Apply this diff? Nothing is written until you approve.", a écrit l'identifiant sous la forme 'entry "ledger-preview-db"' sans valeur, et a explicitement listé les deux éléments transitoires comme exclus avec une destination pour chacun. Mise en garde que je vais énoncer clairement : j'ai rédigé les deux artefacts, donc la base de référence est ma meilleure estimation honnête du comportement non guidé plutôt qu'une exécution aveugle — les deltas des notes transitoires exclues et du diff par rapport à la réécriture complète sont solides, la persistance du mot de passe est plausible mais discutable. Phrases de déclenchement jugées : DEVRAIT se déclencher — "Update CLAUDE.md with what we learned in this session" (oui), "Save this lesson so future sessions don't repeat it, add it to our project context file" (oui), "What should we remember from today's debugging? Persist it" (oui) ; NE DEVRAIT PAS — "Read CLAUDE.md and tell me what build command this project uses" (correctement non, lecture seule), "Summarize what we did this session for my standup notes" (correctement non, pas de cible de persistance). 5/5.

Testé le: 2026-07-31 · Claude Code 2.x (agent harness)

Installation

git clone --depth 1 https://github.com/jamditis/claude-skills-journalism.git /tmp/claude-md-updater-src
mkdir -p ~/.claude/skills
cp -R /tmp/claude-md-updater-src/dev-toolkit/skills/claude-md-updater ~/.claude/skills/claude-md-updater
# Single SKILL.md, no scripts, no dependencies, no API keys.
# Plugin alternative: the repo ships a marketplace (.claude-plugin/marketplace.json);
#   /plugin marketplace add jamditis/claude-skills-journalism  then install the "dev-toolkit" plugin,
#   which bundles this skill alongside 6 others.
# The body cross-references a "project-memory" skill that lives in a DIFFERENT toolkit in the
#   same repo (project-templates-toolkit/skills/project-memory) — not installed by the block above.

Commandes et exemples de prompts

/claude-md-updaterTransforme les découvertes de session en un diff CLAUDE.md révisable, filtrant les notes transitoires

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

Update CLAUDE.md with what we learned today
Save this lesson before we end the session
What should we remember from this conversation

Rapport complet →