From d30843407f2f2b30a01fa998f83f2e739c0754ce Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Fri, 13 Nov 2026 06:37:43 +0900 Subject: [PATCH] =?UTF-8?q?docs(build-logic):=20=EC=A0=80=EC=9E=A5?= =?UTF-8?q?=EC=86=8C=20=EB=A3=A8=ED=8A=B8=EB=A5=BC=20=EB=88=84=EA=B0=80=20?= =?UTF-8?q?=EC=96=B4=EB=8A=90=20=EB=A0=88=EC=9D=B8=EC=97=90=20=EC=A3=BC?= =?UTF-8?q?=EB=8A=94=EC=A7=80=20=EB=B0=94=EB=A1=9C=20=EC=A0=81=EB=8A=94?= =?UTF-8?q?=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit build-logic/AGENTS.md는 「저장소 루트(`ca.repository.root`)는 이 두 레인에만 준다」고 적는다. 실제로 루트를 주는 것은 build-logic convention이 아니라 leaf `build.gradle`의 레인 선언(`systemProperty`)이다. 지금은 app-bootstrap의 `documentContractTest`·`repositoryContractTest` 둘이지만, 다른 leaf의 document-contract 레인도 같은 방식으로 받을 수 있다. 그러면 「두 레인」은 틀린 말이 된다. 태그 두 개로 범위를 적고, 주는 쪽이 그 leaf의 `build.gradle`이라고 적는다. 검증: scripts/verify.sh docs(노트북) rc=0. 이 문장을 읽는 시험은 없다 (git grep 'build-logic/AGENTS.md' -- '*.java': 0건). Refs: round9 리뷰 기록 5절 10번(r9-be 그룹 C) --- build-logic/AGENTS.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/build-logic/AGENTS.md b/build-logic/AGENTS.md index 22483be7..3600cfc1 100644 --- a/build-logic/AGENTS.md +++ b/build-logic/AGENTS.md @@ -14,7 +14,7 @@ registry, settings, build-logic, 루트 라이프사이클이 정하는 것을 - 테스트가 저장소 파일을 읽으면 그 파일을 그 leaf의 test task `inputs`로 선언한다. - 저장소 문서와 대조하는 테스트는 `mainStage()` 레인(`document-contract` 태그)으로 leaf `mainCheck`에서 돈다. - 문서가 아닌 저장소 파일(빌드 스크립트, workflow, Compose, 다른 leaf 소스)을 읽어야 merge 전에 막을 수 있는 계약은 그 파일만 입력으로 둔 별도 레인(app-bootstrap `repository-contract`)에 둔다. -- 저장소 루트(`ca.repository.root`)는 이 두 레인에만 준다. 그래서 태그 없이 저장소를 읽는 테스트는 `test`에서 실패한다. +- 저장소 루트(`ca.repository.root`)는 `document-contract`·`repository-contract` 태그 레인에만, 그 leaf의 `build.gradle`이 레인 선언의 `systemProperty`로 준다. convention은 주지 않는다. 그래서 태그 없이 저장소를 읽는 테스트는 `test`에서 실패한다. - 문서를 파싱해 대조하는 Gradle 검사는 두지 않는다. 문서 검사는 Gradle 밖 `scripts/check-docs.py`·`scripts/check-work-docs.py`다. ## lane 캐시와 성능 lane