AGENTS.md คืออะไร และจะเขียนไฟล์ของตัวเองได้อย่างไรภายใน 30 นาที

เนื้อหาที่ใช้ได้จริงเกี่ยวกับ vibe coding และการทำงานกับเอเจนต์: เอกสารประกอบของ Ailoot.

AGENTS.md ในหนึ่งย่อหน้า#

ด้านล่างนี้จะพิจารณารูปแบบดังกล่าวโดยอ้างอิง agents.md, เอกสารของ OpenAI Codex, JetBrains Junie, Cursor Rules Docs, บันทึกการเปลี่ยนแปลงของ GitHub Copilot Coding Agent และ ข่าวประชาสัมพันธ์ของ Linux Foundation เกี่ยวกับ Agentic AI Foundation ตัวเลขและฟีเจอร์ทั้งหมดเป็นข้อมูล ณ วันที่ 30 พฤษภาคม 2026 ส่วนการรองรับ AGENTS.md ใน Claude Code อธิบายตาม เอกสารของ Anthropic ซึ่งอัปเดตเมื่อวันที่ 24 กันยายน 2026

หากคุณยังไม่รู้ว่าเครื่องมือมากมายในตลาดนี้คืออะไร หรือทำไมจึงต้องมีไฟล์ที่ใช้ร่วมกัน โปรดอ่านคู่มือ “เขียนโค้ดด้วยอะไรในปี 2026: เครื่องมือ AI 8 รายการ ตั้งแต่ Claude Code ถึง Antigravity” ก่อน บทความนี้มุ่งเน้นเฉพาะรูปแบบ AGENTS.md และวิธีเขียนไฟล์ของคุณเองภายใน 30 นาที

AGENTS.md คืออะไร และมีที่มาอย่างไร#

ก่อนหน้านี้ เครื่องมือ AI แต่ละตัวมีไฟล์กฎของตัวเอง: Anthropic มี CLAUDE.md, Cursor มี .cursorrules, GitHub มี .github/copilot-instructions.md, Aider มี .aider.conf.yml และ JetBrains มี .junie/guidelines.md หากทีมของคุณมีเอเจนต์ต่างกันสามตัว ก็หมายถึงมีไฟล์สามไฟล์ที่มีเนื้อหาเหมือนกันและจะแตกต่างกันไปภายในหนึ่งสัปดาห์

OpenAI เป็นรายแรกที่เบื่อเรื่องนี้ ในเดือนสิงหาคม 2025 บริษัทเผยแพร่ Codex CLI และเปิดตัว agents.md เป็นรูปแบบเปิดพร้อมกัน จากเว็บไซต์:

“ลองคิดว่า AGENTS.md คือ README สำหรับเอเจนต์”

(agents.md, แปลจากภาษาอังกฤษ)

ประเด็นหลักคือ AGENTS.md เป็นส่วนเสริมของ README โดย README เขียนขึ้นสำหรับคน: “โปรเจ็กต์นี้คืออะไร วิธีรันในเครื่อง วิธีร่วมพัฒนา” ส่วน AGENTS.md เขียนขึ้นสำหรับเอเจนต์: คำสั่ง shell ที่แน่นอน เกณฑ์ “เสร็จแล้ว” ที่ตรวจสอบได้ และข้อจำกัดอย่าง “ห้ามแตะสิ่งนี้เด็ดขาด”

จากเว็บไซต์:

“AGENTS.md เป็นส่วนเสริมของ README: มีบริบทเพิ่มเติม ซึ่งบางครั้งก็ละเอียด ที่เอเจนต์ต้องใช้ เช่น ขั้นตอนการ build การทดสอบ และแนวปฏิบัติที่อาจทำให้ README ยืดยาวเกินไป หรือไม่จำเป็นสำหรับผู้ร่วมพัฒนาที่เป็นคน”

(agents.md, แปลจากภาษาอังกฤษ)

ภายในเดือนกันยายน 2025 GitHub Copilot Coding Agent รองรับรูปแบบนี้แล้ว (บันทึกการเปลี่ยนแปลง, 28.08.2025) เมื่อถึงเดือนธันวาคม Cursor, Junie, Gemini CLI, Aider และเครื่องมืออื่น ๆ อีกหลายสิบรายการก็เข้าร่วม วันที่ 9 ธันวาคม 2025 Linux Foundation ก่อตั้ง Agentic AI Foundation (AAIF): โปรเจ็กต์ผู้ก่อตั้งสามรายการคือ AGENTS.md จาก OpenAI, MCP จาก Anthropic และ goose จาก Block สมาชิกผู้ก่อตั้งได้แก่ AWS, Anthropic, Block, Bloomberg, Cloudflare, Google, Microsoft และ OpenAI ภายในวันที่ 24 กุมภาพันธ์ 2026 มูลนิธิมี 146 องค์กร แล้ว รวมถึง Red Hat, ServiceNow, Akamai, Lenovo, JPMorgan Chase, Huawei, UiPath และ Hitachi

