토스 프론트엔드 개발자들이 더 이상 문서를 찾지 않는 이유

토스 프론트엔드 팀은 문서 위치를 찾거나 동료의 답변을 기다리느라 개발 흐름이 끊기는 문제를 해결하기 위해, 문서를 찾아가는 대신 질문에 답하는 시스템을 만들었다. RAG 기반 챗봇 ‘박씨’는 IDE와 사내 메신저에서 문서를 바탕으로 답변하고 출처를 제공하며, ‘실록봇’은 메신저 대화를 요약해 문서 저장소에 PR을 올린다. 실록봇이 기록한 지식은 박씨의 답변 기반이 되어 반복 질문과 특정 팀원에게 지식이 집중되는 문제를 줄이는 데 기여했다. 문서를 정적인 정보 모음이 아니라 개발자의 문제 해결 흐름에 연결된 시스템으로 설계하는 것이 핵심 교훈이다.

• 문서 구조를 생산자 관점으로만 설계하면 사용자가 정보를 찾는 데 여러 단계의 탐색을 거칠 수 있다.
• RAG 챗봇은 문서에 근거한 답변과 출처를 함께 제공해 신뢰도를 높일 수 있다.
• 메신저 대화에서 재사용할 지식을 골라 자동으로 문서화하면 별도의 작성 부담을 줄일 수 있다.
• 문서 자동화 도구가 만든 PR을 검토하는 흐름으로 대화 기록을 문서 저장소에 연결할 수 있다.