How Documents Find Developers at Toss
Summary
검색하지 마세요, 찾아오니까! 토스가 개발자 문서화를 자동화하는 신박한 방법
RAG 챗봇 'Mr. Park'과 슬랙 대화를 문서화하는 '실록봇'으로 완성한 능동적 지식 공유 시스템
토스 프론트엔드 챕터는 개발자들이 문서를 일일이 검색하는 대신, 지식이 개발자를 직접 찾아가도록 패러다임을 혁신했습니다. RAG 기반의 AI 챗봇 'Mr. Park'이 개발 흐름 속에서 정답을 제시하고, 사내 메신저의 유용한 대화는 '실록봇(Sillokbot)'이 스스로 감지하고 요약해 문서로 등록합니다. 문서를 쓰는 귀찮은 작업을 자연스러운 개발 문화로 녹여내어 개발자 경험(DX)과 생산성을 혁신한 토스의 노하우를 공개합니다.
- 01문서 경로 의존성 타파: 문서를 직접 찾아 들어가는 번거로움 대신 물어보면 즉시 답하는 동료 같은 환경 제공
- 02RAG 기반 챗봇 Mr. Park: IDE 및 사내 메신저에 연동되어 정확한 출처 정보와 함께 신뢰할 수 있는 개발 지식 즉시 답변
- 03지식 기록 자동화 실록봇: 메신저 스레드에 이모지만 달면 AI가 대화를 분석하고 요약하여 문서 저장소에 PR 자동 생성
- 04실시간 트러블슈팅 자산화: 개발 중 발생한 버그 해결 과정이 실시간으로 문서화되어 Mr. Park의 학습 데이터로 연동
- 05동적 지식 생태계 구축: 정적인 가이드라인에 머물던 기술 문서를 살아 숨 쉬는 문제 해결 시스템으로 진화시킴
RECOMMENDATION
사내 지식 관리 파편화와 잦은 질문 답변으로 리소스가 낭비되는 플랫폼 팀, 혹은 DX(개발자 경험)를 극적으로 개선하고 싶은 테크 리드에게 강력히 추천합니다. 슬랙 대화 요약과 RAG를 결합한 자동화 파이프라인은 초기 구축 비용 대비 가장 확실한 생산성 향상을 선사할 것입니다.
The Problem
개발자가 신규 기능을 개발할 때 사내 도구의 문서 위치를 찾지 못해 컨텍스트가 끊기거나 동료에게 직접 물어보는 상황이 빈번하게 발생했습니다. 전통적인 기술 문서는 작성자 관점으로 구조화되어 있어 정작 필요한 정보를 찾기 위해 여러 번 검색해야 하는 문서 경로 의존성 문제가 있었습니다.
The Solution
기존 지식 베이스를 기반으로 IDE와 사내 메신저에서 질문에 즉각 답해주는 RAG 기반의 챗봇 'Mr. Park'을 도입하고, 메신저 상의 트러블슈팅 및 지식 교환 대화를 자동으로 요약하여 문서 저장소에 PR을 올려주는 문서 자동화 도구 'Sillokbot'을 구축했습니다.
The Result
지식이 한 사람에게 고이지 않고 실시간으로 문서화 및 전파되는 동적 지식 순환 환경을 구축하여 프론트엔드 챕터 전체의 생산성을 크게 높였습니다. 또한 반복적인 질문 문의가 줄어들고 정보 획득에 걸리는 시간이 대폭 단축되는 효과를 얻었습니다.
Trade-off
시스템이 안정적으로 작동하려면 고품질의 지식 베이스가 지속해서 수급되어야 하므로 개발자들의 자발적인 실록봇 이모지 반응 참여가 필수적이며, 자동 생성된 요약 문서의 PR 검토 및 관리를 위한 추가적인 관리 공수가 존재할 수 있습니다.
Key Concepts
More from 토스
View all posts from 토스
AI가 팀 규칙을 지키도록 하는 방법
LLMCoding AgentContext Window2시간 전
2. Beyond Our Expertise
Technical WritingSingle Source of TruthGenerative AI22시간 전1. Creating a Role That Didn’t Exist Before
Technical WritingAI ChatbotRAG22시간 전
AI가 만든 코드가 어드민이 되기까지
Reactesbuild-wasmImport Map3일 전
1%가 겪은 버그 고쳐야할까요?
HotfixProgressive DeliveryQA Platform1주 전