จากจุดนั้น AGENTS.md ก็เลิกเป็น “อีกสิ่งหนึ่งจาก OpenAI” และกลายเป็นมาตรฐานโดยพฤตินัย

เอเจนต์ AI ตัวใดอ่าน AGENTS.md และตัวใดไม่อ่าน#

ตารางการรองรับ ณ วันที่ 30 พฤษภาคม 2026; แถวของ Claude Code อัปเดตเมื่อวันที่ 24 กันยายน 2026:

Anthropic เป็นรายสุดท้ายในบรรดาผู้เล่นรายใหญ่ที่เข้าร่วม ในเดือนสิงหาคม 2025 มีการเปิด issue #6235 ในที่เก็บทางการ anthropics/claude-code เพื่อขอให้รองรับ AGENTS.md

issue นี้เปิดค้างเกือบหนึ่งปีและปิดเมื่อวันที่ 17 สิงหาคม 2026; เวอร์ชัน 2.1.277 ที่รองรับ AGENTS.md เปิดตัวเมื่อวันที่ 18 กันยายน ตรรกะของ Anthropic คือ CLAUDE.md มีลำดับความสำคัญสูงกว่า และจะอ่าน AGENTS.md เมื่อไม่มี CLAUDE.md ในโฟลเดอร์ทำงานหรือโฟลเดอร์แม่ใด ๆ ตามเอกสาร การทำงานเป็นดังนี้:

ข้อควรระวังคือ CLAUDE.local.md ส่วนตัวก็นับด้วย และเมื่อมีไฟล์นี้ Claude Code จะหยุดอ่าน AGENTS.md คุณเปลี่ยนพฤติกรรมนี้ได้ใน /config ตรง Project instructions เช่น ตั้งค่าให้ Claude Code อ่านทั้งสองไฟล์พร้อมกัน ในเวอร์ชันที่เก่ากว่า 2.1.277 ระบบจะไม่อ่าน AGENTS.md โดยอัตโนมัติ วิธีแก้ขัดยังคงเป็นการใส่บรรทัด @AGENTS.md ใน CLAUDE.md

AGENTS.md ต่างจาก CLAUDE.md และ .cursorrules อย่างไร#

เปรียบเทียบสี่รูปแบบ ณ วันที่ 30 พฤษภาคม 2026:

AGENTS.md เก็บคำสั่งร่วมของโปรเจกต์ได้ ส่วนวิธีโหลดของแต่ละไคลเอนต์และการตั้งค่าส่วนตัวยังต้องกำหนดแยกกัน Claude Code มี CLAUDE.local.md สำหรับเรื่องนี้ ส่วน Cursor มีไฟล์ .mdc ในระดับผู้ใช้ AGENTS.md เพียงอย่างเดียวไม่มีฟังก์ชันนี้ คุณต้องใช้ร่วมกับไฟล์อื่นหรือให้ทีมตกลงกันว่าจะเขียนกฎส่วนตัวไว้ในส่วนที่ gitignore

อีกประเด็นสำคัญคือ monorepo Codex และ Cursor ใช้กฎ “AGENTS.md ที่อยู่ใกล้ที่สุดเป็นตัวชนะ”:

“ใน monorepo ให้วาง AGENTS.md แยกไว้ในแต่ละแพ็กเกจ เอเจนต์จะอ่านไฟล์ที่ใกล้ที่สุดในลำดับชั้นของไดเรกทอรีโดยอัตโนมัติ และไฟล์ที่ใกล้ที่สุดเป็นตัวชนะ”

(agents.md, แปลจากภาษาอังกฤษ)

agents.md ระบุว่า monorepo หลักของ OpenAI มีไฟล์ AGENTS.md จำนวน 88 ไฟล์สำหรับแพ็กเกจย่อยต่าง ๆ หากคุณทำงานใน monorepo ให้กระจายกฎไปตามระดับต่าง ๆ: กฎทั่วไปไว้ที่รูท กฎเฉพาะไว้ในโฟลเดอร์ย่อย

AGENTS.md ที่ดีควรมีอะไรบ้าง#

