Git-native 기반 Product/Engineering Truth Lane 분리를 통한 AI 에이전트 컨텍스트 제어

Context

AI 코딩 에이전트의 코드 수정 능력 향상 대비 저장소 가독성 및 문서 최신화 유지의 어려움 발생. 제품 의도(Product Intent)와 구현 상세(Implementation Detail)가 혼재된 문서 구조로 인해 AI 에이전트가 잘못된 컨텍스트를 생성하는 병목 지점 형성.

Technical Solution

• Product Truth와 Engineering Truth의 물리적/논리적 경로 분리를 통한 Workflow Boundary 설정
• '무엇을, 왜(What/Why)'에 집중하는 Product Lane과 '어떻게(How)'를 정의하는 Engineering Lane의 역할 정의
• Git-native 메타데이터를 활용하여 두 Lane 간의 상호 참조(Realized_by / Realizes) 관계를 명시한 Traceability Layer 구축
• 에이전트 작업 시작 전 Lane 분류(Product, Engineering, Both, Ambiguous) 단계를 강제하여 혼합 문서 생성을 방지하는 보수적 설계 적용
• 외부 서비스나 모델 메모리가 아닌 Git Repository 자체를 Durable Context로 활용하여 상태 일관성 확보