Cara Bekerja dengan Developer pada Aplikasi Buatan AI

Untuk bekerja dengan baik bersama developer pada aplikasi yang Anda bangun dengan AI, berikan kode dalam repositori Git, ringkasan satu halaman tentang apa yang dilakukan aplikasi dan mengapa, serta tugas yang lingkupnya jelas dengan definisi selesai. Sepakati siapa mengubah bagian mana agar Anda dan AI tidak menimpa pekerjaan mereka. Simpan repositori dan akun hosting atas nama Anda, dan bagikan secret melalui pengaturan yang layak, bukan lewat pesan.

Banyak orang membangun versi pertama aplikasi dengan AI lalu melibatkan developer, misalnya untuk menambahkan pembayaran, memperbaiki sesuatu yang terus-menerus gagal ditangani AI, meninjau keamanan, atau mengambil alih saat aplikasi berkembang. Jika Anda masih memutuskan apakah perlu merekrut, lihat sewa developer atau bangun dengan AI. Panduan ini mengasumsikan Anda sudah memutuskan dan ingin kolaborasinya berjalan lancar.

Kapan developer layak dilibatkan

Alasan umum untuk melibatkan seseorang:

• Masalah yang tidak bisa dipecahkan AI setelah beberapa percobaan yang jelas dan rollback.
• Area berisiko: pembayaran, izin akses, data sensitif, migrasi database.
• Tinjauan keamanan atau kode sebelum peluncuran atau sebelum menerima pelanggan yang lebih besar.
• Performa saat trafik sungguhan datang.
• Pertumbuhan: aplikasi sudah menjadi bisnis dan membutuhkan seseorang yang memiliki kodenya.

Kejelasan tentang alasan mana yang berlaku akan membentuk semua hal di bawah ini.

Langkah 1: Letakkan kode di tempat yang bisa dibagikan

Developer bekerja dari repositori Git. Sebelum menghubungi siapa pun:

1. Hubungkan proyek ke repositori GitHub (atau sejenisnya) yang privat, atau ekspor.
2. Pastikan tidak ada secret di kode atau riwayatnya. Lihat cara menjaga API key tetap aman.
3. Pastikan proyek berjalan dari salinan baru. Minta AI menuliskan langkah pengaturannya.

Tulis README untuk developer yang bergabung ke proyek ini: apa yang dilakukan aplikasi, stack-nya, cara instal dan menjalankannya secara lokal, variabel lingkungan yang dibutuhkan (hanya nama), struktur folder, dan hal-hal yang rapuh atau tidak biasa.

Jika Git masih baru bagi Anda, cara menggunakan Git dengan aplikasi buatan AI membahas dasar-dasarnya.

Langkah 2: Tulis ringkasan satu halaman

Developer tidak mengikuti riwayat chat Anda. Berikan konteksnya dalam satu halaman:

• Apa yang dilakukan aplikasi, untuk siapa, dan berapa banyak orang yang memakainya.
• Apa yang paling penting: alur yang tidak boleh rusak.
• Masalah yang sudah diketahui dan apa yang sudah Anda coba.
• Tugasnya, dan bagaimana Anda tahu bahwa tugas itu selesai.
• Batasan: anggaran, tenggat, dan hal-hal yang tidak boleh mereka ubah.

Definisi "selesai" yang baik bisa diuji: "Pengguna yang sudah login bisa membayar paket bulanan dengan Stripe Checkout, paket itu muncul di halaman akunnya, dan membatalkan lewat customer portal menurunkan statusnya di akhir periode." Bukan "beresin pembayaran".

Langkah 3: Berikan akses dengan aman

• Kode: tambahkan mereka sebagai kolaborator di repositori. Jangan bolak-balik mengirim file ZIP setelah pekerjaan dimulai.
• Builder: jika AI app builder Anda mendukung anggota tim, undang mereka ke workspace yang hanya berisi proyek ini.
• Secret: tambahkan di pengaturan host Anda, atau bagikan lewat password manager. Jangan pernah menempelkan key di email atau chat.
• Akun uji: buat dengan data uji, alih-alih membagikan login Anda sendiri.
• Data produksi: hanya jika mereka benar-benar membutuhkannya, dan hanya yang mereka butuhkan.

Simpan repositori, domain, dan akun hosting atas nama Anda. Tambahkan orang; jangan serahkan akun.

Langkah 4: Sepakati siapa mengubah apa

Sumber gesekan terbesar adalah dua pihak (Anda bersama AI, dan developer) yang mengubah kode yang sama pada waktu yang sama. Pilih satu aturan:

Apa pun pilihannya: lakukan pull ke kode terbaru sebelum setiap sesi meminta, dan buat perubahan besar di branch yang bisa ditinjau oleh pihak lain.

Langkah 5: Berkomunikasi secara tertulis

• Laporkan masalah dengan langkah, hasil yang diharapkan, dan hasil yang sebenarnya. Lihat cara menulis laporan bug yang baik.
• Simpan keputusan di satu tempat: pelacak isu, dokumen bersama, atau komentar pull request.
• Minta mereka menjelaskan perubahan dengan bahasa sederhana di setiap pull request.
• Sepakati seberapa sering kalian akan saling memeriksa progres.

Langkah 6: Tinjau pekerjaan mereka

Anda tidak perlu membaca kode untuk meninjau pekerjaan. Periksa:

• Apakah sesuai dengan ringkasan, di preview atau salinan staging.
• Tidak ada yang lain yang rusak: jalankan alur-alur kritis Anda.
• Mereka menjelaskan apa yang mereka ubah dan mengapa.
• Tidak ada secret yang muncul di kode.

Untuk pemeriksaan yang lebih dekat, cara meninjau kode yang dibuat AI memiliki daftar periksa yang juga berlaku untuk kode yang ditulis manusia. Anda juga bisa meminta AI builder Anda menjelaskan pull request developer dengan bahasa yang sederhana.

Langkah 7: Jaga kepemilikan tetap jelas

• Repositori, hosting, domain, dan akun pihak ketiga tetap atas nama Anda.
• Tuliskan kepemilikan kode yang mereka tulis sebelum pekerjaan dimulai. Periksa aturan setempat atau minta penasihat untuk pertanyaan kontrak.
• Saat pekerjaan selesai, cabut akses mereka dan ganti key yang sempat mereka lihat.

Contoh permintaan

Developer mengubah kode checkout di pull terakhir. Jelaskan dengan bahasa sederhana apa yang mereka ubah dan apakah ada bagian lain aplikasi yang bergantung padanya.

Daftarkan bagian aplikasi ini yang paling kompleks atau berisiko, supaya saya bisa memberi tahu developer di mana harus memfokuskan tinjauan.

Saya menyerahkan pembayaran kepada developer. Mulai sekarang jangan sentuh file apa pun di src/payments atau rute /api/billing. Jika suatu perubahan membutuhkannya, beri tahu saya.

Kesalahan umum

• Tanpa ringkasan. Developer menghabiskan jam yang dibayar untuk menebak apa yang Anda inginkan.
• Lingkup yang kabur seperti "perbaiki bug-bugnya" atau "buat siap produksi".
• Keduanya mengedit bersamaan tanpa pull dulu, lalu kehilangan pekerjaan karena konflik.
• Membagikan login Anda sendiri atau menempelkan key di chat.
• Akun atas nama developer, sehingga sulit berpisah.
• Lupa mencabut akses dan mengganti key setelah pekerjaan selesai.

Daftar periksa

• Kode berada di repositori privat atas nama saya, tanpa secret di dalamnya.
• README menjelaskan pengaturan; ringkasan satu halaman menjelaskan aplikasi dan tugasnya.
• Tugasnya punya definisi selesai yang bisa diuji.
• Akses lewat undangan kolaborator, secret lewat pengaturan atau password manager.
• Kami sudah sepakat siapa mengubah apa, dan saya melakukan pull sebelum meminta.
• Pekerjaan ditinjau terhadap ringkasan dan alur-alur kritis.
• Kepemilikan tertulis; akses dicabut dan key diganti saat pekerjaan berakhir.

Bekerja dengan developer di Mythex

• Undang mereka ke workspace. Owner bisa mengundang kolaborator tanpa batas dan tanpa biaya per kursi; anggota bekerja pada proyek-proyek di workspace. Gunakan workspace terpisah agar mereka hanya melihat proyek ini. Kredit untuk aplikasi yang dipublikasikan ditagihkan ke owner workspace. Lihat Undangan.
• Sinkronisasi GitHub dan ekspor (Pro). Hubungkan repositori dan lakukan push/pull, atau ekspor proyek dengan secret yang dikecualikan. Lihat GitHub, ekspor, dan impor.
• Bagikan tautan preview untuk menunjukkan pekerjaan yang sedang berjalan kepada seseorang yang tidak punya akun Mythex; hapus saat sudah selesai.
• Mode Ask menjawab pertanyaan tentang kode tanpa mengubahnya, berguna untuk memahami perubahan developer.

Jika developer akan menjalankan aplikasi di tempat lain, lihat cara mengekspor dan self-host aplikasi buatan AI.

Pertanyaan