INFO::pcClaudeMdGenerator modifié par Claude
De wiki_pcwiki2
KEYWORDS: PCCLAUDEMDGENERATOR, CLAUDE
Le 21/07/2026:
pcClaudeMdGenerator
Version : V1.16.0
Date : 2026-07-20
Langage : C++17 (g++), Boost.program_options
Fonctionnement
pcClaudeMdGenerator génère des fichiers CLAUDE.md pour
Claude Code, par analyse statique d'un projet C++ (CMakeLists.txt,
classes .h / .hpp / .cpp).
Déroulé du traitement :
- Repère le(s) produit(s) à traiter dans
projet_root:- si
projet_rootcontient des sous-répertoires versionnés
- si
(ex.MonProjet/V1.13,MonProjet/V1.14…), traite automatiquement la dernière version de chaque sous-répertoire versionné trouvé ;
- sinon traite
projet_rootlui-même (ou son
- sinon traite
sous-répertoire src/ s'il n'a pas de sources directement).
- Pour chaque produit :
- analyse
CMakeLists.txt(nom, version, standard C++, libs) ; - scanne
includes/ include/ inc/ headers/ src/(ou la racine
- analyse
si aucun de ces dossiers n'existe) à la recherche des classes/structs C++ ;
- liste les fichiers de
config/(*.yaml,
- liste les fichiers de
*.yml,*.json) ;
- génère
CLAUDE.md(etCLAUDE.jsonavec
- génère
-j) dans le produit ;
- régénère
compile_commands.json; - versionne ces fichiers générés dans git (
git initsi
- régénère
besoin, commit uniquementCLAUDE.md/CLAUDE.json/compile_commands.json— jamais le code source de l'utilisateur).
- Avant tout traitement (sauf
--checkou--global),
vérifie et régénère si besoin le profil global
~/.claude/CLAUDE.md.
Syntaxe
pcClaudeMdGenerator [options] [projet_root] [output_path]
Arguments positionnels :
projet_root— racine du projet (défaut : répertoire courant)output_path— chemin duCLAUDE.mdgénéré
(défaut : projet_root/CLAUDE.md)
Options
| Court | Long | Effet |
|---|---|---|
-h |
--help |
Affiche l'aide détaillée et quitte |
-v |
--version |
Affiche la version et quitte |
-V |
--verbose |
Mode verbeux (étapes détaillées) |
-g |
--global |
Génère ~/.claude/CLAUDE.md (profil global) puis quitte
|
-j |
--json |
Génère également CLAUDE.json (données structurées) à côté du CLAUDE.md
|
-c |
--check |
Mode CI : compare le CLAUDE.md existant à ce qui serait généré. Exit 0 si identique, 1 sinon. N'écrit aucun fichier.
|
Exemples
-h / --help — affiche l'aide et quitte :
pcClaudeMdGenerator -h
-v / --version — affiche la version et quitte :
pcClaudeMdGenerator -v
-V / --verbose — génère en mode verbeux :
pcClaudeMdGenerator -V /Atelier
(aucune option) — génère CLAUDE.md du projet courant :
pcClaudeMdGenerator
-j / --json — génère aussi CLAUDE.json :
pcClaudeMdGenerator -j
-g / --global — régénère le profil global :
pcClaudeMdGenerator -g
-c / --check — mode CI, aucune écriture :
pcClaudeMdGenerator -c /Atelier
Répertoires et fichiers concernés
| Chemin | Accès | Condition |
|---|---|---|
projet_root/ |
lu | toujours |
projet_root/CMakeLists.txt |
lu | si présent |
projet_root/{includes,include,inc,headers,src}/ |
lu | scan des classes |
projet_root/config/ |
lu | *.yaml, *.yml, *.json
|
projet_root/CLAUDE.md |
écrit | toujours (sauf --check)
|
projet_root/CLAUDE.json |
écrit | avec -j
|
projet_root/compile_commands.json |
écrit | si sources présentes |
projet_root/.git/ |
écrit | git init + commit des fichiers générés
|
~/.claude/CLAUDE.md |
lu et écrit | profil global, hors --check/--global seul
|
~/.claude/CLAUDE.md.old |
écrit | sauvegarde avant régénération du global |
Build
cmake -B build -S . cmake --build build
Paquets Debian requis :
apt install cmake g++ libboost-program-options-dev
Installation système (copie dans /home/local/bin) :
cmake --install build
Voir aussi
- DOCUMENTATION/manuel.md — manuel détaillé (dépannage, détection des
produits versionnés, mise à jour automatique du profil global)
Généré manuellement — V1.16.0 — 2026-07-20