docs(work): FE-GATE-013 desktop 판정을 정하고 스킬 절 인용을 대조한다 #21
@@ -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 <작업 이름>`
|
||||
@@ -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, 시간, 핵심 숫자, 직전 부하, 트리 해시, 로그 경로를 적는다(`operate.md` 8절 표).
|
||||
8. 보고에는 단계·게이트, rc, 시간, 핵심 숫자, 직전 부하, 트리 해시, 로그 경로를 적는다(`docs/work/operate.md` 8절 표).
|
||||
|
||||
@@ -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」
|
||||
|
||||
## 이 분야에서 실패는 이렇게 보인다
|
||||
|
||||
|
||||
@@ -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절
|
||||
|
||||
@@ -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`
|
||||
|
||||
|
||||
@@ -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절
|
||||
|
||||
@@ -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절
|
||||
|
||||
반응형
|
||||
|
||||
+4
-1
@@ -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`).
|
||||
|
||||
### 알려진 제한
|
||||
|
||||
|
||||
@@ -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에서 돈다."
|
||||
}
|
||||
]
|
||||
}
|
||||
|
||||
@@ -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절 |
|
||||
|
||||
@@ -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 「각자 유지」).
|
||||
|
||||
@@ -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=<id>`).
|
||||
- 다운스트림에 보이는 변경(공개 포트, 생성 명령 출력)이 있으면 `CHANGELOG.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 -- <id>`, `scripts/verify.sh exec --apply-back -- <명령…>`. 바뀐 파일은 언제나 로그 폴더의 `changes.patch`에도 남는다.
|
||||
- **한 테스트 파일**도 desktop에서: `scripts/verify.sh exec -- node scripts/run-vitest.ts run <파일>`.
|
||||
|
||||
@@ -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절 |
|
||||
|
||||
|
||||
@@ -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에서만 나는 실패
|
||||
|
||||
|
||||
@@ -29,6 +29,72 @@ KNOWLEDGE_SECTIONS = ["언제 쓰나 · 넘기는 곳", "함정", "이 분야에
|
||||
BANNED_IN_DESCRIPTION = ("PROACTIVELY", "MUST", "CRITICAL", "IMPORTANT", "<example>")
|
||||
|
||||
|
||||
# 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")
|
||||
|
||||
Reference in New Issue
Block a user