Système de mémoire
Cette compétence fournit une couche de persistance pour la mémoire locale d'un projet, dans <project_root>/memories/, via scripts/memory <cmd> (basé sur references/memory_tool, la source de vérité déterministe de cette couche — ne modifiez jamais sa sortie et ne la réimplémentez pas). Elle ne présuppose pas que l'hôte ne possède aucun autre mécanisme de mémoire ; si tel est le cas, traitez celle-ci comme une couche supplémentaire basée sur fichiers, en parallèle. La sortie standard est en JSON ; utilisez read à nouveau pour confirmer l'état sur disque.
Depuis la version 1.1.0, init crée également un fichier caché <project_root>/.memsys-db (SQLite + FTS5, journal_mode=DELETE, un seul fichier, sans -wal/-shm) — l'index et le plan de recherche régénérables. Le Markdown reste la source de vérité.
Commencez ici, dans l'ordre :
- references/protocol.md — le workflow complet ingestion → récupération → raisonnement → réflexion → exécution → empaquetage, ainsi que les commandes et invocations de démarrage rapide.
- references/layout.md — la disposition du stockage et ce qu'il faut charger pour une requête donnée.
- references/when-to-save.md — classification : compétence vs. index vs. sujet vs. rejet, et routage compétences vs. mémoire.
- references/constitution.md — règles strictes (ne jamais ignorer l'analyse des secrets, ne jamais dépasser 200 lignes, ne jamais écrire en dehors de
memories/, ne jamais énumérer via bash, ne jamais utiliser WAL pour le registre). - references/memsys-db.md — le contrat du registre
.memsys-db: schéma,search/reindex/forget, et pourquoi la base de données ne prévaut jamais sur le Markdown. - references/examples.md — exemples concrets : chemin heureux, rejet de secret, récupération d'écrasement.
Vérifiez l'installation avec scripts/memory selftest avant la première utilisation.