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 ?