fix(claude): 분야 파일을 고치기 전에 be 스킬을 부르도록 규칙에 파일과 스킬 짝을 적는다

문제: 실제 세션 평가(구현 과제 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.
This commit is contained in:
DongHyeonka
2026-11-12 04:36:10 +09:00
parent c611b06f03
commit 5feb5a1bc0
+2 -1
View File
@@ -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` 스킬로 렌즈와 리뷰어 수를 정한다.