Notion AI를 도입하기 전까지, 문서가 쌓이는 것과 문서가 읽히는 것이 완전히 다른 문제라는 걸 몰랐습니다. 팀에 온보딩 문서는 있었습니다. 누군가 열심히 써놓은 배포 가이드도 있었고요. 그런데 새 팀원은 여전히 Slack에서 물어봤고, 시니어 개발자는 같은 질문에 반복 답변하다 지쳐갔습니다. 이 글은 그 문제를 Notion AI로 어떻게 풀었는지, 그리고 어디서 막혔는지에 대한 경험 기록입니다.
Notion Q&A가 바꿔놓은 온보딩 풍경
Notion Q&A의 변화는 생각보다 컸습니다. Q&A란 워크스페이스 전체 콘텐츠를 대상으로 자연어 질문에 답하는 기능입니다. 쉽게 말해 팀 내 문서 전체를 학습한 사내 챗봇처럼 작동합니다.
새 팀원이 "배포 프로세스가 어떻게 돼?"라고 Q&A에 물으면, 관련 문서를 찾아 요약해주고 출처 페이지 링크까지 제시했습니다. Slack에서 누군가를 멘션할 필요가 없어졌고, 시니어 개발자가 반복 답변에 소모하던 시간이 눈에 띄게 줄었습니다. 이건 예상 밖의 수확이었습니다.
한 가지 팁이 있다면, 질문 범위를 좁히는 것이 중요합니다. 특정 페이지나 담당자를 @멘션으로 지정하면 검색 정확도가 올라갑니다. 워크스페이스 전체를 뒤지도록 놔두면 엉뚱한 문서가 섞여 들어오는 경우가 있었거든요. 이 세팅 하나 차이로 답변 품질이 꽤 달라졌습니다.
다만 이 기능이 빛을 발하려면 전제 조건이 있습니다. AI가 답변을 끌어올 良質의 문서가 먼저 쌓여 있어야 한다는 점입니다. 문서가 부실하면 Q&A도 부실한 답변을 돌려줍니다. 이 부분은 솔직히 기대보다 실망스러웠습니다. 신기한 기술이기는 한데, 결국 "좋은 문서를 쓰는 팀"에게만 좋은 기술입니다. 그리고 좋은 문서를 쓰는 팀은 AI 없이도 이미 잘하고 있을 가능성이 높습니다. Q&A는 문서화 문화를 만들어주지 않고, 있는 문화를 증폭시킬 뿐입니다.
AI 자동채우기로 API 문서 50개를 5분 만에 정리한 이야기
기술 문서 관리에서 제가 가장 체감한 기능은 AI 자동채우기(AI Autofill)였습니다. AI 자동채우기란 Notion 데이터베이스의 각 행(row)에 AI가 자동으로 지정된 내용을 채워주는 기능입니다. 수십 개의 문서에 일일이 손으로 입력하던 반복 작업을 AI가 일괄 처리해준다는 뜻입니다.
저희 팀은 API 문서 목록을 Notion 데이터베이스로 관리하고 있었는데, "이 API가 어떤 기능을 하는지 한 줄 요약" 컬럼이 절반 이상 비어 있었습니다. 담당 개발자가 문서를 작성할 때 요약까지 쓰기 귀찮다 보니 자연스럽게 비워진 거였죠. AI 자동채우기로 이 컬럼 전체를 채우게 했더니, 50개 API 요약이 5분 안에 완성됐습니다. 개발자는 검토와 수정만 하면 됐고, 실제로 수정이 필요한 건 열 개 남짓이었습니다.
슬래시 커맨드 /요약하기와 /액션아이템도 회의록 관리에 바로 써먹을 수 있었습니다. /액션아이템이란 문서 내에서 할 일(TODO)과 담당자를 자동으로 추출해주는 기능으로, 회의록에서 따로 정리 문서를 만들 필요가 없어집니다. 긴 회의록을 /요약하기로 핵심만 정리하고, /액션아이템으로 후속 조치를 뽑아내는 조합이 팀에서 가장 많이 쓰인 패턴이었습니다.
실질적으로 유용한 기능을 정리하면 이렇습니다. Q&A는 자연어 질문으로 워크스페이스 전체 문서를 검색하고 요약해줍니다. AI 자동채우기는 데이터베이스 행을 일괄 채우고 키워드를 추출합니다. /요약하기는 문서 전체 핵심을 정리해주고, /액션아이템은 회의록과 TODO를 자동으로 추출합니다. Google Drive 커넥터는 외부 문서와 통합 검색을 가능하게 합니다.
이 중에서 팀 생산성에 즉각적인 영향을 준 건 Q&A와 AI 자동채우기 두 가지였고, 나머지는 쓰는 사람만 쓰는 기능이 됐습니다. Notion AI 기능을 한 번에 전부 도입하려 하면 오히려 역효과가 납니다. 팀이 자주 쓰는 워크플로 한두 개에 먼저 붙이는 것이 현실적입니다.
버전 관리의 한계와 이중 관리 체계라는 현실적 타협
버전 관리(Version Control)는 솔직히 Notion의 아킬레스건이었습니다. 버전 관리란 문서나 코드의 변경 이력을 추적하고, 필요 시 이전 상태로 되돌릴 수 있게 하는 체계입니다. Notion은 페이지 기록(Page History) 기능으로 변경 이력을 확인할 수 있지만, Git처럼 브랜치(Branch) 기반으로 병렬 수정과 병합을 관리하는 기능은 제공하지 않습니다. 브랜치란 메인 문서를 건드리지 않고 별도의 작업 흐름을 독립적으로 진행할 수 있는 기능으로, 소프트웨어 팀에서는 사실상 필수에 가깝습니다.
"2주 전 문서와 지금 문서의 차이를 비교"하거나 "이 변경을 누가, 왜 했는지 커밋 메시지(Commit Message) 형태로 남기는" 기능이 없다는 점이 실제로 불편했습니다. 커밋 메시지란 Git에서 변경 사항을 저장할 때 함께 기록하는 메모로, 왜 이 수정을 했는지 맥락을 남길 수 있습니다. Notion의 페이지 기록에는 이 맥락이 없습니다.
결국 저희 팀이 선택한 방법은 이중 관리 체계였습니다. Notion에서 기술 사양서를 작성하고 협업하되, 확정된 버전은 GitHub Wiki에도 동기화해서 보관했습니다. 이상적인 방법은 아닙니다. 두 곳을 동기화하는 데 사람 손이 들어가고, 어느 쪽이 최신인지 혼란이 생길 수도 있거든요. 실제로 한 번은 GitHub Wiki와 Notion 내용이 한 달 넘게 다른 채로 방치된 적이 있었습니다. 아무도 동기화를 챙기지 않은 거죠. 이런 이중 관리의 단점을 팀에 충분히 설명하고 시작하지 않으면, 나중에 "어디가 원본이에요?"라는 질문이 반복됩니다.
비용 문제도 빼놓을 수 없습니다. Notion AI 기능은 유료 플랜에서만 완전히 사용할 수 있으며, 팀 전체가 쓰려면 구독료가 적지 않게 나옵니다. 소규모 팀이라면 ROI(투자 대비 수익률)를 따져볼 필요가 있습니다. 특히 문서 문화가 아직 정착되지 않은 팀이라면, Notion AI보다 Notion 자체를 먼저 습관화시키는 것이 선결 과제라고 봅니다. AI는 좋은 문서를 증폭시킬 뿐, 없는 문서를 만들어내지는 못합니다.
결국 Notion AI가 제대로 작동하려면 두 가지가 선행되어야 합니다. 팀 내에 문서를 꾸준히 쌓는 문화, 그리고 그 문서의 구조를 잡아줄 사람. AI는 도구일 뿐이고, 그 도구를 의미 있게 만드는 건 여전히 조직과 사람의 몫입니다. 도입을 고민하고 계신다면, AI 기능보다 먼저 팀의 문서화 습관부터 점검해보시길 권합니다.
참고:
Notion 공식 — "Notion AI란?": https://www.notion.com/ko/help/notion-ai-faqs
Notion 공식 — "Notion AI로 할 수 있는 모든 것": https://www.notion.com/ko/help/guides/everything-you-can-do-with-notion-ai
Notion 공식 — "가이드와 튜토리얼 (Q&A)": https://www.notion.com/ko/help/guides
Notion 공식 — "Notion AI로 더 나은 글쓰기": https://www.notion.com/ko/help/guides/notion-ai-for-docs