สร้าง CLAUDE.md ที่ดี

CLAUDE.md คืออะไร? ทำไมโปรเจกต์ของเราต้องมี?

ลองนึกภาพว่าคุณกำลังจะเริ่มงานใหม่ในบริษัทแห่งหนึ่ง ถ้ามี 'คู่มือพนักงานใหม่' ที่บอกรายละเอียดสำคัญของบริษัท เช่น วัฒนธรรมองค์กร, เครื่องมือที่ใช้, หรือแม้กระทั่งข้อห้ามต่าง ๆ จะดีแค่ไหน?

ไฟล์ CLAUDE.md ก็เปรียบเสมือน 'คู่มือพนักงานใหม่' สำหรับ AI อย่าง Claude นั่นเองครับ! มันคือไฟล์ข้อความที่เราจะสร้างขึ้นมาในโปรเจกต์ของเรา เพื่อบอกข้อมูลสำคัญเกี่ยวกับโปรเจกต์ให้ Claude เข้าใจ ยิ่งเราเขียนคู่มือนี้ได้ละเอียดและชัดเจนเท่าไหร่ Claude ก็จะยิ่งทำงานร่วมกับเราได้ตรงใจและมีประสิทธิภาพมากขึ้นเท่านั้นครับ

ข้อมูลสำคัญที่ Claude ต้องรู้: Tech Stack และข้อตกลง (Conventions)

ในคู่มือ CLAUDE.md เราควรบอก Claude ถึง 'เครื่องมือ' และ 'กฎ' พื้นฐานของโปรเจกต์เราครับ

**Tech Stack (เครื่องมือที่ใช้):** ส่วนนี้คือการบอกว่าโปรเจกต์ของเราสร้างด้วยภาษาอะไร? ใช้เฟรมเวิร์กอะไร? และเวอร์ชั่นไหน? เช่น Node 22, TypeScript strict, React 19 + TailwindCSS การบอกสิ่งเหล่านี้ทำให้ Claude รู้ว่าต้องใช้ความรู้ด้านไหนมาช่วยงานเรา

**Conventions (ข้อตกลงและรูปแบบ):** นี่คือ 'กฎ' ที่ทีมเราใช้ในการเขียนโค้ดครับ เช่น การตั้งชื่อตัวแปร (naming convention), รูปแบบการจัดหน้าโค้ด (code style), หรือโครงสร้างการจัดเรียงโฟลเดอร์ในโปรเจกต์ การมีข้อตกลงเหล่านี้ทำให้โค้ดของเราเป็นระเบียบ และ Claude ก็จะเขียนโค้ดได้สอดคล้องกับสไตล์ของเราครับ

ข้อมูลสำคัญที่ Claude ต้องรู้: คำสั่งสำคัญ (Commands) และสิ่งที่ไม่ควรทำ (NEVER)

นอกจากเครื่องมือและกฎแล้ว Claude ยังต้องรู้ 'วิธีทำงาน' และ 'ข้อห้าม' บางอย่างด้วยครับ

**คำสั่งสำคัญ (Commands):** ส่วนนี้คือการบอกคำสั่งพื้นฐานที่เราใช้ในการพัฒนาโปรเจกต์ เช่น คำสั่งสำหรับรันโปรเจกต์ในโหมดพัฒนา (npm run dev), คำสั่งสำหรับทดสอบโค้ด (npm test), หรือคำสั่งสำหรับคอมไพล์โค้ด (build) การบอกสิ่งเหล่านี้ทำให้ Claude สามารถแนะนำหรือรันคำสั่งที่ถูกต้องให้เราได้

**NEVER (สิ่งที่ไม่ควรทำเด็ดขาด):** นี่คือส่วนสำคัญที่บอก Claude ถึงข้อห้ามหรือสิ่งที่เราไม่อยากให้เกิดขึ้นในโปรเจกต์ เช่น 'ห้ามใช้ any ใน TypeScript' หรือ 'ห้าม commit โค้ดโดยไม่รัน test ก่อน' การมีส่วนนี้จะช่วยป้องกันความผิดพลาดและรักษาคุณภาพของโค้ดในโปรเจกต์ของเราครับ

