Coding behavior: plan, execute, test, validate

Planora sudah mengajarkan workflow ini kepada agent. Kamu tidak perlu menjalankan pekerjaan teknisnya, tetapi tetap perlu memastikan agent tidak melewati salah satu tahap.

1. Plan

Sebelum mengubah kode, agent menjelaskan:

• tujuan dan batas pekerjaan;
• bagian project yang terdampak;
• urutan implementasi;
• risiko yang perlu dijaga;
• test yang akan dijalankan;
• apakah E2E Required, Recommended, atau Not needed.

Kalau agent langsung mengedit tanpa plan, katakan:

Mana plan implementasinya? Jelaskan scope, file yang terdampak, risiko, test,dan kebutuhan E2E sebelum melanjutkan perubahan.

Plan untuk perubahan kecil boleh singkat. Yang penting agent memahami tujuan dan cara membuktikan hasilnya.

2. Execute

Agent menjalankan plan dan menjaga perubahan tetap sesuai scope. Jika menemukan masalah lain yang tidak diperlukan untuk task saat ini, agent sebaiknya melaporkannya tanpa diam-diam memperluas pekerjaan.

Jika agent berhenti di tengah tanpa alasan jelas, tanyakan:

Apakah seluruh plan sudah dieksekusi? Jelaskan bagian yang selesai, bagian yangbelum, dan blocker yang menghentikan pekerjaan.

3. Test

Test memeriksa kode dan hubungan antarbagian. Agent yang hanya berkata “sudah diubah” belum menyelesaikan workflow.

Kalau tidak ada laporan test, katakan:

Test apa yang sudah dijalankan untuk perubahan ini? Jalankan pemeriksaan yangsesuai, perbaiki kegagalan yang masih berada dalam scope, lalu berikan hasilaktualnya. Jangan mengubah test hanya supaya lulus.

Kamu tidak perlu membuka terminal dan menjalankan test sendiri. Agent yang melakukan, kamu membaca laporan dan memastikan tidak ada pemeriksaan penting yang disembunyikan sebagai “skipped”.

Jika backend Convex berubah, laporan harus menyebut hasil sinkronisasi development dan Convex functions ready!.

4. Validate

Test kode belum selalu membuktikan pengalaman pengguna. Validate membandingkan hasil dengan requirement dan mencoba alur yang benar-benar digunakan pengguna.

Untuk UI atau user journey, lakukan E2E dalam conversation khusus:

/e2e-tester specs/e2e/NAMA-FILE.md

Agent membuka browser, menjalankan scenario, dan menyimpan evidence. Setelah perjalanan pengguna selesai dan test dasarnya bersih, E2E tetap direkomendasikan untuk memastikan hasil benar dari sisi UI dan UX. Laporan harus menyertakan screenshot atau video untuk perjalanan penting jika browser menyediakannya. Kamu cukup membaca report. Jika hasilnya Failed, buka conversation /bug baru. Setelah bug diperbaiki, ulangi E2E pada conversation baru.

Bentuk laporan yang layak diterima

Laporan akhir yang baik menjawab:

1. Apa yang dibuat atau diubah?
2. Apakah seluruh plan selesai?
3. Test apa yang benar-benar dijalankan dan bagaimana hasilnya?
4. Apa yang tidak dijalankan dan mengapa?
5. Apakah acceptance criteria terpenuhi?
6. Apakah E2E masih Pending, Passed, Failed, atau Not needed?
7. Apa blocker dan risiko yang masih tersisa?

Jika laporan membingungkan, kirim:

Tulis ulang laporan untuk orang awam. Pisahkan hasil implementasi, hasil test,hasil E2E, pemeriksaan yang belum dilakukan, dan risiko yang masih tersisa.

Definisi selesai

Kode yang sudah ditulis belum tentu selesai. Sebuah pekerjaan layak disebut selesai ketika plan sudah dilaksanakan, test yang diperlukan lulus, hasilnya sesuai requirement, dan E2E Required sudah lulus.

Kalau E2E hanya Recommended dan belum dijalankan, agent boleh menyebut implementasinya selesai tetapi harus menyatakan bahwa validasi browser masih menjadi risiko yang tersisa.

Kalau komputer belum disiapkan, lanjut ke installation guide. Jika setup sudah selesai, mulai tutorial utama membuat aplikasi.