Workflow dengan AI subscription (opsional) ​

AI subscription bukan syarat untuk memakai CuanAff. Kebutuhan minimum tetap komputer atau laptop, koneksi internet, dan Laravel Herd. Selesaikan Instalasi dan setup terlebih dahulu; bila ingin bekerja dari editor kode, lihat juga Setup IDE (opsional).

Panduan ini berlaku secara umum untuk asisten coding seperti Claude Code, Codex, atau Antigravity. Tampilan, paket, dan kemampuan masing-masing layanan dapat berubah. Gunakan tool yang Anda pilih sebagai pendamping kerja, lalu tetap periksa sendiri setiap hasilnya.

Alur kerja yang disarankan ​

Alur minimum CuanAff tetap sederhana: ubah kode → jalankan test/check → review hasil. Git dan commit tidak diperlukan untuk menyelesaikan alur minimum ini. Jika project Anda memakai Git, gunakan langkah opsional setelah review untuk membantu kolaborasi dan rollback.

1. Buka project ​

Buka folder CuanAff di tool atau editor pilihan Anda. Pastikan terminal aktif berada di folder project, lalu periksa PHP CuanAff:

bash
php cuanaff list

2. Beri konteks ​

Jelaskan tujuan, bagian yang boleh diubah, batasan, dan hasil yang Anda harapkan. Sebutkan file atau command yang relevan bila sudah diketahui. Hindari meminta perubahan terlalu luas dalam satu langkah.

Contoh:

Pelajari struktur project CuanAff ini. Saya ingin memperbarui site affiliate tokoku tanpa mengubah site lain. Jelaskan file yang relevan dan rencana perubahan singkat sebelum mengedit.

3. Minta perubahan yang terukur ​

Berikan satu tujuan yang dapat diperiksa. Minta AI mempertahankan pola yang sudah ada dan tidak mengubah bagian di luar scope.

Contoh prompt untuk workflow CuanAff:

Ubah headline site tokoku agar lebih jelas untuk pembaca yang mencari rekomendasi produk. Pertahankan struktur data dan CTA affiliate yang ada. Tampilkan ringkasan file yang diubah.

Tambahkan satu produk ke data site tokoku dengan mengikuti schema dan pola item yang sudah ada. Jangan membuat field baru. Setelah selesai, jalankan pemeriksaan yang tersedia.

Bantu cari penyebab build site tokoku gagal. Baca pesan error, usulkan penyebab paling mungkin, lalu buat perbaikan terkecil. Jangan mengubah konfigurasi deployment.

4. Jalankan test ​

Minta AI menjalankan pemeriksaan yang relevan, tetapi baca hasil command-nya sendiri. Untuk pemeriksaan source CuanAff, gunakan:

bash
composer check

Jika task memiliki command build atau test khusus, jalankan command tersebut juga. Jangan menganggap perubahan benar hanya karena AI menyatakan sudah selesai.

5. Review hasil ​

Periksa setiap file yang berubah sebelum menerima hasil. Pastikan perubahan hanya menyentuh scope yang diminta, tidak menghapus konten yang masih diperlukan, dan tidak memasukkan data sensitif. Minta revisi bila hasil terlalu luas atau tidak mudah dipahami.

Bila project memakai Git, Anda juga dapat melihat ringkasan dan diff:

bash
git status --short
git diff

Git dan commit (opsional) ​

Git bukan syarat untuk memakai CuanAff, sama seperti dijelaskan pada Instalasi dan setup dan Setup IDE (opsional). Namun, Git direkomendasikan bila Anda berkolaborasi dengan orang lain atau ingin memiliki riwayat perubahan yang dapat dipakai untuk rollback.

Jika project Anda memakai Git, buat commit hanya setelah test/check lulus dan hasil perubahan sudah direview:

bash
git add <file-yang-sudah-direview>
git commit -m "Jelaskan perubahan secara singkat"

Pilih file secara eksplisit agar file lokal yang tidak terkait tidak ikut ter-commit. Jika project tidak memakai Git, cukup selesaikan alur minimum: ubah kode, jalankan test/check, lalu review hasil.

Checklist prompt yang efektif ​

Sebelum mengirim prompt, sertakan empat hal berikut:

  • Tujuan: hasil yang ingin dicapai.
  • Konteks: site, file, error, atau perilaku saat ini.
  • Batasan: bagian yang tidak boleh diubah dan hal yang out-of-scope.
  • Verifikasi: test, build, atau pemeriksaan hasil yang harus dijalankan.

Contoh prompt lengkap:

Pada site affiliate tokoku, rapikan deskripsi produk yang terlalu panjang agar mudah dibaca di mobile. Jangan mengubah URL affiliate, harga, schema data, atau konfigurasi deploy. Ikuti gaya konten produk lain. Jalankan test yang relevan, review diff, lalu laporkan file yang berubah dan hasil test. Jangan commit sebelum saya menyetujui diff.

Keamanan ​

Jangan bagikan secret

Jangan tempelkan credential, API token, password, private key, cookie sesi, isi file .env, atau secret lain ke prompt atau percakapan AI. Jangan meminta AI menampilkan nilai secret dari environment.

  • Bila perlu menjelaskan konfigurasi, gunakan nama variabel atau nilai samaran, misalnya CLOUDFLARE_API_TOKEN=<redacted>.
  • Jika memakai Git, baca diff sebelum commit untuk memastikan tidak ada credential, token, atau secret yang ikut tersimpan.
  • Jika secret terlanjur dibagikan, hentikan pemakaiannya dan rotasi melalui layanan terkait; menghapus prompt atau commit saja belum tentu cukup.

AI subscription hanya pilihan untuk mempercepat sebagian pekerjaan. Semua langkah utama CuanAff tetap dapat dilakukan tanpa AI dengan komputer/laptop, internet, dan Laravel Herd.