AI coding tool ทุกตัวต้องการไฟล์ Markdown พร้อมกฎของโปรเจกต์ของคุณ แต่ทั้งหมดต้องการไฟล์ Markdown ที่แตกต่างกัน

ถ้าคุณใช้ AI tools หลายตัว (และนักพัฒนาส่วนใหญ่ก็ใช้) สิ่งนี้จะทำให้สับสนอย่างรวดเร็ว นี่คือคู่มือที่ครบถ้วนเกี่ยวกับไฟล์ที่คุณต้องการและสิ่งที่อยู่ในแต่ละไฟล์

ไฟล์โดยสรุป

ไฟล์	เครื่องมือ	ตำแหน่ง	ขอบเขต
`AGENTS.md`	Universal (ทุก tool)	Project root	กฎที่ใช้ร่วมกันสำหรับ AI agent ทั้งหมด
`CLAUDE.md`	Claude Code	Project root	คำสั่งเฉพาะ Claude
`.cursor/rules/*.md`	Cursor	`.cursor/rules/` directory	กฎเฉพาะ Cursor
`.github/copilot-instructions.md`	GitHub Copilot	`.github/` directory	คำสั่งเฉพาะ Copilot
`.windsurf/rules`	Windsurf	`.windsurf/` directory	กฎเฉพาะ Windsurf
`JULES.md`	Google Jules	Project root	คำสั่งเฉพาะ Jules

AGENTS.md: มาตรฐานสากล

เหมาะที่สุดสำหรับ: ทีมที่ใช้ AI tools หลายตัว, โปรเจกต์ open source

AGENTS.md เป็นสิ่งที่ใกล้เคียงกับมาตรฐานสากลที่เรามีมากที่สุด ตอนนี้ใช้โดย repository มากกว่า 60,000 แห่งและดูแลโดย Linux Foundation’s Agentic AI Foundation (พร้อมกับ MCP และ goose)

วางคำสั่งที่แชร์ของคุณที่นี่ --- สิ่งที่ AI tool ทุกตัวควรรู้:

โครงสร้างโปรเจกต์และสถาปัตยกรรม
คำสั่ง build และ test
แนวทางสไตล์โค้ด
รูปแบบทั่วไปและ anti-pattern
dependencies และขั้นตอนการติดตั้ง

AI coding tool หลักทุกตัวจะอ่าน AGENTS.md ทำให้เป็นแหล่งความจริงเดียวสำหรับคำสั่ง AI ของโปรเจกต์ของคุณ

CLAUDE.md: หน่วยความจำของ Claude Code

เหมาะที่สุดสำหรับ: ผู้ใช้ Claude Code, ทีมที่ standardize บน Anthropic

CLAUDE.md อ่านโดยอัตโนมัติที่เริ่มต้นทุก Claude Code session รองรับฟีเจอร์เฉพาะ Claude บางอย่างเช่น memory persistence และ session context

ใช้ CLAUDE.md สำหรับ:

การปรับแต่งพฤติกรรมเฉพาะ Claude
ฟีเจอร์ที่ Claude Code สนับสนุนเท่านั้น
Override หรือขยาย AGENTS.md สำหรับ Claude

รูปแบบที่แนะนำ: กฎที่แชร์ใน AGENTS.md, การเพิ่มเติมเฉพาะ Claude ใน CLAUDE.md

.cursorrules / .cursor/rules/: แนวทางของ Cursor

เหมาะที่สุดสำหรับ: ผู้ใช้ Cursor, ทีมที่ใช้ Cursor เป็น IDE หลัก

Cursor เดิมใช้ไฟล์ .cursorrules เดียว จากนั้นพัฒนาเป็น directory .cursor/rules/ สำหรับการควบคุมที่ละเอียดกว่า แต่ละไฟล์ใน directory คือกฎแยกต่างหากที่ Cursor นำไปใช้

ใช้ Cursor rules สำหรับ:

พฤติกรรม agent เฉพาะ Cursor
กฎสำหรับ Composer และ Agent modes ของ Cursor
คำสั่งเฉพาะประเภทไฟล์ (เช่น กฎที่ต่างกันสำหรับ .tsx และ .py)

copilot-instructions.md: แนวทางของ GitHub

เหมาะที่สุดสำหรับ: ผู้ใช้ GitHub Copilot, workflow ที่เน้น GitHub

GitHub Copilot อ่าน .github/copilot-instructions.md สำหรับคำสั่งระดับโปรเจกต์ ปฏิบัติตามแนวทางของ GitHub ในการวางการตั้งค่าใน directory .github/

