Comment dompter le chaos du développement IA avec Comet

Une histoire familière : vous lancez un agent IA, il commence joyeusement à écrire du code, et dix minutes plus tard vous découvrez qu'il "hallucine", écrase des fichiers fonctionnels, ou reste coincé dans une boucle infinie sur la même erreur. Nous sommes habitués à ce que le travail avec les LLM en codage soit soit des sessions de chat courtes, soit des agents autonomes imprévisibles qui nécessitent une supervision constante.

Récemment, je suis tombé sur un projet intéressant appelé Comet. Ce n'est pas juste un autre wrapper autour de l'API OpenAI ou Claude. Les développeurs le positionnent comme un "workflow de tâches longues reprenables". En termes simples : c'est un framework qui fait travailler le réseau neuronal selon un protocole strict, ne perd pas le contexte lorsqu'il s'arrête, et traverse toutes les étapes d'un cycle de développement normal — de la conception à la vérification.

Pourquoi se compliquer quand on a Cursor ou Claude Code

Il semble que pourquoi construire quelque chose de complexe quand les IDE modernes et les outils CLI gèrent déjà bien les choses ? Le problème est la discipline. Un agent classique saute souvent directement dans le code, ignorant la phase de conception appropriée. Comet impose une approche architecturale.

Le projet combine deux méthodologies : OpenSpec (ce que nous faisons) et Superpowers (comment nous le faisons). L'ensemble du processus est divisé en cinq phases :

1. Open — préparation de la proposition et décomposition des tâches.
2. Deep Design — conception détaillée et création du Design Doc.
3. Plan & Build — création du plan d'implémentation et des commits réels.
4. Verify & Finish — tests et rapport de vérification.
5. Archive — synchronisation des spécifications et archivage des modifications.

Il est intéressant de noter que l'agent ne peut physiquement pas passer à l'étape suivante tant que le "garde" (script de vérification) ne se déclenche pas. Par exemple, il ne vous laissera pas fermer une tâche s'il n'y a pas de rapport de test ou si la structure .comet.yaml est violée.

Comment ça marche en pratique

L'installation est standard pour les outils Node :

npm install -g @rpamis/comet
cd your-project
comet init

Après l'initialisation, des configs et un ensemble de compétences pour la plateforme sélectionnée apparaîtront dans votre projet (plus de 30 plateformes sont supportées, incluant Claude Code, Cursor, Windsurf, et même GitHub Copilot).

La fonctionnalité principale que j'ai aimée est la commande /comet. Elle fonctionne comme un point d'entrée avec mémoire. Si vous avez mis le travail en pause, êtes allés prendre un café, ou redémarré votre ordinateur, /comet déterminera à quelle phase le processus s'est arrêté et vous offrira de reprendre exactement à ce point. Vous n'avez pas besoin de re-fournir le contexte à l'agent ou de lui rappeler ce que vous comptiez faire.

D'ailleurs, pour les apprenants visuels il y a comet dashboard. C'est un serveur local qui ouvre un tableau de bord soigné dans votre navigateur montrant toutes les modifications actives, la progression des tâches et l'historique des archives. C'est beaucoup plus beau qu'un journal interminable dans le terminal.

Les trois piliers de Comet

Dans la version 0.4.0, les développeurs ont mis en avant trois scénarios principaux qui couvrent 90% des besoins :

• Codage via /comet : Le workflow principal où l'agent vous guide pas à pas à travers les étapes.
• Création de compétences via /comet-any : Vous permet de construire vos propres chaînes d'actions (compétences) et de les empaqueter en distributions.
• Évaluation via comet eval : C'est probablement la partie la plus techniquement puissante. Au lieu de deviner "mon agent est-il devenu plus intelligent", vous le soumettez à des tests avec les métriques Pass@k et Pass^k. Vous pouvez même intégrer cela avec LangSmith pour une surveillance de production sérieuse.

Fonctionnement technique

Le projet est écrit en JavaScript/TypeScript et fonctionne comme un runtime Node.js pur. C'est un grand plus car auparavant des outils similaires nécessitaient souvent Bash ou WSL sur Windows, ce qui créait des ennuis supplémentaires lors de la configuration.

L'architecture de Comet est construite sur une gestion d'état via des fichiers YAML. Dans le dossier openspec/changes/<name>/, un fichier .comet.yaml est créé qui stocke tout : de la phase actuelle et du mode de construction sélectionné jusqu'aux chemins de documentation et aux résultats de vérification.

Un détail intéressant pour ceux qui sont conscients des tokens : Comet a un mode context_compression. Pendant la transition de la conception vers la construction, le script comet-handoff.mjs compresse le contexte, supprimant l'excès. Selon les tests de l'auteur, cela économise environ 25–30% des tokens d'entrée sans perdre en qualité de code. Pour les grands projets sur Claude 3.5 Sonnet, cela peut représenter une belle économie sur votre facture.

Faut-il essayer

Comet est un outil pour ceux qui ont dépassé le stade "écris-moi une fonction Python" et veulent construire quelque chose de complexe et maintenable avec l'IA. C'est fait pour vous si :

1. Vous êtes fatigué des modifications chaotiques de l'agent qui cassent le projet à des endroits inattendus.
2. Vous avez besoin de transparence : ce que l'agent fait exactement en ce moment et pourquoi.
3. Vous voulez automatiser les tâches routinières comme la mise à jour du Design Doc après avoir fait des modifications de code.

Du côté des inconvénients, je peux noter que la courbe d'apprentissage est toujours plus élevée qu'un chat classique. Vous devez vous habituer à la structure des dossiers openspec/ et docs/superpowers/. Mais si vous travaillez sur un projet à long terme, cette discipline paiera dans l'absence de dette technique, que les réseaux neuronaux génèrent très rapidement.

Vous pouvez consulter le code source et la documentation dans le dépôt rpamis/comet. Le projet est en développement actif, et d'après les commits, les auteurs sont sérieux pour en faire un "framework" fiable pour les ingénieurs autonomes.