Vite+ memangkas waktu pemeriksaan CI dalam salah satu proyek monorepo penulis dari 4 menit menjadi 50 detik. Namun, angka itu bukan jaminan semua proyek akan lebih cepat: hasilnya bergantung pada konfigurasi dan jenis pemeriksaan yang dijalankan.
Dalam tulisan pengalaman yang menjadi sumber artikel ini, seorang pengembang mengulas penggunaan Vite+ selama tiga minggu di empat proyek. Ia menyarankan pengembang yang membuat aplikasi Vite baru dengan bantuan agen AI untuk memasukkan Vite+ sejak instruksi awal, agar agen mengikuti toolchain dan perintah pemeriksaan proyek.
Masalah yang hendak diatasi bukan semata-mata kecepatan menulis kode. Penulis pernah menghadapi proyek dengan 47 dependensi pengembangan, tujuh berkas konfigurasi, serta dokumen Markdown khusus yang menerangkan cara menjalankan semuanya. Pada satu malam, ia juga harus menelusuri perbedaan hasil pemeriksaan di komputer lokal dan CI.
Vite+ menyatukan perintah kerja proyek
Dalam alur lama, tugas pengembangan tersebar di ESLint, Prettier, TypeScript, alat pengujian, dan skrip di package.json. Agen AI yang masuk ke proyek harus menebak perintah mana yang benar. Penulis lalu membuat instruksi tambahan untuk menjelaskan semuanya—berkas lain yang tetap harus dirawat.
Vite+ mengumpulkan sejumlah pekerjaan sehari-hari di bawah perintah vp. Toolchain ini mencakup Vite untuk pengembangan dan build, Vitest untuk pengujian, Oxlint dan Oxfmt untuk pemeriksaan, tsdown untuk pustaka, serta Vite Task untuk tugas proyek. Konfigurasinya dapat ditempatkan di vite.config.ts.
Bukan berarti semua konfigurasi lenyap. Proyek tetap membutuhkan package.json dan tsconfig, sementara proyek tertentu juga memerlukan konfigurasi kerangka kerja. Penulis menekankan bahwa gagasan satu berkas untuk mengatur semuanya terdengar menarik, tetapi tidak mencerminkan kebutuhan repositori nyata.
Vite+ juga tidak menggantikan npm atau pnpm. Perintah vp install menggunakan pengelola paket yang dipilih untuk proyek. Pengembang dapat memasang vp secara global atau menjalankannya sebagai dependensi lokal melalui pengelola paket.
Vite+ dan agen AI perlu aturan verifikasi
Dokumentasi Vite+ menyediakan prompt untuk asisten AI, tetapi penulis menyesuaikannya dengan kebutuhan tiap proyek. Tujuannya jelas: agen memakai toolchain yang disepakati untuk menyiapkan aplikasi dan tidak beralih diam-diam setelah membuat halaman pertama.
Pengalaman sebelumnya memberi alasan praktis. Ketika agen diberi kebebasan tanpa batasan, penulis mendapati Prettier dan Oxfmt dipakai bersamaan, tiga lockfile muncul, dan CI menjadi tidak andal. Karena itu, instruksi proyeknya melarang formatter kedua dan meminta satu lockfile.
Usai mengubah kode, penulis menjalankan vp check untuk memeriksa format dan lint. Pemeriksaan TypeScript ikut berjalan jika typeAware dan typeCheck diaktifkan dalam konfigurasi. Proyek baru yang dibuat melalui vp create mengaktifkan keduanya secara bawaan, tetapi proyek lama perlu diperiksa—hasil lint yang hijau belum tentu membuktikan tipe sudah benar.
Singkatnya: lolos lint belum cukup.
Penulis juga menjalankan vp test untuk memeriksa perilaku aplikasi dan vp build untuk memastikan proses build berhasil. Perintah vp check –fix dapat memperbaiki sebagian temuan secara otomatis, tetapi ia tetap membaca perubahan yang dihasilkan lalu mengulang pemeriksaan. Agen AI bisa membantu mengubah kode; verifikasi tetap perlu mengikuti jalur yang jelas.
Angka CI bergantung pada konfigurasi
Dalam satu percobaan di monorepo, perubahan alur kerja menurunkan waktu CI dari 4 menit menjadi 50 detik. Pemeriksaan pre-commit juga turun dari 11 detik menjadi kurang dari 2 detik. Penulis menyebut hasil itu berasal dari proyeknya sendiri, bukan pengujian pembanding dengan toolchain lain dalam kondisi yang sama.
Perbedaan pentingnya terletak pada apa yang dijalankan dan berkas mana yang diperiksa. Karena itu, angka tersebut tidak bisa langsung dijadikan janji bahwa pemasangan Vite+ akan memberikan waktu CI yang sama pada repositori lain.
Untuk memeriksa berkas yang berubah, penulis menggunakan vp staged dan Git hooks yang dikelola dengan vp hooks. Ia memakai vp toolchain untuk melihat versi aktif sebuah proyek dan vp toolchain –global untuk memeriksa instalasi global. Informasi versi ini membantu saat dua proyek berperilaku berbeda, tanpa hanya mengandalkan ingatan bahwa alat sudah diperbarui.
Di monorepo, vp run dapat menjalankan skrip package.json atau tugas yang didefinisikan di vite.config.ts, sekaligus mengatur urutan berdasarkan dependensi workspace. Namun, caching tidak otomatis aktif untuk skrip package.json. Caching bisa diminta, misalnya dengan vp run –cache build, sedangkan tugas yang didefinisikan di vite.config.ts di-cache secara bawaan.
Perintah serupa bisa punya fungsi berbeda
Penulis mengingatkan bahwa vp build dan vp run build bukan perintah yang sama. vp build menjalankan build aplikasi Vite, sementara vp run build memanggil skrip build dari package.json atau tugas bernama build. Pada proyek Next.js, agen tidak boleh menganggap vp build menggantikan next build. Perbedaan serupa berlaku untuk vp dev dan vp run dev.
Pengelolaan versi juga perlu dijelaskan. vp env dapat mengatur Node.js dan pengelola paket secara global. Penulis memakai tiga versi Node.js di tiga proyek dan merasa perpindahan antarproyek lebih mudah; fitur itu dapat dimatikan lewat vp env off.
Perintah vp upgrade memperbarui CLI global, tetapi tidak otomatis memperbarui paket vite-plus lokal di setiap proyek. Penulis memasukkan batasan ini ke instruksi agen karena nama perintahnya dapat menimbulkan anggapan sebaliknya.
Ia juga mencoba vp migrate pada monorepo lama. Prosesnya berlangsung sekitar 4 menit dan, dalam kasusnya, mengonversi ESLint, Prettier, serta konfigurasi build tsup tanpa merusak proyek. Hasil tersebut bukan patokan untuk semua migrasi: plugin dan aturan khusus mungkin tetap memerlukan penanganan manual, sementara hasil lint, tes, hooks, dan build perlu dibandingkan dengan kondisi sebelumnya.
Dampaknya bagi tim yang memakai agen AI cukup langsung. Satu set perintah yang konsisten mengurangi tebakan agen dan perbedaan antara pemeriksaan lokal dengan CI, sementara instruksi yang disimpan di repositori tetap tersedia saat percakapan sebelumnya sudah berlalu.
Namun, hooks lokal dapat dilewati atau dimatikan, sehingga penulis menjalankan pemeriksaan yang sama di CI dan tetap meninjau perubahan sebelum penggabungan.
Penulis tidak menyarankan migrasi membabi buta pada aplikasi besar yang sudah memiliki build dan rangkaian tes stabil. Untuk proyek baru berbasis Vite, langkah berikutnya lebih sederhana: tetapkan toolchain, tulis perintah pemeriksaan di repositori dan CI, lalu pastikan agen mematuhinya.
Untuk proyek dengan kerangka kerja dan proses build sendiri, fungsi tiap perintah perlu dipastikan sebelum agen mulai bekerja.
📝 Tinggalkan Komentar
Komentar sebagai . Ditinjau admin sebelum tampil.