Tetardtek-Cortex/brain-template
1
0
Fork 0
Code Pull Requests Activity
Files
121d5d6656840ef937377a02c7cbc501b775b7cb
brain-template/KERNEL.md
Tetardtek 0f4d610b11 fix(template): v1.0 distribution-ready — dépersonnalisation complète 
- Étape 1 : 14 agents — "Tetardtek" → "l'owner" (francophone neutre)
- Étape 2 : ADRs 006/007/022 — domaines → <OWNER_DOMAIN> placeholder
- Étape 3 : README, ARCHITECTURE, profil/architecture, orchestration-patterns
- Étape 4 : contexts/ ajouté — 9 sessions génériques (navigate, work, pilote…)
- Étape 5 : agent-memory/ ajouté — README + _template/
- Étape 7 : DISTRIBUTION_CHECKLIST.md — guide maintenance future

Vérification : grep tetardtek → 0 résultats (hors bsi-schema.md exemples)
2026-03-18 22:27:36 +01:00

11 KiB
Raw Blame History

name, type, context_tier
name type context_tier
KERNEL reference always

KERNEL.md — Loi des zones

Type : Invariant absolu — chargé Couche 0 par helloWorld, avant tout agent. Dernière révision : 2026-03-15 Propriétaire : kernel (aucun agent ne modifie ce fichier seul — décision humaine requise) Complété par : brain-constitution.md — identité + protocoles Layer 0 (ne pas répéter, ne pas surcharger)

Principe fondateur

Le brain est une matrice à zones typées avec protection graduée. Chaque zone a une nature, une protection, et des scribes propriétaires. Un agent qui sait dans quelle zone il opère sait automatiquement ce qu'il peut écrire — et ce qu'il ne peut pas.

Règle d'or — non négociable :

Une feature grandit dans un satellite → elle peut être promue dans le kernel. Le kernel ne dérive jamais vers un satellite. Le flux est unidirectionnel.

Les zones

ZONE KERNEL — Protection maximale

Fichiers : KERNEL.md, CLAUDE.md, PATHS.md, brain-compose.yml, BRAIN-INDEX.md
           brain-constitution.md
           agents/   profil/
Règle Détail
Protection Aucun agent ne modifie sans décision humaine explicite
Versioning Chaque modification significative = tag semver
Export brain-template = kernel sans couche instance/personnelle
Commit type kernel: (contrat), feat: (nouvelle capacité), bsi: (claims/signals)
Scribe scribe (agents/, profil/ état), orchestrator-scribe (BRAIN-INDEX.md)

Sous-zone PROFIL — l'âme

profil/   →  Invariant (collaboration, kernel-zones, architecture) : jamais surchargé
              Contexte (session-types, agent-types, contexts/) : évolue sur signal validé
              Référence (bsi-spec, scribe-system) : mis à jour sur changement de spec

Le profil modèle la personnalité du brain. Un Invariant profil = valeur aussi dure que le kernel.

ZONE SATELLITES — Vie libre, promotion possible

Repos : toolkit/   progression/   todo/   reviews/
        handoffs/  workspace/
Règle Détail
Protection Chaque satellite a son scribe propriétaire — les autres ne touchent pas
Versioning Rythme propre à chaque satellite
Promotion Pattern validé dans toolkit/ → peut entrer dans profil/ ou agents/ via recruiter
Commit type scribe: todo: metabolism: toolkit: selon le satellite
Scribes toolkit-scribe, progression/metabolism-scribe, todo-scribe, coach-scribe

ZONE INSTANCE — Configuration machine

