저는 1년간 300건 이상의 의사결정 로그를 기록했습니다. '왜 그 기술을 선택했는지', '왜 그 설계를 했는지' — 모든 것이 기록되어 있습니다.
본 기사에서는 SSOT(Single Source of Truth) 운영 1년 차의 지견을 설명합니다.
obsidian-ssot/
00_SYSTEM/ ← 전체 규칙・용어집・리포지토리 색인
01_DECISIONS/ ← 의사결정 로그 (300건+)
...
일기에는 자세한 내용을 직접 쓰지 않습니다. 요약 + 링크만:
## 세션 로그 (14:30)
- 백로그 자동 아카이브 구현
- 상세: 01_DECISIONS/claude-code/2026-05-24_백로그 도입.md
...
그 자리에서 기록합니다. 5분 후에는 잊어버립니다.
CLAUDE.md에 기록 규칙을 작성하고, Claude Code가 자동으로 기록하게 합니다:
Step 1: SSOT 히스토리 파일 생성
Step 2: 리포지토리 문서 업데이트
Step 3: 일기 (허브) 업데이트
...
일기에 상세 내용을 직접 쓰면 비대화되어 읽을 수 없게 됩니다.
❌ 일기에 50줄의 기술 상세를 직접 작성
✅ 일기에 3줄 요약 + 상세 파일로의 링크
나중에 한 번에 링크를 추가하는 것은 힘듭니다 (338개 파일에 한 번에 추가한 경험이 있습니다).
새로운 파일을 만들 때 반드시 관련 파일로의 링크를 작성합니다.
여러 세션을 동시에 가동하면, 태스크가 흘러 사라집니다.
00_SYSTEM/백로그.md
에 P0/P1/P2의 우선순위로 관리합니다. SessionStart hook으로 자동 로드됩니다.
❌ 01_DECISIONS/career/ ← 무엇이 들어있는지 알 수 없음
✅ 01_DECISIONS/커리어/ ← 직관적으로 알 수 있음
다만 GitHub 리포지토리명은 영어 그대로 유지합니다 (URL의 가독성을 위해).
그 자리에서 기록— '나중에 쓰기'는 금지 -
일기는 허브— 상세는 별 파일, 일기는 링크 모음 -
상호 링크— 작성 시에 작성, 나중에 한 번에 하는 것은 힘들다 -
백로그— 잊어버리는 태스크를 방지 -
일본어 폴더명— 직관적인 이해를 우선
- Claude Code 백로그 관리 자동화 — SSOT 운영을 지탱하는 태스크 관리
- 공무원이 20개 리포지토리에서 살아남는 전략 — SSOT로 관리하는 20 프로젝트의 전체 모습
- Claude Code 설정의 3계층 설계 — CLAUDE.md를 어떻게 분할할까 — SSOT과 연동되는 CLAUDE.md 설계
- Context Engineering 입문 — 47KB의 정체와 대책 — SSOT 비대화 분석 시점
이 기사는 Claude Code (GLM-5.1)와 함께 작성했습니다.
본 기사는 개인 Zenn에서도 공개하고 있습니다.
