AI-DLC 2.11.0 dapat menghentikan alur kerja Codex CLI sebelum pembuatan kode agar pengembang membaca dan menyetujui rencana yang diusulkan. Panduan ini mengikuti rilis v2.11.0 tanggal 8 Oktober 2026 beserta petunjuk berversi untuk Codex CLI, profil alur kerja dan Plan Approval. BIG CHANGE memeriksa dokumen tersebut dan referensi perintah pada tag rilis. Kami tidak memasang atau menjalankan AI-DLC; seluruh langkah di bawah hanya berdasarkan dokumentasi.

Pembaca yang dituju adalah pengembang dengan proyek Git yang ingin memeriksa rencana kode sebelum asisten pemrograman AI membuat berkas. Hasil yang diharapkan adalah pertanyaan Plan Approval yang menyebut rencana, memungkinkan permintaan perubahan, dan membiarkan build menunggu hingga pengembang menjawab. AI-DLC masih memiliki pemeriksaan lanjutan; gerbang ini khusus mengenai rencana kode.

Sebelum memulai

Dokumentasi bertag berupa panduan Codex mensyaratkan Codex CLI 0.145.0 atau lebih baru, repositori Git untuk hook proyek, dan penyedia model yang sudah dikonfigurasi. Rilis native AI-DLC tidak memerlukan Bun atau Node.js. Gunakan proyek yang kode dan rencananya boleh Anda kirim ke penyedia model yang dikonfigurasi. Tinjau ketentuan penanganan data dan penagihan penyedia secara terpisah; repositori AI-DLC tidak menetapkan satu harga penggunaan penyedia untuk alur ini.

Siapkan tugas pengembangan yang konkret sebagai masukan. Panduan ini memilih profil Feature karena dokumentasi v2.11.0 menyatakan Plan Approval aktif untuk Feature. Express dan Proof of concept dimulai dengan Plan Approval nonaktif, meski seseorang dapat meminta peninjauan rencana tertentu. Profil lebih penting daripada anggapan umum bahwa setiap penggunaan AI-DLC akan berhenti sejenak.

1. Pasang dan verifikasi rilis yang dikunci

Di macOS, Linux, atau WSL, rilis v2.11.0 menyediakan perintah pemasang khusus versi berikut:

Terminal
curl -fsSL https://github.com/awslabs/aidlc-workflows/releases/download/v2.11.0/install.sh | sh -s -- --version 2.11.0

Rilis juga menyediakan pemasang Windows khusus versi tersebut untuk PowerShell. Periksa pemasang dan pilih jalur yang sesuai untuk komputer Anda sebelum menjalankannya. Kemudian periksa versi terpasang dan lingkungan dari proyek:

Terminal
aidlc --version
aidlc doctor
codex --version

Harapkan aidlc --version menampilkan 2.11.0. aidlc doctor melaporkan masalah konfigurasi dan runtime, sedangkan codex --version memungkinkan pemeriksaan versi minimum Codex CLI. Jika versi terpasang berbeda, berhenti di sini dan gunakan petunjuk pemasangan atau penyegaran dari rilis v2.11.0; langkah berikut dikunci ke rilis itu.

2. Konfigurasikan Codex dan percayai hook proyek

Dari direktori akar proyek Git, gunakan jalur penyiapan Codex pada tag rilis:

Terminal
aidlc config --harness codex
aidlc doctor
codex

Codex bertanya apakah hook proyek dipercaya. Tinjau proyek dan hook yang dibuat sebelum memilih Trust all and continue (Percayai semua dan lanjutkan). Panduan bertag menyebut dialog yang sudah ditutup dapat dibuka lagi dengan /hooks, kemudian t dan Esc. Jalankan $aidlc --doctor di Codex setelah memberi kepercayaan. Jika hook tidak berjalan, ikuti pemulihan kepercayaan pada panduan lingkungan integrasi; keberhasilan pemasang saja tidak membuktikan hook proyek aktif. Penyedia model dan kredensialnya diatur dalam pengaturan tingkat pengguna Codex, bukan disediakan oleh AI-DLC.

3. Mulai alur Feature dan periksa pengaturannya

Pertama jalankan $aidlc --status di Codex dan pastikan tidak ada alur kerja aktif. Referensi perintah pada tag rilis menyebut bahwa perintah cakupan tanpa opsi tambahan melanjutkan pekerjaan yang ada ketika alur kerja aktif. Gunakan proyek tanpa alur aktif untuk panduan ini.

Di proyek Codex yang telah dikonfigurasi itu, ketik $aidlc feature dan jawab permintaan mengenai tugas yang ingin dibuat. Masukan sebaiknya menjelaskan fitur dan batasannya; rencana akhirnya dihasilkan dari pekerjaan itu. Sebelum rencana kode dibuat, periksa kontrol yang benar-benar berlaku menggunakan referensi perintah v2.11.0:

Text
$aidlc --status
$aidlc config get plan-approval
$aidlc config get guard-policy

