1. Git으로 변경 이력 남기기

5장에서 인제스트 결과를 검수할 때 걸린 문제가 있었습니다. 무엇이 바뀌었는지 정확히 알기 어렵다는 것입니다. 이 절에서 그 문제를 해결합니다. 카파시의 원문이 마지막 요령으로 꼽은 것이기도 합니다. 위키는 그냥 마크다운 파일이 든 폴더이므로, Git을 붙이면 버전 관리가 공짜로 따라옵니다.

1.1 Git이 해 주는 것

Git은 폴더의 상태를 시점별로 저장하는 도구입니다. 위키에 붙이면 셋이 가능해집니다.

무엇이 바뀌었는지 줄 단위로 봅니다. 어제와 오늘의 문서를 비교해 추가된 줄과 지워진 줄을 색으로 보여줍니다.

되돌릴 수 있습니다. 인제스트 결과가 마음에 안 들면 직전 상태로 통째로 돌립니다.

언제 무엇을 했는지 남습니다. log.md와 비슷하지만 이쪽은 파일의 실제 변경을 담습니다.

세 번째가 중요한 이유가 있습니다. log.md는 AI가 쓰는 기록이라 빠뜨릴 수 있습니다. Git은 실제 파일 변경을 기록하므로 빠뜨릴 수 없습니다.

1.2 붙이기

가장 간단한 방법은 Obsidian 플러그인을 쓰는 것입니다. 커뮤니티 플러그인에서 Git을 검색해 설치합니다.

설치한 뒤 명령 팔레트(Ctrl+P)에서 Git: Initialize를 실행하면 위키 폴더가 Git 저장소가 됩니다.

원본 자료를 저장소에 넣을지는 정해야 합니다. PDF와 이미지가 많으면 저장소가 무거워집니다. 넣지 않으려면 .gitignore 파일을 만듭니다.

.gitignore 파일을 만들어줘. 내용은 아래로.

raw/assets/
*.pdf
.obsidian/workspace.json

.obsidian/workspace.json은 창 배치 같은 것이 담긴 파일이라 열 때마다 바뀝니다. 빼 두면 변경 목록이 깨끗해집니다.

1.3 인제스트마다 저장하기

인제스트가 끝나면 그 시점을 저장합니다. Git 용어로 커밋이라고 합니다.

Obsidian Git 플러그인에서 사이드바를 열면 바뀐 파일 목록이 보입니다. 메시지를 적고 커밋하면 그 상태가 저장됩니다.

메시지는 log.md에 남긴 것과 비슷하게 적습니다.

ingest: 경쟁사 C 요금제 페이지

AI에게 시킬 수도 있습니다.

방금 인제스트한 내용을 커밋해줘.
메시지는 'ingest: ' 로 시작하고 무엇을 넣었는지 한 줄로.

자동 커밋 기능도 있습니다. 플러그인 설정에서 몇 분마다 자동으로 저장하게 할 수 있는데, 위키에는 권하지 않습니다. 인제스트 도중에 저장되면 어중간한 상태가 기록됩니다. 작업이 끝난 시점에 직접 하는 편이 낫습니다.

1.4 바뀐 것 확인하기

커밋 전에 무엇이 바뀌었는지 봅니다. 플러그인 사이드바에서 파일 이름을 누르면 변경 내용이 나옵니다. 초록색이 추가된 줄, 빨간색이 지워진 줄입니다.

여기서 5장의 검수가 훨씬 쉬워집니다. 문서 전체를 다시 읽을 필요 없이 바뀐 줄만 보면 됩니다.

특히 이런 것이 눈에 걸립니다.

빨간 줄이 예상보다 많을 때. 갱신인 줄 알았는데 실은 기존 내용을 지우고 다시 쓴 경우입니다.

손대지 않기로 한 곳이 바뀌었을 때. 사람 확인 표시가 붙은 줄이 빨간색이면 규칙이 안 지켜진 것입니다.

출처 표기가 사라졌을 때. 문장을 다듬으면서 괄호 안 출처가 같이 없어지는 일이 있습니다.

1.5 되돌리기

문제를 발견했으면 되돌립니다. 커밋하기 전이라면 그 파일의 변경을 취소하면 원래대로 돌아옵니다. 이미 커밋했다면 이전 커밋 시점으로 돌릴 수 있습니다.

되돌리기는 Git 명령이 필요한 작업이라 AI에게 시키는 편이 편합니다.

방금 커밋을 취소하고 그 직전 상태로 돌려줘.
어떤 파일이 어떻게 돌아가는지 먼저 보여줘.

되돌리기가 가능하다는 것 자체가 위키를 다루는 태도를 바꿉니다. 문서 스무 장을 한 번에 정리하는 작업도 마음 놓고 시킬 수 있습니다.

1.6 여러 사람이 쓸 때

팀이 같은 위키를 쓴다면 Git이 사실상 필수입니다. 두 사람이 각자 AI로 같은 폴더를 고치면 한쪽 변경이 조용히 사라집니다.

GitHub 같은 곳에 비공개 저장소를 만들고 각자 그것을 내려받아 쓰면 됩니다. 다만 몇 가지를 정해 둬야 합니다.

누가 인제스트할지 정합니다. 여럿이 동시에 인제스트하면 충돌이 많이 납니다. 자료를 넣는 사람을 정하거나, 시간을 나누는 편이 낫습니다.

작업 전에 받아옵니다. 남이 올린 변경을 먼저 받고 시작합니다. 안 받고 시작하면 충돌을 나중에 손으로 풀어야 합니다.

대외비는 넣지 않습니다. 저장소가 비공개여도 여러 사람이 접근한다는 사실은 그대로입니다. 11장에서 다룹니다.

팀 위키는 이 책의 범위를 넘어가는 문제들을 만듭니다. 혼자 쓰는 위키가 자리를 잡은 뒤에 시작하기를 권합니다.

다음 절에서 위키가 더 커졌을 때의 도구들을 다룹니다.