Integrasi AI dalam workflow web development paling efektif kalau AI ditempatkan di tahap yang tepat: memecah kebutuhan menjadi tugas, menulis kode berpola, membuat test, meninjau pull request, dan menulis dokumentasi. Di setiap tahap, manusia tetap memegang keputusan desain dan persetujuan akhir. Artikel ini memetakan pemakaian AI per tahap beserta aturan tim yang perlu disepakati.
Peta AI dalam Workflow Web Development
| Tahap | Peran AI | Peran developer |
|---|---|---|
| Perencanaan | Memecah kebutuhan jadi tugas, menemukan kasus tepi | Memutuskan cakupan dan prioritas |
| Desain teknis | Membandingkan pendekatan, menulis draf skema | Memilih arsitektur |
| Coding | Menulis kode berpola, boilerplate, migrasi | Meninjau dan menyesuaikan |
| Test | Menulis test dari spesifikasi | Memastikan test menguji hal yang benar |
| Code review | Tinjauan pertama: bug, keamanan, konsistensi | Tinjauan akhir dan persetujuan |
| Dokumentasi | Draf README, changelog, deskripsi PR | Mengoreksi dan melengkapi |
1. Perencanaan: Dari Kebutuhan ke Tugas
Kebutuhan dari klien: "Admin bisa ekspor laporan penjualan ke Excel,
filter per tanggal dan cabang."
Pecah menjadi tugas teknis untuk aplikasi Laravel. Untuk setiap
tugas: deskripsi, file yang kemungkinan terlibat, perkiraan
kompleksitas (kecil/sedang/besar), dan kasus tepi yang perlu diuji.AI pandai menemukan kasus tepi yang sering terlupa: data kosong, ribuan baris, zona waktu, atau cabang yang sudah dinonaktifkan.
2. Desain Teknis
Gunakan AI sebagai teman diskusi, bukan pengambil keputusan. Minta perbandingan pendekatan dengan konteks proyekmu:
Ekspor bisa sampai 200.000 baris. Bandingkan: ekspor langsung saat
request, queue job lalu kirim tautan unduhan, atau streaming CSV.
Pertimbangkan server 2 vCPU dan batas waktu request 60 detik.3. Coding
Tiga cara memakai AI saat coding, dari yang paling ringan:
- Autocomplete di editor untuk baris dan fungsi kecil.
- Chat dengan konteks untuk fungsi atau kelas tertentu. Polanya dibahas di cara prompt AI untuk coding.
- Agent yang mengerjakan tugas lintas file dan menjalankan test, dibahas di agentic AI coding.
Apa pun caranya, simpan file aturan proyek (misalnya AGENTS.md atau CLAUDE.md) berisi konvensi, perintah test, dan struktur folder. Ini membuat hasil AI konsisten dengan kode tim.
4. Test
AI sangat membantu menulis test, terutama untuk kode lama yang belum punya test. Tapi periksa dua hal:
- Test benar-benar menguji perilaku, bukan sekadar memanggil fungsi tanpa assertion yang berarti.
- Test tidak "disesuaikan" dengan bug yang ada. Kalau kode salah dan AI menulis test berdasarkan kode itu, bug-nya ikut dikunci.
Tulis spesifikasi perilaku dulu, lalu minta test dari spesifikasi, bukan dari kode.
5. Code Review
AI cocok sebagai peninjau pertama sebelum rekan kerja meninjau:
Tinjau diff ini. Fokus: bug logika, celah keamanan (otorisasi,
validasi input, query), query N+1, dan penanganan error.
Abaikan gaya yang sudah dirapikan formatter. Urutkan dari risiko
tertinggi, sebut file dan baris.Dengan begitu, waktu peninjau manusia bisa dipakai untuk hal yang AI lemah: kesesuaian dengan kebutuhan bisnis dan keputusan desain. Celah yang paling sering lolos ada di OWASP Top 10 untuk Laravel.
6. Dokumentasi
- Deskripsi pull request dari diff: apa yang berubah, kenapa, dan cara mengujinya.
- Changelog dari daftar commit.
- README untuk setup lokal, diuji dengan mengikutinya di mesin bersih.
Aturan Tim yang Perlu Disepakati
- Penulis bertanggung jawab. Kode dari AI diperlakukan sama dengan kode yang ditulis sendiri: harus dipahami dan bisa dijelaskan.
- Tidak ada rahasia di prompt. Kredensial, data pelanggan, dan isi
.envtidak boleh dikirim ke layanan AI. - Tools yang disetujui. Sepakati layanan AI yang boleh dipakai dan pengaturan privasinya, terutama untuk kode klien.
- Test wajib. Perubahan dari AI tidak di-merge tanpa test yang lulus di CI.
- Tandai perubahan besar. Untuk perubahan yang sebagian besar dibuat agent, sebut di deskripsi PR agar peninjau lebih teliti.
Kesalahan yang Sering Terjadi
- Memakai AI hanya di tahap coding. Manfaat terbesar sering justru di perencanaan dan review.
- Setiap developer memakai cara sendiri. Tanpa aturan dan file konvensi bersama, gaya kode jadi tidak seragam.
- Mengukur produktivitas dari jumlah baris kode. Ukur dari waktu sampai fitur siap rilis dan jumlah bug setelah rilis.
Langkah Berikutnya
Mulai dari satu tahap yang paling sering memakan waktu timmu, misalnya review atau test, dan uji selama dua minggu. Untuk tugas yang melibatkan beberapa agent sekaligus, lihat multi-agent workflow.
