처음 맡은 프로젝트에서 자료 링크가 다 깨져 있던 썰

처음 맡은 프로젝트에서 자료 링크가 다 깨져 있던 썰… 지금 생각해도 그때는 내가 뭘 잘못한 건가 싶을 정도로 멘탈이 털렸어. 나는 신입도 아니고 경력도 있는 편이라, “기존 문서만 정리하면 되겠지” 하고 가볍게 시작했거든. 그런데 첫날부터 공유 폴더 링크부터, 회의록 첨부 링크, 참고 아키텍처 문서까지 전부가 죄다 404나 권한 없음으로 터지더라.

상황은 이랬어. 팀장님이 “이번 건은 도입 전에 자료가 잘 정리돼 있을 거야. 네가 읽고 바로 파악해줘”라고 하셨고, 나는 바로 그 링크들을 클릭했지. 근데 화면에는 “존재하지 않습니다”만 연달아 떴어. 혹시 내가 로그인 상태가 이상한가 싶어서 다른 브라우저로도 해보고, 사내망에서도 해보고, 심지어 시크릿 탭으로도 했는데 똑같더라. 그 순간 머릿속에 “내가 잘못한 게 맞나?”라는 생각이 스치고, 동시에 “아니 이건 자료 관리가…?”라는 찝찝함이 같이 올라왔어.

링크가 깨진 게 한두 개면 그냥 넘어갔을 텐데, 핵심 자료부터 순서대로 전부 먹통이었어. 요구사항 정의 문서 링크는 깨져 있고, API 명세는 이전 버전 저장소로만 이어져 있는데, 그 저장소는 이미 삭제된 상태였어. 설계 문서도 마찬가지라서, 각 모듈별로 누가 언제 어떤 결정을 했는지 추적할 길이 없었지. 나는 일단 급한 대로 내가 접근 가능한 범위에서 폴더 구조를 훑었는데, 정작 링크로 안내된 파일은 “없음” 표시로 처리돼 있더라.

그날 오후에 팀장님께 “자료 링크가 전부 권한 문제 또는 삭제된 걸로 보여요. 원본 파일이 따로 있나요?”라고 조심스럽게 물어봤어. 팀장님은 잠깐 웃으시더니 “어? 그 링크들 예전에 바꿨는데… 네가 보고 있는 건 예전에 배포된 버전일 거야. 내가 다시 정리해서 줄게”라고 하셨지. 그런데 문제는 그 ‘예전에 배포된 버전’이라는 게 이미 프로젝트 온보딩에 그대로 쓰이고 있었다는 거야. 나는 새로 들어온 사람이 아니라 ‘맡은 사람’인데도, 시작점이 이미 부러진 상태였던 셈이야.

정리해서 준다는 말이 나왔으니 나는 기다렸다가, 다음 날에도 상황이 똑같으면 그때 다시 물어보려고 메모를 해뒀어. 링크가 어디서부터 깨졌는지, 어떤 문서가 없어졌는지 체크해두고, 대신 내가 찾아낸 힌트들로 최소한의 판단을 하려고 했지. 문제는 힌트가 부족했다는 거야. 예를 들어 어떤 기능은 “이 방식으로 구현”이라고만 적혀 있고, 근거 문서가 없어. 팀 내부에서 누군가 이미 결론을 내린 건 분명한데, 그 결론이 나온 과정이 문서로는 남아있지 않으니까 내가 뭘 기준으로 이해해야 할지 계속 흔들렸어.

그래서 나는 회의록에서 단서들을 모아서 역추적하기로 했어. 이전 회의 때 나온 키워드로 검색을 해보니, 문서는 어딘가에 존재하는데 링크만 잘못 걸려 있는 듯했어. 그런데 그 파일을 찾는 과정이 또 문제였지. 파일 이름이 동일한 게 여러 개고, 수정 시점이 뒤섞여 있어서 “이게 지금 쓰는 버전 맞나?”라는 의심이 끝이 없더라. 그때부터는 내가 문서를 읽는 게 아니라, 문서의 길을 찾는 사람이 된 느낌이었어. 진짜로 ‘자료’가 아니라 ‘자료를 찾는 법’만 배우게 됐달까.

일주일 정도 지나면서는 더 이상 “곧 해결되겠지” 모드가 아니게 됐어. 나는 내가 해야 하는 산출물 일정이 있었고, 그걸 맞추려면 최소한의 명세와 설계 근거가 필요했거든. 결국 팀장님과 다시 얘기를 하고, 임시로라도 파일을 공유받는 방식으로 전환했어. 그런데 여기서도 완전히 깔끔하지 않았어. 누군가 “내 컴퓨터에 예전에 받아둔 게 있어” 하고 가져다 줬는데, 그 파일엔 또 다른 링크가 들어있고, 그 링크는 또 깨져 있고… 결국 문제는 하나가 아니라 사슬처럼 이어져 있더라.

그래도 다행이었던 건, 그 과정에서 팀 내부 사람들 의견이 한데 모이기 시작했다는 거야. 내가 “이거 안 보입니다”만 계속 말하면 분위기만 무거워지니까, 나는 찾아낸 단서와 가설을 같이 적어서 공유했어. 예를 들면 “기능 X는 A 방식으로 설계된 걸로 보이는데, 근거 문서가 없어서 확정은 못 했습니다. 확인되면 일정에 반영하겠습니다” 이런 식으로. 그러니까 다들 “아, 네가 지금 막히는 포인트가 이거구나” 하고 반응이 오더라. 결국 자료 링크가 깨진 건 단순한 실수였지만, 그게 우리 팀의 커뮤니케이션과 문서 운영 습관을 돌아보게 만드는 계기가 됐지.

마지막에는 어떻게든 프로젝트를 진행했어. 물론 처음부터 깔끔하게 시작한 느낌은 아니었지만, 내가 만든 임시 문서와 정리표가 훗날 다른 사람이 보기에도 도움이 됐다는 말은 들었어. 그리고 무엇보다, 그때 이후로는 링크를 공유할 때 “이 링크가 언제든 깨질 수 있다”는 걸 기본 전제로 깔게 됐어. 링크는 길이지만, 길이 언제 끊길지 아무도 모르니까 결국 원문 파일이나 버전 정보까지 같이 남겨야 하더라. 지금도 가끔 예전에 봤던 404 화면이 떠오르면서, 그때의 당황이 아니라 “이게 내 일이었구나” 하는 웃픈 현실감이 남아 있어.