Glossaire
Chaque terme OpenSpec, une ligne chacun.
OpenSpec réutilise des mots qui ont un autre sens dans git, CI et les outils d'agent. Chaque ligne donne la signification OpenSpec. La dernière colonne renvoie vers plus de détails lorsqu'ils sont disponibles.
| Terme | Définition | Plus |
|---|---|---|
| Appliquer | Implémente les tâches d'une proposition de changement. Skill : openspec-apply-change. | Appliquer un changement |
| Archiver | Termine une proposition de changement : fusionne ses deltas dans les specs principales et déplace son dossier vers openspec/changes/archive/. | Démarrage rapide |
| Artefact | Un document de planification à l'intérieur d'une proposition de changement : proposal.md, specs delta, design.md, tasks.md. Pas une sortie de build. | Artefacts |
| Capacité | Un domaine de comportement de votre système. Chacune possède une spec dans openspec/specs/<capability>/spec.md. | Capacités |
| Proposition de changement | Une unité de travail : un dossier sous openspec/changes/<name>/ contenant ses artefacts de planification. Souvent abrégée en « changement ». Pas un commit git. | Proposer |
| Commande | Un point d'entrée saisi pour un workflow. L'orthographe varie selon l'outil (/opsx:propose, /opsx-propose). Les docs désignent les workflows par skill. | Outils pris en charge |
| Continuer | Crée l'artefact de planification suivant pour une proposition de changement existante. Skill : openspec-continue-change. | Skills |
| Livraison | La manière dont les workflows sont installés : en tant que skills, commandes, ou les deux. | Configurez votre projet |
| Spec delta | Une spec à l'intérieur d'une proposition de changement listant uniquement ce qui change, sous les en-têtes ADDED, MODIFIED, REMOVED et RENAMED. | Specs delta |
| Explorer | Réfléchit à une idée avec l'agent avant de proposer. N'écrit pas de code. Skill : openspec-explore. | Explorer une idée |
| Fast-forward | Crée une proposition de changement avec tous les artefacts de planification en une seule passe, prête à être implémentée. Skill : openspec-ff-change. Pas un fast-forward git. | Skills |
| Workflow hérité | Les commandes /openspec:* pré-OPSX. | |
| Cycle | Le cycle par lequel passe une proposition de changement : explorer, proposer, réviser, appliquer, archiver. | Démarrage rapide |
| Specs principales | L'arborescence openspec/specs/ : le comportement actuel et validé de votre système. L'archivage y fusionne les deltas. Une capacité sans spec reçoit la sienne à partir de ses exigences ADDED. | Archiver |
| Racine OpenSpec | L'arborescence openspec/ vers laquelle une commande se résout et sur laquelle elle opère : celle de votre dépôt, ou celle d'un store. | Stores |
| OPSX | Le système de workflow OpenSpec actuel, et le préfixe de commande qu'il installe (/opsx:). | |
| Profil | Les workflows que init installe : core ou custom. | Profils |
| Proposer | Crée une proposition de changement et génère tous ses artefacts de planification en une seule étape. Skill : openspec-propose. | Démarrage rapide |
| Registre | La liste au niveau machine des stores enregistrés, dans registry.yaml. Pas un registre de paquets. | CLI |
| Exigence | Un comportement que le système doit posséder, écrit avec SHALL : ### Requirement: dans une spec. | Specs delta |
| Scénario | Un exemple testable sous une exigence, sous forme QUAND/ALORS. | Specs delta |
| Schéma | La définition des artefacts qu'une proposition de changement produit, et dans quel ordre. Pas JSON Schema. | Schémas |
| Skill | Les instructions d'un workflow, installées là où votre outil IA les lit (.agents/skills/, ...). | Skills |
| Spec | Un fichier décrivant le comportement actuel d'une capacité, dans openspec/specs/<capability>/spec.md. | Archiver |
| spec-driven | Le schéma par défaut : proposition, puis specs delta, puis design, puis tâches. | spec-driven |
| Store | Un dépôt OpenSpec autonome enregistré sur votre machine, pour la planification qui s'étend sur plusieurs dépôts. Pas un store de données. | Stores (bêta) |
| Synchroniser | Fusionne les deltas implémentés dans les specs principales sans archivage. Skill : openspec-sync-specs. | Skills |
| Modèle | Le contenu de départ qu'un schéma donne à chaque artefact. | Schémas |
| Mettre à jour | En tant que skill (openspec-update-change) : révise les artefacts de planification d'une proposition de changement. En tant que commande CLI (openspec update) : actualise les fichiers installés d'OpenSpec. | Mettre à jour un changement, CLI |
| Vérifier | Vérifie que l'implémentation correspond aux artefacts d'une proposition de changement avant l'archivage. Skill : openspec-verify-change. | Skills |
| Workflow | Une action OpenSpec nommée (proposer, appliquer, archiver, ...), installée dans votre outil IA en tant que skill ou commande. | Configurez votre projet |
| Workset | Un groupe personnel et local de dossiers ouverts ensemble dans un seul outil. Pas un store, et rien n'est partagé. | Worksets (bêta) |