Menyiapkan pabrik perangkat lunak berbasis Archon dan meninjau satu tugas

Rujukan Repositori AI Software Factory menjelaskan jalur dari misi produk dan tugas menuju permintaan penggabungan yang dibuat Archon. Pemasangan dan pemeriksaan alur kerja baru permulaan. Panduan satu jam pertama dari pengelola menyatakan bahwa validasi nyata menyeluruh masih perlu dilakukan. Panduan ini mengikuti commit pabrik 9e2d85298b45497031009597a6ae0811b66fe6d6 dan revisi Archon yang dikuncinya, fad09169ea1b43512bc7ee88470d47f960a3e0f8. Dasarnya adalah pembacaan dokumentasi dan kode, bukan laporan pemasangan atau pengoperasian oleh BIG CHANGE.

Prosedur ini ditujukan bagi tim yang mengendalikan repositori aplikasi atau PRD, izin GitHub, dan akun penyedia model. Pemelihara secara jelas mendokumentasikan kloning dan pemasangan pabrik ke repositori Anda sendiri. Pohon berkas revisi tetap pabrik tidak memiliki lisensi atau pemberitahuan; panduan ini tidak menetapkan hak penggunaan ulang atau distribusi ulang yang lebih luas. Lisensi MIT Archon berlaku pada sumber Archon yang terpisah. Jangan masukkan rahasia penyedia ke teks tugas, prompt, log, atau bukti tinjauan.

Perubahan besar

• Apa yang berubah: Implementasi ini menghubungkan cakupan produk, perencanaan tugas, pemrograman, tinjauan independen dan pemeriksaan eksekusi melalui paket alur Archon yang tetap. Pabrik memberi masukan proyek dan peluncur; paket bersama memuat langkah AI.
• Mengapa penting: Tim dapat menelusuri usulan dari tugas ke perubahan, hasil CI dan kandidat berjalan tertentu sebelum memutuskan penggabungan. Pemeriksaan pemasangan saja meninggalkan jejak itu tidak lengkap; pengelola menyatakan integrasi nyata masih perlu divalidasi.
• Yang perlu diperhatikan: Bukti berguna pertama adalah tugas nyata dengan revisi kiriman yang lulus perjalanan bermakna dan kasus terpisah independen, disertai biaya serta catatan tinjauan yang terlihat oleh tim. Penjadwalan dan penerapan tetap keputusan terpisah setelah tinjauan itu.

1. Periksa repositori, izin, dan sumber tetap

Dokumen Petunjuk penyiapan pengelola mensyaratkan Git, Python 3.10 atau lebih baru, gh yang telah diautentikasi dengan cakupan workflow, repositori jarak jauh GitHub, agen pemrograman, Bun dan uv. Git juga harus dapat mengirim berkas alur kerja (gh auth setup-git). Sebelum menjalankan agen, periksa perintah pengujian, mulai aplikasi dan CI yang sudah ada, perlindungan cabang, akses GitHub, autentikasi penyedia dan penagihan model. Berikan hanya wewenang repositori dan alur kerja yang diperlukan.

Klon pabrik di luar repositori aplikasi dan pilih commit yang ditentukan. Dari akar aplikasi, perintah pemasangan yang didokumentasikan adalah:

git clone https://github.com/coleam00/ai-software-factory ~/ai-software-factory
git -C ~/ai-software-factory checkout 9e2d85298b45497031009597a6ae0811b66fe6d6
python ~/ai-software-factory/bin/factory.py init

Gunakan python3 jika perlu. Pemasang menyalin templat pabrik dan proyek serta memasang sumber Archon yang disebut dalam pack.json. README dan paket pada commit ini sama-sama menyebut fad09169ea1b43512bc7ee88470d47f960a3e0f8. Pemasang tidak mengautentikasi penyedia, memilih tingkatan model, atau memulai jadwal. Tinjau perubahan berkas sebelum menerimanya dalam repositori.