เว็บไซต์ agents.md เสนอรูปแบบที่ยืดหยุ่น — “Markdown แบบใดก็ได้” แต่ 80% ของไฟล์ที่ดีซึ่งพบในงานจริงมีแปดส่วนเหมือนกัน กฎหลักคือทุกรายการควรเป็นคำสั่งที่แน่นอนหรือตัวอย่างที่ชัดเจน แนวคิดนามธรรมอย่าง “เขียนโค้ดให้สะอาด” จะถูกเอเจนต์มองข้าม

1. ภาพรวมโปรเจ็กต์ — 2–3 บรรทัด โปรเจ็กต์คืออะไร เหมาะกับใคร และมีเป้าหมายหลักอะไร ไม่ต้องใส่คำโฆษณา ตัวอย่าง: “บอต Telegram สำหรับรับผู้เข้าร่วมเวิร์กช็อปแบบเสียเงิน ใช้เทคโนโลยี: Next.js 14, Prisma, PostgreSQL เริ่มทำงานเมื่อมีการเพิ่มระเบียนใหม่ใน purchases”
2. คำสั่งตั้งค่า — คำสั่ง shell ที่แน่นอนสำหรับรันในเครื่อง npm install, npm run dev, npm run build ไม่ต้องเขียนว่า “ปกติเราทำแบบนี้”
3. รูปแบบโค้ด / แนวปฏิบัติ — กฎเฉพาะพร้อมตัวอย่าง ไม่ใช่ “เขียนให้สะอาด” เช่น “ใช้ TypeScript strict, ใช้ single quotes, ไม่มี default exports, ชื่อคอมโพเนนต์เป็น PascalCase, ชื่อ hooks ขึ้นต้นด้วย use”
4. เคล็ดลับสภาพแวดล้อมการพัฒนา — ระบุว่าสิ่งสำคัญอยู่ที่ไหน ต้องใช้ตัวแปรใดใน .env เก็บ secrets ที่ไหน ใช้พอร์ตใด และทำงานกับ DB ในเครื่องอย่างไร
5. คำแนะนำการทดสอบ — วิธีรันการทดสอบเฉพาะและอะไรถือว่า “ผ่าน” ตัวอย่าง: npm test -- --testPathPattern=user-auth; คาดหวังให้ผ่าน 100%
6. แนวทาง PR / commit — รูปแบบข้อความ commit รายการตรวจสอบก่อน PR (การทดสอบ, linter, เอกสาร) และใครเป็นผู้อนุมัติ
7. ข้อพิจารณาด้านความปลอดภัย — สิ่งที่ห้ามเกิดขึ้นเด็ดขาด “ห้าม commit .env secrets ต้องเก็บไว้ใน Vault เท่านั้น อย่าแสดงข้อมูลส่วนบุคคลของผู้ใช้ใน logs”
8. ข้อจำกัด / ห้ามทำสิ่งนี้เด็ดขาด — ข้อห้ามพร้อมทางเลือก “อย่าใช้ git push --force บน main หากต้องการย้อนกลับ ให้ใช้ git revert หรือ git reset บน feature branch”

ในแต่ละส่วน ให้ใช้หลักการ “คำสั่งแทนแนวคิด” เอเจนต์จะไม่สนใจ “ระวังการย้ายข้อมูล” แต่จะทำตาม “ก่อน alembic upgrade head ให้รัน alembic check หากแสดงข้อผิดพลาด อย่าใช้ migration ให้ถามฉัน”

เทมเพลต AGENTS.md พร้อมใช้ (คัดลอกแล้วปรับแต่ง)#

# AGENTS.md

## ภาพรวมโปรเจ็กต์

<project-name> - <one phrase describing its purpose>.
Stack: <Next.js / Python / Go / ...>.
Main entities: <users, orders, posts ...>.
Details for people are in README.md.

## คำสั่งตั้งค่า

```bash
# first install
npm install
cp .env.example .env  # then fill in manually; see list below

# run
npm run dev           # dev server on :3000
npm run build         # production build
npm run start         # run production build
```

## สภาพแวดล้อมการพัฒนา

- Node 20+ (via nvm: `nvm use 20`)
- PostgreSQL 16 locally on :5432 (`docker-compose up postgres`)
- Redis is optional, needed only for queues (`docker-compose up redis`)
- `.env`: `DATABASE_URL`, `STRIPE_KEY`, `RESEND_API_KEY`, `JWT_SECRET`
- Never read the entire `.env` file. If you need one variable: `grep "^VAR=" .env`

