Glosario
Cada término de OpenSpec, en una línea.
OpenSpec reutiliza palabras que significan otra cosa en git, CI y las herramientas de agentes. Cada fila proporciona el significado en OpenSpec. La última columna enlaza a más detalles cuando están disponibles.
| Término | Definición | Más |
|---|---|---|
| Apply | Implementa las tareas de una propuesta de cambio. Skill: openspec-apply-change. | Aplicar un cambio |
| Archive | Completa una propuesta de cambio: fusiona sus deltas en las specs principales y mueve su carpeta a openspec/changes/archive/. | Inicio rápido |
| Artifact | Un documento de planificación dentro de una propuesta de cambio: proposal.md, specs delta, design.md, tasks.md. No es un resultado de compilación. | Artefactos |
| Capability | Un área de comportamiento de tu sistema. Cada una tiene una spec en openspec/specs/<capability>/spec.md. | Capacidades |
| Change proposal | Una unidad de trabajo: una carpeta bajo openspec/changes/<name>/ que contiene sus artefactos de planificación. A menudo se abrevia como "change". No es un commit de git. | Proponer |
| Command | Un punto de entrada que se escribe para un workflow. La forma de escribirlo varía según la herramienta (/opsx:propose, /opsx-propose). En su lugar, la documentación nombra los workflows por su skill. | Herramientas compatibles |
| Continue | Crea el siguiente artefacto de planificación para una propuesta de cambio existente. Skill: openspec-continue-change. | Skills |
| Delivery | Cómo se instalan los workflows: como skills, comandos o ambos. | Configura tu proyecto |
| Delta spec | Una spec dentro de una propuesta de cambio que enumera solo lo que cambia, bajo los encabezados ADDED, MODIFIED, REMOVED y RENAMED. | Specs delta |
| Explore | Analiza una idea a fondo con el agente antes de proponerla. No escribe código. Skill: openspec-explore. | Explora una idea |
| Fast-forward | Crea una propuesta de cambio con todos los artefactos de planificación en una sola pasada, lista para implementar. Skill: openspec-ff-change. No es un fast-forward de git. | Skills |
| Legacy workflow | Los comandos /openspec:* anteriores a OPSX. | |
| Loop | El ciclo por el que pasa una propuesta de cambio: explorar, proponer, revisar, aplicar, archivar. | Inicio rápido |
| Main specs | El árbol openspec/specs/: el comportamiento actual y acordado de tu sistema. El archivado fusiona los deltas en él. Una capacidad que aún no tiene spec obtiene una a partir de sus requisitos ADDED. | Archivar |
| OpenSpec root | El árbol openspec/ al que se resuelve y sobre el que opera un comando: el de tu repositorio o el de un store. | Stores |
| OPSX | El sistema de workflows actual de OpenSpec y el prefijo de comando que instala (/opsx:). | |
| Profile | Qué workflows instala init: core o custom. | Perfiles |
| Propose | Crea una propuesta de cambio y genera todos sus artefactos de planificación en un solo paso. Skill: openspec-propose. | Inicio rápido |
| Registry | La lista a nivel de máquina de stores registrados, en registry.yaml. No es un registro de paquetes. | CLI |
| Requirement | Un comportamiento que el sistema debe tener, escrito con SHALL: ### Requirement: en una spec. | Specs delta |
| Scenario | Un ejemplo comprobable bajo un requisito, en forma WHEN/THEN. | Specs delta |
| Schema | La definición de qué artefactos produce una propuesta de cambio y en qué orden. No es JSON Schema. | Esquemas |
| Skill | Las instrucciones de un workflow, instaladas donde las lee tu herramienta de IA (.agents/skills/, ...). | Skills |
| Spec | Un archivo que describe cómo se comporta hoy una capacidad, en openspec/specs/<capability>/spec.md. | Archivar |
| spec-driven | El schema predeterminado: propuesta, luego specs delta, luego diseño, luego tareas. | spec-driven |
| Store | Un repositorio OpenSpec independiente registrado en tu máquina, para planificar entre varios repositorios. No es un almacén de datos. | Stores (beta) |
| Sync | Fusiona los deltas implementados en las specs principales sin archivarlos. Skill: openspec-sync-specs. | Skills |
| Template | El contenido inicial que un schema da a cada artefacto. | Esquemas |
| Update | Como skill (openspec-update-change): revisa los artefactos de planificación de una propuesta de cambio. Como comando de CLI (openspec update): actualiza los archivos instalados de OpenSpec. | Actualizar un cambio, CLI |
| Verify | Comprueba que la implementación coincide con los artefactos de una propuesta de cambio antes de archivarla. Skill: openspec-verify-change. | Skills |
| Workflow | Una acción de OpenSpec con nombre (propose, apply, archive, ...), instalada en tu herramienta de IA como skill o comando. | Configura tu proyecto |
| Workset | Un grupo personal y local de carpetas abiertas juntas en una herramienta. No es un store y no se comparte nada. | Worksets (beta) |