AGENTS.md ทำให้ AI เข้าใจโปรเจกต์อย่างไร

AGENTS.md คือไฟล์บริบทระดับโปรเจกต์ที่บอก AI ว่า repository นี้ทำงานอย่างไร เช่น โครงสร้างโฟลเดอร์ คำสั่งที่ใช้ตรวจ code style กฎการแก้ไฟล์ และข้อห้ามที่ต้องรู้ก่อนลงมือ ไฟล์เดียวไม่ได้ทำให้ AI ถูกต้องทุกครั้ง แต่ช่วยลดการเริ่มต้นจากศูนย์ในทุก session

ทำไม Context ระดับโปรเจกต์จึงสำคัญ

AI เห็นไฟล์ที่เปิดให้ดู แต่ไม่ได้รู้เจตนาของระบบทั้งหมดโดยอัตโนมัติ ชื่อโฟลเดอร์บางอย่างอาจเป็น legacy route มีระบบ CMS ซ่อนอยู่ หรือมีคำสั่ง deploy ที่ห้ามรันใน local ถ้าไม่บอกกฎเหล่านี้ AI อาจเลือกวิธีที่ดูสมเหตุสมผลแต่ผิดกับ convention ของโปรเจกต์

Source แสดงให้เห็นว่าเมื่อสร้างไฟล์กฎไว้ในโฟลเดอร์แล้ว AI สามารถใช้ข้อมูลนั้นเป็นจุดอ้างอิงก่อนทำงาน ทำให้ผลลัพธ์ต่างจากการปล่อยให้ทำแบบ general purpose

เนื้อหาที่ควรมีใน AGENTS.md

# Project overview
- งานของ repository นี้คืออะไร
- จุดเริ่มต้นของแอปอยู่ที่ไหน

# Commands
- install
- typecheck
- lint
- test
- build

# Conventions
- naming
- folder boundaries
- import aliases
- component/data patterns

# Safety
- ห้ามอ่านหรือ commit secrets
- ห้ามแก้ production data โดยไม่ได้รับอนุมัติ
- ห้าม deploy ก่อน verification

# Definition of done
- tests ผ่าน
- diff check ผ่าน
- route/SEO check ผ่านเมื่อเกี่ยวข้อง

วางไฟล์อย่างไร

โดยทั่วไปควรวางไฟล์หลักไว้ที่ root ของ repository เพื่อให้กฎครอบคลุมงานทั้งโปรเจกต์ และอาจมีไฟล์ระดับโฟลเดอร์เมื่อส่วนย่อยมี convention เฉพาะ เช่น package หรือ app แยกกัน แต่ต้องระวังไม่ให้กฎระดับล่างขัดกับกฎหลัก

AGENTS.md ไม่ใช่ที่เก็บ secret

ใส่ชื่อ environment variable ได้ แต่ไม่ใส่ค่าจริงของ token, API key, password หรือ credential ใด ๆ ไว้ในไฟล์ คำสั่งที่เกี่ยวข้องกับการเงิน Auth หรือ deploy ควรระบุเป็น gate และให้คนอนุมัติ ไม่ใช่เปิดทางให้ทำอัตโนมัติทุกครั้ง

วิธีตรวจว่าไฟล์ช่วยจริงหรือไม่

1. ให้ AI อ่านโครงสร้างและสรุปกฎที่เข้าใจก่อนแก้
2. มอบงานเล็กที่ไม่กระทบระบบสำคัญ
3. ตรวจว่า AI เลือกคำสั่งและไฟล์ถูกตามกฎหรือไม่
4. ปรับ AGENTS.md จากความผิดพลาดที่พบ
5. รัน test/typecheck ทุกครั้งหลังเปลี่ยนกฎ

แหล่งที่มาและขอบเขตของบทความ

บทความนี้เรียบเรียงใหม่จาก transcript ภาษาไทยของคลิป Public ที่ผ่าน publication gate แล้ว ไม่ใช่การเผยแพร่ transcript เต็ม โดยใช้ source เพื่อจับประเด็นและตัวอย่าง ส่วนรายละเอียดที่ขึ้นกับเครื่องมือหรือเวอร์ชันควรตรวจสอบกับเอกสารทางการก่อนใช้งานจริง

• สร้าง AGENTS.md แล้วเปลี่ยนโปรเจกต์ให้ AI เข้าใจงาน — 1 นาที 52 วินาที · ดู Playlist
• ทำไมต้องสร้างไฟล์ AGENTS.md ใน Codex — 1 นาที 55 วินาที · ดู Playlist

เรียนต่ออย่างเป็นระบบ

ถ้าต้องการเปลี่ยนจากการถาม AI เป็นครั้ง ๆ ไปสู่การออกแบบ workflow ที่ทำซ้ำได้ เรียนต่อใน คอร์ส ChatGPT Mastery ซึ่งต่อยอดเรื่องการสั่งงาน AI, การสร้างคอนเทนต์ และการทำงานกับ Codex ให้เป็นระบบ

ดูรายละเอียดคอร์ส ChatGPT Mastery →