정리 4단계(PR #14)가 남긴 두 「일부」를 끝낸다. 프로그램의 「남은 발견 0」 기준 때문이다(design-docs template-program/README.md, repo-structure/04-frontend-layout.md 11절 R2·R5).
R2: 루트 경로 목록 검사가 등록부를 쓰는 7곳만 봤다. 그 밖에 루트 이름을 담은 목록이 코드 15파일에 19개 따로 있었다. 사본이 건너뛰는 항목, git grep 경로, Playwright 설정, 문서 입력, tsconfig 묶음 같은 것들이다. 루트 항목 하나를 옮기면 여전히 여러 곳을 같이 고쳐야 했다.
R5: 샘플이 게이트 대상인지 보는 검사가 문자열 검색이었다. 샘플의 기능 ID나 라우트 경로가 goto 문자열·증거 경로·규모 기록 본문에 들어 있는지만 봤다. 그래서 조립한 경로, 여러 줄 goto, origin을 붙인 template 문자열, 샘플 모듈을 import하는 spec은 놓쳤다.
그리고 이 PR의 desktop 실행에서 main부터 있던 결함 하나를 찾아 같이 고쳤다. FE-GATE-013의 provider fixture가 추적되는 .claude/ 파일을 빠뜨려 system 시험 18개가 실패했다(3번). R2가 옮긴 목록 중 하나라서 여기서 고친다.
고른 방법과 버린 대안
커밋 다섯과 main을 합친 merge 커밋 둘이다. 끝 merge c28bf92c를 뺀 커밋마다 desktop에서 test:unit·check:types·check:ci·lint·verify:documentation을 돌렸다(아래 검증).
3f64c689 R2.
등록부(config/repository-layout.json)에 집합 12개를 더했다. 집합마다 설명에 읽는 파일을 적었다.
template-feature-removal-documents 시험의 문서 목록은 이미 있던 fixture-documents 집합을 그대로 쓴다.
집합의 원소는 옮기기 전 목록과 같다. 그래서 동작은 바뀌지 않는다.
사본이 건너뛰는 node_modules·dist·.tmp처럼 추적하지 않는 항목은 새 종류 untracked(optional)로 적는다. 추적 파일이 있으면 시험이 실패한다.
R2 시험이 추적되는 코드 파일 전체를 본다. 다음 배열이 있으면 실패한다:
원소가 모두 루트 항목이나 그 안 경로인 문자열 배열이고,
그중 추적되는 루트 이름이 둘 이상이다.
인자 목록은 -- 뒤만 본다.
집합마다 selectRepositoryPaths·selectRepositoryEntries로 그것을 고르는 코드가 있는지도 본다.
문서를 복사하지 않는 제거 drill(FE-GATE-020의 기능 제거 셋)은 문서 시험(REMOVAL_FIXTURE_DOCUMENT_TESTS)을 지운다. 그런데 집합 셋(agent-harness·documentation-inputs·feature-typecheck)은 그 시험만 읽는다.
그래서 시험이 이 셋을 DOCUMENT_TEST_SETS로 적어 둔다. 문서 시험이 지워진 사본에서만 셋이 비어도 된다. 셋이 바뀌면 전체 checkout에서 실패한다.
첫 desktop 실행에서 FE-GATE-020이 이것으로 실패해 R2 커밋에 고침을 합쳤다(검증 참고).
파서는 등록부의 kinds·sets 설명이 코드의 목록과 같은지 본다.
버린 것:
목록마다 예외로 두기: 「남은 발견 0」이 안 된다.
루트 이름이 둘 이상인 배열을 모두 잡기: npm 하위 명령 목록(docs·config 포함)처럼 경로가 아닌 목록까지 걸린다.
추적 안 하는 항목도 루트 이름으로 세기: 하위 폴더 이름 목록(realtime-boundaries.ts의 node_modules·dist 건너뛰기)까지 걸린다.
1f57c38e R5. 게이트 대상마다 소유자를 따라간다.
visual·e2e의 goto 경로 → 라우트 표(ROUTE_REGISTRY)의 라우트와 그 기능(ROUTE_FEATURE_OWNER). 선언된 경로가 없으면 catch-all.
workshop story id → title이 그 id를 만드는 stories 파일.
spec의 import → 불러오는 파일을 끝까지 따라간다. 생성기 출력 src/.generated/에서 멈춘다. 그곳의 기능 색인은 설치된 기능을 모두 import하고, 샘플을 지우면 다시 생성된다.
config/ci/gates.json의 수동 a11y 기록 → 그 라우트. 라우트 표에 없으면 실패한다(지운 기능의 기록이 남은 경우).
게이트 명령 → package script 그래프(reachablePackageScripts)로 닿는 script, 경로 인자, --feature 인자.
config/scale/feature-shape-growth.json의 sourceFeature → 기능.
시험 셋:
실제 저장소 결과가 비지 않는지(goto 대상 10개 넘음, src/ 파일에 닿음, 라우트 기록 있음, script 20개 넘음).
플랫폼 화면·디자인 시스템·메시지 카탈로그가 샘플 것이었다면 실제 spec·게이트 중 무엇이 걸리는지.
합성 샘플로 여섯 경로가 각각 잡히는지.
버린 것: TypeScript AST로 import와 goto를 읽기. 이 repo의 TypeScript 7.0(네이티브판)은 JS API가 없다.
ceaf21ea provider fixture가 추적되는 .claude 파일도 복사한다.
이 PR의 첫 desktop 전체 실행에서 찾았다. FE-GATE-013의 tests/system/ci-runner/ci-artifact-contract.test.ts에서 finalizer 시험 18개가 ENOENT … .claude/agents/arch-reviewer.md로 실패했다.
원인: 기준 fixture가 checkout을 .git째 복사하면서 .claude를 통째로 건너뛴다. 하네스 PR #13 뒤로 .claude/에 추적 파일이 11개 있다. 공급망 생성(scripts/lib/repository-file-inventory.ts)이 추적 파일마다 lstat해서 후보 빌드가 멈춘다.
main 38c0dc7d에서도 같다. runner에서는 이 시험이 bwrap 없음으로 돌지 못해 드러나지 않았다.
고침: 다른 worktree가 있는 .claude/worktrees만 건너뛴다. 등록부가 .claude 항목의 setPaths로 그 경로를 고르고, 복사 filter는 경로 앞부분으로 비교한다.
버린 것: inventory가 .claude를 건너뛰게 하기(실제 후보 빌드의 inventory까지 추적 파일을 빠뜨린다), fixture의 git index에서 지우기(fixture가 실제 checkout과 달라진다).
414fc2aa 매뉴얼 03 E절 R1·R2·R5 검사 칸과 집합을 더하는 단계, CHANGELOG 「먼저 할 일」 15·16, 계약 표 한 줄, 3번의 수정 한 줄, 절 머리 범위, 알려진 제한.
b96f3b45 R2가 메모리 안 가상 저장소 목록은 이유와 함께 건너뛴다.
main이 받은 PR #15의 tests/unit/docs-system.test.ts가 문서 검사기 시험용 가상 저장소의 knownPaths(docs, docs/architecture, docs/architecture/layers.md, src, src/platform)를 배열로 적는다. main을 합치자 R2 검사가 이것을 루트 경로 목록으로 잡았다.
실제 루트 항목을 옮겨도 바뀌지 않는 목록이라 집합으로 고를 것이 아니다. R2 시험의 MADE_UP_REPOSITORY_LISTS에 파일·목록·이유를 적는다. 그 파일의 그 목록만 건너뛰고, 적힌 목록이 그 파일에서 없어지면 실패한다.
merge 앞에 두어 모든 커밋이 시험을 통과한다. 매뉴얼 03 E절 R2 칸과 CHANGELOG 15에도 적었다.
버린 것: 배열을 둘로 나누기(검사를 피하려고 코드 모양을 바꾸는 것이다), 가상 경로 이름 바꾸기(문서 검사기가 docs/ 경로를 규칙으로 본다).
f5344f21 main db6a6eb6(PR #15)을 합쳤다. CHANGELOG 정리 단계 절 머리의 범위 문장만 충돌했고 두 범위를 다 남겼다. force push 없이 맞추려고 rebase 대신 merge했다.
c28bf92c main 39d00b28(PR #17)을 합쳤다. 충돌이 없고 겹치는 파일도 없다.
그 밖에 .gitignore 주석 하나를 고쳤다. 주석이 a11y 기록을 아직 artifacts/ 아래라고 적었는데, 정리 3단계에서 docs/로 옮겼다.
위험과 영향
다운스트림:
자기 코드에 루트 목록이 있으면 R2 시험이 실패한다. 집합을 고르거나 새로 더한다. 메모리 안 가상 저장소의 목록이면 MADE_UP_REPOSITORY_LISTS에 적는다(CHANGELOG 15).
샘플을 목록에 둔 프로젝트는 R5가 넓어져 새로 걸릴 수 있다. 특히 지운 기능의 a11y 기록이 gates.json에 남은 경우다(CHANGELOG 16).
문서 시험만 읽는 집합을 새로 더하면 tests/unit/repository-layout.test.ts의 DOCUMENT_TEST_SETS에도 적어야 한다. 빠뜨리면 전체 checkout의 test:unit이 그 이름을 대며 실패한다.
두 제품에 적용해 보지 않았다.
시험이 못 보는 곳:
R2는 코드의 문자열 배열만 본다. 정규식 대안 목록, 객체 키, package.json script 인자, tsconfig include는 보지 않는다. 한 목록을 여러 배열로 나눠 펼쳐도 놓친다(5번의 변이에서 확인).
R5는 실행 때 정해지는 goto 대상(라우트 표 전체를 도는 a11y spec, 생성 기능 경로)은 따라가지 않는다. 그런 spec이 샘플 모듈을 import하면 import 경로로 잡힌다.
둘 다 CHANGELOG 알려진 제한에 적었다.
3번 수정은 desktop에서만 확인했다. runner에서는 FE-GATE-013이 여전히 이미지에 bwrap이 없어 실패한다(W2-FE 작업). desktop에서도 provider sandbox 시험 18개는 비특권 network namespace 제약으로 실패한다(docs/work/reference/gates.md 3절).
FE-GATE-013의 system 시험은 runner와 desktop 어디서도 끝까지 돌지 않는다. 그래서 3번 결함이 하네스 PR #13부터 보이지 않았다. 빠른 계층에서 이것을 잡는 시험은 더하지 않았다.
다른 세션 소관 파일 중 고친 줄: CHANGELOG.md, 매뉴얼 03 E절(이 작업의 규칙 절), .gitignore 주석 3줄, FE-GATE-013 시험의 fixture 복사 filter(3번).
검증
모두 desktop에서 돌렸다. workflow env(CI=true, 40자리 VITE_COMMIT_SHA, VITE_BUILD_ID, RELEASE_ID, CI_RUNNER_IMAGE digest)를 썼고, job마다 깨끗한 트리에서 설치를 한 번 하고 게이트를 차례로 corepack pnpm ci:gate <ID>로 돌렸다. 로그는 desktop /tmp/claude-gates/ 아래 fea-v8·fea-b1·fea-x1·fea-v9·fea-g1·fea-v10·fea-g2에 있다.
판정(docs/work/reference/gates.md 3절): merge 단계 중 FE-GATE-013 밖 전부 통과(f5344f21, fea-v10). FE-GATE-013은 desktop 호스트 제약 실패(뒤 명령 결과 첨부). merge 가능 여부는 소유자가 정한다(FE-GATE-013을 멈춤 기준에서 어떻게 셀지의 결정 대기, docs/work/reference/decisions.md 3.1절). 끝 head c28bf92c는 PR #17만 더 합친 것이라 FE-GATE-017·005와 R5·R2 시험만 다시 돌렸다(아래). 앞 head에서 FE-GATE-008·020이 가끔 떨어진 회차는 아래에 그대로 적었다.
커밋별
다섯 검사(test:unit, check:types, check:ci, lint, verify:documentation)가 끝 merge c28bf92c를 뺀 모든 커밋에서 rc=0이다.
FE-GATE-013 뒤 명령: verify:reproducible-build·build:release-candidate·verify:local-evidence·check:browser-security 모두 0. system 시험(tests/system)은 115개 중 18개 실패, 97개 통과다. 실패 18개는 모두 candidate archive and provider upload boundaries이고, 오류는 provider sandbox의 bwrap: loopback: Failed RTM_NEWADDR: Operation not permitted(비특권 network namespace 제약)와 그 때문에 provider 출력이 생기지 않은 것이다. .claude ENOENT는 0이다.
끝 head c28bf92c(main 39d00b28, PR #17을 합침, fea-g2)
PR #17이 바꾼 파일(.claude/, docs/work/, AGENTS.md, CLAUDE.md, scripts/tests/test_claude_setup.py)은 이 PR이 바꾼 파일과 겹치지 않고 충돌도 없다. 그래서 총괄 지시대로 문서·단위 시험과 이 PR의 구조 검사만 다시 돌렸다.
FE-GATE-020(414fc2aa, fea-v9): feature-scaffold drill 사본의 test:unit에서 tests/unit/documentation-readiness.test.ts 「passes the documents as they are」가 기본 timeout 10초를 넘겼다(10,633ms).
같은 시험은 다른 회차에서 447~1,156ms다.
이 시험은 자식 프로세스로 verify-documentation-readiness.ts를 띄우는데, suite가 자기 timeout을 선언하지 않는다(.claude/rules/tests.md 9). main부터 그렇다.
그 drill이 실패하자 뒤 capability drill 셋은 돌지 않았다. 같은 head를 다시 돌린 fea-g1(load 8)에서는 0이었고 다섯 drill 모두 실패 0이었다.
이 PR의 이 파일 변경은 목록을 같은 원소의 집합으로 바꾼 것뿐이다.
FE-GATE-008(3c9945d8, fea-v8 하나와 fea-b1 둘): 세 번 중 두 번 실패했다.
fea-v8: firefox accessibility.spec.ts:40와 app-shell.spec.ts:3이 30초 안에 h1을 못 찾았다(181 통과).
둘 다 firefox의 첫 페이지 로드가 시간을 넘긴 것이고, 그때 load는 15~22였다. W2-FE가 runner run 56(PR #13f98f39a3, 이 PR 이전 코드)에서 본 「가끔 떨어짐 B」와 증상이 같다. 이 PR은 앱 코드와 이 spec들을 바꾸지 않는다.
414fc2aa(fea-v9)와 f5344f21(fea-v10)에서는 0이었다.
3번 수정의 재현과 확인(fea-x1)
tests/system 전체를 같은 env로 main 38c0dc7d와 수정 커밋에서 돌렸다.
트리
실패
통과
건너뜀
.claude ENOENT 줄
main 38c0dc7d
18 (finalizer)
61
36
19
수정
18 (sandbox, 위 bwrap)
97
0
0
main에서 건너뛴 36개는 기준 fixture 빌드가 실패해 돌지 않은 시험이다. 수정 뒤 그중 18개는 통과했고, 18개는 호스트 제약으로 실패했다.
R2 검출력
이 브랜치의 tests/unit/repository-layout.test.ts(와 등록부, scripts/lib/repository-layout.ts)를 main 38c0dc7d의 코드 위에 올려 돌렸다.
R2 검사가 13파일의 목록 17개를 이름으로 대며 실패한다.
옮긴 19개 중 나머지 둘(supply-chain-fixture-skip의 두 곳)은 추적되는 루트 이름이 artifacts 하나뿐이라 검사 대상이 아니다. 같은 뜻의 목록이라 함께 옮겼다.
집합마다 고르는 코드가 있는지 보는 검사는 새 집합 12개를 대며 실패한다.
PR #15를 합치자 같은 검사가 tests/unit/docs-system.test.ts의 가상 저장소 목록을 잡았다(5번). merge 커밋에서 변이 셋을 넣었다.
예외를 지우면 그 목록을 대며 실패한다.
목록 내용을 바꾸면 바뀐 목록을 대며 실패한다.
목록이 파일에서 없어지면 낡은 예외로 실패한다.
처음 desktop 실행에서 고친 것
FE-GATE-020(옛 head): 문서를 복사하지 않는 제거 drill 셋의 사본에서 「has a reader for every set」이 실패했다. 사본이 지우는 문서 시험만 읽는 집합이 셋이었다.
봉인한 capability 사본에서 재현했다. 실패는 이 시험 하나였다.
DOCUMENT_TEST_SETS로 고친 뒤 전체 checkout·봉인한 capability 사본·feature-scaffold 사본에서 통과했다.
집합 하나의 읽는 곳을 지우면 전체 checkout과 capability 사본에서 실패한다.
고침은 R2 커밋에 합쳤다.
FE-GATE-013(fea-v8): 3번.
runner
run 117(c28bf92c, pull_request)이 runner 대기 중이다. 결과가 나오면 여기 적는다. 앞 head의 run 111(414fc2aa)도 대기 중이다.
리뷰어가 볼 곳
config/repository-layout.json, scripts/lib/repository-layout.ts, tests/unit/repository-layout.test.ts: 집합·종류 untracked·저장소 전체 R2 검사·MADE_UP_REPOSITORY_LISTS.
정리 3·4단계 PR #14, CI 재편 PR #16, 문서 체계 PR #15·분야 전문가 PR #17(main에서 합침)
## 무엇을, 왜
정리 4단계(PR #14)가 남긴 두 「일부」를 끝낸다. 프로그램의 「남은 발견 0」 기준 때문이다(design-docs `template-program/README.md`, `repo-structure/04-frontend-layout.md` 11절 R2·R5).
- **R2**: 루트 경로 목록 검사가 등록부를 쓰는 7곳만 봤다. 그 밖에 루트 이름을 담은 목록이 코드 15파일에 19개 따로 있었다. 사본이 건너뛰는 항목, `git grep` 경로, Playwright 설정, 문서 입력, tsconfig 묶음 같은 것들이다. 루트 항목 하나를 옮기면 여전히 여러 곳을 같이 고쳐야 했다.
- **R5**: 샘플이 게이트 대상인지 보는 검사가 문자열 검색이었다. 샘플의 기능 ID나 라우트 경로가 goto 문자열·증거 경로·규모 기록 본문에 들어 있는지만 봤다. 그래서 조립한 경로, 여러 줄 goto, origin을 붙인 template 문자열, 샘플 모듈을 import하는 spec은 놓쳤다.
- 그리고 이 PR의 desktop 실행에서 main부터 있던 결함 하나를 찾아 같이 고쳤다. FE-GATE-013의 provider fixture가 추적되는 `.claude/` 파일을 빠뜨려 system 시험 18개가 실패했다(3번). R2가 옮긴 목록 중 하나라서 여기서 고친다.
## 고른 방법과 버린 대안
커밋 다섯과 main을 합친 merge 커밋 둘이다. 끝 merge `c28bf92c`를 뺀 커밋마다 desktop에서 test:unit·check:types·check:ci·lint·verify:documentation을 돌렸다(아래 검증).
1. `3f64c689` R2.
- 등록부(`config/repository-layout.json`)에 집합 12개를 더했다. 집합마다 설명에 읽는 파일을 적었다.
| 집합 | 원소 | 읽는 곳 |
|---|---|---|
| `checkout-copy-skip` | node_modules .git .claude .generated .tmp dist artifacts graphify-out | e2e fixture 빌드 둘, `run-output-root-build` 시험 |
| `provider-fixture-skip` | .release artifacts dist node_modules .claude/worktrees .worktrees .tmp graphify-out | `ci-artifact-contract` 시스템 시험. 이 커밋에서는 `.claude`였고 3번 커밋이 고친다 |
| `supply-chain-fixture-skip` | .release artifacts dist node_modules | `check-supply-chain-provider-fixtures.ts`, `security-followup-archive` 시험 |
| `fixture-code` | scripts tests | `check-adapter-inventory.ts`의 `git grep` 둘, `fixture-node-modules` 시험 |
| `package-manifest` | package.json pnpm-lock.yaml pnpm-workspace.yaml | `fixture-node-modules` 시험 |
| `playwright-configs` | 기본·visual·storybook·capabilities 설정 | `check-test-evidence.ts`(forbidOnly) |
| `visual-evidence` | storybook·visual 설정, `tests/storybook/workshop.spec.ts` | `check-test-evidence.ts` |
| `documentation-inputs` | README.md docs `config/contracts/backend-contract-pin.json` | 문서 시험 둘 |
| `agent-harness` | AGENTS.md CLAUDE.md .claude `docs/work` | `template-contract-documents` 시험 |
| `feature-typecheck` / `product-typecheck` / `app-typecheck` | tsconfig 묶음 | 사본 타입 검사 시험 셋 |
`template-feature-removal-documents` 시험의 문서 목록은 이미 있던 `fixture-documents` 집합을 그대로 쓴다.
- 집합의 원소는 옮기기 전 목록과 같다. 그래서 동작은 바뀌지 않는다.
- 사본이 건너뛰는 `node_modules`·`dist`·`.tmp`처럼 추적하지 않는 항목은 새 종류 `untracked`(optional)로 적는다. 추적 파일이 있으면 시험이 실패한다.
- R2 시험이 추적되는 코드 파일 전체를 본다. 다음 배열이 있으면 실패한다:
- 원소가 모두 루트 항목이나 그 안 경로인 문자열 배열이고,
- 그중 추적되는 루트 이름이 둘 이상이다.
- 인자 목록은 `--` 뒤만 본다.
- 집합마다 `selectRepositoryPaths`·`selectRepositoryEntries`로 그것을 고르는 코드가 있는지도 본다.
- 문서를 복사하지 않는 제거 drill(FE-GATE-020의 기능 제거 셋)은 문서 시험(`REMOVAL_FIXTURE_DOCUMENT_TESTS`)을 지운다. 그런데 집합 셋(`agent-harness`·`documentation-inputs`·`feature-typecheck`)은 그 시험만 읽는다.
- 그래서 시험이 이 셋을 `DOCUMENT_TEST_SETS`로 적어 둔다. 문서 시험이 지워진 사본에서만 셋이 비어도 된다. 셋이 바뀌면 전체 checkout에서 실패한다.
- 첫 desktop 실행에서 FE-GATE-020이 이것으로 실패해 R2 커밋에 고침을 합쳤다(검증 참고).
- 파서는 등록부의 `kinds`·`sets` 설명이 코드의 목록과 같은지 본다.
- 버린 것:
- 목록마다 예외로 두기: 「남은 발견 0」이 안 된다.
- 루트 이름이 둘 이상인 배열을 모두 잡기: npm 하위 명령 목록(`docs`·`config` 포함)처럼 경로가 아닌 목록까지 걸린다.
- 추적 안 하는 항목도 루트 이름으로 세기: 하위 폴더 이름 목록(`realtime-boundaries.ts`의 `node_modules`·`dist` 건너뛰기)까지 걸린다.
2. `1f57c38e` R5. 게이트 대상마다 소유자를 따라간다.
- visual·e2e의 goto 경로 → 라우트 표(`ROUTE_REGISTRY`)의 라우트와 그 기능(`ROUTE_FEATURE_OWNER`). 선언된 경로가 없으면 catch-all.
- workshop story id → title이 그 id를 만드는 stories 파일.
- spec의 import → 불러오는 파일을 끝까지 따라간다. 생성기 출력 `src/.generated/`에서 멈춘다. 그곳의 기능 색인은 설치된 기능을 모두 import하고, 샘플을 지우면 다시 생성된다.
- `config/ci/gates.json`의 수동 a11y 기록 → 그 라우트. 라우트 표에 없으면 실패한다(지운 기능의 기록이 남은 경우).
- 게이트 명령 → package script 그래프(`reachablePackageScripts`)로 닿는 script, 경로 인자, `--feature` 인자.
- `config/scale/feature-shape-growth.json`의 `sourceFeature` → 기능.
- 시험 셋:
- 실제 저장소 결과가 비지 않는지(goto 대상 10개 넘음, `src/` 파일에 닿음, 라우트 기록 있음, script 20개 넘음).
- 플랫폼 화면·디자인 시스템·메시지 카탈로그가 샘플 것이었다면 실제 spec·게이트 중 무엇이 걸리는지.
- 합성 샘플로 여섯 경로가 각각 잡히는지.
- 버린 것: TypeScript AST로 import와 goto를 읽기. 이 repo의 TypeScript 7.0(네이티브판)은 JS API가 없다.
3. `ceaf21ea` provider fixture가 추적되는 `.claude` 파일도 복사한다.
- 이 PR의 첫 desktop 전체 실행에서 찾았다. FE-GATE-013의 `tests/system/ci-runner/ci-artifact-contract.test.ts`에서 finalizer 시험 18개가 `ENOENT … .claude/agents/arch-reviewer.md`로 실패했다.
- 원인: 기준 fixture가 checkout을 `.git`째 복사하면서 `.claude`를 통째로 건너뛴다. 하네스 PR #13 뒤로 `.claude/`에 추적 파일이 11개 있다. 공급망 생성(`scripts/lib/repository-file-inventory.ts`)이 추적 파일마다 lstat해서 후보 빌드가 멈춘다.
- main `38c0dc7d`에서도 같다. runner에서는 이 시험이 bwrap 없음으로 돌지 못해 드러나지 않았다.
- 고침: 다른 worktree가 있는 `.claude/worktrees`만 건너뛴다. 등록부가 `.claude` 항목의 `setPaths`로 그 경로를 고르고, 복사 filter는 경로 앞부분으로 비교한다.
- 버린 것: inventory가 `.claude`를 건너뛰게 하기(실제 후보 빌드의 inventory까지 추적 파일을 빠뜨린다), fixture의 git index에서 지우기(fixture가 실제 checkout과 달라진다).
4. `414fc2aa` 매뉴얼 03 E절 R1·R2·R5 검사 칸과 집합을 더하는 단계, CHANGELOG 「먼저 할 일」 15·16, 계약 표 한 줄, 3번의 수정 한 줄, 절 머리 범위, 알려진 제한.
5. `b96f3b45` R2가 메모리 안 가상 저장소 목록은 이유와 함께 건너뛴다.
- main이 받은 PR #15의 `tests/unit/docs-system.test.ts`가 문서 검사기 시험용 가상 저장소의 `knownPaths`(docs, docs/architecture, docs/architecture/layers.md, src, src/platform)를 배열로 적는다. main을 합치자 R2 검사가 이것을 루트 경로 목록으로 잡았다.
- 실제 루트 항목을 옮겨도 바뀌지 않는 목록이라 집합으로 고를 것이 아니다. R2 시험의 `MADE_UP_REPOSITORY_LISTS`에 파일·목록·이유를 적는다. 그 파일의 그 목록만 건너뛰고, 적힌 목록이 그 파일에서 없어지면 실패한다.
- merge 앞에 두어 모든 커밋이 시험을 통과한다. 매뉴얼 03 E절 R2 칸과 CHANGELOG 15에도 적었다.
- 버린 것: 배열을 둘로 나누기(검사를 피하려고 코드 모양을 바꾸는 것이다), 가상 경로 이름 바꾸기(문서 검사기가 `docs/` 경로를 규칙으로 본다).
6. `f5344f21` main `db6a6eb6`(PR #15)을 합쳤다. CHANGELOG 정리 단계 절 머리의 범위 문장만 충돌했고 두 범위를 다 남겼다. force push 없이 맞추려고 rebase 대신 merge했다.
7. `c28bf92c` main `39d00b28`(PR #17)을 합쳤다. 충돌이 없고 겹치는 파일도 없다.
그 밖에 `.gitignore` 주석 하나를 고쳤다. 주석이 a11y 기록을 아직 `artifacts/` 아래라고 적었는데, 정리 3단계에서 `docs/`로 옮겼다.
## 위험과 영향
- 다운스트림:
- 자기 코드에 루트 목록이 있으면 R2 시험이 실패한다. 집합을 고르거나 새로 더한다. 메모리 안 가상 저장소의 목록이면 `MADE_UP_REPOSITORY_LISTS`에 적는다(CHANGELOG 15).
- 샘플을 목록에 둔 프로젝트는 R5가 넓어져 새로 걸릴 수 있다. 특히 지운 기능의 a11y 기록이 gates.json에 남은 경우다(CHANGELOG 16).
- 문서 시험만 읽는 집합을 새로 더하면 `tests/unit/repository-layout.test.ts`의 `DOCUMENT_TEST_SETS`에도 적어야 한다. 빠뜨리면 전체 checkout의 test:unit이 그 이름을 대며 실패한다.
- 두 제품에 적용해 보지 않았다.
- 시험이 못 보는 곳:
- R2는 코드의 문자열 배열만 본다. 정규식 대안 목록, 객체 키, `package.json` script 인자, tsconfig `include`는 보지 않는다. 한 목록을 여러 배열로 나눠 펼쳐도 놓친다(5번의 변이에서 확인).
- R5는 실행 때 정해지는 goto 대상(라우트 표 전체를 도는 a11y spec, 생성 기능 경로)은 따라가지 않는다. 그런 spec이 샘플 모듈을 import하면 import 경로로 잡힌다.
- 둘 다 CHANGELOG 알려진 제한에 적었다.
- 3번 수정은 desktop에서만 확인했다. runner에서는 FE-GATE-013이 여전히 이미지에 bwrap이 없어 실패한다(W2-FE 작업). desktop에서도 provider sandbox 시험 18개는 비특권 network namespace 제약으로 실패한다(`docs/work/reference/gates.md` 3절).
- FE-GATE-013의 system 시험은 runner와 desktop 어디서도 끝까지 돌지 않는다. 그래서 3번 결함이 하네스 PR #13부터 보이지 않았다. 빠른 계층에서 이것을 잡는 시험은 더하지 않았다.
- 다른 세션 소관 파일 중 고친 줄: `CHANGELOG.md`, 매뉴얼 03 E절(이 작업의 규칙 절), `.gitignore` 주석 3줄, FE-GATE-013 시험의 fixture 복사 filter(3번).
## 검증
모두 desktop에서 돌렸다. workflow env(`CI=true`, 40자리 `VITE_COMMIT_SHA`, `VITE_BUILD_ID`, `RELEASE_ID`, `CI_RUNNER_IMAGE` digest)를 썼고, job마다 깨끗한 트리에서 설치를 한 번 하고 게이트를 차례로 `corepack pnpm ci:gate <ID>`로 돌렸다. 로그는 desktop `/tmp/claude-gates/` 아래 `fea-v8`·`fea-b1`·`fea-x1`·`fea-v9`·`fea-g1`·`fea-v10`·`fea-g2`에 있다.
**판정**(`docs/work/reference/gates.md` 3절): merge 단계 중 FE-GATE-013 밖 전부 통과(`f5344f21`, fea-v10). FE-GATE-013은 desktop 호스트 제약 실패(뒤 명령 결과 첨부). merge 가능 여부는 소유자가 정한다(FE-GATE-013을 멈춤 기준에서 어떻게 셀지의 결정 대기, `docs/work/reference/decisions.md` 3.1절). 끝 head `c28bf92c`는 PR #17만 더 합친 것이라 FE-GATE-017·005와 R5·R2 시험만 다시 돌렸다(아래). 앞 head에서 FE-GATE-008·020이 가끔 떨어진 회차는 아래에 그대로 적었다.
### 커밋별
다섯 검사(test:unit, check:types, check:ci, lint, verify:documentation)가 끝 merge `c28bf92c`를 뺀 모든 커밋에서 rc=0이다.
| 커밋 | test:unit | check:types | check:ci | lint | verify:documentation | 실행 |
|---|---|---|---|---|---|---|
| `3f64c689` | 0 (68s) | 0 | 0 | 0 | 0 | fea-v8 |
| `1f57c38e` | 0 (62s) | 0 | 0 | 0 | 0 | fea-v8 |
| `ceaf21ea` | 0 (38s) | 0 | 0 | 0 | 0 | fea-v9 |
| `414fc2aa` | 0 (39s) | 0 | 0 | 0 | 0 | fea-v9 |
| `b96f3b45` | 0 (50s) | 0 | 0 | 0 | 0 | fea-v10 |
| `f5344f21` (merge #15) | 0 (50s) | 0 | 0 | 0 | 0 | fea-v10 |
### 게이트 — `f5344f21`(fea-v10, 2026-11-12 07:03~07:33)
| job | 게이트 | 결과 |
|---|---|---|
| merge_static | 001 · 002 · 003 · 010 · 011 · 012 | 모두 0 (2s · 19s · 11s · 67s · 9s · 8s) |
| merge_test | 004 · 005 · 006 · 007 | 모두 0 (2s · 179s · 13s · 29s) |
| merge_test | 013 | 1 (4s, 사전 점검이 desktop 호스트 제약을 대며 멈춤). 뒤 명령은 아래 |
| merge_test | 020 | 0 (1,067s). 제거 drill 다섯 실패 0: browser-file-storage 7, feature-scaffold 38, optional-recipe 6, realtime 7, sample-removal 목록 비어 SKIP |
| merge_browser | 008 · 009 | 0 (219s, e2e 183 통과·4 건너뜀, browser-capabilities 69 통과) · 0 (28s) |
| main_gate | 029 | 0 (30s) |
| — | 017 | 0 (2s) |
FE-GATE-013 뒤 명령: `verify:reproducible-build`·`build:release-candidate`·`verify:local-evidence`·`check:browser-security` 모두 0. system 시험(`tests/system`)은 115개 중 18개 실패, 97개 통과다. 실패 18개는 모두 `candidate archive and provider upload boundaries`이고, 오류는 provider sandbox의 `bwrap: loopback: Failed RTM_NEWADDR: Operation not permitted`(비특권 network namespace 제약)와 그 때문에 provider 출력이 생기지 않은 것이다. `.claude` ENOENT는 0이다.
### 끝 head `c28bf92c`(main `39d00b28`, PR #17을 합침, fea-g2)
PR #17이 바꾼 파일(`.claude/`, `docs/work/`, `AGENTS.md`, `CLAUDE.md`, `scripts/tests/test_claude_setup.py`)은 이 PR이 바꾼 파일과 겹치지 않고 충돌도 없다. 그래서 총괄 지시대로 문서·단위 시험과 이 PR의 구조 검사만 다시 돌렸다.
| 검사 | 결과 |
|---|---|
| FE-GATE-017 | 0 (2s) |
| FE-GATE-005 | 0 (156s). test:unit 218파일 3,157개 통과 |
| R5·R2 시험(`tests/unit/example-feature-rules.test.ts`, `tests/unit/repository-layout.test.ts`) | 0, 15개 통과 |
### 가끔 떨어진 실패 — 앞 head, 이 PR이 바꾸지 않는 코드
- **FE-GATE-020**(`414fc2aa`, fea-v9): feature-scaffold drill 사본의 test:unit에서 `tests/unit/documentation-readiness.test.ts` 「passes the documents as they are」가 기본 timeout 10초를 넘겼다(10,633ms).
- 같은 시험은 다른 회차에서 447~1,156ms다.
- 이 시험은 자식 프로세스로 `verify-documentation-readiness.ts`를 띄우는데, suite가 자기 timeout을 선언하지 않는다(`.claude/rules/tests.md` 9). main부터 그렇다.
- 그 drill이 실패하자 뒤 capability drill 셋은 돌지 않았다. 같은 head를 다시 돌린 fea-g1(load 8)에서는 0이었고 다섯 drill 모두 실패 0이었다.
- 이 PR의 이 파일 변경은 목록을 같은 원소의 집합으로 바꾼 것뿐이다.
- **FE-GATE-008**(`3c9945d8`, fea-v8 하나와 fea-b1 둘): 세 번 중 두 번 실패했다.
- fea-v8: firefox `accessibility.spec.ts:40`와 `app-shell.spec.ts:3`이 30초 안에 h1을 못 찾았다(181 통과).
- fea-b1 1회차: firefox `browser-capabilities/browser-files.spec.ts:14`의 `page.goto("/")`가 30초를 넘겼다. 2회차는 통과했다.
- 둘 다 firefox의 첫 페이지 로드가 시간을 넘긴 것이고, 그때 load는 15~22였다. W2-FE가 runner run 56(PR #13 `f98f39a3`, 이 PR 이전 코드)에서 본 「가끔 떨어짐 B」와 증상이 같다. 이 PR은 앱 코드와 이 spec들을 바꾸지 않는다.
- `414fc2aa`(fea-v9)와 `f5344f21`(fea-v10)에서는 0이었다.
### 3번 수정의 재현과 확인(fea-x1)
`tests/system` 전체를 같은 env로 main `38c0dc7d`와 수정 커밋에서 돌렸다.
| 트리 | 실패 | 통과 | 건너뜀 | `.claude` ENOENT 줄 |
|---|---|---|---|---|
| main `38c0dc7d` | 18 (finalizer) | 61 | 36 | 19 |
| 수정 | 18 (sandbox, 위 bwrap) | 97 | 0 | 0 |
main에서 건너뛴 36개는 기준 fixture 빌드가 실패해 돌지 않은 시험이다. 수정 뒤 그중 18개는 통과했고, 18개는 호스트 제약으로 실패했다.
### R2 검출력
- 이 브랜치의 `tests/unit/repository-layout.test.ts`(와 등록부, `scripts/lib/repository-layout.ts`)를 main `38c0dc7d`의 코드 위에 올려 돌렸다.
- R2 검사가 13파일의 목록 17개를 이름으로 대며 실패한다.
- 옮긴 19개 중 나머지 둘(`supply-chain-fixture-skip`의 두 곳)은 추적되는 루트 이름이 `artifacts` 하나뿐이라 검사 대상이 아니다. 같은 뜻의 목록이라 함께 옮겼다.
- 집합마다 고르는 코드가 있는지 보는 검사는 새 집합 12개를 대며 실패한다.
- PR #15를 합치자 같은 검사가 `tests/unit/docs-system.test.ts`의 가상 저장소 목록을 잡았다(5번). merge 커밋에서 변이 셋을 넣었다.
- 예외를 지우면 그 목록을 대며 실패한다.
- 목록 내용을 바꾸면 바뀐 목록을 대며 실패한다.
- 목록이 파일에서 없어지면 낡은 예외로 실패한다.
### 처음 desktop 실행에서 고친 것
- **FE-GATE-020**(옛 head): 문서를 복사하지 않는 제거 drill 셋의 사본에서 「has a reader for every set」이 실패했다. 사본이 지우는 문서 시험만 읽는 집합이 셋이었다.
- 봉인한 capability 사본에서 재현했다. 실패는 이 시험 하나였다.
- `DOCUMENT_TEST_SETS`로 고친 뒤 전체 checkout·봉인한 capability 사본·feature-scaffold 사본에서 통과했다.
- 집합 하나의 읽는 곳을 지우면 전체 checkout과 capability 사본에서 실패한다.
- 고침은 R2 커밋에 합쳤다.
- **FE-GATE-013**(fea-v8): 3번.
### runner
run 117(`c28bf92c`, pull_request)이 runner 대기 중이다. 결과가 나오면 여기 적는다. 앞 head의 run 111(`414fc2aa`)도 대기 중이다.
## 리뷰어가 볼 곳
- `config/repository-layout.json`, `scripts/lib/repository-layout.ts`, `tests/unit/repository-layout.test.ts`: 집합·종류 `untracked`·저장소 전체 R2 검사·`MADE_UP_REPOSITORY_LISTS`.
- `tests/unit/example-feature-rules.test.ts`: R5의 소유자 따라가기(`resolveRoute`, `reachableFiles`, `sampleGateTargets`).
- `tests/system/ci-runner/ci-artifact-contract.test.ts`의 `ensureProviderBaseFixture` filter와 등록부 `.claude` 항목의 `setPaths`(3번).
- 기계적으로 바꾼 것: 19개 목록을 `selectRepositoryPaths(<집합>)`으로 바꿨다. 기준 `38c0dc7d`.
- 옛 목록 찾기: 시험의 R2 검사와 같은 정규식을 main 트리에 돌렸다.
- 원소 비교: 등록부 집합과 옛 목록이 원소 단위로 같은지 비교했다.
## 관련
- design-docs `repo-structure/04-frontend-layout.md` 2.4·11절, `template-program/README.md`
- 정리 3·4단계 PR #14, CI 재편 PR #16, 문서 체계 PR #15·분야 전문가 PR #17(main에서 합침)
정리 4단계의 R2 검사는 등록부를 쓰는 7곳만 봤다. 그 밖에 루트 이름을
담은 목록이 코드 15파일에 19개 따로 있어, 루트 항목 하나를 옮기면
여전히 여러 곳을 같이 고쳐야 했다.
- 등록부에 집합 12개를 더했다. 사본 복사에서 건너뛰는 항목 셋
(checkout·provider·공급망 fixture), fixture 코드 범위, pnpm 매니페스트,
Playwright 설정, visual 증거, 문서 입력, 에이전트 하네스, tsconfig
묶음 셋. 각 집합 설명에 읽는 파일을 적었다.
- 사본이 건너뛰는 node_modules·dist·.tmp 같은 추적 안 하는 항목은
종류 untracked(optional)로 적는다. 추적 파일이 있으면 시험이 실패한다.
- 19개 목록이 모두 집합을 고른다. 집합의 원소는 전과 같아 동작은
바뀌지 않는다.
- R2 시험이 추적되는 코드 파일 전체를 본다. 루트 항목(이나 그 안
경로)만 담은 문자열 배열에 추적되는 루트 이름이 둘 이상이면 실패.
인자 목록은 `--` 뒤만 본다. main의 옛 목록 18개를 이 검사가 잡는
것을 확인했다.
- 집합마다 selectRepositoryPaths·selectRepositoryEntries로 고르는 코드가
있는지 본다. 문서를 복사하지 않는 제거 drill(FE-GATE-020)은 문서
시험(REMOVAL_FIXTURE_DOCUMENT_TESTS)을 지우는데, 집합 셋
(agent-harness·documentation-inputs·feature-typecheck)은 그 시험만
읽는다. 시험이 이 셋을 적어 두고, 문서 시험이 지워진 사본에서만 셋이
비는 것을 허용한다. 셋이 바뀌면 전체 checkout에서 실패한다.
- 파서가 kinds·sets 설명과 코드의 목록이 같은지 본다.
- .gitignore 주석이 a11y 기록을 아직 artifacts/ 아래라고 적던 것을
고쳤다(정리 3단계에서 docs/로 옮김).
검증(desktop): test:unit, check:types, check:ci, lint, verify:documentation.
repository-layout 시험을 문서 없는 제거 사본과 feature-scaffold 사본에서도
돌렸고, 집합 하나의 읽는 곳을 지우면 두 곳 모두 실패한다.
R5 검사는 샘플의 기능 ID와 라우트 경로가 goto 문자열, 증거 경로,
규모 기록 본문에 들어 있는지 찾았다. 조립한 경로, 여러 줄 goto,
origin을 붙인 template 문자열, import로 샘플을 쓰는 spec은 놓쳤다.
이제 대상마다 소유자를 따라간다.
- visual·e2e goto 경로 → 라우트 표(ROUTE_REGISTRY)의 라우트와 기능.
선언된 경로가 없으면 catch-all.
- workshop story id → title이 그 id를 만드는 stories 파일.
- spec의 import → 불러오는 파일을 끝까지. src/.generated/에서 멈춘다.
- gates.json의 라우트 기록 → 라우트. 라우트 표에 없으면 실패.
- 게이트 명령 → package script 그래프로 닿는 script, 경로 인자,
--feature 인자.
- config/scale/feature-shape-growth.json의 sourceFeature → 기능.
실제 저장소로 돈 결과가 비지 않는지, 샘플이 플랫폼 화면·디자인
시스템·메시지 카탈로그를 소유했다면 실제 spec·게이트에서 무엇이
걸리는지, 합성 샘플로 각 경로가 잡히는지를 시험한다.
검증(desktop): test:unit, check:types, check:ci, lint, verify:documentation.
FE-GATE-013의 system 시험 tests/system/ci-runner/ci-artifact-contract.test.ts
에서 verified promotion finalizer 시험 18개가 desktop에서 실패한다. 오류는
`ENOENT … .claude/agents/arch-reviewer.md`다. 기준 fixture는 checkout을
.git째 복사하면서 .claude를 통째로 건너뛴다. 하네스 PR #13 뒤로 .claude/에
추적 파일이 11개 있다. 공급망 생성(scripts/lib/repository-file-inventory.ts)
은 추적 파일마다 lstat하므로, 빠진 파일에서 후보 빌드가 멈춘다. main
38c0dc7d에서도 같다. runner에서는 이 시험이 bwrap 없음으로 돌지 못해 드러나지
않았다.
.claude 대신 다른 worktree가 들어 있는 .claude/worktrees만 건너뛴다.
- 등록부의 provider-fixture-skip 집합은 .claude 항목의 setPaths로 그 경로를
고른다.
- 복사 filter는 첫 경로 조각이 아니라 경로 앞부분으로 비교한다.
버린 것:
- inventory가 .claude를 건너뛰게 하기: 실제 후보 빌드의 inventory까지 추적
파일을 빠뜨린다.
- fixture의 git index에서 .claude 파일을 지우기: fixture가 실제 checkout과
달라진다.
위험: runner에서는 FE-GATE-013이 여전히 bwrap 없음으로 실패해, 이 수정은
desktop에서만 확인된다. 사본에 .claude/ 11파일이 더 들어간다.
검증(desktop): 이 시험 파일 전체를 main 38c0dc7d와 이 커밋에서 돌렸다.
- main: 18개 ENOENT 실패, 36개 건너뜀(기준 fixture 빌드 실패).
- 이 커밋: finalizer 18개 통과, ENOENT 0. 남은 18개 실패는 모두
provider sandbox의 `bwrap: loopback: Failed RTM_NEWADDR`(desktop 비특권
network namespace 제약)다.
- test:unit, check:types, check:ci, lint, verify:documentation.
매뉴얼 03 E절의 R1(종류 untracked), R2(저장소 전체 코드, 인자 목록은
`--` 뒤, 집합마다 읽는 코드), R5(소유자를 따라가는 대상 여섯 가지)
검사 칸과, 새 목록이 필요할 때 집합을 더하는 단계를 고쳤다.
CHANGELOG 정리 단계 절에 먼저 할 일 15·16과 계약 표 한 줄을 더했다.
그 밖의 수정에 provider fixture의 .claude 수정 한 줄을 더했다. 절 머리의
범위에 이 브랜치를 넣었다. 알려진 제한의 R2·R5 두 줄은 해결로 표시하고
새 검사가 못 보는 곳을 적었다. runner 줄은 PR #16 실행 #5 결과로 고쳤다.
검증(desktop): verify:documentation, test:unit, merge 단계 job 셋과
main_gate, FE-GATE-017.
donghyeon.kang
changed title from Chore/layout rules r2 r5 to chore(layout): R2·R5 검사를 저장소 전체와 소유자 기준으로 마무리한다2026-11-11 22:01:04 +00:00
main이 받은 PR #15의 tests/unit/docs-system.test.ts는 문서 검사기 시험을
위해 메모리 안에 가상 저장소를 만든다. 그 knownPaths 배열(docs,
docs/architecture, docs/architecture/layers.md, src, src/platform)을 R2
검사가 루트 경로 목록으로 잡아, main을 이 브랜치에 합치면 test:unit이
실패한다. 이 목록은 실제 루트 항목을 옮겨도 바뀌지 않으니 등록부 집합으로
고를 것이 아니다.
R2 시험에 MADE_UP_REPOSITORY_LISTS를 두고 파일·목록·이유를 적는다.
- 그 파일의 그 목록만 건너뛰고, 같은 파일의 다른 목록은 그대로 본다.
- 적힌 목록이 그 파일에 더 없으면 실패한다. 그래서 낡은 예외가 뒤에 새
목록을 덮지 못한다. 제거 drill 사본처럼 그 파일이 검사 대상에 없으면
보지 않는다.
- 이 커밋에는 아직 그 파일이 없다. 다음 merge 커밋이 main을 합쳐도 모든
커밋이 시험을 통과하도록 merge 앞에 둔다.
매뉴얼 03 E절 R2 칸과 CHANGELOG 먼저 할 일 15에 이 예외를 적는다.
버린 것:
- docs-system 시험의 배열을 둘로 나누기: 검사를 피하려고 코드 모양을
바꾸는 것이다.
- 가상 경로를 다른 이름으로 바꾸기: 문서 검사기가 docs/ 경로를 규칙으로
보므로 시험의 뜻이 바뀐다.
- 집합을 고르게 하기: 가상 저장소가 실제 저장소 배치에 묶인다.
위험: 다운스트림이 같은 꼴의 fixture를 두면 이 목록에 적어야 한다.
검증(desktop): 이 커밋과 다음 merge 커밋에서 test:unit, check:types,
check:ci, lint, verify:documentation. merge 커밋에서 변이 셋을 넣었다. 예외를
지우면 R2 시험이 docs-system 목록을 대며 실패한다. 목록 내용을 바꾸면
바뀐 목록을 대며 실패한다. 목록이 파일에서 없어지면 낡은 예외로 실패한다.
main이 PR #15(문서 체계)를 받아 db6a6eb6이 됐다. CHANGELOG 정리 단계
절 머리의 범위 문장이 충돌했고, 문서 체계 단계와 이 브랜치의 범위를 둘
다 남겼다. 나머지 파일은 자동으로 합쳐졌다. PR #15가 더한
tests/unit/docs-system.test.ts의 가상 저장소 목록은 앞 커밋
R2 예외로 적었다.
main이 PR #17(분야 전문가 스킬)을 받아 39d00b28이 됐다. 충돌은 없고, #17이 바꾼 파일(.claude/, docs/work/, AGENTS.md, CLAUDE.md, scripts/tests/test_claude_setup.py)은 이 브랜치가 바꾼 파일과 겹치지 않는다.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
무엇을, 왜
정리 4단계(PR #14)가 남긴 두 「일부」를 끝낸다. 프로그램의 「남은 발견 0」 기준 때문이다(design-docs
template-program/README.md,repo-structure/04-frontend-layout.md11절 R2·R5).git grep경로, Playwright 설정, 문서 입력, tsconfig 묶음 같은 것들이다. 루트 항목 하나를 옮기면 여전히 여러 곳을 같이 고쳐야 했다..claude/파일을 빠뜨려 system 시험 18개가 실패했다(3번). R2가 옮긴 목록 중 하나라서 여기서 고친다.고른 방법과 버린 대안
커밋 다섯과 main을 합친 merge 커밋 둘이다. 끝 merge
c28bf92c를 뺀 커밋마다 desktop에서 test:unit·check:types·check:ci·lint·verify:documentation을 돌렸다(아래 검증).3f64c689R2.등록부(
config/repository-layout.json)에 집합 12개를 더했다. 집합마다 설명에 읽는 파일을 적었다.checkout-copy-skiprun-output-root-build시험provider-fixture-skipci-artifact-contract시스템 시험. 이 커밋에서는.claude였고 3번 커밋이 고친다supply-chain-fixture-skipcheck-supply-chain-provider-fixtures.ts,security-followup-archive시험fixture-codecheck-adapter-inventory.ts의git grep둘,fixture-node-modules시험package-manifestfixture-node-modules시험playwright-configscheck-test-evidence.ts(forbidOnly)visual-evidencetests/storybook/workshop.spec.tscheck-test-evidence.tsdocumentation-inputsconfig/contracts/backend-contract-pin.jsonagent-harnessdocs/worktemplate-contract-documents시험feature-typecheck/product-typecheck/app-typechecktemplate-feature-removal-documents시험의 문서 목록은 이미 있던fixture-documents집합을 그대로 쓴다.집합의 원소는 옮기기 전 목록과 같다. 그래서 동작은 바뀌지 않는다.
사본이 건너뛰는
node_modules·dist·.tmp처럼 추적하지 않는 항목은 새 종류untracked(optional)로 적는다. 추적 파일이 있으면 시험이 실패한다.R2 시험이 추적되는 코드 파일 전체를 본다. 다음 배열이 있으면 실패한다:
--뒤만 본다.집합마다
selectRepositoryPaths·selectRepositoryEntries로 그것을 고르는 코드가 있는지도 본다.REMOVAL_FIXTURE_DOCUMENT_TESTS)을 지운다. 그런데 집합 셋(agent-harness·documentation-inputs·feature-typecheck)은 그 시험만 읽는다.DOCUMENT_TEST_SETS로 적어 둔다. 문서 시험이 지워진 사본에서만 셋이 비어도 된다. 셋이 바뀌면 전체 checkout에서 실패한다.파서는 등록부의
kinds·sets설명이 코드의 목록과 같은지 본다.버린 것:
docs·config포함)처럼 경로가 아닌 목록까지 걸린다.realtime-boundaries.ts의node_modules·dist건너뛰기)까지 걸린다.1f57c38eR5. 게이트 대상마다 소유자를 따라간다.ROUTE_REGISTRY)의 라우트와 그 기능(ROUTE_FEATURE_OWNER). 선언된 경로가 없으면 catch-all.src/.generated/에서 멈춘다. 그곳의 기능 색인은 설치된 기능을 모두 import하고, 샘플을 지우면 다시 생성된다.config/ci/gates.json의 수동 a11y 기록 → 그 라우트. 라우트 표에 없으면 실패한다(지운 기능의 기록이 남은 경우).reachablePackageScripts)로 닿는 script, 경로 인자,--feature인자.config/scale/feature-shape-growth.json의sourceFeature→ 기능.src/파일에 닿음, 라우트 기록 있음, script 20개 넘음).ceaf21eaprovider fixture가 추적되는.claude파일도 복사한다.tests/system/ci-runner/ci-artifact-contract.test.ts에서 finalizer 시험 18개가ENOENT … .claude/agents/arch-reviewer.md로 실패했다..git째 복사하면서.claude를 통째로 건너뛴다. 하네스 PR #13 뒤로.claude/에 추적 파일이 11개 있다. 공급망 생성(scripts/lib/repository-file-inventory.ts)이 추적 파일마다 lstat해서 후보 빌드가 멈춘다.38c0dc7d에서도 같다. runner에서는 이 시험이 bwrap 없음으로 돌지 못해 드러나지 않았다..claude/worktrees만 건너뛴다. 등록부가.claude항목의setPaths로 그 경로를 고르고, 복사 filter는 경로 앞부분으로 비교한다..claude를 건너뛰게 하기(실제 후보 빌드의 inventory까지 추적 파일을 빠뜨린다), fixture의 git index에서 지우기(fixture가 실제 checkout과 달라진다).414fc2aa매뉴얼 03 E절 R1·R2·R5 검사 칸과 집합을 더하는 단계, CHANGELOG 「먼저 할 일」 15·16, 계약 표 한 줄, 3번의 수정 한 줄, 절 머리 범위, 알려진 제한.b96f3b45R2가 메모리 안 가상 저장소 목록은 이유와 함께 건너뛴다.tests/unit/docs-system.test.ts가 문서 검사기 시험용 가상 저장소의knownPaths(docs, docs/architecture, docs/architecture/layers.md, src, src/platform)를 배열로 적는다. main을 합치자 R2 검사가 이것을 루트 경로 목록으로 잡았다.MADE_UP_REPOSITORY_LISTS에 파일·목록·이유를 적는다. 그 파일의 그 목록만 건너뛰고, 적힌 목록이 그 파일에서 없어지면 실패한다.docs/경로를 규칙으로 본다).f5344f21maindb6a6eb6(PR #15)을 합쳤다. CHANGELOG 정리 단계 절 머리의 범위 문장만 충돌했고 두 범위를 다 남겼다. force push 없이 맞추려고 rebase 대신 merge했다.c28bf92cmain39d00b28(PR #17)을 합쳤다. 충돌이 없고 겹치는 파일도 없다.그 밖에
.gitignore주석 하나를 고쳤다. 주석이 a11y 기록을 아직artifacts/아래라고 적었는데, 정리 3단계에서docs/로 옮겼다.위험과 영향
MADE_UP_REPOSITORY_LISTS에 적는다(CHANGELOG 15).tests/unit/repository-layout.test.ts의DOCUMENT_TEST_SETS에도 적어야 한다. 빠뜨리면 전체 checkout의 test:unit이 그 이름을 대며 실패한다.package.jsonscript 인자, tsconfiginclude는 보지 않는다. 한 목록을 여러 배열로 나눠 펼쳐도 놓친다(5번의 변이에서 확인).docs/work/reference/gates.md3절).CHANGELOG.md, 매뉴얼 03 E절(이 작업의 규칙 절),.gitignore주석 3줄, FE-GATE-013 시험의 fixture 복사 filter(3번).검증
모두 desktop에서 돌렸다. workflow env(
CI=true, 40자리VITE_COMMIT_SHA,VITE_BUILD_ID,RELEASE_ID,CI_RUNNER_IMAGEdigest)를 썼고, job마다 깨끗한 트리에서 설치를 한 번 하고 게이트를 차례로corepack pnpm ci:gate <ID>로 돌렸다. 로그는 desktop/tmp/claude-gates/아래fea-v8·fea-b1·fea-x1·fea-v9·fea-g1·fea-v10·fea-g2에 있다.판정(
docs/work/reference/gates.md3절): merge 단계 중 FE-GATE-013 밖 전부 통과(f5344f21, fea-v10). FE-GATE-013은 desktop 호스트 제약 실패(뒤 명령 결과 첨부). merge 가능 여부는 소유자가 정한다(FE-GATE-013을 멈춤 기준에서 어떻게 셀지의 결정 대기,docs/work/reference/decisions.md3.1절). 끝 headc28bf92c는 PR #17만 더 합친 것이라 FE-GATE-017·005와 R5·R2 시험만 다시 돌렸다(아래). 앞 head에서 FE-GATE-008·020이 가끔 떨어진 회차는 아래에 그대로 적었다.커밋별
다섯 검사(test:unit, check:types, check:ci, lint, verify:documentation)가 끝 merge
c28bf92c를 뺀 모든 커밋에서 rc=0이다.3f64c6891f57c38eceaf21ea414fc2aab96f3b45f5344f21(merge #15)게이트 —
f5344f21(fea-v10, 2026-11-12 07:03~07:33)FE-GATE-013 뒤 명령:
verify:reproducible-build·build:release-candidate·verify:local-evidence·check:browser-security모두 0. system 시험(tests/system)은 115개 중 18개 실패, 97개 통과다. 실패 18개는 모두candidate archive and provider upload boundaries이고, 오류는 provider sandbox의bwrap: loopback: Failed RTM_NEWADDR: Operation not permitted(비특권 network namespace 제약)와 그 때문에 provider 출력이 생기지 않은 것이다..claudeENOENT는 0이다.끝 head
c28bf92c(main39d00b28, PR #17을 합침, fea-g2)PR #17이 바꾼 파일(
.claude/,docs/work/,AGENTS.md,CLAUDE.md,scripts/tests/test_claude_setup.py)은 이 PR이 바꾼 파일과 겹치지 않고 충돌도 없다. 그래서 총괄 지시대로 문서·단위 시험과 이 PR의 구조 검사만 다시 돌렸다.tests/unit/example-feature-rules.test.ts,tests/unit/repository-layout.test.ts)가끔 떨어진 실패 — 앞 head, 이 PR이 바꾸지 않는 코드
414fc2aa, fea-v9): feature-scaffold drill 사본의 test:unit에서tests/unit/documentation-readiness.test.ts「passes the documents as they are」가 기본 timeout 10초를 넘겼다(10,633ms).verify-documentation-readiness.ts를 띄우는데, suite가 자기 timeout을 선언하지 않는다(.claude/rules/tests.md9). main부터 그렇다.3c9945d8, fea-v8 하나와 fea-b1 둘): 세 번 중 두 번 실패했다.accessibility.spec.ts:40와app-shell.spec.ts:3이 30초 안에 h1을 못 찾았다(181 통과).browser-capabilities/browser-files.spec.ts:14의page.goto("/")가 30초를 넘겼다. 2회차는 통과했다.f98f39a3, 이 PR 이전 코드)에서 본 「가끔 떨어짐 B」와 증상이 같다. 이 PR은 앱 코드와 이 spec들을 바꾸지 않는다.414fc2aa(fea-v9)와f5344f21(fea-v10)에서는 0이었다.3번 수정의 재현과 확인(fea-x1)
tests/system전체를 같은 env로 main38c0dc7d와 수정 커밋에서 돌렸다..claudeENOENT 줄38c0dc7dmain에서 건너뛴 36개는 기준 fixture 빌드가 실패해 돌지 않은 시험이다. 수정 뒤 그중 18개는 통과했고, 18개는 호스트 제약으로 실패했다.
R2 검출력
tests/unit/repository-layout.test.ts(와 등록부,scripts/lib/repository-layout.ts)를 main38c0dc7d의 코드 위에 올려 돌렸다.supply-chain-fixture-skip의 두 곳)은 추적되는 루트 이름이artifacts하나뿐이라 검사 대상이 아니다. 같은 뜻의 목록이라 함께 옮겼다.tests/unit/docs-system.test.ts의 가상 저장소 목록을 잡았다(5번). merge 커밋에서 변이 셋을 넣었다.처음 desktop 실행에서 고친 것
DOCUMENT_TEST_SETS로 고친 뒤 전체 checkout·봉인한 capability 사본·feature-scaffold 사본에서 통과했다.runner
run 117(
c28bf92c, pull_request)이 runner 대기 중이다. 결과가 나오면 여기 적는다. 앞 head의 run 111(414fc2aa)도 대기 중이다.리뷰어가 볼 곳
config/repository-layout.json,scripts/lib/repository-layout.ts,tests/unit/repository-layout.test.ts: 집합·종류untracked·저장소 전체 R2 검사·MADE_UP_REPOSITORY_LISTS.tests/unit/example-feature-rules.test.ts: R5의 소유자 따라가기(resolveRoute,reachableFiles,sampleGateTargets).tests/system/ci-runner/ci-artifact-contract.test.ts의ensureProviderBaseFixturefilter와 등록부.claude항목의setPaths(3번).selectRepositoryPaths(<집합>)으로 바꿨다. 기준38c0dc7d.관련
repo-structure/04-frontend-layout.md2.4·11절,template-program/README.mdChore/layout rules r2 r5to chore(layout): R2·R5 검사를 저장소 전체와 소유자 기준으로 마무리한다