From 5feb5a1bc05e43ba2ae0cf451f678a05cb3bdae0 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Thu, 12 Nov 2026 04:36:10 +0900 Subject: [PATCH] =?UTF-8?q?fix(claude):=20=EB=B6=84=EC=95=BC=20=ED=8C=8C?= =?UTF-8?q?=EC=9D=BC=EC=9D=84=20=EA=B3=A0=EC=B9=98=EA=B8=B0=20=EC=A0=84?= =?UTF-8?q?=EC=97=90=20be=20=EC=8A=A4=ED=82=AC=EC=9D=84=20=EB=B6=80?= =?UTF-8?q?=EB=A5=B4=EB=8F=84=EB=A1=9D=20=EA=B7=9C=EC=B9=99=EC=97=90=20?= =?UTF-8?q?=ED=8C=8C=EC=9D=BC=EA=B3=BC=20=EC=8A=A4=ED=82=AC=20=EC=A7=9D?= =?UTF-8?q?=EC=9D=84=20=EC=A0=81=EB=8A=94=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: 실제 세션 평가(구현 과제 3번)에서 `be-persistence`는 세 번 모두 스킬 목록에 떴지만 부른 세션은 한 번뿐이었다. 나머지 둘은 관련 문서를 직접 읽고 스킬을 건너뛰었다. 규칙은 "어느 스킬인지는 experts.md 3절 표"라고만 해서 한 번 더 읽어야 짝을 알았다. 고른 방법: 규칙에 고칠 것 → 스킬 짝을 한 줄로 적고, 처음 Edit·Write하기 전에 Skill 도구로 부르며 문서를 읽었어도 부른다고 적었다. 버린 대안: 모듈마다 leaf AGENTS.md에 한 줄 더하기(파일 수십 개, 배치 검사와 겹침), 강조어(MUST 등, 과다 호출을 부른다). 위험: 규칙이 붙는 세션마다 약 300토큰이 는다. 여러 분야를 부르면 호출이 는다. 검증: python3 -m unittest discover -s scripts/tests 154건 통과, scripts/verify.sh docs rc=0. --- .claude/rules/expert-skills.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/.claude/rules/expert-skills.md b/.claude/rules/expert-skills.md index da361ae9..942acb32 100644 --- a/.claude/rules/expert-skills.md +++ b/.claude/rules/expert-skills.md @@ -11,5 +11,6 @@ paths: # 분야 파일을 고칠 때 -- 고치기 전에 그 분야의 지식 스킬(`be-*`, 그 파일을 열면 목록에 뜬다)을 부르고 「함정」과 「검증」을 따른다. 어느 스킬인지는 `docs/work/experts.md` 3절 표다. +- 분야 파일을 처음 Edit·Write하기 전에 그 분야의 `be-*` 스킬을 Skill 도구로 부르고 「함정」과 「검증」을 따른다. 관련 문서를 이미 읽었어도 부른다. 「함정」은 여러 문서에 흩어진 규칙과 이 repo에서 실제로 난 실패를 한곳에 모은 것이다. +- 고칠 것 → 스킬: 마이그레이션·엔티티·repository·트랜잭션 `be-persistence`, env 키·설정 키·HTTP·오류 코드·schema `be-api-contract`, outbox·Kafka·멱등 `be-messaging`, 인증·권한·비밀 값 `be-security`, 로그·지표·trace `be-observability`, 테스트·fake `be-testing`, Gradle·workflow·검사 스크립트 `be-build-ci`, 문서·`.claude/` `be-docs`, 도메인·유스케이스·포트 `be-domain`, 풀·타임아웃·캐시 `be-performance`. 여러 분야에 걸치면 걸리는 것을 다 부른다. 경로별 표는 `docs/work/experts.md` 3절이다. - 둘 이상 분야에 걸치거나 PR 전이면 플러그인 `lead` 스킬로 렌즈와 리뷰어 수를 정한다.