Agents MD Generator: สร้างไฟล์ AGENTS.md สำหรับ Claude Code, Cursor, Codex และ GitHub Copilot

ปฏิเสธไม่ได้แล้วว่า AI coding agent ได้กลายเป็นสมาชิกใหม่ของทีมพัฒนาเกือบทุกทีมไปเรียบร้อย Claude Code, Cursor, Codex และ GitHub Copilot ต่างอ่านโค้ดของเรา เสนอการแก้ไข รัน commands และเปิด pull request ได้เอง แต่เมื่อ agent ตัวหนึ่งย้ายเข้ามาอยู่ใน repository ที่มันไม่เคยรู้จัก มันก็เจอคำถามเดียวกับ contributor มือใหม่ทุกคน นั่นคือ build ยังไง test ยังไง และต้องทำตามกติกาอะไรบ้าง Agents MD Generator ตอบคำถามนี้ได้ในไม่กี่นาทีด้วยการสร้างไฟล์ instruction ที่พร้อม commit ทันที โดย AGENTS.md คือมาตรฐานเปิดที่กำลังมาแรง ซึ่งบอกทุก AI coding agent ว่าโปรเจกต์ของคุณ build, test และทำงานอย่างไร และเครื่องมือนี้ช่วยให้คุณเขียนไฟล์ดังกล่าวได้ดีตั้งแต่แรกโดยไม่ต้องเริ่มจากหน้าว่าง

หลักการของ AGENTS.md นั้นเรียบง่ายอย่างน่าทึ่ง นั่นคือไฟล์ Markdown ไฟล์เดียววางไว้ที่ root ของ repository เพื่ออธิบายโปรเจกต์ให้ agent ทุกตัวที่เข้ามาเยือนฟัง แทนที่นักพัฒนาแต่ละคนจะต้องพิมพ์คำสั่งเฉพาะหน้าลงในทุกแชต ตัวโปรเจกต์เองจะเป็นผู้ถือ context ไว้ โดย agent ที่รองรับมาตรฐานนี้จะอ่านไฟล์นี้โดยอัตโนมัติ ส่งผลให้เกิดการสันนิษฐานผิดน้อยลง การเดา command เองน้อยลง และ pull request ที่พลาด house style ของทีมก็ลดลงอย่างชัดเจน

ตัว generator เปลี่ยนงานนี้ให้เป็น workflow สั้น ๆ ที่มีคนนำทาง คุณเลือก sections ที่ต้องการ ใส่ commands และ conventions จริงของโปรเจกต์ เห็นไฟล์ประกอบร่างสด ๆ ใน live preview แล้วกดดาวน์โหลดผลลัพธ์ ทั้งหมดทำงานฝั่ง client 100% ในเบราว์เซอร์ของคุณ ไม่มีข้อมูลอะไรออกจากอุปกรณ์ และใช้งานแบบ offline ได้

ทำไมต้องใช้ Agents MD Generator?

• ไฟล์เดียว ทุก agent อ่านได้ AGENTS.md เป็นไฟล์ที่ไม่ผูกกับเครื่องมือใดเครื่องมือหนึ่ง ไฟล์เดียวกันนี้นำทางทั้ง Claude Code, Cursor, Codex และ GitHub Copilot ทำให้คุณดูแล source of truth จุดเดียว แทนที่จะมี prompt snippet กระจัดกระจายตามทีม
• Agent ไม่ต้องเดา commands อีกต่อไป ถ้าไม่มีคำแนะนำ agent จะลอง make แล้วก็ npm แล้วก็อะไรก็แล้วแต่มันจำมาจาก repository อื่น การระบุ build, test และ lint command ที่แท้จริงตั้งแต่ต้นไฟล์ตัดปัญหาที่ทำให้ agent เสียเวลามากที่สุดออกไปได้
• Sections ที่จัดโครงไว้ช่วยให้ไม่ลืมของสำคัญ ไฟล์ว่างมักทำให้เราลืมส่วนสำคัญ ๆ generator จะพาคุณไล่ผ่าน project overview, commands, conventions, testing, architecture, agent workflow และ safety rules โดยคุณเลือกเอาเฉพาะส่วนที่ต้องการ
• Live preview ตัดความเดาทิ้ง คุณเห็น Markdown สุดท้ายระหว่างพิมพ์ ทำให้ไฟล์ที่ commit ตรงกับที่คุณตรวจสอบแล้วเป๊ะ ๆ ไม่ใช่ฉบับคล้าย ๆ กัน
• ไม่ต้องติดตั้งและเป็นส่วนตัว 100% เครื่องมือนี้ฟรี ไม่ต้องสมัครบัญชี และทำงานทั้งหมดในเบราว์เซอร์ รายละเอียดโปรเจกต์ของคุณไม่มีทางไปแตะ server ใด ๆ
• ได้ artifact ที่พร้อม commit ทันที ไฟล์ที่ดาวน์โหลดมาคือ AGENTS.md ที่มีรูปแบบเรียบร้อย เอาไปวางที่ root ของ repository แล้ว commit ได้เลย

