main이 PR #17(분야 전문가 스킬)을 받아 39d00b28이 됐다. 충돌은 없고, #17이 바꾼 파일(.claude/, docs/work/, AGENTS.md, CLAUDE.md, scripts/tests/test_claude_setup.py)은 이 브랜치가 바꾼 파일과 겹치지 않는다.
main이 PR #15(문서 체계)를 받아 db6a6eb6이 됐다. CHANGELOG 정리 단계
절 머리의 범위 문장이 충돌했고, 문서 체계 단계와 이 브랜치의 범위를 둘
다 남겼다. 나머지 파일은 자동으로 합쳐졌다. PR #15가 더한
tests/unit/docs-system.test.ts의 가상 저장소 목록은 앞 커밋
R2 예외로 적었다.
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 목록을 대며 실패한다. 목록 내용을 바꾸면
바뀐 목록을 대며 실패한다. 목록이 파일에서 없어지면 낡은 예외로 실패한다.
매뉴얼 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.
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.
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.
정리 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 사본에서도
돌렸고, 집합 하나의 읽는 곳을 지우면 두 곳 모두 실패한다.