예전 노트에서 “AI는 코딩 시간을 항상 줄인다”라는 문장을 발견했다고 해 볼게요. 바로 아래에는 “숙련자는 다르게 쓰는 것 같다”와 “우리 팀도 도입하면 빨라질 것이다”가 붙어 있어요. 어느 문장이 원문의 결과이고 어느 문장이 내 생각인지 구분되지 않으면, 인용을 달아 보고서로 옮기기 어려워요.
첨부 링크는 이 글의 예제 ZIP으로 연결돼요. 압축을 푼 뒤 링크에 표시된 파일을 열면 입력·코드·완성 자료를 함께 사용할 수 있어요.
이번에는 이 합성 노트를 Obsidian에서 열 수 있는 작은 노트 묶음으로 고쳐요. 완성물은 vault 폴더의 시작 노트 (ZIP: README.md), 주장 노트 한 개, 출처 노트 두 개, 보존한 초기 노트예요. 공개 논문 두 편을 사용하며 논문 원문을 통째로 복제하지 않아요.
문장 하나마다 말하는 주체를 붙여요
처음에는 문장을 ‘원문’, ‘내 해석’, ‘미확인’으로 나누면 돼요. 여기서 원문은 반드시 직접 인용만 뜻하지 않아요. 내가 요약했다면 “원문 내용의 요약”이라고 표시하고, 따옴표는 정확한 직접 인용일 때만 사용해요. 번역·요약·추론을 모두 같은 인용 블록으로 넣으면 출처로 돌아갔을 때 문장이 보이지 않는 문제가 생겨요.
예제의 “항상 줄인다”는 문장은 출처 두 개로 지탱되지 않으므로 철회했어요. Peng의 표준 과제 연구와 Becker의 저장소 작업 연구는 환경과 측정 범위가 달라요. 이를 읽은 뒤 새 주장 C01은 “AI 코딩 도구의 시간 효과는 확인한 과제와 환경의 범위를 붙여 설명한다”로 좁혔어요. 어떤 환경 차이가 효과 차이의 원인인지는 별도의 검증이 필요해요.
‘숙련자는 다르게 쓸 것 같다’는 내 해석으로, ‘우리 팀도 빨라질 것이다’는 미검증 예측으로 남겼어요. 해석을 지워야 하는 것은 아니에요. 나중에 연구 질문이 될 수 있으므로 지위를 분명히 표시하면 돼요. 출처 노트에 내 제안을 몰래 섞지 않는 것이 핵심이에요.
출처 노트에는 링크보다 ‘돌아갈 위치’를 남겨요
S01과 S02에는 URL, 판본, 확인일, 근거 위치, 요약, 적용 범위를 넣었어요. S01은 arXiv-2302.06590v1의 Study Design·Results, S02는 arXiv-2507.09089v1의 2.2·2.3·3·4.1절로 돌아갈 수 있어요. “논문 링크”만 있으면 긴 본문에서 같은 문장을 다시 찾아야 하므로, 해당 절이나 표 이름까지 기록하는 편이 좋아요.
노트 첫머리의 type, source_id, checked, version, url은 간단한 속성이에요. Obsidian은 파일 앞부분의 YAML 형태로 속성을 저장해요. 이 예제에서는 복잡한 중첩 구조나 추가 플러그인 없이 텍스트와 날짜만 사용했어요. 공식 Properties 안내를 확인하면 속성의 지원 형식과 제한을 볼 수 있어요.
출처 노트의 적용 범위에는 “이 과제를 모든 개발 업무로 일반화하지 않음”처럼 요약이 넘어가면 안 되는 경계를 적어요. 이 한 줄이 있으면 몇 달 뒤 결과 수치만 가져와 다른 대상의 주장에 붙이는 실수를 줄일 수 있어요. 다만 제한을 적었다고 원문을 다시 확인할 필요가 없어지는 것은 아니에요. 중요한 문장에 재사용할 때는 해당 위치를 실제로 열어 봐야 해요.
주장 노트는 찬성·반대·내 판단이 만나는 곳으로 써요
C01-effect-scope.md에는 현재 주장, 근거, 내 해석, 반대 근거, 미확인, 수정 이력이 있어요. 내부 연결은 [[S01-peng#근거위치]]처럼 파일과 제목을 함께 지정했어요. Obsidian은 위키링크와 Markdown 링크, 다른 노트의 제목으로 가는 연결을 지원해요. 공식 Internal links 문서가 근거예요. 이 묶음에는 다른 Markdown 편집기에서도 파일을 찾을 수 있도록 일반 링크도 함께 넣었어요.
S02의 역할은 초기 ‘항상 줄인다’는 문장에 대한 반대 근거예요. 현재의 좁힌 주장과 반대된다고 기계적으로 표시한 것이 아니에요. 주장이 바뀌면 어떤 자료가 반대 근거인지도 달라질 수 있으므로, 반대 자료를 단순한 빨간 태그로만 남기지 말고 어느 주장과 충돌하는지 적어야 해요.
수정 이력에는 2026년 10월 13일, ‘항상 줄인다’ 철회, 조건을 붙인 주장으로 변경을 남겼어요. 초기 문장은 mixed-note.md에 보존했어요. 잘못된 문장을 지운 뒤 현재 생각만 남겨도 노트는 깨끗해지지만, 왜 판단이 달라졌는지는 잃게 돼요. 보고서를 이미 썼다면 이전 주장을 사용한 문서도 함께 확인할 수 있어야 해요.
실제 앱에서 파일과 링크 연결을 확인했어요
Obsidian의 보관함은 로컬 폴더예요. 제공한 vault 폴더를 새 연습용 위치에 복사하고 시작 화면의 ‘Open folder as vault’에 해당하는 항목으로 열면 돼요. 기존 보관함에 덮어쓰지 않고 이 작은 묶음으로 먼저 연습할 수 있어요. 공식 보관함 안내와 설치 안내를 2026년 10월 13일에 확인했어요.
이 원고의 제작에서는 공식 Linux 앱 Obsidian1.14.4를 사용자 환경과 분리해 실행하고, 제공한 실습 보관함을 실제로 열었어요. 앱 API로 초기 노트와 주장·출처 노트를 열었고, 앱의 내부 메타데이터에서 주장 노트의 링크 네 개가 S01·S02 파일로 연결되며 두 파일에 ‘근거위치’ 제목이 존재하는 것을 확인했어요. 위키링크와 Markdown 링크가 각각 두 개라 총 네 개예요. 실제 확인 기록 (ZIP: obsidian-native-run.json)과 초기 노트를 연 화면 (ZIP: obsidian-before.png)을 함께 제공해요.
그림 2는 앱에서 렌더링한 실제 화면이에요. 기존 사용자 보관함이나 동기화 계정은 사용하지 않았어요. 이 검증은 제공 파일의 열기·표시와 내부 링크 해석을 확인한 범위이며, 사람이 링크를 클릭하며 작업을 완수하는 사용성 검증은 아니에요. 앱이 없어도 일반 텍스트 편집기로 노트와 URL을 열어 같은 구분을 사용할 수 있어요.
사용할 때의 완료 기준은 간단해요. 주장 노트에서 핵심 문장 하나를 골라 출처 노트, 원문 위치까지 돌아갈 수 있어야 해요. 원문이 그 문장을 뒷받침하지 않으면 링크를 더 추가하기보다 주장부터 좁히세요. 원문 접근이 막히면 status: source-unavailable처럼 상태를 남기고 확인되지 않은 요약으로 결론을 강화하지 않아요. 새 자료가 생겼을 때는 출처 변경 기록처럼 어떤 주장과 문서가 영향을 받는지 연결하면 돼요.
작성·확인: Codex가 공개 원문 또는 공식 문서를 확인하고 예제와 초안을 작성했어요. 사람을 대상으로 한 사용성 검증은 수행하지 않았어요.
설명 삽화 2장은 GPT로 생성한 개념 설명이에요. 실제 예제의 작업 화면과 실행 결과는 기존 그림·첨부 자료에서 따로 확인할 수 있어요.