저장하기

기억은 저절로 좋아지지 않는다. 저장 규약의 일관성이 그래프 품질을 결정한다.

언제 저장되나: ak 명령이 있을 때만

AiAkiv는 대화를 자동으로 저장하지 않는다. ak로 명시 명령할 때만 저장한다 (언어 무관: "ak 저장해줘"도 됨).

• 그냥 "기억해둬" / "저장해" 로는 저장되지 않는다.
• 이건 실수로 잡담·비밀이 그래프에 쌓이는 걸 막는 안전장치다.
• AI 클라이언트도 이 규칙을 따른다 → AI를 위한 안내.

좋은 기억을 만드는 규약

1) 결정은 4요소로

결정을 저장할 땐 나중에 되짚을 수 있게 네 가지를 같이 남긴다.

1. 무엇을 정했나
2. 왜 (근거)
3. 고려한 대안과 기각 이유
4. 관련 커밋 해시(코드 프로젝트라면)

대안·기각 이유가 빠지면 "왜 다른 길을 안 갔나"를 나중에 아무도 모른다. 그래프의 가장 값진 부분이 여기다.

2) 버그는 원인 링크와 함께

버그를 고치며 저장할 땐: 증상 / 근본 원인(원인이 된 과거 이벤트·결정) / 수정 방법 / 커밋 해시. 근본 원인을 과거 이벤트에 이어두면, 나중에 "이 버그의 원인이 된 과거 결정은?" 같은 인과 질문이 성립한다.

3) 엔티티는 한 이름으로

같은 대상은 언제나 같은 이름으로 쓴다("세이브 포맷"으로 정했으면 계속 그렇게). 이름이 흔들리면 한 엔티티가 여러 개로 갈라져 연결이 끊긴다.

4) 태그를 붙인다

성격 태그(결정 / 버그 / 밸런스 / 회고 등) + 시스템·주제별 태그. 태그가 일관될수록 검색이 좋아진다.

5) 길면 잘라내지 말고 이어서 저장

중요한 내용을 요약하려고 자르지 않는다. 원문이 길면 이어서 저장한다. 검색은 요약을 주지만, 원문은 보존돼야 나중에 되살릴 수 있다.

원문은 한 번에 50,000자까지 들어간다. 넘으면 나눠서 저장하되, 조각들이 흩어지지 않게 스레드로 엮는다: 직전 저장의 event_id를 다음 저장에 prev_event_id로 넘기면 순서대로 연결된다. 사람은 “ak 이어서 저장해줘” 한마디면 된다. 자세한 방법·주의점은 이어서 저장.

안전한 것만 저장한다

AiAkiv는 외부 서비스이고 저장한 것은 남는다(→ 무엇을 저장하나). 그러니 처음부터 넣어도 되는 것만 넣는다. 넣지 말 것:

• 실명(별칭만), 개인정보
• API 키·토큰·비밀
• 회사 기밀·민감 수치
• 주제와 무관한 잡담

저장한 뒤 고치기: 수정과 폐기

잘못 저장했다고 다시 저장하지 마라. 같은 내용이 두 벌이 된다. 이미 저장된 기억에 쓸 수 있는 방법이 둘인데, 하는 일이 서로 다르다.

고치기: AI가 뽑은 것이 틀렸을 때

원문은 사용자가 쓴 것이라 손댈 이유가 없다. 틀릴 수 있는 건 AI가 만든 쪽이다. 자동 추출한 엔티티, 제안한 태그, 그리고 이어지는 저장인지 아닌지의 판단이다.

• 엔티티가 엉뚱하게 잡혔거나 빠졌을 때 (→ 한 이름 원칙이 깨진 경우도 여기서 푼다)
• 태그를 더 붙이거나 뗄 때
• 이어져야 하는데 안 이어졌을 때, 또는 남남인데 이어졌을 때

원문 자체를 고쳐야 한다면 고치기로는 안 된다. 그 기억을 폐기하고 다시 저장한다.

문서를 통째로 넣어서(ingest) 생긴 문서 구조상의 연결(조각·파일·폴더 순서)은 끊을 수 없다. 다시 만들 수 없는 정보라 그렇다. 거부되면 재시도하지 않는다.

폐기: 회수에서 빼는 것

잘못 저장했거나, 엉뚱한 프로젝트로 갔거나, 낡아서 더 안 나왔으면 할 때 쓴다.

⚠ 폐기는 삭제가 아니다. 검색·회수에서 빠질 뿐 데이터 자체는 남는다. 그리고 되돌리는 것은 운영자 작업이라 도구로는 못 한다. 한 번 폐기하면 되돌리기 어렵다.

• 내 팀의 기억만 폐기할 수 있다. 남의 팀 것은 거부된다.
• 기억 하나를 물리적으로 지우는 길은 사용자에게 없다. 원본까지 사라지는 것은 팀 삭제와 회원 탈퇴뿐이다(콘솔 → 위험 구역, 되돌릴 수 없음 → 콘솔 안내).

그래서 개인정보·비밀은 폐기로 해결되지 않는다. 애초에 안 넣는 것이 유일하게 확실한 방법인 이유다(위 안전한 것만 저장한다 · 무엇을 저장하나).

persona: 프로젝트가 저장 스타일을 지시한다

프로젝트에는 persona(소유자가 건 표준 지침)가 걸릴 수 있다. 예: "결정에는 반드시 고려한 대안과 기각 이유를 함께 저장." 이 프로젝트에 저장하는 AI는 그 지침을 따른다. persona는 저장 스타일을 바꿀 뿐, ak 명령 규칙을 무력화하지 않는다.

다음

• 저장한 걸 되찾기 → 검색하기
• 어디에 저장되는지 → 팀과 프로젝트