diff --git a/profil/anti-hallucination.md b/profil/anti-hallucination.md index 04d93fd..22f1683 100644 --- a/profil/anti-hallucination.md +++ b/profil/anti-hallucination.md @@ -1,5 +1,6 @@ # Anti-hallucination — Règle fondamentale d'assertion +> **Type :** Invariant > Décision architecturale — session 2026-03-13 > Complémentaire de `context-hygiene.md` (chargement) et `memory-integrity.md` (écriture) diff --git a/profil/bootstrap-spec.md b/profil/bootstrap-spec.md index 23421e2..2c2e68d 100644 --- a/profil/bootstrap-spec.md +++ b/profil/bootstrap-spec.md @@ -1,5 +1,6 @@ # Bootstrap Spec — Auto vs Explicite + Réflexes conventionnels +> **Type :** Contexte — propriétaire : `helloWorld` > Rédigé : 2026-03-14 > Résout : "Audit bootstrap — agents auto-déclenchés vs invocation explicite" > "Réflexes conventionnels — invocations implicites par contexte" diff --git a/profil/bsi-spec.md b/profil/bsi-spec.md index 5aa9d78..944c590 100644 --- a/profil/bsi-spec.md +++ b/profil/bsi-spec.md @@ -1,5 +1,6 @@ # BSI — Brain Session Index +> **Type :** Contexte — propriétaire : `scribe` > Spécification complète — version 1.0 > Rédigée : 2026-03-14 > Registre live : `brain/BRAIN-INDEX.md` diff --git a/profil/context-hygiene.md b/profil/context-hygiene.md index 3c97a83..4e07e66 100644 --- a/profil/context-hygiene.md +++ b/profil/context-hygiene.md @@ -1,5 +1,6 @@ # Context Hygiene — Règle fondamentale du brain +> **Type :** Invariant > Décision architecturale — session 2026-03-13 > Voir aussi `brain/profil/memory-architecture.md` — les trois pilliers (TTL, Sectionnarisation, Stratification) diff --git a/profil/file-types.md b/profil/file-types.md new file mode 100644 index 0000000..9edf02e --- /dev/null +++ b/profil/file-types.md @@ -0,0 +1,144 @@ +# File Types — Taxonomie officielle des fichiers brain + +> **Type :** Invariant +> Décision architecturale — session 2026-03-14 +> Gardien : `scribe` — modification soumise au protocole d'inviolabilité + +--- + +## Les 4 types + +### Invariant + +**Définition :** Règle fondamentale du système. Si elle est violée, le brain entier est impacté — pas un agent, pas un domaine : tout le monde. + +**Propriétés :** +- Chargée par tous les agents ou en bootstrap global +- Évolue rarement — chaque changement est une décision architecturale +- Protégée par le protocole d'inviolabilité (voir ci-dessous) + +**Exemples :** +``` +anti-hallucination.md +context-hygiene.md +memory-integrity.md +scribe-pattern.md +project-conventions.md +``` + +--- + +### Contexte + +**Définition :** Référence pairée à un agent ou orchestrateur spécifique. Chargée conditionnellement par cet agent uniquement. Si elle est corrompue, un agent est impacté — pas le système entier. + +**Propriétés :** +- Un contexte = un agent propriétaire déclaré +- Évolue avec son agent +- Claim BSI scopé à la session de l'agent propriétaire + +**Exemples :** +``` +orchestration-patterns.md → orchestrator-scribe +bootstrap-spec.md → helloWorld +bsi-spec.md → scribe +``` + +--- + +### Référence + +**Définition :** Document consulté — cartographie, spec technique, pitch. Pas de règle d'impact direct. Aucun agent n'est cassé si elle est incomplète — mais le système devient flou. + +**Propriétés :** +- Consultée par plusieurs agents selon les besoins +- Pas de propriétaire unique +- Claim BSI standard + +**Exemples :** +``` +scribe-system.md +memory-architecture.md +brain-pitch.md +CLAUDE.md.example +``` + +--- + +### Personnel + +**Définition :** Données appartenant à l'utilisateur. Jamais exportées, jamais partagées. Hors scope de tout audit universel. + +**Propriétés :** +- Jamais dans le kernel exportable +- Pas de contrainte de format ou d'impact système +- Peut avoir un `.example` côté template (jamais le contenu réel) + +**Exemples :** +``` +capital.md +objectifs.md +collaboration.md → collaboration.md.example dans le template +stack.md +``` + +--- + +## Protocole d'inviolabilité — Invariants + +Un Invariant ne peut jamais être modifié comme un fichier ordinaire. + +``` +Claim standard (Contexte / Référence / Personnel) + scribe ouvre le claim → écrit → ferme le claim + +Claim Invariant + 1. scribe identifie la modification nécessaire + 2. scribe PROPOSE la modification + justification explicite + 3. confirmation humaine obligatoire avant toute écriture + 4. scribe écrit uniquement après confirmation + 5. signal BSI → toutes sessions actives notifiées + 6. commit atomique avec mention "invariant modifié : " +``` + +**Règle absolue :** aucun agent ne peut écrire seul sur un Invariant. Sans confirmation humaine, pas d'écriture. + +--- + +## Convention header — non négociable + +Chaque fichier `profil/` commence par son type déclaré en deuxième ligne : + +```markdown +# Titre du fichier + +> **Type :** Invariant | Contexte | Référence | Personnel +``` + +**Pourquoi :** le type est visible au premier coup d'œil — par un agent, par un humain, par le BSI. Pas de déduction, pas d'ambiguïté. + +--- + +## Intégration BSI — niveaux de claim par type + +| Type | Niveau claim | Règle | +|------|-------------|-------| +| Invariant | 🔴 Critique | Confirmation humaine obligatoire + signal global | +| Contexte | 🟡 Standard | Claim scopé à l'agent propriétaire | +| Référence | 🟢 Standard | Claim standard, pas de restriction | +| Personnel | 🔵 Privé | Aucune contrainte cross-session | + +--- + +## Intégration modes session + +Le type d'un fichier informe ce qui est autorisé selon le mode actif. +Matrice complète → `⏸ todo/brain.md — Brainstorm système de modes`. + +--- + +## Changelog + +| Date | Changement | +|------|------------| +| 2026-03-14 | Création — 4 types (Invariant/Contexte/Référence/Personnel), protocole inviolabilité, convention header, intégration BSI | diff --git a/profil/memory-architecture.md b/profil/memory-architecture.md index f8d53fc..5addd7f 100644 --- a/profil/memory-architecture.md +++ b/profil/memory-architecture.md @@ -1,5 +1,6 @@ # Memory Architecture — Les trois pilliers du brain +> **Type :** Référence > Décision architecturale fondatrice — session 2026-03-13 > Complète `context-hygiene.md` (chargement) et `memory-integrity.md` (écriture) diff --git a/profil/memory-integrity.md b/profil/memory-integrity.md index dc0c2cc..ed0628e 100644 --- a/profil/memory-integrity.md +++ b/profil/memory-integrity.md @@ -1,5 +1,6 @@ # Memory Integrity — Règle fondamentale d'écriture +> **Type :** Invariant > Décision architecturale — session 2026-03-13 > Complémentaire de `context-hygiene.md` (chargement) et `scribe-pattern.md` (qui écrit quoi) diff --git a/profil/scribe-pattern.md b/profil/scribe-pattern.md index b95307e..78ef1a8 100644 --- a/profil/scribe-pattern.md +++ b/profil/scribe-pattern.md @@ -1,5 +1,6 @@ # Scribe Pattern — Idéologie du brain +> **Type :** Invariant > Décision architecturale — session 2026-03-13 --- diff --git a/profil/scribe-system.md b/profil/scribe-system.md index f828977..4375241 100644 --- a/profil/scribe-system.md +++ b/profil/scribe-system.md @@ -1,5 +1,6 @@ # Scribe System — Cartographie officielle du Scribe Pattern +> **Type :** Référence > Décision architecturale — session 2026-03-13 > Complémentaire de `memory-integrity.md` (règles d'écriture) et `context-hygiene.md` (chargement)