From c0d7ad8f52a38c7061769a4823411df9e2e1fec2 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Thu, 12 Nov 2026 21:39:33 +0900 Subject: [PATCH 1/9] =?UTF-8?q?docs(work):=20operate.md=EB=A5=BC=20150?= =?UTF-8?q?=EC=A4=84=20=EC=95=88=EC=9C=BC=EB=A1=9C=20=EC=A4=84=EC=9D=B4?= =?UTF-8?q?=EA=B3=A0=20=EB=AC=B6=EC=9D=8C=20ID=EB=A5=BC=20=EB=BA=80?= =?UTF-8?q?=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: red team 수정이 operate.md 4.3절에 요청률 제한 한 줄을 더해 151줄이 됐다(playbook 상한 150). main에서 check-work-docs.py가 rc=1이라 scripts/verify.sh docs와 라운드 끝 묶음이 실패한다. 같은 줄 끝의 "(W4 BE-OBS-A)"는 그 주 노트를 읽은 사람만 따라갈 수 있는 묶음 ID다. 진입 문서에는 ID를 쓰지 않는다(.claude/rules/docs.md). 고른 방법: 바로 위 「파생 서비스가 유지할 게이트」 줄에 한 문장으로 합치고 ID를 뺀다. 자세와 켜는 법의 정본은 docs/security/rate-limiting.md 「파생 서비스가 정할 것」이라 operate.md에는 가리키는 말만 남긴다. 버린 대안: 다른 줄을 지워 자리를 만드는 것 — 지울 만큼 낡은 줄이 없다. 위험·한계: check-work-docs.py가 PR 단계에서 돌지 않아 이 초과가 병합됐다. 그 검사를 PR 단계에 넣는 일은 workflow·build.gradle을 맡은 CI 세션에 넘겼다. 검증: python3 scripts/check-work-docs.py rc=0(operate.md 150/150). 기준 a7e38c10에서는 rc=1(151 lines, limit 150). --- docs/work/operate.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/work/operate.md b/docs/work/operate.md index 2096342b..94f4eecf 100644 --- a/docs/work/operate.md +++ b/docs/work/operate.md @@ -113,11 +113,10 @@ ssh desktop 'cd ~/workspace/<작업 이름> && git add -A && git write-tree' - 파생 서비스는 이 템플릿을 받아 도메인을 채운 repo다. 템플릿 변경을 두 방식으로 받는다: 기준 커밋을 적은 tracked snapshot에 3-way로 반영하거나(`template.lock.json`), `git merge upstream/main`을 한다. - 템플릿 쪽에서 할 일: 파생 서비스가 따라 고쳐야 하는 변경은 `docs/upgrade/`의 안내에 행을 더하고 커밋 제목에 `!`를 단다. 안내 문서 형식은 `docs/upgrade/2026-11-maturity-review.md`다. -- 파생 서비스가 유지할 게이트와 지워도 되는 템플릿 전용 게이트는 `docs/ci-cd/template-vs-consumer.md`다. +- 파생 서비스가 유지할 게이트와 지워도 되는 템플릿 전용 게이트는 `docs/ci-cd/template-vs-consumer.md`다. 요청률 제한을 어디서 거는지(앱은 기본 off, 앞단 책임)는 파생 서비스가 배포 설계에 정한다: [docs/security/rate-limiting.md](../security/rate-limiting.md) 「파생 서비스가 정할 것」. - 파생 서비스의 동기화는 루트 `CLAUDE.md`를 걸러낸다. 그래서 파생 서비스는 자기 `CLAUDE.md`에 `@AGENTS.md` 한 줄을 두고, 지도(`AGENTS.md`)에서 `docs/work/README.md`를 가리켜야 한다. `docs/work/`는 걸러지지 않는다. - `.claude/`의 추적 파일(`settings.json`의 권한과 훅, `rules/`, `skills/`, `agents/`)은 함께 넘어간다. 훅 본체는 `scripts/hooks/`다. 한 설정 단계에서 deny된 도구는 다른 단계(`settings.local.json`, 사용자 설정)의 allow로 풀리지 않는다(Claude Code 권한 문서 「Settings precedence」). 파생 서비스가 `.env` 읽기 차단 같은 권한을 바꾸려면 그 파일을 자기 repo에서 고친다. - 파생 서비스 쪽 병합과 그 게이트는 그 repo의 일이다. 템플릿 세션이 파생 서비스 repo를 고치지 않는다. -- 파생 서비스는 **요청률 제한을 어디서 거는지** 배포 설계에 정한다: 앱은 기본 off(요청 빈도는 ingress/gateway 책임), 앞단에서 안 걸면 앱 내 redis limiter를 켠다. 자세와 켜는 법은 [docs/security/rate-limiting.md](../security/rate-limiting.md)(W4 BE-OBS-A). ## 5. 완료 기준 From 48789b7c5f4d1af5a07378b5d96dc3bf81da2973 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Thu, 12 Nov 2026 21:39:43 +0900 Subject: [PATCH 2/9] =?UTF-8?q?feat(scripts):=20check-work-docs=EA=B0=80?= =?UTF-8?q?=20=EC=9E=91=EC=97=85=20=ED=9D=90=EB=A6=84=20=EC=9D=B4=EB=A6=84?= =?UTF-8?q?=EA=B3=BC=20red=20team=20ID=EB=A5=BC=20=EC=9E=A1=EB=8A=94?= =?UTF-8?q?=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: 진입 문서의 이력 ID 검사(HISTORY_PATTERNS)는 리뷰 라운드·묶음 이름의 아는 꼴만 잡는다. 2026-11 프로그램의 작업 흐름 이름(W1~W6)과 red team 발견 ID(BE-OBS-A, BE-CONFIG-001)는 꼴이 없어, operate.md에 들어간 "(W4 BE-OBS-A)"를 --history도 기본 검사도 잡지 못했다. 고른 방법: 두 꼴을 패턴에 더한다. W 뒤 숫자 하나가 단어로 서 있을 때 (W3C, HTTP-W1-x는 아님), BE·FE 뒤 대문자 분야와 세 자리 번호나 글자 하나. 지금 검사 대상 문서에는 걸리는 줄이 없다. 위험·한계: 새 이름 꼴(다른 프로그램의 흐름 이름 등)은 또 패턴을 더해야 잡힌다. 검사는 아는 꼴만 본다는 한계는 그대로다(be-docs 함정 2). 검증: 새 시험 둘(걸리는 세 줄, 걸리면 안 되는 W3C) — 기준 check-work-docs.py에 얹으면 세 줄 모두 통과해 3건 실패, 이 커밋에서 test_check_work_docs 17건 통과. check-work-docs.py rc=0. --- scripts/check-work-docs.py | 5 +++++ scripts/tests/test_check_work_docs.py | 10 ++++++++++ 2 files changed, 15 insertions(+) diff --git a/scripts/check-work-docs.py b/scripts/check-work-docs.py index ebcdc7b4..338cfbea 100755 --- a/scripts/check-work-docs.py +++ b/scripts/check-work-docs.py @@ -130,6 +130,11 @@ HISTORY_PATTERNS = [ ("finding number with its chosen option (03-11 (b))", re.compile(r"(? None: + for line in ("- 자세는 rate-limiting.md다(W4 BE-OBS-A).", "- BE-CONFIG-001로 고쳤다.", "- W4에서 정했다."): + with self.subTest(line=line): + self.repo.write("docs/work/operate.md", f"# operate.md\n\n{PLAYBOOK}{line}\n") + self.assertFailsWith("docs/work/operate.md:") + + def test_words_that_only_look_like_a_work_stream_pass(self) -> None: + self.repo.write("docs/work/operate.md", f"# operate.md\n\n{PLAYBOOK}- W3C 표준과 HTTP-W1-x는 이름이 아니다.\n") + self.assertEqual(self.repo.run()[0], 0) + def test_local_claude_state_is_not_checked(self) -> None: self.repo.write(".claude/worktrees/other/AGENTS.md", "# 다른 worktree\n\n- 리뷰 05-18.\n") self.assertEqual(self.repo.run()[0], 0) From 96bbdf6c2e5aa2a39be859b3847a27c95170cf80 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Thu, 12 Nov 2026 21:39:53 +0900 Subject: [PATCH 3/9] =?UTF-8?q?docs(work):=20=EC=9E=AC=EB=B0=B0=EC=B9=98?= =?UTF-8?q?=20=EB=92=A4=EC=97=90=EB=8F=84=20src/=EC=97=90=EC=84=9C=20Gradl?= =?UTF-8?q?e=EC=9D=84=20=EB=8F=8C=EB=A6=AC=EB=9D=BC=EB=8A=94=20=EC=A0=88?= =?UTF-8?q?=EC=B0=A8=EB=A5=BC=20=EA=B3=A0=EC=B9=9C=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: Gradle 루트를 저장소 루트로 옮긴 뒤(refactor(layout)!) src/에는 gradlew가 없다. 그런데 operate.md 4.1절 손 절차 두 곳은 아직 `cd ~/workspace/<작업 이름>/src` 다음 ./gradlew를 돌리라고 한다. desktop-gates 스킬 6단계가 단계 밖 명령(lane 하나, spotlessApply, 탐침)을 이 절차로 보내므로 그대로 따르면 명령이 없다고 실패한다. related-repos.md도 "Gradle 루트가 src/라 경로는 두 단계 위"라며 --include-build ../../messaging-library를 적는다. 지금은 workspace 밖을 가리킨다. 고른 방법: /src를 지우고, 라이브러리 경로를 한 단계 위(../messaging-library)로 고친다. 다른 살아 있는 문서에 같은 꼴(cd src, src/gradlew)이 남았는지 git grep으로 봤다. 시험 fixture(broken-readme.md)만 걸린다. 검증: python3 scripts/check-work-docs.py rc=0, check-docs.py rc=0. --- docs/work/operate.md | 4 ++-- docs/work/reference/related-repos.md | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/work/operate.md b/docs/work/operate.md index 94f4eecf..83365b17 100644 --- a/docs/work/operate.md +++ b/docs/work/operate.md @@ -54,7 +54,7 @@ mkdir -p ~/<작업 이름>-logs uptime # 다른 빌드가 돌고 있는지 부하를 본다 # 3) 공유 잠금 아래에서 한 번에 하나씩 돌리고 rc와 로그를 남긴다 -cd ~/workspace/<작업 이름>/src +cd ~/workspace/<작업 이름> flock /tmp/claude-gates/heavy.lock ./gradlew <게이트> --no-daemon --console=plain > ~/<작업 이름>-logs/<게이트>.log 2>&1; echo "rc=$?" # 4) 끝나면 worktree를 지운다 @@ -84,7 +84,7 @@ git diff --cached --binary <기준 커밋> | ssh desktop 'cd ~/workspace/<작업 - 형식은 편집 훅이 파일마다 맞추므로 보통 바뀌는 것이 없다. 그래도 커밋을 나누기 전에 확인한다(나눈 뒤에 고치면 앞 커밋을 다시 만들어야 한다). 형식 맞추기(`spotlessApply`)도 Gradle이라 desktop에서 돈다. 패치를 얹은 worktree에서 돌리고, 바뀐 파일을 노트북에 가져와 두 트리 해시가 같은지 본다. 그 뒤의 게이트는 이 트리에서 돌린다. ```bash -ssh desktop 'cd ~/workspace/<작업 이름>/src && flock /tmp/claude-gates/heavy.lock ./gradlew spotlessApply --no-daemon --console=plain' +ssh desktop 'cd ~/workspace/<작업 이름> && flock /tmp/claude-gates/heavy.lock ./gradlew spotlessApply --no-daemon --console=plain' ssh desktop 'cd ~/workspace/<작업 이름> && git diff --binary' | git apply --index && git write-tree # 노트북 ssh desktop 'cd ~/workspace/<작업 이름> && git add -A && git write-tree' # 같은 해시여야 한다 ``` diff --git a/docs/work/reference/related-repos.md b/docs/work/reference/related-repos.md index 8f7765b4..587242e9 100644 --- a/docs/work/reference/related-repos.md +++ b/docs/work/reference/related-repos.md @@ -16,10 +16,10 @@ ## 2. 라이브러리를 고칠 때 - 템플릿 안에서 라이브러리 코드를 고치지 않는다. 라이브러리 repo에서 고치고 릴리스한다. -- 템플릿 변경 때문에 라이브러리를 고쳐야 하면 두 repo에 브랜치를 하나씩 만들고, 두 repo를 같은 부모 폴더에 둔다(desktop은 `~/workspace/`). 템플릿에서 명령 줄로만 라이브러리를 끼워 같이 시험한다(composite build: Gradle이 같은 `group:artifact`의 외부 의존성을 끼운 빌드의 프로젝트로 바꿔 끼운다). Gradle 루트가 `src/`라 경로는 두 단계 위다. +- 템플릿 변경 때문에 라이브러리를 고쳐야 하면 두 repo에 브랜치를 하나씩 만들고, 두 repo를 같은 부모 폴더에 둔다(desktop은 `~/workspace/`). 템플릿에서 명령 줄로만 라이브러리를 끼워 같이 시험한다(composite build: Gradle이 같은 `group:artifact`의 외부 의존성을 끼운 빌드의 프로젝트로 바꿔 끼운다). Gradle 루트가 저장소 루트라 경로는 한 단계 위다. ```bash - ./gradlew --include-build ../../messaging-library <태스크> + ./gradlew --include-build ../messaging-library <태스크> ``` 그 상태로 lockfile을 쓰거나 커밋하지 않는다. 끼운 모듈은 lockfile 밖으로 빠질 수 있다. 끼운 빌드는 자기 카탈로그로 컴파일되므로 라이브러리 repo CI 결과와 다를 수 있다. 최종 판정은 배포한 좌표로 돈 템플릿 게이트다. From a638698fc84e316bb17e64a9cbae66176ed1ccfa Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Thu, 12 Nov 2026 21:40:07 +0900 Subject: [PATCH 4/9] =?UTF-8?q?docs(work):=20experts.md=20=EA=B2=BD?= =?UTF-8?q?=EB=A1=9C=20=ED=91=9C=EB=A5=BC=20=EC=8A=A4=ED=82=AC=20paths?= =?UTF-8?q?=EC=99=80=20=EB=A7=9E=EC=B6=94=EA=B3=A0=20=EB=8C=80=EC=A1=B0=20?= =?UTF-8?q?=EC=8B=9C=ED=97=98=EC=9D=84=20=EB=91=94=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: experts.md 3절 「경로 → 전문가」는 리드가 바뀐 경로로 렌즈를 고르는 표이고 "지식 스킬의 paths와 맞춘다"고 적는다. 그런데 손으로 옮긴 표가 열 스킬 중 아홉에서 이미 갈라졌다. 예: be-build-ci의 settings.gradle· gradle.properties·Dockerfile·renovate.json, be-api-contract의 .env.example· docs/upgrade/**, be-observability의 docs/runbooks/**, be-docs의 **/CLAUDE.md가 표에 없다. 표로 렌즈를 고르면 그 파일을 바꾼 변경에서 렌즈가 빠진다. 이름만 보는 시험(test_the_experts_manual_names_every_expert)은 이 차이를 못 잡는다. 고른 방법: 표 1열을 1차 렌즈 스킬의 paths와 똑같이 고치고, 시험이 표를 읽어(중괄호 펼침) 스킬마다 "1차 렌즈로 이름 댄 행의 glob 합집합 == 그 스킬의 paths"를 본다. 표 위 문장에 대조 시험이 있다고 적는다. 버린 대안: 표를 지우고 각 스킬 paths를 읽으라고만 쓰기 — 리드가 렌즈 하나를 고르려고 스킬 열 개의 머리를 읽어야 하고, 「이럴 때 더한다」 칸이 갈 곳이 없다. 위험·한계: 「이럴 때 더한다」 칸은 기계로 대조하지 않는다. 검증: 새 시험 test_the_experts_path_table_lists_exactly_each_skill_paths — 기준 표에서 9개 스킬 실패(be-domain만 통과), 고친 표에서 통과. test_claude_setup 16건 통과, check-work-docs.py·check-docs.py rc=0. --- docs/work/experts.md | 20 +++++++++---------- scripts/tests/test_claude_setup.py | 31 ++++++++++++++++++++++++++++++ 2 files changed, 41 insertions(+), 10 deletions(-) diff --git a/docs/work/experts.md b/docs/work/experts.md index 1eb3a966..195e8de0 100644 --- a/docs/work/experts.md +++ b/docs/work/experts.md @@ -50,21 +50,21 @@ ## 3. 경로 → 전문가 -리드가 바뀐 경로로 렌즈를 고르는 표다. 지식 스킬의 `paths`와 맞춘다. `reviewer` 하나에는 렌즈 1~3개를 준다. 관점이 서로 다르고 볼 파일이 많으면 `reviewer`를 렌즈별로 나눠 띄운다. +리드가 바뀐 경로로 렌즈를 고르는 표다. 1열은 1차 렌즈 스킬의 `paths`를 그대로 옮긴 것이다(`scripts/tests/test_claude_setup.py`가 대조한다. 스킬의 `paths`를 바꾸면 이 표도 바꾼다). `reviewer` 하나에는 렌즈 1~3개를 준다. 관점이 서로 다르고 볼 파일이 많으면 `reviewer`를 렌즈별로 나눠 띄운다. | 경로(glob) | 1차 렌즈 | 이럴 때 더한다 | |---|---|---| | `src/domain/core/**`, `src/application/*/**`, `src/shared-contract/**` | be-domain(판정은 `arch-reviewer`) | 오류 코드가 바뀜 → be-api-contract, 포트 계약이 바뀜 → be-testing | -| `src/adapter/outbound/persistence-*/**`, `**/db/migration/**` | be-persistence | 새 조회·인덱스 → be-performance, outbox·멱등성 행 → be-messaging, 응답·이벤트 필드로 드러남 → be-api-contract | -| `src/adapter/*/messaging*/**`, `src/bootstrap/{outbox-relay,idempotency,durable-operation}/**`, `**/outbox/**`, `**/idempotency/**`, `**/contracts/messaging/**` | be-messaging | 테이블·잠금 → be-persistence, schema version → be-api-contract, handler 권한 표시 → be-security | +| `src/adapter/outbound/persistence-*/**`, `**/db/migration/**`, `docs/jpa/**`, `docs/mongodb/**` | be-persistence | 새 조회·인덱스 → be-performance, outbox·멱등성 행 → be-messaging, 응답·이벤트 필드로 드러남 → be-api-contract | +| `src/adapter/*/messaging*/**`, `src/bootstrap/{outbox-relay,idempotency,durable-operation}/**`, `**/outbox/**`, `**/idempotency/**`, `**/contracts/messaging/**`, `src/application/core/src/main/java/dev/caskeleton/application/messaging/**` | be-messaging | 테이블·잠금 → be-persistence, schema version → be-api-contract, handler 권한 표시 → be-security | | `src/adapter/inbound/**` | be-api-contract + be-security | 새 조회·목록 → be-performance, 로그·헤더 → be-observability | -| `src/bootstrap/app/**`, `**/security/**`, `**/authz/**`, `docs/registries/secrets-classification.yaml`, `docs/security/**` | be-security | env 키·공개 경로 → be-api-contract, `runtimeOnly` 줄·lockfile → be-build-ci | -| `docs/registries/{metrics,mdc-keys}.yaml`, `docs/observability/**`, `**/observability/**`, `**/observation/**`, `**/tracing/**`, `src/bootstrap/service-runtime/**` | be-observability | 로그·지표에 실리는 값 → be-security | -| `docs/registries/{error-codes,env-keys,headers}.yaml`, `docs/architecture/*-api-surface.txt`, `docs/web/**`, `**/*.graphqls` | be-api-contract | 공개 경로·헤더 → be-security, 계약 시험 → be-testing | -| `src/adapter/outbound/**`(위 둘 밖: httpclient, cache-redis, notification, fileserver 등), `**/*Performance*`, `**/jmh/**` | be-performance | 외부 호출 대상·자격 증명 → be-security, 결과 불명 → be-messaging | -| `build-logic/**`, `**/build.gradle`, `**/gradle.lockfile`, `gradle/**`, `config/**`, `.gitea/**`, `.github/**`, `scripts/**` | be-build-ci | 새 의존성·버전 → be-security, lane 안 테스트 → be-testing | -| `**/src/test/**`, `**/src/testFixtures/**`, `**/src/*Test/**` | be-testing | 계약이 약속하는 동작 → 그 분야 렌즈 | -| `docs/**/*.md`, `**/AGENTS.md`, `**/README.md`, `.claude/**/*.md` | be-docs | 문서가 설명하는 동작 → 그 분야 렌즈 | +| `src/bootstrap/app/**`, `**/security/**`, `**/authz/**`, `**/authorization/**`, `docs/registries/secrets-classification.yaml`, `docs/security/**`, `.env.example`, `.trivyignore.yaml`, `.github/dependency-vulnerability-policy.md` | be-security | env 키·공개 경로 → be-api-contract, `runtimeOnly` 줄·lockfile → be-build-ci | +| `docs/registries/{metrics,mdc-keys}.yaml`, `docs/observability/**`, `docs/runbooks/**`, `**/observability/**`, `**/observation/**`, `**/tracing/**`, `**/*Metrics*`, `**/logback-spring.xml`, `src/bootstrap/service-runtime/**` | be-observability | 로그·지표에 실리는 값 → be-security | +| `docs/registries/{error-codes,env-keys,headers}.yaml`, `docs/architecture/*-api-surface.txt`, `docs/web/**`, `docs/security/public-paths-snapshot.txt`, `docs/upgrade/**`, `.env.example`, `**/*.graphqls`, `**/contracts/messaging/**`, `**/released-payload-schemas.sha256` | be-api-contract | 공개 경로·헤더 → be-security, 계약 시험 → be-testing | +| `src/adapter/outbound/**`(위 둘 밖: httpclient, cache-redis, notification, fileserver 등), `**/*Performance*`, `**/*PerformanceTest/**`, `**/jmh/**`, `docs/httpclient/performance-baseline.md`, `docs/web/virtual-thread-profile.md` | be-performance | 외부 호출 대상·자격 증명 → be-security, 결과 불명 → be-messaging | +| `build-logic/**`, `**/build.gradle`, `settings.gradle`, `gradle/**`, `gradle.properties`, `**/gradle.lockfile`, `**/settings-gradle.lockfile`, `config/**`, `Dockerfile`, `.gitea/**`, `.github/**`, `scripts/**`, `renovate.json` | be-build-ci | 새 의존성·버전 → be-security, lane 안 테스트 → be-testing | +| `**/src/test/**`, `**/src/testFixtures/**`, `**/src/*Test/**`, `**/src/*Testkit/**`, `docs/testing/**`, `gradle/container-images.properties` | be-testing | 계약이 약속하는 동작 → 그 분야 렌즈 | +| `docs/**/*.md`, `**/AGENTS.md`, `**/README.md`, `**/CLAUDE.md`, `.claude/**/*.md` | be-docs | 문서가 설명하는 동작 → 그 분야 렌즈 | ## 4. 넘김 지도 diff --git a/scripts/tests/test_claude_setup.py b/scripts/tests/test_claude_setup.py index 887ea54b..e06afa9e 100644 --- a/scripts/tests/test_claude_setup.py +++ b/scripts/tests/test_claude_setup.py @@ -61,6 +61,29 @@ def skill_paths(path: Path) -> list[str]: return re.findall(r'-\s+"([^"]+)"', block.group(1)) if block else [] +def expand_braces(pattern: str) -> list[str]: + """`a/{b,c}/d` → [`a/b/d`, `a/c/d`]. One brace group is enough for the patterns in experts.md.""" + match = re.search(r"\{([^}]*)\}", pattern) + if not match: + return [pattern] + return [pattern[:match.start()] + part + pattern[match.end():] for part in match.group(1).split(",")] + + +def experts_lens_paths() -> dict[str, set[str]]: + """experts.md 3절 표: 1열의 glob을 2열(1차 렌즈)이 이름 대는 지식 스킬마다 모은다.""" + text = EXPERTS.read_text(encoding="utf-8") + section = text.split("## 3. ", 1)[1].split("\n## ", 1)[0] + lenses: dict[str, set[str]] = {} + for line in section.splitlines(): + cells = [cell.strip() for cell in line.strip().strip("|").split("|")] + if len(cells) < 2 or not cells[0].startswith("`"): + continue + globs = [g for raw in re.findall(r"`([^`]+)`", cells[0]) for g in expand_braces(raw)] + for lens in re.findall(r"\bbe-[a-z-]+[a-z]", cells[1]): + lenses.setdefault(lens, set()).update(globs) + return lenses + + def front_matter(path: Path) -> dict[str, str]: text = path.read_text(encoding="utf-8") match = re.match(r"^---\n(.*?)\n---\n", text, re.S) @@ -155,6 +178,14 @@ class SkillTest(unittest.TestCase): rx = glob_regex(pattern) self.assertTrue(any(rx.fullmatch(f) for f in files), f"{name}: {pattern} matches no tracked file") + def test_the_experts_path_table_lists_exactly_each_skill_paths(self) -> None: + # The lead picks lenses from this table; a glob the skill has but the table lacks is a lens never picked. + table = experts_lens_paths() + for name in self.KNOWLEDGE: + with self.subTest(skill=name): + self.assertEqual(table.get(name, set()), set(skill_paths(SKILLS / name / "SKILL.md")), + "docs/work/experts.md 3절 1열 vs .claude/skills//SKILL.md paths") + def test_the_experts_manual_names_every_expert_and_the_rule_points_at_it(self) -> None: manual = EXPERTS.read_text(encoding="utf-8") for name in self.KNOWLEDGE + [path.stem for path in AGENTS.glob("*.md")]: From f75a4556514507fdcdd4d2a9e09a564c92e3d403 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Thu, 12 Nov 2026 21:40:19 +0900 Subject: [PATCH 5/9] =?UTF-8?q?docs(claude):=20verify-api=EA=B0=80=20verif?= =?UTF-8?q?y.sh=EB=A1=9C=20=EC=95=B1=EC=9D=84=20=EB=9D=84=EC=9A=B0?= =?UTF-8?q?=EA=B2=8C=20=ED=95=9C=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: verify-api 서브에이전트는 desktop worktree에서 `flock /tmp/claude-gates/heavy.lock scripts/bootstrap-local.sh`를 직접 돌린다. bootstrap-local.sh의 ./gradlew에는 --no-daemon이 없어 desktop에 Gradle daemon이 남는다(여러 worktree를 받은 daemon이 compiler worker를 쌓아 메모리를 채운 일이 있다). 5단계가 따르라는 "4.1절의 정리법"은 operate.md에 없다. 고른 방법: `scripts/verify.sh app --on here`로 부른다. verify.sh가 공유 잠금을 잡고 GRADLE_OPTS로 daemon을 끈 채 같은 스크립트를 부른다. 앱은 compose로 떠 있으니 4단계 호출은 그대로다. 정리는 compose down과 git worktree remove만 적고, 못 지우면 보고에 남기게 한다. 버린 대안: bootstrap-local.sh의 ./gradlew에 --no-daemon을 붙이기 — 사람이 노트북에서 처음 돌릴 때는 daemon이 이득이라 스크립트 기본값은 두고, desktop 쪽 진입점(verify.sh)이 끈다. 검증: test_verify_api_runs_the_app_on_the_desktop_under_the_shared_lock을 새 절차로 바꿨다(verify.sh app --on here와 git worktree remove를 요구하고, 잠금만 두른 직접 호출과 "정리법"을 거절). 기준 verify-api.md에서 실패, 고친 파일에서 통과. test_claude_setup 16건 통과. --- .claude/agents/verify-api.md | 4 ++-- scripts/tests/test_claude_setup.py | 8 ++++++-- 2 files changed, 8 insertions(+), 4 deletions(-) diff --git a/.claude/agents/verify-api.md b/.claude/agents/verify-api.md index 8b1d5faa..704e1c83 100644 --- a/.claude/agents/verify-api.md +++ b/.claude/agents/verify-api.md @@ -18,9 +18,9 @@ Gradle·Docker는 desktop에서만 돈다. 절차의 정본은 `docs/work/operat 1. desktop에 따로 worktree를 만든다. 기존 checkout `~/workspace/clean-architecture-backend-template`의 브랜치와 `stash@{0}`는 건드리지 않는다. 2. 로그 폴더 `~/<작업 이름>-logs/`를 만들고 `uptime`으로 부하를 본다. -3. worktree 루트에서 `flock /tmp/claude-gates/heavy.lock scripts/bootstrap-local.sh > ~/<작업 이름>-logs/bootstrap.log 2>&1; echo "rc=$?"`를 돌린다. 스크립트가 컴파일 → DB 기동 → 앱 기동 → health 200과 `status=UP`을 차례로 본다. +3. worktree 루트에서 `scripts/verify.sh app --on here > ~/<작업 이름>-logs/bootstrap.log 2>&1; echo "rc=$?"`를 돌린다. `verify.sh`가 공유 잠금을 잡고 Gradle daemon을 끈 채 `scripts/bootstrap-local.sh`를 부른다. 스크립트가 컴파일 → DB 기동 → 앱 기동 → health 200과 `status=UP`을 차례로 본다. 4. 앱이 떠 있는 동안 받은 endpoint를 `curl --silent --show-error --max-time 5 --write-out '\n%{http_code}'`로 부르고 응답을 로그 폴더에 남긴다. -5. 저장소 루트에서 `docker compose --profile '*' down`으로 내린다. 컨테이너가 만든 root 소유 폴더가 남으면 4.1절의 정리법을 따른 뒤 worktree를 지운다. +5. 저장소 루트에서 `docker compose --profile '*' down`으로 내리고 `git worktree remove`로 worktree를 지운다. 지우지 못하면 「남은 것」에 적는다. ## 돌려줄 것 diff --git a/scripts/tests/test_claude_setup.py b/scripts/tests/test_claude_setup.py index e06afa9e..961087a7 100644 --- a/scripts/tests/test_claude_setup.py +++ b/scripts/tests/test_claude_setup.py @@ -140,9 +140,13 @@ class SubagentTest(unittest.TestCase): def test_verify_api_runs_the_app_on_the_desktop_under_the_shared_lock(self) -> None: text = (AGENTS / "verify-api.md").read_text(encoding="utf-8") - for fragment in ("docs/work/operate.md", "flock /tmp/claude-gates/heavy.lock", "scripts/bootstrap-local.sh", - "stash@{0}", "down"): + # verify.sh takes the shared lock and turns the Gradle daemon off; a bare flock around the bootstrap script + # left a daemon behind on the desktop, and the cleanup it pointed at was in no manual. + for fragment in ("docs/work/operate.md", "scripts/verify.sh app --on here", "scripts/bootstrap-local.sh", + "stash@{0}", "down", "git worktree remove"): self.assertIn(fragment, text) + self.assertNotIn("heavy.lock scripts/bootstrap-local.sh", text) + self.assertNotIn("정리법", text) class SkillTest(unittest.TestCase): From b5c17d114a527e72db4ffacd3259a43178dca10d Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Thu, 12 Nov 2026 21:40:32 +0900 Subject: [PATCH 6/9] =?UTF-8?q?docs(work):=20=EA=B2=B0=EC=A0=95=20?= =?UTF-8?q?=EC=83=89=EC=9D=B8=EC=9D=98=20=EB=82=A1=EC=9D=80=20=ED=96=89=20?= =?UTF-8?q?=EB=84=B7=EC=97=90=20=EB=B0=94=EB=80=90=20=EA=B3=B3=EC=9D=84=20?= =?UTF-8?q?=ED=91=9C=EC=8B=9C=ED=95=9C=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: 결정 색인의 네 행이 지금 코드와 다른데 바뀌었다는 표시가 없다. 색인 1절 6번은 리뷰어가 정한 결정을 결함으로 올리지 않게 하므로, 낡은 행대로 읽은 리뷰어는 맞는 코드를 결함으로 올린다. - 「문서 검사」: workflow `docs-check`는 2026-11-08 workflow를 셋으로 접으며 없어졌다. 지금은 pr.yml done → :prCheck → documentCheck다. - 「build-logic 의존성 잠금」: "잠그지 않음(보류)"인데 build-logic/build.gradle은 2026-09-25 커밋부터 STRICT로 잠근다. - 「릴리스 이미지 서명」: "cosign keyless"인데 2026-11-07 소유자가 키 쌍으로 바꿨다(Gitea Actions가 OIDC 토큰을 주지 않음, operate.md 4.3절). - 「workflow 명령의 빌드 판정」: "cd도 따라간다"인데 2026-11-08 셸을 해석하지 않는 고정 형식 검사로 바꿨다(소유자가 고른 B안, StrictLaneStagesPlugin). docs/README.md 「문서 검사」도 같은 `docs-check`를 가리켜 함께 고친다. 고른 방법: 1절 5번대로 원문을 지우지 않고 취소선과 "→ 바꿈"으로 새 위치를 가리키고, 서명 키와 job 모양은 새 행을 더한다. 위험·한계: build-logic 잠금을 언제 누가 바꾸기로 했는지 기록이 없다. 행에 "바꾼 결정의 기록은 없다"고 적었다. 소유자 확인이 필요하다. 검증: check-work-docs.py rc=0, check-docs.py rc=0. --- docs/README.md | 4 ++-- docs/work/reference/decisions.md | 10 ++++++---- 2 files changed, 8 insertions(+), 6 deletions(-) diff --git a/docs/README.md b/docs/README.md index 730ce894..e600e909 100644 --- a/docs/README.md +++ b/docs/README.md @@ -184,8 +184,8 @@ leaf마다 둘 필요는 없고 family 하나에 하나여도 된다. 담는 것 ## 문서 검사 -`python3 scripts/check-docs.py`가 위 규칙 중 기계로 볼 수 있는 여덟을 본다. PR마다 workflow `docs-check`가 -돌리고, 하나라도 걸리면 실패한다. 경로 필터가 없다: 코드에서 파일이나 Gradle 프로젝트를 지우는 변경이 +`python3 scripts/check-docs.py`가 위 규칙 중 기계로 볼 수 있는 여덟을 본다. PR마다 `pr.yml`의 `done` job이 `./gradlew :prCheck` +안의 `documentCheck`로 돌리고, 하나라도 걸리면 실패한다. 경로 필터가 없다: 코드에서 파일이나 Gradle 프로젝트를 지우는 변경이 문서를 낡게 만든다. | 검사 | 보는 것 | diff --git a/docs/work/reference/decisions.md b/docs/work/reference/decisions.md index db1f8aa0..67cb64e1 100644 --- a/docs/work/reference/decisions.md +++ b/docs/work/reference/decisions.md @@ -61,7 +61,7 @@ | 학습 문서(지난 것) | 삭제된 코드를 설명하는 학습 문서(지금 `docs/history/study/*.ko.md`, `docs/history/packages/*-superpowers-package/`)는 현재 코드에 맞게 갱신 → 2026-11-07 갱신하지 않고 기록으로 보관(머리 블록만 단다)으로 바뀜 | 소유자 | 2026-09-25 | 결정 6, design-docs `repo-structure/README.md` 3.2절 | | 문서 체계 | 문서를 수명으로 나눈다. 살아 있는 문서는 제자리에 두고 한국어로 옮긴다. 기록은 `docs/history/`, 설계서는 `docs/design/`, 결정 기록은 `docs/adr/`에 둔다. 폴더 이름은 짝 프론트와 같이 쓴다 | 소유자 | 2026-11-07 | design-docs `repo-structure/README.md` 3.2절, 적용은 `docs/README.md` | | 한국어의 범위 | 살아 있는 문서는 본문까지 한국어로 쓴다. 기록 문서는 맨 위에 한국어 머리 블록(상태·작성일·요약·현재 정본)을 달고 본문은 원문 그대로 둔다. 상태는 한국어 고정 어휘다 | 소유자 | 2026-11-07 | design-docs `repo-structure/README.md` 3.2절 | -| 문서 검사 | 언어·머리 블록·참조·숫자 검사를 PR에서 실패로 둔다(`scripts/check-docs.py`, workflow `docs-check`) | 소유자 | 2026-11-07 | design-docs `repo-structure/README.md` 3.2절, `docs/README.md` 「문서 검사」 | +| 문서 검사 | 언어·머리 블록·참조·숫자 검사를 PR에서 실패로 둔다(`scripts/check-docs.py`, workflow `docs-check`) → 2026-11-08 workflow를 셋으로 접으며 `pr.yml` `done`의 `:prCheck` 안 `documentCheck`로 옮겼다(아래 2.7 「workflow 단계 job 모양」) | 소유자 | 2026-11-07 | design-docs `repo-structure/README.md` 3.2절, `docs/README.md` 「문서 검사」 | | 학습 문서 | `docs/history/study/`에 기록으로 보관한다. 코드에 맞춰 갱신하지 않고 머리 블록만 단다 | 소유자 | 2026-11-07 | design-docs `repo-structure/README.md` 3.2절 | | 문서 규칙 정본 | design-docs `conventions/docs-system.md`(두 템플릿 공통). 이 repo의 적용은 `docs/README.md`에 적는다 | 소유자 | 2026-11-07 | design-docs `repo-structure/README.md` 3.2절 | | 레지스트리 yaml 설명 칸 | 번역한다. 그 칸을 읽는 테스트를 먼저 찾는다 | 소유자 | 2026-11-07 | design-docs `repo-structure/README.md` 3.2절 | @@ -190,13 +190,15 @@ | 의존성 checksum | 추가 안 함(보류) | 소유자 | 결정 19 | | 취약점이 있는 의존성 버전 | 고친 버전으로 올리는 것이 먼저다. 고친 버전 중 가장 작은 것을 고르고, 짝으로 움직이는 라이브러리(httpclient5와 httpcore5, gRPC와 protobuf)는 upstream이 선언한 짝을 따른다. Boot BOM이 관리하면 Boot 패치를 먼저 보고, 없으면 BOM 속성 override(build-logic `JavaConventionsPlugin`, 이유와 지울 조건 옆). 어떤 leaf도 선언하지 않는데 upstream이 낡은 버전을 가져오면 카탈로그 `pinned-*`로 모든 구성에 고정한다. 무시 목록(`.trivyignore.yaml`)은 고친 버전이 없을 때만, 묻고 쓴다 | 기본값(2026-11-07) | `gradle/libs.versions.toml` 「Pinned」, 업그레이드 안내 `docs/upgrade/2026-11-maturity-review.md` B-54 | | Querydsl 취약 좌표 | `com.querydsl:querydsl-jpa`(CVE-2024-49203, 고친 버전 없음)를 템플릿이 싣지 않는다. persistence-jpa는 쓰는 타입(`Predicate`)이 있는 querydsl-core로만 컴파일하고, querydsl-jpa는 capability를 켜는 서비스가 더한다. leaf README는 그 좌표에 고친 버전이 없다고 적고 OpenFeign 포크(`io.github.openfeign.querydsl`)를 검토하라고 한다 | 위임(2026-11-07, 총괄이 권한 안 A를 확인) | 커밋 「persistence-jpa가 querydsl-jpa 대신 querydsl-core로 컴파일한다」, `src/adapter/outbound/persistence-jpa/README.md` 「라이브러리 API」 | -| build-logic 의존성 잠금 | 잠그지 않음 + 문서화(보류) | 소유자 | 결정 27 | -| 릴리스 이미지 서명 | cosign keyless, tag 릴리스에서 서명·검증 | 소유자 | 결정 31 | +| build-logic 의존성 잠금 | ~~잠그지 않음 + 문서화(보류)~~ → 지금은 잠근다(`build-logic/build.gradle` `lockMode = LockMode.STRICT`, 2026-09-25 커밋부터). 바꾼 결정의 기록은 없다 | 소유자 | 결정 27 | +| 릴리스 이미지 서명 | ~~cosign keyless~~, tag 릴리스에서 서명·검증 → 2026-11-07 키 쌍으로 바꿈(아래 「릴리스 이미지 서명 키」) | 소유자 | 결정 31 | +| 릴리스 이미지 서명 키 | cosign 키 쌍으로 서명한다. Gitea Actions는 keyless 서명에 필요한 OIDC 토큰을 주지 않는다. 개인 키와 비밀번호는 repo secret이다 | 소유자(2026-11-07) | `docs/work/operate.md` 4.3절, `.gitea/workflows/release.yml` | | gRPC `.proto` | protobuf Gradle 플러그인 + Buf. 2026-11-08부터 `grpc-library` repo의 `ci` 단계 | 소유자 | 결정 18 | | SpotBugs 신뢰도 | MEDIUM으로 내림. 패턴 단위 제외는 이유를 단다 | 위임 | `1101` 15절(08-07) | | 테스트 코드 정적 분석 | `testQualityCheck`는 `mainCheck` | 위임 | `1103` 14절 | | lane 정책과 캐시 | lane 정책 값(`rejectSkipped` 등)은 모두 캐시 입력 | 위임 | `1103` 4절(RR-06-02) | -| workflow 명령의 빌드 판정 | 같은 셸의 `cd <상대 경로>`도 따라간다 | 소유자 | `1103` 15절 ② | +| workflow 명령의 빌드 판정 | ~~같은 셸의 `cd <상대 경로>`도 따라간다~~ → 2026-11-08 셸을 해석하지 않게 바꿈(아래 「workflow 단계 job 모양」) | 소유자 | `1103` 15절 ② | +| workflow 단계 job 모양 | workflow는 `pr.yml`·`main.yml`·`release.yml` 셋이다. 단계 job의 `run:`은 셸 문법 없는 `./gradlew` 한 줄이나 `bash scripts/<이름>.sh` 한 줄이고, `verifyStrictLaneStages`는 셸을 해석하지 않고 이 고정 형식만 본다 | 소유자(2026-11-08) | design-docs `repo-structure/03-ci.md` 7·11절, `build-logic/AGENTS.md`, `StrictLaneStagesPlugin` Javadoc | | 성능 lane 단언 | 끄는 스위치 없음. convention이 `performance.assertions.enabled=true`를 넣고, 빌드·lane이 다른 값을 주거나 skip이 있으면 테스트 전에 실패. 손으로 돌리든 workflow든 같은 상한 | 소유자(2026-11-06 병합 승인) | design-docs `delegation-loop/02-design.md` 13절 D9, 커밋 `e6b6e18e`, `build-logic/AGENTS.md` 「lane 캐시와 성능 lane」 | | 문서 파싱 검사 | 문서를 파싱해 대조하는 Gradle 검사를 두지 않는다(`verifyDocumentedLeafCount` 등 삭제). 문서와 코드 대조는 leaf의 document-contract lane | 정책 | `build-logic/AGENTS.md` 「저장소 파일을 읽는 테스트」 | | MinIO 이미지 | `pgsty/minio` digest | 위임 | `1101` 15절(05-09) | From 82fe39d229ff9902b0fd1f48a2f9befac3920ce0 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Thu, 12 Nov 2026 21:40:32 +0900 Subject: [PATCH 7/9] =?UTF-8?q?docs(claude):=20CLAUDE.md=EC=97=90=EC=84=9C?= =?UTF-8?q?=20=EB=B6=84=EC=95=BC=20=EC=A7=80=EC=8B=9D=20=EC=8A=A4=ED=82=AC?= =?UTF-8?q?=20=EA=B0=9C=EC=88=98=EB=A5=BC=20=EB=BA=80=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 스킬 수를 복사해 두면 스킬을 더하거나 뺄 때 낡는다(be-docs 함정 6). 목록의 정본은 .claude/skills/와 docs/work/experts.md 명단이다. 검증: check-work-docs.py rc=0(CLAUDE.md 10/10). --- CLAUDE.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CLAUDE.md b/CLAUDE.md index 7c458268..f72554b1 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -5,6 +5,6 @@ - 권한과 훅은 `.claude/settings.json`이다: 편집 직후 Java 한 파일 포맷·레이어 의존 알림·문서 검사, 턴 끝 desktop 검증 알림, 적용된 migration 편집 차단, 실제 `.env` 읽기 차단. 훅마다 하는 일과 시험은 `scripts/hooks/README.md`다. - 공통 훅·스킬(되돌릴 수 없는 명령 차단, 비밀 값 알림, 장부, `estimate`·`retro`·`techdebt`)은 하네스 플러그인 `harness@claude-harness`다(같은 settings가 켠다). 비대화형(`claude -p`)은 설치하지 않으니 claude-harness README의 `--scope project` 두 명령을 한 번 돌린다. - 경로별 규칙(테스트·설정·Docker·문서)은 `.claude/rules/`에 있다. 그 경로의 파일을 열 때 읽힌다. -- 스킬은 `.claude/skills/`다: `new-feature`(새 기능), `desktop-gates`(Gradle·Docker를 desktop에서), 분야 지식 `be-*` 10개(`paths`가 걸려 그 분야 파일을 만질 때 목록에 뜬다). 여러 분야면 플러그인 `lead`. 발동 조건이 설명에 있어 모델이 부른다. +- 스킬은 `.claude/skills/`다: `new-feature`(새 기능), `desktop-gates`(Gradle·Docker를 desktop에서), 분야 지식 `be-*`(`paths`가 걸려 그 분야 파일을 만질 때 목록에 뜬다). 여러 분야면 플러그인 `lead`. 발동 조건이 설명에 있어 모델이 부른다. - 서브에이전트는 `.claude/agents/`다: `reviewer`(렌즈로 받은 `be-*` 스킬로 새 창에서 diff 판정), `arch-reviewer`(구조 리뷰), `verify-api`(desktop에서 앱 띄워 확인), `code-simplifier`(단순화 제안). 모두 결과만 돌려주고 파일을 고치지 않는다. - 소유자 환경: Gradle·Docker·테스트는 desktop에서만 돈다(`docs/work/operate.md` 4.1절). 세션 규칙은 `docs/work/delegate.md` 4.3절, 보고 형식은 소유자 전역 설정이다. From 2249d44278e3f80bf02024d3dcc5a467c251796e Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Thu, 12 Nov 2026 21:42:56 +0900 Subject: [PATCH 8/9] =?UTF-8?q?docs(claude):=20=EC=A7=80=EC=8B=9D=20?= =?UTF-8?q?=EC=8A=A4=ED=82=AC=EC=9D=98=20=E3=80=8C=EB=AA=85=EB=A0=B9?= =?UTF-8?q?=EC=9D=80=20src/=EC=97=90=EC=84=9C=E3=80=8D=EB=A5=BC=20?= =?UTF-8?q?=EA=B3=A0=EC=B9=98=EA=B3=A0=20=EC=98=9B=20Gradle=20=EB=A3=A8?= =?UTF-8?q?=ED=8A=B8=20=EC=A7=80=EC=8B=9C=EB=A5=BC=20=EB=A7=89=EB=8A=94?= =?UTF-8?q?=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: be-api-contract·be-domain·be-persistence·be-security의 「검증」 절이 "명령은 `src/`에서다"라고 한다. 분야 스킬은 Gradle 루트를 저장소 루트로 옮긴 뒤에 들어왔는데 옛 위치를 적었다. 그대로 따르면 gradlew가 없는 폴더에서 명령을 돌린다. operate.md 4.1절의 같은 꼴은 앞 커밋이 고쳤다. 고른 방법: 네 줄을 "저장소 루트에서다"로 고치고, 진입 문서(AGENTS.md· CLAUDE.md·docs/work/·.claude/)에 "명령은 `src/`에서"나 `cd …/src`가 남으면 실패하는 시험을 둔다. 검증: 새 시험 test_no_instruction_runs_gradle_from_the_old_src_root — 기준 스킬 넷에서 4건, 기준 operate.md에서 2건(57·87줄)을 잡고, 이 커밋에서 통과. scripts/tests 158건 통과, check-work-docs.py rc=0. --- .claude/skills/be-api-contract/SKILL.md | 2 +- .claude/skills/be-domain/SKILL.md | 2 +- .claude/skills/be-persistence/SKILL.md | 2 +- .claude/skills/be-security/SKILL.md | 2 +- scripts/tests/test_claude_setup.py | 10 ++++++++++ 5 files changed, 14 insertions(+), 4 deletions(-) diff --git a/.claude/skills/be-api-contract/SKILL.md b/.claude/skills/be-api-contract/SKILL.md index 75eb865c..ff755d7f 100644 --- a/.claude/skills/be-api-contract/SKILL.md +++ b/.claude/skills/be-api-contract/SKILL.md @@ -65,7 +65,7 @@ paths: ## 검증 -Gradle은 desktop에서 돈다(`docs/work/operate.md` 4.1절). 명령은 `src/`에서다. +Gradle은 desktop에서 돈다(`docs/work/operate.md` 4.1절). 명령은 저장소 루트에서다. - API surface: leaf `check` 안의 `verify