atrium

Atrium은 3계층 메모리 시스템의 두 번째 계층으로, 표준 대화 아카이브에 대한 파생적이고 폐기 가능한 검색을 제공합니다. 소스 데이터를 소유하지 않으며, 대신 표준 아카이브와 큐레이션된 노트에서 재구축할 수 있는 인덱스를 구축합니다. 설계는 인덱스가 폐기 가능하며 머신이 인덱스가 아닌 아카이브를 동기화하여 복사 없이 수렴을 보장한다는 점을 강조합니다. 주요 기능은 다음과 같습니다: - **수집**: 대화 아카이브(JSONL)와 큐레이션된 노트 트리를 인덱싱합니다. - **검색**: 어휘(전체 단어 및 부분 문자열) 및 밀집(의미) 레인을 융합하는 적응형 검색으로, 각 레인을 단독으로 사용하는 옵션을 제공합니다. 밀집 레인은 원시 말뭉치가 아닌 큐레이션된 노트와 세션 합성만 임베딩합니다. - **세션 기록**: 임계값이 충족되면 에이전트가 세션 에피소드를 기록하도록 프롬프트하는 Claude Code Stop 훅(`stop-record-episode.sh`)으로, `atrium record-session`을 사용하여 기록을 검증, 편집, 저장합니다. - **컨텍스트 검색**: 관련 증거를 프롬프트에 주입하는 `UserPromptSubmit` 훅(`user-prompt-context.sh`)입니다. `atrium context` 명령(MCP에서도 사용 가능)은 프로젝트 및 큐레이션된 노트로 범위가 지정되고, 제한된 예산과 안전 검사가 적용된 구조화된 증거를 반환합니다. - **상태 관리**: 상태는 환경 변수 또는 구성에서 확인된 전용 디렉토리에 저장되어 파생 데이터를 분리하고 동기화하지 않습니다. - **개발**: `uv` 및 `pytest`/`ruff`를 통한 테스트 및 린팅. README에는 사용 예제, 훅 구성, 프로토콜 승인 테스트 세부 정보가 포함되어 있습니다. 또한 검색 레인을 분리하는 이유와 `AGENTS.md`에 문서화된 결정 재측정의 중요성을 설명합니다.