Konfigurasikan penyedia pilihan dan pengenal model yang didukung menurut panduan Archon terpasang. Isi perintah nyata untuk pemeriksaan statis dan pengujian unit di harness/harness.config.json. Jika GitHub tidak dapat melaporkan perlindungan cabang, sebutkan pekerjaan CI yang wajib untuk penggabungan dalam required_checks. Tinjau protected_paths agar perubahan misi, kerangka pengujian dan kebijakan pabrik memerlukan manusia. Templat membiarkan perintah pemeriksaan biasa dan required_checks kosong; menyalinnya saja tidak menghasilkan gerbang penerimaan yang berguna.

2. Tulis misi dan pemeriksaan produk yang sudah ada

Isi MISSION.md dengan tujuan produk, batas tegas dan permintaan masuk akal di luar cakupan. Dalam harness/END-TO-END.md, jelaskan dua sampai lima perjalanan pengguna yang benar-benar diselesaikan aplikasi saat ini, termasuk manfaat yang terlihat. Perjalanan yang membutuhkan fitur belum dibuat akan menghambat pengiriman pertama. Tulis kasus terpisah dalam .factory/holdout/HOLDOUT.md untuk menggabungkan perilaku atau menguji kondisi batas. Nama direktori tidak menyembunyikannya dari pembuat yang dapat mengakses salinan kerja yang sama; tempatkan kasus yang benar-benar privat di luar salinan itu dan berikan hanya kepada tahap verifikasi.

Untuk repositori yang hanya berisi PRD, README meminta misi, perjalanan yang direncanakan dan perintah pengujian diambil dari dokumen. Usulan tugas pertama harus membuat produk dapat dijalankan dan menyebut perintah mulai, jalur kesehatan dan identitas build, pengujian serta CI. Tinjau usulan sebelum mengizinkan penerbitan tugas.

Ubah perjalanan menjadi masukan skenario yang diharapkan alur eksekusi Archon. Ikuti factory/RUNTIME_HOST.md terpasang untuk cuplikan aplikasi dari commit hasil pengiriman, keadaan baru, pemeriksaan kesehatan dan identitas build, serta perintah peluncuran Python atau Node yang diizinkan. Host terdokumentasi tidak mengelola basis data jarak jauh, kontainer atau sumber daya awan sebagai sumber daya eksekusinya sendiri. Aplikasi yang memakainya memerlukan pengaturan verifikasi dengan alasan tersendiri; keberhasilan pemeriksaan host lokal tidak membuktikan isolasinya.

Sebelum mengandalkan evaluator, buat acuan yang lulus dan menguji manfaat nyata, tunjukkan bahwa kesalahan sengaja yang relevan gagal, dan pastikan identitas kandidat keliru menghasilkan putusan tidak konklusif. Panduan host memberi masukan rangkaian dan kolom persis yang diharapkan, termasuk expectations_passed: true dan baseline_verified: true. Simpan keluaran asli aktual dan identitas kandidat sebagai bukti. Pemeriksaan yang hanya melihat halaman termuat, atau pengujian yang langsung menyiapkan keadaan akhir, terlalu lemah.

3. Periksa pemasangan, lalu pilih satu pekerjaan

Jalankan dari akar aplikasi:

python factory/consumer.py doctor
python factory/consumer.py list

doctor memeriksa sumber tetap, kemampuan perintah dan alur tersedia. list menampilkan alur yang ditemukan. Keduanya tidak membuktikan penyedia bisa menyelesaikan tugas, CI akan lulus, atau aplikasi akan berjalan. Selesaikan kegagalan yang dilaporkan sebelum pengiriman; biarkan jadwal mati.

Untuk basis kode yang sudah ada, tulis satu tugas kecil dengan hasil dan pemeriksaan penerimaan yang jelas. README mendokumentasikan perintah ini untuk triase, pengiriman dan tinjauan sampai permintaan penggabungan:

python factory/consumer.py run archon-ship --input target=https://github.com/OWNER/REPO/issues/1 --input discovery_publication=preview --detach --json

