Aller au contenu

Bienvenue dans le Bricks Brain

Page HUB. Si tu débarques, lis ça en entier (10 min) — c'est la carte. Tout le reste s'y rattache.

Le Bricks Brain est un second cerveau d'équipe : un repo Git en Markdown, maintenu par l'IA, qui sert de source de vérité vivante (décisions, projets, concepts, méthodo). Pattern LLM Wiki (Karpathy) + organisation PARA (Forte).

1. Pourquoi (les enjeux)

  • Arrêter d'éparpiller la connaissance (Notion endormi, threads Slack, têtes). Une seule source vivante.
  • La connaissance se compile une fois puis se maintient incrémentalement : chaque source ingérée met à jour 10-15 pages. Le wiki se densifie tout seul.
  • L'IA (dans Cursor) raisonne dessus : prep de réunion, specs, priorisation, réponses sourcées.

2. Le modèle mental

Trois couches, jamais mélangées :

Layer 3 — SCHEMA      AGENTS.md + .cursor/rules/ + scripts/config/   (les règles)
Layer 2 — WIKI        concepts/ projects/ people/ decisions/ ...     (le savoir dérivé, IA-owned)
Layer 1 — SOURCES     inbox/ (Linear, Slack, Leexi, notes)           (brut, immuable)

Tronc commun partagé vs couche privée :

  • Ce que tu reçois au clone = le tronc commun (méthodo, lentilles, pipeline, commandes, templates, concepts génériques). Synchronisé via Git.
  • private/<toi>/ = ta couche perso (notes, brouillons, objectifs, ton profil). Elle ne quitte jamais ta machine (gitignored, donc absente du clone des agents cloud) — mais ton IA locale (Cursor) la lit et s'en sert pour te personnaliser et raisonner avec ton contexte. Seule règle dure : ne jamais la citer comme source dans un doc partagé (ce serait une fuite).

Deux principes qui gouvernent tout :

  • Librarian, not author — les pages pointent vers les sources, ne les réécrivent pas. Ratio synthèse/citations borné.
  • Citations obligatoires — toute affirmation est sourcée, ou marquée [non sourcé].

