Kualitas kode Al- yang dihasilkan hampir sepenuhnya tergantung pada apa yang Anda minta dan bagaimana Anda memintanya. Panduan ini mencakup pola yang secara konsisten menghasilkan hasil yang lebih baik dengan Claude Code.
Dari tugas scoping ke sistem prompt, dari penyempurnaan iteratif ke instruksi spesifik role-. Teknik praktis Anda dapat menerapkan dalam sesi coding berikutnya.
Ketika Anda meminta pengembang manusia untuk 'membangun halaman login', mereka menanyakan pertanyaan yang mengklarifikasi: penyedia auth mana? Bidang apa? Haruskah itu menangani OAuth? Pesan galat? Memuat negara?
Agen kode AI akan mencoba menjawab semua pertanyaan itu sendiri. Kadang-kadang mereka menebak benar. Seringkali mereka menebak sesuatu yang masuk akal tapi tidak apa yang Anda inginkan. Jarak antara 'wajar' dan 'tepat' adalah apa yang cepat insinyur menutup.
Prompt yang baik tidak perlu lama. Mereka perlu spesifik tentang hal-hal yang penting dan diam tentang hal-hal yang tidak. Itulah keseimbangan yang panduan ini adalah tentang.
Pola yang meningkatkan hasil terlepas dari tugas.
Alih-alih 'membuat komponen React, lalu menambah keadaan, lalu menambahkan styling', menggambarkan hasil akhir: 'Bangun sebuah bilah samping yang dapat dibenamkan yang menunjukkan nama-nama projek, mendukung drag-to-reorder, dan menggunakan tema Tailwind yang sudah ada.' Biarkan agen memutuskan bagaimana untuk sampai ke sana.
Avoid
Buat komponen. Tambahkan useState. Tambah tombol togel. Gaya dengan Tailwind.
Better
Buat komponen batang sisi yang dapat dibagi yang memuat proyek berdasarkan nama. Ini harus mendukung drag-to-reorder dan mencocokkan tema gelap kami (bg- [# 111318], border- [# 262b38]). Keadaan yang konflik harus bertahan melewati reload halaman.
Agen bekerja terbaik ketika mereka tahu batas-batas. Tentukan berkas mana yang akan disentuh (atau dihindari), pola mana yang akan diikuti, dan seperti apa 'selesai' terlihat. Tugas tanpa batas menyebabkan perubahan penyemprotan yang sulit untuk diulas.
Avoid
Faktor ulang sistem otentikasi.
Better
Refaktor penangan log masuk dalam src / api / auth / login.ts untuk menggunakan bcrypt daripada sha256 untuk penekanan sandi. Jangan mengubah logika JWT atau penanganan sesi cookie. Mutakhirkan tes terkait dalam tes / auth /.
Claude Code dapat membaca berkas projek Anda, tetapi tidak dapat membaca pikiran Anda. Jika ada konvensi yang kau ikuti, perpustakaan yang kau sukai, atau pola yang sudah kau buat, katakanlah. Ini menghemat rework.
Avoid
Tambahkan validasi formulir.
Better
Tambahkan validasi formulir ke formulir pendaftaran menggunakan zod (kita sudah menggunakannya untuk bentuk pengaturan dalam src / form / settings.ts). Tampilkan pesan galat inline di bawah setiap ruas. Ikuti galat yang sama styling sebagai bentuk log masuk.
Compound prompt ('build the API, write test, update the docs, and spread') paksa agen untuk memegang terlalu banyak tujuan sekaligus. Break kompleks bekerja ke sekuensial, fokus tugas. Masing-masing dibangun pada hasil sebelumnya.
Avoid
Bangun halaman profil pengguna, tulis akhir API, tambahkan tes, perbarui README, dan perbaiki batang navigasi saat Anda berada di dalamnya.
Better
Bangun titik akhir GET / api / profile. Kembalikan id, nama, email, dan rencana bidang. Gunakan middleware auth untuk otentikasi.
Jika hasil pertama tidak benar, perbaiki prompt daripada memulai dari awal. Claude mempertahankan konteks percakapan penuh. Katakan apa yang salah, apa yang harus diubah, dan apa yang harus disimpan. Pendaratan lebih cepat daripada penemuan kembali.
Avoid
Itu salah. Memulai kembali dan membangun komponen berbeda.
Better
Tata letak baik tapi breakpoint mobile salah. Di bawah 768px, tumpukan kartu secara vertikal bukannya menggunakan kisi. Menjaga segala sesuatu yang lain seperti ini.
Sistem mendorong perilaku dasar untuk agen sebelum Anda mengatakan apa-apa. Mereka adalah alat yang paling tidak digunakan dalam kode AI.
Sebuah prompt sistem memberitahu agen siapa itu, apa yang harus difokuskan, dan apa yang harus dihindari. Ini berlaku untuk setiap pesan dalam sesi. Anggap saja sebagai deskripsi pekerjaan agen.
AgentsRoom kapal dengan 14 benteng-spesifik sistem prompt: satu untuk setiap tipe agen. Prompt Frontend agen mengatakan untuk fokus pada komponen, akses, dan desain responsif. Promosi agen QA mengatakan untuk berpikir tentang kasus tepi dan menulis tes komprehensif. Anda dapat menyesuaikannya atau menuliskannya sendiri.
Kau adalah pengembang senior. Fokus pada komponen Reaktif, gaya CSS / Tailwind, aksesibilitas (WCAG AA), dan desain responsif. Gunakan pustaka komponen projek yang ada sebelum membuat komponen baru. Lebih suka komposisi atas warisan. Tulis semantik HTML. Tidak pernah memodifikasi berkas backend.
Prompt yang paling efektif tidak diketik ke percakapan. Ini tinggal di repositori Anda.
CLAUDE.md adalah berkas markdown di akar projek Anda yang Claude Code baca secara otomatis. Ini berisi struktur proyek, konvensi, rincian stack, dan pedoman yang berlaku untuk setiap sesi agen dalam proyek tersebut.
Alih-alih mengulangi 'kami menggunakan Tailwind CSS 4, Prisma ORM, dan Next.js 16' dalam setiap percakapan, menulis sekali dalam CLAUDEM. Setiap agen mewarisi konteks ini. AgentsRoom termasuk built-in editor untuk CLAUDE.md sehingga Anda dapat memperbarui tanpa meninggalkan aplikasi.
CLAUDEMD ditulis dengan baik bernilai lebih dari lusinan prompt individu yang dibuat dengan hati-hati. Ini senyawa: setiap manfaat sesi dari itu.
Berhenti menulis ulang instruksi yang sama. Simpan apa yang bekerja dan menggunakannya kembali.
Jika Anda menemukan diri Anda mengetik jenis permintaan yang sama di seluruh proyek ('write unit tests untuk berkas ini', 'refactor this to use the repositori pattern', 'add error handling to all API route'), simpan sebagai prompt dapat digunakan ulang.
AgentsRoom termasuk fitur pustaka prompt dengan dua tingkat: per- proyek prompt untuk proyek -specific tugas, dan global prompt (cloud- synced) untuk pola yang Anda gunakan di mana saja.
Kandidat yang baik untuk pustaka mendorong: daftar pemeriksaan ulasan kode, templat ujian, skrip migrasi, instruksi skala komponen, langkah audit keamanan. Apa pun yang Anda akan dimasukkan ke dalam wiki tim sebagai prosedur standar.
Tes unit tulis untuk [berkas]. Gunakan vitest. Tutup path bahagia, huruf ujung (masukan kosong, null, tipe tidak valid), dan penanganan kesalahan. Mock ketergantungan eksternal. Tujuan untuk > 90% cakupan cabang.
Tinjau perubahan dalam diff git saat ini. Periksa: impor yang tidak digunakan, penanganan kesalahan yang hilang, tipe masalah keselamatan, kondisi potensial ras, dan penamaan inkonsistensi. Sarankan perbaikan untuk setiap isu ditemukan.
Buat titik akhir REST bagi [sumber daya]. Sertakan validasi masukan dengan zod, galat yang tepat (400, 401, 404, 500), tipe TypeScript untuk permintaan / respons, dan komentar JSDoc menggambarkan titik akhir. Ikuti pola yang ada dalam src / api /.
Teknik untuk tugas-tugas yang rumit yang melampaui dorongan tunggal.
Melanggar tugas besar ke langkah-langkah yang diperintahkan. Mulai agen pertama dengan langkah pertama, tunggu penyelesaian, kemudian mulai agen berikutnya dengan langkah kedua (referensi keluaran dari langkah satu). Setiap langkah lebih kecil dan lebih fokus. Contoh: Agen 1 merancang skema basis data, Agen 2 menulis API menggunakan skema itu, Agen 3 menulis tes terhadap API.
Setelah satu agen selesai, menunjuk agen yang berbeda di output. 'Tinjau perubahan agen frontend hanya dibuat dalam src / komponen /. Periksa masalah aksesibilitas dan keadaan galat hilang.' Seorang agen segar dengan peran yang berbeda menangkap hal-hal agen asli yang terjawab.
Mulailah dengan cepat untuk melihat bagaimana agen mendekati masalah. Kemudian tambahkan batasan dalam pesan-pesan berikut: 'Struktur yang baik, tetapi menggunakan komponen server bukan komponen klien.' 'Jauhkan hook, tetapi menghapus useEffect dan menggunakan sebuah React Query mutasi sebagai gantinya. "Setiap pemancingan mengarah pada solusi yang kau inginkan.
Point agen pada kode yang sudah ada: 'Bangun sebuah halaman pengaturan mengikuti pola yang sama seperti src / pages / profile.tsx. jadi? Struktur tata letak yang sama, penanganan bentuk yang sama, tampilan kesalahan yang sama. "Hal ini sering lebih efektif daripada menggambarkan pola dalam kata-kata.
Pola yang konsisten menghasilkan hasil yang lebih buruk.
Memberitahu agen persis yang fungsi untuk menulis, variabel yang ke nama, dan urutan untuk mengimplementasikan hal. Mikromanajemen ini menghilangkan kemampuan agen untuk menemukan pendekatan yang lebih baik. Jelaskan hasilnya, bukan prosedurnya.
Meminta seorang agen 'memperbaiki codebase' tanpa batasan. Tanpa batasan, agen mungkin memfaktorkan berkas yang tidak ingin Anda sentuh, mengubah APIs bahwa kode lain tergantung pada, atau menghabiskan token pada peningkatan prioritas rendah.
Tidak menyebutkan bahwa pola, utilitas, atau komponen sudah ada dalam proyek. Agen akan membuat yang baru. Sebuah sederhana 'kita sudah memiliki hook useAuth di src / kait /' menghemat rework signifikan.
Menjejalkan lima tugas menjadi satu pesan. Agen akan mencoba mereka semua, tapi kualitas menurun karena juggles gol bersaing. Bagi mereka menjadi sekuensial, sebagai gantinya fokus permintaan.
AgentsRoom memberikan Anda sistem prompt, perpustakaan prompt, dan editing CLAUDEMD yang dibangun. Lebih sedikit waktu menkerajinan prompt, lebih banyak waktu bangunan.
Aplikasi pendamping: pantau agen Anda saat bepergian
Gunakan Claude, Codex, Antigravity CLI, atau penyedia AI lainnya.
Kirim bug dan permintaan langsung ke backlog publik Anda.
Sekilas AgentsRoom dalam aksi.