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

문서화 실패의 주요 원인은 지식 공유에 대한 심리적 부담감과 자율적인 기여를 유도하기 어려운 구조에 있다. 질문하는 것이 '모른다'는 것을 드러내는 일이라 느끼는 문화를 극복하기 위해, 토스는 질문이 자연스러운 **'개발 상담 주간'**을 운영하거나, 챗봇 **'하씨'**를 통해 매일 짧은 지식을 전달하며 참여 문턱을 낮추고 있다.

AI 기술은 문서화 방식에 큰 변화를 가져왔다. AI를 활용해 질문 답변 현황과 문서 업데이트 추이를 지표화하여 문서화 상태를 객관적으로 모니터링할 수 있게 되었다. 또한, 사람이 읽는 문서와 AI가 읽는 문서를 분리하는 전략도 도입되었다.

• 중앙 문서: 사람이 읽기 좋게 관리되는 문서
• 레포지토리 문서: 팀별 상세 맥락과 디테일을 담은 문서

결국 성공적인 문서화를 위해서는 지식을 한곳에 모으는 것이 가장 중요하며, 조직의 성격(도메인 vs 챕터)에 따라 업데이트 주기와 문서의 추상화 수준을 다르게 가져가는 전략이 필요하다.