Aller au contenu

Architecture & disciplines du Bricks Brain

Comment ce cerveau est organisé, et les disciplines qui le gardent utile sans l'alourdir. C'est le complément humain de AGENTS.md (qui, lui, est le schema normatif pour l'IA). À lire après le HUB d'onboarding.

1. Trois couches, jamais mélangées

Couche Quoi Règle
Layer 1 — sources (inbox/) brut : Linear, Slack, Leexi, notes immuable — on lit, on ne modifie jamais
Layer 2 — wiki (le reste en racine) savoir dérivé, organisé PARA IA-owned, sauf zones humaines
Layer 3 — schema (AGENTS.md, .cursor/rules/) les règles co-évolué humain + IA

2. PARA — où range-t-on quoi

Organisation PARA (Forte), enrichie de primitives « entités » :

  • projects/ — initiatives avec un scope et une fin (un outcome visé).
  • areas/ — responsabilités permanentes (produit, tech, design, commercial, finance, rh) : vues transverses, pas de fin.
  • resources/ — référence stratégique stable (vision, personas) — édition humaine.
  • archives/ — ce qui est clos / déprécié.
  • people/, concepts/, decisions/ — les entités : une personne / un concept / une décision = une page.
  • inbox/ — Layer 1 brut. private/<toi>/ — ton sanctuaire local.

Test rapide : début + fin → projects/ ; responsabilité continue → areas/ ; notion récurrente → concepts/ ; choix actant → decisions/.

3. Le compile : inbox → wiki

Une source brute n'est pas « rangée » telle quelle. Elle est compilée : un ingest lit la source et met à jour 10-15 pages d'entités (avec citation vers le brut). Le brut reste dans inbox/, le wiki pointe vers lui. Le wiki compound — il devient plus riche à chaque ingest, sans jamais dupliquer la source.

4. Discipline anti-bloat (le cœur)

On ne documente pas tout — on documente les concepts et patterns récurrents, pas chaque détail. C'est ce qui empêche le cerveau de devenir un dépotoir.

  • Une page concept naît à ≥ 3 mentions d'un sujet. En dessous : ça reste un signal faible dans le journal, pas une page.
  • Librarian, not author : on pointe vers la source, on ne la recopie pas. Ratio synthèse/citations borné (~70/30).
  • Les transcripts complets restent dans inbox/ ; les fiches meetings/ ne sont que des résumés liés.
  • Consolidation : un même fait vu dans 3 sources → une page avec 3 citations, pas 3 pages.
  • Résultat : on gagne en densité de sens, pas en volume de bruit.

5. Pages d'entités & zones auto

Une entité = une page avec frontmatter + une zone <!-- auto:start -->…<!-- auto:end -->. L'IA écrit dans la zone auto (état courant, enrichi à chaque ingest) ; tout le reste est humain (contexte stable). On ne mélange jamais les deux. Détail : .cursor/rules/entity-pages.mdc.

6. La pulse : sujets chauds vs référence

Le cerveau a deux temporalités :

  • La référence stable — resources/, decisions/, concepts/, pages d'entités : l'état consolidé. C'est ce qu'on cite pour décider.
  • Le vivant / les sujets chauds — journal/ : le daily-pulse (matin) et le weekly-digest (lundi) surfacent ce qui bouge, les signaux faibles, ce qui est chaud cette semaine. Jamais canonique — c'est le radar, pas la vérité.

On lit la référence pour trancher, le journal pour sentir ce qui bouge. Un sujet chaud qui se confirme gradue vers une page de référence.

7. Archivage — déplacer, pas effacer

Projet clos depuis >6 mois, décision deprecated → archives/. On déplace, on n'efface jamais : l'historique reste consultable. Le wiki actif reste centré sur le présent.

8. Hiérarchie d'autorité

Pour répondre / synthétiser, on cite la source la plus haute :

resources > decisions > entités (people / projects / concepts) > areas > journal > inbox

Le journal/ n'est jamais cité comme vérité pour une décision. L'inbox/ sert au sourcing, jamais exposé tel quel. Détail : AGENTS.md § Hiérarchie d'autorité.

9. Carte des domaines (areas/)

Chaque domaine est une responsabilité permanente, documentée selon le même schema. La structure est partagée ; le contenu réel est souvent local/internal (provisionné hors du clone public, cf. formalisation & confidentialité).

Domaine Couvre Où vit le contenu
Produit north stars & métriques, features connues, arbitrages produits, discovery structure partagée · contenu local/internal
Tech archi, standards, criticité, dette, workflow agent structure partagée · contenu local
Design design system, parcours, QA design structure partagée · contenu local
Commercial / Finance / RH pipeline, chiffres-clés, équipe local/restricted

La couche Produit est volontairement riche (features, arbitrages) mais son contenu est internal : il se provisionne en local, il n'est pas dans le tronc commun public par défaut. Voir le HUB et la passe de partage produit dédiée.

Sources & liens