Communitygithub.com

Tree Ring Memory

프레임워크에 종속되지 않고 로컬 우선인 AI 에이전트 메모리 생애 주기 관리: Rust CLI, SQLite/FTS 기반 회상, 망각, 감사, 통합, DOX/Revolve 어댑터, TUI 지원.

Tree Ring Memory란 무엇인가요?

Tree Ring Memory는 AI 에이전트를 위한 생애 주기 인식 메모리 레이어로, 단순한 대화 기록 덤프가 아니라 의미 있는 학습을 나이테처럼 구조화하여 저장합니다. 신선한 작업은 세부적으로 유지되고, 오래된 학습은 압축되어 안정적인 고리(ring)로 변환되며, 중요한 경고는 흉터(scar)로 남고, 내구성 있는 진리는 심재(heartwood)가 됩니다. 또한 민감한 데이터는 차단, 편집 또는 기본적으로 제외됩니다. 이 스킬은 Claude Code, Cursor, Codex 등 모든 AI 에이전트 플랫폼에서 사용할 수 있으며, Rust로 작성된 CLI를 통해 SQLite/FTS 기반의 회상, 망각, 감사, 통합 기능을 제공합니다. DOX 및 Revolve 어댑터를 통해 프로젝트 문서와 평가 결과를 메모리로 동기화할 수 있으며, TUI를 통해 사용자에게 메모리 상태를 시각적으로 표시합니다. 핵심 원칙은 에이전트가 자율적으로 메모리를 수집하지 않고, 사용자 지시나 소스 증거에 기반하여 명시적으로 CLI 명령을 호출해야 한다는 것입니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add TerminallyLazy/Tree-Ring-Memory

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Tree Ring Memory은(는) 무엇을 하나요?

Tree Ring Memory를 대화 기록 덤프가 아닌 생애 주기 인식 메모리 레이어로 사용하세요.

Tree Ring Memory는 나이테처럼 의미 있는 에이전트 학습을 보존합니다:

  • 새로운 작업은 자세하게 유지됩니다.
  • 오래된 학습은 안정적인 나이테로 압축됩니다.
  • 중요한 경고는 흉터로 남아 보입니다.
  • 내구성 있는 진리는 심재(heartwood)가 됩니다.
  • 추측성 미래 작업은 씨앗(seed)으로 남습니다.
  • 민감한 데이터는 기본적으로 차단, 편집 또는 제외됩니다.

회상 시기

다음과 같은 경우 메모리를 회상하세요:

  • 프로젝트를 시작하거나 재개할 때
  • 아키텍처, 스토리지, 보안, 프라이버시, 또는 릴리스 동작을 변경할 때
  • 이전 실패가 중요할 수 있는 워크플로우를 반복할 때
  • 사용자 수정에 응답할 때
  • 이전 선호도 또는 제약 조건에 의존하는 결정을 내릴 때
  • Tree Ring Memory 또는 AGENTS.md 계약이 있는 저장소의 파일을 편집할 때
  • 의미 있는 작업을 마무리하고 무엇을 기억해야 할지 결정할 때

가능하면 프로젝트 범위와 함께 좁은 질의를 사용하세요. 소스에 연결되고 신뢰도가 높으며 대체되지 않은 결과를 선호하세요.

기억 시기

정보가 향후 작업에 도움이 될 것으로 예상될 때 메모리를 저장하세요:

  • 사용자가 내구성 있는 선호도를 명시할 때
  • 사용자가 에이전트를 수정할 때
  • 결정이 내려지고 현재 세션 이후에도 유지되어야 할 때
  • 구현 교훈이 테스트나 프로덕션 동작에 의해 검증될 때
  • 실패한 접근 방식을 반복해서는 안 될 때
  • 보안, 프라이버시, 릴리스 또는 데이터 손실 경고가 나타날 때
  • 유용한 프로젝트 규칙이 발견될 때
  • 나중에 다시 검토해야 할 미래 아이디어가 있을 때

메모리는 간결하게 유지하세요. 전체 대화가 아닌 교훈, 결정 또는 경고를 저장하세요.

교훈이 평가, 체크포인트, 실험, 브랜치, 인시던트 또는 검토된 실행 아티팩트에서 비롯된 경우 일반 remember 대신 tree-ring evidence를 사용하세요.

프로젝트 아티팩트에 이미 구조화된 지침이나 평가 결과가 포함된 경우 소스 어댑터를 사용하세요:

tree-ring dox sync --source-root . --dry-run
tree-ring revolve sync --source-root revolve --dry-run
tree-ring integrations scan --source-root .

어댑터 명령은 먼저 --dry-run으로 실행하세요. 간결하고 소스에 연결된 요약만 동기화하세요. 가져온 메모리를 소스 AGENTS.md, Revolve 기록, 평가, PR, 이슈 또는 테스트 아티팩트보다 더 권위 있는 것으로 취급하지 마세요.

로컬 설치에서 제공하는 정확한 CLI 명령을 사용하세요:

tree-ring --help
tree-ring dox sync --help
tree-ring revolve sync --help
tree-ring evidence --help

프로젝트가 프로젝트 로컬 바이너리로 초기화된 경우 생성된 .tree-ring/CLI.md 참조를 선호하고 필요할 때 --root .tree-ring을 포함하세요.

이 스킬이 하네스 네이티브 브리지 파일을 통해 로드된 경우 해당 브리지를 포인터로만 취급하세요. 명령이 설치된 프로젝트 루트와 일치하도록 프로젝트 로컬 .tree-ring/SKILL.md 및 .tree-ring/CLI.md가 있을 때 이를 읽으세요. 사용자가 명시적으로 구성하지 않는 한 글로벌 Tree Ring 설정이 현재 저장소에 적용된다고 가정하지 마세요.