Comment c'est rangé et les disciplines qui gardent le cerveau léger (PARA, anti-bloat, sujets chauds, archivage) : concepts/architecture-bricks-brain.md — l'explainer humain. Le schema normatif complet (pour l'IA) : AGENTS.md.

3. Démarrer (2 min)

Prérequis commun : clone le repo, ouvre-le comme racine de projet dans ton IDE agent (Cursor ou Claude Code). Les commandes slash vivent dans .cursor/commands/ — pas besoin d'installer un plugin marketplace.

Dans Cursor ou Claude Code : tape /onboard dans l'agent — il fait le setup et te guide en conversation (il te demande juste ton handle, dans le chat).

En ligne de commande si tu préfères :

cd scripts
npm install
npm run onboard      # parcours guidé (idempotent, ne pousse rien)

onboard installe le hook de protection, crée ton espace privé, prépare ton .env. Les clés API ne servent qu'au pipeline (ingest, digests) — pour un usage agent local, tu peux les laisser vides.

Claude Code : lance la session depuis le dossier cloné (cd bricks-brain puis claude). Tape / pour voir les commandes marquées (project). Si elles n'apparaissent pas, vérifie que .claude/commands pointe bien vers .cursor/commands (ls -la .claude/commands) et mets Claude Code à jour (≥ 2.1.90 — bug connu sur les commandes projet en 2.1.88–89).

4. Utiliser au quotidien

Tu parles à l'IA en langage naturel en mode Agent — elle connaît le schema (AGENTS.md + .cursor/rules/) et l'applique.

Commandes (tape / ou /help pour la liste à jour de ton clone) :

  • /help — catalogue des commandes disponibles
  • /sync — récupère / envoie les évolutions du tronc commun (début & fin de session)
  • /profil — ce que l'IA sait de toi ; se personnalise au fil de l'usage
  • /handoff, /design-qa — workflows design (handoff Figma → dev, QA visuelle)

Gestes typiques (en langage naturel) :

  • « Ingère ce transcript / cette note » → met à jour les pages d'entités concernées.
  • « Que sait-on sur ** ? » → réponse sourcée depuis le wiki.
  • « Rédige un ticket Linear pour ** » → spec passée à la lentille lean.
  • « Génère une maquette Figma de <écran> » → design system Bricks.

Conseils :

  • Dépose tes sources brutes dans inbox/, puis demande un ingest — ne réécris pas une source à la main.
  • Tes brouillons, doutes, notes perso → private/<toi>/. Tu peux tout y mettre, rien n'en sort sans ton action.
  • Lance /sync en début de session (récupérer) et en fin (envoyer) pour rester aligné avec l'équipe.
  • Un sujet structurant (plusieurs livrables / personnes) = un Linear project, pas une issue fourre-tout.
  • N'écris rien de sensible dans une page partagée (cf. §6) — l'IA t'aide à router.
  • Pour savoir qui fait quoi dans l'équipe : people/team-directory.md.

5. Les lentilles (ce que l'IA applique automatiquement)

Des règles alwaysApply qui orientent chaque production. Tu n'as rien à invoquer, elles s'activent au bon moment :

Lentille S'active quand Ce qu'elle force
Lean PM priorisation, spec, ticket, cadrage produit problème → hypothèse → outcome (pas juste « livrer »)
Design sujet UI/UX parcours, états, fidélité, plan de test, QA design
Réunion & cadrage réunion, fiche meeting, débrief preuve > opinion, hors-scope, décision + next steps
Formalisation & confidentialité écriture dans le partagé écrire propre : le sensible va en local, pas sur le remote

6. Confidentialité — écrire propre dès l'origine

Le remote est traité comme public (par prudence) ; on y écrit donc propre à l'entrée plutôt que de filtrer après coup.

Test de sensibilité — un contenu va en local (private/ ou page gitignored) s'il porte : nom + jugement sur une personne · chiffre business non public · incident / faille · stratégie / donnée client / info financière. Sinon → partageable.

Règle d'or : relocaliser, pas supprimer ; abstraire, pas omettre. Le détail sensible descend en local (sourcé), le partagé garde le pattern. Un fichier confidentiality: restricted n'est jamais committé (le pre-commit le bloque).

Détail : concepts/formalisation-confidentialite.md · docs/private-space.md.

7. Carte des concepts clés (le tronc commun)

index.md (le catalogue exhaustif) est local et auto-généré. Voici les concepts partagés à connaître.

Le système

Produit & delivery

IA dans le dev

  • ai-coding-vibe-coding — cadre vibe coding vs AI-assisted, criticité
  • mcp — interface LLM ↔ API/data (connecteurs)

Design

Méthode d'animation

8. FAQ & pièges

  • « Je ne vois pas encore tout le contenu d'équipe. » Le partage se fait par vagues : le contenu d'équipe internal (projets, concepts, décisions, méthodo, areas) est progressivement mis en commun ; seul le confidentiel reste local (perso, transcripts, et le restricted : clients, finance, RH, partenaires/légal). Tu contribues au même contenu que l'équipe, tu ne reconstruis pas le tien. Cf. ADR remote team-internal.
  • « Faut-il les clés API ? » Seulement pour faire tourner le pipeline (ingest, daily-pulse, digests). Pour un usage IA dans Cursor, non.
  • « Où je mets mes notes perso ? » Dans private/<toi>/. Jamais synchronisé. Voir docs/private-space.md.
  • « Comment je partage une note privée vers le wiki ? » npm run graduate — l'IA propose, tu valides.
  • « J'ai écrit un truc sensible dans une page partagée. » Demande à l'IA de le relocaliser ; le pre-commit bloque de toute façon les fichiers restricted.
  • « Comment je reste à jour avec l'équipe ? » /sync en début/fin de session.

Des questions ou un manque dans cette page ? Dis-le à l'IA — elle peut la mettre à jour (c'est aussi du tronc commun).