
de repo-atlas20
Génère un atlas de contexte persistant au sein du dépôt qui cartographie une base de code : arborescences de répertoires, points d'entrée, documentation d'architecture et supports d'onboarding pour les agents et le moteur.
Repo Atlas est une compétence procédurale qui génère un atlas structuré au sein du dépôt pour aider les humains et les agents LLM à comprendre rapidement une base de code. Il fournit un petit script générateur ainsi qu'un flux de travail pour créer docs/atlas/ (carte du dépôt, architecture, modèle de domaine, flux critiques, points de vigilance, matrice de tests) sans modifier le code d'exécution. L'atlas est destiné à être spécifique au dépôt et à inclure des chemins de fichiers et des exemples réels plutôt que des conseils génériques.
Utilisez Repo Atlas lors de l'intégration de contributeurs, de la préparation d'une base de code pour l'automatisation pilotée par LLM, ou de la création d'une documentation persistante pour la maintenance à long terme. Il est particulièrement utile avant de demander à un agent de modifier ou de refactoriser du code, afin que l'agent puisse s'appuyer sur une carte organisée et éviter le bruit exploratoire.
scripts/generate_atlas.py) pour produire docs/atlas/repo-map.md et des extraits de changelog (la compétence inclut des modèles et des exemples).Conçu pour Claude Code et d'autres frameworks d'agents qui bénéficient d'un contexte au niveau du dépôt et de documents structurés ; fonctionne avec l'outillage local basé sur Python pour la génération et la vérification.
Repo Atlas génère une documentation de contexte persistante (arborescences de répertoires, points d'entrée, journaux de modifications, documents d'architecture) pour n'importe quelle base de code afin que les agents LLM puissent s'y orienter efficacement. Le script generate_atlas.py intégré est un code Python 3 bien structuré utilisant uniquement la bibliothèque standard, qui a planté dans le sandbox car il résout REPO_ROOT relativement à l'emplacement du script et tente d'écrire dans /docs/atlas — il est conçu pour être exécuté à l'intérieur d'un dépôt réel, pas isolément. Aucun problème de sécurité ; pas d'appels réseau, pas d'identifiants, pas de commandes destructrices.
Compétence solide et bien documentée pour une tâche réellement utile. L'échec du script dans le sandbox est attendu — il est conçu pour être sensible au contexte du dépôt, ce n'est pas un bug. Profil de sécurité propre : pure bibliothèque standard, pas de réseau, pas de secrets.