From 2901785436a8d14701212ca4170a4edc6692c56a Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Thu, 12 Nov 2026 06:56:09 +0900 Subject: [PATCH] =?UTF-8?q?fix(claude):=20fe=20=EC=8A=A4=ED=82=AC=EC=9D=B4?= =?UTF-8?q?=20=EB=AC=B8=EC=84=9C=20=EC=B2=B4=EA=B3=84=20=EA=B0=9C=ED=8E=B8?= =?UTF-8?q?=EC=9C=BC=EB=A1=9C=20=EC=98=AE=EA=B8=B4=20=EB=AC=B8=EC=84=9C?= =?UTF-8?q?=EB=A5=BC=20=EA=B0=80=EB=A6=AC=ED=82=A4=EA=B2=8C=20=ED=95=9C?= =?UTF-8?q?=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: #15가 결정 기록을 docs/adr/로, 설계서 넷을 docs/design/의 설계 기록으로 옮겼다. fe-* 스킬 8개가 옛 경로를 적고 있어 verify:documentation(FE-GATE-017)과 그 시험(tests/unit/documentation-readiness.test.ts, FE-GATE-005)이 실패했다. 고른 방법: 옛 경로를 옮긴 곳으로 바꿨다(VD-* → docs/adr/, design-system-platform· frontend-platform-testing-strategy·routing-pages-and-patterns· typescript-state-and-data-flow → docs/design/2026-07-26-*-design.md). 스킬이 인용한 절 번호는 기록에 그대로 있다. 버린 대안: 기록 머리의 「현재 정본」으로 바꾸기 (인용한 절이 정본 쪽에 없는 것이 많아 근거가 끊긴다). 위험: 설계 기록은 쓴 때의 원문이라 지금 동작과 다를 수 있다. 스킬이 그 절을 근거로 든 규칙은 검사기·시험 경로를 함께 적어 두었다. 검증: 바꾼 문서에서 백틱 경로를 검사기 방식으로 다시 뽑아 없는 경로 0개, python3 -m unittest discover -s scripts/tests 통과, scripts/verify.sh docs rc=0. --- .claude/skills/fe-a11y/SKILL.md | 16 ++++++------- .claude/skills/fe-design-system/SKILL.md | 20 ++++++++-------- .claude/skills/fe-performance/SKILL.md | 6 ++--- .claude/skills/fe-qa/SKILL.md | 14 +++++------ .claude/skills/fe-react/SKILL.md | 16 ++++++------- .claude/skills/fe-security/SKILL.md | 12 +++++----- .claude/skills/fe-testing/SKILL.md | 8 +++---- .claude/skills/fe-ux/SKILL.md | 30 ++++++++++++------------ 8 files changed, 61 insertions(+), 61 deletions(-) diff --git a/.claude/skills/fe-a11y/SKILL.md b/.claude/skills/fe-a11y/SKILL.md index 3b9cc2a6..eb28c838 100644 --- a/.claude/skills/fe-a11y/SKILL.md +++ b/.claude/skills/fe-a11y/SKILL.md @@ -23,23 +23,23 @@ paths: ## 함정 -1. axe 통과를 접근성 완료로 적는다. e2e 스캔의 태그는 `wcag2a`·`wcag2aa`·`wcag21a`·`wcag21aa`뿐이다. WCAG 2.2에서 더해진 기준(포커스가 가려지지 않음, 목표 크기 최소, 드래그 대안 등)은 자동으로 보지 않는다. 그리고 critical·serious 위반만 막는다. — `tests/e2e/accessibility.spec.ts`, `docs/accessibility/manual-checklist.md`, `docs/styling/design-system-platform.md` 13절 +1. axe 통과를 접근성 완료로 적는다. e2e 스캔의 태그는 `wcag2a`·`wcag2aa`·`wcag21a`·`wcag21aa`뿐이다. WCAG 2.2에서 더해진 기준(포커스가 가려지지 않음, 목표 크기 최소, 드래그 대안 등)은 자동으로 보지 않는다. 그리고 critical·serious 위반만 막는다. — `tests/e2e/accessibility.spec.ts`, `docs/accessibility/manual-checklist.md`, `docs/design/2026-07-26-design-system-platform-design.md` 13절 2. 자동 스캔이 본 상태를 넘겨 짐작한다. 보호 라우트는 데모 로그인 뒤, 목록은 빈 상태, 단건 읽기 상세는 실패 상태에서 스캔하고 `notChecked`로 남긴다. 데이터가 찬 목록·상세는 기능 시험과 수동 검토 몫이다. — `docs/accessibility/manual-checklist.md` 「What the automated run scans」 -3. 린트가 의미를 잡아 줄 거라 믿는다. `eslint.config.ts`에 접근성 규칙 플러그인이 없다. `div` + 키 핸들러로 만든 버튼, 이름 없는 아이콘 버튼은 component 시험·axe·리뷰가 잡는다. — `eslint.config.ts`, `docs/styling/design-system-platform.md` 13절 +3. 린트가 의미를 잡아 줄 거라 믿는다. `eslint.config.ts`에 접근성 규칙 플러그인이 없다. `div` + 키 핸들러로 만든 버튼, 이름 없는 아이콘 버튼은 component 시험·axe·리뷰가 잡는다. — `eslint.config.ts`, `docs/design/2026-07-26-design-system-platform-design.md` 13절 4. 저장 중 버튼을 `disabled`로 바꿔 키보드 포커스를 잃게 한다. `pending`을 쓴다. — `docs/manual/02-decision-tables.md` 6절 5. 실패·복구 전이 뒤 포커스와 안내를 잃는다. 한 전이에서만 고치고 복구 성공·확인·진행 중 전이에는 없어 버튼이 무반응으로 남았다. — `docs/work/reference/structure.md` 7절, `docs/work/reference/defect-patterns.md` C11 -6. 라우트 heading의 focus outline을 CSS로 없앤다. 마우스 사용자에게 불필요한 ring을 줄일 수는 있지만 키보드 포커스 표시를 전역으로 지우지 않는다. — `docs/architecture/routing-pages-and-patterns.md` 6.3·11절 +6. 라우트 heading의 focus outline을 CSS로 없앤다. 마우스 사용자에게 불필요한 ring을 줄일 수는 있지만 키보드 포커스 표시를 전역으로 지우지 않는다. — `docs/design/2026-07-26-routing-pages-and-patterns-design.md` 6.3·11절 7. 포커스 색 토큰을 `color-mix()`·알파로 만든다. 3:1 대비를 계산하지 못해 `check:design-system`이 실패한다. — `docs/styling/design-tokens.md` UI-01 -8. modal의 포커스 가두기·배경 비활성·복원을 페이지마다 만든다. 공통 `Dialog`·`Drawer`·`ConfirmationDialog`를 쓴다. 닫으면 trigger나 안전한 위치로 포커스를 돌린다. — `docs/styling/design-system-platform.md` 8.2절 +8. modal의 포커스 가두기·배경 비활성·복원을 페이지마다 만든다. 공통 `Dialog`·`Drawer`·`ConfirmationDialog`를 쓴다. 닫으면 trigger나 안전한 위치로 포커스를 돌린다. — `docs/design/2026-07-26-design-system-platform-design.md` 8.2절 9. 같은 변경을 여러 번 읽어 준다. live region은 필요한 변경만 한 번, 라우트 제목 발표도 중복 없이. — 같은 문서 8.1절, routing 6.3절 10. 수동 검토 기록을 not-applicable로 채운다. 폼이나 dialog가 있는 라우트는 M4·M5를 not-applicable로 둘 수 없다. 새 라우트에 pending 기록이 없으면 `verify:documentation`이 실패한다. merge 게이트는 형식만 보고, 서명은 release 게이트 FE-GATE-028이 본다. — `docs/accessibility/manual-checklist.md` -11. 상태를 색만으로 전하거나 필요한 정보를 tooltip에만 둔다. — `docs/styling/design-system-platform.md` 6.1절 10번, `docs/styling/design-tokens.md` 「Included primitives」 +11. 상태를 색만으로 전하거나 필요한 정보를 tooltip에만 둔다. — `docs/design/2026-07-26-design-system-platform-design.md` 6.1절 10번, `docs/styling/design-tokens.md` 「Included primitives」 ## 이 분야에서 실패는 이렇게 보인다 의미·이름 -- [ ] 맞는 native element와 role을 쓴다. 행동은 `