ci(main): lychee가 폴더 CLAUDE.md 대신 AGENTS.md를 본다
main.yml `links`의 lychee 범위에 `src/**/CLAUDE.md`가 있다. 폴더 지역 규칙이 같은 폴더 AGENTS.md로 옮겨 간 뒤 CLAUDE.md는 `@AGENTS.md` 한 줄이라 링크가 하나도 없다. 외부 URL이 있는 `src/**/AGENTS.md`는 범위 밖이라 그 링크가 죽어도 아무 단계도 모른다(상대 링크는 PR의 check-docs.py가 본다). 범위의 그 한 칸을 `src/**/AGENTS.md`로 바꾼다. 범위를 고정하는 DeveloperExperienceContractTest와 gates.md 2절 링크 검사 문장도 함께 바꾼다. 버린 안: 두 패턴을 다 두기 — 링크 없는 파일을 매번 읽을 뿐이다. 위험: 새로 보는 외부 링크는 messaging-kafka AGENTS.md의 Gitea 링크 하나다(코드 span 밖 URL 기준). 익명 GET이 200이라 runner에서도 통과할 것으로 본다. main push의 links job에서 확인한다. 검증: scripts/verify.sh docs(노트북) rc=0. Gradle 쪽 (DeveloperExperienceContractTest)은 PR 실행과 desktop verify.sh pr로 본다.
This commit is contained in:
@@ -98,7 +98,7 @@ jobs:
|
||||
README.md
|
||||
docs/build.md
|
||||
'src/**/README.md'
|
||||
'src/**/CLAUDE.md'
|
||||
'src/**/AGENTS.md'
|
||||
'docs/**/*.md'
|
||||
'.github/**/*.md'
|
||||
fail: true
|
||||
|
||||
@@ -84,7 +84,7 @@ workflow에만 있는 job: `pr.yml` `done`의 마지막 step과 `main.yml`의 `v
|
||||
- 커밋하는 수정이 그 source set에 없던 의존성을 쓰면 lockfile도 같은 커밋에 넣는다. desktop worktree에서 `./gradlew <gradle-path>:resolveAndLockAll --write-locks`로 다시 만들어 가져오고 `verifyDependencyLocks`로 본다. 손으로 고친 lockfile은 Gradle이 실제로 고른 버전과 다를 수 있다.
|
||||
- 탐침이 그 source set에 없는 의존성을 써야 하면 버릴 worktree에서만 `build.gradle` 한 줄을 더하고 `--write-locks`로 돌린다. 바꾼 줄(빌드 파일, lockfile)을 실행 기록에 적는다. 그렇게 하지 않기로 했으면 코드 읽기 증거(E1)로 판정한다.
|
||||
|
||||
**링크 검사**: 상대 링크는 PR마다 `scripts/check-docs.py`의 `link`가 살아 있는 문서 전부(`src/**/AGENTS.md`, `.claude/` 아래 문서 포함)를 본다. 외부 URL까지 보는 lychee는 문서 검사라 main 단계다(`main.yml` `links`, 범위 `README.md`, `docs/build.md`, `src/**/README.md`, `src/**/CLAUDE.md`, `docs/**/*.md`, `.github/**/*.md`). 저장소 밖 경로와 `file:line`은 링크로 쓰지 않는다(lychee가 따라가지 못한다).
|
||||
**링크 검사**: 상대 링크는 PR마다 `scripts/check-docs.py`의 `link`가 살아 있는 문서 전부(`src/**/AGENTS.md`, `.claude/` 아래 문서 포함)를 본다. 외부 URL까지 보는 lychee는 문서 검사라 main 단계다(`main.yml` `links`, 범위 `README.md`, `docs/build.md`, `src/**/README.md`, `src/**/AGENTS.md`, `docs/**/*.md`, `.github/**/*.md`. 폴더 `CLAUDE.md`는 `@AGENTS.md` 한 줄이라 링크가 없다). 저장소 밖 경로와 `file:line`은 링크로 쓰지 않는다(lychee가 따라가지 못한다).
|
||||
|
||||
## 3. 라운드 끝 — 합친 트리의 전체 묶음
|
||||
|
||||
|
||||
+1
-1
@@ -181,7 +181,7 @@ class DeveloperExperienceContractTest {
|
||||
"README.md",
|
||||
"docs/build.md",
|
||||
"src/**/README.md",
|
||||
"src/**/CLAUDE.md",
|
||||
"src/**/AGENTS.md",
|
||||
"docs/**/*.md",
|
||||
".github/**/*.md");
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user