## รูปแบบโค้ด

- TypeScript strict mode
- Single quotes, no semicolons (unless ESLint requires them)
- Imports: external first, then internal via `@/`, then relative
- Components in PascalCase; hooks start with `use`
- No `any` without an explicit comment explaining “why it can’t be typed”

ตัวอย่างโมดูลที่ดี:

```ts
import { z } from 'zod'

const UserSchema = z.object({
  email: z.string().email(),
  name: z.string().min(2),
})

export function parseUser(raw: unknown) {
  return UserSchema.parse(raw)
}
```

## การทดสอบ

```bash
npm test                                # all tests
npm test -- --testPathPattern=auth      # auth only
npm test -- --watch                     # watch mode
```

การทดสอบทั้งหมดต้องผ่าน (เป็นสีเขียว) ก่อน commit หากการทดสอบใดไม่ผ่าน อย่า commit ให้ถามฉันว่าควรทำอย่างไร

## แนวทาง Pull request

- รูปแบบ commit: `<type>(<scope>): <description>` (`feat(auth): add magic-link`)
- ก่อน PR: `npm run build && npm test && npm run lint`
- คำอธิบาย PR = เปลี่ยนอะไร ทำไม และทดสอบอย่างไร
- อย่าอนุมัติ PR ของตัวเอง ให้รอการตรวจสอบจากมนุษย์เสมอ

## ความปลอดภัย

- เก็บ secrets ไว้ใน `.env` และ Vault เท่านั้น ห้ามใส่ในโค้ด
- อย่าบันทึกข้อมูลส่วนบุคคล (email, phone, name) ลง logs
- เมื่อทำงานกับ DB สำหรับ production ให้ใช้เฉพาะคำสั่งอ่านอย่างเดียว เว้นแต่จะได้รับอนุญาตอย่างชัดเจน
- อย่าฝัง API keys ของบริการภายนอก (Stripe, OpenAI) ไว้ใน tests

## ห้ามทำสิ่งนี้เด็ดขาด

- อย่า `git push --force` ไปยัง main หากต้องการย้อนกลับ ให้ใช้ `git revert` หรือเปิด PR ใหม่
- อย่ารัน DB migrations โดยไม่มี `alembic check` (หรือคำสั่งเทียบเท่าใน ORM ของคุณ)
- อย่าใช้ `npm install -g` หรือ `sudo` เพื่อติดตั้ง dependencies ของโปรเจ็กต์
- อย่าเพิ่ม dependencies โดยไม่ได้รับอนุมัติ โดยเฉพาะรายการขนาดใหญ่ เช่น webpack plugins, ORM

โดยเฉลี่ย เทมเพลตมีความยาว 80–120 บรรทัด หากไฟล์ยาวเกิน 150 บรรทัด นั่นเป็นสัญญาณให้จัดโครงสร้างใหม่: ย้ายบางอย่างไปไว้ใน docs/, ใส่ลิงก์ไปยังข้อมูล หรือย่อให้เหลือบรรทัดเดียว ในทางปฏิบัติ ไฟล์ขนาด 100–150 บรรทัดทำงานได้ดีที่สุด เมื่อเกินจุดนั้น ประโยชน์ด้านคุณภาพจะเริ่มลดลง

5 กฎใดทำให้ AGENTS.md มีประโยชน์จริง#

1. ใช้คำสั่งแทนแนวคิด เอเจนต์ไม่เข้าใจคำว่า “ระวังการย้ายข้อมูล” แต่จะทำตาม alembic check ก่อน alembic upgrade head เอเจนต์ทำงานกับคำสั่งและเงื่อนไข ไม่ใช่อารมณ์ความรู้สึก เขียนกฎสำคัญทั้งหมดในรูปแบบ “ทำ X มิฉะนั้นให้ทำ Y”

2. ระบุข้อห้ามพร้อมทางเลือก เอเจนต์จะค่อย ๆ มองข้ามคำสั่ง “อย่า force push” หลังได้รับคำสั่งสองหรือสามครั้ง การจับคู่ “อย่าทำ X; ให้ทำ Y แทน” ใช้ได้ผล ตัวอย่าง: “อย่าใช้ git push --force บน main หากต้องการย้อนกลับ ให้ใช้ git revert หรือเปิด PR ใหม่”