Ganti URL tugas dengan yang Anda kendalikan. discovery_publication=preview secara eksplisit mencegah temuan terkait dari tinjauan diterbitkan sebagai tugas; alur tetap archon-ship memakai auto secara bawaan. Gunakan archon-lifecycle hanya setelah masukan skenario eksekusi dan kasus uji terpisah siap. Berikan tugas sebagai target, jalurnya sebagai scenario dan holdout, serta merge_mode=approve dan discovery_publication=preview. Sediakan pula merge_method yang disetujui proyek: merge, squash atau rebase. Misalnya, gunakan merge_method=squash hanya jika repositori mengizinkan. Alur ini mencakup verifikasi eksekusi dan kasus terpisah, perbaikan dan gerbang penggabungan. Mode persetujuan mempertahankan keputusan manusia sebelum penggabungan; label siap bukan keputusan itu. Opsi host pabrik --runtime-host yang didokumentasikan hanya berjalan di latar depan dan tidak dapat bersama --detach atau --resume.

Untuk PRD, perintah backlog yang didokumentasikan adalah:

python factory/consumer.py run archon-backlog --input 'prd=docs/PRD.md' --input publication=approve

Ganti docs/PRD.md dalam tanda petik dengan jalur PRD sebenarnya relatif terhadap salinan kerja aplikasi. Tinjau urutan tugas usulan sebelum penerbitan. Hubungkan host eksekusi memakai perintah mulai aplikasi dan kontrak identitas yang dinyatakan tugas pertama, lalu jalankan tugas itu melalui archon-lifecycle dengan perjalanan dan kasus terpisah yang siap. Tugas pertama perlu ketelitian yang sama dengan tugas selanjutnya.

4. Nilai perubahan dan hasil yang berjalan sebelum menyetujui

Simpan ID eksekusi yang dikembalikan. Program pengendali menyediakan get <run-id> --json --events dan status --all --json untuk kemajuan dan bukti. Cocokkan tugas serta rencana dengan MISSION.md; baca perubahan PR sebenarnya dan tinjauan independen atas revisi terkini; periksa CI wajib dan laporan jalur terlindungi. Jalankan perjalanan produk pada revisi terkirim dan tinjau hasil asli eksekusi serta kasus terpisah, termasuk identitas kandidat. Bandingkan hasil pengguna yang diamati dengan kriteria penerimaan. Peninjau harus mengembalikan PR yang kurang memadai untuk diperbaiki; README menjelaskan archon-deliver --adopt <run id> untuk eksekusi pengiriman yang ditahan antrean penggabungan.

Hanya manusia berwenang pada repositori yang boleh menyetujui penggabungan setelah pemeriksaan lulus. Penerapan memerlukan perintah khusus proyek untuk penerapan, kesehatan dan identitas serta pembacaan ulang revisi setelah diterapkan; PR yang digabung tidak membuktikan penerapan. Biarkan jadwal mati sepanjang tugas pertama dan putuskan secara terpisah apakah eksekusi berulang perlu diaktifkan.

Dokumen Petunjuk biaya pengelola tidak memberikan harga tetap per eksekusi. Sarannya: ukur token sejak hari pertama dan amati panggilan model pada satu tugas kecil sebelum mengaktifkan perulangan. Biaya bergantung pada penyedia, model dan ketentuan akun. BIG CHANGE belum mengukur belanja pabrik ini.

Eksekusi aktif juga memerlukan keputusan berhenti yang eksplisit. Dalam kode pengendali, halt memblokir peluncuran baru dan kelanjutan, sedangkan cancel <run-id> menargetkan pekerjaan aktif. pause menghentikan peluncuran timer tetapi mengizinkan kebangkitan pekerjaan yang sedang berjalan. Tidak satu pun menggantikan pemeriksaan keadaan eksekusi saat ini dan perubahan repositori jarak jauh.

Sumber dan bacaan lanjutan

• README pabrik pada revisi tetap: pemasangan, perintah, masukan produk, pilihan alur dan batas yang dinyatakan. Deskripsi pengelola, bukan bukti eksekusi BIG CHANGE.
• Manifest paket tetap dan kode pengendali: revisi Archon, alur yang tersedia serta perbedaan status, halt, cancel dan pause.
• Panduan satu jam pertama dan panduan host eksekusi: catatan validasi pengelola serta syarat pemeriksaan eksekusi yang terikat pada kandidat.
• Laporan terkait BIG CHANGE mengenai agen pemrograman dan pekerjaan selesai: konteks pemeriksaan hasil tuntas. Laporan ini membahas studi berbeda, bukan kelanjutan bertanggal dari implementasi pabrik.