AI 에이전트가 노트에서 바꾼 내용을 검토하는 방법

AI 에이전트에게 노트를 맡긴다면, 그 변경에 기대기 전에 확인할 방법이 있어야 해요. 코딩 에이전트는 빠르고 글을 매끄럽게 써요. 그게 바로 문제예요. 틀린 문장도 맞는 문장과 똑같이 읽히거든요. 코드에서는 에이전트가 틀리면 테스트가 실패하는 경우가 많아요. 지식 베이스에서는 아무것도 실패하지 않아요. 틀린 날짜가 그냥 거기 있을 뿐이에요.

자꾸 되풀이되는 문제가 몇 가지 있어요.

• 조용한 재작성. 새 노트 하나를 부탁했는데 에이전트가 오래된 노트 세 개도 “정리”하면서, 내가 공들여 쓴 문장의 뜻을 바꿔 놓아요.
• 덮어쓰인 편집. 어제 손으로 숫자를 고쳤어요. 오늘 에이전트가 더 오래된 자료로 노트를 다시 쓰고, 내 수정은 사라져요.
• 퍼지는 오류. 다음 세션이 틀린 사실을 맥락으로 읽고, 노트 두 개에 더 되풀이하면, 이제 확인된 사실처럼 보여요.
• 기록이 없음. 한 달 뒤에는 어떤 노트를 내가 썼고, 어떤 노트를 에이전트가 썼고, 어떤 노트를 누군가 확인한 적이 있는지 알 수 없어요.

해결책은 두 부분이에요. 모든 변경을 굳어지기 전에 보고, 누가 무엇을 확인했는지 적어 두는 거예요. 이 가이드는 git과 frontmatter 필드 몇 개로 두 가지를 직접 하는 방법을 보여 주고, 단계마다 Knowtarium은 어떻게 하는지 덧붙여요. 저희는 바로 이걸 위해 Knowtarium을 만들어요. 거기서 에이전트의 변경은 기본으로 서명되고 되돌릴 수 있고, 변경이 굳어지기 전의 검토는 폴더마다 켜는 스위치예요.

이 일에는 git이 가장 좋은 무료 도구예요. 노트가 마크다운 파일 폴더라면 git으로 관리하고, 에이전트 세션 전마다 커밋하세요. 그러면 에이전트가 하는 모든 일이 읽고, 일부만 남기고, 버릴 수 있는 diff가 돼요.

# 한 번만, 노트 폴더에서
$ git init$ git add -A && git commit -m "Notes before agents"
 
# 에이전트 세션 전마다: 자기 브랜치에서 깨끗하게 시작
$ git switch -c agent/2026-09-26-cleanup

브랜치에서 작업하면 main 기록이 깨끗하게 유지돼요. 세션 전체가 실수였다면 돌아가서 브랜치를 지우면 돼요. 에이전트가 끝나면 무엇을 바꿨는지 읽어 보세요.

# 어떤 파일이 얼마나 바뀌었는지
$ git status$ git diff --stat
 
# 변경을 단어 단위로 읽기, 줄 단위보다 글에 잘 맞아요
$ git diff --word-diff
 
# 동의하는 덩어리만 남기기 (y = 남기기, n = 건너뛰기, s = 나누기, e = 고치기)
$ git add -p$ git commit -m "Keep claude-code edits to pricing notes"
 
# 남기지 않은 건 모두 버리기
$ git restore .
 
# main으로 돌아와 승인한 것 들여오기
$ git switch main$ git merge agent/2026-09-26-cleanup

이걸 진짜 검토로 만드는 건 git add -p예요. 바뀐 덩어리를 하나씩 보여 주면서 스테이징하거나 건너뛰게 해 줘서, 새 노트는 남기고 부탁하지 않은 오래된 노트의 재작성은 버릴 수 있어요. 큰 덩어리는 s로 작게 나누고, e로 직접 고칠 수 있어요.

