피드로 돌아가기
토스 기술블로그DevOps
원문 읽기
4. 우리 팀의 문서화는 왜 실패할까? (2)
AI 기반 지식 전파 및 문서 이원화 구조를 통한 조직적 Knowledge Management 최적화
AI 요약
Context
자율적 기여 기반의 Wiki 플랫폼 운영 시 지속적 기여 유도의 한계와 지식 공유에 대한 심리적 허들이 발생함. 도메인별로 상이한 문서 업데이트 주기와 독자층의 다양성으로 인해 단일한 문서화 전략으로는 지식 파편화 문제를 해결하기 어려운 구조적 제약이 존재함.
Technical Solution
- Psychological Barrier 제거를 위한 '상담 주간' 및 '지식 푸시 봇' 도입을 통한 능동적 지식 습득 환경 구축
- AI 기반 모니터링 시스템을 통해 질문-답변 패턴과 문서 생성 빈도를 수치화하여 지식 공백 지점 식별
- 사람을 위한 '중앙 관리 문서(Technical Writer 관리)'와 AI 및 팀 내부 맥락을 위한 '레포지토리별 상세 문서'로 이원화하는 Architecture 설계
- 비개발자까지 포괄하는 추상화 수준의 가이드라인 수립 및 기능(Capability) 단위의 정책/용어/지표 문서 분리 구조 적용
- 조직의 문서 성숙도(사람 기반 $ ightarrow$ 검색 기반 $ ightarrow$ AI 봇 기반)에 따른 단계적 진단 및 맞춤형 보완 전략 수립
실천 포인트
- [ ] 문서의 독자를 개발자 외 비개발자까지 확장하여 추상화 수준을 설정했는가? - [ ] AI 학습을 위한 상세 맥락(Detail)과 사람이 읽는 요약 정보(Summary)를 분리하여 저장하고 있는가? - [ ] AI 봇의 오답 패턴을 분석하여 누락된 문서 주제나 낡은 정보를 식별하는 프로세스가 있는가? - [ ] 문서화 진입 장벽을 낮추기 위해 완성된 문서 작성 전 '기존 지식에 대한 피드백' 단계를 마련했는가?
태그