CLAUDE.md คือคู่มือประจำโปรเจกต์สำหรับ AI coding agent — ไฟล์เล็กที่ช่วยลดงานบอกซ้ำ

CLAUDE.md คือไฟล์ Markdown ที่ทำหน้าที่เหมือนคู่มือประจำโปรเจกต์สำหรับ Claude Code หรือ AI coding agent พูดง่าย ๆ คือแทนที่จะต้องบอก AI ทุกครั้งว่า repo นี้ใช้ Next.js, TypeScript, Prisma, command test คืออะไร, ห้ามแก้ไฟล์ไหน ให้เราเขียนกติกาพวกนี้ไว้ในไฟล์เดียว

ถ้าเปรียบเป็นที่ทำงาน CLAUDE.md คือป้ายบนโต๊ะทำงานที่บอกว่า "ก่อนเริ่มงาน อ่านตรงนี้ก่อน" มันไม่ทำให้ AI ฉลาดขึ้นแบบเวทมนตร์ แต่ช่วยให้ AI มีบริบทถูกตั้งแต่ต้น ลดการเดาสุ่ม และลดรอบถามตอบที่เสีย token

ไฟล์นี้สำคัญขึ้นเรื่อย ๆ เพราะ coding agent ไม่ได้แค่ autocomplete แล้ว แต่เริ่มอ่านทั้ง repo แก้หลายไฟล์ รันคำสั่ง และเสนอ pull request ถ้า context ผิดตั้งแต่แรก มันจะทำงานเร็วมากในทิศทางที่ผิด

เริ่มจากข้อมูลพื้นฐานของโปรเจกต์ก่อน เช่น stack ที่ใช้ โครงสร้าง folder หลัก คำสั่ง install/test/lint/build และวิธีรัน local development จากนั้นใส่ conventions เช่น naming, style, pattern ที่ทีมใช้ และสิ่งที่ไม่ควรทำ

ส่วนที่หลายคนลืมคือข้อห้าม เช่นห้ามแก้ generated files, ห้ามแตะ migration โดยไม่ถาม, ห้ามเปลี่ยน API contract, ห้ามเพิ่ม dependency โดยไม่อธิบายเหตุผล หรือห้ามรันคำสั่งที่แตะ production data

อีกส่วนที่ควรมีคือ definition of done หรือเช็กลิสต์ว่างานหนึ่งจะถือว่าเสร็จเมื่อไหร่ เช่น test ผ่าน, typecheck ผ่าน, ไม่มี lint error, เพิ่ม test สำหรับ behavior ใหม่ และสรุป diff ให้คนตรวจ

ฟันธง: ถ้าใช้ Claude Code กับโปรเจกต์จริง ควรมี CLAUDE.md ทุก repo โดยเฉพาะ repo ที่มีหลาย framework, command แปลก, หรือกติกาทีมเยอะ ไฟล์นี้เป็นการลงทุนเล็กที่ช่วยลดงานแก้ซ้ำได้มาก

เริ่มง่าย ๆ ไม่ต้องเขียนยาว เอาแค่ 20-40 บรรทัดที่มีคำสั่งจริงและข้อห้ามจริงก่อน แล้วค่อยปรับจากความผิดพลาดที่ AI ทำซ้ำ ถ้า AI ชอบแก้ผิดที่ ให้เพิ่มกติกา ถ้า AI ลืมรัน test ให้เพิ่มเช็กลิสต์ ถ้า AI เพิ่ม dependency มั่ว ให้ใส่ policy

จำไว้ว่า CLAUDE.md ไม่ได้แทนคนตรวจ มันช่วยให้ AI เริ่มงานถูกทางขึ้นเท่านั้น Human Gate ยังต้องอยู่ท้ายทางเสมอ โดยเฉพาะงานที่แตะข้อมูลลูกค้า เงิน ระบบ deploy หรือโค้ดที่กระทบหลายทีม