OpenSpec

Glosarium ​

Semua istilah OpenSpec dalam satu tempat, didefinisikan dengan bahasa yang sederhana. Baca sekilas dan dokumentasi lainnya akan lebih cepat dipahami.

Istilah dikelompokkan berdasarkan topik, kemudian diurutkan secara alfabetis di dalam setiap kelompok.

Kata benda inti ​

Spesifikasi (Spec). Dokumen yang menjelaskan bagaimana bagian dari sistem Anda berperilaku. Spesifikasi berada di openspec/specs/, diatur berdasarkan domain, dan terdiri dari persyaratan dan skenario. Spesifikasi adalah jawaban yang disepakati atas pertanyaan "apa yang dilakukan perangkat lunak ini?". Lihat Konsep.

Sumber kebenaran (Source of truth). Direktori openspec/specs/ secara keseluruhan. Ini berisi perilaku sistem saat ini yang telah disepakati. Perubahan mengusulkan pengeditan terhadapnya; pengarsipan menerapkan perubahan tersebut.

Perubahan (Change). Satu unit pekerjaan, dikemas sebagai folder di bawah openspec/changes/<name>/. Sebuah perubahan mencakup segala sesuatu tentang pekerjaan tersebut: proposal, desain, tugas, dan pengeditan spesifikasi yang dibawanya. Satu perubahan, satu fitur atau perbaikan.

Artefak. Dokumen di dalam sebuah perubahan. Artefak standar adalah proposal, delta spesifikasi, desain, dan tugas. Artefak ini dibuat berdasarkan urutan ketergantungan dan saling melengkapi.

Delta spesifikasi (Delta spec). Spesifikasi di dalam sebuah perubahan yang hanya menggambarkan apa yang berubah, menggunakan bagian ADDED, MODIFIED, dan REMOVED, alih-alih menyatakan seluruh spesifikasi. Inilah yang memungkinkan OpenSpec mengedit sistem yang ada dengan bersih. Lihat Konsep.

Domain. Pengelompokan logis untuk spesifikasi, seperti auth/, payments/, atau ui/. Anda memilih domain yang sesuai dengan cara Anda memandang sistem Anda.

Di dalam sebuah spesifikasi ​

Persyaratan (Requirement). Satu perilaku yang harus dimiliki sistem, biasanya ditulis dengan kata kunci RFC 2119: "Sistem HARUS kedaluwarsa sesi setelah 30 menit." Persyaratan menyatakan apa, bukan bagaimana.

Skenario. Contoh konkret dan dapat diuji dari suatu persyaratan yang sedang berjalan, biasanya dalam bentuk Given/When/Then. Skenario membuat persyaratan dapat diverifikasi: Anda dapat menulis uji otomatis dari salah satunya.

Kata kunci RFC 2119. Kata-kata MUST, SHALL, SHOULD, dan MAY, yang memiliki makna terstandarisasi mengenai seberapa ketat suatu persyaratan. MUST dan SHALL bersifat mutlak. SHOULD direkomendasikan dengan ruang untuk pengecualian. MAY bersifat opsional. Nama ini berasal dari dokumen standar internet yang mendefinisikannya.

Artefak ​

Proposal (proposal.md). Mengapa dan apa dari sebuah perubahan: niat, ruang lingkup, dan pendekatan tingkat tinggi. Artefak pertama yang Anda buat.

Desain (design.md). Bagaimana: pendekatan teknis, keputusan arsitektur, dan file yang diharapkan akan Anda ubah. Opsional untuk perubahan sederhana.

Tugas (tasks.md). Daftar periksa implementasi, dengan kotak centang. AI bekerja melaluinya selama /opsx:apply dan mencentang item saat proses berlangsung.

Siklus hidup ​

Arsip (Archive). Tindakan menyelesaikan sebuah perubahan. Delta spesifikasinya digabungkan ke dalam spesifikasi utama, dan folder perubahan dipindahkan ke openspec/changes/archive/YYYY-MM-DD-<name>/. Setelah diarsipkan, spesifikasi Anda menggambarkan realitas baru. Lihat Konsep.

Sinkronisasi (Sync). Menggabungkan delta spesifikasi dari sebuah perubahan ke dalam spesifikasi utama tanpa mengarsipkan perubahan tersebut. Biasanya otomatis (arsip menawarkan untuk melakukannya), tetapi tersedia secara mandiri sebagai /opsx:sync untuk perubahan yang berdurasi panjang. Lihat Perintah.

Alur kerja dan perintah ​

OPSX. Alur kerja OpenSpec standar saat ini, dibangun di sekitar tindakan fluida daripada fase yang kaku. Semua perintah slash-nya dimulai dengan /opsx:. Lihat Alur Kerja OPSX.

Perintah slash (Slash command). Perintah yang Anda ketikkan ke dalam chat asisten AI Anda, seperti /opsx:propose. Perintah slash mengendalikan alur kerja. Ini bukan perintah terminal. Lihat Cara Perintah Bekerja.

