Context Cartographer

Que fait Context Cartographer ?

Construisez un petit système de documentation qui permet aux futurs agents de charger uniquement le contexte dont ils ont besoin.

Limite de portée

• Utilisez cette compétence pour la configuration d'un système de documentation, l'audit, la migration, le nettoyage, la restructuration ou lorsque la propriété n'est pas claire.
• Ne l'utilisez pas pour une modification courante lorsque le fichier propriétaire cible est déjà connu.
• Ne l'utilisez pas pour une maintenance durable automatique déjà requise par AGENTS.md, CLAUDE.md, les règles Cursor, docs/architecture.md ou docs/code_rules.md. Appliquez ces instructions locales directement.
• Utilisez-la toujours lorsque l'utilisateur invoque explicitement context-cartographer.

Règles fondamentales

• Résolvez la racine du projet et inventorier les chemins réels avant de lire les fichiers du projet. Ne devinez pas les chemins à partir du répertoire courant ou d'un autre projet.
• Réutilisez les fichiers déjà lus pendant la tâche. Relisez uniquement un fichier modifié, une sortie tronquée ou une plage non lue spécifique.
• Gardez les fichiers d'instructions racines de l'agent courts. Placez les détails durables des sujets dans les fichiers propriétaires sous docs/.
• Utilisez AGENTS.md pour Codex, CLAUDE.md pour Claude Code, .cursor/rules/context-cartographer.mdc pour Cursor, ou des adaptateurs légers pour des cibles multi-agents sélectionnées.
• Inspectez en lecture seule avant de proposer des modifications.
• Préservez les règles existantes spécifiques au projet et modifiez chirurgicalement.
• Ne remplacez, ne déplacez, ne fusionnez ni ne supprimez jamais de fichiers d'instructions ou de documentation existants sans approbation.
• Créez uniquement les fichiers justifiés par les preuves du projet et les besoins actuels.
• Marquez les faits inconnus comme TODO: clarifier ; n'inventez jamais de faits sur le projet.
• Gardez les documents de mémoire du projet en local uniquement par défaut et ajoutez-les au fichier d'ignorance du dépôt, sauf si l'utilisateur demande explicitement de les suivre ou de les publier.
• Vérifiez les liens, le routage des propriétaires, les règles d'ignorance et les références obsolètes après les modifications.

Décisions requises

Avant de créer ou de remplacer des instructions racines d'agent, résolvez :

• cible de l'agent ;
• mode règles de code : utiliser docs/code_rules.md ou ne pas l'utiliser ;
• mode de maintenance de la documentation : maintenance durable automatique ou maintenance sur demande uniquement ;
• traitement de la documentation existante : conserver en l'état, auditer uniquement, migrer après approbation, ou laisser l'agent décider ;
• si les documents de mémoire du projet restent en local uniquement ou sont suivis.

N'inférez pas le mode règles de code ou le mode maintenance de la documentation. Lorsque plus de deux décisions manquent, utilisez le questionnaire fourni.

Les instructions racines générées doivent maintenir la maintenance courante indépendante de cette compétence :

• En mode maintenance durable automatique, mettez à jour le document propriétaire correspondant dans la même tâche chaque fois qu'un travail terminé modifie le comportement durable, l'architecture, la configuration, le déploiement, l'environnement de staging, les données de test, l'accès, l'import/export, les URL publiques, le flux de travail de l'opérateur, le modèle de données, les interfaces publiques, le flux de travail de l'agent ou la propriété de la documentation.
• En mode maintenance sur demande uniquement, mettez à jour la documentation uniquement lorsque cela est explicitement demandé et signalez les documents probablement obsolètes.
• Précisez que la maintenance courante utilise les instructions racines et les documents propriétaires existants directement sans invoquer context-cartographer.
• Si aucun fichier propriétaire existant ne correspond, invoquez cette compétence et suivez le protocole de propriétaire manquant. En mode maintenance durable automatique, classez et créez le plus petit propriétaire justifié automatiquement sans demander uniquement la permission de créer un fichier Markdown.
• Invoquez cette compétence ultérieurement uniquement pour la configuration, l'audit, la migration, le nettoyage, la restructuration, une utilisation explicite ou une propriété vraiment floue.

Routage des références

• Pour une première configuration, lisez toujours references/setup-workflow.md ; il achemine les autres références requises.
• Pour l'audit, la migration, le nettoyage, la restructuration ou la propriété floue, lisez toujours references/existing-docs-workflow.md ; il achemine les autres références requises.
• Lisez references/doc-map.md avant de choisir les fichiers ou la propriété.
• Lisez references/file-templates.md avant de créer des instructions racines ou docs/*.md.
• Lisez references/audit-checklist.md avant d'auditer un dépôt existant.
• Lisez references/cleanup-rules.md avant de diviser, fusionner, supprimer ou renommer des documents.
• Lisez references/question_schema.md avant de créer le questionnaire JSON.
• Lisez references/questionnaire_usage_examples.md uniquement lorsque vous adaptez le flux du questionnaire.

Flux de travail

1. Résolvez la racine du projet et les chemins d'inventaire avec rg --files.
2. Classez le profil du projet, la cible de l'agent sélectionnée, la documentation existante, la propriété, le mode règles de code et le mode de maintenance.
3. Pour la documentation existante, affichez une carte compacte des fichiers actuels, des propriétaires de sujets et des actions de création/mise à jour/suppression planifiées avant de modifier.
4. Appliquez le plus petit changement justifié du système de documentation dans le périmètre autorisé par l'utilisateur.
5. Vérifiez les liens, les noms de fichiers obsolètes, la couverture des propriétaires, les règles d'ignorance locale et les instructions indépendantes de maintenance courante.

Pour un nouveau système, suivez references/setup-workflow.md.

Pour un audit, un nettoyage, une migration, une restructuration ou une propriété floue, suivez references/existing-docs-workflow.md.

Questionnaire

Pour un travail de configuration large avec plus de deux décisions manquantes :

1. Créez .project-questionnaire/questions.json à partir de references/question_schema.md.
2. Définissez language sur la langue de l'utilisateur ou du projet.
3. Validez avec python3 <this-skill>/scripts/questionnaire_server.py --input .project-questionnaire/questions.json --validate-only.
4. Exécutez le serveur sur 127.0.0.1 avec un port automatique.
5. Une fois que l'utilisateur a enregistré et dit qu'il a terminé, lisez les deux fichiers de réponses avant de continuer.

Le mode règles de code et le mode maintenance de la documentation doivent être des choix obligatoires sans valeurs par défaut ni options de recommandation.

Vérification des mises à jour

Exécutez python3 <this-skill>/scripts/check_update.py --json au maximum une fois par jour. Demandez avant d'installer une mise à jour disponible. Augmentez VERSION lors de la publication d'un changement que les utilisateurs installés devraient recevoir.

Critères de sortie

Signalez :

• fichiers créés ou modifiés ;
• liens, routage et références obsolètes vérifiés ;
• politique d'ignorance locale vérifiée ;
• routage de maintenance automatique indépendant vérifié ;
• validation effectuée et toutes les vérifications non exécutées.