솔리테르: 클로드 코드로 구축된 AI 에이전트용 오픈 소스 신원 계층

솔리테어는 주로 Claude Code를 개발 환경으로 사용하여 구축된, AI 에이전트용 아이덴티티 레이어를 제공하는 오픈소스 프로젝트입니다. 기억 회상에 초점을 맞춘 에이전트 메모리 도구와 달리, 솔리테어는 에이전트가 시간이 지남에 따라 사용자와 어떻게 협력하는지 다루며, 창시자가 "더 나은 노트북을 가진 똑똑한 낯선 사람"이라고 묘사한 것을 넘어서는 것을 목표로 합니다.

주요 기능 및 아키텍처

이 시스템은 2월부터 프로덕션 환경에서 운영되었으며, 현재 버전은 실제 사용에서 600회 이상의 세션과 15,700개 이상의 항목을 통해 형성되었습니다. 주요 아키텍처 결정은 실패 모드를 관찰하고 실제 문제를 해결하는 과정에서 도출되었습니다:

Claude Code가 도구 호출과 세션 상태를 처리하는 방식에 맞춰 설계된 MCP 서버 아키텍처 및 훅 시스템
실제로 유용하다고 입증된 내용을 기반으로 조정되는 검색 가중치
프로덕션 사용을 통해 개선된 부트 구조 및 페르소나 컴파일
모순 감지, 신뢰도 재점수, 엔티티 재연결 기능을 갖춘 자체 수정 지식 그래프
에이전트가 빈 상태가 아닌 브리핑된 상태로 도착하도록 하는 계층화된 부트 컨텍스트

아이덴티티 및 행동 시스템

솔리테어의 아이덴티티 시스템은 정적 구성이 아닌 실제 상호작용을 통해 진화합니다:

성향 특성(따뜻함, 주장성, 확신, 관찰력)은 상호작용 패턴에서 컴파일되며 세션 간에 진화
페르소나 및 행동 아이덴티티는 구성 파일 편집이 아닌 실제 사용에서 발전
세션 잔류물은 단순히 논의된 내용이 아닌 작업이 어떻게 느껴졌는지를 전달
새 사용자는 대화를 통해 파트너를 구축하는 안내된 온보딩을 받음 - 이름 선택, 필요 설명, 시스템이 답변에서 페르소나를 조립(YAML 불필요)

로컬-퍼스트 디자인

로컬-퍼스트 접근 방식은 디자인에서 절대 타협할 수 없는 부분입니다:

모든 저장소는 작업 공간 디렉토리의 SQLite + JSONL
코어 엔진에서 네트워크 요청 없음
클라우드 의존성 없음, 원격 측정 없음, 메모리 작업을 위한 외부 API 호출 없음
설정 없이 자동 롤링 백업
사용자 데이터는 사용자 기기에 유지

설치 및 호환성

pip install solitaire-ai를 통해 설치(참고: 관련 없는 패키지인 install solitaire가 아님). 이 프로젝트는 Claude Code를 우선 대상으로 구축되었지만 다른 에이전트 플랫폼도 지원합니다. 메모리와 무관하게 작동 - 기존 메모리 레이어와 함께 작동하거나 필요한 경우 하나를 제공합니다.