단일 진실 공급원

요청하신 ‘단일 진실 공급원’(type: concept) 지식 노트 작성을 완수하였습니다.

1. 작성 개요

• 파일 경로: /Users/railscraft/.gemini/antigravity-cli/scratch/llm-wiki/wiki/단일 진실 공급원.md
• 적용 규칙: 지정된 frontmatter 스키마 준수, 출처 명시, Obsidian 위키링크(CLAUDE.md, DESIGN.md, Claude Code 등) 연결, 충돌 분석 섹션 작성, 구체적 코드/프롬프트 예시 포함.

---

2. 주요 내용 요약

Frontmatter

type: concept
status: draft
core: false
tags:
  - llm
  - agent
  - design-system
  - software-architecture
aliases:
  - Single Source of Truth
  - SSOT
sources:
  - 'raw/CLAUDE.md vs DESIGN.md. What to Put in Each for Claude Code.md'
  - 'raw/DESIGN.md 워크플로우. Google Stitch와 Claude Code가 디자인-코드 핸드오프를 조용히 바꾼 방법-ko.md'
created: '2026-08-28'
updated: '2026-08-28'

본문 구조

• 한 줄 정의: 모든 데이터, 규칙, 디자인 아키텍처 요소가 오직 하나의 신뢰할 수 있는 단일 출처에서 관리되어야 한다는 설계 원칙.
• 핵심 요지:
  1. AI-인간 협업 시 생성 화면 증대에 따른 스타일/맥락 이탈(Style Drift) 방지.
  2. 운영 매뉴얼(CLAUDE.md)과 시각 단일 진실 공급원(DESIGN.md)의 역할 분리.
  3. 전통적 디자이너-개발자 핸드오프 단계의 완벽한 소멸.
  4. Git 버전 관리 시스템을 통한 디자인 시스템의 엔지니어링 산출물화.
• 상세: AI 에이전트 환경에서의 필요성, CLAUDE.md 대 DESIGN.md 비대칭 구조 표 정리, 마크다운 기반 SSOT의 3대 장점(이식성, 직관성, 버전 관리) 분석.
• 구체적 예시:
  1. Google Stitch + Claude Code 연동 실무 시나리오(습관 추적 앱 ‘Cadence’ 사례) 및 프롬프트 예시.
  2. CLAUDE.md 내 DESIGN.md 단일 진실 공급원 참조 지정 마크다운 예시.
• 충돌 분석: @DESIGN.md 상시 임포트 방식과 토큰 절약을 위한 온디맨드 조건부 읽기 지침 전략 간의 충돌 및 권장 사안 서술.
• 관련 노트: CLAUDE.md, DESIGN.md, Claude Code, Context Window, AI 보조 코딩, LLM Wiki 등과 상호 연결.