surfup

12 peraturan projek untuk Cursor dan Claude Code

12 peraturan praktikal tentang konteks repositori, SEO, keselamatan dan perubahan yang boleh disahkan.

Gunakan langkah ini sebagai senarai semak kerja dan sesuaikannya dengan bukti, skop serta kekangan projek.

Konteks dan skop

  • Baca arahan projek yang terpakai untuk alat ini, jika ada (contohnya .cursor/rules atau CLAUDE.md); semak juga README dan manifest jika tersedia.
  • Sebelum mengedit, ringkaskan seni bina semasa dan kenal pasti hanya fail yang diperlukan oleh perubahan ini.
  • Tetapkan matlamat sebagai satu hasil yang boleh disahkan; jangan luaskan tugasan tanpa sebab.
  • Sebelum mengubah API, kenal pasti pengguna API itu, bentuk permintaan/tindak balas dan keperluan keserasian.

Kualiti dan keselamatan

  • Bagi setiap input pengguna, nyatakan format, panjang dan pengesahan nilai yang tidak selamat.
  • Jangan sekali-kali meletakkan rahsia dalam kod, log, fixture, contoh atau aset frontend yang dihantar kepada pengguna.
  • Untuk halaman carian, semak title, description, canonical, robots, tajuk, pautan dan HTML sumber.
  • Kekalkan teks tersendiri bagi setiap bahasa, contoh maklumat hubungan yang sesuai dengan wilayah dan URL yang sepadan.
  • Pastikan elemen interaktif boleh digunakan dengan papan kekunci, mempunyai nama yang boleh dibaca teknologi bantuan dan menunjukkan fokus dengan jelas.

Pengesahan dan pelaporan

  • Jalankan hanya semakan yang mengesahkan tingkah laku yang diubah; jangan dakwa menjalankan arahan yang sebenarnya tidak dijalankan.
  • Bandingkan hasil dengan kriteria penerimaan; periksa laluan ralat dan paparan mudah alih.
  • Laporkan perubahan, arahan yang dijalankan dan hasil sebenar, had yang diketahui serta cara untuk mengembalikan perubahan.