Source of Truth 동기화 실패 방지를 통한 인지 비용 제거

Context

자동 생성된 state.json 파일과 수동 편집된 backlog.md 파일 간의 데이터 불일치 발생. 요약본에 의존하는 진단 프로세스로 인해 잘못된 상태 파악 및 불필요한 리소스 낭비 초래.

Technical Solution

• Source of Truth인 머신 생성 state 파일로 직접 쿼리하는 검증 프로세스 도입
• git log 분석을 통한 실제 배포 이력 기반의 1차 팩트 체크 수행
• jq를 활용한 JSON 데이터 필터링으로 미발행 상태의 정확한 수량 및 URL 추출
• Summary 파일이 아닌 Filesystem 기반의 원천 데이터 직접 참조를 통한 데이터 Drift 방지
• 상태 진단 전 Sanity Check 단계를 강제하여 잘못된 진단으로 인한 리소스 낭비 차단

Impact

• 20분 분량의 잘못된 진단 시간 및 수작업 재확인으로 인한 인지적 비용 제거
• 27초 내외의 쉘 스크립트 실행으로 실시간 데이터 정합성 검증 가능

Key Takeaway

수동 편집되는 요약 정보는 데이터 drift 발생 가능성이 매우 높으므로, 시스템 진단 시 반드시 Source of Truth를 직접 참조하는 설계를 지향함.