3. มีแหล่งข้อมูลหลักเพียงแห่งเดียว AGENTS.md ในรูทเป็นแหล่งข้อมูลหลักของทั้งโปรเจ็กต์ หากมี monorepo ให้ใช้ไฟล์ AGENTS.md ในโฟลเดอร์ย่อยตามกฎ “ไฟล์ที่ใกล้ที่สุดเป็นตัวชนะ” ห้ามมีไฟล์คู่ขนานที่มีคำสั่งขัดแย้งกัน

4. กำหนดเกณฑ์ “เสร็จแล้ว” ที่ตรวจสอบได้ “การทดสอบต้องผ่าน” ไม่มีประโยชน์ เกณฑ์ที่แน่นอนคือ npm test คืนค่า exit code 0 และไม่พิมพ์ FAIL ไปยัง stdout “โค้ดต้องสะอาด” ก็ไม่มีประโยชน์เช่นกัน เกณฑ์ที่แน่นอนคือ npm run lint ผ่านโดยไม่มี warnings เอเจนต์จะเข้าใจว่า “เสร็จแล้ว” หมายถึงอะไร ก็ต่อเมื่อคุณอธิบายเงื่อนไขอย่างชัดเจน

5. ไฟล์สั้นกว่า 150 บรรทัด เมื่อเกิน 150 บรรทัด ตัวชี้วัดเริ่มแย่ลง: เอเจนต์ใช้บริบทในการอ่านมากขึ้นและพลาดกฎสำคัญ หากใส่ทุกอย่างไว้ไม่พอ ให้ย้ายรายละเอียดไปที่ docs/architecture.md แล้วลิงก์จาก AGENTS.md โดยเหลือเฉพาะคำสั่งและข้อจำกัดในไฟล์

10 ข้อผิดพลาดใดทำให้ AGENTS.md กลายเป็นขยะ#

1. กฎคลุมเครือที่ไม่มีคำสั่ง เอเจนต์จะมองข้าม “ระวังการย้ายข้อมูล” เพราะประโยคนี้ไม่มีความหมายสำหรับมัน มีเพียงคำสั่งเฉพาะพร้อมเงื่อนไขเท่านั้นที่ได้ผล: “รัน alembic check ก่อน alembic upgrade head หากมีข้อผิดพลาด อย่าใช้ migration ให้ถามฉัน”

2. “โค้ดสะอาด” เป็นวลีที่ไร้ประโยชน์ ให้แทนที่ด้วยรูปแบบที่เฉพาะเจาะจง: “ใช้คอมโพเนนต์แบบฟังก์ชันกับ hooks ตัวอย่าง: function LoginForm() { const [email, setEmail] = useState(''); ... }”

3. ร้อยแก้วไม่มีโครงสร้าง หาก AGENTS.md มีร้อยแก้ว 300 บรรทัดโดยไม่มีหัวข้อ เอเจนต์จะใช้ context tokens 80K ไปกับข้อความที่ไม่เกี่ยวข้องและพลาดเรื่องสำคัญ ใช้หัวข้อ H2/H3 ส่วนสั้น ๆ และรายการหัวข้อย่อย

4. ไฟล์ยาวกว่า 150 บรรทัด ตัวชี้วัดคุณภาพจะลดลงเมื่อเกินเกณฑ์นี้ แยกเป็นไฟล์หลักและลิงก์ไปยังรายละเอียดใน docs/

5. ข้อห้าม 30 ข้อขึ้นไปโดยไม่มีทางเลือก หากไฟล์มีรายการยาว ๆ อย่าง “ห้ามทำ X ห้ามทำ Y” โดยไม่อธิบายว่า “ให้ทำ Z แทน” เอเจนต์จะสับสนและเดินไปอย่างไร้ทิศทาง

6. คัดลอก README.md หากเขียนวิธีติดตั้งและรันไว้ใน README แล้ว อย่าคัดลอกมาไว้ใน AGENTS.md ให้ใส่การอ้างอิง README หนึ่งบรรทัดแทน แล้วอธิบายใน AGENTS.md ว่าเอเจนต์ต้องรู้อะไรที่ผู้ร่วมพัฒนาซึ่งเป็นคนไม่จำเป็นต้องรู้

7. ฝัง secrets ไว้ในไฟล์ AGENTS.md อาจเปิดเผยต่อสาธารณะ (อยู่ใน git) ห้ามใส่ API keys, tokens หรือรหัสผ่านจริง ให้ใส่เฉพาะการอ้างอิงไปยังที่เก็บ secrets เช่น “ดู Vault: secret/staging/db”

