From 6805ed62a4d564d744c95e5ce9bafe48eddd4326 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=20fe=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 문제: 백엔드 템플릿 실제 세션 평가에서 분야 스킬이 목록에 떠도 세 번 중 한 번만 불렸다. 같은 모양인 이 repo 규칙도 "어느 스킬인지는 experts.md 3절 표"라고만 해서 한 번 더 읽어야 짝을 알았다. 고른 방법: 규칙에 고칠 것 → 스킬 짝을 한 줄로 적고, 처음 Edit·Write하기 전에 Skill 도구로 부르며 문서를 읽었어도 부른다고 적었다. 버린 대안: 폴더마다 AGENTS.md에 한 줄 더하기(파일 수가 늘고 배치 규칙과 겹침), 강조어(과다 호출을 부른다). 위험: 규칙이 붙는 세션마다 약 300토큰이 는다. 여러 분야를 부르면 호출이 는다. 검증: python3 -m unittest discover -s scripts/tests 68건 통과, 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 094c660d..117eaf96 100644 --- a/.claude/rules/expert-skills.md +++ b/.claude/rules/expert-skills.md @@ -12,5 +12,6 @@ paths: # 분야 파일을 고칠 때 -- 고치기 전에 그 분야의 지식 스킬(`fe-*`, 그 파일을 열면 목록에 뜬다)을 부르고 「함정」과 「검증」을 따른다. 어느 스킬인지는 `docs/work/experts.md` 3절 표다. +- 분야 파일을 처음 Edit·Write하기 전에 그 분야의 `fe-*` 스킬을 Skill 도구로 부르고 「함정」과 「검증」을 따른다. 관련 문서를 이미 읽었어도 부른다. 「함정」은 여러 문서에 흩어진 규칙과 이 repo에서 실제로 난 실패를 한곳에 모은 것이다. +- 고칠 것 → 스킬: 토큰·디자인 시스템 컴포넌트·story·시각 골든 `fe-design-system`, 키보드·포커스·aria·레이블·axe `fe-a11y`, 컴포넌트·hook·query·폼 제출 `fe-react`, 폴더·import 방향·배럴·dependency-cruiser `fe-structure`, 시험·Vitest·Playwright·MSW `fe-testing`, 화면 구성·상태 화면·문구 `fe-ux`, 번들·청크·lazy·Service Worker `fe-performance`, 인증·XSS·CSP·의존성 추가 `fe-security`, 브라우저로 흐름 확인·재현 `fe-qa`. 여러 분야에 걸치면 걸리는 것을 다 부른다. 경로별 표는 `docs/work/experts.md` 3절이다. - 둘 이상 분야에 걸치거나 PR 전이면 플러그인 `lead` 스킬로 렌즈와 리뷰어 수를 정한다.