codecartographer

CodeCartographer est un framework pour comprendre une base de code inconnue avec un agent de codage IA et produire une spécification de réimplémentation validée et agnostique au langage. Il est distribué comme extension Pi, serveur MCP, ou modèle prêt à l'emploi `.codecarto/` de fichiers Markdown et YAML. Fonctionnement : le « code » est du Markdown structuré plus du YAML dans `.codecarto/`. `GUIDE.md` est le point d'entrée LLM, `workflow/pipeline.yaml` définit les phases et dépendances, `workflow/status.yaml` contient l'état mutable par projet, et `workflow/VALIDATE.md` décrit le protocole de validation. Les phases forment un DAG — contrats et protocoles peuvent s'exécuter en parallèle après l'architecture, le portage attend les deux, et la spécification de réimplémentation est en dernier. L'hôte lit le pipeline actif, trouve la prochaine phase dont les dépendances sont complètes, donne au LLM les instructions de cette phase, valide la sortie et avance l'état. Preuves et validation : chaque phase écrit un artefact plus petit, basé sur un modèle et étiqueté de preuves sous `.codecarto/findings/`, et les phases ultérieures relisent les fichiers amont spécifiques dont elles ont besoin. Les constats sont étiquetés comme fait observé, inférence forte, risque de portabilité, affirmation de comportement externe, ou question ouverte. Chaque sortie de phase se termine par un tableau `## Validation` marquant chaque critère d'achèvement PASS, PARTIAL ou FAIL avec preuve ; la validation analyse ce tableau et recoupe l'appariement preuve/action et les sorties secondaires déclarées, refusant d'avancer sur un FAIL, une sortie manquante ou un verdict illisible. Les artefacts produits incluent une carte d'architecture, rapport de défauts, suivi de correction de défauts, contrats comportementaux, protocoles et état, un ensemble de portage, et la spécification finale de réimplémentation avec modules, scénarios d'acceptation et inconnues connues. Variantes de pipeline : la valeur par défaut est une exécution d'audit approfondi en 7 phases qui divise l'analyse des défauts en passes mécanique et sémantique. Autres variantes : scout-first (8 phases), full-with-audit (6), full (5), defect scan (2), lite (3), architecture-only (1), et synthesis (4). Les variantes peuvent être changées en place sans supprimer constats ou progrès. Résilience de contexte : le système de fichiers, pas la conversation, est la mémoire durable. Chaque phase obtient une fenêtre de contexte fraîche ; les constats terminés vivent sur disque ; `status.yaml` enregistre progrès, questions ouvertes, éléments reportés et backlog post-pipeline. Les transcriptions de phase Pi sont sauvegardées sur fichier et restent disponibles via `/resume`, `/tree` et `/export`. Les résumés de compactage conscients de la phase sont checkpointés sous `.codecarto/scratch/checkpoints/`. Le README note que la pression de contexte intra-phase est bornée plutôt qu'éliminée. Surfaces et fonctionnalités : l'extension Pi ajoute commandes slash, widget d'agents en direct, sessions de phase sauvegardées sur fichier, résumés d'achèvement de phase, invites de départ pilotées par LLM en option, suivi d'utilisation par phase et interception d'outils (bash bloqué ; édition/écriture confinée à `.codecarto/`). Le serveur MCP expose invites de phase, validation et opérations expérimentales de publication/liste/réindexation de bibliothèque pour autres agents compatibles MCP. Un tableau de bord HTML à fichier unique agrège progrès, liens, utilisation et résumé narratif optionnel. La synthèse avant combine vision produit avec spécifications de bibliothèque confirmées par humain en plan de projet traçable, avec vérifications préalables d'exécution exigeant confirmation humaine explicite avant fusion ou finalisation.