Agent Dev Thai Academyprinciples · patterns · architecture

CLAUDE.md ยาวขึ้นเรื่อยๆ แล้วมันทำตามน้อยลง

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

โพสต์ที่ดังที่สุดของเพจนี้ คือโพสต์ที่บอกให้เพิ่มกฎลง CLAUDE.md

เดือนที่แล้ว engineer ของ Anthropic โพสต์ว่าทีมเขาลบ system prompt ของ Claude Code ออกไปประมาณ 80% สำหรับโมเดลรุ่นใหม่

คนที่สร้างเครื่องมือนี้ เดินไปคนละทางกับที่ผมสอน


ลองเปิดไฟล์ตัวเองดูก่อน

CLAUDE.md ของหลายคนตอนนี้ยาวเป็นร้อยบรรทัด เพิ่มมาเรื่อยๆ ทุกครั้งที่ AI ทำอะไรไม่ถูกใจ

แล้วมันทำตามน้อยลง ไม่ใช่มากขึ้น

อาการที่เจอกันคือ สั่งอะไรไปมันทำครึ่งเดียว กฎข้อที่ 3 มันจำได้ ข้อที่ 14 เหมือนไม่เคยอ่าน


เหตุผลไม่ได้ลึกลับอะไร

กฎทุกข้อที่เพิ่มเข้าไป มันแย่งความสนใจกับกฎข้ออื่น

ไฟล์ 20 บรรทัดที่ทุกข้อสำคัญ กับไฟล์ 200 บรรทัดที่ 30 ข้อสำคัญ อันหลังไม่ได้ให้ผลดีกว่า มันเจือจางกว่า

เขียนกฎเพิ่มมันรู้สึกเหมือนกำลังแก้ปัญหา เพราะได้ลงมือทำอะไรสักอย่าง แต่สิ่งที่เกิดขึ้นจริงคือเราเพิ่ม noise ให้ตัวเอง


ของที่เอาไปใช้ได้เลย คือ pass ตัดทิ้ง

เปิด CLAUDE.md แล้วไล่ทีละข้อ ตัดตามนี้

หนึ่ง กฎที่มันทำอยู่แล้วโดยไม่ต้องบอก เช่น เขียนโค้ดให้อ่านง่าย ตั้งชื่อตัวแปรให้สื่อความหมาย พวกนี้ตัดทิ้งได้หมด

สอง กฎที่นึกไม่ออกว่าเคยพังยังไง ถ้าจำไม่ได้ว่าเขียนข้อนี้เพราะอะไร แปลว่ามันไม่ได้มาจากปัญหาจริง

สาม กฎที่พูดเรื่องเดียวกับอีกข้อ รวมให้เหลือข้อเดียว

สี่ กฎที่เป็นรสนิยม ไม่ใช่ความถูกต้อง ย้ายไปไว้ที่อื่น ไม่ต้องอยู่ในไฟล์ที่ AI อ่านทุกรอบ

ห้า กฎที่ยาวเกินสองบรรทัด บีบให้สั้นลง ยาวกว่านั้นมันจะอ่านผ่าน


ถ้าไล่ไม่ไหว ใช้คำถามเดียวนี้กับทุกข้อ

ถ้าลบข้อนี้ทิ้ง มันจะทำอะไรผิดขึ้นมาบ้าง

ตอบเป็นเรื่องที่เคยเกิดขึ้นจริงได้ เก็บไว้

ตอบไม่ได้ หรือตอบว่าน่าจะดีกว่าถ้ามี ลบ


ข้อควรระวังข้อเดียว

อย่าตัดทีเดียวหมดแล้วปิดเครื่อง

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

ไฟล์ที่ผ่านการตัดแล้วเติมกลับ ต่างจากไฟล์ที่มีแต่เติมอย่างเดียว


สรุป

เพิ่มกฎมันง่ายกว่าลบกฎ เพราะเพิ่มแล้วรู้สึกว่าได้ทำอะไร ส่วนลบแล้วรู้สึกเหมือนยอมแพ้

แต่ไฟล์ที่สั้นและทุกบรรทัดมีเหตุผล มันได้ผลกว่าไฟล์ยาวที่เต็มไปด้วยของเผื่อไว้

เปิดไฟล์ตัวเองตอนนี้ นับดูว่ามีกี่ข้อ แล้วลองตอบคำถามข้างบนกับสามข้อแรกที่สะดุดตา

ถ้าตอบไม่ได้สักข้อ นั่นแหละคือจุดที่เริ่ม