커밋 메시지에 에이전트 이름을 넣으세요. 그러면 git log로 어느 세션이 무엇을 썼는지 알 수 있고, git log -p -- path/to/note.md는 노트 하나의 전체 기록을 보여 줘요.

Knowtarium에서는

Knowtarium에서는 에이전트의 모든 변경이 그 에이전트의 키로 서명된 새 버전으로 저장돼요. 그래서 노트의 기록에 버전마다 누가 언제 만들었는지 나오고, See changes가 에이전트의 편집을 diff로 보여 주며, Undo가 이전 버전을 되살려요. 먼저 읽어 보고 싶은 폴더에는 검토(“Ask me first”)를 켜세요. 거기서 에이전트의 변경은 내가 승인할 때까지 diff로 기다리고, 댓글을 달아 거절할 수도 있어요.

(새 탭에서 원래 크기로 열림) (새 탭에서 원래 크기로 열림)

Claude Code를 쓴다면 도움이 되는 기능이 세 가지 있어요. 어느 것도 git을 대신하지는 않지만, 문제를 더 일찍 잡아내요.

권한 모드

권한 모드는 Claude가 묻지 않고 무엇을 할 수 있는지 정해요. Manual 모드(설정값 default)에서는 파일을 고치기 전에 물어봐요. acceptEdits는 묻지 않고 고치게 하는데, 나중에 git diff로 검토하는 쪽을 좋아한다면 Anthropic이 권하는 방식이에요. plan 모드에서는 Claude가 조사하고 변경을 제안하지만, 내가 계획을 승인할 때까지 실제로 바꾸지는 않아요. 세션 중에 Shift+Tab을 누르면 모드가 바뀌어요. 최근 버전은 대화형 세션을 auto 모드로 시작하는데, 여기서는 내가 아니라 분류기가 동작을 검토해요. 그러니 아끼는 노트에서 하는 세션은 Manual이나 plan 모드로 바꾸세요.

체크포인트

Claude Code는 프롬프트를 보낼 때마다 그 전에 체크포인트를 저장해요. /rewind를 실행하거나, 프롬프트가 비어 있을 때 Esc를 두 번 누르면 파일, 대화, 또는 둘 다를 되돌릴 수 있어요. 한계도 알아 두세요. 체크포인트는 mv나 rm 같은 셸 명령으로 바뀐 파일은 추적하지 않고, 서브에이전트가 한 편집은 대개 되돌리지 못하며, 기본값으로 약 30일 뒤에 지워져요. Anthropic 문서에도 체크포인트가 버전 관리를 대신하지 않는다고 분명히 적혀 있어요.

권한 규칙

.claude/settings.json의 규칙으로 특정 폴더의 편집을 막거나 승인을 거치게 할 수 있어요. 거부 규칙은 다른 모든 것보다 우선하고, 모든 모드에 적용돼요.

{
  "permissions": {
    "ask": ["Edit(/decisions/**)"],
    "deny": ["Edit(/journal/**)", "Edit(/people/**)"]
  }
}

여기서 Claude는 journal/이나 people/을 절대 고칠 수 없고, decisions/를 건드리기 전에는 물어봐야 해요. Edit 규칙은 Claude의 내장 파일 도구와 Claude가 셸에서 인식하는 파일 명령에는 적용되지만, 스크립트가 직접 파일을 여는 경우는 막지 못해요. 확실한 보장이 필요하다면 Anthropic은 자체 샌드박스를 권해요.

대부분의 에이전트는 시작하기 전에 지침 파일을 읽어요. Codex, Cursor를 비롯한 많은 에이전트는 AGENTS.md를, Claude Code는 CLAUDE.md를 읽어요. 편집 규칙은 거기에 적으세요. 짧게, 그리고 지켰는지 확인할 수 있을 만큼 구체적으로요.

## 문서 바꾸기
 
