Files
document-haness/docs/TechLog/tech-log-studio/css-rules-that-leak/reference/reference-measure-what-is-visible-not-a-proxy.md
T
DongHyeonkaandClaude Opus 5 0650d91def docs(TechLog): 설명 뒤에 붙은 평가·예고·되풀이를 걷어낸다
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>
2026-09-07 16:03:16 +09:00

68 lines
2.8 KiB
Markdown

---
kind: REFERENCE
slug: measure-what-is-visible-not-a-proxy
title: 프록시 지표가 아니라 보이는 것을 측정한다
topic: css-rules-that-leak
topicName: CSS 규칙이 구역을 넘어 샌다
project: TechLog
status: 게시 전
verifiedOn: 2026-09-04
evidence:
- ../../../final/evidence/browser/tab-metrics.txt
sourceRevision: tech-log@2026-09-02
source:
- final/document.md#§17.5
- final/document.md#§11.2
---
# 프록시 지표가 아니라 보이는 것을 측정한다
격자와 열을 재고 「정상」이라고 답했는데, 전체 페이지 스크린샷을 찍으니 제목이 26px 에 굵기 400 이었다. 목록 간격을 바운딩 박스로만 재서 엉뚱한 곳을 결함으로 지목한 적도 있다. 화면이 잘못됐다는 보고는 보이는 것을 재서 확인한다.
## 관계
- **규칙이 없었던 게 아니라 절반만 있었다**
이 기준의 근거 사건이다.
- **구역 전체에 건 격자가 제목까지 잡아 h2 높이가 199px 이 됐다**
같은 화면에서 보이는 것을 재서 확인한 사건이다.
- **홈의 비교 구역이 세 번 바뀌었다**
폭마다 측정을 남긴 기록이다.
## 목적
화면이 잘못됐다는 보고를 확인할 때 엉뚱한 값을 재고 「정상」이라 답하는 것을 막는다.
## 규칙
**보고된 증상과 같은 축의 값을 잰다**
「제목이 작아 보인다」는 글자 크기와 굵기다. 격자와 열은 다른 축이다.
**촬영을 스크립트로 고정한다**
손으로 찍으면 뷰포트와 축소 배율이 매번 달라진다.
**폭을 고정해 여러 개를 돌고, 폭마다 측정값도 남긴다**
스크린샷만 남기면 나중에 그 값이 얼마였는지 다시 잴 수 없다.
**전체 페이지를 한 장으로 찍지 않는다**
축소되어 글자 크기가 실제와 달라진다. 화면 높이만큼 잘라 찍는다.
## 적용 조건
화면이 잘못됐다는 보고를 확인하는 일. 배포본의 실제 렌더 결과를 판단 근거로 삼을 때.
## 예외
측정 대상이 좌표나 간격 자체라면 바운딩 박스는 프록시가 아니라 대상이다.
CSS 선언이 정본과 같은지를 보는 검사는 렌더 결과를 재지 않는다. 그 검사가 덮는 범위를 알고 쓰면 된다.
## 예시
격자와 열만 재고 「정상」이라 답했다. 사용자가 다시 지적한 뒤 전체 페이지 스크린샷을 찍어서야 26px 과 400 을 봤다.
목록 간격을 바운딩 박스로만 재서 엉뚱한 구역을 결함으로 지목한 적이 있다.
브라우저 세션이 리셋되면 창이 약 877px 로 돌아가는데 이 사이트의 분기는 1179·1050·900·767 이라, 877px 에서 본 배치는 방문자 대부분이 보는 배치가 아니다.
전체 페이지를 한 장으로 찍으면 1425x4466 이 638x2000 으로 들어와 17px 글자가 7~8px 이 된다.