Brain Linking

Que fait Brain Linking ?

Un coffre est un graphe. Une note sans lien est perdue. Chaque note que vous écrivez doit se connecter à au moins deux pages existantes, et au moins une page existante doit pointer vers elle.

Ce skill est destiné à tout coffre Obsidian ou base de connaissances Markdown qui utilise [[wikiliens]]. Il n'est pas lié aux fichiers d'une seule personne.

Avant d'écrire

1. Lisez le schéma du coffre à la racine. Noms courants : CLAUDE.md, AGENTS.md, README.md. Suivez ce fichier s'il existe.
2. Recherchez ce qui existe déjà : rg -il '<sujet ou nom>' --glob '*.md'.
3. Si une page sur le sujet existe, ajoutez-y du contenu (ou déposez une note de boîte de réception pointant vers elle). Ne créez pas de quasi-doublon.

Chaque note doit avoir

• Un lien ascendant : un [[lien]] vers son hub parent. Exemples : un index de personne ou de projet [[index]] ou [[statut]], une page [[concepts/...]], un hub de projet ou un hub de domaine.

• Des liens latéraux : au moins un [[lien]] vers une personne, un projet, un produit, un concept ou une réunion connexe qui existe déjà.

• Les personnes et les choses sous forme de liens, pas de texte brut : si une personne, un produit ou un projet a une page, écrivez [[Nom]]. S'il devrait en avoir une mais n'en a pas, liez-le quand même. Obsidian montre le lien pendant, et le mainteneur crée la page.

• Métadonnées : about, area, source, suggested_home, date, agent. Utilisez les valeurs area déjà utilisées par le coffre (souvent travail vs vie, ou la propre liste de domaines du coffre).

• Une section Connexe en bas :

  ## Connexe
  - [[hub-parent]]
  - [[personne-ou-frère]]
  

Cibles des liens

• Utilisez le nom de fichier exact existant (kebab-case). Vérifiez avec rg --files | rg <slug> avant de lier.
• Préférez quelques liens forts à une pile de liens faibles. Liez ce qu'un lecteur cliquerait réellement ensuite.
• Ne liez jamais uniquement une page de date, une note quotidienne ou un tag. Ceux-ci ne connectent pas les sujets.

Notes de réunion et d'enregistrement

Une note de réunion ou d'enregistrement renvoie vers :

• la personne, l'équipe ou le projet concerné
• chaque participant qui a une page
• tout concept ou décision qu'elle a produit

Une transcription sans aucun lien est l'orphelin le plus courant.

Sources brutes

Les fichiers dans _raw/ (ou le dossier de capture équivalent du coffre) ne sont jamais modifiés. N'ajoutez pas de liens à l'intérieur. Au lieu de cela, la page de résumé ou de réunion qui les cite renvoie vers le fichier brut, afin qu'il rejoigne le graphe via cette page.

Écriture dans une boîte de réception partagée (robots)

• Si le coffre indique d'écrire uniquement dans _agents/inbox/ (ou un autre chemin de boîte de réception), faites-le.
• Les règles de lien ci-dessus s'appliquent toujours aux notes de boîte de réception, et suggested_home doit nommer une page réelle.

Ne jamais mettre dans le coffre

• Identifiants, jetons ou secrets
• Coordonnées privées qui n'ont pas leur place dans un graphe partagé
• Dossiers médicaux ou autres données personnelles sensibles
• Matériel confidentiel de tiers que vous n'êtes pas autorisé à stocker

Vérification rapide avant de terminer

• Au moins un lien ascendant et un lien latéral, tous vers des fichiers réels (ou des nouvelles pages délibérées)
• Les noms des personnes, produits et projets sont liés
• Section Connexe présente
• Aucun doublon d'une page existante