- 문서는 절대 지우지 않아요. `status: deprecated`로 설정하고 이유를 적어요.
- journal/이나 people/ 안의 파일은 절대 고치지 않아요.
- 바꿔 달라고 하지 않은 문단은 다시 쓰지 않아요.
- 쓰는 모든 문서의 `generated`에 이름과 버전으로 서명해요.
- `verified`에 `human:` 항목은 절대 추가하지 않아요. 그건 사람만 해요.
- 세션이 끝나면 만들거나 바꾸거나 옮긴 파일을 모두 나열해요.

검토에 쓸모 있는 건 마지막 규칙이에요. 건드린 파일 목록이 나오면 git status와 비교할 수 있어요. 둘이 다르면 더 자세히 보세요.

지침은 컨텍스트이지 잠금장치가 아니에요. Anthropic 문서는 CLAUDE.md를 Claude가 강제하는 설정이 아니라 읽는 것으로 설명해요. 위의 권한 규칙이 있는 이유예요. 전체 템플릿은 지식 베이스를 위한 AGENTS.md와 CLAUDE.md 가이드에 있어요.

macOS와 Linux에서는 chmod -R a-w journal/로 폴더를 읽기 전용으로 만들 수도 있어요. 과속 방지턱 정도로만 생각하세요. 셸 명령을 실행할 수 있는 에이전트는 권한을 다시 바꿀 수 있어요.

diff는 오늘 무엇이 바뀌었는지 알려 줘요. 하지만 다음 달에 읽는 사람에게 누군가 그 노트를 확인했는지는 알려 주지 않아요. 그러려면 노트 자체에 적어 두세요. Google Cloud가 공개한 열린 명세인 Open Knowledge Format(OKF)에 바로 이걸 위한 필드가 있어요.

---
type: Decision
title: 결제를 연간 요금제로 전환
generated: { by: claude-code/2.1, at: 2026-09-26T09:12:00Z }
verified:
  - { by: human:maya, at: 2026-09-26T11:40:00Z }
stale_after: 2027-03-31T00:00:00Z
---

• generated는 지금 내용을 누가 언제 썼는지 말해요. 에이전트는 name/version으로, 사람은 human:name으로 서명해요.
• verified는 그 뒤로 확인한 모든 쪽을 시각과 함께 나열해요. 항목이 없는 문서는 unverified, 에이전트나 프로세스만 확인한 문서는 machine-confirmed, human: 행위자가 확인한 문서는 human-reviewed예요.
• stale_after는 그 문서를 더는 안심하고 인용할 수 없게 되는 시점이에요.

방법은 간단해요. 에이전트는 generated를 쓰고 서명하지만, verified는 절대 건드리지 않아요. 나는 diff를 검토한 다음 내 verified 항목을 추가해요. 이렇게 해 두면 아무도 확인하지 않은 것을 찾는 건 명령 하나면 돼요.

# 아직 아무도 확인하지 않은 문서: verified 줄이 아예 없음
$ grep -rL "^verified:" --include="*.md" .

1. 커밋한 다음, 세션용 브랜치를 만들어요.
2. 절대 건드리면 안 되는 폴더에 거부 규칙을 걸고, Manual이나 plan 모드로 에이전트를 시작해요.
3. 작업은 하나만 줘요. 끝에 건드린 파일 목록을 달라고 해요.
4. 그 목록을 git status와 비교한 다음, git diff --word-diff를 읽어요.
5. 동의하는 건 git add -p로 남기고, 나머지는 되돌려요.
6. 확인한 노트마다 내 verified 항목을 추가하고, 메시지에 에이전트 이름을 넣어 커밋한 다음, 병합해요.

도구마다 잡아내는 게 달라요.