Cari Plan Approval on (aktif) dan sumber pengaturan yang disebutkan. Jika nonaktif untuk intent ini, $aidlc --plan-approval on mengaktifkan pertanyaan untuk rencana berikutnya. Sakelar tingkat mesin dapat memaksanya nonaktif, dan aturan memori tim dapat mewajibkannya aktif; baris status menunjukkan nilai yang berlaku. Untuk panduan ini, atur Guard Policy menjadi ketat dengan $aidlc --guard-policy strict jika Anda juga ingin rencana yang sudah disetujui lalu diedit, atau petunjuk pengujiannya, memerlukan persetujuan lagi. Plan Approval aktif mengontrol pertanyaan pertama; Guard Policy mengontrol apa yang terjadi setelah rencana yang disetujui berubah.

4. Tinjau rencana kode pada gerbang persetujuan

Lanjutkan alur hingga Code Generation menyiapkan rencana. Dengan Plan Approval aktif, mesin v2.11.0 menampilkan ringkasan dan jalur rencana, termasuk pilihan Approve Plan (Setujui Rencana), Request Changes (Minta Perubahan), atau I'll edit the files (Saya akan mengedit berkas). Buka berkas code-generation-plan.md yang disebutkan, lalu baca usulan berkas, urutan, dan petunjuk pengujiannya. Tinjau perintah, akses ke data proyek, dan tindakan yang mungkin mengubah repositori sebelum menyetujui.

Pilih Request Changes (Minta Perubahan) jika rencana memerlukan implementasi atau pengujian berbeda. Jika mengedit sendiri, gunakan jalur mesin I'll edit the files (Saya akan mengedit berkas) alih-alih menganggap pengeditan sebagai persetujuan. Hanya jawaban Anda yang mengizinkan rencana; model tidak dapat menyetujuinya untuk Anda. Dengan gerbang aktif, pembuatan kode menunggu jawaban itu. Catatan rilis menyebut peninjauan, pengaturan, commit, atau permintaan lain yang diizinkan dapat berjalan sementara build menunggu.

5. Setujui, periksa catatan, dan tangani perubahan rencana

Saat rencana sudah dapat diterima, jawab Approve Plan (Setujui Rencana) pada pertanyaan yang terbuka. Mesin mencatat persetujuan untuk rencana itu dan melanjutkan build melalui alur normal next. Menurut catatan rilis, rencana yang telah disetujui dan tidak berubah tetap diingat meski percakapan dipadatkan atau diparkir. Referensi perintah pada tag rilis mendokumentasikan perintah hanya-baca aidlc engine audit history untuk memeriksa linimasa yang tercatat, dan $aidlc --status menunjukkan posisi alur kerja. Catatan ini menjadi pemeriksaan keberhasilan, bersama gerbang yang tampak muncul sebelum kode dibuat.

Jika rencana atau petunjuk pengujiannya berubah sebelum build, Guard Policy ketat meminta persetujuan lagi. Pada kebijakan longgar atau nonaktif, perubahan dilaporkan dan dicatat, tetapi alur dapat berlanjut tanpa persetujuan baru yang wajib. Dokumentasi bertag juga membedakan perubahan berkas sumber yang tidak terkait setelah persetujuan: perubahan itu dilaporkan, sementara persetujuan tetap mengenai rencana dan petunjuk pengujian. Pengguna dapat mengatakan “kembali ke rencana yang disetujui” untuk memulihkan rencana sebelumnya sebelum build. Rencana yang tidak berubah seharusnya tidak memunculkan pertanyaan kedua hanya karena percakapan dipadatkan.

Jika jeda tidak muncul

Pertama baca $aidlc --status dan $aidlc config get plan-approval. Periksa cakupan yang dipilih, pengaturan yang berlaku, dan sumbernya. Express serta Proof of concept secara bawaan nonaktif; aktifkan Plan Approval untuk intent itu atau mulai alur Feature jika seluruh siklusnya cocok dengan tugas. Jika konfigurasi atau hook tampak bermasalah, jalankan aidlc doctor dan ikuti pemulihan lingkungan integrasi Codex. Periksa ketidakcocokan versi sebelum mengubah runtime proyek aktif. Jangan menganggap tidak adanya pertanyaan membuktikan persetujuan tercatat: dengan pengaturan nonaktif, AI-DLC menulis baris PLAN_APPROVAL_SKIPPED, yang secara eksplisit dibedakan dokumentasi bertag dari persetujuan seseorang.

Perubahan besar

  • AI-DLC 2.11.0 menempatkan pertanyaan rencana dalam mesinnya, yang mencatat keputusan dan mempertahankan rencana yang telah disetujui tanpa perubahan dalam sesi yang diparkir atau dipadatkan.
  • Dalam alur Codex CLI Feature, pengembang dapat memeriksa pengaturan Plan Approval yang berlaku, membaca rencana sebelum pembuatan kode, dan meminta perubahan pada gerbang persetujuan.
  • Persetujuan ulang setelah rencana diedit bergantung pada Guard Policy. Pengembang dapat memilih kebijakan ketat agar berhenti lagi ketika rencana atau petunjuk pengujian berubah.

Sumber dan bacaan lanjutan