Eksplorasi (/opsx:explore). Perintah mitra berpikir. Ini membaca basis kode Anda, membandingkan opsi, dan memperjelas ide yang kabur menjadi rencana konkret, tanpa membuat artefak dan tanpa menulis kode. Titik awal yang disarankan setiap kali Anda memiliki masalah tetapi belum memiliki rencana. Lihat Eksplorasi Pertama.

CLI. Program openspec yang Anda jalankan di terminal Anda. Ini menyiapkan proyek, mencantumkan dan memvalidasi perubahan, membuka dasbor, dan mengarsip. Separuh terminal dari OpenSpec. Lihat CLI.

Skill. Folder instruksi (.../skills/openspec-*/SKILL.md) yang dideteksi dan diikuti secara otomatis oleh asisten AI Anda. Skill adalah standar lintas alat yang sedang berkembang untuk menyampaikan alur kerja OpenSpec kepada asisten Anda.

File perintah. File perintah slash per alat (.../commands/opsx-*). Mekanisme pengiriman yang lebih lama, masih didukung bersama skill. Anda jarang menyentuh ini secara langsung.

Profil. Kumpulan perintah slash yang dipasang di proyek Anda. Core (default) adalah propose, explore, apply, update, sync, archive. Set expanded menambahkan new, continue, ff, verify, bulk-archive, onboard. Ubah dengan openspec config profile.

Pengiriman (Delivery). Apakah OpenSpec memasang skill, file perintah, atau keduanya untuk alat Anda. Dikonfigurasi secara global dan diterapkan dengan openspec update.

Kustomisasi ​

Skema (Schema). Definisi artefak mana yang dimiliki sebuah alur kerja dan bagaimana mereka saling bergantung. Default bawaan adalah spec-driven (proposal → specs → design → tasks). Anda dapat melakukan fork atau menulis milik Anda sendiri. Lihat Kustomisasi.

Templat. File Markdown di dalam skema yang membentuk apa yang dihasilkan AI untuk artefak tertentu. Mengedit templat mengubah output AI secara langsung, tanpa perlu rebuild.

Konfigurasi proyek (openspec/config.yaml). Pengaturan per-proyek: skema default, context: yang disuntikkan ke setiap permintaan perencanaan, dan rules: per-artefak. Cara termudah untuk mengajarkan OpenSpec tentang tumpukan dan konvensi Anda. Lihat Kustomisasi.

Penyuntikan konteks (Context injection). Memasukkan latar belakang proyek ke dalam bidang context: di config.yaml sehingga secara otomatis ditambahkan ke setiap artefak yang dihasilkan AI. Lebih andal daripada berharap AI membaca file terpisah.

Graf ketergantungan (Dependency graph). Grafik berarah yang dibentuk oleh hubungan requires: artefak. Ini adalah DAG (directed acyclic graph: panah hanya menunjuk ke depan, tidak pernah dalam loop), dan OpenSpec menggunakannya untuk mengetahui apa yang dapat Anda buat selanjutnya.

Enabler, bukan gerbang (Enablers, not gates). Prinsip bahwa ketergantungan artefak menunjukkan apa yang menjadi mungkin selanjutnya, bukan apa yang diperlukan selanjutnya. Anda dapat meninjau kembali dan mengedit artefak apa pun kapan saja. Lihat Konsep Inti Sekilas.

Koordinasi antar repositori (beta) ​

Istilah-istilah ini hanya berlaku jika perencanaan Anda mencakup lebih dari satu repositori. Fitur ini masih dalam tahap beta. Sebagian besar pengguna dapat mengabaikannya. Lihat Panduan Pengguna Stores.

Store. Repositori mandiri yang seluruh tugasnya adalah perencanaan. Ini memiliki struktur openspec/ yang sama seperti yang sudah Anda ketahui (spesifikasi dan perubahan) ditambah file identitas kecil. Daftarkan sekali di mesin Anda, berdasarkan nama, dan kemudian perintah OpenSpec apa pun dapat bekerja di dalamnya dari mana saja.

Referensi. Pernyataan, di openspec/config.yaml repositori kode, tentang store yang ditarik oleh repositori tersebut. Referensi bersifat baca-saja: repositori mempertahankan root-nya sendiri, dan openspec instructions mendapatkan indeks spesifikasi dari store yang dirujuk, masing-masing dengan perintah tepat untuk mengambilnya.

Konteks kerja (Working context). Apa yang dirakit oleh openspec context untuk repositori saat ini: root OpenSpec-nya plus setiap store yang dirujuknya, masing-masing dengan cara untuk mengambilnya. Jawaban atas pertanyaan "dengan apa saya bekerja?"

Workset. Kumpulan folder pribadi, lokal pada mesin, yang Anda buka bersama (sebuah store bersama repositori kode yang Anda kerjakan). Dibuat secara eksplisit dengan openspec workset create; tidak ada path lokal terkait yang dikommit ke repositori perencanaan bersama.

Lihat juga ​