คนที่ต้องสลับทำงานระหว่าง AI coding agent หลายตัวในโปรเจกต์เดียวกันน่าจะคุ้นเคยกับปัญหานี้ดี ในทีมเดียวกัน คนหนึ่งถนัดใช้ Claude Code อีกคนชอบใช้ Cursor ส่วนใน CI ก็มี Copilot คอยรีวิวโค้ด แต่ละเครื่องมืออ่านไฟล์คอนฟิกคนละชื่อกันทั้งหมด ไม่ว่าจะเป็น Claude Code ที่อ่าน CLAUDE.md, Cursor ที่อ่าน .cursorrules, Copilot ที่อ่าน .github/copilot-instructions.md หรือ Codex ที่อ่าน AGENTS.md พอปรับแก้กฎการพัฒนาทีหนึ่ง ก็ต้องตามไปแก้ให้ครบทุกไฟล์ ถ้าลืมไฟล์ไหนไป กฎของแต่ละเครื่องมือก็เริ่มไม่ตรงกันทันที

ai-rules-sync คือ CLI ขนาดกะทัดรัดที่สร้างขึ้นมาแก้ปัญหานี้โดยตรง แนวคิดหลักเรียบง่ายและตรงไปตรงมา คือเขียนกฎไว้ที่ AGENTS.md เป็นไฟล์ต้นทางเพียงจุดเดียว แล้วให้เครื่องมือแปลงไฟล์นั้นไปเป็นคอนฟิกของ agent ตัวอื่นทั้งหมดโดยอัตโนมัติ แก้ไขรอบเดียวที่เดียว เครื่องมือทุกตัวก็ได้กฎชุดเดียวกันทันที

ปัญหาไฟล์กฎเพี้ยนแบบไม่รู้ตัว

ต้นตอของปัญหาไม่ได้อยู่ที่การเขียนกฎ แต่อยู่ที่การดูแลรักษาให้ทุกไฟล์ตรงกันอยู่เสมอ เมื่อกฎชุดเดียวกันต้องกระจายอยู่ในหลายไฟล์ การซิงก์ด้วยตัวเองก็กลายเป็นการคัดลอกและวางซ้ำๆ ทุกครั้งที่มีการเปลี่ยนข้อตกลงในทีม

เมื่อทำงานไปเรื่อยๆ โอกาสตกหล่นก็เกิดขึ้นได้ง่าย เช่น แก้ไข CLAUDE.md แล้วลืมอัปเดต .cursorrules ส่งผลให้ agent แต่ละตัวทำงานตามกฎคนละเวอร์ชัน บางตัวรู้ว่าห้าม commit เข้า main โดยตรง แต่บางตัวไม่รู้ ความคลาดเคลื่อนแบบนี้มักไม่มี error แจ้งเตือนให้เห็น กว่าจะรู้ตัวก็ต่อเมื่อเกิดปัญหากับโค้ดในโปรเจกต์แล้ว

เขียนต้นทางไฟล์เดียว ที่เหลือแปลงให้อัตโนมัติ

หัวใจของ ai-rules-sync คือการยกให้ AGENTS.md เป็น Single Source of Truth เพียงไฟล์เดียว ส่วนไฟล์ของ agent ตัวอื่นทั้งหมดถือเป็นไฟล์ผลลัพธ์ที่สร้างขึ้นจากต้นทาง ไม่ใช่ไฟล์ที่ต้องเข้าไปแก้ไขเองโดยตรง

เบื้องหลังการทำงานไม่ใช่แค่การคัดลอกข้อความธรรมดา แต่ตัว CLI จะอ่านและแปลงกฎทั้งหมดให้อยู่ในโครงสร้างกลาง แยกหัวข้อ เนื้อหากฎ ขอบเขตไฟล์ และข้อห้ามต่างๆ อย่างเป็นระบบ จากนั้นจึง render ออกมาเป็นรูปแบบที่ตรงตามไวยากรณ์ของแต่ละ agent ทำให้ได้กฎชุดเดียวกันในรูปแบบที่แต่ละเครื่องมืออ่านเข้าใจได้อย่างสมบูรณ์