노트가 수십 개이고 에이전트가 하나라면 git과 이 습관으로 충분할 수 있어요. 에이전트가 매일 쓰거나, 변경 하나가 노트 열 개에 닿거나, 내 편집 하나가 나도 모르게 다른 노트 다섯 개를 틀리게 만들기 시작하면 번거로워져요. Knowtarium이 바로 그 부분을 위해 만들어졌어요. 에이전트의 모든 변경은 서명되고 클릭 한 번이면 되돌릴 수 있고, 검토를 켠 곳에서는 에이전트의 변경이 나를 기다리고, 내 편집은 에이전트에게 확인을 부탁할 때까지 기다려요.

Knowtarium은 위의 습관을 종단간 암호화 지식 베이스 안에 담아요. 에이전트는 MCP로 연결해서 같은 OKF 문서를 다루고, 앱은 에이전트가 무엇을 했고 무엇을 아직 살펴봐야 하는지 보여 줘요. 검토 방식은 두 단계예요. 기본으로 모든 변경을 되돌릴 수 있고, 원하는 곳에서는 먼저 승인을 받아요.

모든 변경에 서명, 모든 변경을 되돌리기

기본으로 에이전트의 변경은 바로 문서의 다음 버전으로 저장되고, 그 에이전트의 키로 서명돼요. 에이전트가 고친 문서는 내가 열어 볼 때까지 사이드바에 점으로 표시되고, 제목 아래 줄이 어느 에이전트가 언제 고쳤는지 알려 주며 See changes 링크와 Undo가 함께 있고, 워크스페이스 페이지에는 최근 14일 동안 에이전트가 고친 것이 나열돼요. Undo는 이전 버전을 내 변경으로 되살리고, 기록은 내가 정한 기간(처음에는 30일, 최대 1년) 동안 되돌릴 수 있는 모든 버전을 보관해요.

Ask me first: diff를 보고 승인하기

워크스페이스나 폴더에 검토를 켜면, 거기서 에이전트의 변경은 대신 제안으로 기다려요. 하나를 열면 에이전트가 직접 쓴 요약, 누가 제안했는지와 함께 diff가 보여요. 승인하거나, 댓글을 달아 거절하거나, 여러 개를 한 번에 승인하세요. 승인하면 시각과 함께 내가 verified에 추가돼요. 원래라면 손으로 입력했을 human: 항목이에요. 에이전트의 제안에는 이미 에이전트 자신의 확인이 담겨 있으니, 승인하는 순간 노트는 완전히 검증된 상태가 돼요.

(새 탭에서 원래 크기로 열림) (새 탭에서 원래 크기로 열림)

그런 폴더에서는 확인을 기다리는 모든 것이 한 대기열에 모여요.

• 에이전트가 제안해서 나를 기다리는 변경
• 내가 해서 에이전트의 확인을 기다리는 편집
• 에이전트가 확인하다가 찾은 충돌

stale_after 날짜가 지났거나 곧 다가오는 문서는 어디에 있든 Stale and expiring 페이지에 나열돼요.

양방향 확인

검토를 켠 폴더에서는 검토가 반대 방향으로도 돌아가요. 내가 직접 문서를 고치면, 그 편집은 내 것으로 서명되고 에이전트가 연결된 모든 문서와 대조할 때까지 대기열에서 기다려요. Knowtarium은 직접 AI를 호출하지 않아요. 내가 에이전트에게 오늘 편집한 것을 확인해 달라고 하면, 에이전트가 확인 결과를 기록하거나, 더는 맞지 않는 곳마다 충돌을 표시해요.

신뢰 등급

검토를 켠 폴더에서는 모든 문서에 신뢰 등급이 있어요.

모든 에이전트에게 같은 규칙이 적용돼요. 에이전트는 어떤 것도 사람이 확인했다고 표시할 수 없고, 그 권한을 줬을 때만 문서를 지우며, 검토를 켠 폴더에서는 내 검토를 건너뛸 수 없어요. 문서는 종단간 암호화되니까 저희는 읽을 수 없고, 연결한 에이전트는 자기가 읽는 내용을 봐요. 기능과 에이전트를 연결하는 방법을 보세요.