Glossário
Todos os termos do OpenSpec, um por linha.
O OpenSpec reutiliza palavras que significam algo diferente no git, CI e ferramentas de agentes. Cada linha apresenta o significado no OpenSpec. A última coluna linka para mais detalhes, quando disponíveis.
| Termo | Definição | Mais |
|---|---|---|
| Apply | Implementar as tarefas em uma proposta de mudança. Skill: openspec-apply-change. | Aplicar uma mudança |
| Archive | Concluir uma proposta de mudança: mesclar seus deltas nas specs principais e mover sua pasta para openspec/changes/archive/. | Quickstart |
| Artifact | Um documento de planejamento dentro de uma proposta de mudança: proposal.md, specs delta, design.md, tasks.md. Não é uma saída de build. | Artefatos |
| Capability | Uma área de comportamento do seu sistema. Cada uma possui uma spec em openspec/specs/<capability>/spec.md. | Capacidades |
| Change proposal | Uma unidade de trabalho: uma pasta sob openspec/changes/<name>/ contendo seus artefatos de planejamento. Frequentemente abreviada como "mudança". Não é um commit git. | Propor |
| Command | Um ponto de entrada tipado para um fluxo de trabalho. A grafia varia por ferramenta (/opsx:propose, /opsx-propose). Os docs nomeiam fluxos de trabalho por skill. | Ferramentas suportadas |
| Continue | Criar o próximo artefato de planejamento para uma proposta de mudança existente. Skill: openspec-continue-change. | Skills |
| Delivery | Como os fluxos de trabalho são instalados: como skills, comandos ou ambos. | Configurar seu projeto |
| Delta spec | Uma spec dentro de uma proposta de mudança listando apenas o que muda, sob os cabeçalhos ADDED, MODIFIED, REMOVED e RENAMED. | Specs delta |
| Explore | Elaborar uma ideia com o agente antes de propor. Não escreve código. Skill: openspec-explore. | Explorar uma ideia |
| Fast-forward | Criar uma proposta de mudança com todos os artefatos de planejamento de uma só vez, pronta para implementação. Skill: openspec-ff-change. Não é um fast-forward do git. | Skills |
| Legacy workflow | Os comandos /openspec:* pré-OPSX. | |
| Loop | O ciclo pelo qual uma proposta de mudança passa: explorar, propor, revisar, aplicar, arquivar. | Quickstart |
| Main specs | A árvore openspec/specs/: o comportamento atual e acordado do seu sistema. O arquivamento mescla os deltas nela. Uma capacidade sem spec ainda recebe uma a partir de seus requisitos ADDED. | Arquivar |
| OpenSpec root | A árvore openspec/ à qual um comando resolve e opera: do seu repositório ou de um store. | Stores |
| OPSX | O sistema de fluxo de trabalho OpenSpec atual e o prefixo de comando que instala (/opsx:). | |
| Profile | Quais fluxos de trabalho o init instala: core ou custom. | Perfis |
| Propose | Criar uma proposta de mudança e gerar todos os seus artefatos de planejamento em uma etapa. Skill: openspec-propose. | Quickstart |
| Registry | A lista em nível de máquina de stores registrados, em registry.yaml. Não é um registro de pacotes. | CLI |
| Requirement | Um comportamento que o sistema deve ter, escrito com SHALL: ### Requirement: em uma spec. | Specs delta |
| Scenario | Um exemplo testável sob um requisito, na forma QUANDO/ENTÃO. | Specs delta |
| Schema | A definição de quais artefatos uma proposta de mudança produz e em que ordem. Não é JSON Schema. | Esquemas |
| Skill | As instruções de um fluxo de trabalho, instaladas onde sua ferramenta de IA as lê (.agents/skills/, ...). | Skills |
| Spec | Um arquivo descrevendo como uma capacidade se comporta hoje, em openspec/specs/<capability>/spec.md. | Arquivar |
| spec-driven | O esquema padrão: proposta, depois specs delta, depois design, depois tarefas. | spec-driven |
| Store | Um repositório OpenSpec autônomo registrado na sua máquina, para planejamento que abrange repositórios. Não é um armazenamento de dados. | Stores (beta) |
| Sync | Mesclar deltas implementados nas specs principais sem arquivar. Skill: openspec-sync-specs. | Skills |
| Template | O conteúdo inicial que um esquema fornece a cada artefato. | Esquemas |
| Update | Como skill (openspec-update-change): revisar os artefatos de planejamento de uma proposta de mudança. Como comando CLI (openspec update): atualizar os arquivos instalados do OpenSpec. | Atualizar uma mudança, CLI |
| Verify | Verificar se a implementação corresponde aos artefatos de uma proposta de mudança antes de arquivar. Skill: openspec-verify-change. | Skills |
| Workflow | Uma ação OpenSpec nomeada (propor, aplicar, arquivar, ...), instalada em sua ferramenta de IA como skill ou comando. | Configurar seu projeto |
| Workset | Um grupo pessoal e local de pastas abertas juntas em uma ferramenta. Não é um store, e nada é compartilhado. | Worksets (beta) |