AI-translated from English; not yet reviewed by a fluent editor.

# Menyiapkan pabrik perangkat lunak berbasis Archon dan meninjau satu tugas

> Panduan berdasarkan revisi tetap untuk merencanakan dan meninjau tugas pemrograman Archon, dari misi produk dan pemeriksaan saat berjalan hingga keputusan penggabungan oleh manusia. BIG CHANGE belum menjalankan pabrik ini.

By BIG CHANGE Editorial

Published: 2026-10-19T14:43:34.857Z
Updated: 2026-10-19T14:43:34.857Z
Canonical: https://bigchange.ai/blog/archon-software-factory-reviewed-issue

![Conceptual charcoal illustration of one reviewer studying an unbranded two-column code change printout clipped to a wall rail.](https://bigchange.ai/api/media/file/archon-reviewed-code-change-v2.png)
AI-generated conceptual illustration by BIG CHANGE; no factory installation, issue delivery, code review outcome or product interface is depicted.

Rujukan [Repositori AI Software Factory](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/README.md) menjelaskan jalur dari misi produk dan tugas menuju permintaan penggabungan yang dibuat Archon. Pemasangan dan pemeriksaan alur kerja baru permulaan. [Panduan satu jam pertama](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/docs/first-hour.md) 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](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/README.md#instructions-for-the-agent) 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:

```bash
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`](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/factory/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](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/README.md#instructions-for-the-agent) 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`](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/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:

```bash
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:

```bash
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:

```bash
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](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/README.md#cost) 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](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/factory/consumer.py), `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](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/README.md): pemasangan, perintah, masukan produk, pilihan alur dan batas yang dinyatakan. Deskripsi pengelola, bukan bukti eksekusi BIG CHANGE.
- [Manifest paket tetap](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/factory/pack.json) dan [kode pengendali](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/factory/consumer.py): revisi Archon, alur yang tersedia serta perbedaan status, halt, cancel dan pause.
- [Panduan satu jam pertama](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/docs/first-hour.md) dan [panduan host eksekusi](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/factory/RUNTIME_HOST.md): catatan validasi pengelola serta syarat pemeriksaan eksekusi yang terikat pada kandidat.
- [Laporan terkait BIG CHANGE mengenai agen pemrograman dan pekerjaan selesai](https://bigchange.ai/articles/ai-coding-agents-review-output-study): konteks pemeriksaan hasil tuntas. Laporan ini membahas studi berbeda, bukan kelanjutan bertanggal dari implementasi pabrik.

## Sources

- [README.md](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/README.md) — Penyiapan, berkas proyek, alur, jalur tugas dan PRD, kebijakan penggabungan serta batas operasi dari pengelola.
- [pack.json](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/factory/pack.json) — Revisi Archon yang tepat, entri alur dan kemampuan baris perintah; cocok dengan README tetap.
- [first-hour.md](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/docs/first-hour.md) — Urutan penyiapan dan pernyataan tegas bahwa validasi nyata menyeluruh masih diperlukan.
- [consumer.py](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/factory/consumer.py) — Implementasi doctor/list, pemanggilan alur, status, halt, pause dan cancel.
- [RUNTIME_HOST.md](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/factory/RUNTIME_HOST.md) — Ikatan kandidat, acuan dan kesalahan sengaja untuk kalibrasi, bentuk aplikasi yang didukung dan batasannya.
- [harness.config.json](https://github.com/coleam00/ai-software-factory/blob/9e2d85298b45497031009597a6ae0811b66fe6d6/template/harness/harness.config.json) — Perintah pemeriksaan dan pemeriksaan wajib yang kosong serta jalur terlindungi bawaan.
- [LICENSE](https://github.com/coleam00/Archon/blob/fad09169ea1b43512bc7ee88470d47f960a3e0f8/LICENSE) — Ketentuan lisensi Archon; bukan izin untuk repositori pabrik yang terpisah.
- [archon-ship.yaml](https://github.com/coleam00/Archon/blob/fad09169ea1b43512bc7ee88470d47f960a3e0f8/.archon/workflows/sdlc/ship/archon-ship.yaml) — Penerbitan temuan memakai auto secara bawaan; preview tidak menerbitkan temuan terkait.
- [archon-lifecycle.yaml](https://github.com/coleam00/Archon/blob/fad09169ea1b43512bc7ee88470d47f960a3e0f8/.archon/workflows/sdlc/lifecycle/archon-lifecycle.yaml) — Memerlukan metode penggabungan eksplisit: merge, squash atau rebase.
- [archon-backlog.yaml](https://github.com/coleam00/Archon/blob/fad09169ea1b43512bc7ee88470d47f960a3e0f8/.archon/workflows/sdlc/backlog/archon-backlog.yaml) — PRD dinyatakan sebagai jalur di dalam salinan kerja.
- [BIG CHANGE](https://bigchange.ai/articles/ai-coding-agents-review-output-study) — Konteks berkaitan tetapi berbeda untuk memeriksa hasil yang selesai.