SSOT(Single Source of Truth) 뜻과 AI 시대에 관리 원본을 정하는 이유

SSOT(Single Source of Truth)는 같은 정보의 기준이 되는 관리 원본을 정하고 다른 곳이 그 기준을 참조하게 하는 원칙입니다. 한국어로 단일 진실 공급원이라고도 부릅니다. 여기서 ‘진실’은 문서 내용이 자동으로 참이라는 뜻이 아니라, 팀이 어느 정보를 기준으로 관리하고 확인할지 정한다는 뜻입니다.

예를 들어 현재 판매 가격은 가격표 원본에서 관리하고, 부서별 안내문은 그 가격표를 참조합니다. 내용이 여러 화면에 표시되거나 백업 파일이 존재해도 됩니다. 중요한 것은 같은 가격을 여러 곳에서 제각각 고치지 않는 것입니다.

주간 보고와 광고 대시보드의 숫자가 다르다고 모두 사본 문제가 생긴 것은 아닙니다. 기간과 집계 정의가 다를 수도 있습니다. 먼저 같은 정보를 비교하는지 확인한 뒤 원본과 변경 절차를 정합니다. 이 글에서는 가상 가격표를 메모장으로 만들어 첫 변경과 재확인을 연습합니다.

위 화면은 노션의 동기화 블록 예시입니다. 권한이 있는 사람이 연결된 어느 화면에서 편집하든 같은 내용이 반영됩니다. 편집 버튼이 한 화면에만 있어야 한다는 뜻은 아닙니다. 여러 화면이 같은 내용을 공유하느냐, 서로 독립된 사본을 따로 고치느냐의 차이입니다. 그림의 Unsync all은 모든 동기화를 해제하는 메뉴이며 연결을 만드는 버튼이 아닙니다. 원본 페이지의 접근 권한과 동기화 연결도 확인해야 합니다. Notion 동기화 블록 안내

데이터와 문서에 적용하는 같은 원칙

데이터베이스에서는 고객의 현재 연락처를 여러 테이블에 중복 관리하면 수정 누락이 생길 수 있습니다. 고객 정보를 관리하는 곳을 정하고 다른 곳은 고객 번호로 참조하게 만드는 것이 한 예입니다. 테이블은 같은 종류의 자료를 행과 열로 모아 둔 구조입니다.

다만 현재 연락처와 주문 당시 배송지는 다른 정보입니다. 고객이 이사했다고 이미 완료한 주문의 배송 기록을 새 주소로 덮어쓰면 안 됩니다. 주문 당시의 주소를 별도로 보존하는 것은 무조건 잘못된 중복이 아닙니다. 어느 시점의 무엇을 뜻하는지 먼저 정해야 합니다.

클라우드 데이터 처리 서비스인 Azure Databricks의 Microsoft 설명은 여러 시스템에 서로 다른 사본을 만드는 대신 일관된 데이터 접근과 관리를 제공하는 구조를 다룹니다. Google Cloud는 업무 용어의 공통 정의를 모은 용어집을 기준 원본으로 삼는 예를 안내합니다. 데이터 값뿐 아니라 지표의 뜻과 작업 규칙에도 같은 원칙을 적용할 수 있습니다. Microsoft 설명, Google Cloud 용어집 안내

회사 전체를 한 파일이나 한 서비스에 넣을 필요는 없습니다. 가격은 가격표, 고객의 현재 연락처는 고객 관리 시스템, 콘텐츠 작성 기준은 팀 문서에 두어도 항목별 기준과 책임이 분명하면 됩니다.

복사, 백업과 동기화는 역할이 다릅니다

SSOT는 이 기능들과 경쟁하는 도구가 아닙니다. 백업과 자동 복제본이 있어도 관리 원본 및 수정 절차가 분명하면 함께 쓸 수 있습니다. 양방향 동기화의 충돌 처리도 제품마다 다르므로 언제나 마지막 수정이 이긴다고 단정하지 않습니다.

