INFO::pcClaudeMdGenerator modifié par Claude

De wiki_pcwiki2
Aller à la navigationAller à la recherche

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 :

  1. Repère le(s) produit(s) à traiter dans projet_root :
    • si projet_root contient des sous-répertoires versionnés
 (ex. MonProjet/V1.13, MonProjet/V1.14…),
 traite automatiquement la dernière version de chaque
 sous-répertoire versionné trouvé ;
    • sinon traite projet_root lui-même (ou son
 sous-répertoire src/ s'il n'a pas de sources directement).
  1. Pour chaque produit :
    • analyse CMakeLists.txt (nom, version, standard C++, libs) ;
    • scanne includes/ include/ inc/ headers/ src/ (ou la racine
 si aucun de ces dossiers n'existe) à la recherche des classes/structs C++ ;
    • liste les fichiers de config/ (*.yaml,
 *.yml, *.json) ;
    • génère CLAUDE.md (et CLAUDE.json avec
 -j) dans le produit ;
    • régénère compile_commands.json ;
    • versionne ces fichiers générés dans git (git init si
 besoin, commit uniquement CLAUDE.md /
 CLAUDE.json / compile_commands.json — jamais
 le code source de l'utilisateur).
  1. Avant tout traitement (sauf --check ou --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 du CLAUDE.md gé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

 produits versionnés, mise à jour automatique du profil global)

Généré manuellement — V1.16.0 — 2026-07-20