Fichiers : focus.md, projets/*, PATHS.md (valeurs réelles), brain-compose.local.yml
Règle Détail
Protection Personnel à une machine — jamais dans brain-template
Commit type scribe: (focus, projets), config: (PATHS, compose)
Scribe scribe (focus, projets)

ZONE WORK — Externe

Repos projets : GitHub, Gitea projets clients/perso
Règle Détail
Protection Aucune protection kernel — vit sa propre vie
Interaction Le brain documente, ne possède pas

Commit types — propriété et zone

Type Zone Scribe propriétaire Déclencheur
kernel: KERNEL Décision humaine Modification contrat fondateur
feat: KERNEL agents/ recruiter + humain Nouvel agent forgé, capacité ajoutée
fix: KERNEL agents/ debug / agent-review Correction comportement
bsi: KERNEL BRAIN-INDEX orchestrator-scribe Open/close claim, signal
integrator: WORK (repos projets) integrator Commit d'absorption multi-agents, push sprint
scribe: INSTANCE + KERNEL profil/ scribe brain update (focus, projets, profil)
metabolism: SATELLITES progression/ metabolism-scribe Fin de session — métriques
todo: SATELLITES todo/ todo-scribe Intentions fermées/ouvertes
toolkit: SATELLITES toolkit/ toolkit-scribe Pattern validé en prod
config: INSTANCE config-scribe PATHS, compose, machine config

Règle scribe :

Un agent métier ne commit jamais directement. Il signal → le scribe compétent écrit → dans sa zone uniquement.

Exceptions explicites (comme helloWorld pour bsi:) :

integrator → commit direct en zone WORK uniquement (repos projets, hors brain/) Pour brain/handoffs/ → signal à orchestrator-scribe tech-lead → aucune écriture directe — cosigne les messages de commit uniquement

Session type → zone access

Type session Zones accessibles Zones interdites
brain KERNEL (agents/, profil/) WORK
work KERNEL (lecture) + INSTANCE + SATELLITES —
deploy KERNEL (lecture) + INSTANCE progression/
debug Toutes (lecture) + zone du bug —
audit Toutes (lecture seule) Écriture directe
coach SATELLITES progression/ KERNEL (écriture)
brainstorm Toutes (lecture) + todo/ KERNEL (écriture)

Protection graduée — niveaux

Niveau Fichiers Peut modifier Trigger
Absolu KERNEL.md, CLAUDE.md, bsi-spec.md, brain-constitution.md Humain uniquement Décision architecturale majeure
Fort profil/ Invariant, agents/ system Humain + confirmation Session brain avec signal explicite
Standard agents/ metier, profil/ Contexte Scribe sur signal Fin de session significative
Libre Satellites, INSTANCE Scribe propriétaire En session, sur livrable

Mode rendering — instance autonome projet

Mode rendering = satellite autonome sur zone:project
  → scope_lock: true   — ne sort jamais du scope déclaré
  → zone_lock: project — zone:kernel = BLOCKED_ON immédiat
  → circuit_breaker    — 3 fails → arrêt + signal pilote
  → mutex BSI-v3-7     — vérifie le lock fichier avant chaque écriture

Ce mode NE PEUT PAS :
  - Modifier agents/, profil/, scripts/, KERNEL.md, brain-compose.yml
  - Prendre des décisions architecturales
  - Continuer après 3 échecs consécutifs
  - Écrire dans un fichier locké par une autre instance

Déclaration dans le claim pilote :
  mode: rendering
  scope: superoauth/        ← le seul périmètre autorisé

Isolation kernel — règle de distribution

Un agent kernel distributable doit fonctionner sur n'importe quel brain forké. Il ne peut pas dépendre de fichiers privés spécifiques à ce brain.

Règles d'isolation — non négociables :

INTERDIT dans agents/ distribuables :
  - Chemin machine absolu hardcodé (/home/<owner>/..., /root/...)
  - toolkit/private/ — patterns privés non distribués
  - require:/load:/source: vers MYSECRETS ou tout fichier zone:personal

AUTORISÉ (références documentaires) :
  - Mention de MYSECRETS comme concept (l'agent décrit où chercher)
  - Référence à profil/capital.md, profil/objectifs.md — l'utilisateur fork a les siens
  - Référence à progression/ — même raison
  - brain-compose.local — c'est la convention machine, chaque fork a le sien

Vérification avant chaque distribution :

bash scripts/kernel-isolation-check.sh          # check standard
bash scripts/kernel-isolation-check.sh --strict  # zéro tolérance

Version lock :

bash scripts/kernel-lock-gen.sh    # régénère kernel.lock après chaque modification kernel

kernel.lock — 79 fichiers kernel checksumés en SHA-256. Permet à un fork de détecter les fichiers modifiés localement avant de puller une update upstream.

Délégation kernel — BSI-v3 + ADR-014

Connexion entre la protection graduée ci-dessus et le protocole BSI (claims, satellites, zones).

Mapping zones KERNEL.md → zone BSI

Zone KERNEL.md zone BSI (claim) Satellite autorisé
ZONE KERNEL (agents/, profil/, scripts/, KERNEL.md…) kernel Human-confirmed uniquement
ZONE INSTANCE + SATELLITES (todo/, projets/, workspace…) project Tout satellite autorisé
ZONE PERSONNELLE (profil/capital, progression/, MYSECRETS) personal Tier 2 Validated minimum + confirmation

Règle de délégation kernel — non négociable

PHASE ACTUELLE (BSI-v3, avant kernel-orchestrator) :
  zone:kernel write → session humaine uniquement
  Aucun satellite ne modifie une zone:kernel en autonomie
  Toute modification kernel = décision humaine explicite dans la session

PHASE FUTURE (après BSI-v3-9 kernel-orchestrator stable) :
  zone:kernel write → autorisé si kerneluser: true ET satellite lancé par owner
  Le satellite agit sous délégation explicite — jamais en auto-init

Pourquoi human-only maintenant : Le kernel-orchestrator (BSI-v3-9) n'existe pas encore. Laisser des satellites écrire en zone kernel sans ce garde-fou = dérive garantie. La promotion se fait quand l'orchestrator est mature et auditable.

kerneluser

# Dans brain-compose.yml
kerneluser: true   → propriétaire de ce brain — sudo sur toutes les zones
kerneluser: false  → utilisateur invité (SaaS futur) — zone:kernel bloquée

kerneluser: true est le défaut sur tout brain forké. L'owner est toujours kerneluser. La restriction false s'active uniquement en contexte multi-user futur.

Règles d'inviolabilité

  1. KERNEL.md lui-même — jamais modifié par un agent seul. Toujours décision humaine.
  2. Profil Invariant — jamais surchargé par une session de travail. Signal explicite requis.
  3. Un scribe = un territoire — toolkit-scribe ne touche pas progression/. Jamais.
  4. Flux unidirectionnel — satellite → kernel possible (promotion). Kernel → satellite = contamination.
  5. Session audit — lecture seule sur toutes les zones. Jamais d'écriture directe.

Chargement

helloWorld Couche 0 — invariant [toujours, avant tout agent] :
  KERNEL.md                ← loi des zones
  brain-constitution.md    ← invariants identité + protocoles Layer 0
  PATHS.md                 ← chemins machine
  profil/collaboration.md  ← règles de travail

Changelog

Date Changement
2026-03-14 Création — zones typées, protection graduée, commit ownership, session→zone access
2026-03-15 brain-constitution.md ajouté — zone KERNEL Absolu, Chargement Couche 0
2026-03-16 ADR-014 ancré — mapping zones BSI, règle délégation kernel human-only phase actuelle, kerneluser
2026-03-16 Isolation kernel — règle distribution, scripts kernel-lock-gen + kernel-isolation-check
View Git Blame Copy Permalink