링크를 넣었다고 이미 만든 PDF나 AI 답변이 저절로 바뀌지는 않습니다. 링크를 다시 열거나 데이터를 다시 가져와야 할 수 있고, 시스템이 잠시 저장한 캐시 때문에 이전 값이 보일 수도 있습니다. 캐시는 재사용을 위해 보관한 사본입니다. 원본 참조와 갱신 확인은 둘 다 필요합니다.

팀에서 기준이 어긋나는 세 가지 경우

지표 정의가 다른 경우: 광고 플랫폼의 구매와 주문 시스템의 구매는 기간과 기여 규칙, 취소 및 환불 처리에 따라 다를 수 있습니다. 어느 한쪽이 무조건 오류라고 보기 전에 보고서의 목적에 맞는 정의와 자료 원본을 정합니다.

문서를 독립 복사한 경우: 신입 안내 페이지를 부서마다 복제한 뒤 공통 연락처까지 각자 수정하면 기준이 어긋날 수 있습니다. 공통 연락처는 원본을 참조하고 부서별 내용은 별도로 관리합니다. 과거에 전달한 PDF는 당시 버전이라는 표시를 남깁니다.

AI 지침이 충돌하는 경우: 같은 규칙을 여러 파일에 복사한 뒤 일부만 수정하면 AI가 서로 다른 지시를 읽을 수 있습니다. 날짜가 새롭다는 이유만으로 항상 우선하는 것도 아니므로 도구의 지침 적용 순서와 사용자가 현재 요청한 조건을 함께 확인합니다.

사람도 AI도 원본을 잘못 고를 수 있습니다. 원본 경로와 적용 날짜를 명시하고, 충돌을 발견했을 때 담당자가 어느 기준을 적용할지 결정하도록 해야 합니다.

AI에게 원본 경로를 알려 주는 방법

Claude Code 공식 문서는 지침끼리 모순되면 어느 쪽을 따를지 일관되지 않을 수 있으므로 낡거나 충돌하는 지시를 검토하라고 안내합니다. 파일을 한곳에 모았다는 사실만으로 지침의 품질과 실행 결과가 보장되지는 않습니다. Claude Code 지침 파일 안내

예를 들어 공통 규칙이 AGENTS.md에 있으면 CLAUDE.md에 내용을 복사하는 대신 @AGENTS.md 가져오기를 사용할 수 있습니다. 이 문법은 Claude Code가 지원하는 기능이며 일반 메모장이나 모든 AI 도구가 자동으로 처리하는 문법은 아닙니다. 실제 파일 위치와 읽는 조건을 확인해야 합니다.

지원 버전의 Claude Code는 AGENTS.md를 직접 읽는 기능도 제공합니다. 기본 설정에서는 작업 경로와 상위 경로에 프로젝트용 CLAUDE.md 등이 있는지에 따라 읽는 파일이 달라지며 함께 읽는 설정도 있습니다. 기존 파일을 지우기 전에 AGENTS.md 지원 조건을 확인합니다.

규칙과 코드를 함께 버전 관리하면 어느 변경에 어떤 설명이 적용됐는지 남길 수 있습니다. 버전 관리는 수정 이력을 저장하고 이전 상태를 확인하는 기능입니다. intent.md와 spec.md 같은 업무 의도 및 요구사항 문서도 관련 코드 변경과 함께 확인하는 것이 좋습니다. 모든 업무 문서를 반드시 코드 저장소로 옮겨야 한다는 뜻은 아닙니다.

가상 가격표로 처음 만들어 봅니다

새 폴더 SSOT-연습을 만들고 텍스트 편집기에서 파일 두 개를 만듭니다. 회사의 실제 가격표와 권한 설정은 바꾸지 않습니다. md 파일 저장법이 처음이면 마크다운 파일 만들기를 먼저 확인합니다.

첫 파일 이름은 가격표.md입니다.

두 번째 파일 이름은 안내.md입니다. 같은 폴더에 저장합니다.

미리 보기를 지원하는 편집기에서는 안내.md의 가격표 링크를 열고 5,000원이 보이는지 확인합니다. 메모장만 쓴다면 ./가격표.md가 같은 폴더의 파일을 뜻하므로 그 파일을 직접 엽니다. 안내문에는 5,000원을 따로 복사하지 않습니다.

