어떤 작업이었나
재시도 로직이 두 군데에 거의 똑같이 복붙돼 있어서 하나로 합치는 작업이었습니다. API 호출이 실패하면 지연 시간을 조금씩 늘려가며 다시 시도하는 백오프 함수였는데, 원래는 각 호출부에서 await와 setTimeout을 직접 썼습니다. 이걸 재귀 방식의 공용 함수로 뽑아내면서 Promise 체인 스타일로 바꿨습니다.
export function withRetry<T>(
fn: () => Promise<T>,
maxAttempts = 3,
baseDelayMs = 500
): Promise<T> {
function attempt(n: number): Promise<T> {
return fn().catch((err) => {
if (n >= maxAttempts) throw err;
sleep(baseDelayMs * n);
return attempt(n + 1);
});
}
return attempt(1);
}
function sleep(ms: number) {
return new Promise((resolve) => setTimeout(resolve, ms));
}
타입도 잘 맞고, 테스트도 통과했습니다. 실패하면 재시도하고, 최대 횟수를 넘기면 에러를 던지는 동작 자체는 맞게 돌아갔으니까요.
AI를 어떻게 활용했나
커밋하기 전에 /code-review를 돌렸습니다.
/code-review HEAD~1..HEAD
처음 돌렸을 때는 별다른 지적이 없었습니다. 그런데 터미널에 "Reusing low effort, the level you typed last time"이라는 알림이 떠 있었습니다. 며칠 전 다른 세션에서 간단한 타이포 수정 리뷰를 low로 돌린 게 그대로 남아 있다가 이번에도 재사용된 겁니다. 로직이 복잡한 리팩터링인데 가장 낮은 effort level로 훑었으니, 컴파일도 되고 테스트도 통과하는 코드에서 "확신이 설 만큼만" 보고 넘어간 셈이었습니다.
effort level을 명시해서 다시 돌렸습니다.
/code-review high HEAD~1..HEAD
이번에는 sleep(baseDelayMs * n); 줄을 짚었습니다. 이 호출의 반환값을 버리고 있어서, attempt(n + 1)이 지연 시간과 무관하게 바로 실행된다는 지적이었습니다. 원래 함수는 await sleep(...)로 지연이 끝난 뒤에야 다음 시도를 했는데, Promise 체인으로 바꾸면서 sleep()이 반환하는 Promise를 리턴 체인에 연결하지 않고 그냥 호출만 해버린 겁니다. 테스트에서는 재시도 자체가 일어나는지만 확인했어서 타이밍 버그가 전혀 드러나지 않았습니다.
고친 버전입니다.
export function withRetry<T>(
fn: () => Promise<T>,
maxAttempts = 3,
baseDelayMs = 500
): Promise<T> {
function attempt(n: number): Promise<T> {
return fn().catch((err) => {
if (n >= maxAttempts) throw err;
return sleep(baseDelayMs * n).then(() => attempt(n + 1));
});
}
return attempt(1);
}
--fix를 붙여서 다시 돌렸더니 리뷰 결과에 맞춰 이 줄을 직접 고쳐줬습니다.
/code-review high HEAD~1..HEAD --fix
결과와 얻은 팁
- effort level은 세션 단위로 기억돼서 다음 리뷰에도 그대로 재사용됩니다. 전에 돌린 작은 리뷰의 level이 큰 리팩터링에 그대로 따라붙을 수 있다는 걸 몰랐습니다. 지금은 변경 범위가 작으면 그냥 두고, 함수를 통째로 바꾸는 작업이면
/code-review high라고 매번 명시적으로 적습니다. - 이 버그는 타입 에러도 아니고 런타임 에러도 아니었습니다. 재시도는 실제로 일어났고, 함수는 결국 성공하거나 maxAttempts에서 에러를 던졌으니 "동작은 한다"고 판단하기 쉬운 코드였습니다. 지연 시간이라는 의도가 조용히 사라진 것뿐이라, 컴파일러도 테스트도 못 잡는 종류였습니다.
HEAD~1..HEAD처럼 리뷰 범위를 커밋 단위로 좁혀두면, 리팩터링과 무관한 다른 파일의 지적이 끼어들지 않아서 결과를 읽는 시간이 짧아졌습니다. PR 번호나 브랜치 비교 대신 특정 커밋 범위를 지정하는 쪽이 로컬에서 작업 중일 때는 더 편했습니다.