TheElephantCoder/memory-sync

메모리 동기화

세션이 빈 상태로 시작되지 않도록 합니다.

구조

memory/
  MEMORY.md        # 선별된, 항상 로드됨, 8k 이하 유지
  SOUL.md          # 에이전트의 정체성
  USER.md          # 사용자 정보
  sessions/        # 원시 세션별 노트, 약 30일 후 정리됨
  decisions/       # 짧은 ADR들
  tiers/
    hot.md         # 항상 로드됨
    warm.md        # 키워드가 일치하면 로드됨
    cold/          # 명시적으로 읽기 전용

생명주기

시작: MEMORY.md와 tiers/hot.md를 읽습니다. 작업이 일치하면 warm.md도 읽습니다. 기록을 깊이 파지 않는 한 sessions/는 읽지 않습니다. 총 15초 이내여야 합니다.

종료: harness memory sync를 실행하거나 종료 훅이 이를 수행하도록 합니다. 세션 로그를 MEMORY.md로 정리하고, 오래된 내용을 가지치기하며, 실제 결정을 내렸다면 ADR을 추가합니다.

팁

• MEMORY.md는 선별 저장소이며, 단순 추가 전용이 아닙니다. 8k 토큰 미만으로 유지하고, 외과적으로 편집하세요.
• 두 가지 이상의 접근 방식을 고려하고 하나를 선택했다면 decisions/ADR-###.md를 짧게 작성하세요.
• 메모리에 비밀 정보를 저장하지 마세요. 어차피 삭제 처리됩니다.

명령어:

harness memory show
harness memory edit
harness memory prune --dry-run
harness memory sync --auto