ตัวอย่าง CLAUDE.md และตำแหน่งการจัดเก็บไฟล์

ไฟล์ CLAUDE.md ควรถูกวางไว้ที่ 'ราก' (root) ของโปรเจกต์ของคุณครับ เหมือนกับการวางคู่มือพนักงานใหม่ไว้ที่โต๊ะทำงานของพนักงานใหม่นั่นแหละครับ และชื่อไฟล์ต้องเป็น CLAUDE.md เป๊ะๆ นะครับ (ตัวพิมพ์ใหญ่ทั้งหมด)

นี่คือตัวอย่างง่ายๆ ของไฟล์ CLAUDE.md ที่คุณสามารถนำไปปรับใช้ได้ครับ:

``` # My Awesome Project ## Stack - Node 22, TypeScript strict - React 19 + TailwindCSS ## Commands - dev: npm run dev - test: npm test - build: npm run build ## NEVER - อย่าใช้ 'any' ใน TypeScript - อย่า commit โดยไม่รัน test - อย่าแก้ไฟล์ในโฟลเดอร์ 'node_modules' ```

ให้ Claude ช่วยสร้าง CLAUDE.md ร่างแรกให้เรา

บางทีการเริ่มเขียน CLAUDE.md จากศูนย์ก็อาจจะยากสำหรับมือใหม่ใช่ไหมครับ? ไม่ต้องกังวล! เราสามารถให้ Claude ช่วยสร้างร่างแรกให้เราได้เลยครับ เหมือนมีผู้ช่วยมาเตรียมโครงสร้างคู่มือให้เราก่อน แล้วเราค่อยมาปรับแก้ให้สมบูรณ์

วิธีนี้จะช่วยประหยัดเวลาและทำให้เรามีจุดเริ่มต้นที่ดีครับ หลังจากนั้นเราก็แค่เพิ่มรายละเอียดเฉพาะของโปรเจกต์เราเข้าไป

1. เตรียมโปรเจกต์ของคุณให้พร้อม

   ตรวจสอบให้แน่ใจว่าโปรเจกต์ของคุณมีโครงสร้างไฟล์และโค้ดที่ Claude สามารถอ่านและทำความเข้าใจได้
2. เปิดหน้าต่างแชทกับ Claude

   เข้าไปในแพลตฟอร์มที่คุณใช้ Claude
3. ใช้ Prompt นี้กับ Claude

   พิมพ์หรือคัดลอก Prompt นี้ลงไปในช่องแชท

   พิมพ์ Prompt นี้

   ช่วยอ่านโปรเจกต์นี้แล้วสร้างไฟล์ CLAUDE.md ที่เหมาะสมให้หน่อย ใส่ tech stack, conventions, และคำสั่งสำคัญคัดลอก

สรุป: CLAUDE.md คือเพื่อนคู่คิดที่ช่วยให้ AI ทำงานได้ดีขึ้น

สรุปง่ายๆ ก็คือ CLAUDE.md เป็นเหมือน 'คู่มือการใช้งาน' โปรเจกต์ของเรา ที่เราสร้างขึ้นมาเพื่อให้ Claude เข้าใจรายละเอียดสำคัญๆ ตั้งแต่เครื่องมือที่ใช้, กฎการเขียนโค้ด, คำสั่งที่จำเป็น ไปจนถึงสิ่งที่เราไม่อยากให้ทำเลยครับ

การลงทุนเวลาเขียน CLAUDE.md ให้ดีตั้งแต่แรก จะช่วยให้การทำงานร่วมกับ AI มีประสิทธิภาพมากขึ้น ลดความเข้าใจผิด และทำให้ Claude สามารถให้ความช่วยเหลือเราได้อย่างตรงจุด เหมือนมีเพื่อนร่วมงานที่เข้าใจเราเป็นอย่างดีเลยครับ