AGENTS.md

AGENTS.md คือไฟล์ Markdown ธรรมดาที่วางไว้ที่ root ของโปรเจกต์ เพื่อเป็น "README สำหรับ agent" : จุดที่ agent เขียนโค้ดทุกตัวรู้ว่าต้องมาอ่านกติกาก่อนเริ่มงาน เป็น open format ที่โปรเจกต์ open source ใช้แล้วกว่า 60,000 โปรเจกต์ และมี coding agent รองรับกว่า 20 ตัว เช่น OpenAI Codex, Jules กับ Gemini CLI ของ Google, GitHub Copilot, Cursor, Zed, Warp, Devin และอื่นๆ แนวคิดคือ README.md เขียนให้คนอ่าน (quick start, คำอธิบายโปรเจกต์) ส่วน AGENTS.md เก็บรายละเอียดที่ agent ต้องรู้แต่คนอ่านผ่านๆ ไม่จำเป็นต้องรู้ เช่น คำสั่ง build และ test, code style, ข้อควรระวังด้าน security

วิธีทำงานเรียบง่ายมาก : ไม่มี field บังคับ ไม่มี format พิเศษ เขียนหัวข้ออะไรก็ได้ที่อยากให้ agent รู้ แล้วเนื้อหาจะถูกโหลดเข้า context ของ agent ตอนเริ่มทำงานโดยอัตโนมัติ ในโปรเจกต์ใหญ่แบบ monorepo วาง AGENTS.md ซ้อนไว้ในแต่ละ package ได้ โดย agent จะอ่านไฟล์ที่อยู่ใกล้โค้ดที่กำลังแก้ที่สุด (ไฟล์ใกล้สุดชนะ) และไม่ว่าไฟล์จะเขียนว่าอะไร คำสั่งที่ผู้ใช้พิมพ์ใน chat ก็ override ได้เสมอ format นี้เกิดจากความร่วมมือของหลายเจ้าในวงการ เช่น OpenAI Codex, Amp, Jules, Cursor, Factory และปัจจุบันดูแลโดย Agentic AI Foundation ภายใต้ Linux Foundation

จุดที่คนใช้ Claude Code ต้องรู้ : Claude Code อ่าน CLAUDE.md ไม่ได้อ่าน AGENTS.md โดยตรง ทางแก้ตามเอกสารทางการคือสร้าง CLAUDE.md ที่ import ด้วยบรรทัด @AGENTS.md (แล้วเติมคำสั่งเฉพาะของ Claude ต่อท้ายได้) หรือทำ symlink จาก AGENTS.md มาเป็น CLAUDE.md ก็ได้ถ้าไม่ต้องเติมอะไร สำหรับคนทำงานทั่วไปที่ใช้ AI แนวคิดนี้สำคัญกว่าตัวไฟล์ : แทนที่จะพิมพ์กติกาเดิมซ้ำทุกครั้งที่เปิด session ใหม่ ให้เขียนกติกาลงไฟล์ที่ AI หาเจอเสมอ ทีมทั้งทีมก็จะได้ AI ที่ทำงานตามมาตรฐานเดียวกันโดยไม่ต้องสอนกันปากเปล่า

ตัวอย่างจากบทสนทนาจริง

ถาม: พี่ครับ ผมพิมพ์สั่งใน chat ทุกเช้าเลยว่าห้ามแตะไฟล์ config กับให้รัน test ก่อน commit แต่พอเปิด session ใหม่ AI ก็ลืมหมด ต้องมานั่งพิมพ์ใหม่ทุกรอบจริงๆ เหรอ

ตอบ: ไม่ต้องครับ ย้ายกติกาพวกนั้นไปไว้ใน AGENTS.md ที่ root ของโปรเจกต์ agent ส่วนใหญ่อย่าง Codex, Cursor, Copilot จะอ่านไฟล์นี้เองทุกครั้งที่เริ่มงาน ทีมเราใช้เครื่องมือคนละตัวก็อ่านไฟล์เดียวกันหมด ส่วนใครใช้ Claude Code ให้สร้าง CLAUDE.md ที่มีบรรทัด @AGENTS.md ไว้ import เข้ามา เท่านี้กติกาชุดเดียวใช้ได้ทั้งทีม

ระวังสับสนกับ

• CLAUDE.md : ทำหน้าที่คล้ายกันแต่เป็นไฟล์เฉพาะของ Claude Code ส่วน AGENTS.md เป็นมาตรฐานกลางที่ agent หลายค่ายอ่านร่วมกัน · Claude Code ไม่อ่าน AGENTS.md ตรงๆ ต้อง import ผ่าน CLAUDE.md หรือ symlink
• README.md : เขียนให้คนอ่าน เน้นแนะนำโปรเจกต์และวิธีเริ่มใช้ ส่วน AGENTS.md เขียนให้ AI อ่าน เน้นรายละเอียดเชิงปฏิบัติอย่างคำสั่ง build, test และ convention ของทีม