นอกจากนี้ยังช่วยจัดระเบียบข้อความให้อัตโนมัติ หากไฟล์กฎเดิมเป็นข้อความยาวติดต่อกันโดยไม่มีหัวข้อ ตัวแปลงจะวิเคราะห์ความหมายแล้วจัดเข้าหมวดหมู่อย่างเหมาะสม เช่น บรรทัดคำสั่งจะถูกจัดไปอยู่หมวด Build & test commands, ข้อแนะนำเรื่องสไตล์โค้ดจะไปอยู่ที่ Code style และข้อห้ามต่างๆ จะแยกไปอยู่ที่ Do not

กฎที่แปลงไม่ได้ จะแจ้งเตือนทันที

จุดที่ทำให้เครื่องมือซิงก์กฎทั่วไปใช้งานจริงได้ยาก คือแต่ละแพลตฟอร์มมีฟีเจอร์เฉพาะของตัวเอง เช่น Cursor มี glob และ frontmatter ในขณะที่ Claude มี @path สำหรับการ import ไฟล์ ซึ่งฟีเจอร์เหล่านี้ไม่มีรูปแบบที่เทียบเคียงได้ในเครื่องมืออื่น

ai-rules-sync จัดการเรื่องนี้อย่างตรงไปตรงมา เมื่อเจอกฎที่ไม่สามารถแปลงข้ามระบบได้ เครื่องมือจะแสดงข้อความแจ้งเตือน (warning) ให้เห็นชัดเจน แทนที่จะตัดทิ้งไปเงียบๆ การแจ้งเตือนตรงๆ ช่วยให้เราทราบข้อจำกัดได้ทันที และปลอดภัยกว่าการปล่อยให้กฎหายไปโดยไม่รู้ตัว

เริ่มต้นง่ายๆ ด้วยคำสั่งเดียว

วิธีเริ่มต้นที่สะดวกที่สุดคือการรันคำสั่ง agentsync setup ในโฟลเดอร์โปรเจกต์ ซึ่งคำสั่งนี้จะจัดการสามขั้นตอนหลักให้พร้อมกันทันที:

1. สแกนโปรเจกต์แล้วสร้าง AGENTS.md ให้จากไฟล์กฎเดิมที่มีอยู่
2. สร้างไฟล์คอนฟิก agentsync.json พร้อมซิงก์ออกไปยังทุกฟอร์แมตรอบแรกให้เสร็จสรรพ
3. ติดตั้ง Git pre-commit hook เพื่อตรวจสอบและซิงก์ไฟล์กฎให้ตรงกันโดยอัตโนมัติทุกครั้งที่ commit

หลังจากนั้น หน้าที่ของเราเหลือเพียงขั้นตอนเดียว คือแก้ไขกฎใน AGENTS.md แล้วสั่ง commit ตามปกติ ไฟล์คอนฟิกของ agent ตัวอื่นจะอัปเดตตามให้เอง ไม่จำเป็นต้องจำว่าต้องตามแก้ไฟล์ไหนบ้างอีกต่อไป

สำหรับการติดตั้ง สามารถลงแบบ global ด้วยคำสั่ง npm install -g @panishandsome/agentsync หรือเรียกใช้งานผ่าน npx @panishandsome/agentsync --help ได้ทันทีโดยไม่ต้องติดตั้งลงเครื่อง

หากต้องการดูตัวอย่างการแปลงไฟล์ก่อนนำมาใช้ในโปรเจกต์ สามารถเข้าไปทดลองใช้งานได้ที่ playground บนเว็บ เพียงวางเนื้อหากฎต้นทางไว้ฝั่งซ้าย ระบบจะแสดงผลลัพธ์ที่แปลงแล้วทางฝั่งขวาทันที การประมวลผลทั้งหมดเกิดขึ้นบนเบราว์เซอร์ในเครื่องของเราโดยตรง ไม่มีการส่งข้อมูลขึ้นเซิร์ฟเวอร์ภายนอก

ปรับแต่งและควบคุมการทำงานได้เอง

สำหรับทีมที่ไม่ต้องการใช้งานผ่าน Git hook ตัว ai-rules-sync ก็เปิดให้ควบคุมขั้นตอนการซิงก์ได้เองทั้งหมด เริ่มต้นด้วยคำสั่ง agentsync sync --init เพื่อสร้างไฟล์ agentsync.json ที่ระบุไฟล์ต้นทางและปลายทาง จากนั้นเลือกรูปแบบการทำงานที่ต้องการ:

