Rangkuman dan Latihan
Poin-poin kunci
- Ruang kerja yang baik memberi AI konteks, siklus umpan balik yang cepat, dan pembatalan yang murah — penyiapannya adalah pengganda, seringkali lebih dari model itu sendiri.
- File konteks (AGENTS.md / CLAUDE.md) adalah hal berdampak paling tinggi yang bisa Anda tulis: aturan yang konkret, larangan yang lantang, dan penunjuk ke contoh.
- Jadikan kontrol versi sebagai refleks — kecil, baca diff, buat untuk pekerjaan berisiko — sehingga tidak ada yang dilakukan AI yang benar-benar tak bisa dibatalkan.
- Jaga lingkarannya tetap ketat dan biarkan agen menutupnya: edit, jalankan, baca kegagalan, perbaiki. Alirkan diagnostik (, lint, typecheck) kembali ke AI.
- Pagari setiap berbayar dengan batas keras dan pembatas laju, jaga rahasia tetap di luar repositori, dan gunakan harness untuk menjadikan pemeriksaan keamanan sesuatu yang tidak bisa dilewati AI.
Coba sendiri
Buka proyek apa pun yang sedang Anda kerjakan (atau buat rangka proyek kosong) dan tulis draf pertama AGENTS.md secara manual: apa proyek ini, tech stack-nya, perintah persis untuk menjalankan dev/test/lint, tiga konvensi nyata, dan setidaknya dua larangan yang lantang (misalnya, "jangan pernah membaca atau mencetak .env," "jangan tambahkan tanpa memberi tahu dulu"). Lalu minta alat AI Anda membuat perubahan sepele dan lihat apakah ia menghormati file itu. Setiap kali ia melakukan sesuatu yang tidak Anda inginkan, tambahkan atau pertajam satu baris. Anda sedang menyetel ruangnya, bukan hanya kodenya.
bab ini
Read my project and help me write a concise AGENTS.md context file for it.
First, inspect the repo and tell me:
- the tech stack and versions you detect
- the commands for install / dev / test / lint / build
- the layout and where the entry point is
Then draft an AGENTS.md with these sections: What this is, Tech stack,
Commands, Conventions, and Don'ts. Be specific and concrete (name the
exact libraries and rules, not "follow our conventions"). State the don'ts
as loudly as the do's, and point to one existing file as a style example.
Keep it under ~40 lines — I'll prune from there.