Unified Agent Context
여러 AI 에이전트(claude code, codex, hermes, gajaecode, lettacode, …)의 컨텍스트/메모리를 하나의 로컬 공유 저장소로 통합하는 v1 시스템.
목표 한 줄: 어느 에이전트에서 정한 결정·선호도 재설명 없이 모든 에이전트의 새 세션에 이어진다.
아키텍처 (v1, 로컬 전용)
에이전트들 ──(MCP stdio)──► mcp-memory-keeper (공유 SQLite, channel=스코프 서버측 필터)
│ ▲
│ └─ 세션 시작: 증류된 사실만 주입 (훅 또는 지시 pull) — scripts/inject-context.mjs
└──── 세션 중 명시 기록 (record-fact) / 종료 자동 증류 (distill-session)
└─ 모든 저장 경로는 중앙 fail-closed 비밀 게이트 경유 (차단 or redact)
- 스코프:
global(선호) vsproject:<git-root-basename>(결정/작업 상태) — 프로젝트 간 누출 차단 (서버 쿼리 강제) - TTL: decision/preference 영구 보존, project_state 90일
- 원본 대화는 콜드 아카이브만 (주입 금지, 비밀은 redact-only)
- degraded mode: 서버 부재 시 warning/log/health/metric 4증거 방출,
UAC_STRICT=1이면 실패 처리 - v2 예정: 셀프호스팅 원격 MCP + 인증 → claude.ai 합류 / P3 작업 이어받기 / GJC 확장 자동주입
문서
| 문서 | 내용 |
|---|---|
docs/phase0-comparison.md |
저장소 후보 대조표 + 채택 근거 |
docs/phase1-storage.md |
스키마/스코프/TTL/비밀 게이트 |
docs/phase2-hooks.md |
하네스 5종 배선 + degraded mode |
docs/phase3-write-paths.md |
기록 경로 5종 + 증류/검역 |
docs/phase4-coverage-matrix.md |
20경로 커버리지 매트릭스 + 검증 계층 |
docs/onboarding.md |
신규 에이전트 합류 절차 (5분) |
주요 커맨드
node scripts/inject-context.mjs [--cwd <dir>] # 공유 컨텍스트 블록 출력
node scripts/record-fact.mjs --type decision "..." # 명시 기록 (비밀은 exit 3 차단)
node scripts/distill-session.mjs --file <transcript> # 세션 증류 + 검역 스윕
node scripts/doctor.mjs # 배선 자가진단
node scripts/cross-verify.mjs # 20경로 커버리지 매트릭스 재실행
node scripts/reexplain.mjs log|report # 재설명 계측 (2주 관문 보조지표)
node --test 'tests/*.test.mjs' # 전체 테스트 (65+)
2주 실사용 관문 (진행 중)
시나리오 테스트는 전부 통과 상태. 최종 합격은 2주 실사용에서 "다시 설명하는" 체감이 사라졌는지 사용자 확인으로 판정한다. 재설명이 발생할 때마다 reexplain.mjs log로 기록하고, 2주 후 report의 주간 추이가 0에 수렴하는지 본다.
