docs(build-logic): 저장소 루트를 누가 어느 레인에 주는지 바로 적는다

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)
This commit is contained in:
DongHyeonka
2026-11-13 06:37:43 +09:00
parent 66a7190a83
commit d30843407f
+1 -1
View File
@@ -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