발견 기능 품질 필터 기준 문서 교정

문서와 실제 운영 정책이 따로 노는 상황을 발견했다. VTuber 프로필 서비스의 인디(independent) 발견(discover) 기능에 적용하는 품질 임계값이 팀 지침 문서에는 "medium"이라고 적혀 있는데, 실제 정책은 "high"였다. 그래서 CLAUDE.md 파일의 해당 부분을 정정했다. 코드 한 줄 안 건드리고 문서만 고친 작은 변경이지만, 이 과정에서 팀 운영 차원의 여러 생각을 정리하게 됐다.

인디 발견 기능과 품질 관리

우리 서비스에서 "발견" 기능은 사용자가 새로운 크리에이터를 찾는 핵심 경로다. 특히 인디 버추얼 튜버들은 기존 에이전시 소속 크리에이터들에 비해 자연스럽게 노출 기회가 적을 수밖에 없다. 따라서 발견 기능을 통해 숨은 인재들을 발굴하는 것은 우리 플랫폼의 중요한 역할이다.

그런데 모든 인디 크리에이터를 무분별하게 추천할 순 없다. 사용자들이 신뢰할 수 있는 콘텐츠를 발견해야 하기 때문이다. 그래서 임계값 기반 필터링을 도입했다. 채널 나이, 정기 활동 여부, 기본적인 품질 지표 등을 종합해서 "이 정도 수준 이상의 크리에이터만 발견 추천에 올린다"는 기준을 정한 것이다.

임계값의 레벨: low, medium, high

시스템에서 기준값을 표현할 때 흔히 쓰는 방식이다. 우리의 경우 이렇게 정의했다:

우리가 실제로 돌리고 있는 운영 정책은 high다. 초기에는 medium으로 시작했을 수도 있지만, 운영하면서 사용자 피드백을 모아보니 품질이 높은 크리에이터들을 정확하게 추천하는 게 더 효과적이었다. 낮은 기준으로 많은 사람을 노출시키는 것보다, 높은 기준으로 신뢰할 수 있는 컨텐츠를 보여주는 게 장기적으로 플랫폼에 낫다는 판단이었다.

코드는 맞는데 문서가 틀렸다

여기가 문제였다. 실제 코드와 설정값은 이미 high로 맞춰져 있었다. 그런데 팀 지침 문서(CLAUDE.md)에는 여전히 medium이 기재되어 있었다.

이건 무시하기 쉬운 불일치다. 단순 오타처럼 보이니까. 하지만 영향은 크다. 신입이 팀 정책을 배우면서 문서를 읽으면 "아, 인디 발견 기능은 medium 임계값을 쓰는구나"라고 이해한다. 향후 정책 검토나 의사결정할 때도 "우리가 실제로 뭘 하고 있나?"하는 기준으로 문서를 참고하는데, 그 문서가 현실과 다르면 판단이 꼬인다.

문서 정확성의 가치

이 작업은 정말 작다. 코드 한 줄도 안 건드렸고, 단순히 문서의 숫자/단어 몇 글자를 바꿨을 뿐이다. 그런데 중요하다:

팀 운영 차원에서:
- 정책 문서가 현실과 싱크되지 않으면 팀원들이 서로 다른 기준으로 일한다
- 새로 합류한 사람이 정책을 배울 때 신뢰할 수 있는 출처가 필요하다
- 나중에 "우리가 왜 이렇게 했지?" 할 때 근거가 되는 문서가 정확해야 한다

코드 리뷰 관점에서:
- 코드가 high인데 문서가 medium이라는 것 자체가 "뭔가 점검 시스템이 작동 안 한다"는 신호다
- 변경이 있을 때마다 "코드와 문서가 정말 일치하나?" 체크하는 습관이 필요하다

앞으로의 교훈

이번 경험을 통해 몇 가지 느낀 점:

• 정책이나 설정값이 변경될 때 코드만 수정하고 문서를 놓치기 쉽다는 것. 특히 중간에 담당자가 바뀌면 더 그렇다.
• 정기적으로 문서 정확성을 감시하는 절차(체크리스트, 검수 과정)가 팀 규모가 커질수록 중요하다는 것
• "단순 문서 수정"도 팀 전체의 이해도와 신뢰도에 직결된다는 것

다음엔 정책 변경이 있을 때 코드 리뷰뿐만 아니라 관련 문서들도 한 번 더 스캔하는 습관을 들여야겠다.

🛒 이 글과 어울리는 추천 상품

• 모니터 쿠팡에서 보기 →
• 사무의자 쿠팡에서 보기 →
• 커피머신 쿠팡에서 보기 →

*위 링크는 쿠팡파트너스 활동의 일환이며, 일정액의 수수료를 제공받을 수 있습니다.