การตั้งค่าที่แนะนำ

สำหรับโปรเจกต์ส่วนใหญ่ คุณต้องการไม่เกินสองไฟล์:

ถ้าคุณใช้ AI tool เดียว:

ใช้แค่ไฟล์ native ของ tool นั้น (CLAUDE.md สำหรับ Claude Code, .cursor/rules/ สำหรับ Cursor ฯลฯ)

ถ้าคุณใช้ AI tools หลายตัว:

AGENTS.md --- กฎที่แชร์ทั้งหมด (สถาปัตยกรรม คำสั่ง build, แนวทาง)
ไฟล์เฉพาะ tool --- เฉพาะสำหรับฟีเจอร์ที่เป็นเอกลักษณ์ของ tool นั้น

ตัวอย่างโครงสร้าง:

your-project/
  AGENTS.md              # แชร์: build commands, สถาปัตยกรรม, แนวทาง
  CLAUDE.md              # เฉพาะ Claude: ความต้องการหน่วยความจำ, การใช้ tool
  .cursor/rules/style.md # เฉพาะ Cursor: พฤติกรรม composer
  .github/copilot-instructions.md  # เฉพาะ Copilot

สิ่งที่ต้องรวมในกฎของคุณ

จากการวิเคราะห์ repository นับพัน ไฟล์คำสั่งที่มีประสิทธิภาพสูงสุดรวมถึง:

รวมเสมอ:

วิธี build และรันโปรเจกต์
วิธีรัน test
การตัดสินใจสถาปัตยกรรมที่สำคัญ
ความต้องการด้านสไตล์การเขียนโค้ด

มักจะมีประโยชน์:

สิ่งที่ห้ามทำ (คำสั่งเชิงลบทำงานได้ดีอย่างน่าประหลาดใจ)
คำอธิบายโครงสร้างไฟล์
ขั้นตอนการ debug ทั่วไป
คำสั่งจัดการ dependency

ข้าม:

ฟีเจอร์ภาษาที่ชัดเจน
สิ่งที่ AI รู้อยู่แล้ว
กฎที่ละเอียดเกินไป (เริ่มน้อย เพิ่มตามความจำเป็น)

การสร้างกฎ AI ของคุณด้วยบริบทจากเว็บ

การเขียนไฟล์คำสั่ง AI ที่ดีมักต้องอ้างอิงเอกสารภายนอก คู่มือสไตล์ หรือรูปแบบสถาปัตยกรรม นี่คือที่ที่การมีเนื้อหาเว็บในรูปแบบ Markdown ช่วยได้

ตัวอย่างเช่น ถ้าโปรเจกต์ของคุณใช้รูปแบบ API เฉพาะจากหน้าเอกสาร คุณสามารถ:

ใช้ Save เพื่อแปลงหน้าเอกสารนั้นเป็น Markdown
อ้างอิงหรือดึงส่วนที่เกี่ยวข้องใน AGENTS.md ของคุณ
AI coding assistant ของคุณตอนนี้มีบริบทครบถ้วน

เช่นเดียวกันกับเอกสาร framework คู่มือสไตล์ บทความ best practice และวิธีแก้ปัญหา Stack Overflow Markdown ที่สะอาดคือรูปแบบที่ทั้งคุณและ AI tools สามารถทำงานได้อย่างมีประสิทธิภาพสูงสุด

บทสรุป

AI coding rules ecosystem ยังคงพัฒนา แต่รูปแบบชัดเจน: มันทั้งหมดคือ Markdown ไม่ว่าคุณจะใช้ tool หนึ่งหรือห้า คำสั่ง AI ของโปรเจกต์ของคุณอยู่ในไฟล์ Markdown ที่ถูกควบคุมเวอร์ชัน อ่านได้โดยมนุษย์ และแยกวิเคราะห์ได้โดยเครื่อง

เริ่มด้วย AGENTS.md สำหรับกฎสากล เพิ่มไฟล์เฉพาะ tool ตามความจำเป็น และเก็บทุกอย่างให้น้อยที่สุดจนกว่าคุณจะเห็นปัญหาที่เกิดซ้ำที่ควรแก้

Save แปลงหน้าเว็บใดก็ได้เป็น Markdown ที่สะอาด --- เหมาะสำหรับสร้างเนื้อหาอ้างอิงและบริบทเอกสารที่ AI coding assistant ของคุณต้องการ ลอง Save ฟรี