/// Signal

Readable Node : rendre un workflow ComfyUI lisible, c’est le réécrire — et son auteur parle moins d’un programme que d’un « corps de loi »

Le fait : un skill d’agent, publié sous licence MIT, rend un workflow ComfyUI lisible — et pour cela il le réécrit entièrement. Il ne range pas des nœuds : il défait le graphe, devine ce qu’il fait, sépare en plusieurs fichiers un workflow qui empile plusieurs tâches, puis reconstruit chaque partie en remplaçant les nœuds personnalisés par des nœuds du cœur. Son auteur prévient lui-même que la sortie « may not always match the original exactly » — elle ne correspondra pas toujours exactement à l’original, et annonce dix minutes pour un graphe d’environ 25 nœuds, vingt à quarante pour un gros. Le dépôt a été créé le 19 octobre 2026, sa première version date du 8 novembre, il porte vingt et une étoiles au 12 novembre, et il lui faut un modèle haut de gamme pour donner son meilleur. Trois réserves à poser d’emblée. L’outil n’est pas un formateur : c’est une réécriture, et l’article le dit à chaque fois qu’il le faut. La définition de « lisible » qu’il applique est celle d’une personne, ce que son auteur reconnaît sans détour. Et l’essentiel du débat qu’il a provoqué ne porte pas sur sa vitesse, mais sur le droit de trancher à sa place.

Le document d’abord, parce qu’il décide de tout ce qui suit. Le dépôt s’appelle nomadoor/comfyui-readable-node, il est en Python, il pèse 656 Ko, sa licence est MIT, et sa première version — 0.1.0 — a été publiée le 8 novembre 2026. La deuxième phrase de son README refuse le malentendu : « It doesn’t just tidy up the layout with a script. The AI takes the workflow apart and works out what it does. » La suite précise le mécanisme, et c’est là que se joue la différence avec un simple rangement : « A workflow that packs several tasks into a single file is split into separate workflows, one per task, and each is rebuilt from scratch following the rules below. » Le skill lit deux choses pour travailler — votre ComfyUI local, d’où il tire la liste des nœuds réellement installés (ce qui impose de lancer ComfyUI avant l’agent), et les workflows publiés sur le site de son auteur, comfyui.nomadoor.net, qui peuvent lui servir de référence. Ses scripts ont besoin de Python 3, bibliothèque standard uniquement, et l’installation se fait comme plugin de l’application de bureau Claude ou de ChatGPT (Codex), en ligne de commande, ou par `npx skills add` pour les autres agents — cette dernière voie exigeant Node.js 22.20 au minimum.

Les six règles sont écrites noir sur blanc, et elles disent tout du parti pris. Ne pas cacher de nœuds — déplier les sous-graphes, ouvrir les nœuds repliés, ne pas superposer. Ne pas cacher les fils — reconvertir en vrais fils les liens sans fil que sont Set/Get et Anything Everywhere, et éviter les dispositions « Bento » qui serrent les nœuds au point que les fils disparaissent. Aller de gauche à droite, dans l’ordre du traitement. Un workflow, une tâche — plutôt que de tout mettre dans un seul fichier avec des aiguillages, le découper en petits workflows qui font chacun une chose. Garder le moins de nœuds personnalisés possible : ce qui se construit avec des nœuds du cœur se construit avec des nœuds du cœur. Et colorer par fonction. La définition qui coiffe ces règles mérite d’être citée dans son entier, parce qu’elle est plus exigeante qu’un goût. Dans le README : être lisible, c’est « you can tell at a glance what the workflow does, it runs reliably, and it is easy to rework ». Dans le fil Reddit qui annonce le skill, l’auteur dit la même chose autrement, et la suite est plus tranchante : « It’s not about looking pretty. It’s about being easy to understand and easy to change. » Trois critères, dont deux ne se voient pas sur une capture d’écran.

Le coût, maintenant, tel que la source le chiffre. « A workflow of about 25 nodes takes around 10 minutes. A large workflow can take 20 to 40 minutes. » Dix minutes pour vingt-cinq nœuds, c’est un ordre de grandeur qui décide de l’usage : on ne fait pas tourner cet outil entre deux rendus. Interrogé sur cette lenteur dans le fil de r/StableDiffusion, l’auteur ne la corrige pas, il l’explique : « It’s slow because it puts accuracy first: it looks into the custom nodes the workflow uses, and has another agent review the result. » Il ajoute qu’on peut demander un mode « rapide », qui saute quelques étapes — et il le déconseille lui-même comme solution. La contrainte de modèle va dans le même sens. Le README recommande Claude Opus 5.5, avec lequel le skill a été développé ; il concède que « GPT 6.1 / 6.0 Astra also work, but the layout may still have a few issues ». Dans le fil, un cran plus bas dans la gamme, l’auteur est plus net : « even switching to Sonnet made the results noticeably worse ». Autrement dit, un outil libre dont l’usage confortable suppose un modèle haut de gamme — ce n’est pas une objection, c’est une condition à connaître avant d’essayer.

