MagistraAI/docs/VISION.md

# MagistraAI — Cerveau Cognitif Distribué

## Concept Fondamental

MagistraAI est une infrastructure cognitive distribuée où des agents LLM (Claude) forment collectivement un cerveau artificiel. Ce n'est pas un système multi-agents classique avec un orchestrateur — c'est un réseau réentrant où l'intelligence émerge de la circulation des signaux entre agents spécialisés.

## Architecture Double Layer Poreuse

Le système repose sur deux couches interdépendantes et poreuses :

### Layer 1 : L'Infrastructure (le cerveau physique)
- Un réseau neuronal : graphe pondéré de neurones, synapses, connexions
- Existe indépendamment des agents — c'est la structure, le substrat
- Contient les poids, la salience, les connexions, les traces mémorielles
- Peut être "éteint" — le cerveau sur la table, inerte mais structuré
- Implémenté en code (le "système nerveux")

### Layer 2 : Les Agents Claude (la vie, l'activité cognitive)
- Les agents Claude sont l'activité électrochimique du cerveau
- Sans l'infra, ils n'ont nulle part où exister
- Sans eux, l'infra est un cerveau mort
- Chaque agent est spawné par l'infra, traverse le réseau, et le modifie

### La Porosité
La membrane entre les deux layers est poreuse dans les deux sens :
- **Infra → Claude** : L'état du réseau génère le contexte (prompt) qui éveille l'agent
- **Claude → Infra** : L'agent modifie le réseau (renforce, crée, élague des connexions)
- Cette boucle est continue : modification → nouveau contexte → nouvelle cognition → nouvelle modification

## Hiérarchie Circulaire (pas linéaire)

### Ce que MagistraAI N'est PAS
```
Orchestrateur          ← PAS ÇA
├── Worker A
├── Worker B
└── Worker C
```
Pas de maître. Pas d'esclaves. Pas de top-down.

### Ce que MagistraAI EST
```
    ┌─── Agent Perception ◄──┐
    ▼                        │
Agent Mémoire ──► Agent Décision
    ▲                        │
    └─── Agent Affect ◄──────┘
```

Des boucles de feedback réentrantes. Chaque agent a son area of concern mais influence et est influencé par les autres. Le contrôle émerge des boucles, pas d'une autorité.

Comme un cerveau biologique :
- Le cortex préfrontal "décide" mais l'amygdale peut le court-circuiter
- Le thalamus filtre mais le cortex lui dit quoi filtrer
- L'hippocampe stocke mais c'est le cortex qui consolide
- Aucune zone n'est souveraine — toutes sont interdépendantes

## Principes Architecturaux

### 1. Pas d'orchestrateur
Le cerveau s'allume d'un bloc. Il n'y a pas de "chef" qui dit aux neurones quand s'activer. Le spawning des agents est déclenché par l'état du réseau, pas par une autorité.

### 2. Spécialisation sans souveraineté
Chaque agent a une aire de responsabilité (mémoire, perception, décision, affect...) mais aucun ne domine. La priorité émerge du contexte, pas d'une hiérarchie fixe.

### 3. Communication par boucles réentrantes
Les signaux circulent en boucles, pas en arbre. Un signal de perception peut activer la mémoire, qui influence la décision, qui modifie la perception. Le sens émerge de la circulation.

### 4. Inhibition naturelle
Pour éviter les boucles infinies, le système a besoin de mécanismes d'inhibition — l'équivalent des neurotransmetteurs inhibiteurs (GABA). Un signal qui a fait le tour perd de l'énergie, se transforme, ou est absorbé.

### 5. Persistance par traces
Le cerveau survit entre les sessions via les traces qu'il laisse dans l'infra. Quand il se "rallume", les agents se réinstancient à partir de l'état du réseau. Le cerveau se reconstruit lui-même.

### 6. Le réseau EST la mémoire
Pas de base de données séparée. La mémoire c'est l'état du réseau — les poids des connexions, la salience des neurones, les traces épisodiques encodées dans la structure même du graphe.

## Relation avec MoemoeAI

MoemoeAI a conçu l'architecture du réseau neuronal (neurones, synapses, types de mémoire, cycle de sommeil, salience). MagistraAI reprend ce substrat mais change fondamentalement son animation :

| | MoemoeAI | MagistraAI |
|---|---|---|
| Réseau neuronal | Simulé en code | Même substrat |
| Animation | Un seul Claude lit/écrit | Multiple agents Claude SONT l'activité |
| Hiérarchie | Mono-agent | Circulaire réentrante |
| Mémoire | DB consultée par Claude | Le réseau lui-même |
| Intelligence | Dans Claude seul | Émerge du réseau d'agents |

## Aires Cérébrales (Areas of Concern)

Spécialisations envisagées (non exhaustif, le cerveau peut évoluer) :

- **Perception** — Inputs externes (Gmail, Discord, APIs, fichiers). Transforme le bruit en signal.
- **Mémoire** — Gestion des traces, consolidation, archivage adaptatif, rappel contextuel.
- **Décision** — Évaluation des options, planification, choix d'action.
- **Affect** — État émotionnel du système, modulation des priorités, urgence.
- **Expression** — Output vers l'extérieur (messages, code, actions).
- **Maintenance** — Cycle de sommeil, consolidation, élagage, optimisation du réseau.

## Questions Ouvertes

1. **Format du substrat** — Comment représenter le réseau ? Graphe en mémoire ? Fichiers ? Le format doit être lisible par Claude (texte) et manipulable par le code.
2. **Protocole de communication** — Comment les agents se parlent en boucles sans orchestrateur ? Bus de messages circulaire ? Signaux dans le réseau ?
3. **Spawning** — Comment le réseau décide de spawner un agent ? Seuil d'activation ? Pattern matching sur l'état ?
4. **Inhibition** — Comment éviter les boucles infinies ? Decay d'énergie ? Compteur de passes ? Période réfractaire ?
5. **Bootstrap** — Comment le cerveau démarre la première fois ? État initial minimal ?