인간 소유 메모리 프로토콜
AI 채팅 승인
AI 에이전트와의 채팅에서 Engram 승인은 대화형으로 진행됩니다. 에이전트는 먼저 다듬은 TYPE: ... | TEXT: ... 후보를 보여 주고, 규칙 메모리라면 Light/Balanced/Strict 변형도 함께 제시합니다. 정확히 그 후보를 저장하려면 yes, 수정하려면 audit, 중단하려면 cancel 로 답합니다. yes 이후 에이전트는 승인된 후보 그대로 engram save-session --accept-all 을 사용합니다. 직접 CLI 에서 저장할 때는 accept-all 명령을 명시적으로 호출하지 않는 한 계속 A/B/C 를 사용합니다.
Engram은 단지 "에이전트용 메모리 저장소"를 넘어서는 개념입니다. 메모리를 직접 투명하게 검사할 수 있고, 공유 및 이식이 가능하며, 최종 소유권이 인간에게 있음을 보장하는 프로토콜입니다.
계약 (The Contract)
Markdown은 영속적인 메모리의 기본 실체입니다.
JSON 인덱스 및 그래프 파일은 빠른 처리를 돕는 가속 레이어에 불과합니다.
승인(Approval)은 최종 쓰기 권한을 지키는 신뢰 경계선입니다.
해시(Hashes)는 무결성을 검증하기 위한 수단입니다.
제외 규칙(Ignore rules)은 프라이버시 필터입니다.
Git은 버전 이력 추적과 이식성을 책임집니다.
에이전트 어댑터는 편의를 제공할 뿐 어떠한 최종 결정 권한도 가지지 못합니다.
에이전트는 새로운 메모리를 감지하고 추천할 수 있지만 인간만이 그것을 최종적인 메모리로 영속화할 수 있습니다.
메모리 유형 (Memory Types)
| 유형 | 용도 |
|---|---|
| Rule | 사용자 선호, 제약 사항, 교정 피드백, 항상 또는 절대 준수해야 하는 가이드 |
| Skill | 반복 실행하는 워크플로우, 단계별 체크리스트, 프로시저, 런북(runbook) |
| Knowledge | 객관적인 프로젝트 팩트, 아키텍처 결정 사항, 세부 구현 내용 |
실제 작동하는 모든 메모리 파일은 명확하게 Context, Content, 그리고 Example 섹션을 포함해야 합니다. 특히 규칙(Rule) 메모리는 에이전트에 로드되었을 때 유의미한 밀도를 유지하기 위해 간결한 줄(line) 수 제한 규칙을 엄격히 적용받습니다.
쓰기 흐름 (Write Flow)
- 에이전트가 하나 이상의 메모리 후보를 추천합니다.
save-session --query-level <n>을 사용하면 에이전트는 접근 가능한 최근 인간-에이전트 채팅 최대 n개를 제안용 컨텍스트로만 고려할 수 있습니다. 자연어/engram ss -a last 50 sessions는 같은 범위에 명시적 일괄 승인을 더한 것입니다:engram save-session --query-level 50 --accept-all. - Engram이 추천 대상의 유형과 저장 위치(scope)를 분석합니다.
- Engram이 스키마 준수 여부, 계정 비밀번호나 API 키 누출 여부, 프롬프트 인젝션 패턴 및 파일 접근 경로의 안전성을 검사합니다.
- 인간 사용자에게 저장하려는 정보의 프리뷰를 표시합니다.
- 사용자가 확인 후
A,A 1,3,B <메모 내용>또는C를 통해 승인 여부를 전달합니다. - 승인을 거친 메모리 내용만 디스크에 기록됩니다.
- 인덱스, 그래프, 해시 맵 및 변경 이력(changelog) 파일이 즉시 갱신됩니다.
읽기 흐름 (Read Flow)
- Engram이 워크스페이스 및 활성화된 글로벌 인덱스를 읽어 들입니다.
- 중복되는 키(ID)가 발견되면 워크스페이스 메모리가 글로벌 메모리보다 우선 적재됩니다.
- 제외 규칙 및 활성 역할(role) 필터를 적용해 현재 태스크와 연관 없는 항목들을 걸러냅니다.
- 그래프 분석 모델을 활용해 현재 작업에 가장 적합한 최소한의 컨텍스트 패키지를 추출합니다.
- 에이전트 프롬프트에 들어가기 직전에 해시 값 체크 및 내용 보안 검증이 실행됩니다.
이것이 중요한 이유
프로토콜에 기반하지 않는 에이전트 메모리는 보이지 않는 내부 상태(invisible state)로 전락하고 맙니다. 보이지 않는 메모리는 검토하거나 공유하기 매우 곤란할 뿐만 아니라, 에이전트가 예기치 않게 오염된 상태를 PERSIST 해버릴 리스크가 큽니다.
Engram은 메모리를 의도적으로 단순하게 관리합니다. 오직 파일, Diff 비교, 해시 체크, 인간의 승인 게이트, 그리고 언제든 수동으로 재실행 가능한 명령어들로만 이루어집니다.
다음 단계: 운영 및 명령어 가이드.