Compréhension du codebase
Comprenez plus vite un codebase inconnu.
Parcourez le code, la documentation Markdown, les graphes de relations et l’historique du projet dans un même espace de travail. FiboCode maintient les explications près du code source qu’elles décrivent, afin de transformer des recherches isolées en un parcours d’exploration continu.
Un codebase ne se résume pas aux fichiers que vous pouvez ouvrir.
Un nouveau dépôt s’explique rarement dans l’ordre dont vous avez besoin. Les noms ne racontent qu’une partie de l’histoire, les comportements importants franchissent les limites des modules et la raison d’une décision peut se trouver hors du fichier courant. Lire les fichiers les uns après les autres révèle des détails sans forcément montrer le système dans son ensemble.
FiboCode relie le code modifiable, le Markdown lisible et les graphes navigables. Partez d’une sélection de code pertinente, lisez ou rédigez une explication, puis suivez les relations balisées vers le fichier, le document ou le graphe suivant. Le code reste la source de vérité et les connaissances complémentaires demeurent assez proches pour être vérifiées.
Voyez la compréhension circuler entre les vues reliées.
Commencez par une analyse de tout le codebase, puis étudiez un fichier à partir de sa documentation et de ses graphes de relations avant d’interroger AI sur le code sélectionné.
Une analyse globale donne aux fichiers et répertoires inconnus une structure lisible à partir de laquelle poursuivre l’enquête.
Naviguez entre le code, la documentation et les graphes autour d’un fichier, puis poursuivez à partir de ces connaissances avec une question AI ciblée.
Passez d’une question à un contexte vérifiable.
Le parcours reste ancré dans le dépôt et laisse une piste lisible à la personne suivante.
Commencez par le code à l’origine de la question.
Ouvrez le fichier concerné ou sélectionnez l’implémentation à comprendre. Chaque explication part ainsi d’un contexte source concret plutôt que d’un résumé abstrait.
Lisez ou consignez l’explication en Markdown.
Décrivez le comportement, l’intention, les limites et les questions ouvertes dans un format que les développeurs comme les Coding Agents peuvent lire et améliorer.
Suivez les relations à travers les graphes et les balises.
Passez de l’explication aux modules, décisions ou diagrammes associés. Les balises portent les liens entre code, documentation et graphes sans tout aplatir dans une vue unique.
Vérifiez le modèle dans le code source modifiable.
Revenez au code référencé dès qu’une explication doit être contrôlée. Actualisez les connaissances près de l’implémentation pour que l’exploration suivante commence avec des éléments à jour.
Un espace relié pour étudier le code.
Le code reste la source de vérité.
Les supports renvoient à l’implémentation décrite, ce qui facilite la confrontation d’une explication au comportement réel.
Markdown rend l’intention lisible.
Analyses, décisions et explications restent des connaissances de projet simples que personnes et Agents peuvent lire et écrire.
Les graphes révèlent les relations.
Les vues reliées rendent les relations entre modules et documents visibles et navigables lorsqu’une liste linéaire de fichiers ne suffit pas.
L’historique conserve l’évolution de la compréhension.
Spécifications, conceptions, explications de changements et analyses forment un récit traçable qui peut grandir avec le codebase.
Cas d’utilisation : prendre en main un service que vous n’avez pas créé.
Imaginez que vous héritiez d’un service au chemin de requête inconnu. Partez du gestionnaire, consignez son rôle et utilisez les balises et graphes reliés pour trouver la logique métier et les dépendances en aval. Chaque étape reste liée à un fichier ou document vérifiable.
Le résultat reste utile après la première visite. Un membre de l’équipe peut reprendre la même explication, la confronter au code source et l’étendre lorsque le service évolue, sans recommencer toute l’enquête.
Plus durable qu’un résumé ponctuel du code.
Un résumé généré peut aider, mais une réponse isolée perd vite ses preuves et sa place dans le système. FiboCode traite la compréhension comme un ensemble de ressources reliées : code, documentation, graphes et historique restent des vues distinctes, avec des chemins entre elles.
Cette page aide les personnes à explorer un codebase. Si vous souhaitez ensuite donner à un Coding Agent un contexte durable pour ses futurs travaux, poursuivez avec Contexte du codebase.
FAQ sur la compréhension du codebase
FiboCode remplace-t-il la lecture du code source ?
Non. Le code reste la source de vérité. FiboCode relie les explications et les relations au code source afin que vous puissiez vérifier ce que disent les supports.
Puis-je utiliser une documentation Markdown existante ?
Oui. Markdown sert de surface commune aux explications, spécifications, conceptions, plans, analyses et registres de changements, afin que les connaissances du dépôt restent lisibles par les personnes et les Agents.
Comment les graphes aident-ils dans un dépôt inconnu ?
Les graphes rendent les relations visibles et navigables. Ils complètent le code source et le texte lorsque le comportement traverse plusieurs fichiers ou qu’une limite du système est difficile à voir linéairement.
Est-ce utile uniquement lors de l’intégration ?
Non. Cela facilite aussi l’étude de code ancien, l’analyse d’impact, l’exploration de l’architecture et la compréhension ultérieure des raisons d’une évolution.
Un Coding Agent peut-il utiliser les mêmes connaissances ?
Oui. Les documents Markdown et le contexte relié du projet sont lisibles par les Agents comme par les personnes. Contexte du codebase explique comment ces connaissances soutiennent les tâches suivantes.