AI Verification 기반 Doc-Code 동기화로 문서 부패 및 유지보수 비용 해결

Context

전체 문서 트래픽의 45.3%가 AI Agent로 전환되며 잘못된 문서 정보가 시스템 전반의 오답으로 확산되는 구조적 리스크 발생. 기존의 생성 중심 AI 접근법은 Verification 단계 부재로 인해 문서의 Drift 현상을 가속화하는 한계 노출.

Technical Solution

• AI의 역할을 Generation에서 Verification으로 전환하여 Ground Truth 기반의 신뢰성 확보
• PR Diff를 입력값으로 사용하는 CI Job 설계를 통해 코드 변경 시 Wiki Delta 작성을 강제하는 Workflow 구축
• OpenAPI, GraphQL SDL 등 Typed Schema 기반의 API 문서 생성으로 AI의 Hallucination 원천 차단
• Retrieval Grounding 기법을 적용해 실제 Route Handler 및 Schema를 앵커로 설정함으로써 답변 정확도 향상
• 결정 사항 발생 시 즉시 ADR 초안을 생성하는 Scribe Agent 도입을 통한 기록의 적시성 확보
• Scheduled AI Drift Check를 백그라운드에서 실행하여 코드와 문서 간의 불일치를 상시 감지하는 Verification Stack 운영