Gérer le contexte de l'IA avec un magasin de connaissances SQLite et des outils MCP

Un problème courant avec les agents de codage IA : les fichiers CLAUDE.md atteignent des milliers de lignes, consommant le budget de contexte et faisant que l'IA ignore de toute façon la moitié des règles. Un développeur sur r/ClaudeAI a construit un système pour résoudre cela — RunawayContext (sous licence MIT, actuellement utilisé pour des intégrations de gestion de construction avec Vista, Procore, Monday.com, etc.).

Architecture

L'idée centrale : déplacer les connaissances approfondies d'un fichier markdown plat vers une base de données SQLite avec recherche en texte intégral (FTS5) et recherche vectorielle optionnelle via sqlite-vec. Au lieu de tout charger à chaque session, seuls un petit brief par projet (~150 lignes), une constitution globale (~200 lignes) et une "mémoire vivante" de type pointeur (~50 lignes) sont chargés au préalable. L'IA interroge la base de données à la demande en utilisant des outils MCP comme search_lessons et get_chunk.

Détails clés de l'implémentation

• Calcul des tokens : Les ~280K tokens équivalents existent toujours — ils sont simplement dans la base de données, pas chargés dans le contexte. L'IA récupère ce dont elle a besoin en cours de tâche.
• Limites codées en dur : Le régénérateur refuse d'écrire un brief au-delà de sa limite de 150 lignes. 15 règles architecturales nommées ont chacune des tests CI associés qui échouent si la règle dévie.
• Récupération hybride : La recherche vectorielle seule était moins bonne que l'hybride. Le système combine les scores de mots-clés FTS5 avec les scores vectoriels de sqlite-vec pour de meilleurs résultats.
• Validation humaine : L'IA écrit de nouvelles leçons dans une boîte de réception de brouillons. Un humain doit approuver avant la promotion dans le magasin de connaissances, évitant ainsi le bruit.
• Voix préservée : Les briefs générés automatiquement contiennent un bloc rédigé à la main, délimité par les marqueurs <!-- PRESERVE_START -->. Le régénérateur conserve cette section intacte tout en régénérant tout autour.

Leçons apprises

• Appliquez les règles dans le code, pas dans les politiques — chaque instruction "attention à ne pas grandir" a été violée en quelques mois.
• La recherche hybride FTS5 + vectorielle surpasse la recherche vectorielle seule.
• Les écrits directs de l'IA dans le magasin de connaissances introduisent du bruit ; utilisez une boîte de réception de brouillons avec approbation manuelle.

Le système est indépendant de l'agent et le dépôt est public pour que chacun puisse l'adapter.