Satu cara prompt untuk semua project

Dua lapis

• File project (sekali per project): AGENTS.md di folder project berisi hal yang tidak berubah: project ini apa, cara menjalankan, test dan deploy, dan apa yang tidak boleh disentuh AI. Claude Code, Codex dan Gemini membacanya sendiri.
• Prompt tugas (setiap kali): hanya yang kamu mau sekarang, selalu dengan 4 bagian yang sama: tujuan, di mana, aturan, selesai kalau.

Langkah 1 — Minta AI menulis AGENTS.md

Buka project-nya (Telegram: /project nama; terminal: cd ~/workspace/nama) lalu kirim ini. Sama untuk semua project:

Baca project ini (README, package.json atau config lain, struktur folder, scripts).
Tulis AGENTS.md di root project, maksimal 60 baris, berisi:
- Project ini apa, dalam 2 kalimat
- Stack dan folder penting
- Perintah install, run, test, build dan deploy (hanya yang benar-benar jalan)
- Aturan kode yang terlihat di kode (gaya, penamaan, bahasa teks UI)
- Apa yang tidak boleh diubah tanpa tanya (config produksi, secret, data database)
Lalu buat CLAUDE.md dan GEMINI.md yang masing-masing hanya berisi baris: @AGENTS.md
Jangan ubah file lain.

Baca AGENTS.md sekali dan betulkan yang salah — mulai sekarang AI mengikutinya. Kalau project berubah (perintah deploy baru, aturan baru), kirim: “Update AGENTS.md: …”.

Contoh AGENTS.md yang bagus

# Website toko
Toko online tas handmade. Astro 5 + Tailwind, konten di src/content/.

## Perintah
- npm install / npm run dev (port 4321) / npm run build
- Deploy: npx wrangler deploy (akun Cloudflare di wrangler.jsonc)

## Aturan
- Teks UI bahasa Indonesia, kode dan komentar bahasa Inggris
- Commit kecil, gaya pesan: fix(cart): ...
- Jalankan npm run build sebelum bilang selesai

## Jangan disentuh tanpa tanya
- routes di wrangler.jsonc, .env, database produk

Langkah 2 — Template tugas (sama untuk semua project)

Isi 4 bagian ini. Boleh dilewati kalau memang sudah jelas.

Tujuan: <apa yang harus ada atau jalan setelahnya>
Di mana: <halaman, file, fungsi, atau "cari sendiri">
Aturan: <apa yang jangan diubah, library yang boleh/tidak>
Selesai kalau: <cara cek: build lolos, test, halaman menampilkan X>

Contoh:

Tujuan: dropdown "Urutkan harga" di halaman produk
Di mana: src/pages/products.astro
Aturan: tanpa library baru, desain tetap seperti sekarang
Selesai kalau: npm run build lolos dan urutan murah→mahal dan mahal→murah jalan

Prompt siap pakai

Project baru dari nol

Tujuan: <aplikasinya untuk apa, untuk siapa>
Stack: <mis. Astro + Tailwind di Cloudflare Workers> — atau pilih yang sederhana dan jelaskan alasannya
Aturan: seminimal mungkin, tanpa layanan berbayar, belum perlu login
Selesai kalau: jalan dengan npm run dev, dan ada AGENTS.md (+ CLAUDE.md dan GEMINI.md berisi @AGENTS.md) yang menjelaskan cara run dan deploy
Mulai dengan rencana singkat dan tunggu OK saya sebelum menulis kode.

Perbaiki bug

Bug: <apa yang terjadi> — seharusnya: <apa yang diharapkan>
Langkah: <1. buka … 2. klik … 3. muncul error>
Error (disalin apa adanya):
<tempel error atau log>
Cari penyebabnya dulu dan jelaskan dalam 2-3 kalimat, lalu perbaiki dengan perubahan sekecil mungkin. Selesai kalau: <langkah tadi jalan lagi / test lolos>

Tambah fitur

Tujuan: <fiturnya, dari sudut pandang pengguna>
Di mana: <halaman atau file, atau "cari sendiri">
Aturan: ikuti gaya kode yang sudah ada, tanpa dependency baru kecuali tanya dulu
Selesai kalau: build lolos dan <cara saya melihat fiturnya jalan>

