Referensi perintah agent Planora

Halaman ini adalah referensi cepat untuk memilih perintah. Untuk perjalanan lengkap dari ide sampai aplikasi, ikuti Tutorial utama: membuat aplikasi dengan Planora.

Setelah setup selesai dan halaman starter bisa dibuka, kamu siap membuat aplikasimu. Planora bekerja dalam dua tahap besar: menentukan arah, lalu membangun satu bagian pada satu waktu.

Gunakan satu perintah utama dalam satu task. Tanda / di depan nama perintah memberi tahu agent workflow apa yang harus dipakai.

Bagian 1: buat rencana aplikasi

Buka task atau chat baru dari folder Planora, lalu kirim:

/planora-product-kit
Saya ingin membuat aplikasi yang membantu [siapa penggunanya] untuk [masalahyang ingin diselesaikan]. Gambaran singkat aplikasi saya: [ceritakan denganbahasamu sendiri].

Tidak perlu menulis prompt sempurna. Akan lebih membantu jika kamu juga menyebutkan:

• siapa yang akan memakai aplikasi;
• masalah utama mereka;
• tiga kemampuan yang menurutmu paling penting;
• contoh aplikasi atau gaya tampilan yang kamu sukai;
• hal yang tidak boleh dilakukan aplikasi;
• keputusan yang masih belum kamu ketahui.

Planora akan bertanya beberapa hal penting. Jawab berdasarkan pengetahuanmu. Kalau tidak tahu, katakan belum tahu dan minta pilihan dijelaskan. Jangan mengiyakan asumsi yang sebenarnya tidak kamu pahami.

Apa yang terjadi setelah itu?

Agent membuat folder product/ berisi arah produk, kebutuhan, panduan tampilan, urutan pengerjaan, dan daftar pekerjaan. Tahap ini belum mengubah aplikasi di browser. Itu normal: Planora sedang membuat peta sebelum mulai membangun.

Sebelum lanjut, minta ringkasan:

Jelaskan rencana produk ini kepada saya dengan bahasa sederhana. Sebutkan fiturversi pertama, asumsi yang belum pasti, keputusan yang masih terbuka, dan apayang sengaja belum akan dibuat.

Lanjut hanya jika arah tersebut memang sesuai dengan aplikasi yang ingin kamu buat.

Bagian 2: mulai membangun

Jalankan:

/planora-next

Perintah ini memilih satu pekerjaan yang sudah siap, membangunnya, dan menjalankan pemeriksaan yang sesuai. Agent akan menangani pekerjaan tersebut dan memberikan report. Satu task tidak harus langsung membuat seluruh aplikasi. Pengembangan bertahap lebih mudah diperiksa dan diperbaiki.

Setelah agent selesai:

1. baca ringkasan perubahan;
2. lihat test apa saja yang benar-benar dijalankan dan hasilnya;
3. pastikan tidak ada test wajib yang masih gagal;
4. baca report validasi atau evidence yang diberikan agent;
5. catat file E2E yang perlu dijalankan setelah alur pengguna lengkap;
6. lihat hasil di aplikasi hanya jika kamu ingin memberi feedback tentang kebutuhan atau tampilannya;
7. jalankan /planora-next lagi pada task baru ketika siap melanjutkan.

Gunakan /planora-status kapan saja untuk melihat posisi project.

Melihat progres

Kirim:

/planora-status
Jelaskan progresnya dengan bahasa sederhana. Apa yang sudah selesai, apa yangmasih terhalang, dan satu langkah paling masuk akal berikutnya?

Perintah ini hanya membaca kondisi project. Ia tidak mengubah kode.

Menambah kemampuan baru

Jika kemampuan tersebut belum ada di rencana produk, jangan langsung meminta agent menulis kode. Perbarui arah produk terlebih dahulu:

/planora-change
Saya ingin menambahkan [kemampuan baru]. Penggunanya membutuhkan ini karena[alasan]. Hasil yang saya harapkan adalah [hasil yang bisa dilihat pengguna].

Agent akan memperbarui rencana dan daftar pekerjaan. Setelah itu gunakan /planora-next untuk mulai mengimplementasikannya.

Gunakan /feature secara langsung hanya jika scope dan hasil yang diharapkan sudah jelas serta pekerjaan tidak sedang diatur melalui daftar Planora.

Mengedit tanpa menambah kemampuan

Gunakan /chore untuk perubahan seperti tulisan, warna kecil, konfigurasi, merapikan kode, atau mengganti susunan tanpa menambah kemampuan produk.

/chore
Ubah tulisan tombol "Mulai" menjadi "Buat akun". Jangan mengubah fungsi tombolatau bagian lain.

Kamu tidak harus selalu memilih kategori dengan benar. Jika permintaanmu ternyata mengubah perilaku produk atau memperbaiki bug, agent akan menjelaskan dan menggunakan workflow yang lebih sesuai.

Memperbaiki error

Gunakan /bug saat sesuatu yang seharusnya bekerja ternyata gagal.

/bug
Setelah saya menekan tombol Simpan, muncul pesan [salin pesan error]. Sayamelakukannya dari halaman [nama halaman]. Seharusnya [hasil yang diharapkan],tetapi yang terjadi [hasil sebenarnya]. Tolong cari penyebab dan perbaiki.

Screenshot, pesan error lengkap, alamat halaman, dan urutan kejadian sangat membantu. Jangan hanya mengatakan “tidak bekerja” jika kamu bisa menjelaskan apa yang kamu lakukan sebelum error muncul.

Mengubah arah aplikasi yang sudah direncanakan

Gunakan /planora-change, bukan mengedit dokumen product/ secara manual. Ini menjaga kebutuhan, tampilan, dan daftar pekerjaan tetap saling cocok.

/planora-change
Saya ingin mengubah [perilaku lama] menjadi [perilaku baru] karena [alasan].Tolong tunjukkan bagian rencana lain yang ikut terdampak sebelum implementasi.

Memilih tampilan yang belum pasti

Kalau Planora menandai satu keputusan visual belum selesai, kamu dapat meminta beberapa pilihan:

/prototype
Tunjukkan beberapa arah untuk [bagian yang ingin dibandingkan] dengan tetapmengikuti identitas UI aplikasi ini. Jangan implementasikan ke aplikasi sebelumsaya memilih.

Setelah memilih, kembali ke /planora-next atau /feature untuk implementasi.

Sebelum mengatakan “selesai”

Tanyakan ini kepada agent:

Apa yang sudah benar-benar divalidasi? Apa yang baru diperiksa dari kode? Apayang masih perlu saya coba melalui browser? Jelaskan risiko yang masih tersisa.

Jika agent membuat file di specs/e2e/, lanjutkan ke tutorial E2E. Jika hasil sudah stabil, simpan progres melalui GitHub.