ใช้ AGENTS.md / CLAUDE.md ให้ context กับ AI coding agent เพื่อให้โค้ดตรงงาน

AGENTS.md (และ CLAUDE.md) คือไฟล์ Markdown ที่วางไว้ที่ root ของโปรเจกต์ หน้าที่ของมันคือเป็นใบสรุปงานที่ยื่นให้ AI coding agent อ่านก่อนลงมือเขียนโค้ด คิดง่าย ๆ ว่าเหมือนเอกสารต้อนรับคนใหม่เข้าทีม ที่บอกตั้งแต่ต้นว่าโปรเจกต์นี้ใช้ stack อะไร ติดตั้งและรันยังไง สั่งเทสต์ด้วยคำสั่งไหน โครงสร้างไฟล์เป็นแบบไหน เขียนโค้ดสไตล์ไหน มีกฎความปลอดภัยอะไร และห้ามแตะไฟล์ส่วนไหนบ้าง

ปัญหาที่ไฟล์นี้เข้ามาแก้คือ เวลา AI ไม่รู้บริบทของโปรเจกต์ มันจะเดา แล้วก็มักเดาผิดในแบบเดิม ๆ คือใช้คำสั่งผิด ไปแก้ผิดไฟล์ หรือข้ามขั้นตอนเทสต์ พอมีไฟล์ context วางไว้ตั้งแต่แรก AI ก็มีกติกาให้ทำตามแทนที่จะเดา ปัจจุบันโปรเจกต์ Next.js ที่สร้างใหม่ด้วย `npx create-next-app` ก็สร้างไฟล์ AGENTS.md ให้อัตโนมัติแล้ว สะท้อนว่ามันกลายเป็นของมาตรฐานในงาน AI coding

โครงที่ใช้ได้จริงมี 6 ส่วน ไล่ใส่ทีละหัวข้อ ส่วนแรกคือ **commands** รวบคำสั่งที่ต้องใช้บ่อยไว้ที่เดียว ทั้ง install, run และ build เพื่อให้ AI หยิบคำสั่งที่ถูกไปใช้ ไม่ต้องเดาเอง ส่วนที่สองคือ **testing** บอกว่าโปรเจกต์นี้สั่งเทสต์ยังไง เพื่อให้ AI รันเทสต์หลังแก้ ไม่ใช่ส่งงานทั้งที่ยังไม่ผ่าน

ส่วนที่สามคือ **project structure** อธิบายว่าโครงสร้างโฟลเดอร์และไฟล์วางตัวยังไง อะไรอยู่ตรงไหน เพื่อกันไม่ให้ AI สร้างไฟล์ผิดที่หรือแก้ผิดจุด ส่วนที่สี่คือ **code style** บอกสไตล์การเขียนโค้ดที่โปรเจกต์ยึด เพื่อให้โค้ดที่ AI เขียนออกมากลมกลืนกับของเดิม ส่วนที่ห้าคือ **git workflow** ระบุวิธีทำงานกับ git ของทีม และส่วนที่หกคือ **boundaries** กำหนดขอบเขตการแก้ไฟล์ให้ชัดว่าไฟล์ไหนแก้ได้ ไฟล์ไหนห้ามแตะ ส่วนนี้สำคัญที่สุดในแง่ความปลอดภัย เพราะเป็นเส้นที่กั้นไม่ให้ AI ไปยุ่งกับของอ่อนไหว

ทักษะ "ให้ context" คือของจริงในยุค AI coding และเป็นสิ่งที่ลงมือทำได้ทันที การนั่งเขียนไฟล์ AGENTS.md หรือ CLAUDE.md หนึ่งครั้งให้ครบ 6 ส่วน คือการลงทุนที่คุ้ม เพราะมันเปลี่ยนงานของ AI จาก "เดาแล้วผิดบ่อย ๆ" มาเป็น "ทำตามกติกาที่เราวางไว้" ตั้งแต่ครั้งแรก แทนที่จะคอยมาแก้คำสั่งผิดหรือไฟล์ผิดทีหลังทุกรอบ และพอวางเป็นเทมเพลตของทีมไว้ โปรเจกต์ใหม่ ๆ ก็เริ่มจากฐานเดียวกันได้เลย

แต่ต้องย้ำให้ชัดว่าไฟล์ context ไม่ได้ทำให้ AI ถูก 100% มันช่วยให้ AI ทำงานตรงงานขึ้น ไม่ได้แปลว่าเชื่อได้โดยไม่ต้องตรวจ Human Gate คือจุดที่คนต้องตรวจก่อนผ่าน ยังต้องอยู่เสมอ ให้คนรีวิวและเทสต์งานที่ AI เขียนทุกครั้ง โดยเฉพาะส่วนที่อ่อนไหวอย่างระบบ login, payment, database และอะไรก็ตามที่จะขึ้น production พลาดตรงนี้แล้วเจ็บจริง ไฟล์ context จึงเป็นตัวช่วยให้ AI เริ่มถูกทาง ไม่ใช่ตัวแทนสายตาคน