용어집
모든 OpenSpec 용어를 한 줄씩 설명합니다.
OpenSpec은 git, CI 및 에이전트 도구에서 다른 의미로 사용되는 단어를 재사용합니다. 각 행은 OpenSpec에서의 의미를 제공합니다. 마지막 열은 가능한 경우 자세한 내용으로 연결됩니다.
| 용어 | 정의 | 더 보기 |
|---|---|---|
| Apply | 변경 제안서의 작업을 구현합니다. 스킬: openspec-apply-change. | 변경 적용하기 |
| Archive | 변경 제안서를 완료합니다: 델타를 메인 사양에 병합하고 해당 폴더를 openspec/changes/archive/로 이동합니다. | 빠른 시작 |
| Artifact | 변경 제안서 내의 계획 문서: proposal.md, 델타 사양, design.md, tasks.md. 빌드 결과물이 아닙니다. | 아티팩트 |
| Capability | 시스템의 하나의 동작 영역입니다. 각각은 openspec/specs/<capability>/spec.md에 하나의 사양을 가집니다. | 기능 |
| Change proposal | 하나의 작업 단위: openspec/changes/<name>/ 아래에 계획 아티팩트를 보관하는 폴더입니다. 흔히 "change"로 줄여 부릅니다. Git 커밋이 아닙니다. | 제안하기 |
| Command | 워크플로의 입력 시작점입니다. 도구에 따라 철자가 다릅니다 (/opsx:propose, /opsx-propose). 문서에서는 대신 스킬 이름으로 워크플로를 지칭합니다. | 지원 도구 |
| Continue | 기존 변경 제안서의 다음 계획 아티팩트를 생성합니다. 스킬: openspec-continue-change. | 스킬 |
| Delivery | 워크플로가 설치되는 방식: 스킬, 명령 또는 둘 다로. | 프로젝트 설정 |
| Delta spec | 변경 제안서 내에서 변경 사항만을 나열하는 사양으로, ADDED, MODIFIED, REMOVED, RENAMED 헤더 아래에 있습니다. | 델타 사양 |
| Explore | 제안하기 전에 에이전트와 함께 아이디어를 검토합니다. 코드를 작성하지 않습니다. 스킬: openspec-explore. | 아이디어 탐색 |
| Fast-forward | 모든 계획 아티팩트를 한 번에 생성하여 구현 준비된 변경 제안서를 만듭니다. 스킬: openspec-ff-change. Git fast-forward가 아닙니다. | 스킬 |
| Legacy workflow | OPSX 이전의 /openspec:* 명령들입니다. | |
| Loop | 변경 제안서가 거치는 주기: 탐색, 제안, 검토, 적용, 보관. | 빠른 시작 |
| Main specs | openspec/specs/ 트리: 시스템의 현재 합의된 동작입니다. 보관 시 델타를 여기에 병합합니다. 아직 사양이 없는 기능은 ADDED 요구사항으로부터 사양을 생성합니다. | 보관 |
| OpenSpec root | 명령이 해석되어 작업하는 openspec/ 트리: 저장소의 것 또는 스토어의 것입니다. | 스토어 |
| OPSX | 현재 OpenSpec 워크플로 시스템과 설치되는 명령 접두사(/opsx:)입니다. | |
| Profile | init이 설치할 워크플로 유형: core 또는 custom. | 프로필 |
| Propose | 변경 제안서를 생성하고 한 단계로 모든 계획 아티팩트를 생성합니다. 스킬: openspec-propose. | 빠른 시작 |
| Registry | 머신 수준의 등록된 스토어 목록, registry.yaml에 있습니다. 패키지 레지스트리가 아닙니다. | CLI |
| Requirement | 시스템이 반드시 가져야 할 하나의 동작으로, 사양에 ### Requirement:로 SHALL과 함께 작성됩니다. | 델타 사양 |
| Scenario | 요구사항 아래의 WHEN/THEN 형식으로 된 테스트 가능한 예제입니다. | 델타 사양 |
| Schema | 변경 제안서가 어떤 아티팩트를 어떤 순서로 생성하는지 정의합니다. JSON Schema가 아닙니다. | 스키마 |
| Skill | 워크플로의 지침으로, AI 도구가 읽는 위치(.agents/skills/ 등)에 설치됩니다. | 스킬 |
| Spec | 하나의 기능이 현재 어떻게 동작하는지 설명하는 파일로, openspec/specs/<capability>/spec.md에 있습니다. | 보관 |
| spec-driven | 기본 스키마: 제안, 델타 사양, 설계, 작업 순서입니다. | spec-driven |
| Store | 머신에 등록된 독립형 OpenSpec 저장소로, 저장소를 아우르는 계획을 위해 사용됩니다. 데이터 저장소가 아닙니다. | 스토어 (베타) |
| Sync | 보관하지 않고 구현된 델타를 메인 사양에 병합합니다. 스킬: openspec-sync-specs. | 스킬 |
| Template | 스키마가 각 아티팩트에 제공하는 시작 콘텐츠입니다. | 스키마 |
| Update | 스킬 (openspec-update-change): 변경 제안서의 계획 아티팩트를 수정합니다. CLI 명령 (openspec update): OpenSpec의 설치된 파일을 새로 고칩니다. | 변경 업데이트, CLI |
| Verify | 보관하기 전에 구현이 변경 제안서의 아티팩트와 일치하는지 확인합니다. 스킬: openspec-verify-change. | 스킬 |
| Workflow | 이름이 지정된 OpenSpec 동작(제안, 적용, 보관 등)으로, AI 도구에 스킬 또는 명령으로 설치됩니다. | 프로젝트 설정 |
| Workset | 하나의 도구에서 함께 열리는 개인 로컬 폴더 그룹입니다. 스토어가 아니며 공유되지 않습니다. | 워크셋 (베타) |