- Published on
디버깅 왕복을 41분에서 4분으로 줄인 기록
- Authors

- Name
- Indo Yoon
금요일 밤 11시 40분. 배포 직전에 CI가 빨갛게 물들었고, 나는 "네가 만든 거 아니잖아"라고 말할 수 있는 사람이 아니었다. 41분 뒤 원인은 내가 세 시간 전에 지운 null 체크였다.
이 글은 그 41분을 4분으로 줄인 기록이다.
실패는 조용히 온다
에이전트가 만든 실패는 대부분 시끄럽지 않다. 크래시는 오히려 친절한 쪽이다. 진짜 비용은 조용한 실패에서 나온다.
- 테스트는 초록인데 프로덕션에서만 나는 에러
- 로컬에서는 되는데 배포 후에만 404가 나는 경로
- 아무도 실패라고 부르지 않는, 그냥 "느려진" 응답
세 번째가 제일 비싸다. 실패로 인식되지 않으니 측정조차 안 된다.
시간이 아니라 회차를 세라
"디버깅에 세 시간 썼다"는 문장은 아무것도 알려주지 않는다. 그 세 시간 중 대부분은 대기였다. 실제로 값을 치른 건 왕복 횟수다.
내가 쓰는 계측은 이 네 개다.
| 항목 | 왜 보는가 |
|---|---|
| 왕복 횟수 | 가설 하나당 빌드·확인 사이클이 몇 번인가 |
| 첫 신호까지 | 문제 인지 → 첫 유효 관측까지의 시간 |
| 잘못된 가설 | 몇 번의 가설이 틀렸는가 |
| 롤백 비용 | 되돌리는 데 걸린 커밋 수 |
첫 항목이 압도적으로 중요하다. 왕복이 줄면 나머지가 따라 줄고, 왕복이 늘면 무엇을 고쳐도 비용은 늘어난다.
왕복을 줄이는 세 가지
첫째, 관측을 먼저 붙인다. 수정보다 로그가 먼저다. 가설을 세우기 전에 그 가설이 확인될 지점을 코드에 심는다. 이걸 건너뛰면 매 왕복이 추측이 된다.
둘째, 한 번에 한 변수만 바꾼다. 두 개를 동시에 바꾸면 성공해도 원인을 모르고, 실패해도 원인을 모른다. 정보량이 0인 실험이 된다.
셋째, 되돌리는 비용을 미리 낮춘다. 커밋을 잘게 쪼개 두면 롤백이 한 줄이 된다. 큰 커밋 하나는 롤백이 결정이 되고, 결정은 회의를 부른다. 회의는 왕복이다.
에이전트에게 넘길 것과 넘기지 말 것
에이전트는 왕복을 잘한다. 지치지 않고, 같은 명령을 열 번 돌려도 화내지 않는다. 그래서 관측과 반복은 넘기는 게 맞다.
반대로 넘기면 안 되는 건 무엇을 실패로 볼지 정하는 일이다. 이건 판단이고, 판단에는 책임이 붙는다. 기준을 에이전트에게 위임하면 잘못된 것을 열심히 최적화한다.
내 규칙은 단순하다. 실패의 정의는 사람이 쓰고, 그 정의를 확인하는 노동은 에이전트가 한다.
다음부터
프로덕션에서만 나는 버그를 만나면 이렇게 시작한다.
- 재현 조건을 한 문장으로 적는다. 두 문장이면 아직 모르는 것이다.
- 그 문장이 참인지 확인할 관측 지점을 먼저 붙인다.
- 가설을 하나씩, 왕복 횟수를 세면서 지운다.
- 4회를 넘기면 가설이 아니라 구조를 의심한다.
마지막 항목이 실제로 제일 자주 맞는다. 네 번 왕복해도 안 잡히는 버그는 대개 내가 잘못된 층에서 찾고 있다.