재현 조건이 불분명한 이슈를 구조화해 정리한 경험
팀 프로젝트에서 특정 조건에서만 재현되는 버그를 담당했습니다. 발생 조건이 불분명해서 팀원들에게 설명하기가 어려웠습니다. 먼저 재현 가능한 최소 케이스를 만들고, 재현 조건과 관련 없는 변수를 하나씩 제거했습니다. 결국 특정 데이터 조합일 때만 발생한다는 걸 확인했고, 이를 「증상 → 재현 조건 → 원인 추정 → 해결 방향」 순서로 한 페이지 문서로 정리했습니다. 팀장이 읽고 5분 만에 피드백을 줬는데, 이전에 비슷한 이슈가 있었다는 것도 그때 알게 됐습니다. 복잡한 이슈일수록 구조를 먼저 잡으면 설명이 빨라진다는 걸 그때 배웠습니다. 이후로는 어떤 이슈든 최소 재현 케이스를 먼저 만드는 습관이 생겼습니다.