jlholm/noodle

Cerveau

Mémoire persistante entre les sessions. Vault Obsidian dans brain/.

Le cerveau est le fondement de l'ensemble du flux de travail — chaque agent, compétence et session le lit. Un contenu de mauvaise qualité ou spéculatif dégrade tout ce qui en découle. Avant d'ajouter quoi que ce soit, demandez-vous : « Est-ce que cela améliore réellement le fonctionnement du système ? » Si la réponse n'est pas clairement oui, n'écrivez pas.

Avant d'écrire

Lisez d'abord brain/index.md. Ensuite, lisez le point d'entrée pertinent pour votre sujet :

• brain/principles.md pour les mises à jour de principes
• brain/plans/index.md pour les notes liées aux plans

Pour les répertoires sans fichier d'index dédié pour l'instant (brain/codebase/, brain/audits/), scannez directement les fichiers voisins et modifiez une note existante si possible.

Structure

brain/
├── index.md              ← point d'entrée racine, liens vers tout
├── principles.md         ← index pour principles/
├── todos.md              ← backlog produit
├── vision.md             ← elevator pitch + lien vers l'architecture
├── architecture.md       ← référence technique complète
├── principles/           ← principes d'ingénierie et de conception
├── codebase/             ← connaissances spécifiques au projet et pièges
├── plans/                ← plans de fonctionnalités numérotés (02-arrow-bindings/, etc.)
└── audits/               ← audits de conception et de qualité (noms de fichiers préfixés par la date, ex. 2026-02-20-quality-audit.md)

Règles :

• Un sujet par fichier. brain/codebase/noodle-spawn-gotchas.md, pas un méga-fichier.
• Maintenez les points d'entrée d'index existants : brain/index.md, brain/principles.md, brain/plans/index.md.
• Si vous introduisez une nouvelle catégorie de premier niveau, ajoutez un point d'entrée de type index pour celle-ci (liens uniquement, pas de contenu intégré).
• brain/index.md est la racine. Chaque fichier cérébral doit être accessible depuis celui-ci.
• Noms de fichiers : minuscules, avec traits d'union. worktree-gotchas.md.
• Répertoires de plans : préfixés par l'ID de la tâche de brain/todos.md. 02-arrow-bindings/ avec overview.md et phase-N-*.md à l'intérieur.

Wikiliens

Format : [[section/nom-de-fichier]]. Ordre de résolution : même répertoire, puis chemin relatif, puis racine du vault. Les ancres de titre ([[fichier#titre]]) sont supprimées lors de la résolution.

Style d'écriture

• Listes à puces plutôt que prose. Pas de préambule.
• Markdown simple avec # Titre. Pas de frontmatter Obsidian.
• Gardez les notes sous ~50 lignes. Divisez si plus long.

Après l'écriture

Mettez à jour brain/index.md pour tous les fichiers que vous avez ajoutés ou supprimés. Mettez également à jour le point d'entrée pertinent (brain/principles.md, brain/delegation.md, ou brain/plans/index.md) le cas échéant. Gardez les indexes composés uniquement de liens et faciles à parcourir.

Test de durabilité

Demandez-vous : « Est-ce que j'inclurais ceci dans une invite pour une tâche différente ? »

• Oui → écrivez dans brain/. C'est de la connaissance durable.
• Non, c'est spécifique au plan → mettez à jour le document de phase du plan à la place.
• Non, c'est un problème de compétence → mettez à jour le fichier de compétence directement.
• Non, cela nécessite un suivi → déposez une tâche avec la compétence todo.

Maintenance

• Supprimez les notes obsolètes ou subsumées.
• Supprimez les fichiers aux noms aléatoires dans brain/plans/ — artefacts de mode plan obsolètes.
• Fusionnez les notes qui se chevauchent avant d'en ajouter de nouvelles.