docs(perf): 초기 JS 예산 폭의 근거와 되돌림 규칙을 적는다

문제: D7이 초기 JS 예산을 204,800 → 206,848 B로 올렸다(`287dc6f`). 드릴
(FE-GATE-020, 생성 기능 둘)이 넘은 양은 665 B(CI env)인데 2,048 B를 올렸다.
문서는 올린 뒤 여유만 적고 왜 그 폭인지, 언제 다시 내리는지를 적지 않는다.
재검토 조건 "예산을 또 넘을 때"는 이번 상향의 조건과 같아서, 내릴 조건이 없다.
다음 담당자는 예산을 넘었을 때 올릴지 줄일지 문서에서 알 수 없다.

고른 방법: 메인 세션 결정 D9를 따른다. 206,848 B를 그대로 두고
`docs/operations/performance-evidence.md`의 예산 항목에 세 가지를 적는다.
- 폭의 근거: 드릴 측정값 205,465 B(CI env, `bbde570`) + 기능 하나의 상한
  1 KiB = 206,489 B를 KiB 단위로 올림해 202 KiB = 206,848 B. 드릴 위 여유
  1,383 B가 기능 하나와 올림 359 B로 나뉜다. 템플릿 자신의 몫은 이 규칙에 없다.
- 되돌림 규칙: D7의 재검토 조건마다 드릴을 다시 재고, 204,800 B 이하이면 같은
  규칙으로 내린다.
- 사용자가 이 결정을 뒤집을 수 있다.
버린 대안(리뷰 15-01의 대안): 예산을 드릴 + 256 B로 되돌리기(다음 템플릿
변경마다 넘는다), 테스트로 예산 값을 여유 규칙에 묶기(D9가 고르지 않았다).

위험·한계: 규칙은 문서에만 있다. 예산 값을 규칙 밖으로 바꿔도 실패하는
테스트는 없다(리뷰 대안 c는 고르지 않았다). 205,465 B는 2026-11-06의 한 번
측정이고, 다음 측정은 "다시 볼 때"에 한다. 결정 기록 자체는 오케스트레이터가
2026-11-06 리뷰 README에 적는다. 이 문서는 그 파일을 가리킨다.

검증: 문서만 바꿨다. desktop batch에서 확인.
corepack pnpm verify:documentation (새로 적은 경로
`docs/reviews/2026-11-06-maturity-review/README.md`와 FE-GATE-020을 본다)
node scripts/run-vitest.ts run tests/unit/documentation-readiness.test.ts tests/unit/template-feature-removal-documents.test.ts

Refs: 1106/15-01
This commit is contained in:
DongHyeonka
2026-11-06 05:22:31 +09:00
parent ddc6353d81
commit 1eaa6447dc
+11
View File
@@ -51,6 +51,17 @@ Performance evidence is deliberately split by measurement context:
넘을 때, 또는 1103/13-03(zod 갱신, 약 7 KB)을 정할 때. 그때 03-01·02-01의
런타임 검사를 빌드 시점으로 옮기는 것부터 본다. 이 상향은 13-03을 정하지
않는다. 결정 기록은 `docs/reviews/2026-11-05-maturity-review/README.md` 16절이다.
- 폭의 근거(1106/15-01, 결정 D9): 예산은 드릴 측정값에 기능 하나의 상한
(`perFeatureGzipBytes` 상한 1 KiB)을 더해 KiB 단위로 올림한 값이다. 드릴은
CI env에서 205,465 B였다(2026-11-06, `bbde570`, FE-GATE-020). 205,465 +
1,024 = 206,489 B를 올림하면 202 KiB = 206,848 B다. 그래서 드릴 위의 여유
1,383 B는 기능 하나(1,024 B)와 올림(359 B)이다. 이 규칙에 템플릿 자신이 더
쓸 몫은 없다. 템플릿 변경이 이 여유를 쓰면 그만큼 기능 몫이 준다.
- 되돌림 규칙: 위 "다시 볼 때"마다 드릴을 다시 잰다. 드릴 측정값이 204,800 B
이하이면 같은 규칙(드릴 + 1 KiB를 KiB 단위로 올림)으로 예산을 내린다. 그때
규칙의 값은 201 KiB 이하다.
- D9(206,848 B를 그대로 둔다)는 메인 세션이 2026-11-06에 정했다. 사용자가 뒤집을
수 있다. 결정 기록은 `docs/reviews/2026-11-06-maturity-review/README.md`다.
- 기능 실행부(`feature-runtime.ts`)는 라우트에 들어갈 때 받는 lazy chunk다.
lazy chunk 예산은 파일마다 120 KiB(`lazyChunkGzipBytes`)다.