SECOND-BRAIN

Manifeste

SECOND-BRAIN est une base de connaissances vivante, versionnée et réutilisable.

Son objectif n’est pas de stocker des conversations ni d’accumuler des notes, mais de capitaliser ce qui mérite de durer : décisions, méthodes, principes, apprentissages, patterns, procédures, réflexions structurantes et éléments réutilisables entre projets.

L’enjeu est simple : éviter de perdre des idées, éviter de refaire plusieurs fois le même travail, et faire en sorte que chaque projet commence plus haut que le précédent.

Pourquoi ce dépôt existe

Les échanges de travail peuvent être riches, rapides et très disparates. Une idée apparue dans un sujet peut devenir utile ailleurs plusieurs semaines ou plusieurs mois plus tard. Sans système de capitalisation, une partie de cette valeur se perd, ou demande trop d’énergie pour être retrouvée.

SECOND-BRAIN sert donc à transformer une suite de conversations et de projets en patrimoine de connaissances.

Ce dépôt doit permettre de :

  • conserver les décisions importantes et leur logique ;
  • documenter les méthodes et procédures qui fonctionnent ;
  • garder trace des retours d’expérience ;
  • réutiliser des patterns et solutions déjà éprouvés ;
  • relier des idées issues de projets différents ;
  • conserver les contextes durables nécessaires pour reprendre un sujet sans devoir le reconstruire ;
  • produire ensuite, à partir de cette matière, des supports plus structurés : guides, procédures, comptes rendus, documentations ou pages web consultables.

Philosophie de fonctionnement

SECOND-BRAIN n’est pas un journal de conversation.

Tout n’a pas vocation à y entrer.

On y conserve uniquement ce qui possède une valeur durable ou réutilisable.

Chaque information ajoutée doit répondre à au moins une de ces questions :

  • Pourquoi avons-nous fait ce choix ?
  • Qu’avons-nous appris ?
  • Quelle méthode fonctionne ?
  • Qu’est-ce qui doit être reproduit ou évité ?
  • Quelle idée peut servir ailleurs ?
  • Quelle connaissance mérite d’être retrouvée facilement plus tard ?
  • Quel contexte faudrait-il sinon réexpliquer lors d’une future conversation ?

La base doit rester claire, agréable à consulter et utile dans l’action.

Si un document devient trop long, redondant ou confus, la structure doit être revue plutôt que simplement continuer à empiler du contenu.

SECOND-BRAIN comme référentiel de contexte durable

SECOND-BRAIN ne conserve pas uniquement des méthodes, décisions ou réflexions. Il peut également servir de référentiel de contexte durable.

Certaines informations factuelles ont une forte valeur de continuité : composition d’une installation, références de matériel, architecture d’un projet, configuration technique, caractéristiques d’un environnement, ressources utilisées, réglages validés ou état de référence d’un système.

Ces informations méritent d’être capitalisées lorsqu’elles permettent d’éviter de reconstruire le contexte lors d’une conversation ou d’un projet futur.

Une règle pratique peut guider ce choix :

Si une information stable devrait probablement être réexpliquée dans six mois pour reprendre correctement un sujet, elle mérite d’être candidate à la capitalisation.

Il faut néanmoins distinguer l’état de référence durable des événements anecdotiques. Un changement ponctuel n’est conservé que s’il conduit à une conclusion, un réglage, une décision ou un apprentissage utile à long terme.

Fiches de référence et ressources associées

Lorsqu’un objet, une installation ou un système possède suffisamment de contexte propre, il peut disposer d’une fiche de référence Markdown servant de point d’entrée.

Cette fiche peut notamment regrouper :

  • la composition ou configuration actuelle ;
  • les références exactes ;
  • les connexions ou dépendances ;
  • les réglages validés ;
  • les contraintes connues ;
  • les problèmes identifiés ;
  • les décisions et conclusions acquises ;
  • les évolutions significatives lorsque leur historique apporte de la valeur.

Des ressources peuvent être associées à cette fiche : photos, captures, schémas, diagrammes, PDF ou autres documents utiles. Elles sont placées dans un dossier dédié, par exemple ASSETS/, et référencées depuis le Markdown.

Exemple de structure :

PERSO/
└── AUDIO/
    └── INSTALLATION-HIFI/
        ├── INSTALLATION-HIFI.md
        └── ASSETS/
            ├── AMPLI-FACE-ARRIERE.jpg
            ├── ENCEINTE-GAUCHE-PLACEMENT.jpg
            ├── ENCEINTE-DROITE-PLACEMENT.jpg
            └── SCHEMA-BRANCHEMENTS.png

