17장
불만이 커밋까지 닿는 사슬

앞 장이 "만든 것을 어떻게 줄였나"였다면, 이 장은 "만든 것 중에 무엇이 값을 했나"다.
우리 관리자에는 피드백이라는 표가 있다. 사용자가 불편하다고 한 것을 적고, 그걸 어떻게 고쳤는지 적고, 어느 커밋에서 고쳤는지까지 연결한다.
불만 → 결정 → 커밋 → 배포일
이 사슬이 끊기지 않으면, 몇 달 뒤에도 "이 코드는 왜 이렇게 생겼나"에 답할 수 있다.
이 장은 그 표에 대한 이야기인데, 쓰려고 다시 세어 보니 내가 알던 것과 달랐다.
27건이 있다
먼저 실제 항목들이다. 제목만 봐도 이 서비스가 어떻게 변했는지 보인다.
Claude API 비용이 비싸다 → 모델 전환
과거 대화를 기억 못해서 답답하다 → 히스토리 요약 시스템
공유 시 텍스트만 가서 그림이 빠진다 → HTML 공유 페이지
채팅 중 503 에러로 응답이 끊긴다 → 인프라 이전
유아 안전 질문에 환각이 난다 → 모델 상향 + 안전 가드
발신번호가 보이스피싱인지 모르겠다 → 발신번호 분석 기능
표의 계산이 틀렸는데 못 찾겠다 → 엑셀 검산 도우미
4장의 요약 시스템도, 6장의 화자 구분 가드도 여기서 나왔다. 이 책에서 기술로 설명한 것들의 절반이 사용자 한 마디에서 시작했다.
그런데 — 사슬은 나중에 만들었다
여기가 이 장에서 정직해야 할 대목이다.
나는 이 표를 두고 "불만 27건이 전부 커밋까지 연결돼 있다"고 말해 왔다. 그런데 다시 세어 보니 그렇지 않았다.