ฟีเจอร์เด่น

• ค่า default ใช้งานได้จริง ถ้าปล่อยช่อง commands ว่าไว้ generator จะใช้ค่าที่นิยมใช้อย่าง npm install และ npm test เป็นค่าเริ่มต้น แล้วค่อยปรับให้ตรงกับโปรเจกต์ใน preview
• ส่วน safety rules อย่าลืมใส่ ตรงนี้คือที่บันทึก never-touch zones เช่น secrets, ไฟล์ CI หรือคำสั่งที่ลบทำลาย ซึ่งช่วยให้ทุก session ของ agent ปลอดภัย

วิธีใช้งาน

1. เปิดเครื่องมือ ที่ Agents MD Generator หน้า editor และ live preview โหลดขึ้นมาทันทีในเบราว์เซอร์
2. เลือก sections กดสลับ section chips เฉพาะส่วนที่โปรเจกต์ต้องการ โปรเจกต์เล็ก ๆ อาจใช้แค่ overview, commands และ testing ส่วน monorepo ใหญ่ ๆ ควรเพิ่ม architecture และ safety rules ด้วย
3. กรอกรายละเอียดโปรเจกต์ ใส่ชื่อโปรเจกต์ คำอธิบายสั้นหนึ่งบรรทัด ภาษาหลักที่ใช้ และ install, build, test และ lint command ที่แท้จริงของคุณ
4. อธิบาย conventions และ workflow เพิ่มกฎการตั้งชื่อ, style guideline, ข้อคาดหวังด้าน testing และ never-touch safety rules ที่ใช้กับ repository ของคุณ
5. ตรวจ preview แล้วดาวน์โหลด อ่านไฟล์ที่ประกอบเสร็จจากบนลงล่าง แก้จุดที่อ่านแล้วไม่ลื่น จากนั้นดาวน์โหลด วางไว้ที่ root ของ repository และ commit

อะไรที่ควรใส่ใน AGENTS.md

AGENTS.md ที่ดีจะอ่านเหมือน onboarding checklist สำหรับ engineer มือดีคนใหม่ มากกว่าเอกสารประกอบ โดยไฟล์ที่มีประสิทธิภาพมักครอบคลุมห้าเรื่องนี้

Project overview อธิบายสองถึงสามบรรทัดว่าโปรเจกต์คืออะไร ใช้ stack อะไร และมีข้อจำกัดแบบไหนบ้าง ส่วนนี้เป็นจุดยึดของ instruction อื่น ๆ ทั้งหมด และป้องกันไม่ให้ agent เข้าใจ context ผิดตั้งแต่ต้น

Setup และ build commands ลำดับขั้นที่แท้จริงสำหรับติดตั้ง dependencies และ build โปรเจกต์ ตรงนี้ต้องแม่นยำที่สุดเมื่อเทียบกับส่วนอื่น เพราะรายละเอียดอย่าง npm ci กับ npm install ต่างกัน หรือ Node version ที่ต้องใช้ คือสิ่งที่ agent เดาผิดบ่อยที่สุดเมื่อปล่อยให้คิดเอง

Test และ verification commands บอก agent ว่าจะพิสูจน์ว่างานตัวเองถูกต้องได้อย่างไร ถ้า test อยู่ใน directory เฉพาะ ต้องรัน database ก่อน หรือต้องมี environment variable บางตัว ให้เขียนบอกไว้ และกฎที่ควรเขียนลงไปตรง ๆ คือ ห้ามปิดงานว่าเสร็จจนกว่า build และ test command จะผ่านบนเครื่องจริง

