OpenSpecSpesifikasi-Driven Development untuk Asisten AI

→ fluida bukan kaku
→ iteratif bukan waterfall
→ mudah bukan kompleks
→ dibangun untuk brownfield bukan hanya greenfield
→ dapat diskalakan dari proyek pribadi hingga enterprise

Ikuti @0xTab di X untuk pembaruan · Bergabunglah dengan OpenSpec Discord untuk bantuan dan pertanyaan.

Lihat dalam aksi ​

You: /opsx:propose add-dark-mode
AI:  Created openspec/changes/add-dark-mode/
     ✓ proposal.md — why we're doing this, what's changing
     ✓ specs/       — requirements and scenarios
     ✓ design.md    — technical approach
     ✓ tasks.md     — implementation checklist
     Ready for implementation!

You: /opsx:apply
AI:  Implementing tasks...
     ✓ 1.1 Add theme context provider
     ✓ 1.2 Create toggle component
     ✓ 2.1 Add CSS variables
     ✓ 2.2 Wire up localStorage
     All tasks complete!

You: /opsx:archive
AI:  Archived to openspec/changes/archive/2025-01-23-add-dark-mode/
     Specs updated. Ready for the next feature.

Mulai Cepat ​

Membutuhkan Node.js 20.19.0 atau lebih tinggi.

Instal OpenSpec secara global:

npm install -g @fission-ai/openspec@latest

Kemudian navigasi ke direktori proyek Anda dan inisialisasi:

cd your-project
openspec init

Sekarang beri tahu AI Anda: /opsx:propose <apa-yang-ingin-anda-bangun>

Jika Anda menginginkan alur kerja yang diperluas (/opsx:new, /opsx:continue, /opsx:ff, /opsx:verify, /opsx:sync, /opsx:bulk-archive, /opsx:onboard), pilih dengan openspec config profile dan terapkan dengan openspec update.

Dokumentasi ​

→ Memulai: langkah pertama
→ Alur Kerja: kombinasi dan pola
→ Perintah: perintah slash & keterampilan
→ CLI: referensi terminal
→ Alat yang Didukung: integrasi alat & jalur instalasi
→ Konsep: bagaimana semuanya terhubung
→ Multi-Bahasa: dukungan multi-bahasa
→ Kustomisasi: buat milik Anda

Mengapa OpenSpec? ​

Asisten pemrograman AI sangat kuat tetapi tidak dapat diprediksi ketika persyaratan hanya ada di riwayat obrolan. OpenSpec menambahkan lapisan spesifikasi ringan sehingga Anda setuju tentang apa yang akan dibangun sebelum kode apa pun ditulis.

• Sepakati sebelum Anda membangun — manusia dan AI menyelaraskan spesifikasi sebelum kode ditulis
• Tetap terorganisir — setiap perubahan mendapat folder sendiri dengan proposal, spesifikasi, desain, dan tugas
• Bekerja secara fluida — perbarui artifact kapan saja, tanpa gerbang fase yang kaku
• Gunakan alat Anda — berfungsi dengan 20+ asisten AI melalui perintah slash

Bagaimana kami dibandingkan ​

vs. Spec Kit (GitHub) — Menyeluruh tetapi berat. Gerbang fase kaku, banyak Markdown, pengaturan Python. OpenSpec lebih ringan dan memungkinkan Anda ber迭代 secara bebas.

vs. Kiro (AWS) — Kuat tetapi Anda terkunci di IDE mereka dan terbatas pada model Claude. OpenSpec berfungsi dengan alat yang sudah Anda gunakan.

vs. tidak ada — Pemrograman AI tanpa spesifikasi berarti prompt yang samar dan hasil yang tidak dapat diprediksi. OpenSpec membawa prediktabilitas tanpa keributan.

Memperbarui OpenSpec ​

Tingkatkan paket

npm install -g @fission-ai/openspec@latest

Segarkan instruksi agen

Jalankan ini di dalam setiap proyek untuk menghasilkan kembali panduan AI dan memastikan perintah slash terbaru aktif:

openspec update

Catatan Penggunaan ​

Pemilihan model: OpenSpec bekerja paling baik dengan model dengan penalaran tinggi. Kami merekomendasikan Opus 4.5 dan GPT 5.2 untuk perencanaan dan implementasi.

Kebersihan konteks: OpenSpec mendapat manfaat dari jendela konteks yang bersih. Bersihkan konteks Anda sebelum memulai implementasi dan pertahankan kebersihan konteks yang baik sepanjang sesi Anda.

Berkontribusi ​

Perbaikan kecil — Perbaikan bug, koreksi kesalahan ketik, dan perbaikan minor dapat diajukan langsung sebagai PR.

Perubahan lebih besar — Untuk fitur baru, refactor signifikan, atau perubahan arsitektural, silakan ajukan proposal perubahan OpenSpec terlebih dahulu agar kami dapat menyelaraskan tujuan dan niat sebelum implementasi dimulai.

Saat menulis proposal, ingat filosofi OpenSpec: kami melayani berbagai pengguna di berbagai agen pemrograman, model, dan kasus penggunaan. Perubahan harus berfungsi dengan baik untuk semua orang.

Kode yang dihasilkan AI diterima — selama sudah diuji dan diverifikasi. PR yang berisi kode yang dihasilkan AI harus menyebutkan agen pemrograman dan model yang digunakan (misalnya, "Dihasilkan dengan Claude Code menggunakan claude-opus-4-5-20251101").

Pengembangan ​

• Instal dependensi: pnpm install
• Bangun: pnpm run build
• Uji: pnpm test
• Kembangkan CLI secara lokal: pnpm run dev atau pnpm run dev:cli
• Komit konvensional (satu baris): type(scope): subject

Lainnya ​

Lisensi ​

MIT