팀 간 소통에서 문서화를 통해 오해를 줄인 경험
팀 프로젝트에서 프론트엔드와 백엔드 팀이 따로 개발하다가 API 스펙이 서로 달라서 통합 주에 이틀을 날린 경험이 있습니다.
그 이후로는 협업할 때 말로 합의한 것은 없는 것과 같다는 것을 기준으로 삼고 있습니다. API 정의나 인터페이스 변경 사항은 Notion이나 Confluence 같은 도구에 먼저 글로 남기고 상대방의 확인을 받은 다음 개발을 시작했습니다. 처음에는 번거롭다는 반응도 있었으나, 두 번째 통합부터는 충돌이 거의 없었습니다.
소통 방식을 바꾼 것보다 기록을 남기는 습관이 팀 전체 속도를 높였다는 것이 그때 배운 점입니다. 각자의 기억이 다르더라도 문서가 기준이 되니까 다툼이 줄었고, 새 팀원이 합류해도 맥락을 빠르게 파악할 수 있었습니다. 소통은 빈도보다 정확성이 더 중요하다는 것을 그 경험에서 배웠습니다.