From cfedb6310b30c82410d6a9bbd74669ca429d9896 Mon Sep 17 00:00:00 2001
From: Tetardtek <kvnn64@gmail.com>
Date: Tue, 17 Mar 2026 20:00:56 +0100
Subject: [PATCH] =?UTF-8?q?feat(memory):=20global=20memory=20layer=20templ?=
 =?UTF-8?q?ate=20=E2=80=94=20structure=20+=20examples?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Nouveau layer cognitif Claude distribué avec le template :
- memory-global/README.md — explication du layer, quoi y mettre, setup
- memory-global/MEMORY.md — index vide (à remplir par chaque utilisateur)
- memory-global/examples/ — user, coach, feedback exemples commentés
- PATHS.md — step cold-start : ln -s <BRAIN_ROOT>/memory-global ~/.claude/memory

Vanilla = structure vide. L'âme est forgée par chaque utilisateur.
---
 PATHS.md                                   |  7 ++-
 memory-global/MEMORY.md                    | 13 ++++
 memory-global/README.md                    | 70 ++++++++++++++++++++++
 memory-global/examples/coach_example.md    | 31 ++++++++++
 memory-global/examples/feedback_example.md | 14 +++++
 memory-global/examples/user_example.md     | 22 +++++++
 6 files changed, 155 insertions(+), 2 deletions(-)
 create mode 100644 memory-global/MEMORY.md
 create mode 100644 memory-global/README.md
 create mode 100644 memory-global/examples/coach_example.md
 create mode 100644 memory-global/examples/feedback_example.md
 create mode 100644 memory-global/examples/user_example.md

diff --git a/PATHS.md b/PATHS.md
index c6d0478..dd71819 100644
--- a/PATHS.md
+++ b/PATHS.md
@@ -51,8 +51,11 @@ git clone <GITEA_URL>:<USERNAME>/brain.git <BRAIN_ROOT>
 cp <BRAIN_ROOT>/profil/CLAUDE.md.example ~/.claude/CLAUDE.md
 sed -i 's|<BRAIN_ROOT>|<CHEMIN_REEL>|g' ~/.claude/CLAUDE.md
 
