Vault Organizer

Que fait Vault Organizer ?

Transformez un coffre-fort Markdown désordonné en une base de connaissances propre, interconnectée et indexée qu'un LLM (ou un coéquipier) peut interroger rapidement. Construit sur le principe de Karpathy : traiter la connaissance comme du code. Les sources brutes sont les fichiers source, le wiki compilé est le résultat de la construction, l'INDEX est le schéma, et cette compétence est le compilateur + linter.

Le modèle (3 couches)

Couche	Quoi	Où
RAW	Non traité : transcriptions, extraits, dumps, captures d'écran	00_Inbox/raw/, dossier thématique le plus proche
COMPILED	Pages synthétisées, référencées avec [[wikiliens]]	Dossiers PARA (01_–04_)
SCHÉMA	Fichiers INDEX, CLAUDE.md, les règles	INDEX.md par dossier + un index maître

Chaque fichier porte un frontmatter type: (raw | compiled | reference | framework | client | index). Voir references/standards.md pour les modèles de frontmatter et d'INDEX.

Workflow

Exécutez-les dans l'ordre. Auditez et proposez avant de modifier quoi que ce soit. Ne supprimez ni ne déplacez sans confirmation. Préférez un dépôt git pour que les modifications soient réversibles.

1. Audit (lecture seule)

# tout le coffre :
python3 scripts/audit.py <racine_du_coffre> --stale-days 120 --report /tmp/audit-coffre.md
# un sous-dossier, mais résout les [[wikiliens]] par rapport à tout le coffre (évite les faux drapeaux "brisé") :
python3 scripts/audit.py <sous_dossier> --link-root <racine_du_coffre> --report /tmp/audit-coffre.md

Renvoie un rapport de santé : frontmatter manquant, wikiliens brisés/manquants, orphelins, sections Connexes manquantes, doublons, fichiers obsolètes, dossiers sans INDEX. Lisez-le, puis montrez à l'utilisateur le tableau récapitulatif et les principaux problèmes. (--json pour un résultat lisible par machine.)

2. Triage

Regroupez les constats et demandez ce qu'il faut corriger maintenant ou plus tard. Priorité par défaut :

1. Dossiers sans INDEX (tue la récupération)
2. Frontmatter manquant (tue la recherche + Propriétés)
3. Wikiliens brisés (tue le graphe)
4. Sections Connexes manquantes + orphelins (tue la découverte)
5. Obsolètes / doublons (nettoyage)

3. Nettoyage (par fichier)

Pour chaque fichier signalé :

• Ajoutez un frontmatter YAML (title, type, source, author, created, description, tags) — déduisez du contenu, utilisez la date du jour pour created si inconnue.
• Ajoutez des [[wikiliens]] à la première mention d'un concept, outil, personne ou fichier qui existe ailleurs dans le coffre.
• Ajoutez une section ## Connexes en bas avec 3–8 [[wikiliens]] vers les pages les plus connectées. Ajoutez le fichier dans la section Connexes de 2–3 de ces pages (bidirectionnel).
• Corrigez les wikiliens brisés : redirigez vers le slug correct, ou laissez comme une intention délibérée si la cible mérite d'être écrite plus tard. Utilisez les modèles dans references/standards.md. Ne supprimez pas le frontmatter ou les liens existants.

4. Organisation (proposez d'abord)

• Déplacez les fichiers mal classés vers la bonne couche/dossier (raw → 00_Inbox/raw/, compiled → PARA).
• Normalisez les noms de fichiers en kebab-case ; fusionnez ou renommez les doublons.
• Gardez les déplacements petits et réversibles. Listez chaque déplacement et obtenez un oui avant de l'exécuter.

5. Enregistrement (le livrable)

• Pour chaque dossier de contenu, générez ou mettez à jour INDEX.md : un pointeur d'une ligne par fichier (- [[nom-du-fichier]] — courte accroche), regroupé par type, le plus récent ou le plus important en premier.
• Construisez/rafraîchissez un index maître (par ex. INDEX.md à la racine, ou un dossier de schéma meta/) qui pointe vers chaque INDEX de dossier.
• Ce registre est ce qui rend la récupération rapide et ce que vous remettez à un coéquipier.

6. Lint (confirmation)

Ré-exécutez audit.py. Montrez les comptes avant/après. Le coffre est "propre" lorsque les comptes de frontmatter, de couverture INDEX et de liens brisés sont à zéro (les orphelins/obsolètes peuvent rester par choix).

Transmettre à un coéquipier

Lorsque l'objectif est de partager le coffre organisé avec un coéquipier : assurez-vous que l'INDEX maître est à jour, que chaque dossier a son propre INDEX, et qu'un court README.md à la racine explique le modèle en 3 couches et comment naviguer. Le README + l'INDEX maître est le point d'entrée.

Règles

• Audit en lecture seule d'abord, toujours. Révélez, ne surprenez pas.
• Ne supprimez jamais et ne déplacez jamais en masse sans confirmation explicite ; recommandez de commiter d'abord.
• Ne touchez pas à .obsidian/, .git/, ou à la configuration de Claude Code (settings.json, hooks).
• Respectez les conventions existantes du coffre (celui-ci : PARA + les standards dans references/standards.md).
• Travaillez par lots ; signalez ce qui a changé après chaque lot.

Fichiers

• scripts/audit.py — scanner en lecture seule, le moteur. Exécutez-le en premier et en dernier.
• references/standards.md — spécification du frontmatter, taxonomie des types, modèles INDEX + README.