用語集
OpenSpec の全用語を1行ずつ。
OpenSpec は git、CI、エージェントツールで別の意味を持つ単語を再利用しています。各行に OpenSpec での意味を示します。最終列は詳細へのリンクです（利用可能な場合）。
| 用語 | 定義 | 詳細 |
|---|---|---|
| Apply | 変更プロポーザルのタスクを実装する。スキル: openspec-apply-change。 | 変更を適用する |
| Archive | 変更プロポーザルを完了する: そのデルタをメインスペックにマージし、フォルダを openspec/changes/archive/ に移動する。 | クイックスタート |
| Artifact | 変更プロポーザル内の計画ドキュメント: proposal.md、デルタスペック、design.md、tasks.md。ビルド成果物ではない。 | 成果物 |
| Capability | システムの1つの振る舞い領域。それぞれ openspec/specs/<capability>/spec.md に1つのスペックを持つ。 | ケイパビリティ |
| Change proposal | 1つの作業単位: openspec/changes/<name>/ 配下のフォルダで、計画成果物を保持する。しばしば「change」と略される。git commit ではない。 | プロポーズ |
| 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 | 変更プロポーザルが経るサイクル: explore、propose、review、apply、archive。 | クイックスタート |
| Main specs | openspec/specs/ ツリー: システムの現在の合意された振る舞い。アーカイブ時にデルタがマージされる。まだスペックのないケイパビリティは、その ADDED 要件からスペックを取得する。 | アーカイブ |
| OpenSpec root | コマンドが解決して操作する openspec/ ツリー: リポジトリのもの、またはストアのもの。 | ストア |
| OPSX | 現在の OpenSpec ワークフローシステム、およびそれがインストールするコマンドプレフィックス（/opsx:）。 | |
| Profile | init がインストールするワークフローの選択: core または custom。 | プロファイル |
| Propose | 変更プロポーザルを作成し、すべての計画成果物を1ステップで生成する。スキル: openspec-propose。 | クイックスタート |
| Registry | registry.yaml 内のマシンレベルの登録ストア一覧。パッケージレジストリではない。 | CLI |
| Requirement | システムが持つべき1つの振る舞い。SHALL を使用して記述: スペック内の ### Requirement:。 | デルタスペック |
| Scenario | 要件の下にあるテスト可能な例。WHEN/THEN 形式。 | デルタスペック |
| Schema | 変更プロポーザルがどの成果物をどの順序で生成するかの定義。JSON Schema ではない。 | スキーマ |
| Skill | ワークフローの指示書。AI ツールが読み取る場所にインストールされる（.agents/skills/ など）。 | スキル |
| Spec | 1つのケイパビリティが現在どのように振る舞うかを記述するファイル。openspec/specs/<capability>/spec.md に配置。 | アーカイブ |
| spec-driven | デフォルトのスキーマ: proposal、次に delta specs、次に design、次に tasks。 | spec-driven |
| Store | マシンに登録されたスタンドアロンの OpenSpec リポジトリ。リポジトリを跨ぐ計画用。データストアではない。 | ストア (ベータ) |
| Sync | アーカイブせずに、実装済みのデルタをメインスペックにマージする。スキル: openspec-sync-specs。 | スキル |
| Template | スキーマが各成果物に与える初期コンテンツ。 | スキーマ |
| Update | スキルとして（openspec-update-change）: 変更プロポーザルの計画成果物を修正する。CLI コマンドとして（openspec update）: OpenSpec のインストール済みファイルを更新する。 | 変更を更新する, CLI |
| Verify | アーカイブ前に、実装が変更プロポーザルの成果物と一致することを確認する。スキル: openspec-verify-change。 | スキル |
| Workflow | 名前付きの OpenSpec アクション（propose、apply、archive など）。スキルまたはコマンドとして AI ツールにインストールされる。 | プロジェクトをセットアップする |
| Workset | 1つのツールでまとめて開くパーソナルなローカルのフォルダグループ。ストアではなく、何も共有されない。 | ワークセット (ベータ) |