Glossario
Ogni termine OpenSpec, una riga ciascuno.
OpenSpec riutilizza parole che significano qualcos'altro in git, CI e negli strumenti per agent. Ogni riga fornisce il significato che hanno in OpenSpec. L'ultima colonna rimanda a ulteriori dettagli, ove disponibili.
| Termine | Definizione | Dettagli |
|---|---|---|
| Apply | Implementa i task di una proposta di modifica. Skill: openspec-apply-change. | Applica una modifica |
| Archive | Completa una proposta di modifica: unisce i suoi delta nelle specifiche principali e sposta la cartella in openspec/changes/archive/. | Avvio rapido |
| Artifact | Un documento di pianificazione all'interno di una proposta di modifica: proposal.md, specifiche delta, design.md, tasks.md. Non un output di build. | Artefatti |
| Capability | Un'area di comportamento del tuo sistema. Ognuna ha una specifica in openspec/specs/<capability>/spec.md. | Funzionalità |
| Change proposal | Un'unità di lavoro: una cartella sotto openspec/changes/<name>/ che contiene i suoi artefatti di pianificazione. Spesso abbreviato in "change". Non è un commit git. | Proponi |
| Command | Un punto di ingresso digitato per un workflow. La grafia varia a seconda dello strumento (/opsx:propose, /opsx-propose). La documentazione indica i workflow tramite lo skill. | Strumenti supportati |
| Continue | Crea il successivo artefatto di pianificazione per una proposta di modifica esistente. Skill: openspec-continue-change. | Skill |
| Delivery | Come vengono installati i workflow: come skill, comandi o entrambi. | Configura il tuo progetto |
| Delta spec | Una specifica all'interno di una proposta di modifica che elenca solo ciò che cambia, sotto le intestazioni ADDED, MODIFIED, REMOVED e RENAMED. | Specifiche delta |
| Explore | Elabora un'idea con l'agent prima di proporla. Non scrive codice. Skill: openspec-explore. | Esplora un'idea |
| Fast-forward | Crea una proposta di modifica con ogni artefatto di pianificazione in un'unica passata, pronta per l'implementazione. Skill: openspec-ff-change. Non è un fast-forward di git. | Skill |
| Legacy workflow | I comandi /openspec:* pre-OPSX. | |
| Loop | Il ciclo che attraversa una proposta di modifica: esplora, proponi, rivedi, applica, archivia. | Avvio rapido |
| Main specs | L'albero openspec/specs/: il comportamento attuale e concordato del tuo sistema. L'archiviazione unisce i delta ad esso. Una funzionalità senza ancora una specifica ne ottiene una dai suoi requisiti ADDED. | Archivia |
| OpenSpec root | L'albero openspec/ a cui un comando si risolve e su cui opera: quello del tuo repo o di uno store. | Store |
| OPSX | L'attuale sistema di workflow OpenSpec e il prefisso di comandi che installa (/opsx:). | |
| Profile | I workflow che init installa: core o custom. | Profili |
| Propose | Crea una proposta di modifica e genera tutti i suoi artefatti di pianificazione in un unico passaggio. Skill: openspec-propose. | Avvio rapido |
| Registry | L'elenco a livello di macchina degli store registrati, in registry.yaml. Non è un registro di pacchetti. | CLI |
| Requirement | Un comportamento che il sistema deve avere, scritto con SHALL: ### Requirement: in una specifica. | Specifiche delta |
| Scenario | Un esempio testabile sotto un requisito, in forma WHEN/THEN. | Specifiche delta |
| Schema | La definizione di quali artefatti produce una proposta di modifica e in che ordine. Non è JSON Schema. | Schemi |
| Skill | Le istruzioni di un workflow, installate dove il tuo strumento AI le legge (.agents/skills/, ...). | Skill |
| Spec | Un file che descrive come una funzionalità si comporta oggi, in openspec/specs/<capability>/spec.md. | Archivia |
| spec-driven | Lo schema predefinito: proposta, poi specifiche delta, poi design, poi task. | spec-driven |
| Store | Un repo OpenSpec autonomo registrato sulla tua macchina, per la pianificazione che coinvolge più repository. Non è un data store. | Store (beta) |
| Sync | Unisce i delta implementati nelle specifiche principali senza archiviare. Skill: openspec-sync-specs. | Skill |
| Template | Il contenuto iniziale che uno schema fornisce a ciascun artefatto. | Schemi |
| Update | Come skill (openspec-update-change): rivede gli artefatti di pianificazione di una proposta di modifica. Come comando CLI (openspec update): aggiorna i file installati di OpenSpec. | Aggiorna una modifica, CLI |
| Verify | Verifica che l'implementazione corrisponda agli artefatti di una proposta di modifica prima dell'archiviazione. Skill: openspec-verify-change. | Skill |
| Workflow | Un'azione OpenSpec denominata (propose, apply, archive, ...), installata nel tuo strumento AI come skill o comando. | Configura il tuo progetto |
| Workset | Un gruppo personale e locale di cartelle aperte insieme in un unico strumento. Non è uno store e non viene condiviso nulla. | Workset (beta) |