fix(claude): 분야 파일을 고치기 전에 fe 스킬을 부르도록 규칙에 파일과 스킬 짝을 적는다
frontend-quality-gates / merge / static checks (pull_request) Successful in 2m41s
frontend-quality-gates / merge / tests (pull_request) Failing after 13m11s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 8m41s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / main / checker self-tests (pull_request) Skipped
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Skipped
frontend-quality-gates / external-vulnerability-provider (pull_request) Skipped
frontend-quality-gates / external-provenance-provider (pull_request) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Skipped
frontend-quality-gates / deploy-promoted-release (pull_request) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped

문제: 백엔드 템플릿 실제 세션 평가에서 분야 스킬이 목록에 떠도 세 번 중 한 번만
불렸다. 같은 모양인 이 repo 규칙도 "어느 스킬인지는 experts.md 3절 표"라고만 해서
한 번 더 읽어야 짝을 알았다.

고른 방법: 규칙에 고칠 것 → 스킬 짝을 한 줄로 적고, 처음 Edit·Write하기 전에 Skill
도구로 부르며 문서를 읽었어도 부른다고 적었다. 버린 대안: 폴더마다 AGENTS.md에 한 줄
더하기(파일 수가 늘고 배치 규칙과 겹침), 강조어(과다 호출을 부른다).

위험: 규칙이 붙는 세션마다 약 300토큰이 는다. 여러 분야를 부르면 호출이 는다.

검증: python3 -m unittest discover -s scripts/tests 68건 통과, scripts/verify.sh docs rc=0.
This commit is contained in:
DongHyeonka
2026-11-12 04:36:10 +09:00
parent b5e7f54bd1
commit 6805ed62a4
+2 -1
View File
@@ -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` 스킬로 렌즈와 리뷰어 수를 정한다.