Skip to content
← Semua bab

Bab 05

Arketipe repositori

Sebelum mengubah satu baris pun, agent membuat satu keputusan yang membentuk segalanya setelahnya: repositori macam apa ini? Arketipe yang disimpulkannya menetapkan batas tempat ia akan bernalar sepanjang penugasan — cara ia meng-onboard, seberapa jauh sebuah rencana menjangkau, dan di mana status disimpan. Salah identifikasi, dan agent akan menetapkan lingkup pekerjaan pada permukaan yang keliru — sumber drift paling umum pada tugas berjangka panjang. Identifikasi dengan benar, dan agent dapat bekerja secara otonom selama berjam-jam, karena rencana, onboarding, dan status semuanya selaras dengan bentuk kode yang sesungguhnya.

DWP mengenali dua arketipe. Sebagian besar repositori termasuk yang pertama; yang kedua ada untuk tim yang mengoordinasikan banyak repositori.

Repositori individual

Kasus umum: sebuah basis kode yang mandiri — sebuah aplikasi, sebuah pustaka, atau sebuah layanan. Ada satu permukaan koheren untuk dinalar, sehingga rencana beroperasi langsung pada kode di dalam repositori dan onboarding membaca struktur serta konvensi repositori itu sendiri. Agent memegang seluruh basis kode sebagai konteksnya dan mengerjakannya dari ujung ke ujung.

Karakteristik:

  • Satu basis kode yang koheren.
  • Rencana memodifikasi berkas di repositori ini.
  • Ruang kerja .dwp/ berada di akar repositori.

Orchestrator hub

Kasus koordinasi: sebuah repositori yang tugasnya adalah mengelola repositori lain. Di sini unit kerja bukan sebuah berkas melainkan sebuah repositori turunan, sehingga rencana dapat memunculkan rencana turunan di sub-repositori, dan onboarding membaca registri repositori yang dikelola hub alih-alih satu basis kode. Agent bernalar tentang batas dan serah terima — repositori mana yang memiliki pekerjaan yang mana, dan bagaimana status mereka tetap konsisten.

Karakteristik:

  • Mengoordinasikan beberapa sub-repositori.
  • Rencana dapat mendelegasikan ke rencana turunan.
  • Memelihara sebuah registri repositori yang dikelola.
  • Ruang kerja .dwp/ di akar hub melacak status lintas repositori.

Heuristik klasifikasi

Kedua arketipe terlihat berbeda di disk, dan agent memilih di antara keduanya berdasarkan sinyal yang dapat diverifikasinya — bukan label yang diberitahukan kepadanya. Pohon keputusan di bawah ini menunjukkan jalurnya; singkatnya, perlakukan sebuah repositori sebagai orchestrator hub hanya ketika bukti menuntutnya, dan sebagai repositori individual dalam kondisi lainnya.

Sebuah agent sebaiknya mengklasifikasikan sebuah repositori sebagai orchestrator hub ketika ia menemukan beberapa repositori git bersarang atau submodule, sebuah registri atau manifes repositori yang dikelola, atau konfigurasi yang menunjuk ke repositori eksternal. Dengan tidak adanya sinyal-sinyal itu, ia memperlakukan repositori sebagai repositori individual — nilai default yang aman, karena menetapkan lingkup rencana terlalu luas melampaui batas yang tidak ada lebih buruk daripada bekerja dalam batas yang ada.

Bagaimana onboarding berbeda

Arketipe bukan sekadar label kosmetik; ia mengubah apa yang dibaca agent, apa yang boleh disentuh rencana, dan di mana status dicatat.

Aspek Individual Orchestrator
Lingkup Repositori ini Beberapa repositori
Onboarding Struktur repositori Registri hub
Target rencana Berkas lokal Rencana turunan
Status .dwp/ lokal .dwp/ lintas repositori

Efek praktisnya adalah bahwa agent repositori individual bernalar tentang satu basis kode dari ujung ke ujung, sementara agent orchestrator bernalar tentang koordinasi — repositori turunan mana yang memiliki pekerjaan yang mana, dan bagaimana status lintas repositori tetap konsisten.

Inilah yang memungkinkan agent bekerja secara otonom selama berjam-jam tanpa pengawasan: dengan menetapkan arketipe terlebih dahulu, ia menetapkan lingkup rencana, onboarding, dan status ke batas yang tepat, sehingga setiap tugas dari yang pertama hingga yang terakhir beroperasi pada permukaan yang benar.