Pengarahan tercepat di 1DesignTool tidak ditulis — ia ditunjuk. Comment mode mengubah live preview menjadi permukaan mark-up: ⌥-click sebuah elemen, ketik catatan, dan pin mendarat di node persis yang akan diedit agen.
Comment mode
Tombol Comment mode di rel pratinjau mengaktifkan permukaannya. Dari sana:
- ⌥-hover — menyorot elemen di bawah kursor, jadi Anda bisa melihat persis node mana yang akan dituju pin sebelum Anda yakin
- ⌥-click — menjatuhkan pin bernomor pada elemen itu
- Draw — seret melintasi sebuah area untuk menandai wilayah, bukan satu node
- Click a pin — buka untuk menulis atau mengedit komentarnya
Pin mendarat di panel Comments yang menyelinap di samping pratinjau — masing-masing menampilkan nomor, selector, dan catatannya. Penghitung di tombol melacak berapa pin yang menunggu.
Kirim catatan ke agen
Tulis komentar di tiap pin — "rapatkan headline ini, maksimal dua baris", "ini harus terasa sekunder" — lalu tekan Send N new comments to agent. Catatan itu ikut ke turn berikutnya, terlipat pada elemen yang persis dimaksud, jadi agen mengedit node yang Anda maksud, bukan yang ia tebak.
Ada pin yang sudah terselesaikan? Kirim hanya yang baru — panel menghitung catatan yang belum terkirim. Setelah perbaikan mendarat, selesaikan atau bersihkan pin supaya turn berikutnya tidak membaca ulang tanda basi.
Apa yang membuat komentar bagus
Aturan yang sama seperti brief bagus, lebih kecil: sebut perubahannya, bukan mekanismenya. "Bikin ini terasa sekunder" mengalahkan "kecilkan ke 14px #999" — design kit memiliki token-nya, jadi arah yang diterapkan konsisten mengalahkan nilai yang melawan sisa sistem. Satu masalah per pin; kalau dua hal salah, jatuhkan dua pin.
Tip: Kalau perbaikannya soal spasi atau perataan, gambar wilayahnya, bukan memilih node — area bertanda memberi tahu agen elemen mana yang Anda maksud dari posisinya, yang bertahan lebih baik terhadap markup ambigu daripada selector.
Di mana pin tinggal
Pin melekat pada keadaan proyek, bukan pratinjau sesaat — mereka bertahan melalui run yang memperbaikinya, dan muncul di brief berikutnya sampai diselesaikan. Menghapus proyek membersihkan pinnya sekalian; memulihkan keadaan sebelumnya mengembalikan pin keadaan itu.