| 건수 | |
|---|---|
| 전체 | 27 |
| 실제로 커밋이 들어 있는 것 | 20 |
| "커밋 불명확 — 수동 확인 필요"라고 적힌 것 | 4 |
| 파일 경로까지 기록된 것 | 8 |
| 배포일 기록 | 27 |
27이 아니라 20이었다. 내 측정이 틀린 이유는 1장에서 겪은 것과 똑같다 — 커밋 목록이 빈 배열인 항목을 "값이 있음"으로 세고 있었다.
비어 있는 것과 없는 것은 다르다. 그런데 대부분의 계산은 그 둘을 같게 센다.
그리고 더 중요한 것이 하나 더 있다. 출처를 세어 보면 이렇다.
운영자 백필(소급 기록) 17건
실제 신고에서 온 것 10건
27건 중 17건은 나중에 소급해서 채운 것이다. 표를 만들기 전에 이미 고쳐놓은 것들을 뒤늦게 정리해 넣었다.
소급하면 시간이 사라진다
소급 기록이 나쁘다는 말이 아니다. 없는 것보다 훨씬 낫다. 다만 소급하면 반드시 잃는 것이 있고, 그게 데이터에 그대로 남아 있다.
신고에서 배포까지 걸린 날짜를 세면 이렇게 나온다.
0일 23건 ← 소급 기록. 신고일과 배포일을 같은 날로 채웠다
20일 4건 ← 실제로 그 기간이 걸린 것
23건이 "0일"이다. 당연히 하루 만에 고친 게 아니다. 소급해 넣으면서 "언제 신고받았는지"를 모르니 배포일을 그대로 신고일에 넣은 것이다.
그래서 이 표로는 "우리는 불만을 며칠 만에 고치는가"에 답할 수 없다. 그 질문에 답할 수 있는 건 실시간으로 기록된 네 건뿐이고, 그건 전부 20일이었다.
기록은 소급해서 만들 수 있지만, 시간은 소급되지 않는다.
내용은 나중에 채울 수 있다. 어느 커밋이었는지도 git을 뒤지면 찾을 수 있다. 그런데 "언제 알았고 언제 고쳤나"는 그 순간에 안 적으면 영원히 없다. 1장에서 처음 6주의 비용을 복원할 수 없었던 것과 같은 종류다.
"모르겠다"라고 적어둔 네 건
그 표에서 내가 가장 잘했다고 생각하는 부분이 있다. 네 건에 이렇게 적혀 있다.
관련 커밋 불명확 — 수동 확인 필요
소급 정리를 하면서 커밋을 못 찾은 항목들이다. 여기서 두 가지를 할 수 있었다.
하나 — 그럴듯한 커밋을 하나 골라 넣는다. 날짜가 비슷한 것을 찾아 붙이면 표가 예뻐진다. 27/27이 된다.
둘 — 모른다고 적는다. 표에 구멍이 남는다.
둘째를 골랐고, 그게 맞았다. 첫째를 골랐다면 지금 이 장을 쓸 때 그 네 건을 사실로 믿었을 것이다. 그리고 언젠가 그 커밋을 따라가 보고 "이게 왜 여기 붙어 있지?" 하며 더 큰 혼란을 겪었을 것이다.
기록에 구멍을 남기는 것이, 구멍을 그럴듯한 것으로 메우는 것보다 낫다.
6장에서 프로필 분석기에 "모호하면 비운다"는 규칙을 세운 것과 같은 원리다. 빈 칸은 나중에 채울 수 있지만, 틀린 값은 아무도 의심하지 않는다.
요청 47건 — 거절이 더 값지다
피드백 표 옆에 요청 표가 따로 있다. 사용자가 "이런 것도 됐으면"이라고 한 것들이다.
완료 40건
보류 4건
거절 3건
완료 40건보다 나머지 7건이 이 표의 값이라고 생각한다.
보류된 것들을 보면 이렇다.
음악을 들려주면 제목을 알려주기
동물 소리를 듣고 무슨 뜻인지
말 못 하는 아기 울음소리의 의사 전달
전부 오디오를 이해하는 기능이다. 그리고 전부 보류다. 세 개가 같은 이유로 막혔다는 게 목록을 보고서야 보였다 — 우리 서비스에는 소리를 분석하는 경로가 없다. 13~15장에서 다룬 음성은 전부 대화였지 분석이 아니었다.
요청 목록을 세로로 읽으면 개별 기능이 보이고, 가로로 읽으면 빠진 축이 보인다. 셋을 따로 보면 "그건 좀 어렵겠네"인데, 모아 놓으면 "우리는 오디오 분석을 아예 안 한다"가 된다.
거절 3건은 전부 테스트로 들어온 항목이었다. 거절 사유가 남아 있지 않다는 게 이 표의 남은 약점이다. 접은 기능 45건에는 사유가 평균 141자씩 붙어 있는데(16장), 거절한 요청에는 없다.
사용자가 신고하기 전에 잡는 것
사슬의 반대편도 있다. 사용자가 말하기 전에 에러가 스스로 등록되는 장치다.
자동 캡처 버그 35건 · 유형 16종 · 2026-04-24부터
유형별로 보면 성격이 드러난다.
| 유형 | 건수 |
|---|---|
| 프론트엔드 오류 (관리자 화면) | 19 |
| 서버 오류 | 2 |
| 코드 오류 (속성·이름·타입) | 4 |
| 쿼리 취소 | 1 |
| 프론트엔드 오류 (챗봇) | 2 |
절반 이상이 관리자 화면의 오류다. 사용자가 쓰는 챗봇 쪽은 2건이다.
이 비율이 16장과 이어진다. 탭이 마흔여섯 개까지 늘어난 그 화면들이 에러도 가장 많이 냈다. 그리고 그 에러는 사용자에게 안 보였으니 아무도 신고하지 않았고, 자동 캡처가 없었다면 나도 몰랐을 것이다.
아무도 안 보는 화면은 조용히 고장난다. 조용히 고장난 것을 아는 유일한 방법은 자동으로 줍는 것이다.
상태를 보면 절반 가까이가 transient — 한 번 나고 다시 안 난 것들이다. 이걸 전부 쫓아다녔다면 시간을 다 썼을 것이다. 그래서 두 번 이상 난 것만 처리 대상으로 본다.
그래서 이 표들은 값을 했나
정직한 답은 "절반쯤"이다.
값을 한 부분 — 4장의 요약 시스템, 6장의 화자 구분, 인프라 이전. 이런 것들이 왜 만들어졌는지가 표에 남아 있어서 이 책을 쓸 수 있었다. 기억으로는 절대 복원 못 했을 것이다.
값을 못 한 부분 — 시간이 없다. 소급 기록 23건이 전부 "0일"이라 개선 속도를 재는 데는 못 쓴다. 그리고 거절 사유가 없어서 왜 안 했는지를 알 수 없다.
이 둘의 차이는 하나다. 그 순간에 적었느냐, 나중에 적었느냐.
나중에 채울 수 있는 것과 그 순간에만 남길 수 있는 것을 갈라서, 후자를 먼저 적는다.
내용은 나중에 채워도 된다. 하지만 날짜, 그때의 판단, 왜 안 했는지 — 이 셋은 그 순간을 놓치면 끝이다.
정리하면
- 불만 27건이 결정과 커밋과 배포일로 이어져 있고, 이 책 기술 장의 절반이 여기서 나왔다.
- 그런데 커밋이 실제로 붙은 것은 20건이다. 27이라고 세던 것은 빈 배열을 값으로 센 내 오류였다.
- 27건 중 17건은 소급 기록이다. 그래서 신고~배포 기간이 23건이 "0일"로 남아 있다.
- 기록은 소급할 수 있지만 시간은 소급되지 않는다.
- 커밋을 못 찾은 네 건에 "불명확"이라고 적어둔 것이 이 표에서 가장 잘한 부분이다.
- 요청 47건 중 보류·거절 7건이 더 값지다. 세로로 읽으면 기능이 보이고 가로로 읽으면 빠진 축이 보인다.
- 자동 캡처 버그 35건 중 절반 이상이 관리자 화면이다. 아무도 안 보는 화면은 조용히 고장난다.
- 나중에 채울 수 있는 것과 그 순간에만 남길 수 있는 것을 갈라야 한다.
다음 장은 이 표들을 매일 보는 일에 관한 것이다. 스물두 개의 탭을 아침마다 열어보는 대신, 이상이 나를 부르게 만든 이야기다.