Conventions รูปแบบการตั้งชื่อ ลำดับการ import, สไตล์ error handling ที่ชอบ, รูปแบบ commit message ซึ่งเป็นกฎเล็ก ๆ ที่ทำให้ codebase รู้สึกเป็นเนื้อเดียวกัน agent ปฏิบัติตามข้อควรจริงเมื่อเราเขียนบอกอย่างตรงไปตรงมา

Do-not-touch rules เส้นแบ่งที่ทำให้ทุกคนปลอดภัย เช่น ห้ามแก้ไฟล์ generated, ห้ามรัน shell command แบบทำลายข้อมูล และห้าม commit secrets หรือ environment files

ทำไมเรื่องนี้ถึงสำคัญขนาดนั้น เพราะถ้าไม่มีไฟล์นี้ agent จะมีพฤติกรรมทำลายงานแบบทำนายได้ มันเดา build command จากความจำอันล้าสมัยของโปรเจกต์อื่น รัน test runner ผิดตัว หรือไม่รันเลย สร้าง file path ขึ้นมาเอง และเขียน utility ใหม่ทั้งที่ของเดิมมีอยู่แล้วอีกสาม directory ข้าง ๆ ประสบการณ์กับ agent ที่น่าหงุดหงิดแทบทุกครั้ง ย้อนกลับไปได้ที่ context ที่ขาดหาย ซึ่ง AGENTS.md บรรทัดเดียวก็เติมให้ได้

เขียนให้สั้นและทันสมัยเสมอ AGENTS.md ยาว 300 บรรทัดคือ prompt ที่ไม่มีใครอ่าน รวมถึงตัว model ด้วย ควรตั้งเป้าไว้ประมาณหนึ่งจอของเนื้อหาที่มีสาระ และอัปเดตในวันเดียวกับที่ tooling เปลี่ยน เพราะ instruction ที่เก่าคือแย่กว่าไม่มีเลย เนื่องจาก agent จะเชื่อมัน

AGENTS.md เทียบกับ CLAUDE.md และ .cursor/rules ชั้นข้อมูลเหล่านี้เสริมกัน ไม่ใช่แข่งกัน AGENTS.md เป็น baseline แบบเปิดที่ไม่ผูกกับเครื่องมือ ซึ่ง agent ใดก็อ่านได้ ส่วน CLAUDE.md คือการปรับแต่งเฉพาะของ Claude ที่วางซ้อนขึ้นมา และ .cursor/rules ใช้กำหนดพฤติกรรมของ Cursor เชิงลึกยิ่งขึ้น รูปแบบที่นิยมคือวางข้อมูลที่ใช้ร่วมกัน เช่น commands, โครงสร้าง และ conventions ไว้ใน AGENTS.md แล้วเก็บไฟล์เฉพาะเจาะจงของแต่ละเครื่องมือไว้สำหรับพฤติกรรมเฉพาะและ preference ส่วนบุคคล เมื่อไฟล์กลางเป็น source of truth จุดเดียว การสลับ agent ก็ไม่มีค่าใช้จ่าย

ตัวอย่างสั้น ๆ พร้อมคำอธิบายของไฟล์ที่ generator สร้างให้:

# AGENTS.md

Guidance for AI coding agents working in this repository.

## Commands

| Task                 | Command         |
| -------------------- | --------------- |
| Install dependencies | `npm ci`        |
| Build                | `npm run build` |
| Run tests            | `npm test`      |
| Lint                 | `npm run lint`  |

Never mark work complete until the build and
test commands above pass locally.

## Safety Rules

- Never commit secrets or .env files.
- Do not edit files under generated/.

ตาราง commands คือบล็อกที่ให้ value สูงสุดในไฟล์ เพราะมันแปลง workflow จริงของคุณให้กลายเป็นสิ่งที่ agent รันตามได้แบบคำต่อคำ ประโยคปิดท้ายวางข้อคาดหวังที่อยู่ได้ตลอดทั้ง session และ safety rules คือเส้นที่ agent ห้ามข้าม

กรณีการใช้งานจริง

Open-Source Repository: Agent ของ Contributor ก็อ่านมันด้วย

