altRAG : Remplacez la base de données vectorielle RAG par des fichiers pointeurs de 2 Ko pour les agents d'IA de codage

Ce que fait altRAG

altRAG résout le problème des agents de codage IA qui peinent avec de gros fichiers de compétences de 200KB en remplaçant la génération augmentée par récupération (RAG) de base de données vectorielle par une approche plus simple basée sur des pointeurs. L'outil crée un fichier squelette léger qui mappe les sections du document à leurs emplacements exacts, éliminant le besoin d'embeddings, de découpage ou de bases de données.

Comment ça fonctionne

altRAG scanne vos fichiers de compétences Markdown ou YAML et construit un fichier squelette TSV (extension .skt) qui mappe chaque section à son numéro de ligne exact et à son décalage d'octets. Ce fichier squelette fait environ 2KB.

Lorsque votre agent IA a besoin d'informations, il lit d'abord le fichier squelette, trouve la section spécifique dont il a besoin, puis lit uniquement ces lignes du document original. Cette approche est particulièrement efficace pour la documentation structurée où vous savez déjà où se trouvent les informations.

Fonctionnalités clés de la source

• Crée des fichiers squelettes de 2KB au lieu d'utiliser des bases de données vectorielles
• Fonctionne avec les fichiers de compétences Markdown et YAML
• Génère des fichiers squelettes au format TSV (extension .skt)
• Mappe les sections aux numéros de ligne exacts et aux décalages d'octets
• Zéro dépendance
• Nécessite Python 3.10+
• Sous licence MIT

Installation et configuration

L'installation est simple :

pip install altrag
altrag setup

Compatibilité

L'outil fonctionne avec divers agents de codage IA, notamment Claude Code, Cursor, Copilot, Windsurf, Cline et Codex — essentiellement tout système capable de lire des fichiers.

Avantages du mode Plan

Le mode Plan bénéficie considérablement de cette approche. Selon la source, il permet aux agents de construire des arbres de compétences tout en utilisant un contexte précoce et sans encombrement pour créer des plans "presque chirurgicaux".

Cas d'utilisation

Cette approche est spécifiquement conçue pour la documentation structurée où les développeurs savent déjà où se trouvent les informations, rendant la RAG de base de données vectorielle excessive. Elle est particulièrement utile lorsque les agents IA doivent référencer des sections spécifiques de documentation sans charger des fichiers entiers dans le contexte.