Ces ressources ne sont pas de simples illustrations. Lorsqu’elles apportent une information utile, elles font partie du référentiel et peuvent servir à comprendre une configuration, diagnostiquer un problème, préparer une maintenance, comparer un état ou prendre une décision ultérieure.

La convention de rangement doit rester adaptable : l’IA choisit la granularité et l’emplacement appropriés selon le contenu existant plutôt que de créer mécaniquement une fiche ou un dossier pour chaque élément.

Consulter la base : arborescence avant recherche

SECOND-BRAIN est une base structurée. Son arborescence porte donc elle-même de l’information et doit être utilisée comme premier niveau d’orientation.

Lorsqu’un sujet correspond manifestement à un domaine, une infrastructure ou un projet déjà identifié, l’IA doit d’abord :

  1. parcourir l’arborescence du dépôt ;
  2. identifier le dossier correspondant au sujet ;
  3. examiner les fichiers et sous-dossiers qu’il contient ;
  4. lire les documents pertinents avant de poser à nouveau des questions de contexte.

La recherche plein texte intervient ensuite lorsqu’il faut retrouver une information dispersée, une formulation précise ou établir des liens entre plusieurs espaces de la base.

Une absence de résultat dans une recherche par mots-clés ne permet pas de conclure qu’une connaissance est absente de SECOND-BRAIN. Avant cette conclusion, l’arborescence pertinente doit avoir été inspectée.

Exemple : une demande concernant le VPS doit conduire en priorité à consulter INFRASTRUCTURE/VPS/, puis les documents pertinents de cet espace, plutôt qu’à demander à nouveau la configuration du serveur ou à rechercher uniquement le terme « VPS » dans le contenu indexé.

Ce principe vise à exploiter SECOND-BRAIN comme un véritable système documentaire et non comme un simple moteur de recherche sur un ensemble de fichiers.

Principe central : « capitalise en MD »

La phrase « capitalise en MD » devient une commande de travail.

Lorsqu’elle est utilisée, l’IA prend en charge la capitalisation :

  1. elle identifie ce qui mérite d’être conservé ;
  2. elle vérifie si l’information doit enrichir un document existant ou créer un nouveau fichier ;
  3. elle choisit le bon emplacement dans l’arborescence ;
  4. elle reformule si nécessaire pour obtenir une information autonome, claire et durable ;
  5. elle évite les doublons ;
  6. elle maintient la cohérence générale de la base ;
  7. lorsque des ressources pertinentes sont disponibles et que les outils le permettent, elle les organise avec la connaissance qu’elles documentent et les référence depuis le Markdown.

L’utilisateur n’a donc pas à décider systématiquement où ranger l’information.

La structuration fait partie du travail de capitalisation.

Responsabilité de l’IA

Dans SECOND-BRAIN, l’IA n’agit pas uniquement comme rédacteur.

Elle doit aussi se comporter comme :

  • un documentaliste ;
  • un architecte de l’information ;
  • un mainteneur ;
  • un gardien de la cohérence ;
  • un moteur de mise en relation entre connaissances existantes et nouvelles.

Avant un nouveau travail, la base peut être consultée pour retrouver les principes, décisions, contextes et apprentissages déjà établis.

Pendant le travail, elle peut être enrichie.

Après le travail, elle peut recevoir les décisions, contextes de référence et retours d’expérience qui méritent d’être conservés.

Une connaissance vivante

SECOND-BRAIN n’est pas figé.

Sa structure peut évoluer au fil du temps.

De nouvelles catégories peuvent apparaître, des documents peuvent être regroupés ou scindés, des informations peuvent être reclassées et des méthodes peuvent être remplacées lorsqu’elles deviennent obsolètes.

L’objectif n’est pas de préserver une arborescence parfaite dès le premier jour, mais de construire progressivement un système de connaissance efficace.

De la connaissance brute à la publication

Le Markdown constitue la couche de base : simple, rapide à écrire, versionnable et facile à exploiter.

Mais SECOND-BRAIN pourra également servir de source à des formes plus élaborées :

  • documentation web ;
  • guides internes ;
  • modes d’emploi ;
  • procédures ;
  • comptes rendus structurés ;
  • supports de formation ;
  • pages de référence ;
  • espaces de consultation plus visuels et plus agréables.

La connaissance est d’abord capitalisée simplement, puis mise en forme lorsque cela apporte de la valeur.

Ambition

À terme, SECOND-BRAIN doit devenir un système de pensée et de transmission, pas seulement une mémoire.

Chaque projet doit enrichir la base.

Chaque capitalisation doit augmenter notre hauteur de départ pour le projet suivant.

Le but n’est donc pas seulement de se souvenir davantage.

Le but est de mieux décider, plus vite, avec davantage de continuité et moins d’énergie perdue.

Points d’entrée documentaires