ปัจจุบัน repository สาธารณะได้รับ pull request ที่เขียนโดย agent บ่อยพอ ๆ กับที่เขียนโดยคน AGENTS.md ที่วางไว้ที่ root ของ repo จะช่วยยกระดับคุณภาพของ pull request เหล่านั้นทั้งหมดอย่างเงียบ ๆ เพราะ agent ของ contributor ทุกคนจะรู้จัก test command จริง, กฎ lint และ contribution convention ก่อนเขียนโค้ดแม้แต่บรรทัดเดียว นี่คือเอกสารที่ maintainer เพิ่มได้ถูกที่สุด และให้ผลตอบแทนกับทุก pull request ในอนาคต

Monorepo

Monorepo คือสถานที่ที่ agent สับสนมากที่สุด แอปหนึ่งใช้ pnpm workspaces อีกแอปใช้ Poetry แล้ว agent แยกไม่ออก AGENTS.md ที่ root จะวางภาพรวม ส่วนไฟล์ AGENTS.md แยกตาม directory จะ override commands และ conventions ของแต่ละ package โดย agent จะหยิบไฟล์ที่ใกล้ที่สุดและใช้ได้จริงมาใช้ ทำให้คุณได้ทั้ง baseline ร่วมและความแม่นยำระดับท้องถิ่นในเวลาเดียวกัน

โปรเจกต์ส่วนตัว

แม้แต่ repository ส่วนตัวของคนเดียวก็คุ้มค่า คุณสลับไปมาระหว่างเครื่องและระหว่างเครื่องมือ ใช้ Cursor ที่โต๊ะทำงาน ใช้ Claude Code บน laptop แล้ว AGENTS.md ทำให้คุณไม่ต้องอธิบาย setup ของตัวเองซ้ำกับใครเลย และเมื่อกลับมาแตะ side project หลังจากห่างหายสามเดือน ไฟล์นี้ยังทำหน้าที่เป็นเจ้าความจำว่าโปรเจกต์ของคุณเอง build อย่างไรอีกด้วย

การมาตรฐานระดับองค์กร

สำหรับทีม AGENTS.md คือนโยบาย template ที่ผ่านการ review แล้วแจกจ่ายไปตาม repository ต่าง ๆ จะทำให้ทุก session ของ agent ใช้ verification step แบบเดียวกันและเคารพ safety boundary เดียวกัน ทีม security จะชอบจุดเดียวที่ตรวจสอบได้ ซึ่งระบุกฎอย่าง "ห้ามรัน migration เองโดยไม่ถาม" ไว้สำหรับ contributor อัตโนมัติทุกตัว

แนวทางปฏิบัติที่ดีที่สุด

• Commit ไว้ที่ root ของ repository ไฟล์จะทำงานก็ต่อเมื่ออยู่ตรงที่ agent มองหา เก็บไว้ใน version control เพื่อให้มันพัฒนาไปพร้อมกับโค้ดและถึงมือ contributor ทุกคนผ่าน pull request ปกติ
• Commands ต้องแม่นยำและทดสอบแล้วเท่านั้น รันทุก command ที่คุณเขียนก่อน commit ไฟล์ เพราะ agent ที่ตาม command ที่พังเสียเวลามากกว่า agent ที่ไม่มีไฟล์เลยซะอีก
• อัปเดตเมื่อ tooling เปลี่ยน ย้าย build system หรือเพิ่ม test runner ใหม่ ให้ถือว่าการอัปเดต AGENTS.md เป็นส่วนหนึ่งของ change เดียวกัน เหมือนกับที่คุณอัปเดต README
• ความยาวไม่ควรเกินหนึ่งจอ instruction ที่สั้นและเน้นสาระ ชนะแบบละเอียดยิบย่อยเสมอ ถ้ามีเอกสารเชิงลึกให้ลิงก์ออกไปแทนการก๊อปมาวาง
• เขียน safety rules อย่างชัดเจน อย่าหวังพึ่ง common sense ให้ระบุชื่อ directory, ไฟล์ และประเภทคำสั่งที่ห้าม agent แตะโดยตรง
• Review การเปลี่ยนแปลงเหมือนโค้ด เพราะ agent ทำตามไฟล์อย่างตรงตัว instruction ที่เขียนไม่รอบคอบจึงแพร่ไปทุก session ในอนาคต ควรแก้ไขผ่าน pull request เสมอ

