สรุปและฝึกฝน

ประเด็นสำคัญ

• พื้นที่ทำงานที่ดีให้บริบทแก่ AI วงจรป้อนกลับที่รวดเร็ว และการยกเลิกที่ราคาถูก — การตั้งค่าคือตัวคูณ บ่อยครั้งยิ่งกว่าตัวโมเดลเองเสียอีก
• ไฟล์บริบท (AGENTS.md / CLAUDE.md) คือสิ่งที่ให้ผลตอบแทนสูงสุดที่คุณเขียนได้ กฎที่เป็นรูปธรรม สิ่งที่ห้ามทำอย่างชัดเจน และตัวชี้ไปยังตัวอย่าง
• ทำให้การควบคุมเวอร์ชันเป็นปฏิกิริยาสะท้อน — คอมมิตเล็ก ๆ อ่าน diff แยก branch สำหรับงานเสี่ยง — เพื่อไม่ให้สิ่งใดที่ AI ทำนั้นย้อนกลับไม่ได้จริง ๆ
• รักษาวงจรให้กระชับและปล่อยให้เอเจนต์ปิดวงจรเอง แก้ไข รัน อ่านความล้มเหลว แก้ไข ป้อนการวินิจฉัย (LSP, lint, typecheck) กลับไปให้ AI
• สร้างกรงรอบทุก API ที่มีค่าใช้จ่ายด้วยเพดานและการจำกัดอัตรา เก็บความลับให้อยู่นอกรีโพ และใช้ harness เพื่อทำให้การตรวจสอบความปลอดภัยเป็นสิ่งที่ AI ข้ามไม่ได้

ลองทำดู

เปิดโปรเจกต์ที่คุณกำลังทำอยู่ (หรือสร้างโปรเจกต์ว่างขึ้นมาใหม่) และเขียนร่างแรกของ AGENTS.md ด้วยมือของคุณเอง ว่าโปรเจกต์นี้คืออะไร เทคสแตกที่ใช้ คำสั่งที่แน่นอนสำหรับรัน dev/test/lint ธรรมเนียมจริงสามข้อ และสิ่งที่ห้ามทำอย่างชัดเจนอย่างน้อยสองข้อ (เช่น "ห้ามอ่านหรือแสดงเนื้อหาของ .env" "ห้ามเพิ่มดีเพนเดนซีโดยไม่แจ้งก่อน") จากนั้นขอให้เครื่องมือ AI ของคุณทำการเปลี่ยนแปลงเล็กน้อย แล้วดูว่ามันเคารพไฟล์นั้นหรือไม่ ทุกครั้งที่มันทำสิ่งที่คุณไม่ต้องการ ให้เพิ่มหรือปรับบรรทัดหนึ่งให้คมชัดขึ้น คุณกำลังปรับจูนห้อง ไม่ใช่แค่ปรับโค้ด

พรอมต์ประจำบท

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.