계정 설정과 팀 지침을 버전 관리로 정리

서비스의 외부 계정 설정(GSC/AdSense 등)과 팀 개발 지침을 docs 디렉토리에 정리하고, git 저장소에 추가했다. 산재된 정보가 버전 관리되면서 팀 전체가 동일한 정보를 참고할 수 있는 구조가 갖춰졌다.

배경 — 문서가 어디 갔지?

개발팀이 여러 서비스를 운영하다 보면 각 서비스마다 외부 플랫폼 계정(검색 엔진 콘솔, 광고 네트워크 등)과 연동해야 한다. 그런데 이런 설정 정보들이 어디에 있는가? 종종 이메일 스레드, 팀 드라이브의 스프레드시트, 혹은 누군가의 개인 노트에 산재되어 있다. 내 경험상 GSC 매핑과 AdSense 계정 정보를 찾으려고 하면 "어디 있었더라" 하면서 여러 곳을 뒤져야 했다.

그렇게 되면 뭐가 문제인가?

• 신규 팀원이 합류했을 때 누군가가 일일이 설명해줘야 한다
• 정보가 업데이트되어도 팀이 모르거나 자신도 모를 수 있다
• 정보가 분산되면서 버전 관리가 안 되고 최신이 뭔지 불명확해진다
• 의존성이 특정 사람에게만 있어 리스크가 커진다

특히 '계정 매핑'은 한 번 정하면 자주 바뀌지 않지만, 변경될 때는 팀 전체가 동기화되어야 한다. 누군가 무심코 매핑을 수정하면 다른 팀원은 여전히 옛 정보를 들고 일한다.

변경 내용 — git에 기록하다

이번 작업은 간단했다. 서비스별 설정 문서를 docs/ 디렉토리에 만들고(hedvion-CLAUDE.md), 서버 전역 지침을 정리해서 버전 관리에 올렸다(server-global-CLAUDE.md). 그 안에 GSC/AdSense 계정 매핑을 명시했다.

"명시"라는 게 뭔가 하면, 어느 서비스가 어느 계정과 연동되어 있는지를 문서로 기록하고, 그들이 코드에서 어떻게 쓰이는지까지 함께 정리하는 것이다. 나중에 누군가 "이 서비스의 광고 설정이 뭐더라?" 하면 docs를 보면 된다. git 로그로 언제 누가 변경했는지도 추적된다.

팀 문서화의 의미

이런 작업이 "작은" 것처럼 보이지만, 팀 운영 관점에서 꽤 중요하다.

첫째, 의존성을 줄인다. 계정 설정이 "운영자의 노트북"에만 있으면, 그 사람이 팀을 떠나거나 휴가 가면 팀이 난감해진다. git에 올리면 모두가 접근하고 필요시 편집할 수 있다.

둘째, 변경을 투명하게 한다. git blame을 보면 누가 언제 뭘 바꿨는지 한눈에 본다. 나중에 "어? 이 설정이 원래 이거였나?" 하는 의문이 생겨도 히스토리가 남아 있다.

셋째, 새 팀원 온보딩이 빨라진다. 지침이 repo에 있으면 "이 docs 읽어봐" 한 줄이면 된다. 개별 설명을 여러 번 반복할 필요가 없다.

특히 side 작업이 많은 팀에서는 이런 "정리"가 나중에 큰 자산이 된다. 바쁠 때는 "아, 나중에 정리하지 뭐" 하고 넘어가기 쉽지만, 한두 달 뒤 누군가가 "이거 어떻게 했었더라?" 물을 때 문서가 있으면 없을 때보다 답변 시간이 훨씬 짧다.

회고 — 정보의 위치가 중요하다

사실 이 작업의 핵심은 "정보를 어디에 두는가"다. 코드 변경도 아니고, 기능 추가도 아니지만, 팀 효율성에는 확실한 영향을 준다. 비슷한 상황들을 보면:

• 배포 절차를 위키 → repo docs로 이동
• 팀 채팅에 흩어진 디버깅 팁들을 문서로 수집
• 각 서비스가 어느 외부 API를 쓰는지 매핑해 두기

이런 작업들은 한 번 해두면 반복 비용이 급격히 줄어든다. 처음 정리할 때는 시간이 들지만, 그 이후로는 모두가 자유로워진다. 특히 외부 계정이나 환경 변수처럼 "한 번 정하면 자주 안 바뀌지만, 바뀔 때는 팀 전체가 알아야 하는" 정보들은 더더욱.

🛒 이 글과 어울리는 추천 상품

• 모니터 쿠팡에서 보기 →
• 사무의자 쿠팡에서 보기 →
• 외장SSD 쿠팡에서 보기 →

*위 링크는 쿠팡파트너스 활동의 일환이며, 일정액의 수수료를 제공받을 수 있습니다.