8. ลำดับความสำคัญที่ขัดแย้งกันโดยไม่จัดอันดับ “ทำงานให้เร็ว” + “รักษาความครอบคลุมของการทดสอบ 90%” ทำให้เอเจนต์ไม่รู้ว่าควรเลือกอะไร จัดอันดับอย่างชัดเจน: “ความครอบคลุมของการทดสอบ ≥80% มาก่อน แล้วจึงคำนึงถึงความเร็ว หากขัดแย้งกัน ให้การทดสอบมีความสำคัญกว่า”

9. เอกสารล้าสมัย คำอธิบายสถาปัตยกรรมที่ระบุว่าใช้ REST+polling ทั้งที่ปัจจุบันใช้ WebSockets แล้ว เอเจนต์จะทำตามคำอธิบายที่ล้าสมัยและทำให้สถาปัตยกรรมพัง กฎคือให้อัปเดต AGENTS.md ใน PR เดียวกับการเปลี่ยนสถาปัตยกรรมในโค้ด

10. สถาปัตยกรรมซับซ้อนเกินไปสำหรับงานง่าย ๆ หากมีคนขอให้เปลี่ยนสองบรรทัดในไฟล์ config เอเจนต์ไม่ควรต้องอ่านภาพรวมทั้งหมดของ microservices 14 ตัว ย้ายรายละเอียดสถาปัตยกรรม “เชิงลึก” ไปที่ docs/architecture.md; ใน AGENTS.md ให้เหลือเพียง “หากงานเกี่ยวกับสถาปัตยกรรม ให้อ่าน docs/architecture.md”

การศึกษาของ GitHub Blog จากที่เก็บ AGENTS.md มากกว่า 2,500 แห่ง ระบุข้อสรุปหลักไว้ว่า:

“ไฟล์เอเจนต์ส่วนใหญ่ล้มเหลวเพราะเขียนกว้างเกินไป ‘คุณคือผู้ช่วยเขียนโค้ดที่เป็นประโยชน์’ ใช้ไม่ได้”

(GitHub Blog, แปลจากภาษาอังกฤษ)

จะเก็บ AGENTS.md และ CLAUDE.md ไว้ใน repo เดียวกันได้อย่างไร#

คำถามเชิงปฏิบัติหลักคือจะใช้ไฟล์ทั้งสองโดยไม่ทำสำเนาเนื้อหาได้อย่างไร มีสามสถานการณ์:

สถานการณ์ 1: ใช้ Claude Code อย่างเดียว เก็บ CLAUDE.md ไว้และใช้ฟีเจอร์ทั้งหมดของ Claude Code: ~/.claude/CLAUDE.md สำหรับคำสั่งระดับผู้ใช้, CLAUDE.md สำหรับโปรเจ็กต์, CLAUDE.local.md สำหรับการเขียนทับส่วนตัว, @import เพื่อรวมไฟล์อื่น และ .claude/skills/ สำหรับ skills เฉพาะทาง ไม่จำเป็นต้องมี AGENTS.md

สถานการณ์ 2: ใช้ไคลเอนต์เขียนโค้ดหลายตัว เก็บกฎร่วมไว้ใน AGENTS.md แล้วเชื่อมต่อและตรวจแต่ละไคลเอนต์แยกกัน Gemini CLI รองรับการตั้งชื่อไฟล์บริบท ส่วน Aider โหลดไฟล์ผ่านการตั้งค่า read ได้ ทั้งสองเป็นวิธีโหลดที่กำหนดชัดเจน ไม่ใช่การค้นหาอัตโนมัติแบบเดียวกัน

เปิดเซสชันใหม่ในรีโปทดสอบที่ไม่เสี่ยง เพิ่มคำสั่งทดสอบเฉพาะที่ไม่เป็นอันตราย เช่น “ใส่เครื่องหมาย instructions-loaded ในคำตอบทดสอบ” แล้วตรวจทั้งหน้าดูไฟล์ที่โหลดหรือ log ตามเอกสารของไคลเอนต์และคำตอบ ทำซ้ำกับทุกไคลเอนต์และเวอร์ชันที่ใช้จริง คำตอบที่โมเดลบอกว่าอ่านไฟล์แล้วไม่ใช่หลักฐานอิสระว่าไฟล์ถูกโหลด และการตรวจผ่านหนึ่งตัวไม่ได้ยืนยันเครื่องมืออื่นทั้งหมด

