Quatre repères. Une architecture.
Event, Handler, State, External.
Une carte pour votre architecture
Votre code est réparti dans des fichiers.
Votre architecture les traverse.
Une carte pour comprendre les événements, les réactions et les frontières de votre système.
Découvrir la carteDu code aux relations
Une sélection de relations vérifiées dans
les tests d’acceptation du projet.
L’essentiel, puis le détail.
FlowAtlas rassemble les relations que le code permet de démontrer. Les détails d’implémentation s’effacent. L’architecture devient lisible.
Event, Handler, State, External.
Les relations connues. Les limites aussi.
Dans le terminal, ou aux côtés d’un agent de code.
694 360 tokens sans FlowAtlas.
350 270 avec son contexte MCP.
Une comparaison exploratoire, cache inclus.
Un résultat observé, pas une moyenne
garantie.
Explore your architecture.
Projet en développement · Installation depuis les sources
Un événement est déclaré ici. Un listener réagit ailleurs. Un reducer met à jour l’état. Une gateway franchit une frontière.
Quelque chose est demandé
ou s’est produit.
Une réaction qui coordonne
des transitions.
Une zone d’état de l’application
qui peut être modifiée.
Une frontière d’exécution,
de communication ou de persistance.
Dans la carte Fragments, likeToggleUseCaseFactory écoute
uiLikeToggleRequested, puis émet likeOptimisticApplied. Cet
événement met à jour likeWlReducer.
Les flèches respectent le sens canonique des relations. Cette illustration présente une sélection du graphe, pas une trace d’exécution.
Voir la preuve dans le code ↗Une relation doit pouvoir se justifier dans le code. Quand une liaison est dynamique ou impossible à résoudre statiquement, FlowAtlas ne l’invente pas.
Deux branches asynchrones peuvent rejoindre le même état sans former une chaîne causale démontrable. La carte préserve cette distinction.
Lire les principes du projet ↗Exemple issu des tests Fragments : écriture optimiste ↗ et rafraîchissement de projection ↗.
Recherchez un élément, explorez son voisinage, remontez en amont ou suivez les relations en aval. La TUI propose trois écrans : Map, Explorer et Inspector.
Commandes et installation ↗$ node dist/index.js find like .
$
node dist/index.js inspect \
uiLikeToggleRequested .
$
node dist/index.js tui \
uiLikeToggleRequested .
Le serveur MCP fournit une projection ciblée du graphe, avec des limites explicites. L’agent s’oriente dans les relations connues, puis consulte les sources.
Découvrir l’intégration MCP ↗flowatlas_find_nodes↗
flowatlas_get_context↗
FlowAtlas est en développement actif. Ses capacités avancent à partir de tests d’acceptation sur des applications réelles.
Parcourir la feuille de route ↗Essayez FlowAtlas depuis les sources. Le package n’est pas encore publié.
git clone https://github.com/nico8156/flowAtlas.git
cd flowAtlas
npm install
npm run build
node dist/index.js scan /chemin/vers/votre-projet
Recherchez un élément avec find, puis utilisez son identifiant exact pour
ouvrir la carte :
node dist/index.js find like /chemin/vers/votre-projet
node dist/index.js tui <nodeId> /chemin/vers/votre-projet
Le projet analysé doit contenir un tsconfig.json. Les motifs Redux
Toolkit pris en charge sont décrits dans le dépôt.
Deux sessions distinctes de Codex CLI ont exploré la même architecture Like et outbox de
Fragments, en lecture seule, à partir de uiLikeToggleRequested. La première
utilisait la recherche habituelle dans le dépôt ; la seconde devait commencer par le
contexte MCP de FlowAtlas, puis lire les sources.
| Mesure | Sans FlowAtlas | Avec MCP |
|---|---|---|
| Tokens d’entrée | 694 360 | 350 270 |
| Dont tokens en cache | 634 496 | 315 264 |
| Fichiers déclarés ouverts | 26 | 18 |
Avec FlowAtlas, l’agent a reçu deux projections du graphe, représentant 9 230 octets de contexte. Les deux sessions ont retrouvé le chemin architectural central et identifié les deux risques de retry décrits dans l’évaluation.
Sur cette tâche, l’exploration assistée par FlowAtlas a consommé moins de tokens d’entrée. Le graphe sert à orienter la lecture ; il ne remplace pas la consultation du code.
Il s’agit d’une seule paire de sessions, pas d’un benchmark statistique. Les tokens d’entrée incluent le cache et ne mesurent pas directement le coût facturé. La session sans FlowAtlas a aussi lancé volontairement trois suites de tests, contrairement à l’autre.
Le modèle utilisé n’a pas été enregistré dans les traces. L’usage de MCP était imposé et l’identifiant de départ était fourni : ni le choix autonome de l’outil ni la découverte initiale n’ont été évalués. Des essais répétés sont nécessaires avant de généraliser ce gain.
Protocole : Codex CLI 0.152.1 · Fragments 0b2956d · FlowAtlas
43f3e33.