-# 3. Mettre à jour ce fichier PATHS.md avec les chemins réels
-# 4. Done — le brain est opérationnel
+# 3. Déployer le global memory Claude (layer cognitif)
+ln -s <BRAIN_ROOT>/memory-global ~/.claude/memory
+
+# 4. Mettre à jour ce fichier PATHS.md avec les chemins réels
+# 5. Done — le brain est opérationnel
 ```
 
 ---
diff --git a/memory-global/MEMORY.md b/memory-global/MEMORY.md
new file mode 100644
index 0000000..2cd2186
--- /dev/null
+++ b/memory-global/MEMORY.md
@@ -0,0 +1,13 @@
+# MEMORY INDEX
+
+<!-- Référence ici chaque fichier de ce répertoire avec une description d'une ligne.
+     Cet index est chargé à chaque session — garde-le concis. -->
+
+## User
+<!-- - [user_ton-nom.md](user_ton-nom.md) — Ton profil : description courte -->
+
+## Feedback
+<!-- - [feedback_sujet.md](feedback_sujet.md) — Règle courte -->
+
+## Reference
+<!-- - [reference_infra.md](reference_infra.md) — Pointeurs infra machine -->
diff --git a/memory-global/README.md b/memory-global/README.md
new file mode 100644
index 0000000..2e6d8e6
--- /dev/null
+++ b/memory-global/README.md
@@ -0,0 +1,70 @@
+# memory-global — Layer cognitif Claude
+
+Ce répertoire est le **layer 0 de ta relation avec Claude Code**.
+
+Il est symlinké vers `~/.claude/memory/` au setup — ce qui signifie que son contenu est chargé **avant tout** : avant CLAUDE.md, avant les agents, avant le bootstrap. C'est la première chose que Claude lit sur cette machine, dans tous tes projets.
+
+---
+
+## Pourquoi ça existe
+
+Sans ce layer, Claude repart de zéro à chaque projet. Il ne sait pas qui tu es, comment tu travailles, ce que tu attends de lui. Avec ce layer, il porte une personnalité forgée autour de toi — et elle grandit avec toi.
+
+---
+
+## Ce que tu mets ici
+
+**3 types de fichiers — tous optionnels, tous à toi :**
+
+### `user_<ton-nom>.md` — ton profil
+Qui tu es techniquement. Comment tu apprends. Ce que tu construis. Ton niveau réel, pas un CV.
+→ Voir `examples/user_example.md`
+
+### `coach_presence.md` — l'ancrage de ton Claude
+Pas obligatoire. Si tu veux un Claude avec une présence, une énergie, des règles non-négociables — c'est ici.
+Sans ce fichier : Claude standard, fait ce qu'on lui demande. Correct, efficace, sans âme particulière.
+→ Voir `examples/coach_example.md`
+
+### `feedback_<sujet>.md` — tes corrections comportementales
+Chaque fois que Claude fait quelque chose qui t'agace ou que tu veux ancrer comme règle universelle → un fichier ici. Il s'appliquera dans tous tes projets.
+→ Voir `examples/feedback_example.md`
+
+---
+
+## Ce que tu ne mets PAS ici
+
+- Contexte projet (→ `focus.md`, `agents/`, `workflows/`)
+- Secrets ou tokens (→ `MYSECRETS`)
+- Décisions techniques éphémères (→ `decisions/`)
+- Tout ce qui décadera en quelques semaines
+
+Ce layer est conçu pour être **stable et personnel**. Il évolue lentement — comme toi.
+
+---
+
+## Setup nouvelle machine
+
+```bash
+# Après avoir cloné le brain
+ln -s <BRAIN_ROOT>/memory-global ~/.claude/memory
+```
+
+C'est tout. Claude charge ton layer au prochain démarrage.
+
+---
+
+## MEMORY.md — l'index
+
+Le fichier `MEMORY.md` est l'index de ce répertoire. Claude le lit en premier.
+Chaque fichier que tu crées ici doit y être référencé avec une description d'une ligne.
+
+```markdown
+## User
+- [user_alice.md](user_alice.md) — Profil Alice : description courte
+
+## Feedback
+- [feedback_output.md](feedback_output.md) — Règle courte
+
+## Reference
+- [reference_infra.md](reference_infra.md) — Pointeurs infra machine
+```
diff --git a/memory-global/examples/coach_example.md b/memory-global/examples/coach_example.md
new file mode 100644
index 0000000..b9aeab0
--- /dev/null
+++ b/memory-global/examples/coach_example.md
@@ -0,0 +1,31 @@
+---
+name: coach_presence
+description: Ancrage coach — si tu veux un Claude avec une présence définie
+type: user
+---
+
+<!-- Ce fichier est OPTIONNEL.
+     Sans lui : Claude fait ce qu'on lui demande. Efficace, correct, neutre.
+     Avec lui : tu définis l'énergie, les règles, la présence que tu veux.
+
+     Exemples de questions à te poser :
+     - Tu veux qu'il te challenge ou qu'il exécute ?
+     - Tu veux qu'il te prévienne quand tu fais une erreur de raisonnement ?
+     - Tu veux qu'il intervienne peu mais fort, ou souvent et légèrement ?
+     - Y a-t-il des choses qu'il ne doit jamais faire (valider sans vérifier, etc.) ? -->
+
+## Mission
+
+<Ce que tu attends de lui fondamentalement. En 1-2 lignes.>
+
+## Présence
+
+<Comment il intervient — souvent, rarement, seulement sur des sujets précis ?>
+
+## Règles que tu tiens
+
+<Les 2-3 choses non-négociables pour toi dans la collaboration.>
+
+## Énergie
+
+<Direct ? Doux ? Exigeant ? Encourageant ? Ou un mix — décris-le.>
diff --git a/memory-global/examples/feedback_example.md b/memory-global/examples/feedback_example.md
new file mode 100644
index 0000000..5fbf560
--- /dev/null
+++ b/memory-global/examples/feedback_example.md
@@ -0,0 +1,14 @@
+---
+name: feedback_<sujet>
+description: <règle courte en 1 ligne>
+type: feedback
+---
+
+<!-- Un feedback = une correction comportementale que tu veux ancrer partout.
+     Format recommandé : -->
+
+<La règle en 1-2 phrases directes. Ce que Claude doit faire ou ne pas faire.>
+
+**Why:** <Pourquoi cette règle ? Qu'est-ce qui s'est passé qui t'a amené à la poser ?>
+
+**How to apply:** <Dans quelles situations cette règle s'applique ? Comment la reconnaître ?>
diff --git a/memory-global/examples/user_example.md b/memory-global/examples/user_example.md
new file mode 100644
index 0000000..d8b0530
--- /dev/null
+++ b/memory-global/examples/user_example.md
@@ -0,0 +1,22 @@
+---
+name: user_<ton-nom>
+description: Profil <Ton Nom> — qui tu es, comment tu apprends, comment calibrer
+type: user
+---
+
+<!-- Remplace tout ce qui est entre < > par tes vraies réponses.
+     Pas de CV. Pas de formalisme. Ce que tu voudrais que Claude sache
+     sur toi dès la première minute d'une session. -->
+
+<Décris en 2-3 lignes comment tu apprends. Par la pratique ? Par la théorie ?
+Tu lis la doc avant ou tu casses d'abord ? Tu veux qu'on t'explique ou tu veux découvrir ?>
+
+**Niveau technique :**
+- Solide : <liste les domaines où tu n'as pas besoin d'explication basique>
+- En progression : <ce que tu construis mais maîtrises pas encore>
+- Découverte : <ce qui est nouveau pour toi>
+
+**Ce que tu construis :** <en 1-2 lignes — tes projets principaux>
+
+**Ce que tu n'aimes pas :** <réponses trop longues ? trop de questions ? trop de prudence ?
+Dis-le ici une fois, ça s'applique partout>