주석의 실측 숫자를 근거로 세운 작업이 통째로 무대상이었다

증상

코드 주석에 "실측 <날짜>: N건"이 적혀 있었다. 그 한 줄에서 "주기마다 N건을 재조회한다"는 부하 주장이 자라났고, 작업 트랙 하나가 통째로 그 위에 세워졌다. dry-run 카운트 절차까지 만들었다.

실측 결과 그 재조회는 존재한 적이 없다. 그 숫자를 집계하는 쿼리는 코드 전체에 0개였다. 우리 시스템이 보는 대상은 다른 집합이었고, 그날 실제 스캔 건수는 0. 트랙은 무대상 종결.

원인

• 주석은 스냅샷이지 값이 아니다. "실측 <날짜>: N"은 *그날 어떤 화면에 그렇게 떠 있었다*는 뜻이지 *이 코드가 그 숫자를 다룬다*는 뜻이 아니다. 둘은 완전히 다른 주장이다
• 주석은 코드 옆에 있어서 그 코드의 성질처럼 읽힌다
• 출처 표기가 있는 숫자가 더 위험하다. 근거 없는 숫자는 의심받지만, 날짜와 출처가 붙은 숫자는 인용처럼 보여 검증을 건너뛰게 만든다

해법

• 숫자를 근거로 트랙을 세우기 전에 그 숫자를 산출하는 코드를 먼저 찾는다. 못 찾으면 그건 데이터가 아니라 관측 기록이다
• 주석에 실측치를 남길 때는 무엇의 값인지를 같이 적는다 (외부 화면 육안 ≠ 우리 집계)
• 부하·규모 주장은 계약으로 못박는다 — 그 숫자를 만드는 쿼리가 나중에 생기면 계약이 깨져 알게 된다

검증

주장에 등장하는 숫자마다 "이 값을 계산하는 코드 경로가 어디인가"를 답한다. 답이 "주석"이면 근거 없음으로 취급하고 다시 실측한다.

★ 숫자를 근거로 트랙을 세우기 전에 그 숫자를 산출하는 코드를 찾는다.

---

---