• agentsync sync สั่งประมวลผลและซิงก์ไฟล์เมื่อต้องการ
• agentsync sync --watch ซิงก์ไฟล์ให้อัตโนมัติทุกครั้งที่มีการบันทึก เหมาะสำหรับช่วงที่กำลังปรับแต่งกฎอย่างต่อเนื่อง
• agentsync sync --check ตรวจสอบความถูกต้องโดยไม่แก้ไขไฟล์ หากพบว่าไฟล์ไม่ตรงกันจะคืนค่า exit code ไม่เท่ากับศูนย์ เหมาะสำหรับนำไปใส่ใน CI pipeline เพื่อป้องกันไฟล์กฎคลาดเคลื่อนหลุดเข้า repository

นอกจากนี้ยังมีโหมด agentsync sync --auto ที่ช่วยบันทึกสถานะไฟล์ล่าสุดไว้ใน .agentsync-state.json เพื่อตรวจสอบว่าไฟล์ไหนมีการเปลี่ยนแปลงล่าสุด แล้วนำไฟล์นั้นมาเป็นต้นทางในการอัปเดตไฟล์อื่น แต่หากพบว่ามีการแก้ไขหลายไฟล์พร้อมกัน ระบบจะหยุดและขอให้เราระบุ --source <ไฟล์> อย่างชัดเจน เพื่อป้องกันการเขียนทับกฎผิดพลาด

รวมกฎเดิมที่มีอยู่แล้วเข้ามาเป็นต้นทางเดียว

สำหรับโปรเจกต์ที่มีไฟล์กฎกระจัดกระจายอยู่เดิม สามารถใช้คำสั่ง agentsync merge เพื่อรวมไฟล์เข้าด้วยกัน เช่น agentsync merge CLAUDE.md .cursorrules -o AGENTS.md คำสั่งนี้จะรวบรวมเนื้อหาทั้งหมดมารวมไว้ใน AGENTS.md เพียงไฟล์เดียว ช่วยให้เริ่มต้นเป็น Single Source of Truth ได้ทันทีโดยไม่ต้องพิมพ์ใหม่

ส่วนโปรเจกต์ใหม่ที่เริ่มต้นจากศูนย์ สามารถใช้คำสั่ง agentsync generate เพื่อสร้างโครง AGENTS.md จากการระบุข้อมูลพื้นฐาน เช่น ชื่อโปรเจกต์ ภาษา เฟรมเวิร์ก และเครื่องมือทดสอบ

ตัวโปรเจกต์ ai-rules-sync เองก็ใช้วิธีนี้ในการจัดการ repository ของตัวเอง โดยไฟล์ AGENTS.md สร้างขึ้นผ่านคำสั่ง agentsync generate ทำให้ AI coding agent ที่เข้ามาช่วยพัฒนาเข้าใจบริบทและข้อตกลงของโปรเจกต์ตั้งแต่เริ่มต้น

เบาเครื่อง ไร้ dependency เพิ่มเติม

จุดเด่นอีกข้อของ ai-rules-sync คือการเป็นแพ็กเกจแบบ zero-dependency ที่ไม่ดึงไลบรารีอื่นเข้ามาเพิ่มในโปรเจกต์ กลไกหลักที่ใช้ใน CLI เป็นชุดเดียวกับที่รันบน web playground จึงทำงานได้รวดเร็ว คาดเดาผลลัพธ์ได้แม่นยำ และเหมาะอย่างยิ่งสำหรับการใส่เข้าไปใน workflow ประจำวัน

อย่างไรก็ตาม การนำเครื่องมือนี้มาใช้มีข้อตกลงร่วมกันในทีมว่า ทุกคนต้องแก้ไขกฎที่ AGENTS.md เท่านั้น หากมีใครเผลอไปแก้ไขไฟล์ปลายทางอย่าง CLAUDE.md โดยตรง การซิงก์ครั้งถัดไปจะเขียนทับการเปลี่ยนแปลงนั้นทันที

เมื่อทีมปรับการทำงานให้สอดคล้องกันได้ ประโยชน์ที่ได้รับคือกฎของ AI agent ทุกตัวจะตรงกันอย่างสมบูรณ์ตลอดเวลา โดยไม่ต้องคอยกังวลหรือเสียเวลาตรวจเช็กด้วยตัวเองอีกต่อไป

---

ที่มา: ai-rules-sync จาก GitHub