피드로 돌아가기
토스 기술블로그Infrastructure
원문 읽기
토스 기술블로그전문성 밖으로 나아가기
4만 개 페이지의 SSoT 구축을 통한 지식 관리 시스템의 자동화 및 시스템화
AI 요약
Context
SSG 기반 문서화의 높은 진입 장벽과 파편화된 지식 소스로 인한 문서 부채 발생. 비개발자의 접근성 저하 및 최신성 유지 불가능으로 인한 지식 활용 효율 급감.
Technical Solution
- SSoT(Single Source of Truth) 원칙에 기반하여 GitHub, 메신저 등 흩어진 소스를 통합하는 중앙 집중형 플랫폼 설계
- API, CLI, MCP 인터페이스 제공을 통한 AI Agent와의 유기적 연동 및 데이터 활용성 극대화
- TW의 '좋은 문서 기준'을 알고리즘화하여 AI 교정 및 초안 생성 자동화 로직 구현
- 메신저 내 의사결정과 코드 변경 사항을 실시간 모니터링하여 문서로 자동 변환하는 이벤트 기반 갱신 구조 채택
- 조직별 독립된 문서 공간을 제공하는 Multi-tenancy 구조를 통한 계열사 단위 스케일업 가능성 확보
Impact
- 런칭 후 6개월 만에 500개 이상의 문서 및 40,000개 이상의 유효 페이지 확보
- 월간 활성 사용자(MAU) 1,000명 이상의 내부 사용성 증명
Key Takeaway
개별 운영자의 수동 관리에 의존하는 것이 아니라, 도메인 전문가의 판단 기준을 시스템의 제약 조건으로 치환하여 자동화하는 '거버넌스의 제품화' 전략 필요.
실천 포인트
- 문서 작성 진입 장벽을 낮추기 위한 비개발자 친화적 Edit UX 제공 여부 검토 - 단순 저장소가 아닌 AI LLM이 읽기 좋은 구조의 데이터 스키마 설계 적용 - 수동 업데이트 대신 코드 변경 및 협업 툴의 이벤트를 트리거로 하는 문서 자동 갱신 파이프라인 구축 - 지식의 최신성을 판별하고 담당자에게 알림을 보내는 Lifecycle Management 시스템 도입