long-term-memory

name	long-term-memory
description	Manages cross-session tiered memory (L1/L2/L3) and compaction logic to maintain performance over long durations.

Long-Term Memory: Compaction & Cross-Session Continuity

This skill manages the transition of data through different "memory tiers" and uses background compaction (Cron logic) to ensure the agent remains efficient over hundreds of sessions.

หน่วยความจำ 3 ชั้น (Tiered Architecture)

Tier	Name	Storage	Strategy
L1	Hot Context	Active Context Window	Verbatim (Full history of last 10-20 turns)
L2	Warm Memory	MEMORY.md / Summaries	Condensed (Key facts, project status, active tasks)
L3	Cold Storage	Archived Files / Vector DB	Indexed (Searchable records, historical logs)

ขั้นตอนการจัดการ (Workflow)

1. การสรุปผลแบบลำดับชั้น (Hierarchical Summarization)

• เมื่อ Context ใน L1 เริ่มหนาแน่น ให้สรุป (Summarize) เนื้อหาลงใน L2
• รักษาโครงสร้าง "State" (เช่น "ผู้ใช้ย้ายงานไปที่โฟลเดอร์ X แล้ว") ให้ชัดเจนใน L2 เสมอ

2. การบีบอัดข้อมูลข้ามเซสชั่น (Cross-session Compaction)

• ใช้หลักการ Cron Logic (ทำซ้ำตามรอบเวลา):
  • ทุก 24 ชั่วโมง: ตรวจสอบความซ้ำซ้อนใน MEMORY.md
  • ทุก 7 วัน: ย้ายข้อมูลที่ไม่ได้ถูกเรียกใช้นาน ๆ ไปยัง L3
• Action: รวมบันทึกที่กระจัดกระจาย (Fragmentation) ให้เป็นระเบียบ

3. การเพิ่มประสิทธิภาพบริบท (Context Optimization)

• Hub-and-Stub: ใช้ AGENTS.md เป็นตัวเชื่อม และโหลดเฉพาะบริบทที่จำเป็น (Scoped Context) ตาม Directory ที่ทำงานอยู่
• Entity Tracking: ติดตามสถานะของ Entity (Project, Bug, Task) แทนการอ่านประวัติแชททั้งหมด

การตั้งค่ารอบการทำงาน (Scheduled Tasks)

• compaction run: สั่งให้ระบบบีบอัดหน่วยความจำทันที
• memory migrate: ย้ายข้อมูลจาก L1/L2 ไปยัง L3 เพื่อเตรียมเริ่ม Session ใหม่ที่สะอาด (Fresh Start)

ประโยชน์ที่ได้รับ

• No Lost-in-the-Middle: ลดปัญหา AI สับสนเมื่อมี Context ยาวเกินไป
• Cost Reduction: ประหยัดค่า Token อย่างมหาศาลในการรันโปรเจกต์ระยะยาว
• Consistency: รักษาความสม่ำเสมอของข้อเท็จจริงข้ามวัน/ข้ามสัปดาห์