이제 가격표.md의 판매 가격을 6,000원, 현재 기준을 2026-10-04로 바꾸고 저장합니다. 안내문에서 원본을 다시 열어 6,000원과 새 날짜가 보이면 첫 변경을 확인한 것입니다. 이미 열려 있던 화면이 5,000원을 보여 준다면 저장 여부와 파일 경로를 확인하고 다시 엽니다.

왜 과거 견적은 바꾸지 않나요?

10월 3일에 작성한 가상 견적이 5,000원이었다면 그것은 당시의 기록입니다. 현재 가격표가 6,000원으로 바뀌어도 과거 견적 금액까지 고쳐 쓰지는 않습니다. 현재 새 견적에 적용할 값과 과거 계약에 적용한 값은 구분해서 관리합니다.

새 상품으로 혼자 반복합니다

가격표에 연습 펜, 2,000원을 추가하고 안내문은 수정하지 않습니다. 안내문의 링크로 다시 연 원본에서 노트 6,000원과 펜 2,000원이 함께 보이는지 확인합니다. 이후 펜 가격만 2,500원으로 바꾸고 현재 기준 날짜를 가상 날짜인 2026-10-05로 바꿉니다. 파일 아래에 변경 기록: 10월 4일 펜 2,000원 추가, 10월 5일 펜 2,500원으로 변경을 남깁니다. 다시 열어 노트 가격이 6,000원으로 유지되고 펜 가격과 날짜 및 변경 기록이 맞는지 확인합니다.

링크를 눌렀는데 파일이 없다면 두 파일이 같은 폴더인지, 실제 이름이 가격표.md.txt로 저장되지 않았는지 확인합니다. 미리 보기 대신 원문 화면에서는 링크를 눌러도 이동하지 않을 수 있으므로 파일을 직접 열어 확인합니다.

이 연습은 현재 기준을 한곳에서 바꾸고 다른 문서가 그 위치를 가리키는 동작을 익히는 것입니다. 실제 팀에 적용할 때는 읽는 사람에게 원본 접근 권한이 있고 담당자에게만 필요한 수정 권한이 있는지 확인합니다.

지표 정의서에 적용하는 방법

가격표 대신 지표 정의를 원본으로 관리할 수도 있습니다. 아래는 도구의 기본 지표가 아니라 가상 팀이 직접 정한 기준입니다.

실제 보고서에는 시간대와 집계 기간, 세금 및 취소 처리 등 필요한 조건을 더 적습니다. 구매 페이지 도달만으로 실제 결제 완료를 보장하지 않으며, ‘최근 30일 방문 없음’ 같은 자체 정의를 분석 도구의 신규 사용자와 같은 뜻으로 쓰지 않습니다.

정의가 바뀌면 새 적용 날짜와 변경 이유를 남깁니다. 과거 보고서를 재계산할 것인지도 정해야 하며 과거 기준을 지워 버리면 숫자가 달라진 이유를 설명하기 어렵습니다.

작은 팀에서 적용할 네 가지

1. 반복해서 쓰는 정보 한 가지를 고릅니다. 현재 가격이나 지표 정의처럼 범위를 좁힙니다.
2. 관리 원본과 담당자 및 수정 권한을 정합니다. 원본의 정확한 주소나 경로를 남깁니다.
3. 독립 사본은 참조로 바꾸거나 버전이 표시된 배포본으로 구분합니다. 백업과 과거 기록은 역할에 맞게 보존합니다.
4. 원본을 고친 뒤 사용하는 화면과 보고서에서 실제 적용을 확인합니다. 접근 오류와 갱신 지연이 생겼을 때 담당자에게 확인할 경로도 남깁니다.

데이터 거버넌스는 데이터를 관리하는 규칙과 역할 및 절차 전체를 뜻합니다. SSOT는 그 안에서 정보의 기준과 변경을 일관되게 관리하는 원칙입니다. 처음에는 가상 가격표처럼 원본 하나와 참조 하나를 만들고, 변경 뒤 실제로 같은 내용을 확인할 수 있는지부터 점검합니다.