Ubah tampilan halaman

Di Dev Box penuh, AI bisa membuka halaman di browser-nya sendiri dan mengambil screenshot (Telegram: /shot <url>).

Tujuan: <apa yang harus terlihat beda>
Di mana: <URL halaman atau file>
Aturan: mobile dulu, pakai warna dan font yang sudah ada
Selesai kalau: kamu sudah cek di browser dengan lebar HP dan desktop, lalu kirim screenshot ke saya

Deploy ke Cloudflare

Hubungkan Cloudflare di dashboard dulu; setelah itu wrangler jalan tanpa wrangler login. Kalau akunnya lebih dari satu, account_id di config wrangler project menentukan akun mana.

Deploy project ini ke Cloudflare dengan wrangler.
Cek dulu: account_id mana yang ada di config wrangler, dan build lolos.
Tunjukkan perintahnya sebelum dijalankan. Jangan buat atau hapus apa pun yang lain di akun itu.

Memahami kode yang bukan buatanmu

Jelaskan <file atau fitur> ke saya: fungsinya apa, alur datanya bagaimana, dan di mana saya harus mengubah <X>.
Jangan ubah file apa pun.

Perubahan besar, bertahap

Tujuan: <perubahan besarnya>
Buat rencana langkah kecil dulu (maksimal 6) dan tunggu OK saya.
Setelah OK, kerjakan satu langkah per kali; setiap selesai satu langkah jalankan build dan ceritakan apa yang berubah.

Di Telegram

• /project nama dulu — AI bekerja di project aktif dan membaca AGENTS.md-nya.
• /new setiap mulai tugas lain: AI melupakan percakapan sebelumnya (hanya di project ini) dan mulai dari awal. File, perubahan dan project aktif tetap.
• Satu tugas per pesan. Lima permintaan dalam satu pesan menghasilkan lima pekerjaan setengah jadi.
• Cek dengan /diff, lalu /push dan tekan Confirm. Tidak ada yang di-push tanpa kamu.
• Kerja juga di laptop? Push dari sana, lalu kirim /pull supaya masuk ke box. Kalau ada catatan package-lock.json berubah, minta AI menjalankan npm ci sebelum build.
• Deploy dan restart (wrangler deploy, npm run deploy, docker restart, …) tidak pernah jalan sendiri: kamu dapat command lengkapnya dengan tombol Jalankan / Batal.
• Tugas besar di Dev Box penuh: /team <tugas> — satu AI mengerjakan, AI lain mereview, lalu diperbaiki.
• /stop kalau arahnya salah: hanya membatalkan tugas yang sedang jalan. Kamu tetap di project yang sama, editan yang sudah dibuat tetap ada (cek /diff), dan AI masih ingat percakapannya, jadi tinggal bilang apa yang harus dilakukan berbeda. Mau mulai bersih? Kirim /new.

Aturan pribadimu untuk semua project

Hal yang berlaku untukmu di mana saja (bahasa, gaya commit, “jangan pernah wrangler login”) cukup ditulis di satu file pribadi, bukan di setiap project. Minta AI:

Buat ~/.claude/CLAUDE.md, ~/.codex/AGENTS.md dan ~/.gemini/GEMINI.md dengan aturan ini untuk semua project saya:
- Jawab dalam bahasa Indonesia, singkat dan langsung
- Jangan pernah git push; saya push sendiri
- Jangan pernah wrangler login; token Cloudflare sudah diatur
- Tanya dulu sebelum menghapus file atau mengubah config produksi

Kesalahan yang sering terjadi

• Terlalu umum: “perbaiki website saya” → sebutkan apa yang salah dan bagaimana kamu melihatnya.
• Tanpa cara cek: tanpa “selesai kalau”, AI menentukan sendiri kapan selesai.
• Project salah: cek /project sebelum memberi tugas di Telegram.
• Secret di prompt: jangan tempel password atau API key ke chat; pakai koneksi di dashboard atau file .env.
• Koreksi tanpa akhir: setelah 2-3 kali gagal, kirim /new dan tulis ulang tugasnya dengan lebih jelas.