From bf612f1051e4fdc1122dea077e59b4dcf5f5c355 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Thu, 12 Nov 2026 21:36:05 +0900 Subject: [PATCH] =?UTF-8?q?ci(main):=20lychee=EA=B0=80=20=ED=8F=B4?= =?UTF-8?q?=EB=8D=94=20CLAUDE.md=20=EB=8C=80=EC=8B=A0=20AGENTS.md=EB=A5=BC?= =?UTF-8?q?=20=EB=B3=B8=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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로 본다. --- .gitea/workflows/main.yml | 2 +- docs/work/reference/gates.md | 2 +- .../bootstrap/contract/DeveloperExperienceContractTest.java | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/.gitea/workflows/main.yml b/.gitea/workflows/main.yml index 0bac68b7..a878e56a 100644 --- a/.gitea/workflows/main.yml +++ b/.gitea/workflows/main.yml @@ -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 diff --git a/docs/work/reference/gates.md b/docs/work/reference/gates.md index b9bd683b..7b5c5da7 100644 --- a/docs/work/reference/gates.md +++ b/docs/work/reference/gates.md @@ -84,7 +84,7 @@ workflow에만 있는 job: `pr.yml` `done`의 마지막 step과 `main.yml`의 `v - 커밋하는 수정이 그 source set에 없던 의존성을 쓰면 lockfile도 같은 커밋에 넣는다. desktop worktree에서 `./gradlew :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. 라운드 끝 — 합친 트리의 전체 묶음 diff --git a/src/bootstrap/app/src/test/java/dev/caskeleton/bootstrap/contract/DeveloperExperienceContractTest.java b/src/bootstrap/app/src/test/java/dev/caskeleton/bootstrap/contract/DeveloperExperienceContractTest.java index c12a565a..68700ab9 100644 --- a/src/bootstrap/app/src/test/java/dev/caskeleton/bootstrap/contract/DeveloperExperienceContractTest.java +++ b/src/bootstrap/app/src/test/java/dev/caskeleton/bootstrap/contract/DeveloperExperienceContractTest.java @@ -181,7 +181,7 @@ class DeveloperExperienceContractTest { "README.md", "docs/build.md", "src/**/README.md", - "src/**/CLAUDE.md", + "src/**/AGENTS.md", "docs/**/*.md", ".github/**/*.md"); }