openspec

OpenSpec est un cadre de développement orienté spécifications (SDD) pour les assistants de codage par IA. Il ajoute une couche de spécification légère pour aligner les développeurs humains et les assistants IA sur ce qui doit être construit avant toute écriture de code. Le projet est publié sous forme de package npm @fission-ai/openspec, est sous licence MIT et nécessite Node.js 20.19.0 ou supérieur. Le workflow repose sur des commandes slash intégrées aux outils de codage par IA pris en charge. Après avoir exécuté `openspec init` dans un projet, les utilisateurs peuvent invoquer des commandes comme `/opsx:explore` pour discuter d'une idée avec l'IA, `/opsx:propose <name>` pour créer une proposition de modification, `/opsx:apply` pour implémenter les tâches planifiées, et `/opsx:archive` pour finaliser et archiver la modification. Chaque proposition de modification crée un dossier dédié sous `openspec/changes/`, contenant un fichier `proposal.md`, un dossier `specs/` avec les exigences et scénarios, un fichier `design.md` et un fichier `tasks.md`. Les spécifications sont rédigées en Markdown simple, avec un format exigence-scénario sans syntaxe spéciale. OpenSpec prend en charge plus de 30 assistants et outils de codage par IA, avec des variantes de commande selon l'outil, telles que `/opsx-propose`, `@opsx-propose` ou `$openspec-propose`. Un profil de workflow élargi propose des commandes supplémentaires : `/opsx:new`, `/opsx:continue`, `/opsx:ff`, `/opsx:verify` et `/opsx:onboard`. Le projet introduit également une fonctionnalité bêta appelée Stores, permettant de planifier dans un dépôt séparé partagé entre équipes via git push. Les Stores utilisent la même structure `openspec/` pour les spécifications et changements, et visent à soutenir les fonctionnalités inter-dépôts, les exigences partagées gérées par une seule équipe, et les workflows « planifier avant de coder » où les dépôts de code rattrapent plus tard. OpenSpec collecte des statistiques d'utilisation anonymes, limitées aux noms de commandes et à la version, sans arguments, chemins, contenu ni informations personnellement identifiables. La télémétrie est désactivée automatiquement en CI et peut être désactivée via configuration ou variables d'environnement. La documentation couvre le démarrage, le fonctionnement des commandes, l'adoption dans des projets existants, l'édition des changements, la référence CLI, le support multi-langues, la personnalisation et les schémas communautaires. Le projet est construit avec OpenSpec lui-même, et son dépôt contient des exemples en direct de spécifications et de changements en cours.