Read Original
#DevOps

6. 도구를 넘어, 기준과 책임으로

6. 도구를 넘어, 기준과 책임으로
01

Summary

AI가 초안을 써줘도 해결 안 된 '문서화', 토스는 '거버넌스'로 풀었습니다

도구를 넘어 신뢰의 시스템으로, 토스 테크니컬 라이팅 챕터의 지식 관리 생존기

이 아티클은 거대 조직에서 지식이 흩어지며 발생하는 비효율을 해결하기 위한 토스의 치열한 고민을 담고 있습니다. 단순한 AI 도구 도입을 넘어, 지식의 책임 소재를 명확히 하고 선순환 구조를 설계하는 '지식 거버넌스' 수립 과정을 시니어 엔지니어의 관점에서 상세히 풀어냅니다.

  • 01AI 기반 문서 초안 자동 생성 시스템 (배포 공지 및 봇 로그 활용)
  • 02지식 관리 4대 기준 수립: 조직적 축적, 구조화, 업무 흐름 내 연결, 최신성 유지
  • 03의사결정 권한을 가진 공식 협의체 'Knowledge Committee' 운영
  • 04조직 성격에 따른 3가지 지식 분류 체계 (기술 레이어, 서비스 도메인, 기능 단위)
  • 05개인의 기억을 조직의 자산으로 전환하는 지식 생명주기 관리 프로세스

RECOMMENDATION

사내 위키가 정보의 늪이 되어버린 성장기 조직의 매니저나, 문서화가 늘 우선순위에서 밀려 고민인 테크 리드들에게 강력히 추천합니다.

The Problem

커머스 도메인의 여러 팀이 협업하는 과정에서 지식이 파편화되어 용어 혼선과 중복 문의가 발생하고, 수동 문서화 속도가 제품의 변화 속도를 따라가지 못하는 비효율이 발생했다.

The Solution

AI가 제품 변경 공지와 봇 질의응답 로그를 분석해 문서 초안을 자동 생성하는 시스템을 구축하고, 지식의 생성·관리·폐기 전 과정을 규정하는 '지식 관리 기준'과 의사결정 협의체인 'Knowledge Committee'를 도입했다.

The Result

문서 작성의 심리적 문턱을 낮추어 지식 축적의 속도를 높였으며, 전사적인 지식 거버넌스 수립을 통해 파편화된 정보들을 신뢰할 수 있는 '조직의 지식'으로 전환하는 체계를 마련했다.

Trade-off

자동화는 정보 수집 속도를 높였으나 기준이 없을 경우 낡은 정보를 기반으로 틀린 답을 내놓거나 중복 문서를 양산하는 부작용이 있었으며, 자발적 길드 형태는 실질적인 운영 강제력을 갖기 어려워 공식적인 커미티 체제로의 전환이 필요했다.

03

Key Concepts

Concept · 01

테크니컬 라이팅 (Technical Writing)

기술적인 정보를 사용자가 이해하기 쉬운 형태로 구조화하여 전달하는 전문적인 라이팅 프로세스입니다.

  • 단순 작성을 넘어 지식이 생기고 순환되는 구조를 설계하는 역할로 확장됨
  • 토스 내에서 지식 시스템의 기준과 거버넌스를 수립하는 주체로 활동
Concept · 02

지식 거버넌스 (Knowledge Governance)

조직 내 지식의 생성, 검토, 승인, 갱신 및 폐기에 이르는 전 과정을 관리하는 의사결정 체계입니다.

  • 누가 지식을 책임지고 언제 업데이트할 것인지에 대한 명확한 기준 정의
  • 도구가 해결해주지 못하는 '지식의 신뢰성' 문제를 해결하기 위한 핵심 장치
Concept · 03

지식 커미티 (Knowledge Committee)

전사적 지식 관리 기준을 정의하고 조직 간의 기준 충돌을 조율하며 실제 효력을 갖는 결정을 내리는 협의체입니다.

  • 자발적 모임인 길드와 달리 실질적인 의사결정 권한과 집행력을 보유
  • 현장의 특수성과 전사의 공통 기준 사이에서 균형을 맞추는 역할 수행