Files
document-haness/docs/TechLog/tech-log-studio/when-a-guard-can-be-trusted/reference/reference-revert-the-defect-and-watch-the-guard-fail.md
T
DongHyeonkaandClaude Opus 5 f6c825e858 docs(TechLog): 글감 56개를 기록으로 쓴다
주제 13개 · Case 28 · Concept 5 · Reference 15 · Question 4 · Decision 4.
계약의 노드마다 종류가 요구하는 칸을 채우고, 본문이 있는 두 종류에는 SSOT 가 이미
그려 둔 도식 셋(value-boundaries · decision-path-404 · topic-variant-model)을
tech-log-studio/ 로 옮겨 붙였다. 새로 그린 그림은 없다.

검사 셋 전부 통과한다.
  check_body.mjs      56 편 중 본문이 있는 33 편 PASS
  check_prose.mjs     56 편 error 0
  check_evidence.mjs  --repo 포함 문제 없음
  verify-tech-log-tree.py  프로젝트 5 · error 0 · warn 0

인용한 코드블록은 전부 SSOT 에서 찾아 대조했다. check_evidence.mjs 가 본문의 각 줄과
source 앵커와 계약 제목을 다시 확인한다.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-07 15:29:33 +09:00

3.1 KiB

kind, slug, title, topic, topicName, project, status, verifiedOn, evidence, sourceRevision, source
kind slug title topic topicName project status verifiedOn evidence sourceRevision source
REFERENCE revert-the-defect-and-watch-the-guard-fail 가드는 결함을 되돌려 실제로 멈추는 것을 확인한 뒤 커밋한다 when-a-guard-can-be-trusted 가드를 언제 믿을 수 있는가 TechLog 게시 전 2026-09-04
../../../final/evidence/raw/guards/guards-actually-fail.txt
tech-log@2026-09-02
final/document.md#§15
final/document.md#§3.5
final/document.md#§17.4

가드는 결함을 되돌려 실제로 멈추는 것을 확인한 뒤 커밋한다

가드를 넣었다는 것과 그 가드가 무엇을 잡는다는 것은 다르다. 결함을 되돌려 실제로 빨개지는 것을 확인한 뒤에 커밋한다. 확인하지 않은 가드는 그 결함이 원래 없었는지 검사가 안 도는지 구별되지 않는다.

관계

  • 가드는 작동했는데 제가 그것을 돌리지 않아 두 번 새어 나갔다 가드가 정확해도 돌리지 않으면 소용없다는 사건이다.
  • 매번 우는 검사는 읽히지 않는다 — 기대된 실패는 조건을 적어 빼고 나머지는 전부 실패시킨다 가드가 늘 빨간 상태로 남는 다른 실패 모양이다.
  • 이음매마다 그 이음매를 실제로 지나는 검사를 하나씩 둔다 어디에 가드를 둘지를 다루는 기준이다.

목적

무엇도 잡지 못하는 가드가 초록불로 남는 것을 막는다. 이 상태는 가드가 있는 것과 화면에서 구분되지 않는다.

규칙

결함을 되돌려 그 가드가 실제로 멈추는 것을 확인한 뒤 커밋한다 계약에서 값을 빼고 대조 검사가 빨개지는지 본다. 매핑을 떼어 보고 그 연산 하나를 짚는지 본다.

가드가 짚는 대상이 하나인지 본다 전부를 짚으면 어디가 문제인지 알 수 없고, 결과가 곧 읽히지 않는다.

되돌릴 수 없는 것은 현재 상태를 대신 증거로 남긴다 이미 마이그레이션으로 고친 데이터는 실패 상태를 다시 만들 수 없다. 그럴 때는 지금 고쳐져 있다는 것을 남긴다.

가드를 CI 에 묶는다 사람이 기억해서 돌리는 가드는 절반만 존재한다.

적용 조건

재발 방지로 넣는 테스트·아키텍처 규칙·CI 게이트. 결함을 고치는 커밋에서 함께 넣을 때 걸린다.

예외

결함을 되돌릴 수 없는 것 — 이미 마이그레이션으로 고친 데이터, 지난 배포에서만 나던 상태 — 은 현재 상태가 고쳐져 있음을 대신 증거로 남긴다.

기존 가드를 옮기거나 이름만 바꾸는 변경은 되돌려 확인하지 않아도 된다. 다만 옮긴 뒤에 한 번은 돌린다.

예시

가드 셋을 각각 결함으로 되돌려 실제로 빨개지는 것을 확인한 기록을 남겼다.

계약에서 CONCEPT 을 빼자 백엔드의 계약 대조 테스트가 빨개졌다.

매핑을 떼어 보고 계약 대조 테스트가 그 연산 하나를 정확히 짚는 것을 확인했다.

굵기 선언을 빼 보고 제목 급 검사가 실제로 멈추는 것을 확인했다.