동호의 블로그

1️⃣ 무엇을 했나

이번 주는 짧은 시간 안에 다른 팀 동료가 작성한 코드를 이해하고 동시에 리팩토링까지 진행해야 해서 정신없이 지나갔습니다. 어떤 날은 10시간이 넘게 슬랙에 상주하면서 팀원들과 코드를 분석하고 어떻게 개선할지를 논의했습니다. 체력적으로, 정신적으로 정말 힘든 한 주였지만 되돌아보니 그만큼 얻는 것도 많았던 것 같습니다.

페어 팀의 문서 꼼꼼히 살펴보기

먼저 저희 팀은 페어 팀이 3주 간 어떤 문제들에 집중했는지 이해하기 위해 문서들을 꼼꼼히 확인했습니다. 미션 내용에 관해서는 외부 유출이 되지 않기 때문에 자세히 말할 수는 없어서 아쉽지만, 이 과정을 거치면서 페어 팀이 3주간 집중했던 문제들을 빠르게 이해할 수 있었습니다. 특히 짧은 개발 기간임에도 불구하고 실제 요구사항과 유사하게 성능까지 고려해 핵심 기능을 체계적으로 구현한 점이 인상적이었습니다.

팀원 모두가 한 자리에 모여 코드 살펴보기

저희 팀은 짧은 시간 안에 모두가 비슷한 수준으로 코드베이스를 이해하기 위해서 각자 코드를 분석하는 방식이 아니라 애초에 한자리에 모여 함께 구조를 파악하는 방식을 선택했습니다. 코드를 살펴보다가 이해가 가지 않는 부분이 생기면 다른 동료에게 바로바로 물어볼 수 있기에 혼자 끙끙대며 고민하는 시간을 확 줄일 수 있었습니다. 게다가 팀원들끼리 의견을 주고받다 보면, '아, 이 부분 이렇게 바꾸면 더 깔끔하겠네?' 같은 사소하지만 효율적인 개선점들도 바로 공유할 수 있어 좋았던 것 같습니다.

까먹지 않게 바로바로 기록하기

활발하게 소통만 하고 지나가면 나중에 '그게 뭐였더라?' 하고 기억이 흐려지기 쉽기 때문에, 중요한 내용이나 결정 사항은 Figjam에 바로바로 기록하는 습관을 들였습니다. 덕분에 시간이 지난 지금도 저희 팀이 어떤 것들을 개선해야 할지를 빼먹지 않고 빠르게 확인할 수 있었습니다.

그루의 스터디

팀 프로젝트 외에도 그루의 권유로 [가상 면접 사례로 배우는 대규모 설계 기초] 스터디에 참여하게 되었고, 그 덕분에 주말에 시간을 내서 공부하기도 했습니다. 아직 1주차이지만, 남은 기간 동안 서로의 경험과 지식을 훔쳐(?) 가며 함께 성장할 수 있는 좋은 시간을 만들고자 합니다. 😅

2️⃣ 무엇을 배웠나

처음 보는 코드엔 AI 다이어그램이 유용하다

페어 팀이 문서화를 정말 잘해주었지만 사람이 문서화를 직접 하다 보니 간혹 누락되거나 모호하게 표현된 부분도 있었는데요. 그래서 저희 팀은 Cursor나 Codex 같은 AI 도구를 적극 활용해 코드에서 실제로 동작하는 구조와 흐름을 다이어그램으로 시각화했습니다. 덕분에 복잡한 클래스 간 관계나 호출 흐름을 한눈에 파악할 수 있었습니다. 또한 시각화된 다이어그램을 팀원들과 공유하면서 바로 의견을 나눌 수 있어, 코드 이해 속도가 빨라지는 장점도 존재했습니다.

하지만, AI가 주는 정보를 맹신하지는 않고 실제로 코드 하나하나를 직접 따라가며 검증하는 과정도 거쳤습니다. 다이어그램은 큰 흐름을 이해하는 데 큰 도움이 되었지만, 세부 로직이나 예외 처리까지 완벽하게 설명해주지는 않았기 때문입니다. 그래서 다이어그램으로 전체 구조를 파악한 뒤, 실제 코드와 함께 비교하면서 "왜 이렇게 동작하는지", "이 부분은 어떤 역할을 하는지"를 팀원들과 계속해서 이야기했습니다.

테스트 코드는 심리적 안정감을 준다

부스트캠프에 입과하기 전까지는 테스트 코드의 '테' 자도 몰랐지만, 프로젝트를 진행하다 보니 테스트 코드의 중요성을 몸으로 느끼고 있습니다. 테스트 코드가 없으니 코드 한 줄을 수정할 때에도 예상치 못한 버그가 발생할까 봐 불안했습니다. 반면에, 테스트 코드를 작성해둔 곳은 수정 후에도 기존 기능이 정상적으로 동작하는지 바로 확인할 수 있어 마음이 한결 편했습니다.

3️⃣ 무엇이 아쉬웠나

테스트 코드가 우리의 발목을 잡는건 아닐까?

한편으로는 걱정되는 마음도 있었습니다. 이번 프로젝트의 리팩토링 기간이 2주였는데, 그중 거의 1주를 테스트 코드 작성에 할애하다 보니 “이 시간을 효율적으로 쓰고 있는 걸까?” 하는 생각이 들었습니다. 장기적으로는 테스트 코드 작성이 분명히 유리하지만, 단기간 프로젝트에서는 부담으로 느껴질 수밖에 없었습니다.

그래서 저희 팀은 단위 테스트를 하나하나 작성하기보다는 e2e 테스트를 중심으로 진행하기로 했습니다. 덕분에 테스트 작성에 시간을 너무 많이 쓰지 않으면서도, 개선 작업을 병렬적으로 진행할 수 있었습니다.

문서화를 조금 더 잘할껄...

일주일 가까이 남의 코드를 이해하려 애쓰다 보니, 문득 '내가 짠 코드도 남이 보면 어려울 수 있겠다'는 생각이 들었습니다. 코드를 하나 수정하기 위해서는 그 코드와 연관되어 있는 다른 함수나 모듈까지 모두 이해해야 하고, 의도치 않은 문제가 생기지 않도록 테스트 코드도 꼼꼼히 확인해야 했습니다. 앞으로는 다른 동료의 시간을 아껴주기 위해서 문서화랑 테스트 코드를 좀 더 신경 쓰려고 합니다.

4️⃣ 다음 주 목표는!

다음 주는 이번 주에 느꼈던 아쉬운 점들을 하나하나 보완해보려고 합니다.

진행한 개선 작업에 대해 문서와 테스트 코드 꼭 작성하기

저녁 시간을 활용해 코딩 테스트 준비하기

의도적인 휴식 시간 확보하기

5️⃣ 마무리하며

한 주를 팀원들과 불태우고 주말에는 오프라인으로 만나서 밥도 먹고 보드게임도 하면서 리프레시하는 시간을 가졌습니다. 이제 팀원들과 합이 좀 맞는 듯한 느낌이 들었는데 한 주 뒤면 헤어진다는 생각을 하니 아쉽네요. 🥲 마지막 남은 한 주도 후회없이 알차게 보내야겠습니다!