인터페이스 불일치 사고 → 슬랙 공유 루틴 + 문서 최신화 습관으로 개선한 흐름
팀 프로젝트에서 API 명세를 서로 다르게 이해하고 구현한 탓에 통합 테스트 당일 인터페이스가 맞지 않는 상황이 생겼습니다. 가장 아쉬웠던 건 구두 소통에만 의존한 것이었습니다. 이후 저는 변경 사항이 생길 때마다 슬랙에 공유하고 Swagger 문서를 업데이트하는 루틴을 만들었습니다. 15분 스탠드업을 고정해서 각자 어디서 막히는지를 빠르게 드러냈고, 서로 기다리는 시간이 줄었습니다. 의사소통이 잘 된다는 것은 자주 말한다는 게 아니라 기준이 되는 문서가 항상 최신 상태라는 거라는 걸 그때 배웠습니다.
말이 아니라 기록이 소통의 신뢰를 만드는 자리라는 걸 지금도 기억합니다. 소통 방식을 바꾸는 건 개인 역량이 아니라 팀이 함께 쓰는 도구와 루틴에 달려 있다는 걸 그때 배웠습니다.