Subagent 리뷰를 통한 Schema-Contract Drift 4건의 71초 내 적발

Context

12개 외부 플랫폼 API를 통합하는 Publisher UI 구축 과정에서 Frontend와 Backend 간의 Request Body 명세 불일치 발생. JSON 기반의 비정형 데이터 전송 구조로 인해 Static Analysis 및 Unit Test 단계에서 Schema Drift를 감지하지 못하는 한계 직면.

Technical Solution

• LLM 기반 Subagent를 활용한 PR 단계의 전수 Coverage Review 프로세스 도입
• Frontend의 toBody 변환 로직과 Backend Router의 Destructuring 구문을 교차 분석하는 Schema Contract 검증 수행
• Snake-case(Frontend)와 Camel-case(Backend)의 명명 규칙 충돌 및 필드 누락 여부 전수 조사
• Backend 내부에서 처리하는 Array-wrap 로직과 Frontend의 중복 래핑 구조로 인한 Data Shape 불일치 식별
• 구체적인 검토 항목(XSS, Auth, Schema 등)과 엄격한 분량 제한을 설정하여 AI의 분석 정밀도 및 Actionable한 결과 도출 유도

Impact

• 71초의 리뷰 시간으로 12개 엔드포인트 중 4개의 Blocker급 버그(400 Bad Request) 적발
• 수동 비교 시 예상 소요 시간인 10분 이상의 공수를 71초로 단축

Key Takeaway

HTTP Boundary에서 발생하는 Schema Drift는 타입 시스템이나 단위 테스트로 해결이 불가능하며, 전체 Diff를 객관적으로 조망하는 Cold Reader 관점의 교차 검증 체계가 필수적임.