Superpowers dapat memandu pengguna Claude Code mengerjakan perubahan besar dalam repositori Git yang dikuasainya: menyepakati desain, menyetujui rencana tugas, menerapkan perubahan dengan pengujian, meninjau setiap tugas, dan memeriksa branch yang selesai. Panduan ini mengikuti manual resmi Superpowers 7.0.0 yang diperiksa pada 20 Oktober 2026. BIG CHANGE meninjau dokumentasinya; kami tidak memasang plugin atau menjalankan proyek melaluinya.

Perubahan besar

  • Apa yang berubah: Desain dan rencana implementasi yang disetujui memberi agen pemrograman tugas serta batasan yang jelas sebelum mengedit repositori.
  • Mengapa penting: Alur tugas yang didokumentasikan menggabungkan pengujian gagal dan lulus yang diamati dengan putusan spesifikasi serta kualitas yang terpisah dari satu peninjau, lalu tinjauan lebih luas atas seluruh branch.
  • Yang perlu diperhatikan: Pemilik tetap memeriksa seluruh diff dan hasil penerimaan terbaru, lalu menentukan nasib branch. Alur agen yang selesai masih dapat menyisakan temuan yang diungkapkan.

Sebelum memulai

Pilih satu perubahan kode bertahap yang diizinkan dalam repositori milik Anda atau yang boleh Anda edit. Perubahan itu harus dapat dibagi menjadi tugas yang bisa ditinjau dan memiliki perilaku yang dapat diuji. Catat perilaku yang diminta, area terdampak, pengecualian, perintah penerimaan awal, dan commit awal. Jalankan perintah itu serta pemeriksaan relevan yang sudah ada sebelum bekerja. Jika kondisi awal sudah gagal, identifikasi kegagalannya sekarang; hasil hijau atau merah berikutnya memerlukan titik awal yang diketahui.

Anda memerlukan Git, instalasi Claude Code yang terautentikasi, izin memasang plugin dan membuat branch atau worktree, serta kapasitas paket atau API yang cukup untuk Claude Code dan subagennya. Periksa aturan organisasi tentang akses kode sumber dan penggunaan plugin. Tinjau isi plugin, izin efektif, ketentuan data penyedia, dan kendali pengeluaran sebelum mengaktifkannya. Anthropic memperingatkan bahwa hook plugin dan proses server dapat berjalan dengan hak pengguna Anda di luar sandbox pemanggilan alat; permintaan izin alat biasa tidak mencakup semua kode tersebut. Batasi rahasia, dependensi, penulisan eksternal, push, dan rilis sesuai kewenangan yang benar-benar Anda miliki. Dokumentasi keamanan plugin Claude Code menjelaskan batas ini.

Jalur berikut menggunakan keterampilan Superpowers subagent-driven-development untuk perubahan dengan beberapa tugas. Manual juga menjelaskan jalur inline executing-plans dan mengizinkan kesepakatan desain yang lebih sederhana untuk pekerjaan kecil. Pilih jalurnya bersama pemilik sebelum implementasi, alih-alih menganggap setiap proyek harus mengikuti seluruh urutan.

1. Pasang plugin dan periksa versi aktif

Dalam sesi Claude Code interaktif, masukkan perintah marketplace resmi:

Text
/plugin install superpowers@claude-plugins-official

Claude Code membuka panel detail plugin sebelum pemasangan. Periksa isinya dan pilih cakupan yang diizinkan. Cakupan local mengaktifkannya untuk Anda dalam repositori ini; cakupan project memengaruhi pengaturan repositori para kolaborator. Baca ringkasan pemasangan dan tab Errors. Ikuti petunjuk aktivasi sesi atau mulai ulang, lalu periksa tab Installed dan jalankan claude plugin list dalam shell. Catat Version, Scope, dan Status yang ditampilkan, lalu pastikan keterampilan Superpowers tersedia dalam sesi aktif. Perintah marketplace tidak mengunci commit riset yang digunakan untuk panduan ini. Jika versi terpasang atau teks keterampilan berbeda dari 7.0.0, sesuaikan prosedur dengan versi terpasang sebelum melanjutkan. Pemasangan gagal atau nonaktif berarti berhenti, bukan bukti bahwa alur kerja telah dimuat. Panduan pemasangan Claude Code mendokumentasikan pemeriksaan ini.

2. Setujui desain, lalu rencana

Beri tahu Claude Code perubahan sebenarnya, kriteria penerimaan, hasil awal, dan edit yang dilarang. Gunakan proses Superpowers brainstorming untuk menyepakati maksud, pilihan desain, dan batasan. Untuk perubahan bertahap ini, periksa desain tertulis serta temuan pemeriksaan pembangun, selesaikan pertanyaan yang menjadi tanggung jawab pemilik, dan setujui uraian lengkapnya. Persetujuan harus menjelaskan perilaku yang akan dibangun; jangan menyimpulkannya hanya karena agen terus berbicara. Manual desain mengizinkan kesepakatan yang lebih ringan atau pilihan keluar secara eksplisit untuk pekerjaan kecil, sehingga jalur ini merupakan pilihan yang disengaja untuk tugas besar.

Selanjutnya, minta proses writing-plans mengubah desain itu menjadi tugas. Tinjau batas file, antarmuka, batasan menyeluruh, perintah pengujian, dan Review Focus dalam rencana. Setiap tugas harus cukup kecil untuk diperiksa, dan pengujiannya harus mengukur perilaku yang disepakati. Setujui rencana serta pendekatan eksekusi subagen sebelum perubahan kode dimulai. Manual perencanaan menetapkan serah terima. Jangan menganggap rencana yang tampak masuk akal sebagai izin menambah dependensi atau mengubah file yang tidak terkait.

