스크랩 글을 AI가 위키로 정리해준다는 second-brain-os, 뜯어봤다

옵시디언 raw 메모를 위키 페이지로 바꿔주는 무료 템플릿, 설치 구조와 흐름을 직접 뜯어봤습니다.

2026-09-30 기준으로 공식 저장소를 확인했습니다.

메모가 쌓이기만 하는 이유

글을 저장할 때는 나중에 정리하겠다고 생각합니다. 그런데 요약하고 다른 메모와 연결하는 작업은 지루해서 보통 이주일을 못 넘기고 멈춥니다.

second-brain-os는 이 정리 작업을 사람이 아니라 에이전트가 대신 하도록 짜인 템플릿입니다. 옵시디언(마크다운 노트 앱) 볼트 구조와, 그 안에서 Claude Code가 따라야 할 지침(스킬) 묶음이 세트로 들어 있습니다.

raw에 넣으면 무슨 일이 일어나는가

웹 클리퍼로 글을 저장하면 원문 그대로 raw/ 폴더에 들어갑니다. 여기서 /ingest 명령을 실행하면 에이전트가 원문을 읽고, 요약과 핵심 개념을 뽑아 [[위키링크]]로 기존 페이지와 이어 붙인 위키 페이지를 만듭니다.

글 한 편을 넣고 나면 확인할 지점은 세 가지입니다.

1. 생성된 페이지에 요약과 태그가 붙은 프런트매터가 들어갔는가
2. 본문 속 핵심 개념이 [[위키링크]]로 표시됐는가
3. 그 링크가 기존 페이지와 실제로 연결됐는가 — 저장소는 "연결되지 않은 페이지는 일주일 안에 잊힌다"는 것을 핵심 설계 원칙으로 내세웁니다

볼트 안은 두 구역으로 나뉩니다. 아는 것을 쌓는 위키 폴더와, 지금 하고 있는 작업을 담는 프로젝트 폴더입니다. 새 자료가 들어오면 기존 페이지 옆에 새 글을 쌓는 대신 있던 페이지를 고쳐 쓴다는 점이 이 구조의 핵심 주장입니다. 의견이 서로 다른 자료가 들어와도 지우지 않고 날짜와 출처를 남겨 둔다는 원칙도 함께 적혀 있습니다.

어디서 판단이 갈리는가

저장소는 이 도구를 팀 위키나 노션 대체용으로 쓰지 말라고 스스로 못 박습니다. 개인이 계속 자료를 넣어야 굴러가는 구조라는 뜻입니다.

또 하나 눈에 띄는 대목은 벡터 데이터베이스를 굳이 먼저 쓰지 않는다는 결정입니다. 개인 자료는 양이 적고 이미 구조화돼 있으니, 링크를 촘촘히 쌓은 페이지만으로 필요한 답을 찾을 수 있다는 논리입니다. 읽는 자료가 많고 정리가 안 된다고 느끼는 사람에게는 맞는 전제지만, 실제로 몇 달 써봐야 검증되는 부분입니다.

git clone https://github.com/undefined-ui/second-brain-os.git
cp -r second-brain-os/vault-template ~/brain
mkdir -p ~/brain/.claude
cp -r second-brain-os/skills   ~/brain/.claude/skills
cp -r second-brain-os/commands ~/brain/.claude/commands
cp -r second-brain-os/agents   ~/brain/.claude/agents
cp -r second-brain-os/scripts  ~/brain/scripts
rm ~/brain/.claude/*/README.md ~/brain/scripts/README.md
cd ~/brain && claude