Discord 채널 분리로 팀 소통 혼선 해결
목차
요즘 사내 도구 설정 변경 중에 가장 간단해 보이는 작업들이 의외로 팀 전체에 영향을 크게 미친다는 걸 다시 한번 느낀다. 이번 작업도 그런 케이스였다. 회사 전체 공지사항이 섞여 있던 Discord에서 #기획-seo학습 채널을 별도로 분리하고, 우리 시스템의 설정 파일(discord_channels.json)에 해당 채널 ID(1518466281718808616)를 명시한 것인데, 돌이켜보니 이 작은 변경이 팀의 커뮤니케이션 흐름을 얼마나 깔끔하게 정리했는지 실감한다.
왜 SEO 채널을 따로 만들었나
처음엔 단순한 문제였다. 회사 전체 공지사항, 정책 안내, 운영자 메시지가 한 개의 Discord 채널에 뒤섞여 있었다. 우리 팀이 SEO 작업을 할 때마다 "지난주 가이드라인이 어디 있더라?" 하면서 채널 히스토리를 헤매게 되었다. 팀원들은 정책 변경, 학습 자료, 긴급 공지를 구분하기 어려워했고, 중요한 공지를 놓치기도 했다.
그래서 생각해 낸 게 채널 분리였다. 정책 채널과 학습 채널을 나누되, 우리 팀이 특정하게 사용할 채널을 "전용"으로 지정하기로 했다. #기획-seo학습 채널을 하나 파고, 우리 시스템이 SEO 관련 메시지만 여기로 보내도록 라우팅했다. 이제 팀원이 채널을 열면 SEO학습과 관련된 콘텐츠만 있으니, 정보 검색 시간이 확실히 줄었다. 특정 용도의 채널을 지정한다는 건 단순해 보이지만, 정보 구조화의 기본이자 팀 간 noise를 줄이는 핵심이다.
설정 파일로 의도를 명확히 하기
discord_channels.json은 우리 시스템이 어떤 종류의 메시지를 어느 채널로 보낼지를 정의하는 map이다. 그 전에는 코드 곳곳에 채널 ID가 하드코딩되어 있었다. 새 기능을 만들 때마다 "어떤 채널에 보낼 거지?" 라는 질문이 반복되었고, 채널을 옮기려면 코드를 일일이 뒤져서 수정해야 했다.
설정 파일로 모으면서 달라진 점들:
| 항목 | Before (하드코딩) | After (설정 파일) |
|---|---|---|
| 변경 비용 | 코드 수정 → 배포 필요 | 설정 파일 수정만 가능 |
| 가독성 | 채널 ID가 뭐 하는 건지 불명확 | seo_channel_id로 의도 명시 |
| 관리 | 코드 곳곳에 산재 | 한 곳에서 중앙 관리 |
| 온보딩 | 개발자만 이해 | 팀원도 설정 구조 파악 가능 |
물론 파일 한 줄의 변경처럼 보이지만, 팀 규모가 커지고 채널이 많아질수록 이런 일관된 관리 방식이 얼마나 중요한지를 느낀다.
팀 리더 입장에서의 배운 점
이번 작업을 통해 느낀 게 몇 가지 있다.
첫째, 프로세스를 코드에 담는 것의 중요성. Discord 채널 분리는 결국 "우리 팀이 어떻게 일하는가"를 반영한다. seo_channel_id를 설정 파일에 명시하는 건 "우리는 SEO 작업에 대해 전용 커뮤니케이션 채널을 유지한다"는 팀의 정책을 코드화한 것이다. 이렇게 명시하면 새로 온 팀원도, 코드 리뷰어도 우리 팀의 의도를 곧바로 이해한다.
둘째, 팀원 의견의 중요성. 코드 리뷰에서 여러 팀원이 "정보가 섞여 있다"는 피드백을 줬다. 나도 같은 pain point를 느끼고 있었다. 리더로서 중요한 건 팀의 불편함을 인식하고, 그걸 바탕으로 해결책을 함께 찾는 것이다. "이게 좋다"고 일방적으로 밀어붙이면 팀원들이 따라오지 않는다.
셋째, 작은 변경도 영향 범위를 생각해야 한다는 것. 설정 파일 한 줄의 변경이 누구에게는 "이제 우리 채널이 깔끔해졌네" 라고 느껴지고, 다른 누구에게는 "이제 이 채널을 모니터링해야 하는군" 이라는 의미가 될 수 있다. 커밋 메시지와 코드 리뷰 과정에서 "왜 이 변경을 했는가"를 분명히 설명해야 한다.
비슷한 상황에서의 패턴
이 작업을 통해 우리 팀이 배운 패턴:
- 명확한 채널 용도 정의: 각 채널이 뭐하는 채널인지 팀원 모두가 알고 있어야 한다. 불명확하면 "이 메시지는 어디에?" 할 때마다 판단이 다르다.
- 설정 파일의 일관성: 새로운 채널이 생기거나 용도가 바뀔 때마다 설정 파일을 함께 업데이트한다. 코드 커밋과 설정 커밋을 분리하지 않는 게 낫다.
- 변경 이력 남기기: "왜 이 채널 ID로 변경했는가"를 커밋 메시지에 남긴다. 6개월 뒤 새로운 팀원이 "이 숫자가 뭐지?" 할 때 history를 통해 맥락을 알 수 있다.
- 도움말 문서화: 이 채널이 왜 필요했는지, 어떤 메시지가 여기로 가는지를 팀 wiki에 남겨 둔다.
처음엔 단순한 설정 변경으로 시작했지만, 이걸 통해 팀의 커뮤니케이션 의도를 코드로 표현하는 방법과 중요성을 다시 한번 생각하게 됐다. 다음엔 이런 종류의 구조 변경을 미리 예측하고, 설정을 더 유연하게 확장할 수 있도록 설계할 수 있을지 고민해야겠다.
🛒 이 글과 어울리는 추천 상품
*위 링크는 쿠팡파트너스 활동의 일환이며, 일정액의 수수료를 제공받을 수 있습니다.
댓글 0
첫 댓글 달아줘.