Saat eksekusi, using-git-worktrees memeriksa ruang kerja yang sudah ada dan sesuai atau menyiapkan ruang terisolasi dengan persetujuan yang diperlukan. Catat branch sebenarnya, commit dasar, dan kondisi awal yang bersih. Gunakan dukungan worktree bawaan Claude Code jika tersedia. Jika ruang kerja berisi edit yang tidak terkait, selesaikan kepemilikannya sebelum melanjutkan. Manual worktree menjelaskan jalur pemeriksaan dan pembuatannya.

3. Amati setiap pengujian dan tinjauan tugas

Dengan rencana yang disetujui, gunakan subagent-driven-development untuk tugas yang dapat ditinjau secara mandiri. Manual saat ini menugaskan seorang pelaksana untuk suatu tugas, lalu menyerahkan implementasi dan diff-nya kepada satu peninjau tugas. Peninjau tersebut memberikan dua penilaian: apakah tugas sesuai spesifikasi dan apakah kualitas implementasinya dapat diterima. Ini dua putusan dari satu tinjauan, bukan dua agen peninjau berurutan. Tugas kecil yang serupa dapat dikelompokkan sesuai aturan manual. Alur tugas dan instruksi peninjau menetapkan urutan ini.

Untuk setiap perilaku yang sesuai dengan pendekatan pengujian lebih dahulu, minta siklus merah-hijau yang dapat diamati: tambahkan pengujian perilaku, jalankan, dan lihat kegagalan yang diharapkan; buat implementasi paling kecil, jalankan kembali, dan lihat kelulusannya; lalu rapikan kode sambil mempertahankan pemeriksaan tetap lulus. Kesalahan impor atau kerangka pengujian yang rusak bukan hasil merah yang diharapkan. Simpan perintah, keluaran, serta commit atau diff terkait untuk setiap tugas. Manual test-driven-development menjelaskan pengecualian yang memerlukan persetujuan manusia; panduan ini mengasumsikan tugas yang sesuai dengan jalur normal pengujian lebih dahulu.

Baca kedua putusan peninjau dan diff yang sebenarnya. Selesaikan setiap butir “tidak dapat diverifikasi dari diff” berdasarkan rencana dan repositori sebelum menerima tugas. Periksa perbaikan serta tinjauan ulang terbatasnya; pernyataan sukses yang baru bukan hasil pengujian terbaru. Alur 7.0.0 membatasi siklus perbaikannya dan dapat menunda temuan dengan keputusan tertulis. Simpan temuan tersebut untuk tinjauan berikutnya. Tugas yang ditandai selesai belum tentu memiliki tinjauan tanpa masalah.

Setelah semua tugas selesai, periksa ulasan terpisah atas seluruh branch. Ulasan ini dapat menemukan interaksi antartugas dan memeriksa kembali temuan tertunda yang tidak dapat diselesaikan peninjau tugas dari satu diff. Minta bukti dan keputusan untuk setiap masalah terbuka. Simpan desain, rencana, keluaran pengujian, laporan tinjauan, dan seluruh diff sebelum ruang kerja sementara plugin dibersihkan. Jika keterampilan yang diharapkan tidak terpicu, periksa status serta versi plugin aktif dan jalur diagnosis yang didokumentasikan; jangan menganggap alur telah diberlakukan hanya karena plugin terpasang.

4. Periksa branch dan tentukan tindak lanjutnya

Jalankan kembali perintah penerimaan awal pada kode akhir, beserta seluruh rangkaian pengujian proyek. Periksa keluaran terbaru, diff seluruh branch, dan semua temuan yang belum selesai. Manual verifikasi Superpowers mensyaratkan bukti keadaan terkini sebelum menyatakan pekerjaan selesai. Jika rangkaian pengujian gagal, identifikasi kegagalan tepatnya lalu perbaiki atau tinggalkan branch untuk ditinjau; menu penyelesaian branch yang didokumentasikan tidak dicapai ketika rangkaian pengujian gagal.

Pada branch bernama, finishing-a-development-branch menawarkan penggabungan lokal, push dan pembuatan pull request, atau mempertahankan branch apa adanya. Pada detached HEAD tersedia pilihan pull request dan mempertahankan pekerjaan. Pembuangan pekerjaan hanya dilakukan setelah permintaan eksplisit pemilik dan konfirmasi yang diketik; ini bukan pilihan keempat rutin. Manual penyelesaian branch menjabarkan pilihan tersebut. Tunjukkan pemeriksaan, diff, dan temuan tersisa kepada pemilik sebelum ia memutuskan. Penggabungan, push, penghapusan, atau rilis memerlukan kewenangan yang sesuai untuk tindakan itu.

Hasil yang berguna ialah branch yang dapat ditinjau dan terhubung dengan kebutuhan awal: desain serta rencana yang disetujui, hasil pengujian yang diamati, kedua putusan tinjauan tugas, tinjauan seluruh branch, diff lengkap, dan hasil penerimaan terbaru. Jika pemasangan, akses, anggaran, atau pemeriksaan menghentikan proses, simpan artefak yang terverifikasi dan nyatakan tahap terakhir yang selesai. Dokumentasi menjelaskan proses; dokumentasi tidak membuktikan bahwa perubahan yang belum dijalankan dalam panduan ini lebih cepat, lebih murah, atau memiliki lebih sedikit cacat.

Sumber dan bacaan lanjutan

Untuk perbaikan yang lebih terbatas pada pemeriksaan yang disepakati, lihat panduan BIG CHANGE untuk memverifikasi satu pemeriksaan repositori yang gagal. Proses di sini dimulai lebih awal, dari desain dan rencana untuk perubahan dengan beberapa tugas.