Glosarium
Setiap istilah OpenSpec, satu baris masing-masing.
OpenSpec menggunakan kembali kata-kata yang memiliki arti lain di git, CI, dan peralatan agent. Setiap baris memberikan makna OpenSpec. Kolom terakhir menautkan ke detail lebih lanjut bila tersedia.
| Istilah | Definisi | Lebih Lanjut |
|---|---|---|
| Apply | Menerapkan tugas-tugas dalam proposal perubahan. Skill: openspec-apply-change. | Apply a change |
| Archive | Menyelesaikan proposal perubahan: menggabungkan delta-nya ke spec utama dan memindahkan foldernya ke openspec/changes/archive/. | Quickstart |
| Artifact | Dokumen perencanaan di dalam proposal perubahan: proposal.md, delta spec, design.md, tasks.md. Bukan output build. | Artifacts |
| Capability | Satu area perilaku dari sistem Anda. Masing-masing memiliki satu spec di openspec/specs/<capability>/spec.md. | Capabilities |
| Change proposal | Satu unit kerja: sebuah folder di bawah openspec/changes/<name>/ yang menampung artefak perencanaannya. Sering disingkat menjadi "change". Bukan commit git. | Propose |
| Command | Titik masuk yang diketik untuk sebuah workflow. Ejaannya bervariasi per alat (/opsx:propose, /opsx-propose). Dokumentasi menamai workflow berdasarkan skill. | Supported tools |
| Continue | Membuat artefak perencanaan berikutnya untuk proposal perubahan yang sudah ada. Skill: openspec-continue-change. | Skills |
| Delivery | Cara workflow dipasang: sebagai skill, perintah, atau keduanya. | Set up your project |
| Delta spec | Spec di dalam proposal perubahan yang hanya mencantumkan apa yang berubah, di bawah header ADDED, MODIFIED, REMOVED, dan RENAMED. | Delta specs |
| Explore | Memikirkan sebuah ide secara menyeluruh dengan agent sebelum mengajukan. Tidak menulis kode. Skill: openspec-explore. | Explore an idea |
| Fast-forward | Membuat proposal perubahan dengan semua artefak perencanaan dalam satu kali proses, siap untuk diimplementasikan. Skill: openspec-ff-change. Bukan fast-forward git. | Skills |
| Legacy workflow | Command /openspec:* pra-OPSX. | |
| Loop | Siklus yang dilalui proposal perubahan: explore, propose, review, apply, archive. | Quickstart |
| Main specs | Struktur openspec/specs/: perilaku saat ini yang disepakati dari sistem Anda. Mengarsipkan menggabungkan delta ke dalamnya. Capability yang belum memiliki spec akan mendapatkannya dari requirement ADDED-nya. | Archive |
| OpenSpec root | Struktur openspec/ yang menjadi target resolusi dan operasi sebuah command: milik repo Anda, atau milik store. | Stores |
| OPSX | Sistem workflow OpenSpec saat ini, dan prefix command yang dipasangnya (/opsx:). | |
| Profile | Workflow mana yang dipasang init: core atau custom. | Profiles |
| Propose | Membuat proposal perubahan dan menghasilkan semua artefak perencanaannya dalam satu langkah. Skill: openspec-propose. | Quickstart |
| Registry | Daftar store yang terdaftar pada tingkat mesin, di registry.yaml. Bukan registry paket. | CLI |
| Requirement | Satu perilaku yang harus dimiliki sistem, ditulis dengan SHALL: ### Requirement: dalam sebuah spec. | Delta specs |
| Scenario | Contoh yang dapat diuji di bawah sebuah requirement, dalam bentuk WHEN/THEN. | Delta specs |
| Schema | Definisi artefak mana yang dihasilkan proposal perubahan, dan dalam urutan apa. Bukan JSON Schema. | Schemas |
| Skill | Instruksi workflow, dipasang di tempat alat AI Anda membacanya (.agents/skills/, ...). | Skills |
| Spec | File yang menjelaskan bagaimana satu capability berperilaku saat ini, di openspec/specs/<capability>/spec.md. | Archive |
| spec-driven | Skema bawaan: proposal, lalu delta spec, lalu design, lalu tasks. | spec-driven |
| Store | Repo OpenSpec mandiri yang terdaftar di mesin Anda, untuk perencanaan yang melintasi repositori. Bukan data store. | Stores (beta) |
| Sync | Menggabungkan delta yang telah diimplementasikan ke spec utama tanpa mengarsipkan. Skill: openspec-sync-specs. | Skills |
| Template | Konten awal yang diberikan skema untuk setiap artefak. | Schemas |
| Update | Sebagai skill (openspec-update-change): merevisi artefak perencanaan proposal perubahan. Sebagai command CLI (openspec update): memperbarui file OpenSpec yang dipasang. | Update a change, CLI |
| Verify | Memeriksa implementasi sesuai dengan artefak proposal perubahan sebelum mengarsipkan. Skill: openspec-verify-change. | Skills |
| Workflow | Aksi OpenSpec bernama (propose, apply, archive, ...), dipasang ke alat AI Anda sebagai skill atau command. | Set up your project |
| Workset | Kelompok folder lokal yang personal, dibuka bersamaan dalam satu alat. Bukan store, dan tidak ada yang dibagikan. | Worksets (beta) |