ลองใช้เลย

AGENTS.md ที่เขียนดีคือไฟล์ที่ให้ผลลัพธ์สูงสุดต่อเวลาที่คุณเพิ่มให้ repository ได้ในปีนี้ เปิด Agents MD Generator เลือก sections ที่ต้องการ ใส่ commands จริงของคุณ แล้วดาวน์โหลดไฟล์พร้อม commit ได้ภายในประมาณห้านาที ฟรี เป็นส่วนตัว 100% และใช้ offline ได้

เครื่องมืออื่น ๆ ที่คุณอาจสนใจ:

• Cursor Rules Generator — สร้างไฟล์ .cursor/rules เพื่อกำหนดพฤติกรรมเฉพาะโปรเจกต์ให้ Cursor
• GitHub Actions Workflow Generator — สร้าง CI workflow ที่รัน commands ชุดเดียวกับที่ agent ของคุณจะรัน
• Markdown Preview — เรนเดอร์และตรวจไฟล์ AGENTS.md ของคุณแบบเดียวกับที่ agent และผู้อ่านจะเห็น

ขอให้สนุกกับการ build ทั้งมนุษย์และ agent

คำถามที่พบบ่อย

ถ: AGENTS.md คืออะไร และเครื่องมือไหนอ่านมันจริง?

ตอบ: AGENTS.md คือข้อตกลงแบบเปิดสำหรับไฟล์ Markdown ที่วางไว้ที่ root ของ repository เพื่อให้ instruction เฉพาะโปรเจกต์แก่ AI coding agent ทั้ง Claude Code, Cursor, Codex, coding agent ของ GitHub Copilot และเครื่องมืออื่นอีกหลายตัวอ่านมันโดยอัตโนมัติเมื่อมีอยู่ ส่วนเครื่องมือที่ไม่รองรับก็ไม่ได้รับผลกระทบใด ๆ

ถ: generator อัปโหลดข้อมูลโปรเจกต์ของฉันไปที่ไหนหรือเปล่า?

ตอบ: ไม่ เครื่องมือนี้ทำงานฝั่ง client 100% ในเบราว์เซอร์ ทุกอย่างที่คุณพิมพ์อยู่บนอุปกรณ์ของคุณเท่านั้น และไฟล์ที่สร้างถูกประมวลผลแบบ local ก่อนดาวน์โหลด จึงใช้งานแบบ offline ได้ด้วยหลังจากหน้าเว็บโหลดแล้ว

ถ: ใช้ AGENTS.md คู่กับ CLAUDE.md พร้อมกันได้ไหม?

ตอบ: ได้ และเป็นรูปแบบที่นิยมมาก ให้วางข้อมูลที่ใช้ร่วมกันและไม่ผูกกับเครื่องมือ เช่น commands, โครงสร้าง, conventions และ safety rules ไว้ใน AGENTS.md แล้วใช้ CLAUDE.md สำหรับพฤติกรรมเฉพาะของ Claude หรือ preference ส่วนบุคคล ไฟล์ของผู้ให้บริการแต่ละรายจะขยาย baseline แทนการซ้ำซ้อนกัน

ถ: AGENTS.md ควรยาวแค่ไหน?

ตอบ: สั้นพอที่จะอ่านจบในหนึ่งจอ เน้น commands ที่แม่นยำ, overview แบบกระชับ, conventions ที่จำเป็น และ safety rules เอกสารเชิงลึกควรอยู่ใน docs ปกติของโปรเจกต์ แล้วลิงก์ออกไปแทนการก๊อปมาใส่ในไฟล์ของ agent

ถ: ถ้า build command ของฉันเปลี่ยนภายหลังต้องทำอย่างไร?

ตอบ: ให้อัปเดตไฟล์ใน change เดียวกับที่อัปเดต tooling แล้ว commit ทั้งสองอย่างพร้อมกัน ควรถือว่า instruction ที่เก่าเป็นบั๊ก เพราะ agent จะทำตามไฟล์ตามที่เขียนไว้ ไฟล์จึงต้องอธิบาย repository ตามสภาพปัจจุบันเสมอ