สถานการณ์ 3: ทีมผสม (Claude Code และเครื่องมืออื่น ๆ) นี่เป็นการตั้งค่าที่พบบ่อยที่สุดในปี 2026 วิธีแก้คือให้ AGENTS.md เป็นไฟล์หลัก หากไม่มีกฎที่มีไว้สำหรับ Claude Code โดยเฉพาะ ก็อย่าสร้าง CLAUDE.md เลย: ตั้งแต่เวอร์ชัน 2.1.277 Claude Code จะอ่าน AGENTS.md เมื่อโปรเจ็กต์ไม่มี CLAUDE.md หากมีกฎดังกล่าว ให้ใช้ CLAUDE.md เป็น symlink หรือไฟล์ครอบสั้น ๆ ที่มี import @AGENTS.md

ก่อนเปลี่ยนไฟล์ให้ตรวจและสำรองทั้งคู่ หากมีทั้งสอง ให้รวมคำสั่งร่วมที่ไม่ขัดกันไว้ใน AGENTS.md และเก็บคำสั่งเฉพาะ Claude ใน CLAUDE.md พร้อม import @AGENTS.md รักษา symlink เดิมแทนการแทนที่

สำหรับ CLAUDE.md ที่เป็นไฟล์ปกติ เฉพาะเมื่อไม่มี AGENTS.md ตัวป้องกันบน macOS/Linux นี้จะไม่เขียนทับเป้าหมายหรือ symlink เดิม:

if [ -e AGENTS.md ] || [ -L AGENTS.md ]; then
  printf '%s\n' 'STOP: AGENTS.md exists; merge both files first.' >&2
elif [ -f CLAUDE.md ] && [ ! -L CLAUDE.md ]; then
  mv CLAUDE.md AGENTS.md && ln -s AGENTS.md CLAUDE.md
else
  printf '%s\n' 'STOP: inspect the existing CLAUDE.md path first.' >&2
fi

หลังเปลี่ยนชื่อสำเร็จ CLAUDE.md เป็น symlink ไป AGENTS.md

บน Windows การสร้าง symlink ต้องใช้ Developer Mode (หรือสิทธิ์ Admin) ซึ่งอาจไม่สะดวกสำหรับทั้งทีม ทางเลือกคือสร้าง CLAUDE.md สั้น ๆ ที่ import AGENTS.md:

# CLAUDE.md

@AGENTS.md

## เฉพาะ Claude Code

- ใช้ .claude/skills/ สำหรับ prompts เฉพาะทาง
- เมื่อทำงานกับ Skills ให้อ่าน .claude/skills/INDEX.md
- ใช้ Plan Mode ก่อนเปลี่ยนแปลงครั้งใหญ่ (Shift+Tab)

ใน Claude Code ไวยากรณ์นี้จะนำ AGENTS.md เข้ามาด้วยบรรทัดเดียว แล้วเพิ่มส่วนเฉพาะของ Claude Code ต่อท้าย หากต้องการนำ AGENTS.md ออกในภายหลัง ก็เพียงลบ import บรรทัดนี้ไม่ทำให้อ่านซ้ำสองครั้ง: ตามเอกสารของ Claude Code ระบบจะไม่โหลด AGENTS.md เดิมซ้ำ แม้จะอ่านไฟล์นั้นเองได้ก็ตาม

โครงสร้างมาตรฐานสำหรับทีมที่ใช้หลายเครื่องมือในปี 2026:

repo-root/
├── AGENTS.md                              # แหล่งข้อมูลหลัก ≤150 บรรทัด
├── CLAUDE.md                              # มีเฉพาะเมื่อมีกฎสำหรับ Claude โดยเฉพาะ: symlink → AGENTS.md หรือ @AGENTS.md + ส่วนเพิ่มเติม
├── .cursor/rules/                         # กฎเฉพาะสำหรับ Cursor
├── .github/copilot-instructions.md        # “ดู AGENTS.md” หากใช้
└── docs/architecture.md                   # รายละเอียดสถาปัตยกรรมที่ AGENTS.md อ้างถึง

อ่านเพิ่มเติมเกี่ยวกับ CLAUDE.md ได้ในคู่มือ “วิธีกำหนดค่า CLAUDE.md อย่างถูกต้อง” สำหรับบริบทเพิ่มเติมเกี่ยวกับเหตุผลที่เอเจนต์ต้องมีไฟล์คำสั่งขนาดใหญ่ โปรดอ่าน “Context Engineering คืออะไร”

เกิดอะไรขึ้นในปี 2026: ทำไม AAIF จึงนำ AGENTS.md เข้ามาอยู่ใต้ Linux Foundation#

