สิ่งที่แพงที่สุดเกี่ยวกับการทำงานกับเอเจนต์คือการอธิบายบริบทซ้ำๆ ทุกเช้าคุณต้องอธิบายการตัดสินใจเมื่อวานซ้ำ, วางข้อความ commit ล่าสุด, สร้างความเข้าใจใหม่ว่าบั๊กใดที่ขัดขวางการ deploy คูณด้วยทุกเซสชัน ค่าใช้จ่ายที่ซ่อนอยู่คือหลายชั่วโมงต่อสัปดาห์ ไม่ใช่หลายนาที
STATE.md ช่วยลดภาระนั้น ไฟล์เดียว อัปเดตเมื่อสิ้นสุดทุกเซสชัน โหลดเมื่อเริ่มต้นเซสชันถัดไป ระเบียบวินัย: ก่อนที่คุณจะปิดเซสชัน ใช้เวลาสามนาทีในการอัปเดตไฟล์ พรุ่งนี้ สามนาทีนั้นจะช่วยประหยัดเวลาได้ยี่สิบนาที
STATE.md เก็บสามสิ่งเท่านั้น ไม่มีอะไรมากไปกว่านั้น
การตัดสินใจ: สิ่งที่คุณตัดสินใจและเหตุผล หากไม่มีเหตุผล ตัวคุณในอนาคตจะเปิดการตัดสินใจนั้นอีกครั้ง "Postgres triggers แทน cron สำหรับ daily digest: triggers เป็น transactional, cron แข่งกับ write path"
ที่กำลังดำเนินการ: สิ่งที่ทำไปครึ่งหนึ่ง เฉพาะเจาะจงพอที่จะส่งต่อได้ "Migration 014 เขียนที่ /migrations/014_add_subscription_columns.sql แต่ยังไม่ได้ apply ต้องรันก่อน webhook handler จะเริ่มทำงาน"
ปัญหาที่ขัดขวาง: สิ่งที่หยุดการทำงานไปข้างหน้า รวมถึงสิ่งที่คุณลองทำแล้ว "ลายเซ็น Stripe webhook ล้มเหลวใน test env ลองใช้ raw body parser แล้ว แต่ยังคงเป็น 400 ถัดไป: ตรวจสอบ env var ใน Vercel preview"
จำกัดไว้ที่ 60-80 บรรทัด เมื่อมีบางอย่างแก้ไขได้ ให้ลบออก เมื่อมีบางอย่างถูกส่งมอบ ให้เก็บถาวร
ระเบียบวินัยในการอัปเดต เพิ่ม Stop hook เพื่อเตือนตัวเอง:
{
"hooks": {
"Stop": [
{
"command": "echo 'Before you close: update STATE.md with decisions, in-flight, and blockers from this session.'"
}
]
}
}แค่การเตือนไม่พอ; นิสัยต้องเป็นไปโดยอัตโนมัติ วิธีที่เร็วที่สุด: ทำติดต่อกันห้าเซสชัน เมื่อถึงเซสชันที่หก คุณจะรู้สึกผิดที่จะปิดโดยไม่อัปเดต ความรู้สึกไม่สบายใจนั้นคือสัญญาณว่านิสัยได้ก่อตัวขึ้นแล้ว
MEMORY.md คือดัชนีสำหรับทุกสิ่งที่คงทน แต่ละรายการคือหนึ่งบรรทัดที่ชี้ไปยังไฟล์แยกต่างหาก มีสี่ประเภท:
user_*: ข้อเท็จจริงถาวรเกี่ยวกับคุณ: เขตเวลา, บริบทอาชีพ, ความชอบ user_location.md
feedback_*: กฎที่เรียนรู้จากข้อผิดพลาด พร้อมช่องความมั่นใจ เริ่มต้นที่ 0.3, เพิ่มเป็น 0.5 เมื่อรูปแบบเกิดขึ้นซ้ำ, เลื่อนขั้นเป็น CLAUDE.md ที่ 0.9+ feedback_public_endpoints_need_rate_limits.md
project_*: สถานะและข้อตัดสินใจที่มีวันที่สำหรับหนึ่งโปรเจกต์ เก็บถาวรเมื่อส่งมอบ project_stripe_integration_2026_05.md
reference_*: ตารางค้นหาสำหรับบุคคล, เครื่องมือ, APIs reference_neon_db_config.md
แต่ละบรรทัดดัชนีควรมีความยาวไม่เกิน 200 ตัวอักษร และดัชนีไม่เกิน 200 บรรทัด หากเกินกว่านั้น รายการจะถูกตัดทอนและ Claude จะมองไม่เห็น
STATE.md สำหรับตอนนี้ MEMORY.md สำหรับตลอดไป กฎง่ายๆ: ถ้าคุณจะพูดในการประชุม standup มันจะอยู่ใน STATE.md ถ้าคุณจะเขียนใน wiki หรือเอกสารแนะนำ มันจะอยู่ในไฟล์หน่วยความจำ การประชุม standup เป็นชั่วคราว; wikis เป็นถาวร
เมื่อโปรเจกต์ถูกส่งมอบและ STATE.md ยังคงมีห้าบรรทัดเกี่ยวกับมัน ให้ย้ายบรรทัดเหล่านั้นไปยังไฟล์หน่วยความจำ project_* ที่มีวันที่และล้างออก โปรเจกต์ไม่ได้หยุดสำคัญ; มันหยุดเป็นปัจจุบัน ความแตกต่างนี้ทำให้ STATE.md มีประโยชน์
เขียนสถานะ ไม่ใช่วารสาร รายการวารสาร: "ทำงานเกี่ยวกับการรวม Stripe มันยุ่งยาก" รายการสถานะ: "Webhook endpoint ที่ app/api/webhooks/stripe/route.ts การตรวจสอบลายเซ็นทำงานได้ในเครื่อง แต่ล้มเหลวใน Vercel preview (รูปแบบ raw body ผิด) ถัดไป: ตรวจสอบการกำหนดค่า rawBody middleware" หนึ่งให้จุดเริ่มต้นสำหรับเซสชันถัดไป; อีกหนึ่งให้บันทึกความทรงจำ
รูปแบบที่ไม่ดีอีกสองอย่าง: รายการที่กำลังดำเนินการโดยไม่มีการดำเนินการถัดไปที่เป็นรูปธรรมที่เซสชันใหม่สามารถดำเนินการได้ และรายการซ้ำสำหรับหัวข้อเดียวกันข้ามเซสชัน รวมรายการซ้ำ: หนึ่งหัวข้อ, หนึ่งรายการ, สถานะปัจจุบันเท่านั้น
การอัปเดตเซสชันที่ดีคือเก้าถึงสิบสองบรรทัด: หนึ่งการตัดสินใจพร้อมเหตุผล, หนึ่งรายการที่กำลังดำเนินการพร้อมขั้นตอนถัดไป, หนึ่งปัญหาที่ขัดขวางพร้อมสิ่งที่คุณลองทำแล้ว
การขยายขนาดเกิน 50 ไฟล์หน่วยความจำ: ชั้นสรุป (digest layer) แต่ละบรรทัดตัวชี้ MEMORY.md มีค่าใช้จ่ายประมาณ 100-150 โทเค็น ที่ 200 บรรทัด นั่นคือ 20-30K โทเค็นของตัวชี้ล้วนๆ วิธีแก้ไข: STRATEGY-DIGEST.md, สรุป 2-3 ประโยคของเอกสารหลักทุกฉบับ พร้อมช่อง "ใช้เมื่อ:" (Use when:)
## q2-positioning.md
Q2 positioning targets AI enablement in mid-market sales orgs.
Use when: discussing target customer, pricing, or lead qualification.Claude อ่านสรุป (ประมาณ 3K โทเค็น) และโหลดเอกสารฉบับเต็มเมื่อเกี่ยวข้องเท่านั้น ที่ 25 เอกสารกลยุทธ์ นั่นคือ 3K โทเค็นแทนที่จะเป็น 50K ช่อง "ใช้เมื่อ:" (Use when:) คือกลไกการกำหนดเส้นทาง: เขียนเป็นเงื่อนไขการเรียกใช้ที่เฉพาะเจาะจง ไม่ใช่คำอธิบายของไฟล์
STATE.md บันทึกสถานะปัจจุบัน (การตัดสินใจ, สิ่งที่กำลังดำเนินการ, ปัญหาที่ขัดขวาง) ไม่เกิน 80 บรรทัด; อัปเดตเมื่อสิ้นสุดเซสชันและเก็บถาวรประวัติทันที MEMORY.md จัดทำดัชนีความรู้ที่คงทนในสี่ประเภท (ผู้ใช้, ข้อเสนอแนะ, โปรเจกต์, การอ้างอิง) จำกัดที่ 200 บรรทัด เริ่มคืนนี้ด้วยสามบรรทัด: หนึ่งการตัดสินใจ, หนึ่งรายการที่กำลังดำเนินการ, หนึ่งปัญหาที่ขัดขวาง สามบรรทัดดีกว่าศูนย์ในขณะที่นิสัยกำลังก่อตัวขึ้น