OpenSpec : clarifier les besoins avec l’IA avant de coder

Usage

Avec l’IA, les besoins d’un projet peuvent se disperser entre plusieurs conversations. Un comportement que vous avez décidé de conserver aujourd’hui risque d’être oublié au prochain changement. OpenSpec rassemble les besoins, les décisions de conception et les tâches dans des fichiers du projet pour que vous puissiez examiner le plan avant de demander à l’IA de le réaliser.

C’est un outil de développement guidé par les spécifications qui associe une CLI à plusieurs agent skills. Vous pouvez l’utiliser dans votre outil de développement avec l’IA habituel, sans changer d’éditeur. Le projet officiel publie son code source sous licence MIT.

Quand l’utiliser

Nous pensons qu’OpenSpec mérite d’être essayé lorsqu’une fonctionnalité demande plusieurs échanges, s’étend sur plusieurs conversations ou possède des critères d’acceptation précis. Les besoins restent dans le projet et peuvent être consultés lorsque vous reprenez le travail.

Pour corriger une seule phrase, préparer un dossier de changement complet peut demander plus d’efforts que la correction elle-même. L’ampleur du changement peut guider ce choix. Il s’agit d’un jugement éditorial fondé sur la documentation officielle, pas d’un retour de test personnel ni d’une comparaison de performances.

Exemple d’utilisation

Pour ajouter un répertoire d’Agent Skills, vous pourriez d’abord dire à l’IA :

Aide-moi à réfléchir à la création d’un répertoire d’Agent Skills. Je veux présenter nos propres Skills et une sélection externe, avec un filtre par catégorie et un tri par date. Clarifions d’abord les besoins ; n’écris pas encore de code.

Le guide de démarrage officiel décrit cinq étapes pour un changement :

Explorer : discuter des besoins, lire le code existant et comparer les approches sans écrire de code.
Proposer : noter la raison du changement, les exigences et les tâches ; ajouter un document de conception si des choix techniques sont nécessaires.
Revoir : confirmer le périmètre et les critères d’acceptation avant l’implémentation.
Appliquer : demander à l’IA d’accomplir les tâches à partir des fichiers.
Archiver : intégrer les exigences terminées aux spécifications principales et conserver la trace du changement.

Pour lancer directement l’exploration, utilisez $openspec-explore dans Codex ou /opsx:explore dans Claude Code. La syntaxe varie selon l’outil ; consultez les indications affichées lors de l’initialisation et la documentation des outils pris en charge.

Limites

Les spécifications doivent toujours être relues par une personne. Une exigence erronée reste erronée une fois écrite. OpenSpec ne garantit pas que l’IA produira le bon résultat et ne remplace ni les tests logiciels ni la revue humaine.

Les plateformes, les méthodes d’installation et les commandes peuvent changer selon la version. Codex, Claude Code, Cursor et GitHub Copilot ne sont que des exemples ; consultez la documentation officielle pour la liste complète.

Installation

Pour l’installation avec npm, vérifiez d’abord que vous disposez de Node.js 22.12.0 ou plus récent. Exécutez ensuite :

npm install -g @fission-ai/openspec@latest
openspec --version

Quand le numéro de version apparaît, placez-vous dans le dossier de votre projet et initialisez OpenSpec :

cd your-project
openspec init

Remplacez your-project par le chemin de votre projet et sélectionnez les outils d’IA utilisés lorsque le programme le demande. Vous pourrez ensuite demander à l’IA d’explorer les besoins ou de proposer un changement. Le guide officiel présente aussi un installateur autonome et Homebrew ; l’installateur autonome ne nécessite pas Node.js. Consultez le guide d’installation pour les autres méthodes et les mises à jour.