From 2c2d459b17e23784b6b2e4fa39aaf34fcfaad87f Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Thu, 5 Nov 2026 00:50:44 +0900 Subject: [PATCH] =?UTF-8?q?docs(operations):=20=EC=84=B1=EB=8A=A5=20?= =?UTF-8?q?=EA=B8=B0=EB=A1=9D=20=EB=AC=B8=EC=84=9C=EA=B0=80=20=EC=83=98?= =?UTF-8?q?=ED=94=8C=EA=B3=BC=20=ED=95=A8=EA=BB=98=20=EC=A7=80=EC=9B=8C?= =?UTF-8?q?=EC=A7=80=EB=8A=94=20=EA=B2=BD=EB=A1=9C=EB=A5=BC=20=EB=B0=B1?= =?UTF-8?q?=ED=8B=B1=20=EC=97=86=EC=9D=B4=20=EC=A0=81=EB=8A=94=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제 fix/r1103-release(15-02)가 performance-evidence.md에 기준선 기록 파일 (config/scale/feature-shape-ceilings.json)과 측정 테스트 (tests/unit/feature-shape-growth.test.ts)를 백틱 경로로 적었다. 둘 다 참조 기능을 복사해 재므로 test:sample-removal이 함께 지운다. 그래서 제거 fixture에서 verify:documentation이 실패하고 documentation-readiness 테스트 36건이 떨어진다(깨끗한 clone FE-GATE-020). 14-04 규칙(지울 수 있는 샘플 경로는 백틱 없이)과 2f2426a와 같은 결함이다. 고른 방법 - 두 경로를 백틱 없이 적고, 샘플과 함께 지워진다고 적는다. 검증 - verify:documentation PASS_SCOPED. 제거 fixture는 X4 재실행에서 확인한다. Refs: docs/reviews/2026-11-03-maturity-review/14-template-product-docs.md 14-04, 15-performance.md 15-02 --- docs/operations/performance-evidence.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/operations/performance-evidence.md b/docs/operations/performance-evidence.md index 65e63552..c7bd5bd9 100644 --- a/docs/operations/performance-evidence.md +++ b/docs/operations/performance-evidence.md @@ -20,7 +20,8 @@ Performance evidence is deliberately split by measurement context: 보고 예산을 정한다. 기준선 숫자는 이 문서에 적지 않는다. 손으로 적은 숫자는 두 번 낡았다. 기록은 -`config/scale/feature-shape-ceilings.json`의 `initialJavascript` 한 곳이다. +config/scale/feature-shape-ceilings.json의 `initialJavascript` 한 곳이다. 이 파일과 아래 +측정 테스트는 참조 기능을 복사해 재므로 샘플과 함께 지워진다. 그래서 경로를 백틱 없이 적는다. | 칸 | 뜻 | |---|---| @@ -28,7 +29,7 @@ Performance evidence is deliberately split by measurement context: | `perFeatureGzipBytes` | 있는 context에 참조 기능 모양 기능을 하나 더할 때 느는 초기 JS. 상한 1 KiB | | `perContextGzipBytes` | 새 context를 하나 더할 때 느는 초기 JS. 상한 512 B | -- `tests/unit/feature-shape-growth.test.ts`(unit, merge 단계)가 매번 빌드해 이 +- tests/unit/feature-shape-growth.test.ts(unit, merge 단계)가 매번 빌드해 이 값을 재고, 상한을 넘거나 기록과 다르면(합계 1% 초과, 파일 수 불일치, 기능· context 비용 10% 초과) 실패한다. 실패 메시지에 잰 값이 나온다. - 기록을 고칠 때는 `node scripts/scale/measure-feature-shape-growth.ts