เรื่องการเมืองสำคัญที่สุดของการเขียนโค้ดด้วย AI ในเดือนพฤษภาคม 2026 ไม่ใช่การเปิดตัวโมเดลใหม่ แต่เป็นการรวมรูปแบบเข้าด้วยกัน ก่อนหน้านี้ผู้ให้บริการแต่ละรายมีไฟล์กฎของตัวเอง ซึ่งสะดวกสำหรับผู้ให้บริการแต่สร้างภาระให้ทีมที่ใช้เครื่องมือหลายรายการ

ในข่าวประชาสัมพันธ์ลงวันที่ 9 ธันวาคม 2025 Linux Foundation ประกาศจัดตั้ง Agentic AI Foundation เพื่อเป็นองค์กรร่มให้กับสามรูปแบบ:

• AGENTS.md จาก OpenAI — รูปแบบไฟล์คำสั่งสำหรับเอเจนต์
• Model Context Protocol (MCP) จาก Anthropic — โปรโตคอลสำหรับเชื่อมต่อเครื่องมือภายนอกกับเอเจนต์
• goose จาก Block — เฟรมเวิร์กเอเจนต์แบบโอเพนซอร์ส

จากข่าวประชาสัมพันธ์ของ Linux Foundation:

“การนำโปรเจ็กต์เหล่านี้มารวมกันภายใต้ร่ม AAIF ช่วยให้พัฒนาได้ด้วยความโปร่งใสและเสถียรภาพที่มีได้จากการกำกับดูแลแบบเปิดเท่านั้น”

(ข่าวประชาสัมพันธ์ของ Linux Foundation, 9 ธันวาคม 2025, แปลจากภาษาอังกฤษ)

ภายในวันที่ 24 กุมภาพันธ์ 2026 มี 146 องค์กรเป็นสมาชิก AAIF (สมาชิกใหม่ 97 รายในสองเดือน) สมาชิก Gold รายใหม่ได้แก่ Red Hat, ServiceNow, Akamai, Lenovo, JPMorgan Chase, Huawei, Hitachi, UiPath, American Express และ Autodesk Anthropic อยู่ในระดับ Platinum และสนับสนุน MCP OpenAI อยู่ในระดับ Platinum และสนับสนุน AGENTS.md ส่วน Block อยู่ในระดับ Platinum พร้อมกับ goose

สิ่งนี้เปลี่ยนสถานะของ AGENTS.md จาก “รูปแบบของ OpenAI” ไปเป็นมาตรฐานอุตสาหกรรม ในฤดูใบไม้ผลิปี 2026 Claude Code ยังไม่ได้เข้าร่วม แต่ในเดือนกันยายนก็เรียนรู้ที่จะอ่าน AGENTS.md เองด้วยเวอร์ชัน 2.1.277 ส่วน CLAUDE.md ยังไม่หายไป และโดยค่าเริ่มต้นก็ยังมีความสำคัญกว่าเมื่ออยู่ในโปรเจ็กต์

จุดเริ่มต้นที่ใช้ได้คือเก็บกฎร่วมของโปรเจกต์ไว้ใน AGENTS.md แล้วเพิ่ม import, wrapper หรือการตั้งค่า read ที่แต่ละไคลเอนต์ต้องการ สำหรับ Claude Code ให้ตรวจเวอร์ชันที่ติดตั้งและลำดับความสำคัญของไฟล์ก่อนตัดสินใจว่าต้องใช้ import ใน CLAUDE.md หรือ symlink หรือไม่ ตรวจการโหลดทุกไคลเอนต์ บทความนี้ไม่ได้ยืนยันเปอร์เซ็นต์ความครอบคลุม

ต่อไปจะเป็นอย่างไร#

AGENTS.md เป็นองค์ประกอบพื้นฐานชิ้นแรกใน “วิธีตกลงกับเอเจนต์เพื่อให้ทำงานได้อย่างคาดการณ์ได้” ต่อมาคือองค์ประกอบชิ้นที่สอง — โฟลเดอร์ความรู้ของโปรเจ็กต์ ซึ่งมีบริบทธุรกิจ กลุ่มเป้าหมาย ผลิตภัณฑ์ และราคา องค์ประกอบชิ้นที่สามคือ context engineering ซึ่งเชื่อมทุกอย่างเข้าด้วยกัน: เอเจนต์เห็นไฟล์ใดในแต่ละขั้นตอน รักษาสถานะระหว่างเซสชันอย่างไร และสลับไปมาระหว่างโมเดลต่าง ๆ อย่างไร

เนื้อหาที่ใช้ได้จริง: เอกสารประกอบของ Ailoot.

เนื้อหาและเครื่องมือเพิ่มเติม: Ailoot.