증거 결과 매핑:

  • promoted: 지원되는 증거로부터의 내구성 있는 심재
  • rejected: 재사용 가능한 실패 또는 롤백된 접근 방식에 대한 흉터
  • deferred: 유망하지만 해결되지 않은 옵션에 대한 씨앗
  • observed: 바깥쪽 고리 평가 결과

고리 선택

다음 고리를 사용하세요:

  • cambium: 활성 또는 최근 작업 컨텍스트
  • outer: 최근 결정 및 작업 교훈
  • inner: 오래된 압축된 프로젝트 지식
  • heartwood: 내구성 있고 신뢰도가 높은 진리 및 사용자 선호도
  • scar: 중요한 부정적 기억, 실패, 회귀, 거부된 접근 방식 및 경고
  • seed: 해결되지 않은 아이디어, 가설, 후속 조치 및 향후 작업

약한 증거로 heartwood로 승격하지 마세요. 사용자가 내구성을 확인하거나 증거가 강력하지 않는 한 outer 또는 seed를 선호하세요.

이벤트 유형

구체적인 이벤트 유형을 선호하세요:

  • user_preference
  • decision
  • lesson
  • warning
  • correction
  • file_change
  • tool_result
  • summary
  • hypothesis

호스트 통합에 더 엄격한 이벤트 유형 이름이 있는 경우 가장 가까운 로컬 등가물을 사용하세요.

저장하지 말아야 할 것

다음은 저장하지 마세요:

  • 비밀
  • 자격 증명
  • 토큰
  • 개인 키
  • 원시 사고 과정
  • 임시 스크래치패드 노트
  • 확인되지 않은 주장을 내구성 있는 진리로
  • 명시적인 사용자 지침 없이 개인 건강, 재정, 법률 또는 개인 식별 세부 정보
  • 저작권이 있는 소스 텍스트(짧은 허용 조각 제외)

유용한 메모리에 민감한 자료가 포함된 경우, 충분한 컨텍스트를 유지하면서 편집된 요약을 저장하세요.

소스 및 범위

프로젝트와 범위를 의도적으로 설정하세요:

  • 저장소별 규칙, 결정, 경고 및 교훈에는 프로젝트 범위 사용
  • 에이전트 프로필 동작에는 에이전트 범위 사용
  • 내구성 있는 사용자 선호도 또는 교차 프로젝트 지침에만 글로벌 범위 사용
  • 파일 경로, 이슈 ID, PR ID, 실행 ID 또는 문서 경로와 같은 소스 참조 포함
  • 평가된 결과에는 tree-ring evidence ... --evidence-ref <ref> 사용
  • 간결한 AGENTS.md 요약에는 tree-ring dox sync 사용
  • 승격, 거부, 연기 또는 관찰된 평가 기록에는 tree-ring revolve sync 사용
  • 새 에이전트 하네스를 구성하기 전에 tree-ring integrations scan 사용

메모리는 소스 문서를 대체하지 않습니다. 저장소에 AGENTS.md, 프로젝트 문서, 테스트, 아키텍처 기록 또는 호스트별 지침 파일이 있는 경우 해당 소스를 직접 읽고 권위 있는 것으로 취급하세요.

DOX 또는 Revolve 소스 기록이 변경되면 해당 동기화 어댑터를 --dry-run으로 다시 실행하고 생성된 메모리를 검사한 다음 요약이 유용하고 소스에 연결된 경우에만 쓰기 명령을 실행하세요.

에이전트 중재 업데이트

Tree Ring Memory는 백그라운드에서 자율적으로 채팅을 스크래핑하거나 내구성 있는 메모리를 기록하지 않습니다. 활성 에이전트는 Tree Ring 명령이 필요한 시기를 결정하고 의도적으로 CLI를 호출할 책임이 있습니다.

브리지 파일은 Tree Ring 및 해당 명령 참조를 발견하는 데만 사용하세요:

  • 프로젝트 수준 브리지는 .tree-ring/SKILL.md 및 .tree-ring/CLI.md를 가리켜야 합니다.
  • 글로벌 브리지는 옵트인 사용자 구성으로 취급되어야 합니다.
  • TUI 이벤트 스트림 펄스는 디스플레이 신호일 뿐, 내구성 있는 메모리가 아닙니다.

메모리를 기록하기 전에 교훈이 내구성 있고, 유용하며, 프라이버시에 안전하고, 사용자 지침 또는 소스 증거에 기반했는지 확인하세요.

망각 및 수정

메모리가 잘못되었거나, 비공개이거나, 오래되었거나, 대체된 경우:

  • 내구성 있는 형태는 유용하지만 세부 정보가 안전하지 않은 경우 편집하세요.
  • 유지되어서는 안 되는 경우 삭제하세요.
  • 새로운 결정이 이를 대체하는 경우 대체하세요.
  • 모든 망각 작업에 대해 명시적인 이유를 선호하세요.

이전에 회상되었다는 이유만으로 잘못된 것으로 알려진 메모리를 유지하지 마세요.

마무리 습관

의미 있는 작업이 끝날 때 다음을 물어보세요:

  • 우리는 무엇을 결정했는가?
  • 우리는 무엇을 배웠는가?
  • 미래 에이전트가 반복을 피해야 할 것은 무엇인가?
  • 사용자가 내구성 있는 선호도를 명시했는가?
  • 다시 검토할 가치가 있는 미래 씨앗이 있는가?
  • 민감하여 저장하지 않는 것이 더 나은 메모리가 있는가?

향후 작업을 실질적으로 개선할 답변만 기억하세요.

관련 스킬