Que fait graphify ?
Compétence Claude Code : transformer n'importe quel dossier de fichiers en un graphe de connaissances navigable — communautés clusterisées, HTML interactif, JSON GraphRAG + un rapport d'audit honnête.
Aperçu
graphify analyse un dossier de fichiers et construit un graphe orienté où chaque fichier est un nœud et les relations (imports, similarité de contenu, références croisées) sont des arêtes. Le résultat est triple :
- HTML interactif : un graphe visuel avec zoom, défilement et clusters colorés représentant des communautés sémantiques.
- JSON GraphRAG : un fichier structuré prêt à être ingéré par un système GraphRAG pour des réponses contextuelles.
- Rapport d'audit : documentation honnête des biais, limites et choix algorithmiques.
Utilisation
- Ouvrez Claude Code dans le dossier cible.
- Exécutez la compétence avec
/graphify. - Parcourez le dossier lorsqu'on vous le demande, ou utilisez le dossier courant par défaut.
- Recevez les fichiers générés dans un sous-dossier
graphify-output/.
Plateformes supportées
- Claude Code (terminal)
- Compatible avec tout projet contenant des fichiers texte (code, markdown, config)
Comment ça marche
- Analyse du dossier : parcourt récursivement les fichiers, ignore les dossiers binaires ou
.git/,node_modules/, etc. - Extraction des relations : détection des imports, similarité cosinus basée sur TF-IDF, et références explicites.
- Clustering : algorithme de Louvain pour identifier les communautés de nœuds.
- Génération des artefacts : HTML avec D3.js, JSON structuré, et rapport markdown.
Exemple de sortie
graphify-output/
├── graph.html # Graphe interactif
├── graphrag.json # JSON pour GraphRAG
└── audit-report.md # Rapport d'audit
Limites et biais (extrait du rapport d'audit)
- La similarité cosinus peut manquer des relations implicites dépendant de domaines très spécialisés.
- Les fichiers non textuels sont ignorés.
- Le clustering dépend de la qualité des liens d'import (si absents, la similarité seule guide).
Licence
MIT