From 1b3eee41e3ff48b5614b7ee8c71d22854e2a9c0d Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Thu, 12 Nov 2026 10:49:20 +0900 Subject: [PATCH 1/4] =?UTF-8?q?test(claude):=20=EC=8A=A4=ED=82=AC=EC=9D=B4?= =?UTF-8?q?=20=EC=9D=B8=EC=9A=A9=ED=95=98=EB=8A=94=20=EC=A0=88=20=EC=9D=B4?= =?UTF-8?q?=EB=A6=84=EC=9D=84=20=EB=AC=B8=EC=84=9C=20=EC=A0=9C=EB=AA=A9?= =?UTF-8?q?=EA=B3=BC=20=EB=8C=80=EC=A1=B0=ED=95=9C=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: 스킬은 정본 문서의 절을 「이름」이나 「N절」로 가리킨다. 문서 검사 (verify:documentation)는 경로만 보므로, 문서를 번역하거나 절을 바꾸면 인용한 절이 사라져도 통과한다. 지금 9곳이 그렇다. - fe-structure: 「Decision rule」(지금 「판단 규칙」), 「The adapter kernel」(지금 「adapter kernel」) - fe-a11y: 「What the automated run scans」, 「Included primitives」 - fe-design-system: 「Arbitrary-value policy」 - fe-performance: 「Service Worker steps」 - fe-ux: 「routing 6.4절」이 앞 인용(typescript 설계서)의 6.4절로 읽힌다. 그 설계서에는 6.4절이 없다. - desktop-gates: 경로 없이 `gates.md`·`operate.md`라고만 쓴다. 고른 방법: scripts/tests/test_claude_setup.py의 SkillTest에 시험을 더한다. - 모든 repo 스킬에서 읽는 인용 꼴: `경로.md` 「이름」, `경로.md` N절 (3·4절, 6.1·11절), `경로.md` N절 「이름」, 같은 문서 N절, `fe-x` 「이름」(다른 스킬의 절). - 인용마다 대상 파일에 그 제목이 있는지 본다. 제목은 앞 번호와 끝 괄호를 뗀 꼴도 받는다. 「이름:」만 있는 소제목 줄도 받는다. 코드 블록 안 제목은 보지 않는다. - 파서와 제목 읽기를 따로 고정하는 시험 둘을 함께 둔다. - 9곳은 지금 제목으로 고치고, 짧게 쓴 경로는 전체 경로로 쓴다. 버린 대안: 문서 검사(scripts/lib/docs-system.ts)에 넣는 방법. 스킬 구성의 다른 규칙이 이미 이 시험 파일에 있고, `scripts/verify.sh hooks`로 노트북에서 바로 돈다. 위험: 「 」 안의 말이 절 이름이 아닌데 경로 바로 뒤에 붙으면 거짓 실패가 난다. 경로 뒤의 —, 괄호, 문장 끝에서 읽기를 멈춰 지금 196개 인용에는 그런 경우가 없다. 「N절」이 다른 문서를 줄여 부르면(「routing 6.4절」) 앞 경로로 읽으니 전체 경로로 쓴다. 이 시험은 게이트가 아니라 hooks 단계에서 돈다. 검증: python3 -m unittest scripts.tests.test_claude_setup. - 고치기 전: 새 시험이 9곳(과 처음 판에서 거짓 실패 2곳)을 냈다(RED). - 고친 뒤: 24개 모두 통과했다. 인용 196개를 확인했다. --- .claude/skills/desktop-gates/SKILL.md | 4 +- .claude/skills/fe-a11y/SKILL.md | 4 +- .claude/skills/fe-design-system/SKILL.md | 2 +- .claude/skills/fe-performance/SKILL.md | 2 +- .claude/skills/fe-structure/SKILL.md | 4 +- .claude/skills/fe-ux/SKILL.md | 2 +- scripts/tests/test_claude_setup.py | 112 +++++++++++++++++++++++ 7 files changed, 121 insertions(+), 9 deletions(-) diff --git a/.claude/skills/desktop-gates/SKILL.md b/.claude/skills/desktop-gates/SKILL.md index 9a9ca150..34359fc9 100644 --- a/.claude/skills/desktop-gates/SKILL.md +++ b/.claude/skills/desktop-gates/SKILL.md @@ -7,7 +7,7 @@ description: 이 프론트 repo에서 pnpm·게이트·테스트·빌드·브라 정본은 `docs/work/operate.md` 4.1절(실행 위치)·4.2절(기록)과 `docs/work/reference/gates.md`(무엇을 돌릴지)다. 이 스킬은 실행 순서표다. 둘이 다르면 정본이 맞다. -1. 무엇을 돌릴지 고른다(`gates.md` 2절). merge 가능을 말하려면 `merge` 단계 전부다. 고른 스크립트 목록으로 merge 가능을 말하지 않는다. +1. 무엇을 돌릴지 고른다(`docs/work/reference/gates.md` 2절). merge 가능을 말하려면 `merge` 단계 전부다. 고른 스크립트 목록으로 merge 가능을 말하지 않는다. 2. `ssh desktop uptime`으로 부하를 적는다. 3. 돌린다. 오래 걸리면 background로 띄우고 끝나기를 한 번 기다린다. - 단계: `scripts/verify.sh merge --log <작업 이름>` @@ -21,4 +21,4 @@ description: 이 프론트 repo에서 pnpm·게이트·테스트·빌드·브라 5. 결과를 읽는다: desktop `/tmp/claude-gates/<작업 이름>/summary.txt`(첫 줄이 트리 해시), 게이트별 로그, `gate-artifacts/`, `status-after.txt`(비어 있어야 한다). 6. FE-GATE-013은 desktop에서 호스트 제약(user namespace)으로 실패한다. "호스트 제약 실패"로 적고 `parts`로 뒤 명령 결과를 함께 적는다. 7. 실패하면 기준 커밋에서도 돌려 이번 변경 몫인지 가린다. 다시 돌려 통과한 결과를 "통과"로 쓰지 않는다. -8. 보고에는 단계·게이트, rc, 시간, 핵심 숫자, 직전 부하, 트리 해시, 로그 경로를 적는다(`operate.md` 8절 표). +8. 보고에는 단계·게이트, rc, 시간, 핵심 숫자, 직전 부하, 트리 해시, 로그 경로를 적는다(`docs/work/operate.md` 8절 표). diff --git a/.claude/skills/fe-a11y/SKILL.md b/.claude/skills/fe-a11y/SKILL.md index eb28c838..eb80cea5 100644 --- a/.claude/skills/fe-a11y/SKILL.md +++ b/.claude/skills/fe-a11y/SKILL.md @@ -24,7 +24,7 @@ paths: ## 함정 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」 +2. 자동 스캔이 본 상태를 넘겨 짐작한다. 보호 라우트는 데모 로그인 뒤, 목록은 빈 상태, 단건 읽기 상세는 실패 상태에서 스캔하고 `notChecked`로 남긴다. 데이터가 찬 목록·상세는 기능 시험과 수동 검토 몫이다. — `docs/accessibility/manual-checklist.md` 「자동 실행이 검사하는 것」 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 @@ -33,7 +33,7 @@ paths: 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/design/2026-07-26-design-system-platform-design.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` 「들어 있는 primitive」 ## 이 분야에서 실패는 이렇게 보인다 diff --git a/.claude/skills/fe-design-system/SKILL.md b/.claude/skills/fe-design-system/SKILL.md index be64597b..e849c645 100644 --- a/.claude/skills/fe-design-system/SKILL.md +++ b/.claude/skills/fe-design-system/SKILL.md @@ -35,7 +35,7 @@ paths: 3. 포커스 대비 토큰을 `color-mix()`·알파·키워드로 만든다. 3:1 계산은 불투명한 `oklch()`로 끝나는 토큰만 하고 나머지는 실패한다. `color-mix()`는 `in oklab`만 쓴다. — `docs/styling/design-tokens.md` UI-01·UI-02 4. 다크 테마 재정의를 빠뜨리거나 light 전용 패널·글자색을 박는다. 핵심 역할 토큰은 `:root[data-theme="dark"]`에 모두 있어야 하고, `component.css`에 forced-colors 대체가 있어야 한다. — `docs/styling/design-tokens.md`, `scripts/check-design-system.ts` 5. 디자인 시스템 하위 파일, `lucide-react`, headless 라이브러리를 직접 import한다. `src/presentation/design-system/index.ts`와 vendor facade로만 들어간다. — `docs/architecture/layers.md` 규칙 `design-system-is-reached-through-its-index`·`icon-vendor-is-facade-only`, `docs/design/2026-07-26-design-system-platform-design.md` 6.1절 -6. 사용자 값이나 실행 중에 조립한 class 문자열을 쓰고, 같은 bracket 값을 여러 곳에 쓴다. variant는 닫힌 정적 표에서 고르고, 반복되는 bracket 값은 `@theme`로 올린다. — `docs/styling/design-tokens.md` 「Arbitrary-value policy」 +6. 사용자 값이나 실행 중에 조립한 class 문자열을 쓰고, 같은 bracket 값을 여러 곳에 쓴다. variant는 닫힌 정적 표에서 고르고, 반복되는 bracket 값은 `@theme`로 올린다. — `docs/styling/design-tokens.md` 「임의 값(arbitrary value) 정책」 7. 컴포넌트 API를 열어 둔다: 날 색 prop, vendor 타입 노출, 무제한 `as`, 범위 없는 `className`. — `docs/design/2026-07-26-design-system-platform-design.md` 11절 4단계, 13절 8. primitive가 API·query·인증·저장소를 직접 부른다. pattern·template도 use case를 고르지 않고 상태와 callback을 props로 받는다. — 같은 문서 2절 9. 세 번째 사용 사례가 나오기 전에 제품 전용 조합을 primitive로 올린다. — 같은 문서 2절 diff --git a/.claude/skills/fe-performance/SKILL.md b/.claude/skills/fe-performance/SKILL.md index ead44617..db1a0547 100644 --- a/.claude/skills/fe-performance/SKILL.md +++ b/.claude/skills/fe-performance/SKILL.md @@ -39,7 +39,7 @@ paths: 7. 의존성 하나를 올리고 번들을 안 본다. 갱신 하나가 초기 JS를 약 7 KB 늘려 예산을 넘긴 예가 있다. — `docs/work/reference/performance.md` 2절 8. 조건 없이 숫자를 비교한다. 노트북 측정, 지난 측정을 대조군으로 쓰기, 표본 하나는 비교에 쓰지 않는다. — 같은 문서 3절 9. lab이 재는 범위를 넘겨 짐작한다. `/` 밖 화면의 layout shift, 스크롤바가 보이는 환경은 어느 게이트도 재지 않는다. 기능 라우트 로딩을 바꾸면 그 라우트 첫 진입을 lab과 같은 조건으로 따로 잰다(제안). — 같은 문서 6절, 결함 패턴 B2 -10. Service Worker를 페이지 코드처럼 다룬다. install에서 `skipWaiting()`을 부르지 않는다. 모든 탭이 닫히거나 `requestActivation()`까지 기다린다. 캐시 이름은 자산 묶음 digest이고, 기다리는 동안 release마다 precache가 하나씩 남는다. worker는 HTML·자산과 같은 빌드에서 나온다. 지우는 데 release 셋이 든다. — `docs/operations/release-cache-rollback.md` 「Service Worker steps」 +10. Service Worker를 페이지 코드처럼 다룬다. install에서 `skipWaiting()`을 부르지 않는다. 모든 탭이 닫히거나 `requestActivation()`까지 기다린다. 캐시 이름은 자산 묶음 digest이고, 기다리는 동안 release마다 precache가 하나씩 남는다. worker는 HTML·자산과 같은 빌드에서 나온다. 지우는 데 release 셋이 든다. — `docs/operations/release-cache-rollback.md` 「Service Worker 절차」 11. 청크 로드 실패에 제한 없이 `location.reload`한다. 새 manifest가 확인되고 같은 build에서 한 번만 reload한다. — `docs/design/2026-07-26-routing-pages-and-patterns-design.md` 6.2·11절 12. 런타임 설정·release manifest를 캐시하게 둔다. `config.json`·`release-manifest.json`은 `no-store`, HTML은 `no-cache`, 해시 자산만 1년 `immutable`이다. — `config/hosting/cache-policy.json` diff --git a/.claude/skills/fe-structure/SKILL.md b/.claude/skills/fe-structure/SKILL.md index a81af21e..77a755a4 100644 --- a/.claude/skills/fe-structure/SKILL.md +++ b/.claude/skills/fe-structure/SKILL.md @@ -31,7 +31,7 @@ paths: ## 함정 1. 배럴을 건너뛰어 그룹 내부 파일을 import한다. 2단계 `index.ts`(예: `http/internals/index.ts`)도 공개 배럴이 아니다. 예외는 `storage/indexeddb`·`storage/opfs` 서브배럴뿐이다. — 루트 `AGENTS.md` 꼭 지킬 것 1, `docs/architecture/layers.md` 「어댑터 그룹의 공개 경계」 -2. adapter끼리 import가 필요해 파일 하나를 `pathNot`에 더한다. 예외는 kernel 셋뿐이다. 새 공유 프리미티브는 `src/adapters/platform/`에 둔다. 폴더 전체가 예외라 규칙을 바꿀 필요가 없다. kernel 파일은 메커니즘만 갖고 이름·스키마·실패 code·관측 모양을 갖지 않는다. — 꼭 지킬 것 2, `docs/architecture/layers.md` 「The adapter kernel」, `docs/work/reference/defect-patterns.md` S5 +2. adapter끼리 import가 필요해 파일 하나를 `pathNot`에 더한다. 예외는 kernel 셋뿐이다. 새 공유 프리미티브는 `src/adapters/platform/`에 둔다. 폴더 전체가 예외라 규칙을 바꿀 필요가 없다. kernel 파일은 메커니즘만 갖고 이름·스키마·실패 code·관측 모양을 갖지 않는다. — 꼭 지킬 것 2, `docs/architecture/layers.md` 「adapter kernel」, `docs/work/reference/defect-patterns.md` S5 3. `depcruise`를 돌려 통과로 본다. dependency-cruiser CLI는 TypeScript 7을 못 읽어 0개 모듈을 보고 통과한 일이 있다. 판정은 `check:architecture`다. — 꼭 지킬 것 3, `docs/architecture/layers.md` 끝 절 4. 규칙이 edge 하나씩만 본다는 것을 잊는다. 기능 루트 파일·`src/contexts`·`src/apps`에서 adapter를 re-export하면 다른 규칙이 다 통과해도 adapter가 presentation으로 실려 간다. 그래서 `feature-and-app-roots-do-not-reach-adapters`가 있다. — `docs/architecture/layers.md` 5. `import.meta.glob`으로 모듈을 불러온다. 이름 없이 모듈을 실어 그래프가 edge를 못 보므로 parse failure로 실패한다. — 같은 문서 끝 절 @@ -49,7 +49,7 @@ paths: - [ ] presentation은 adapter·bootstrap을 모르고(예외 `src/presentation/adapters/query`), 직접 fetch하지 않는다. application은 React·TanStack·adapter를 모른다. — `docs/architecture/layers.md` 규칙 표 - [ ] 기능끼리, context끼리 import하지 않는다. 공용이 필요하면 `src/contracts/`나 kernel로 옮기는 일을 따로 묻는다. — `src/features/AGENTS.md`, `src/contexts/AGENTS.md` - [ ] zod는 `src/contracts/zod.ts`로만, 아이콘은 lucide facade로만, 관측 vendor는 adapter 뒤에서만 쓴다. — `docs/architecture/layers.md` -- [ ] 공유 타입의 위치는 `docs/architecture/contract-ownership.md` 「Decision rule」로 정한다. contracts는 application·features·presentation·bootstrap을 모른다. — `src/contracts/AGENTS.md` +- [ ] 공유 타입의 위치는 `docs/architecture/contract-ownership.md` 「판단 규칙」로 정한다. contracts는 application·features·presentation·bootstrap을 모른다. — `src/contracts/AGENTS.md` - [ ] 규칙 예외에는 `pathNot`과 `comment`(이유·담당·재검토 조건)가 함께 있다. 예외가 실제 쓰임보다 넓지 않다. — `docs/work/reference/structure.md` 3절·10절 - [ ] 선택하지 않은 realtime·web-push runtime을 조립하지 않는다. 기능 runtime은 `src/features/loaded-feature-runtimes.ts`만 불러온다. — `src/bootstrap/AGENTS.md` - [ ] 소비자 없는 확장 지점과 빈 레지스트리를 지우자고 하지 않는다. 다운스트림용이다. — 루트 `AGENTS.md` 첫 문단, `docs/work/reference/review-criteria.md` 2절 diff --git a/.claude/skills/fe-ux/SKILL.md b/.claude/skills/fe-ux/SKILL.md index c7ee38b4..3cb18f56 100644 --- a/.claude/skills/fe-ux/SKILL.md +++ b/.claude/skills/fe-ux/SKILL.md @@ -59,7 +59,7 @@ paths: 폼 - [ ] label·설명·오류가 연결되고, 제출 실패 시 오류 요약으로 포커스가 가며, 요약 항목은 그 필드로 간다. — `docs/design/2026-07-26-design-system-platform-design.md` 8.3절 -- [ ] 409를 검증 오류로 위장하지 않는다. 이탈 확인(`useDirtyNavigationGuard`)은 성공 저장 뒤 풀고 이동한다. — `docs/design/2026-07-26-typescript-state-and-data-flow-design.md` 8절, routing 6.4절 +- [ ] 409를 검증 오류로 위장하지 않는다. 이탈 확인(`useDirtyNavigationGuard`)은 성공 저장 뒤 풀고 이동한다. — `docs/design/2026-07-26-typescript-state-and-data-flow-design.md` 8절, `docs/design/2026-07-26-routing-pages-and-patterns-design.md` 6.4절 - [ ] 자동 완성·IME·붙여넣기·비밀번호 관리자를 막지 않는다. 입력을 loading skeleton으로 덮지 않는다. — data-flow 8절 반응형 diff --git a/scripts/tests/test_claude_setup.py b/scripts/tests/test_claude_setup.py index e30b2994..3ed0aeaa 100644 --- a/scripts/tests/test_claude_setup.py +++ b/scripts/tests/test_claude_setup.py @@ -29,6 +29,72 @@ KNOWLEDGE_SECTIONS = ["언제 쓰나 · 넘기는 곳", "함정", "이 분야에 BANNED_IN_DESCRIPTION = ("PROACTIVELY", "MUST", "CRITICAL", "IMPORTANT", "") +# A skill points at a section as `path.md` 「name」, `path.md` 3.1절 (or 3·4절), `path.md` 4.1절 「name」, +# 같은 문서 6절 (the path cited last), or `fe-x` 「name」 (another skill's section). +CITED_TARGET = re.compile(r"`([^`\s]+\.md)`|`((?:fe-[a-z0-9-]+|new-feature|desktop-gates))`|(같은 문서)") +SECTION_NUMBERS = re.compile(r"(\d+(?:\.\d+)*(?:·\d+(?:\.\d+)*)*)절") +SECTION_NAME = re.compile(r"「([^」]+)」") +# What follows a citation up to the first of these is about that citation; past it is the sentence's own text. +CITATION_END = re.compile(r"—|`|\(|\)|;|\. |。") +HEADING_NUMBER = re.compile(r"^(\d+(?:\.\d+)*)\.?(?=\s)") + + +# A paragraph label on its own line ("자동 실행이 검사하는 것:") names a part of a section the same way a heading does. +LABEL_LINE = re.compile(r"^\*{0,2}([^\s*#|>`-][^:|]*?)\*{0,2}:\s*$") + + +def headings(path: Path) -> tuple[set[str], set[str]]: + """The section names of a markdown file and the numbers of its numbered headings. + + A name is a heading's text, with and without its leading number and a trailing "(…)", or a label line.""" + names, numbers, fenced = set(), set(), False + for line in path.read_text(encoding="utf-8").splitlines(): + if line.startswith("```"): + fenced = not fenced + if fenced: + continue + label = LABEL_LINE.match(line) + if label: + names.add(label.group(1).strip()) + if not re.match(r"#{1,6} ", line): + continue + text = line.lstrip("#").strip() + number = HEADING_NUMBER.match(text) + if number: + numbers.add(number.group(1)) + for name in (text, text[number.end():].strip() if number else text): + names.add(name) + names.add(re.sub(r"\s*\([^()]*\)$", "", name)) + return names, numbers + + +def cited_sections(text: str) -> list[tuple[int, str, str]]: + """(line, target file, 「name」 or N절) for every section a skill names after a path or another skill.""" + found, last_path = [], None + for number, line in enumerate(text.splitlines(), 1): + matches = list(CITED_TARGET.finditer(line)) + for index, match in enumerate(matches): + path, skill, same = match.groups() + if path: + target = last_path = path + elif skill: + target = f".claude/skills/{skill}/SKILL.md" + elif last_path: + target = last_path + else: + continue + rest = line[match.end(): matches[index + 1].start() if index + 1 < len(matches) else len(line)] + end = CITATION_END.search(rest) + segment = rest[: end.start()] if end else rest + if skill or same: + # Only a section named right after it: `fe-x`의 「검증」, 같은 문서 12절. + segment = re.match(r"(?:의)?\s*(?:\d[\d.·]*절\s*)?(?:「[^」]+」)?", segment).group(0) + for numbers in SECTION_NUMBERS.findall(segment): + found.extend((number, target, f"{value}절") for value in numbers.split("·")) + found.extend((number, target, f"「{name}」") for name in SECTION_NAME.findall(segment)) + return found + + def front_matter(path: Path) -> tuple[dict[str, str], list[str]]: """The scalar fields and the list items of a document's YAML front matter.""" match = re.match(r"^---\n(.*?)\n---\n", path.read_text(encoding="utf-8"), re.S) @@ -185,6 +251,52 @@ class SkillTest(unittest.TestCase): self.assertIn("쓴다", description, f"{name}: say when to use it") self.assertIn("부른다", description, f"{name}: say what the user says that calls it") + def test_every_section_a_skill_cites_is_a_heading_of_that_document(self) -> None: + # The path check (verify:documentation) passes when a cited document is translated or renumbered + # and the section the skill names is gone: 「Decision rule」 outlived its heading this way. + missing = [] + for path in sorted((CLAUDE / "skills").glob("*/SKILL.md")): + for line, target, section in cited_sections(path.read_text(encoding="utf-8")): + document = REPO / target + if not document.is_file(): + missing.append(f"{path.parent.name}:{line}: {target} does not exist") + continue + names, numbers = headings(document) + known = numbers if section.endswith("절") and not section.startswith("「") else names + if section.strip("「」").removesuffix("절") not in known: + missing.append(f"{path.parent.name}:{line}: {target} has no section {section}") + self.assertEqual(missing, [], "\n" + "\n".join(missing)) + + def test_the_section_check_reads_each_citation_form(self) -> None: + text = "\n".join([ + "- 배럴 — `docs/a.md` 「공개 경계」, `docs/b.md` 3·4.1절", + "- 토큰 — `docs/c.md` 6절 「검사 규칙」, 같은 문서 12절", + "- 원칙 — `PRODUCT.md` 원칙 1, 「Constraints」", + "- 골든을 본다(`fe-design-system` 「검증」). 예제가 없으면 「없음」", + "- `docs/d.md` — 설명. 아래 「함정」", + ]) + self.assertEqual(cited_sections(text), [ + (1, "docs/a.md", "「공개 경계」"), (1, "docs/b.md", "3절"), (1, "docs/b.md", "4.1절"), + (2, "docs/c.md", "6절"), (2, "docs/c.md", "「검사 규칙」"), (2, "docs/c.md", "12절"), + (3, "PRODUCT.md", "「Constraints」"), + (4, ".claude/skills/fe-design-system/SKILL.md", "「검증」"), + ]) + + def test_the_section_check_reads_headings_numbers_and_labels(self) -> None: + import tempfile + with tempfile.TemporaryDirectory() as folder: + document = Path(folder) / "doc.md" + document.write_text("\n".join([ + "# 제목", "## 3. merge 가능 판정", "### 3.1 열린 결정", "#### 토큰 CSS 검사 규칙 (`check:design-system`)", + "임의 값(arbitrary value) 정책:", "- 목록 줄: 이름이 아니다", "```text", "## 9. 코드 안 제목", "```", + ]), encoding="utf-8") + names, numbers = headings(document) + self.assertEqual(numbers, {"3", "3.1"}) + for name in ("merge 가능 판정", "열린 결정", "토큰 CSS 검사 규칙", "임의 값(arbitrary value) 정책"): + self.assertIn(name, names) + self.assertNotIn("코드 안 제목", names) + self.assertFalse(any(name.startswith("목록 줄") for name in names)) + def test_each_skill_points_at_its_canonical_playbook_instead_of_copying_it(self) -> None: for name, canon in self.CANON.items(): body = (CLAUDE / "skills" / name / "SKILL.md").read_text(encoding="utf-8") -- 2.54.0 From bdda84f8440d336e0258b3776ae488850335c3bd Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Thu, 12 Nov 2026 10:49:34 +0900 Subject: [PATCH 2/4] =?UTF-8?q?docs(work):=20desktop=20FE-GATE-013?= =?UTF-8?q?=EC=9D=84=20=EC=A1=B0=EA=B1=B4=EB=B6=80=EB=A1=9C=20merge=20?= =?UTF-8?q?=ED=8C=90=EC=A0=95=EC=97=90=EC=84=9C=20=EB=B9=BC=EA=B8=B0?= =?UTF-8?q?=EB=A1=9C=20=EC=A0=95=ED=95=9C=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: FE-GATE-013을 멈춤 기준에서 어떻게 셀지가 결정 대기라, desktop에서 merge 판정을 하면 매번 「merge 가능 여부는 소유자가 정한다」로 끝났다. desktop의 ssh 셸은 비특권 user namespace를 막아 test:system 사전 점검이 호스트 원인으로 실패한다. 고른 방법: 소유자 결정(2026-11-11, 「그 조건이 되는 실행 환경을 찾아 초록으로」)에 따라 총괄이 권하는 안으로 정했다(2026-11-12). - merge 판정에서 빼는 조건 둘: 실패가 사전 점검의 user namespace 제한 하나뿐이고, `scripts/verify.sh parts FE-GATE-013`의 뒤 명령이 모두 rc=0. - 게이트 「충족」은 조건을 갖춘 runner에서 FE-GATE-013이 통과한 것으로만 센다. - decisions.md: 3.1절(열린 결정)에서 빼고 2.2절에 결정·버린 안·재검토 조건을 적었다. evidence.md 행에 결정 번호를 더했다. - gates.md 3절의 보고 문구, improve.md 멈춤 조건 3, operate.md 4.1절, new-feature.md 완료 기준, desktop-gates 스킬 6단계를 새 규칙으로 고쳤다. 버린 안: runner에서 통과할 때까지 merge 판정을 미충족으로 두기. 그 runner가 아직 없어 모든 PR의 merge 판정이 막힌다. 위험: desktop에서 test:system의 provider 테스트는 여전히 돌지 않는다. 그 몫의 결함은 runner가 FE-GATE-013을 돌 때까지 merge 판정에서 안 보인다. 뒤 명령 목록을 옮겨 적지 않고 gates.json `commandIds`를 가리킨다. 검증: python3 scripts/check-work-docs.py OK(지난 ID 줄 0), python3 -m unittest discover -s scripts/tests 71개 통과. 문서 검사는 desktop에서 돌린다. --- .claude/skills/desktop-gates/SKILL.md | 2 +- docs/work/evidence.md | 2 +- docs/work/improve.md | 2 +- docs/work/new-feature.md | 2 +- docs/work/operate.md | 2 +- docs/work/reference/decisions.md | 4 ++-- docs/work/reference/gates.md | 7 ++++++- 7 files changed, 13 insertions(+), 8 deletions(-) diff --git a/.claude/skills/desktop-gates/SKILL.md b/.claude/skills/desktop-gates/SKILL.md index 34359fc9..f2f74502 100644 --- a/.claude/skills/desktop-gates/SKILL.md +++ b/.claude/skills/desktop-gates/SKILL.md @@ -19,6 +19,6 @@ description: 이 프론트 repo에서 pnpm·게이트·테스트·빌드·브라 - 먼저 무엇을 돌릴지만 보려면 `--dry-run`. 4. 스크립트가 하는 일: 지금 트리를 패치로 보내고, desktop 공유 checkout에서 새 worktree를 만들어 같은 트리인지 해시로 보고, 깨끗한 커밋 하나로 만들어 오프라인 설치 뒤 `flock /tmp/claude-gates/heavy.lock` 아래 CI env(`CI=true` 등)로 돌린다. 공유 checkout의 브랜치와 stash는 건드리지 않는다. push하지 않는다. 5. 결과를 읽는다: desktop `/tmp/claude-gates/<작업 이름>/summary.txt`(첫 줄이 트리 해시), 게이트별 로그, `gate-artifacts/`, `status-after.txt`(비어 있어야 한다). -6. FE-GATE-013은 desktop에서 호스트 제약(user namespace)으로 실패한다. "호스트 제약 실패"로 적고 `parts`로 뒤 명령 결과를 함께 적는다. +6. FE-GATE-013은 desktop에서 호스트 제약(user namespace)으로 실패한다. `parts`로 뒤 명령 결과를 함께 적는다. 실패가 그 제약 하나뿐이고 뒤 명령이 모두 rc=0일 때만 merge 판정에서 뺀다(`docs/work/reference/gates.md` 3절). 7. 실패하면 기준 커밋에서도 돌려 이번 변경 몫인지 가린다. 다시 돌려 통과한 결과를 "통과"로 쓰지 않는다. 8. 보고에는 단계·게이트, rc, 시간, 핵심 숫자, 직전 부하, 트리 해시, 로그 경로를 적는다(`docs/work/operate.md` 8절 표). diff --git a/docs/work/evidence.md b/docs/work/evidence.md index d0b60e66..8fc68a4f 100644 --- a/docs/work/evidence.md +++ b/docs/work/evidence.md @@ -45,7 +45,7 @@ | 경로를 백틱 밖으로 옮기지 않는다(`docs-writing.md` 4절) | 참조 기능 경로 26줄을 백틱 밖으로 옮긴 것이 검사 약화로 기록 | 1105/14-03 | | `npm run` 금지(`gates.md` 2절) | 제거 드릴을 `npm run`으로 돌려 모든 검사가 `Unknown command` | 1103 README 10.4절 | | 임시 worktree의 `pnpm verify:documentation`(`delegate.md` 9절) | pnpm이 재설치를 시도하다 TTY 없음으로 멈춰 결과 무효 | 1105 README 11.5절 | -| FE-GATE-013 desktop 기록법(`gates.md` 3절) | ssh 셸에서 user namespace가 막혀 provider 테스트 18건 실패 | 1105/12-01, 1105 README 11.1절, 1106 README 1절 | +| FE-GATE-013 desktop 판정(`gates.md` 3절) | ssh 셸에서 user namespace가 막혀 provider 테스트 18건 실패. 2026-11-12에 조건부로 merge 판정에서 빼기로 정함 | 1105/12-01, 1105 README 11.1절, 1106 README 1절, D8 | | 대조 허용치 < 여유(`performance.md` 5절) | 허용 1%(약 2 KB) > 남은 여유 1,873 B | 1105/15-02 | | 예산을 올리는 것은 결정(`performance.md` 5절) | 초기 파일 수 26 → 32, 초기 JS 204,800 → 206,848 B | 1103 README 14.6절 #4, 1105 README 16.2절 D7, 1106 README 16.2절 D9 | | 기준선은 합친 끝에서 다시 잰다(`delegate.md` 4.2절) | 브랜치마다 맞던 초기 JS 기록이 합친 빌드에서 허용치를 넘음 | 1106 README 16.3절 | diff --git a/docs/work/improve.md b/docs/work/improve.md index 3ea01600..def94d42 100644 --- a/docs/work/improve.md +++ b/docs/work/improve.md @@ -86,7 +86,7 @@ 1. 그 라운드의 새 High 0. 2. 그 라운드의 새 P1 0. -3. merge 단계 게이트 전부 통과([reference/gates.md](reference/gates.md) 3절 방법). FE-GATE-013을 어떻게 셀지는 결정 대기라, 그동안은 같은 절의 문구로 보고하고 멈출지는 소유자가 정한다. +3. merge 단계 게이트 전부 통과([reference/gates.md](reference/gates.md) 3절 방법). desktop의 FE-GATE-013은 같은 절의 두 조건(실패가 호스트 제약 하나뿐, 뒤 명령 모두 rc=0)을 채우면 빼고 세고, 같은 절 문구로 보고한다. - 채워도 바로 끝내지 않는다. 그 라운드의 Medium·Low를 고치고 멈춘다. 리뷰 발견은 Low까지 고쳐 "남은 문제 0"으로 보고한다. 못 고치는 것은 결정 대기로 남긴다(형식 [reference/decisions.md](reference/decisions.md) 3절). 이유 없는 이월("나중에", "범위 밖")은 남기지 않는다. - 마지막 Medium·Low 수정은 다음 리뷰를 받지 않는다. 그래서 그 수정도 4.2절 6단계와 merge 판정을 그대로 거친다. 짝 백엔드는 "발견 0까지 확인 리뷰"를 쓴다. 두 기준을 맞추지 않는다(소유자 결정 2026-11-05 「각자 유지」). diff --git a/docs/work/new-feature.md b/docs/work/new-feature.md index 607d12b9..3d0124ba 100644 --- a/docs/work/new-feature.md +++ b/docs/work/new-feature.md @@ -39,7 +39,7 @@ - 생성 명령으로 시작했고, 템플릿 소유 파일을 생성 명령 밖에서 고치지 않았다(고쳤으면 큼으로 올려 결정을 받았다). - 동작마다 테스트가 있고 RED → GREEN을 봤다. - 초기 JS 기록이 빌드와 맞는다(`test:unit` 안의 대조). -- `scripts/verify.sh merge`가 통과했고(FE-GATE-013은 [reference/gates.md](reference/gates.md) 3절 문구로 적었다) FE-GATE-026도 통과했다. +- `scripts/verify.sh merge`가 통과했고(FE-GATE-013은 [reference/gates.md](reference/gates.md) 3절 조건을 채워 빼고 그 문구로 적었다) FE-GATE-026도 통과했다. - 이 기능을 지운 사본이 통과한다(`test:sample-removal -- --feature=`). - 다운스트림에 보이는 변경(공개 포트, 생성 명령 출력)이 있으면 `CHANGELOG.md` 미출시 절에 적었다. diff --git a/docs/work/operate.md b/docs/work/operate.md index d83221c2..7c2aca28 100644 --- a/docs/work/operate.md +++ b/docs/work/operate.md @@ -35,7 +35,7 @@ - **공유 checkout을 건드리지 않는다.** desktop의 그 checkout은 다른 세션도 쓴다. 브랜치를 바꾸지 않고, `stash`를 건드리지 않는다. 어쩔 수 없이 그 checkout에서 돌려야 하면 잠금 안에서 바꾸고 끝나면 처음 브랜치로 되돌린 뒤 `git status`가 비었는지 본다. - **잠금.** 무거운 실행은 하나씩 돈다. 백엔드 세션도 같은 desktop에서 같은 잠금을 쓴다. 다른 세션이 잠금을 쥐고 있으면 기다리고, 기다리는 동안 다른 일을 한다. 오래 걸리는 단계는 background로 띄우고 끝나기를 한 번 기다린다(짧은 간격으로 확인하지 않는다). - **CI env.** `scripts/verify.sh`는 게이트를 workflow와 같은 꼴의 env로 돌린다: `CI=true`, `VITE_COMMIT_SHA`(그 worktree의 HEAD), `VITE_BUILD_ID`, `RELEASE_ID`, `CI_RUNNER_IMAGE`(`@sha256:` digest 꼴). `CI=true`를 빼면 CI에서만 나는 실패를 놓친다([reference/gates.md](reference/gates.md) 4절). -- **desktop의 FE-GATE-013.** ssh 셸에서 비특권 user namespace가 막혀 `test:system`의 provider 테스트가 호스트 원인으로 실패한다. 시스템 설정은 바꾸지 않는다. `scripts/verify.sh parts FE-GATE-013`으로 그 게이트의 명령을 하나씩 끝까지 돌려, 실패가 호스트 전제 하나뿐인지와 뒤 명령의 결과를 함께 적는다. 이 게이트를 멈춤 기준에서 어떻게 셀지는 결정 대기다([reference/decisions.md](reference/decisions.md)). +- **desktop의 FE-GATE-013.** ssh 셸에서 비특권 user namespace가 막혀 `test:system`의 provider 테스트가 호스트 원인으로 실패한다. 시스템 설정은 바꾸지 않는다. `scripts/verify.sh parts FE-GATE-013`으로 그 게이트의 명령을 하나씩 끝까지 돌려, 실패가 호스트 전제 하나뿐인지와 뒤 명령의 결과를 함께 적는다. 둘 다 맞고 뒤 명령이 모두 rc=0이면 merge 판정에서 뺀다. 게이트 충족은 조건을 갖춘 runner에서 통과한 것으로만 센다([reference/gates.md](reference/gates.md) 3절). - **노트북에서 꼭 돌려야 하면** 노트북 checkout이 아니라 깨끗한 복제본(`git clone --no-hardlinks`, 그 뒤 `corepack pnpm install --frozen-lockfile --offline`)에서 돌리고 vite가 들어가는 게이트에 `CHOKIDAR_USEPOLLING=1`을 준다. 노트북 checkout의 `.claude/worktrees/`가 `test:system`의 repo 복사와 vite 파일 감시를 깨뜨린다. - **desktop에서 파일을 만드는 명령**(생성 명령, 기준선 다시 쓰기)은 `--apply-back`으로 결과를 노트북 작업 트리에 받는다: `scripts/verify.sh script create:feature --apply-back -- `, `scripts/verify.sh exec --apply-back -- <명령…>`. 바뀐 파일은 언제나 로그 폴더의 `changes.patch`에도 남는다. - **한 테스트 파일**도 desktop에서: `scripts/verify.sh exec -- node scripts/run-vitest.ts run <파일>`. diff --git a/docs/work/reference/decisions.md b/docs/work/reference/decisions.md index 6066a1c0..80e9a1c2 100644 --- a/docs/work/reference/decisions.md +++ b/docs/work/reference/decisions.md @@ -56,6 +56,7 @@ | WebKit preload 경고(1103/11-09) | 2026-11-05 | 경고 문구 하나만 무시하고 preload 사용을 세 엔진에서 직접 검사한다 | 1103 README 14.7절 | | 1105 결정 D7 | 2026-11-05 | 초기 JS 예산을 204,800 B에서 206,848 B로 올린다 | 1105 README 16.2절 | | 1106 결정 D9·D10 | 2026-11-06 | 초기 JS 예산 206,848 B를 그대로 두고 근거·되돌림 규칙을 `docs/operations/performance-evidence.md`에 둔다(D9). 결과 불명 KEYED 재전송이 쓰기 전 거절로 끝나도 훅이 결과 불명과 키를 지킨다. 재전송의 거절이 결과 불명을 푸는 것은 짝 백엔드 표의 code뿐이다(D10과 보완 둘, 판정 `src/contracts/errors.ts` `isRefusedOnEveryAttempt`) | 1106 README 16.2절 | +| 결정 D8 FE-GATE-013 판정 | 2026-11-12 | desktop에서 FE-GATE-013의 실패가 사전 점검의 user namespace 제한(bwrap) 하나뿐이고 `scripts/verify.sh parts FE-GATE-013`의 뒤 명령이 모두 rc=0이면, merge 판정에서 그 실패를 호스트 원인으로 빼고 센다. 게이트 「충족」은 조건을 갖춘 runner에서 FE-GATE-013이 통과한 것으로만 센다. 버린 안: runner에서 통과할 때까지 merge 판정을 미충족으로 두기(그 runner가 아직 없어 모든 PR의 merge 판정이 막힌다). 재검토: 조건을 갖춘 runner가 merge 단계를 돌게 되면 desktop 예외가 아직 필요한지 다시 본다. 판정 방법은 `gates.md` 3절 | 소유자 결정 e(2026-11-11, 「그 조건이 되는 실행 환경을 찾아 초록으로」)에 따라 총괄이 권하는 안으로 정함(2026-11-12, repo 밖). 관련 발견 1105/12-01 | | 구조·기술 결정 기록 | 2026-07-26~ | `VD-01`~(빈 번호 있음) | `docs/adr/` | ## 3. 결정 대기 쓰는 법 @@ -75,14 +76,13 @@ ### 3.1 지금 열린 결정 대기 -2026-11-06 리뷰(1106) 시점이다. 다음 라운드가 닫거나 새로 열면 이 표를 고친다. +2026-11-06 리뷰(1106) 시점이다. 다음 라운드가 닫거나 새로 열면 이 표를 고친다. D8은 2026-11-12에 정해 2.2절로 옮겼다. | 번호 | 결정 | 관련 | 결정할 사람 | 출처 | | --- | --- | --- | --- | --- | | D1 | 운영 advisory 2건(zod·react-router). zod 갱신은 초기 JS를 약 7 KB 늘린다 | 1103/13-03 | 프론트 소유자 + reviewer | 1106 README 7절 | | D2 | 플랫폼 구성 화면을 진단 화면으로 인정할지, 기능으로 옮기고 다시 잴지 | 1103/09-04 | 프론트 소유자 | 같음 | | D3 | 백엔드 생성기의 목록 GET | 1103/03-07 | 두 repo 소유자 | 같음 | -| D8 | FE-GATE-013을 멈춤 기준에서 어떻게 셀지(호스트 제약 실패로 제외 / 다른 러너에서 통과할 때까지 미충족) | 1105/12-01 | 소유자 | 같음 | | D11 | 생성 기능 설치 상태의 브라우저 merge 게이트 | 1105/16-03 | 템플릿 담당 | 같음 | | D6(1105) | 실행 격리: 실행별 출력·빈 포트, 또는 "한 checkout 한 실행" 명시. `ci:gate` 두 실행은 아직 같은 `dist`·`artifacts/`를 쓴다 | 1105/12-04 | 프론트 소유자 | 1105 README 7절, 1106 README 2.3절 | diff --git a/docs/work/reference/gates.md b/docs/work/reference/gates.md index d92af0f2..1db8d0ef 100644 --- a/docs/work/reference/gates.md +++ b/docs/work/reference/gates.md @@ -68,7 +68,12 @@ release 단계 게이트는 merge 단계에 없다. 그래서 lab 게이트 회 **가끔 떨어지는 게이트.** 다시 돌려 통과시킨 결과를 "통과"로 쓰지 않는다. 실패한 회차를 그대로 적고 원인을 찾는다([testing.md](testing.md) 5절). "세 번째 실행에서 통과"로 적혔던 FE-GATE-008의 두 실패는 둘 다 테스트 결함이었다. 원인을 고친 뒤에는 같은 게이트를 연속으로 여러 번 돌려 실패 0을 적는다. -**desktop에서 FE-GATE-013.** ssh 셸에서 비특권 user namespace가 막혀 `bwrap --unshare-net`이 실패하고, `test:system`의 provider 테스트가 호스트 원인으로 떨어진다. 사전 점검(`scripts/check-system-test-prerequisites.ts`)은 이제 이 제한을 이름으로 대며 실패한다. 이 게이트를 멈춤 기준에서 어떻게 셀지는 결정 대기다([decisions.md](decisions.md)). 결정 전까지 merge 판정 보고는 이 문구로 쓴다: 「merge 단계 중 FE-GATE-013 밖 전부 통과, FE-GATE-013은 desktop 호스트 제약 실패(뒤 명령 결과 첨부). merge 가능 여부는 소유자가 정한다(FE-GATE-013을 멈춤 기준에서 어떻게 셀지의 결정 대기, [decisions.md](decisions.md) 3.1절)」. 뒤 명령 결과는 `scripts/verify.sh parts FE-GATE-013`으로 낸다. 시스템 설정은 바꾸지 않는다. +**desktop에서 FE-GATE-013.** ssh 셸에서 비특권 user namespace가 막혀 `bwrap --unshare-net`이 실패하고, `test:system`의 provider 테스트가 호스트 원인으로 떨어진다. 사전 점검(`scripts/check-system-test-prerequisites.ts`)은 이 제한을 이름으로 대며 실패한다. merge 판정에서는 이 실패를 호스트 원인으로 보고 뺀다(소유자 결정 2026-11-11에 따라 2026-11-12에 정함, [decisions.md](decisions.md) 2.2절). 뺄 수 있는 조건은 둘이고, 하나라도 어기면 merge 가능이 아니다. + +1. FE-GATE-013의 실패가 사전 점검의 user namespace 제한 하나뿐이다. +2. `scripts/verify.sh parts FE-GATE-013`으로 돌린 뒤 명령(`config/ci/gates.json`의 FE-GATE-013 `commandIds`에서 `test-system` 다음 것)이 모두 rc=0이다. + +보고 문구는 「merge 단계 중 FE-GATE-013 밖 전부 통과, FE-GATE-013은 desktop 호스트 제약(user namespace)이라 판정에서 뺌(뒤 명령 결과 첨부, 모두 rc=0)」이다. 이것은 merge 판정이지 게이트 충족이 아니다. FE-GATE-013의 「충족」은 그 조건을 갖춘 runner에서 FE-GATE-013이 통과한 것으로만 적는다. 시스템 설정은 바꾸지 않는다. ## 4. CI env에서만 나는 실패 -- 2.54.0 From ac19de85ac2808547d1654d3cf98223dfe9587e4 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Thu, 12 Nov 2026 10:49:34 +0900 Subject: [PATCH 3/4] =?UTF-8?q?docs(ci):=20ungated-tests.json=EC=9D=98=20r?= =?UTF-8?q?eason=EC=9D=84=20=ED=95=9C=EA=B5=AD=EC=96=B4=EB=A1=9C=20?= =?UTF-8?q?=EC=98=AE=EA=B8=B4=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: config/ci/ungated-tests.json의 reason 6개(같은 문장)가 영어다. 설정 파일의 사람이 읽는 설명 칸은 한국어로 쓴다(docs/README.md 2절). 고른 방법: scripts/lib/ungated-tests.ts는 빈 문자열만 막고, 시험은 reason 내용을 읽지 않는다. 경로·명령·게이트 ID·리뷰 ID는 그대로 두고 문장만 옮겼다. ungated-scripts.json의 같은 scale 이유와 말을 맞췄다. 위험: 없다고 본다. 읽는 코드가 내용을 보지 않는다(위 확인). 검증: diff가 reason 6줄뿐이다(키·순서·항목 수 같음). ungated-tests 시험과 check:ci:gating(FE-GATE-029)은 desktop에서 돌린다. --- config/ci/ungated-tests.json | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/config/ci/ungated-tests.json b/config/ci/ungated-tests.json index f9612c48..dbbecf91 100644 --- a/config/ci/ungated-tests.json +++ b/config/ci/ungated-tests.json @@ -3,27 +3,27 @@ "entries": [ { "path": "tests/scale/composition-scale.test.ts", - "reason": "Scale suite in the main or nightly tier (scripts/scale/run-scale-profile.ts). No CI job runs those tiers: both include baseline-regression, which compares timings only on the CPU model that recorded config/scale/benchmark-baseline.json and reports incomplete elsewhere (review 11-03). Run check:scale:main or check:scale:nightly on that machine. The CPU-independent pr tier runs in FE-GATE-005." + "reason": "main 또는 nightly scale 단계의 suite다(scripts/scale/run-scale-profile.ts). 이 단계를 도는 CI job은 없다. 두 단계 모두 baseline-regression을 포함하는데, 이 검사는 config/scale/benchmark-baseline.json을 기록한 CPU 모델에서만 시간을 비교하고 다른 곳에서는 incomplete로 보고한다(리뷰 11-03). 그 기계에서 check:scale:main이나 check:scale:nightly를 돌린다. CPU와 상관없는 pr 단계는 FE-GATE-005에서 돈다." }, { "path": "tests/scale/global-local-independence.test.ts", - "reason": "Scale suite in the main or nightly tier (scripts/scale/run-scale-profile.ts). No CI job runs those tiers: both include baseline-regression, which compares timings only on the CPU model that recorded config/scale/benchmark-baseline.json and reports incomplete elsewhere (review 11-03). Run check:scale:main or check:scale:nightly on that machine. The CPU-independent pr tier runs in FE-GATE-005." + "reason": "main 또는 nightly scale 단계의 suite다(scripts/scale/run-scale-profile.ts). 이 단계를 도는 CI job은 없다. 두 단계 모두 baseline-regression을 포함하는데, 이 검사는 config/scale/benchmark-baseline.json을 기록한 CPU 모델에서만 시간을 비교하고 다른 곳에서는 incomplete로 보고한다(리뷰 11-03). 그 기계에서 check:scale:main이나 check:scale:nightly를 돌린다. CPU와 상관없는 pr 단계는 FE-GATE-005에서 돈다." }, { "path": "tests/scale/session/long-session.test.ts", - "reason": "Scale suite in the main or nightly tier (scripts/scale/run-scale-profile.ts). No CI job runs those tiers: both include baseline-regression, which compares timings only on the CPU model that recorded config/scale/benchmark-baseline.json and reports incomplete elsewhere (review 11-03). Run check:scale:main or check:scale:nightly on that machine. The CPU-independent pr tier runs in FE-GATE-005." + "reason": "main 또는 nightly scale 단계의 suite다(scripts/scale/run-scale-profile.ts). 이 단계를 도는 CI job은 없다. 두 단계 모두 baseline-regression을 포함하는데, 이 검사는 config/scale/benchmark-baseline.json을 기록한 CPU 모델에서만 시간을 비교하고 다른 곳에서는 incomplete로 보고한다(리뷰 11-03). 그 기계에서 check:scale:main이나 check:scale:nightly를 돌린다. CPU와 상관없는 pr 단계는 FE-GATE-005에서 돈다." }, { "path": "tests/scale/session/network-flap.test.ts", - "reason": "Scale suite in the main or nightly tier (scripts/scale/run-scale-profile.ts). No CI job runs those tiers: both include baseline-regression, which compares timings only on the CPU model that recorded config/scale/benchmark-baseline.json and reports incomplete elsewhere (review 11-03). Run check:scale:main or check:scale:nightly on that machine. The CPU-independent pr tier runs in FE-GATE-005." + "reason": "main 또는 nightly scale 단계의 suite다(scripts/scale/run-scale-profile.ts). 이 단계를 도는 CI job은 없다. 두 단계 모두 baseline-regression을 포함하는데, 이 검사는 config/scale/benchmark-baseline.json을 기록한 CPU 모델에서만 시간을 비교하고 다른 곳에서는 incomplete로 보고한다(리뷰 11-03). 그 기계에서 check:scale:main이나 check:scale:nightly를 돌린다. CPU와 상관없는 pr 단계는 FE-GATE-005에서 돈다." }, { "path": "tests/scale/telemetry/telemetry-storm.test.ts", - "reason": "Scale suite in the main or nightly tier (scripts/scale/run-scale-profile.ts). No CI job runs those tiers: both include baseline-regression, which compares timings only on the CPU model that recorded config/scale/benchmark-baseline.json and reports incomplete elsewhere (review 11-03). Run check:scale:main or check:scale:nightly on that machine. The CPU-independent pr tier runs in FE-GATE-005." + "reason": "main 또는 nightly scale 단계의 suite다(scripts/scale/run-scale-profile.ts). 이 단계를 도는 CI job은 없다. 두 단계 모두 baseline-regression을 포함하는데, 이 검사는 config/scale/benchmark-baseline.json을 기록한 CPU 모델에서만 시간을 비교하고 다른 곳에서는 incomplete로 보고한다(리뷰 11-03). 그 기계에서 check:scale:main이나 check:scale:nightly를 돌린다. CPU와 상관없는 pr 단계는 FE-GATE-005에서 돈다." }, { "path": "tests/scale/tsc-diagnostics-parser.test.ts", - "reason": "Scale suite in the main or nightly tier (scripts/scale/run-scale-profile.ts). No CI job runs those tiers: both include baseline-regression, which compares timings only on the CPU model that recorded config/scale/benchmark-baseline.json and reports incomplete elsewhere (review 11-03). Run check:scale:main or check:scale:nightly on that machine. The CPU-independent pr tier runs in FE-GATE-005." + "reason": "main 또는 nightly scale 단계의 suite다(scripts/scale/run-scale-profile.ts). 이 단계를 도는 CI job은 없다. 두 단계 모두 baseline-regression을 포함하는데, 이 검사는 config/scale/benchmark-baseline.json을 기록한 CPU 모델에서만 시간을 비교하고 다른 곳에서는 incomplete로 보고한다(리뷰 11-03). 그 기계에서 check:scale:main이나 check:scale:nightly를 돌린다. CPU와 상관없는 pr 단계는 FE-GATE-005에서 돈다." } ] } -- 2.54.0 From c8b70f5a2bb44c68a2bcb341ad35729ac99ced0e Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Thu, 12 Nov 2026 10:49:49 +0900 Subject: [PATCH 4/4] =?UTF-8?q?docs(changelog):=20FE-GATE-013=20=ED=8C=90?= =?UTF-8?q?=EC=A0=95=C2=B7=EC=8A=A4=ED=82=AC=20=EC=A0=88=20=EB=8C=80?= =?UTF-8?q?=EC=A1=B0=C2=B7ungated=20reason=EC=9D=84=20=EC=A0=81=EB=8A=94?= =?UTF-8?q?=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: desktop FE-GATE-013 판정 규칙, 스킬 절 인용 시험, ungated-tests reason 번역이 변경 이력에 없다. 절 인용 시험은 자기 문서의 절 이름을 바꾼 다운스트림이 스킬도 같이 고쳐야 통과한다. 고른 방법: 「정리 단계」 절 머리에 이 브랜치 범위를 더하고 「그 밖의 수정」에 세 줄을 더한다. 위험: 커밋 해시는 이 브랜치의 것이다. main이 다시 바뀌어 rebase하면 함께 고친다. 검증: 문서 검사는 desktop에서 돌린다. --- CHANGELOG.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index f904b881..415ef9ce 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -43,7 +43,7 @@ ## 미출시 — `48c7695b` → 정리 단계 -2026-11-07 소유자가 지시한 저장소 정리다(design-docs `repo-structure/04-frontend-layout.md` 9.2절, 결정은 `repo-structure/README.md` 3.4절). 범위는 `main` `48c7695b`(PR #9 병합) 다음부터다. 1단계(PR #11, `85f941c4`~`121e1125`, `main` `f33e4778`에 합침), 2단계(브랜치 `chore/layout-2-sample-removal`, `c7e80f2f`~`ad3a071f`), 3단계(합치기)와 4단계(배치 규칙 검사)(브랜치 `chore/layout-3-merge`, `bf485f44`~`c54c3813`), CI 재편(브랜치 `chore/ci-merge-jobs`, `0739f26b`부터 브랜치 끝까지), 문서 체계 단계(브랜치 `claude/fe-b-docs-korean-645f55`, `99e76e87`부터 브랜치 끝까지. design-docs `conventions/docs-system.md`), 4단계에 남은 R2·R5 검사(브랜치 `chore/layout-rules-r2-r5`, `3f64c689`부터 브랜치 끝까지), 문서 체계 후속(브랜치 `claude/fe-b-docs-followup`, `8acf07c2`부터 브랜치 끝까지)을 담는다. 기준점 `48c7695b`를 빼면 이 절의 해시는 모두 이 범위에 있다. +2026-11-07 소유자가 지시한 저장소 정리다(design-docs `repo-structure/04-frontend-layout.md` 9.2절, 결정은 `repo-structure/README.md` 3.4절). 범위는 `main` `48c7695b`(PR #9 병합) 다음부터다. 1단계(PR #11, `85f941c4`~`121e1125`, `main` `f33e4778`에 합침), 2단계(브랜치 `chore/layout-2-sample-removal`, `c7e80f2f`~`ad3a071f`), 3단계(합치기)와 4단계(배치 규칙 검사)(브랜치 `chore/layout-3-merge`, `bf485f44`~`c54c3813`), CI 재편(브랜치 `chore/ci-merge-jobs`, `0739f26b`부터 브랜치 끝까지), 문서 체계 단계(브랜치 `claude/fe-b-docs-korean-645f55`, `99e76e87`부터 브랜치 끝까지. design-docs `conventions/docs-system.md`), 4단계에 남은 R2·R5 검사(브랜치 `chore/layout-rules-r2-r5`, `3f64c689`부터 브랜치 끝까지), 문서 체계 후속(브랜치 `claude/fe-b-docs-followup`, `8acf07c2`부터 브랜치 끝까지. 브랜치 `claude/fe-b-docs-followup-2`, `1b3eee41`부터 브랜치 끝까지)을 담는다. 기준점 `48c7695b`를 빼면 이 절의 해시는 모두 이 범위에 있다. ### 먼저 할 일 (BREAKING) @@ -127,6 +127,9 @@ - 번역할 때 남겨 둔 낡은 서술 일곱 곳을 코드·설정에 맞췄다: 계약 파일 수는 `src/contracts/`를 가리키고, Local Draft는 테스트 fixture라고 쓰고, 초기 JS 파일 수의 기준은 feature가 없는 빌드다. `.dependency-cruiser.json` 주석은 절 이름을 쓰고, runbook 문서 제목은 `runbooks.json` title과 같다. zod advisory 행의 잰 버전을 밝히고, runbook record 고정 경로 문단의 두 문장을 제자리로 옮겼다 (`374af986`). - `drill:runbook`의 복구 확인 항목 이름이 `runbooks.json`의 `recoveryEvidence`와 같다. `record.json`의 `assertion` 값이 한국어가 되고, `tests/unit/runbook-drill.test.ts`가 이름과 순서를 대조한다. 자기 `recoveryEvidence`를 고쳤으면 drill 이름도 같이 고친다 (`6571d8cb`). - `config/ci/ungated-scripts.json`의 `reason`을 한국어로 옮겼다 (`b824195c`). +- desktop의 FE-GATE-013은 실패가 user namespace 제한 하나뿐이고 `scripts/verify.sh parts FE-GATE-013`의 뒤 명령이 모두 rc=0이면 merge 판정에서 뺀다. 게이트 충족은 조건을 갖춘 runner에서 통과한 것으로만 센다(`docs/work/reference/gates.md` 3절, 결정 색인 2.2절). 열린 결정에서 뺐다 (`bdda84f8`). +- 스킬이 인용하는 절 이름·번호가 그 문서에 있는지 `scripts/tests/test_claude_setup.py`가 대조한다. 번역으로 사라진 절을 가리키던 9곳을 지금 제목으로 고쳤다. 자기 문서의 절 이름을 바꾸면 그 절을 인용하는 스킬도 같이 고친다 (`1b3eee41`). +- `config/ci/ungated-tests.json`의 `reason`을 한국어로 옮겼다 (`ac19de85`). ### 알려진 제한 -- 2.54.0