Ce que l’outil produit ensuite mérite qu’on s’y arrête, parce que c’est là qu’il prend soin de son lecteur. Il écrit un fichier dont le nom est celui de l’original, suffixé de `_readable`, et — c’est souligné dans le README — « The original file is not overwritten ». Il ajoute un `report.html` qui se lit dans un navigateur et offre trois vues : la comparaison avec l’original, le rejeu des déplacements de l’IA sur une frise, un pas à la fois, et une visite guidée du résultat expliquée partie par partie. Le fichier de sortie n’écrase donc rien, et le rapport rend le travail de l’IA inspectable — deux décisions qui répondent d’avance à la crainte la plus légitime devant un outil qui réécrit votre travail. Reste la phrase qui compte le plus, et elle est du même auteur : « It preserves what the original workflow does as much as possible, while replacing custom nodes with core nodes and rebuilding parts more simply where it can, making the workflow more robust without changing its purpose. » « Autant que possible » n’est pas « à l’identique », et le fil Reddit l’assume sans détour : « Since it aims for a more robust workflow, the output may not always match the original exactly. » Pour un graphe qu’on a téléchargé quelque part et dont les nœuds personnalisés portent le résultat, c’est l’information décisive de tout l’article. L’auteur vise d’ailleurs précisément ce cas : « I mostly hope people use it when they’re trying to make sense of something they downloaded from Civitai with hundreds of features crammed in. »

Le débat, enfin, et il est meilleur que l’outil. Le point de friction n’est pas la lenteur : ce sont les règles de structure — déplier les sous-graphes, reconvertir en vrais fils les liens sans fil, et surtout la quatrième, « One workflow, one task » — et ce qu’elles impliquent. Un commentateur défend l’abstraction avec des mots très proches de la définition de l’auteur : « But subgraph make things readable. It’s one unit of work abstracted away, so you can see more of the bigger picture. » Il ajoute que découper en plusieurs workflows oblige à documenter ailleurs comment les rebrancher, et qu’il faut sauter de l’un à l’autre, ce qu’il juge pénible. Ce n’est pas une objection isolée : plus loin dans le fil, un autre intervenant s’en prend à la même règle — « One thing I strongly disagree about is one workflow for each task. If I have a new node I want to use, or a new smart solution, then I would need to change in several places. » Un autre, qui porte le badge « Top 1% Commenter » de Reddit, répond exactement l’inverse : « I can not run a workflow I can’t inspect », et plus loin, sans nuance, « Subgraphs are the worst thing that ever happened to comfyui ». Entre les deux, la remarque la plus utile n’est ni pour ni contre : un troisième intervenant explique qu’il n’a pas une seule idée du lisible mais trois, selon ce qu’il fait — apprendre un workflow (pas de sous-graphes, beaucoup de liens nommés), le maintenir (des sous-graphes pour ce qu’on ne touchera jamais), ou s’en servir (compact, avec l’aperçu à côté du prompt). Il demande donc des préférences réglables, et note au passage qu’un Set/Get bien étiqueté lui paraît plus lisible qu’un lacis de fils, « especially for VAE » — c’est-à-dire dans le cas du VAE plus encore qu’ailleurs. L’auteur en rabat d’ailleurs lui-même, plus loin dans le fil : « On subgraphs, I think I came on a little too strong, and I regret that. Used like blueprints, they’re really handy. »

Deux réponses de l’auteur, à deux questions différentes, disent l’essentiel. À quelqu’un qui demande si le skill fait mieux qu’un Claude employé seul, il répond : « AI’s idea of “readable” and a human’s are pretty different. If you just ask plain Claude to “make it readable,” you’ll probably get something neatly aligned, but not quite readable. » Le skill ne serait donc pas un meilleur goût, mais un goût contraint. Puis, à l’intervenant qui réclamait des préférences réglables, il accorde le point : « Thanks! You’re right, it really needs a design with a shared core that you can override with your own preferences. » Suit une réserve qui vaut mieux que bien des articles de fond sur le sujet : « That said, building this skill made me realize how delicate the balance is. It feels less like a program and more like a body of law. » Et l’aveu, dans le même commentaire : « This time I tuned it entirely to my own way of doing things, but I’ll look for a way to make customization more flexible. » Un corps de loi, c’est-à-dire un texte qui tranche des cas que son auteur n’avait pas prévus, et qu’il faudra amender — ce qu’il annonce lui-même. C’est pourquoi les six règles sont un objet éditorial et pas une spécification : une opinion cohérente, tenue par quelqu’un dont le site publie plus de quatre cents workflows, ceux-là mêmes sur lesquels le skill est bâti — « This skill is built on more than 400 workflows published there », dit le README. Un jugement exercé reste un jugement.

Reste la question qui décidera si ce genre d’outil sera encore là dans six mois, et l’auteur l’a posée lui-même avant qu’on la lui pose. « Side note: if AI can build workflows, why care about readability? » Sa réponse ne parle pas de propreté mais de lieu de travail : si l’IA écrit le workflow et que vous voulez le retoucher, où le faites-vous ensemble ? Il compare à la retouche d’image : pour effacer un grain de beauté près d’un œil, peindre par-dessus est souvent plus rapide que d’écrire « remove the mole », c’est-à-dire « enlever le grain de beauté ». Autrement dit : demander à l’IA ce qui se dit mieux en mots, faire à la main ce qui se fait mieux à la main, et se donner un endroit où les deux cohabitent. Le graphe de nœuds de ComfyUI est cet endroit — à une condition, qui est justement celle de l’outil : qu’on puisse le lire. C’est aussi pourquoi le skill sait construire un workflow à partir de rien, et pas seulement réparer un existant. La vraie promesse n’est donc pas « des workflows plus jolis ». C’est : après la réécriture, on peut suivre chaque fil du regard, et donc reprendre la main sur ce qu’une machine a produit. À ce prix — dix à quarante minutes et un modèle de tête —, sur un outil de moins d’un mois et vingt et une étoiles, la seule façon raisonnable de l’essayer est de le faire sur une copie.