본문으로 이동
문서

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

황동진 토스 · 토스 기술 블로그

원문 보기

AI 핵심 요약

커머스 도메인에서는 여러 팀에 정책과 용어가 흩어져 같은 내용을 반복해서 묻고, 문서가 제품 변화 속도를 따라가지 못하는 문제가 있었습니다. 위키와 뉴스레터, 질문 봇, 워크숍, 길드에 이어 공지와 봇의 미답변을 바탕으로 AI가 문서 초안을 만드는 자동화를 도입했지만, 중복 문서와 오래된 정책이 신뢰 문제로 남았습니다. 이에 무엇을 지식으로 남길지, 누가 책임지고 언제 검토·폐기할지 정하는 지식 관리 기준과 의사결정 권한을 가진 Knowledge Committee를 제안했습니다. 전사 공통 원칙은 TW 챕터가 관리하고 세부 운영은 각 도메인이 맡아, 지식이 업무 흐름에서 검증되고 계속 활용되도록 하는 것이 핵심 교훈입니다.

  • 반복 질문, 중요한 의사결정, 신규 구성원이 알아야 할 내용은 조직의 지식으로 남길 대상으로 삼으세요.
  • 지식 분류는 기술 레이어·서비스 도메인·기능 단위 중 팀의 업무 구조에 맞춰 설계할 수 있습니다.
  • AI 초안은 근거를 확인하고 승인하는 절차를 두며, 현행 정책과 종료된 실험 기록을 구분해야 합니다.
  • 문서마다 책임자와 검토 주기를 정하고, 필요하면 오래된 문서를 갱신하거나 폐기하세요.
  • 전사 공통 기준과 현장별 운영을 분리하면 일관성과 도메인 상황에 맞는 유연성을 함께 확보할 수 있습니다.

소개

도구와 자동화가 있어도, 무엇을 남기고 누가 책임지고 어떤 문서를 믿을지 정하는 기준과 책임이 없으면 문서화가 제대로 굴러가지 않아요. 그 빈자리를 메워간 과정을 담았습니다.

비슷한 학습 자료

문서 한주연

2. Beyond Our Expertise

문서 한주연

This is the story of how we turned Technical Writers’ challenges and expertise into a product called "todoc", and how the process helped us take that expertise even further.

문서 한주연

Learn how Toss’s Technical Writers have expanded their role from writing documentation to designing knowledge systems for the organization.

문서 김혜빈D

TW의 암묵지를 AI에게 가르쳐서, 사람이 하던 글쓰기와 리뷰를 대신하게 만든 과정을 담았어요.

AI 코딩 AI에이전트 개발

문서 김혜빈/황동진/한주연

3. 우리 팀의 문서화는 왜 실패할까? (1)

문서 김혜빈/황동진/한주연

거의 모든 회사가 겪는 "지식이 안 쌓인다"는 문제에 어떻게 접근했고 무엇을 배웠는지 공유해요.

개발 · 프로그래밍 기타 애자일 · 협업

문서 한주연

토스의 Technical Writer들이 어떻게 '문서를 쓰는 사람'에서 '조직의 지식 시스템을 설계하는 사람'으로 일을 넓혀왔는지 소개해요.

문서 이지윤

디자이너들도 어떻게 하면 빠른 속도를 내며 전체적인 경험을 맞출 수 있을지 매 순간 고민하고 있어요.

UI/UX