DongHyeonkaandClaude Opus 5
0650d91def
rewriting-technical-prose-naturally 를 서브에이전트 셋으로 나눠 56편에 적용했다. ai-tells.md 의 첫 절대로 다른 표현으로 바꾸는 대신 문장을 통째로 지웠다. 설명한 것의 중요성을 다시 평가하는 꼬리 19 이미 설명한 것을 추상어로 되풀이 19 독자에게 읽는 법을 지시하거나 오해를 가정 9 자료가 뒷받침하지 않는 덧붙인 이득 4 문서군 전체의 문형 편중도 풀었다 — 함께 27→7(한 묶음), 그대로 22→12(두 묶음), 하게 된다 1→0. 한 편에서 세 번 반복되던 「같은 병이 ~에서도 났다」와 두 기록에 같은 문장으로 있던 세 쌍을 갈랐다. 계약 제목 「여덟 자리」가 본문의 「여덟 곳」과 어긋나 있었다. 제목이 spatial-metaphor 규칙에도 걸리므로 계약과 기록을 함께 「여덟 곳」으로 맞췄다. 검사 넷 전부 통과한다 — check_prose 56편 error 0 · check_body PASS · check_evidence --repo 문제 없음 · verify-tech-log-tree error 0 warn 0. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
69 lines
3.0 KiB
Markdown
69 lines
3.0 KiB
Markdown
---
|
|
kind: REFERENCE
|
|
slug: revert-the-defect-and-watch-the-guard-fail
|
|
title: 가드는 결함을 되돌려 실제로 멈추는 것을 확인한 뒤 커밋한다
|
|
topic: when-a-guard-can-be-trusted
|
|
topicName: 가드를 언제 믿을 수 있는가
|
|
project: TechLog
|
|
status: 게시 전
|
|
verifiedOn: 2026-09-04
|
|
evidence:
|
|
- ../../../final/evidence/raw/guards/guards-actually-fail.txt
|
|
sourceRevision: tech-log@2026-09-02
|
|
source:
|
|
- final/document.md#§15
|
|
- final/document.md#§3.5
|
|
- final/document.md#§17.4
|
|
---
|
|
|
|
# 가드는 결함을 되돌려 실제로 멈추는 것을 확인한 뒤 커밋한다
|
|
|
|
결함을 되돌려 실제로 빨개지는 것을 확인한 뒤에 커밋한다. 확인하지 않은 가드는 그 결함이 원래 없었는지 검사가 안 도는지 구별되지 않는다.
|
|
|
|
## 관계
|
|
|
|
- **가드는 작동했는데 제가 그것을 돌리지 않아 두 번 새어 나갔다**
|
|
가드가 정확해도 돌리지 않으면 소용없다는 사건이다.
|
|
- **매번 우는 검사는 읽히지 않는다 — 기대된 실패는 조건을 적어 빼고 나머지는 전부 실패시킨다**
|
|
가드가 늘 빨간 상태로 남는 다른 실패 모양이다.
|
|
- **이음매마다 그 이음매를 실제로 지나는 검사를 하나씩 둔다**
|
|
어디에 가드를 둘지를 다루는 기준이다.
|
|
|
|
## 목적
|
|
|
|
무엇도 잡지 못하는 가드가 초록불로 남는 것을 막는다. 이 상태는 가드가 있는 것과 화면에서 구분되지 않는다.
|
|
|
|
## 규칙
|
|
|
|
**결함을 되돌려 그 가드가 실제로 멈추는 것을 확인한 뒤 커밋한다**
|
|
계약에서 값을 빼고 대조 검사가 빨개지는지 본다. 매핑을 떼어 보고 그 연산 하나를 짚는지 본다.
|
|
|
|
**가드가 짚는 대상이 하나인지 본다**
|
|
전부를 짚으면 어디가 문제인지 알 수 없고, 결과가 곧 읽히지 않는다.
|
|
|
|
**되돌릴 수 없는 것은 현재 상태를 대신 증거로 남긴다**
|
|
이미 마이그레이션으로 고친 데이터는 실패 상태를 다시 만들 수 없다. 그럴 때는 지금 고쳐져 있다는 것을 남긴다.
|
|
|
|
**가드를 CI 에 묶는다**
|
|
사람이 기억해서 돌리는 가드는 절반만 존재한다.
|
|
|
|
## 적용 조건
|
|
|
|
재발 방지로 넣는 테스트·아키텍처 규칙·CI 게이트. 결함을 고치는 커밋에서 함께 넣을 때 걸린다.
|
|
|
|
## 예외
|
|
|
|
결함을 되돌릴 수 없는 것 — 이미 마이그레이션으로 고친 데이터, 지난 배포에서만 나던 상태 — 은 현재 상태가 고쳐져 있음을 증거로 남긴다.
|
|
|
|
기존 가드를 옮기거나 이름만 바꾸는 변경은 되돌려 확인하지 않아도 된다. 다만 옮긴 뒤에 한 번은 돌린다.
|
|
|
|
## 예시
|
|
|
|
가드 셋을 각각 결함으로 되돌려 실제로 빨개지는 것을 확인한 기록을 남겼다.
|
|
|
|
계약에서 CONCEPT 을 빼자 백엔드의 계약 대조 테스트가 빨개졌다.
|
|
|
|
매핑을 떼어 보고 계약 대조 테스트가 그 연산 하나를 정확히 짚는 것을 확인했다.
|
|
|
|
굵기 선언을 빼 보고 제목 급 검사가 실제로 멈추는 것을 확인했다.
|