Commit Graph
1216 Commits
Author SHA1 Message Date
DongHyeonka 42b183f72c fix(design-system): Dialog 밖 Popover·Tooltip이 Dialog의 Escape를 막지 않는다
앞 커밋은 Popover와 보이는 Tooltip이 Escape를 document capture 단계에서
받아 기본 동작을 막게 했다(1112/05-11). 그런데 대상이 어디인지 보지 않는다.
열린 popover를 Tab으로 벗어나 키보드로 Dialog를 열거나, tooltip이 보이는
채로 Dialog가 열리면, Dialog 안의 첫 Escape를 뒤쪽 층이 먹고 Dialog는 닫히지
않는다. 고치기 전에는 둘 다 닫혔다(확인 리뷰).

고른 방법: escape-layer.ts의 escapeIsForLayer가 Escape를 누른 곳이 그 층을
품지 않은 dialog 안이면 그 Escape를 dialog 것으로 본다. 층 안, 층을 품은
dialog 안, 요소 밖(포커스가 body)에서 누른 Escape는 층의 것이다. Popover와
Tooltip이 이것을 묻는다. 버린 대안: 대상이 층 안일 때만 받기(WebKit은 클릭한
버튼에 포커스를 주지 않아 열린 popover가 Escape로 닫히지 않는다).

위험·한계: native <dialog>가 아닌 modal(role="dialog"만 단 것)은 이 판정이
모른다. 템플릿의 Dialog·Drawer는 <dialog>다.

검증: design-system-a11y.test.tsx의 새 시험 셋(Dialog 밖 Popover, Dialog 밖
Tooltip, body에서 누른 Escape)이 고치기 전 코드에서 앞 둘이 실패하고 셋째는
통과(대조)하며, 고친 뒤 모두 통과한다(desktop, PR 본문).

Refs: 1112/05-11
2026-11-13 00:05:26 +09:00
DongHyeonka 353bed7ac2 fix(design-system): 공통 primitive의 키보드·보조기술 동작을 약속대로 맞춘다
공통 primitive가 디자인 시스템 설계 8.1·8.2절과 WCAG 2.2 AA 약속을
어긴다.

- Popover가 이름 없는 role="dialog"를 그린다(1112/05-10).
- Dialog 안의 Menu·Popover·Tooltip에서 Escape를 누르면 Dialog까지
  닫힌다. Dialog가 안쪽이 처리한 Escape를 보지 않는다(05-11).
- SearchField는 required 기호만, Checkbox는 상태만 있다(05-13).
- Toast를 닫기 버튼으로 닫으면 포커스가 body로 떨어진다(05-14).
- TextArea 글자 수가 <output>(암묵 status)이라 글자마다 발표되고 입력과
  이어지지 않는다(05-17).
- 라우트 h1의 :focus outline 제거가 layer 순서로 키보드 :focus-visible
  표시까지 지운다(05-02). Tooltip이 pointer-events: none과 틈 때문에
  포인터를 설명 위로 옮기면 사라진다(1.4.13, 05-06).
- 홈 readiness 목록이 role 없는 div에 aria-label을 단다(05-15).
- fe-a11y·fe-ux 스킬이 제출 실패 때 오류 요약으로 포커스가 간다고 적는다.
  코드는 첫 오류 필드로 보낸다(05-09).

고른 방법: Popover는 trigger id로 이름을 받는다. Popover·Tooltip은
Escape를 capture 단계에서 받아 preventDefault하고, Dialog는 기본 동작이
막힌 Escape(과 그 뒤 cancel)를 넘긴다. Tooltip은 보일 때(hover·focus)만
Escape를 가진다. 숨은 tooltip이 다른 Dialog의 Escape를 막지 않게 하려는
것이다. Toast 닫기는 다음 toast의 닫기 버튼, 없으면 toast로 들어오기 전
요소로 포커스를 돌린다. TextArea 글자 수는 aria-describedby로 잇고 0에
닿을 때만 따로 발표한다. h1은 :focus:not(:focus-visible)만 outline을
지운다. Tooltip은 보일 때만 포인터를 받고 ::before 다리로 틈을 메운다.
버린 대안: Dialog가 안쪽 layer 목록을 들고 Escape를 나누기(primitive끼리
묶인다).

위험·한계: native <dialog>가 막힌 keydown 뒤에도 cancel을 쏘는지는
브라우저마다 다를 수 있어, Dialog는 같은 task의 cancel 하나를 넘긴다.
Toast가 돌려줄 요소가 지워졌으면 포커스를 옮기지 않는다. 시각 골든이
바뀌는지는 desktop test:visual로 본다.

검증: 새 component 시험(tests/component/design-system-a11y.test.tsx,
starter-pages), e2e(app-shell focus ring, 세 엔진), storybook(tooltip
hover)의 RED·GREEN은 desktop에서 돌려 PR 본문에 적는다.

Refs: 1112/05-02, 1112/05-06, 1112/05-09, 1112/05-10, 1112/05-11,
 1112/05-13, 1112/05-14, 1112/05-15, 1112/05-17
2026-11-12 22:53:40 +09:00
donghyeon.kang 5250ff950e Merge pull request 'test(setup): 자식 프로세스 시험 timeout을 잰 값으로 정하고 흔들리던 시험 둘을 고친다' (#22) from fix/child-process-test-timeouts into main
frontend-quality-gates / main / checker self-tests (push) Successful in 56s
frontend-quality-gates / merge / static checks (push) Successful in 2m12s
frontend-quality-gates / merge / browser tests (push) Successful in 8m23s
frontend-quality-gates / FE-GATE-017 / diagram-review (push) Skipped
frontend-quality-gates / FE-GATE-014 / config-compatibility (push) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (push) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (push) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (push) Skipped
frontend-quality-gates / external-vulnerability-provider (push) Skipped
frontend-quality-gates / external-provenance-provider (push) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (push) Skipped
frontend-quality-gates / deploy-promoted-release (push) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (push) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (push) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (push) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (push) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (push) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (push) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (push) Skipped
frontend-quality-gates / merge / tests (push) Failing after 12m24s
2026-11-12 04:13:12 +00:00
DongHyeonka a593feb252 docs(changelog): 자식 프로세스 시험 timeout과 흔들리던 시험 둘의 고침을 적는다
frontend-quality-gates / merge / static checks (pull_request) Successful in 2m37s
frontend-quality-gates / merge / tests (pull_request) Failing after 13m15s
frontend-quality-gates / merge / browser tests (pull_request) Failing after 7m3s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / main / checker self-tests (pull_request) Skipped
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Skipped
frontend-quality-gates / external-vulnerability-provider (pull_request) Skipped
frontend-quality-gates / external-provenance-provider (pull_request) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Skipped
frontend-quality-gates / deploy-promoted-release (pull_request) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
정리 단계 절에 이 브랜치의 범위를 넣었다. 먼저 할 일 17을 더했다:
기본 timeout인 Vitest 시험이 자식 프로세스를 띄우면 실패하니,
다운스트림은 자기 시험에 childProcessTimeout(<잰 ms>)을 준다. 옮긴 뒤
확인 1에는 test:integration과 17단계를 더했다. 계약 표 한 줄과, 그 밖의
수정에 guardian lease 고침과 archive 시험의 임시 파일 경합 고침을
한 줄씩 적었다.

검증(desktop): verify:documentation, test:unit.
2026-11-12 11:43:15 +09:00
DongHyeonka db4c632d53 test(archive): 다른 시험이 쓰는 중인 임시 파일은 사본에 복사하지 않는다
tests/integration/security-followup-archive.test.ts는 후보 빌드에 쓸
증거를 얻으려고 checkout의 artifacts/를 통째로 사본에 복사한다. 같은
integration 실행에서 tests/integration/http-scenario-catalog.test.ts가
artifacts/tests/http-scenario-executions.json을 임시 파일에 쓰고
rename한다. 복사가 목록을 읽은 뒤 그 임시 파일이 rename되면 ENOENT로
실패한다. desktop FE-GATE-007(2026-11-12, load 9)에서 났다.

복사 filter가 원자적 쓰기의 임시 파일(.<이름>.<무작위>.tmp)을 건너뛴다.
그런 파일은 쓰는 중이라 증거가 아니다. fs.cp는 filter를 stat보다 먼저
부르므로, 건너뛴 파일은 사라져도 오류가 없다.

버린 것:
- 필요한 증거 경로만 복사: 공급망 생성이 추적 파일(artifacts의 .gitkeep
  포함)을 모두 lstat하고 build가 읽는 증거가 여러 곳이라, 목록을 따로
  관리해야 한다.
- 두 시험을 같이 돌지 않게 하기: integration 층 전체를 직렬로 돌려야 한다.

위험: 임시 파일이 아닌 파일을 다른 시험이 지우는 경합은 남는다. 지금
artifacts/ 아래에서 그렇게 하는 시험은 찾지 못했다.

검증(desktop):
- 다른 프로세스가 artifacts/tests에 임시 파일 10개를 계속 만들고
  rename하는 동안 이 시험을 돌렸다. main 6b4f703c는 3회 중 2회가 같은
  ENOENT(.tmp)로 실패했고, 이 커밋은 3회 모두 통과했다.
- test:unit, check:types, check:ci, lint, verify:documentation.
2026-11-12 11:43:08 +09:00
DongHyeonka 77c01b03c1 test(guardian): lease가 시험 대상이 아니면 시험 timeout만큼 준다
tests/integration/provider-guardian-transaction.test.ts가 부하 때 lease
만료로 실패한다. guardian이 스스로 SIGKILL한 것이다. desktop 기록 둘:
- FE-GATE-007: 「still publishes near the lease deadline」
- FE-GATE-020 drill: 「owns raw and sealed publication through the
  authenticated client lease」
FE-B 실행에서도 load 28에 같은 실패가 2건 났다. 다시 돌리면 통과한다.

원인은 두 가지다.
- startProviderGuardian은 guardian을 띄우자마자 절대 deadline
  (Date.now() + leaseMs)을 찍는다. 그래서 client 경로 시험의 2~3초
  lease가 node 시작 시간까지 낸다. 부하 때 시작에는 상한이 없다.
- 직접 프로토콜 시험은 guardian이 load를 마친 뒤 가드를 보낸다
  (c8620042). 그래도 가드 → READY 처리는 실제 시계로 돈다. desktop에서
  CPU 25%로 제한하면 이 구간이 17ms에서 334ms로 늘어나, 350ms lease로
  만료를 보는 시험의 여유가 거의 없다.

lease가 시험 대상인지로 나눠 고쳤다.
- lease가 대상이 아닌 15곳(client 경로 10, 직접 경로 5)은
  LEASE_NOT_UNDER_TEST_MS다. 값은 시험 timeout과 같아서, lease가 시험보다
  먼저 끝날 수 없다. guardian이 멈추면 시험 timeout이 잡는다.
- lease 만료를 보는 시험은 350ms → 2초다. 가드 → READY의 CPU 25% 최대
  334ms의 여섯 배다.
- near-deadline 시험은 client 경로에서 직접 프로토콜로 옮겼다.
  - deadline이 guardian load 뒤에 시작해서 시작 시간이 빠진다.
  - sendGuard가 보낸 deadline을 돌려준다.
  - 시험은 lease 4초의 마지막 2초 안에 publish·commit을 보내고, 그
    구간에 있었는지 단언한다.
  - 2초는 publish·commit의 CPU 25% 최대 104ms의 약 스무 배다.
  - client의 publish·commit은 「owns raw and sealed publication」이 그대로
    본다.

버린 것:
- guardian에 가짜 시계 주입: 운영 스크립트에 시험용 훅을 넣어야 한다
  (c8620042와 같은 이유).
- client가 guardian load 뒤에 deadline을 찍게 바꾸기: 운영 프로토콜에
  준비 신호를 더해야 한다. 이 PR 범위를 넘는다.
- 모든 lease를 늘리기: 만료와 near-deadline 시험은 lease가 대상이라
  늘리면 보는 것이 흐려진다.

위험:
- 시험이 실패하면 guardian이 lease 끝까지(최대 30초) 남을 수 있다.
  전에는 2~3초였다.
- near-deadline 시험에는 실제 시계 구간이 남는다. publish·commit이 2초를
  넘으면 실패한다. 잰 최대의 약 스무 배다.
- 운영 client가 lease에 node 시작 시간을 포함하는 것은 그대로다. 운영
  lease는 분 단위라 시험만큼 빠듯하지 않다.

검증(desktop):
- 이 파일을 10회 돌려 22개 모두 통과했다(load 3~4).
- CPU 20% 제한에서 main d2239c67은 5회 모두 1~6개 실패했다. 원인은 가드
  처리 중 deadline 지남(126), READY·PUBLISHED 대기 시간 초과, EPIPE였다.
  같은 조건에서 이 커밋은 5회 모두 통과했다.
- 시험 timeout은 잰 최대로 고쳤다. near-deadline 3.2초, 만료 2.1초.
- 첫 최종 실행에서 FE-GATE-007이 near-deadline 시험의 「마지막 2초 안」
  단언으로 실패했다(남은 2,001ms). 타이머가 Date.now()보다 1ms 일찍 깼다.
  목표 시각에 닿을 때까지 다시 기다리게 고쳤다. 고친 뒤 이
  파일을 30회(load 3.6~21), CPU 20% 제한으로 5회 돌려 모두 통과했다.
2026-11-12 11:23:04 +09:00
DongHyeonka 91962e24e3 test(setup): 자식 프로세스를 띄우는 시험이 잰 시간으로 timeout을 정한다
자식 프로세스를 띄우는 Vitest 시험 91개(24파일)가 기본 timeout 10초에
기대고 있었다. 셋은 FE-GATE-013에서만 도는 tests/system 시험이다.
기본값은 프로세스 안에서 도는 시험에 맞춘 값이다. 부하가 높은
desktop에서는 자식 프로세스 시험이 평소보다 크게 느려진다.
FE-GATE-020 drill 사본에서 평소 0.4~1.2초인 문서 시험이 10.6초 걸려
실패했다(2026-11-12). 가장 위험한 것은 tests/architecture/app-build-input
.test.ts로, desktop에서 이미 5.7초까지 걸렸다.

무엇을 고칠지는 desktop 계측으로 정했다.
- test:coverage 묶음(maxWorkers=4)과 test:unit을 세 번씩 돌렸다. 시험마다
  띄운 자식 프로세스는 child_process 함수를 감싸 기록했고, 소요 시간은
  JSON reporter로 받았다.
- 시험마다 실제 timeout은 task.timeout으로 기록했다.
- 자식 프로세스를 띄우는 시험 140개 중 88개가 기본값이었다. tests/system은
  그 묶음에 없어서, 아래 검사가 잡은 셋을 따로 세 번 쟀다.

고친 것:
- tests/helpers/child-process-timeout.ts의 childProcessTimeout(<잰 최대
  ms>)는 그 15배를 30초 단위로 올린 값이다. 15배는 위 0.7초 → 10.6초에서
  왔다. 시험마다 자기가 잰 최대값을 인자로 적어 근거가 호출 자리에 남는다.
- describe 안의 기본값 시험이 모두 자식 프로세스를 띄우면 describe에,
  일부만 띄우면 그 시험에 준다. 프로세스 안에서 도는 시험의 hang을 늦게
  잡지 않으려는 것이다.
- tests/setup.ts가 child_process 함수를 감싼다. 기본 timeout인 시험이
  자식 프로세스를 띄우면 그 호출에서 실패시키고, helper 이름을 알린다.
  helper나 시험이 import한 스크립트가 띄워도 잡는다. util.promisify가
  읽는 속성은 원래 함수에서 옮긴다.
- docs/work/reference/testing.md 2절에 값 정하는 법과 이 검사를 적었다.

버린 것:
- 전역 testTimeout 올리기: 프로세스 안 시험의 hang을 늦게 잡는다.
- 시험마다 손으로 정한 숫자: 근거가 남지 않고, 이미 있는 값도
  60_000·120_000처럼 근거가 없었다.
- 자식 프로세스를 띄우지 않게 바꾸기: 검사 스크립트를 CLI 그대로 시험하는
  것이 이 시험들의 목적이라 범위가 커진다.
- 파일에 timeout 선언이 있는지만 보는 정적 검사: helper가 띄우는 경우와
  같은 파일의 다른 시험을 놓친다.

위험:
- hook(beforeAll 등)에서 띄우는 프로세스는 검사하지 않는다. 계측에서
  hook이 띄운 곳은 둘이고, 둘 다 180초를 선언했다.
- 같은 파일 안에서 it.concurrent로 도는 시험이 섞이면 어느 시험의
  timeout인지 틀릴 수 있다. 지금은 그런 시험이 없다.
- 다운스트림 시험이 기본값으로 자식 프로세스를 띄우면 test:unit 등이
  실패한다. 메시지가 helper를 알린다.

검증(desktop):
- 다섯 검사(test:unit·check:types·check:ci·lint·verify:documentation)
  rc=0.
- 자식 프로세스를 띄우는 시험 파일 40개와 tests/scale: rc=0, 검사 위반 0.
- tests/system: 115개 중 18개 실패. 모두 bwrap 호스트 제약이고 검사
  위반은 0이다.
- 변이: 검사를 끄면 tests/unit/child-process-timeout.test.ts가 실패한다.
  tracked-artifacts describe의 timeout을 지우면 그 시험이 검사 메시지로
  실패한다.
- 재현: CPU 10% 제한에서 app-build-input·registry-governance·hosting-probe
  ·design-system-rules를 돌렸다. main 650d22fa는 11개가 10초 timeout으로
  실패했다. 이 커밋은 71개 모두 통과했고, 가장 긴 시험은 17.7초였다.
2026-11-12 11:22:59 +09:00
donghyeon.kang 6b4f703c59 Merge pull request 'docs(work): FE-GATE-013 desktop 판정을 정하고 스킬 절 인용을 대조한다' (#21) from donghyeon.kang/claude/fe-b-docs-followup-2 into main
frontend-quality-gates / merge / static checks (push) Successful in 2m19s
frontend-quality-gates / merge / tests (push) Failing after 12m33s
frontend-quality-gates / merge / browser tests (push) Successful in 9m0s
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (push) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (push) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (push) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (push) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (push) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (push) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (push) Skipped
frontend-quality-gates / FE-GATE-017 / diagram-review (push) Skipped
frontend-quality-gates / main / checker self-tests (push) Successful in 1m14s
frontend-quality-gates / FE-GATE-014 / config-compatibility (push) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (push) Skipped
frontend-quality-gates / external-vulnerability-provider (push) Skipped
frontend-quality-gates / external-provenance-provider (push) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (push) Skipped
frontend-quality-gates / deploy-promoted-release (push) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (push) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (push) Skipped
2026-11-12 01:58:15 +00:00
DongHyeonka c8b70f5a2b docs(changelog): FE-GATE-013 판정·스킬 절 대조·ungated reason을 적는다
frontend-quality-gates / merge / tests (pull_request) Failing after 13m9s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 8m30s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / merge / static checks (pull_request) Successful in 2m18s
frontend-quality-gates / main / checker self-tests (pull_request) Skipped
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Skipped
frontend-quality-gates / external-vulnerability-provider (pull_request) Skipped
frontend-quality-gates / external-provenance-provider (pull_request) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Skipped
frontend-quality-gates / deploy-promoted-release (pull_request) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
문제: desktop FE-GATE-013 판정 규칙, 스킬 절 인용 시험, ungated-tests
reason 번역이 변경 이력에 없다. 절 인용 시험은 자기 문서의 절 이름을 바꾼
다운스트림이 스킬도 같이 고쳐야 통과한다.

고른 방법: 「정리 단계」 절 머리에 이 브랜치 범위를 더하고 「그 밖의
수정」에 세 줄을 더한다.

위험: 커밋 해시는 이 브랜치의 것이다. main이 다시 바뀌어 rebase하면 함께
고친다.

검증: 문서 검사는 desktop에서 돌린다.
2026-11-12 10:49:49 +09:00
DongHyeonka ac19de85ac docs(ci): ungated-tests.json의 reason을 한국어로 옮긴다
문제: 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에서 돌린다.
2026-11-12 10:49:34 +09:00
DongHyeonka bdda84f844 docs(work): desktop FE-GATE-013을 조건부로 merge 판정에서 빼기로 정한다
문제: 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에서 돌린다.
2026-11-12 10:49:34 +09:00
DongHyeonka 1b3eee41e3 test(claude): 스킬이 인용하는 절 이름을 문서 제목과 대조한다
문제: 스킬은 정본 문서의 절을 「이름」이나 「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개를 확인했다.
2026-11-12 10:49:20 +09:00
donghyeon.kang d2239c6764 Merge pull request 'docs: 문서 체계 후속으로 VD 보완 표시와 낡은 서술을 고친다' (#20) from donghyeon.kang/claude/fe-b-docs-followup into main
frontend-quality-gates / merge / browser tests (push) Successful in 9m46s
frontend-quality-gates / FE-GATE-017 / diagram-review (push) Skipped
frontend-quality-gates / FE-GATE-014 / config-compatibility (push) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (push) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (push) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (push) Skipped
frontend-quality-gates / external-vulnerability-provider (push) Skipped
frontend-quality-gates / external-provenance-provider (push) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (push) Skipped
frontend-quality-gates / deploy-promoted-release (push) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (push) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (push) Skipped
frontend-quality-gates / merge / static checks (push) Successful in 2m17s
frontend-quality-gates / merge / tests (push) Failing after 12m23s
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (push) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (push) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (push) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (push) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (push) Skipped
frontend-quality-gates / main / checker self-tests (push) Successful in 1m7s
2026-11-12 01:43:19 +00:00
DongHyeonka 36eb6b0b35 docs(changelog): 문서 체계 후속 고침을 정리 단계 절에 적는다
frontend-quality-gates / merge / browser tests (pull_request) Successful in 11m27s
frontend-quality-gates / merge / tests (pull_request) Failing after 15m24s
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Skipped
frontend-quality-gates / external-vulnerability-provider (pull_request) Skipped
frontend-quality-gates / external-provenance-provider (pull_request) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Skipped
frontend-quality-gates / deploy-promoted-release (pull_request) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / main / checker self-tests (pull_request) Skipped
frontend-quality-gates / merge / static checks (pull_request) Successful in 2m56s
문제: VD 보완 표시, 낡은 서술 고침, drill 복구 항목 이름, ungated
reason 번역이 변경 이력에 없다. drill 이름은 record.json의 값을 바꾸고,
자기 runbooks.json을 고친 다운스트림은 drill도 같이 고쳐야 한다.

고른 방법: 같은 동기화 단위인 「정리 단계」 절 머리에 이 브랜치 범위를
더하고, 「그 밖의 수정」에 네 줄을 더한다.

위험: 커밋 해시는 이 브랜치의 것이다. 병합 방식이 merge commit이라 main에서도
같은 해시로 찾을 수 있다.

검증: 문서 검사는 desktop에서 돌린다.
2026-11-12 09:41:13 +09:00
DongHyeonka b824195cdc docs(ci): ungated-scripts.json의 reason을 한국어로 옮긴다
문제: config/ci/ungated-scripts.json의 reason 18개가 영어다. 설정 파일의
사람이 읽는 설명 칸은 한국어로 쓴다(docs/README.md 2절).

고른 방법: 읽는 코드를 먼저 봤다. scripts/lib/ungated-scripts.ts는 빈
문자열만 막고, tests/unit/ungated-scripts.test.ts는 check:feature-index의
reason에 verify:extreme-scale이 들어 있는지만 본다. 그래서 script 이름·
경로·명령·게이트 ID·리뷰 ID는 그대로 두고 문장만 옮겼다. 옮기다 본
verify:extreme-scale의 「24 scripts」는 실제 23개라 숫자 대신
EXTREME_SCALE_GATES를 가리킨다.

위험: 같은 형식의 config/ci/ungated-tests.json reason은 범위 밖이라 영어로
남았다.

검증: diff가 reason 18줄뿐이다(키·순서·항목 수 같음). ungated-scripts
시험과 check:ci:gating은 desktop에서 돌린다.
2026-11-12 09:40:51 +09:00
DongHyeonka 6571d8cb9d fix(runbook): drill 복구 항목 이름을 runbooks.json과 같게 한다
문제: scripts/drill-runbook.ts의 복구 확인 항목 이름은 영어 리터럴이고,
config/runbooks/runbooks.json의 recoveryEvidence는 2026-11-08에 한국어로
옮겼다. 둘을 비교하는 곳이 없어 record.json과 UNVERIFIED 줄이 runbook에
없는 이름을 쓴다. 앞으로 한쪽만 고쳐도 아무 신호가 없다.

고른 방법: 다섯 drill의 항목 이름 20개를 recoveryEvidence 문자열로 바꾸고,
이름과 순서가 recoveryEvidence와 같은지 보는 시험을 runbook-drill.test.ts에
더한다. 판정 근거 문구(evidence)와 오류 메시지는 영어 그대로다.
버린 대안: drill이 recoveryEvidence를 위치로 읽어 이름을 붙이는 방법은
코드에서 항목과 판정의 짝이 보이지 않고, 설정 순서를 바꾸면 조용히
어긋난다.

위험: artifacts/runbooks/<id>/record.json의 assertion 값이 한국어가 된다.
record schema는 빈 문자열만 막으니 통과하지만, 그 값을 영어로 읽는 바깥
도구가 있으면 바꿔야 한다. 이 repo에는 없다.

검증: desktop에서 node scripts/run-vitest.ts run tests/unit/runbook-drill.test.ts
— 고치기 전 새 시험 5개 실패(RED), 고친 뒤 runbook-drill 14개·
runbook-contract 2개 통과(GREEN).
2026-11-12 09:40:51 +09:00
DongHyeonka 374af98640 docs: 번역하며 찾은 낡은 서술을 코드·설정에 맞춘다
문제: 살아 있는 문서를 옮길 때 뜻을 바꾸지 않는다는 규칙 때문에 남겨
둔 낡은 서술이 있다.
- contract-ownership: 계약 파일 「39개」. 지금 src/contracts의 .ts는 44개다.
- capability-consumer-experience: Local Draft를 「두 번째 구체 소비자」,
  「두 feature」라고 부른다. 지금은 제품 feature가 아니라 테스트 fixture
  (tests/fixtures/indexeddb-consumer)다.
- static-delivery: initialJavascript.files가 「예시 feature 기준」이라고
  한다. feature-shape-ceilings.json은 feature가 없는 지금 템플릿 빌드라고
  적는다.
- .dependency-cruiser.json:254 주석이 번호 없는 layers.md의 「§4」를 가리킨다.
- runbook 문서 제목 셋이 runbooks.json title과 다르다. FE-RB-002는 영어
  원문부터 manifest가 빠져 있었고, 001·003은 번역에서 갈라졌다.
- ci-quality-gates: zod 행의 고친 버전은 4.6.6인데 이유 칸은 4.6.7을 말한다.
  4.6.7은 올렸을 때 잰 버전이다(26ca2fdb 원문 "4.6.7 also adds").
- 같은 문서 FE-GATE-016 문단 끝 두 문장은 원래 runbook record 고정 경로
  문단의 것이다(6c52cdb9 원문). 폐기 문장 뒤로 밀려 뜻이 끊겼다.

고른 방법: 숫자는 옮겨 적지 않고 정본(src/contracts/)을 가리킨다.
Local Draft는 fixture라고 쓰고, 편의 프로필을 들일 조건을 「IndexedDB를
쓰는 제품 feature」로 좁힌다. 절 번호는 절 이름으로, 문서 제목은 등록부
title로 맞춘다. zod는 「고친 버전 이상으로 올리면」으로 쓰고 잰 버전과
날짜를 괄호에 둔다. 두 문장은 원래 문단으로 옮긴다.

위험: zod 7 KB는 다시 재지 않았다(2026-11-04 측정값 그대로).
cruiser 주석은 check:architecture 위반 메시지의 why 줄에 나온다. 이 주석을
비교하는 시험은 없다.

검증: 각 사실을 git ls-files, feature-shape-ceilings.json, runbooks.json,
layers.md 절 제목, 원문 커밋으로 확인했다. 문서 검사와 관련 시험은
desktop에서 돌린다.
2026-11-12 09:40:51 +09:00
DongHyeonka 8acf07c2f6 docs(adr): VD-09·11·13을 채택(보완)으로 올리고 보완 절을 단다
문제: 세 결정 기록은 결정한 뒤 본문을 제자리에서 고쳤지만 본문에 날짜가
붙은 보완 메모가 없어, 2026-11-08 머리 블록을 달 때 기계 규칙대로
「채택」이 됐다. 머리 블록은 본문이 결정한 때의 원문이라고 말하지만
실제로는 고친 뒤의 내용이다.

고른 방법: git 이력에서 결정 뒤 본문을 바꾼 커밋을 찾아 상태를
「채택(보완)」으로 올리고, 맨 아래 「보완」 절에 날짜·커밋·바뀐 절을
적는다(docs/README.md 2절). 본문은 고치지 않는다. 처음 커밋한 본문을
보는 git show 명령도 적는다.
- VD-09: 2026-07-30 6c52cdb9(스크립트 경로 .mjs→.ts),
  2026-08-02 92e5cace(결정 6~11번, 도식, 검증, Rollback)
- VD-11: 2026-09-18 ec7f20e2(case 수 고정 문단을 규칙으로 바꿈)
- VD-13: 2026-11-06 02a761f0(Web Storage key 이름을 정본 가리키기로)
6f6c48eb(2026-09-24)는 이력을 다시 시작한 커밋이라 세 본문 모두 그
앞 커밋과 내용이 같다. 그래서 보완에 넣지 않았다.

위험: 둘째 줄 「본문은 결정한 때의 원문이다」는 검사기가 고정한 문구라
그대로다. 보완 절의 첫 인용 블록이 실제 사정을 적는다.

검증: 각 커밋의 diff를 git diff <앞>:<경로> <뒤>:<경로>로 읽었다. 인용한
커밋 다섯 개가 모두 main의 조상이다. 문서 검사는 desktop에서 돌린다.
2026-11-12 09:40:51 +09:00
donghyeon.kang 650d22fa65 Merge pull request 'chore(layout): R2·R5 검사를 저장소 전체와 소유자 기준으로 마무리한다' (#18) from chore/layout-rules-r2-r5 into main
frontend-quality-gates / merge / static checks (push) Successful in 2m21s
frontend-quality-gates / merge / tests (push) Failing after 13m58s
frontend-quality-gates / merge / browser tests (push) Successful in 8m37s
frontend-quality-gates / FE-GATE-017 / diagram-review (push) Skipped
frontend-quality-gates / FE-GATE-014 / config-compatibility (push) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (push) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (push) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (push) Skipped
frontend-quality-gates / external-vulnerability-provider (push) Skipped
frontend-quality-gates / external-provenance-provider (push) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (push) Skipped
frontend-quality-gates / deploy-promoted-release (push) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (push) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (push) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (push) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (push) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (push) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (push) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (push) Skipped
frontend-quality-gates / main / checker self-tests (push) Successful in 1m7s
2026-11-11 23:29:49 +00:00
DongHyeonka c28bf92c21 Merge branch 'main' into chore/layout-rules-r2-r5
frontend-quality-gates / merge / static checks (pull_request) Successful in 2m32s
frontend-quality-gates / merge / tests (pull_request) Failing after 14m8s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 8m33s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / main / checker self-tests (pull_request) Skipped
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Skipped
frontend-quality-gates / external-vulnerability-provider (pull_request) Skipped
frontend-quality-gates / external-provenance-provider (pull_request) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Skipped
frontend-quality-gates / deploy-promoted-release (pull_request) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
main이 PR #17(분야 전문가 스킬)을 받아 39d00b28이 됐다. 충돌은 없고, #17이 바꾼 파일(.claude/, docs/work/, AGENTS.md, CLAUDE.md, scripts/tests/test_claude_setup.py)은 이 브랜치가 바꾼 파일과 겹치지 않는다.
2026-11-12 07:33:49 +09:00
donghyeon.kang 39d00b282c Merge pull request 'feat(claude): 분야 전문가를 지식 스킬 아홉 개와 렌즈 리뷰어로 두고 협업 명단을 붙인다' (#17) from donghyeon.kang/w3-experts-fe into main
frontend-quality-gates / merge / static checks (push) Successful in 2m54s
frontend-quality-gates / merge / tests (push) Failing after 13m52s
frontend-quality-gates / merge / browser tests (push) Failing after 7m15s
frontend-quality-gates / FE-GATE-017 / diagram-review (push) Skipped
frontend-quality-gates / FE-GATE-014 / config-compatibility (push) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (push) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (push) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (push) Skipped
frontend-quality-gates / external-vulnerability-provider (push) Skipped
frontend-quality-gates / external-provenance-provider (push) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (push) Skipped
frontend-quality-gates / deploy-promoted-release (push) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (push) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (push) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (push) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (push) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (push) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (push) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (push) Skipped
frontend-quality-gates / main / checker self-tests (push) Successful in 1m1s
2026-11-11 22:13:22 +00:00
DongHyeonka f5344f2166 Merge branch 'main' into chore/layout-rules-r2-r5
main이 PR #15(문서 체계)를 받아 db6a6eb6이 됐다. CHANGELOG 정리 단계
절 머리의 범위 문장이 충돌했고, 문서 체계 단계와 이 브랜치의 범위를 둘
다 남겼다. 나머지 파일은 자동으로 합쳐졌다. PR #15가 더한
tests/unit/docs-system.test.ts의 가상 저장소 목록은 앞 커밋
R2 예외로 적었다.
2026-11-12 07:00:43 +09:00
DongHyeonka b96f3b4564 test(layout): 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 목록을 대며 실패한다. 목록 내용을 바꾸면
바뀐 목록을 대며 실패한다. 목록이 파일에서 없어지면 낡은 예외로 실패한다.
2026-11-12 07:00:43 +09:00
DongHyeonka 2901785436 fix(claude): fe 스킬이 문서 체계 개편으로 옮긴 문서를 가리키게 한다
frontend-quality-gates / merge / static checks (pull_request) Successful in 2m35s
frontend-quality-gates / merge / tests (pull_request) Failing after 14m34s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 11m54s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / main / checker self-tests (pull_request) Skipped
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Skipped
frontend-quality-gates / external-vulnerability-provider (pull_request) Skipped
frontend-quality-gates / external-provenance-provider (pull_request) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Skipped
frontend-quality-gates / deploy-promoted-release (pull_request) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
문제: #15가 결정 기록을 docs/adr/로, 설계서 넷을 docs/design/의 설계 기록으로
옮겼다. fe-* 스킬 8개가 옛 경로를 적고 있어 verify:documentation(FE-GATE-017)과
그 시험(tests/unit/documentation-readiness.test.ts, FE-GATE-005)이 실패했다.

고른 방법: 옛 경로를 옮긴 곳으로 바꿨다(VD-* → docs/adr/, design-system-platform·
frontend-platform-testing-strategy·routing-pages-and-patterns·
typescript-state-and-data-flow → docs/design/2026-07-26-*-design.md). 스킬이 인용한
절 번호는 기록에 그대로 있다. 버린 대안: 기록 머리의 「현재 정본」으로 바꾸기
(인용한 절이 정본 쪽에 없는 것이 많아 근거가 끊긴다).

위험: 설계 기록은 쓴 때의 원문이라 지금 동작과 다를 수 있다. 스킬이 그 절을
근거로 든 규칙은 검사기·시험 경로를 함께 적어 두었다.

검증: 바꾼 문서에서 백틱 경로를 검사기 방식으로 다시 뽑아 없는 경로 0개,
python3 -m unittest discover -s scripts/tests 통과, scripts/verify.sh docs rc=0.
2026-11-12 06:56:09 +09:00
DongHyeonka 5d3e0f59ae Merge remote-tracking branch 'origin/main' into claude/w3-experts-fe 2026-11-12 06:52:28 +09:00
donghyeon.kang db6a6eb6fb Merge pull request 'docs: 문서 체계를 백엔드와 같게 하고 살아 있는 문서를 한국어로 옮긴다' (#15) from donghyeon.kang/claude/fe-b-docs-korean-645f55 into main
frontend-quality-gates / merge / static checks (push) Successful in 2m29s
frontend-quality-gates / merge / tests (push) Failing after 14m2s
frontend-quality-gates / merge / browser tests (push) Failing after 7m20s
frontend-quality-gates / FE-GATE-017 / diagram-review (push) Skipped
frontend-quality-gates / FE-GATE-014 / config-compatibility (push) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (push) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (push) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (push) Skipped
frontend-quality-gates / external-vulnerability-provider (push) Skipped
frontend-quality-gates / external-provenance-provider (push) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (push) Skipped
frontend-quality-gates / deploy-promoted-release (push) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (push) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (push) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (push) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (push) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (push) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (push) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (push) Skipped
frontend-quality-gates / main / checker self-tests (push) Successful in 1m24s
2026-11-11 21:51:56 +00:00
DongHyeonka 414fc2aa4a docs(manual): R1·R2·R5 규칙 문장과 CHANGELOG를 새 검사에 맞춘다
frontend-quality-gates / merge / static checks (pull_request) Successful in 3m4s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 21m46s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / external-vulnerability-provider (pull_request) Skipped
frontend-quality-gates / external-provenance-provider (pull_request) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Skipped
frontend-quality-gates / deploy-promoted-release (pull_request) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Skipped
frontend-quality-gates / merge / tests (pull_request) Failing after 14m14s
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
frontend-quality-gates / main / checker self-tests (pull_request) Skipped
매뉴얼 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.
2026-11-12 05:02:07 +09:00
DongHyeonka ceaf21ea84 fix(test): provider fixture가 추적되는 .claude 파일도 복사한다
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.
2026-11-12 05:01:27 +09:00
DongHyeonka bbbc6abd98 docs(changelog): 하네스·정리 3·4단계를 받은 뒤의 문서 체계 고침을 적는다
frontend-quality-gates / merge / static checks (pull_request) Successful in 2m20s
frontend-quality-gates / merge / tests (pull_request) Failing after 14m18s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 8m33s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / main / checker self-tests (pull_request) Skipped
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Skipped
frontend-quality-gates / external-vulnerability-provider (pull_request) Skipped
frontend-quality-gates / external-provenance-provider (pull_request) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Skipped
frontend-quality-gates / deploy-promoted-release (pull_request) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
문제: 정리 단계 미출시 절이 main을 두 번 받은 뒤 더한 문서 체계 고침(하네스
문서 맞추기, 줄임표 자리표시자, 시험 시간 한도, a11y 기록 경로)을 적지 않는다.

고른 방법: 「그 밖의 수정」에 세 줄을 더한다. 계약 행은 바뀌지 않는다.

검증: changelog-review-ids 시험과 verify:documentation을 desktop에서 본다.
2026-11-12 04:55:32 +09:00
DongHyeonka e9e98b8aa7 Merge branch 'main' into claude/fe-b-docs-korean-645f55
정리 3·4단계 PR #14와 CI 재편 PR #16(main 38c0dc7d)을 받는다. 충돌은 아홉
파일이다. 이 브랜치가 한국어로 다시 쓴 문서에 두 PR이 영어 판에서 바꾼
것을 한국어로 넣었다.
- a11y 기록 경로 `artifacts/tests/a11y-manual/` → `docs/accessibility/route-reviews/`:
  README, docs/README.md, manual-checklist, starter-experience,
  ci-quality-gates. 문서 검사의 `NOT_DOCUMENT`도 새 경로로 바꿨다(정해진 영어
  키 형식의 게이트 입력이라 문서로 보지 않는다)
- ci-quality-gates.md: merge 단계 job 셋, 지운 CI 계약 기준선, main 단계
  FE-GATE-029의 `check:ci:gating`
- adapter 재검토 원장: 합친 음성 fixture script
- README 프로젝트 구조: `schemas/`는 `config/schemas/`로, `artifacts/`는
  `.gitkeep`만 추적, 최상위 항목 등록부 `config/repository-layout.json`
- verify-documentation-readiness.ts: #14의 배치 규칙 검사(R6·R7)와 이 브랜치의
  문서 체계 검사를 둘 다 둔다. R7의 「현재 문서」는 #14의 폴더 목록(옛
  `docs/superpowers/` 포함) 대신 문서 검사의 `checkedForDrift`로 고른다
- deletable-history-documents 시험: #14의 등록부 기반 경로와 이 브랜치의
  검사기 예외를 같이 둔다
- CHANGELOG: 범위 문장과 표 행을 둘 다 둔다
- 루트 등록부에서 SPEC.md 항목을 뺀다(그 항목이 「문서 체계 작업이 이력 폴더로
  옮기고 이 항목을 뺀다」고 적었다)
- #14가 옛 `docs/testing/frontend-platform-testing-strategy.md`를 고친 것이
  이름 바뀜을 따라 기록(docs/design/…)에 들어와서, 기록은 옮길 때의 글로 되돌렸다
2026-11-12 04:53:06 +09:00
DongHyeonka 6805ed62a4 fix(claude): 분야 파일을 고치기 전에 fe 스킬을 부르도록 규칙에 파일과 스킬 짝을 적는다
frontend-quality-gates / merge / static checks (pull_request) Successful in 2m41s
frontend-quality-gates / merge / tests (pull_request) Failing after 13m11s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 8m41s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / main / checker self-tests (pull_request) Skipped
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Skipped
frontend-quality-gates / external-vulnerability-provider (pull_request) Skipped
frontend-quality-gates / external-provenance-provider (pull_request) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Skipped
frontend-quality-gates / deploy-promoted-release (pull_request) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
문제: 백엔드 템플릿 실제 세션 평가에서 분야 스킬이 목록에 떠도 세 번 중 한 번만
불렸다. 같은 모양인 이 repo 규칙도 "어느 스킬인지는 experts.md 3절 표"라고만 해서
한 번 더 읽어야 짝을 알았다.

고른 방법: 규칙에 고칠 것 → 스킬 짝을 한 줄로 적고, 처음 Edit·Write하기 전에 Skill
도구로 부르며 문서를 읽었어도 부른다고 적었다. 버린 대안: 폴더마다 AGENTS.md에 한 줄
더하기(파일 수가 늘고 배치 규칙과 겹침), 강조어(과다 호출을 부른다).

위험: 규칙이 붙는 세션마다 약 300토큰이 는다. 여러 분야를 부르면 호출이 는다.

검증: python3 -m unittest discover -s scripts/tests 68건 통과, scripts/verify.sh docs rc=0.
2026-11-12 04:36:10 +09:00
DongHyeonka 1f57c38e40 test(layout): R5를 게이트 대상의 소유자를 따라가는 검사로 바꾼다
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.
2026-11-12 01:17:55 +09:00
DongHyeonka 3f64c68991 refactor(layout): 남은 루트 경로 목록도 등록부 집합에서 고른다
정리 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 사본에서도
돌렸고, 집합 하나의 읽는 곳을 지우면 두 곳 모두 실패한다.
2026-11-12 01:17:55 +09:00
DongHyeonka b5e7f54bd1 feat(claude): 분야 전문가를 지식 스킬 아홉 개와 렌즈 리뷰어로 두고 협업 명단을 붙인다
frontend-quality-gates / merge / static checks (pull_request) Successful in 3m3s
frontend-quality-gates / merge / tests (pull_request) Failing after 13m34s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 9m26s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / main / checker self-tests (pull_request) Skipped
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Skipped
frontend-quality-gates / external-vulnerability-provider (pull_request) Skipped
frontend-quality-gates / external-provenance-provider (pull_request) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Skipped
frontend-quality-gates / deploy-promoted-release (pull_request) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
문제: 하네스에 분야 지식이 없다. QA·디자인/UX·디자인 시스템·React·폴더
구조·시험 환경·접근성·성능·보안의 이 repo 규칙(배럴 경계, 토큰 밖 색 금지,
axe 태그 범위, 예산, FE-GATE 실행법 등)은 문서와 검사기에 흩어져 있고,
여러 분야에 걸친 일을 누가 보고 어떻게 합치는지 정한 곳이 없다.

고른 방법(소유자 결정 2026-11-11 「W3 설계대로」, 백엔드와 같은 모양):
- 지식 스킬 fe-* 9개(.claude/skills/). paths를 걸어 그 분야 파일을 만질 때만
  목록에 뜬다. 본문은 언제 쓰나 → 함정 → 실패는 이렇게 보인다 → 검증 →
  이 repo에서 정한 것 순서. 초안은 이 repo 문서만 본 서브에이전트가 썼고
  glob 75개가 모두 파일에 걸리는 것을 확인했다.
- 서브에이전트 reviewer(렌즈 = brief의 스킬 경로). arch-reviewer는
  fe-structure를, verify-app은 fe-qa를 미리 싣는다(QA 탐색 차터).
- .claude/rules/expert-skills.md: 분야 파일을 고치기 전에 그 스킬의
  「함정」·「검증」을 보게 하는 두 줄.
- docs/work/experts.md: 명단·경로 → 렌즈·넘김 지도(백엔드 repo로 가는 API
  계약 차이는 총괄을 거침)·충돌·비용. 루트 AGENTS.md·CLAUDE.md 한 줄씩,
  README 3절 4단계와 delegate.md 4.3절에 가리키는 말.
- 시험: 에이전트 넷, Agent 도구 금지, 설명 합 1,200자, 미리 싣는 스킬,
  지식 스킬의 paths·설명 300자·금지어·절 순서·150줄·glob이 파일에 걸림,
  명단이 모든 전문가를 담음, 규칙 목록에 expert-skills.
- 문서 PR #15와 겹치지 않게 docs/는 docs/work/만 건드렸다.
버린 대안: 분야마다 서브에이전트(QA·디자인·접근성 …). Anthropic
2026-10-22·2026-01-23·2026-04-07 글이 반대하고, 설명이 모든 세션에 든다.

위험: 플러그인 lead·new-expert·harness-eval은 claude-harness PR #3(0.3.0)이
병합돼야 받는다. fe-ux·fe-a11y의 paths는 템플릿에 기능 화면이 없어
src/presentation/**까지만 건다(기능이 생기면 넓힌다).

검증: scripts/verify.sh docs → rc=0, scripts/verify.sh hooks → 68건 통과.
새 시험은 조건을 깰 때마다 실패했다. desktop merge 단계는 이 커밋 뒤에 돈다.
2026-11-11 23:55:59 +09:00
DongHyeonka 7b09c215f0 test(docs): verify:documentation을 띄우는 시험에 넉넉한 시간을 준다
문제: tests/unit/documentation-readiness.test.ts의 사례마다
verify:documentation을 새 프로세스로 띄운다. 이 브랜치에서 그 검사가 살아
있는 문서 전부를 읽게 돼 한 번 도는 시간이 늘었고, 부하가 큰 desktop(load
25)에서 FE-GATE-020의 기능 생성 드릴이 사본 안에서 이 파일을 돌릴 때 세
사례가 기본 시간 10초를 넘겨 실패했다. 같은 사례는 부하가 낮을 때 1~8초다.

고른 방법: 이 파일의 사례에 저장소 관례대로 시간 한도 60초를 준다
(`VERIFY_TIMEOUT`). 그리고 livingDocuments가 문서 내용을 읽지 않고 경로만
고르게 해 한 번 도는 일을 줄인다. 버린 안: vitest 전역 testTimeout을
올리는 것(다른 시험의 멈춤을 늦게 알게 된다).

위험: 진짜로 멈춘 검사를 60초 뒤에야 알게 된다.

검증: desktop에서 이 파일과 FE-GATE-005·FE-GATE-020을 다시 돌린다.
2026-11-11 23:25:51 +09:00
donghyeon.kang 38c0dc7dbf Merge pull request 'ci(gates): merge job을 셋으로 합치고 검사기 자기 시험을 main 단계로 내린다' (#16) from chore/ci-merge-jobs into main
frontend-quality-gates / merge / static checks (push) Successful in 2m26s
frontend-quality-gates / merge / browser tests (push) Successful in 8m38s
frontend-quality-gates / FE-GATE-017 / diagram-review (push) Skipped
frontend-quality-gates / merge / tests (push) Failing after 12m16s
frontend-quality-gates / FE-GATE-014 / config-compatibility (push) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (push) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (push) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (push) Skipped
frontend-quality-gates / external-vulnerability-provider (push) Skipped
frontend-quality-gates / external-provenance-provider (push) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (push) Skipped
frontend-quality-gates / deploy-promoted-release (push) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (push) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (push) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (push) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (push) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (push) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (push) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (push) Skipped
frontend-quality-gates / main / checker self-tests (push) Successful in 1m32s
2026-11-11 13:36:13 +00:00
donghyeon.kang 6e8d8e2eb2 Merge pull request 'chore(layout): 정리 3·4단계로 루트를 합치고 배치 규칙을 검사로 둔다' (#14) from chore/layout-3-merge into main
frontend-quality-gates / FE-GATE-001 / manifest-lockfile (push) Successful in 42s
frontend-quality-gates / FE-GATE-002 / lint (push) Successful in 1m4s
frontend-quality-gates / FE-GATE-003 / typecheck (push) Successful in 1m6s
frontend-quality-gates / FE-GATE-004 / runtime-schema (push) Successful in 51s
frontend-quality-gates / FE-GATE-005 / unit (push) Failing after 1m45s
frontend-quality-gates / FE-GATE-006 / component (push) Successful in 1m5s
frontend-quality-gates / FE-GATE-007 / integration (push) Successful in 57s
frontend-quality-gates / FE-GATE-010 / architecture (push) Successful in 1m54s
frontend-quality-gates / FE-GATE-026 / lab-performance (push) Skipped
frontend-quality-gates / external-vulnerability-provider (push) Skipped
frontend-quality-gates / external-provenance-provider (push) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (push) Skipped
frontend-quality-gates / deploy-promoted-release (push) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (push) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (push) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (push) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (push) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (push) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (push) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (push) Skipped
frontend-quality-gates / FE-GATE-017 / diagram-review (push) Skipped
frontend-quality-gates / FE-GATE-011 / build (push) Successful in 2m9s
frontend-quality-gates / FE-GATE-012 / bundle (push) Successful in 50s
frontend-quality-gates / FE-GATE-013 / security (push) Failing after 49s
frontend-quality-gates / FE-GATE-020 / removability (push) Failing after 15m11s
frontend-quality-gates / FE-GATE-008 / e2e (push) Successful in 10m12s
frontend-quality-gates / FE-GATE-009 / accessibility (push) Successful in 4m1s
frontend-quality-gates / FE-GATE-014 / config-compatibility (push) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (push) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (push) Skipped
2026-11-11 13:36:10 +00:00
DongHyeonka 5f10f9285a docs(readme): 문서 지도가 제거 드릴 사본에 없는 루트 파일을 링크하지 않는다
문제: 기능 제거 드릴과 template-feature-removal-documents 시험은 repo
사본에서 verify:documentation을 돈다. 사본은 scripts/lib/removal-fixture.ts의
목록만 복사하고, 하네스 PR #13 뒤로 그 목록에 루트 CLAUDE.md가 없다.
docs/README.md 「폴더 밖 문서」가 `../CLAUDE.md`를 마크다운 링크로 가리켜
사본에서 없는 경로로 실패한다(.claude/rules/docs.md가 금하는 꼴).

고른 방법: CLAUDE.md와 PRODUCT.md 두 행을 링크 대신 인라인 코드 이름으로
적는다. 버린 안: 사본 목록에 CLAUDE.md를 더하는 것(목록은 드릴이 지우지
않는 문서만 담는다는 하네스 쪽 결정이다).

위험: 지도에서 그 두 파일로 바로 가는 링크가 없어진다. 이름은 그대로다.

검증: template-feature-removal-documents 시험이 desktop에서 통과한다.
2026-11-11 21:18:59 +09:00
DongHyeonka 743f6fcc68 fix(docs): 문서 경로 검사가 줄임표 「…」를 자리표시자로 본다
문제: 하네스 PR #13이 더한 scripts/hooks/README.md는 `node scripts/…`처럼
줄임표 「…」(U+2026)로 「아무 스크립트」를 적는다. 참조 검사가 살아 있는
문서 전부로 넓어지자 verify:documentation이 `scripts/…`를 없는 경로로
잡아 실패한다. 경로 검사는 `...`만 자리표시자로 알고 「…」는 몰랐다.
같은 repo의 문서 검사(scripts/lib/docs-system.ts의 PLACEHOLDER)는 이미
「…」를 자리표시자로 본다.

고른 방법: verify-documentation-readiness.ts의 경로 후보 거르기에 「…」를
더해 두 검사를 맞춘다. 버린 안: 하네스 문서의 표기를 바꾸는 것(같은 표기를
다른 문서도 쓸 수 있고, 검사 둘이 다르게 판정하는 것이 원인이다).

위험: 「…」가 든 진짜 경로는 검사에서 빠진다. 파일 이름에 「…」를 쓰는
일은 없다고 본다.

검증: documentation-readiness 시험의 자리표시자 사례에 `node scripts/…`를
더했다. 고치기 전 코드에서는 그 사례가 실패하고 고친 뒤 통과한다(desktop).
2026-11-11 21:17:48 +09:00
DongHyeonka 776a6ec68d docs(manual): 작업 매뉴얼과 겹치는 완료 기준 사본을 지운다
문제: 이 브랜치는 SPEC.md의 공통 완료 기준을
docs/manual/reference/done-criteria.md로 옮겼다. 하네스 PR #13은 같은 기준을
작업 매뉴얼 docs/work/improve.md 5절로 옮겼다. 같은 규칙의 사본이 둘이면
하나만 고쳐져 갈라진다.

고른 방법: 소유자 결정 D5가 말한 「매뉴얼」은 일하는 순서를 정하는 작업
매뉴얼(docs/work/) 쪽이 맞아서 개발 매뉴얼 사본을 지운다. 매뉴얼 README의
그 행과 CHANGELOG 줄을 고친다.

위험: 없음에 가깝다. 사본은 이 브랜치에서 생겼고 다른 문서가 가리키지
않는다.

검증: `git grep -n done-criteria`가 CHANGELOG의 이력 줄 밖에서 0건.
2026-11-11 20:55:32 +09:00
DongHyeonka 5757742ed0 docs(work): 하네스 문서를 새 문서 위치와 검사 범위에 맞춘다
문제: 하네스 PR #13이 더한 작업 매뉴얼·규칙은 이 브랜치가 바꾼 문서
체계의 옛 모습을 적는다.
- 옛 경로: `docs/architecture/decisions/`, `docs/superpowers/`, 루트
  `SPEC.md`, 목표 설계였던 `docs/testing/frontend-platform-testing-strategy.md`
- 옛 검사 범위: 「docs/README.md 1절이 링크한 문서, 폴더 링크는 바로 아래
  .md만」. 지금 verify:documentation은 살아 있는 문서 전부를 보고 언어·
  문체·숫자·머리 블록도 본다
- 옛 docs/README.md 절(1절 묶음 / 2절 목표 설계 / 3절 작업 이력)과 README
  절 이름(「Support scope」, 「Updating a copied project」)
- #13의 template-contract-documents 시험은 README 지워도 되는 표를
  `docs/superpowers/` 행으로 찾는데, 그 행은 이제 없다

고른 방법: 그 줄만 새 위치·새 절 이름·새 범위로 고친다(.claude/rules/docs.md,
docs/work의 docs-writing·operate·research-design·reference 다섯,
docs/problem-statement.md). 시험은 `docs/history/` 행으로 표를 찾는다.
docs/work/evidence.md는 백엔드처럼 매뉴얼 규칙의 근거 기록이라 고치지 않고
`HISTORY_HOLDERS`에 넣어 참조·숫자 검사에서 뺀다.

위험: 하네스 문서의 다른 문장은 건드리지 않았다. 하네스 세션이 쓴 뜻을
바꾸지 않으려는 것이다.

검증: 문서 검사 여섯이 0건, `git grep -n -E 'docs/superpowers|architecture/decisions'`가
기록·CHANGELOG·출처 표시 밖에서 0건.
2026-11-11 20:55:32 +09:00
DongHyeonka fb446e471e Merge branch 'main' into claude/fe-b-docs-korean-645f55
하네스 PR #13(main d1b9c087)을 받는다. 충돌은 README.md와 docs/README.md
둘이다. 이 브랜치가 두 파일을 한국어로 다시 썼고, #13이 영어 판에
AGENTS.md·docs/work/·docs/ledger/를 가리키는 줄과 지워도 되는 표 행을 더했다.
이 브랜치 판을 바탕으로 #13이 더한 것을 한국어로 넣었다.
- README: 최상위 표에 AGENTS.md·.claude/, 문서 지도에 AGENTS.md·docs/work/·
  docs/vision.md·docs/problem-statement.md·docs/ledger/, 지워도 되는 표에서
  CLAUDE.md를 빼고 docs/ledger/estimates.jsonl을 더함, 새 서비스로 시작하기와
  규칙과 기여의 CLAUDE.md 줄을 AGENTS.md 기준으로
- docs/README.md: 1절 「처음 읽을 문서」에 ../AGENTS.md·work/·work/reference/
  링크(#13의 template-contract-documents 시험이 본다), 지도에 work/·ledger/
  행, 폴더 밖 문서에 AGENTS.md·vision.md·problem-statement.md, 2절 살아 있는
  문서 목록
2026-11-11 20:55:11 +09:00
donghyeon.kang 7cd2d9e89b docs(work): ungated 검사가 도는 곳을 check:ci:gating으로 고친다
frontend-quality-gates / merge / static checks (pull_request) Successful in 2m23s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 10m49s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / external-vulnerability-provider (pull_request) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
frontend-quality-gates / main / checker self-tests (pull_request) Skipped
frontend-quality-gates / merge / tests (pull_request) Failing after 12m59s
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Skipped
frontend-quality-gates / external-provenance-provider (pull_request) Skipped
frontend-quality-gates / deploy-promoted-release (pull_request) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Skipped
main에 들어온 하네스 매뉴얼(docs/work/reference/gates.md, testing.md)이
「새 script·시험 파일이 게이트에 안 걸리면 check:ci가 실패한다」고 적는다.
이 PR의 f6b2b96c가 그 검사를 check:ci에서 떼어 main 단계 FE-GATE-029의
check:ci:gating으로 옮겼다. 두 줄과 생성기 주석 한 줄(merge_gate)을
고친다. 하네스 작업은 끝났고(PR #13 병합) 옮긴 명령을 가리키는 줄만
고쳤다.

검증(desktop): verify:documentation, test:unit.
2026-11-11 20:29:30 +09:00
donghyeon.kang 9676101a4d chore(merge): main을 받은 정리 3단계 브랜치를 받는다
PR #16은 PR #14(chore/layout-3-merge) 위에 쌓았다. #14가 하네스 PR #13이
들어간 main을 합친 커밋(568f3328)을 받는다. 충돌은 없었다.
2026-11-11 20:29:19 +09:00
donghyeon.kang 568f332892 chore(merge): 하네스 PR #13이 들어간 main을 받는다
frontend-quality-gates / FE-GATE-001 / manifest-lockfile (pull_request) Successful in 1m20s
frontend-quality-gates / FE-GATE-002 / lint (pull_request) Successful in 1m13s
frontend-quality-gates / FE-GATE-003 / typecheck (pull_request) Successful in 1m2s
frontend-quality-gates / FE-GATE-004 / runtime-schema (pull_request) Successful in 1m4s
frontend-quality-gates / FE-GATE-005 / unit (pull_request) Failing after 2m13s
frontend-quality-gates / FE-GATE-006 / component (pull_request) Successful in 1m12s
frontend-quality-gates / FE-GATE-007 / integration (pull_request) Successful in 1m17s
frontend-quality-gates / FE-GATE-010 / architecture (pull_request) Successful in 1m38s
frontend-quality-gates / FE-GATE-011 / build (pull_request) Successful in 57s
frontend-quality-gates / FE-GATE-012 / bundle (pull_request) Successful in 53s
frontend-quality-gates / FE-GATE-013 / security (pull_request) Failing after 36s
frontend-quality-gates / FE-GATE-020 / removability (pull_request) Failing after 12m49s
frontend-quality-gates / FE-GATE-008 / e2e (pull_request) Successful in 9m9s
frontend-quality-gates / FE-GATE-009 / accessibility (pull_request) Failing after 6m43s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Skipped
frontend-quality-gates / external-vulnerability-provider (pull_request) Skipped
frontend-quality-gates / external-provenance-provider (pull_request) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Skipped
frontend-quality-gates / deploy-promoted-release (pull_request) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
main(d1b9c087)에 하네스 PR #13이 들어가 루트에 `AGENTS.md`, `.claude/`,
`.gitattributes`가 생겼다. 이 브랜치는 그 셋을 루트 등록부에 optional로
미리 적어 두었다.

충돌 둘을 풀었다.
- `scripts/lib/removal-fixture.ts`: main은 문서 복사 목록에 `AGENTS.md`를
  더했고 이 브랜치는 그 목록을 등록부의 `fixture-documents` 집합으로
  바꿨다. 등록부의 `AGENTS.md` 항목에 그 집합을 적었다.
- `tests/unit/template-feature-removal-documents.test.ts`: main은 문서
  목록에 `AGENTS.md`와 옛 a11y 기록 폴더를 더했다. a11y 기록은 이
  브랜치에서 `docs/`로 옮겼으므로 `AGENTS.md`만 남겼다.

등록부의 `AGENTS.md`·`.claude`·`.gitattributes`는 이제 추적되는 항목이라
optional을 빼고 역할을 실제 내용으로 고쳤다. 추적되는 루트 항목과
등록부 항목이 서로 남는 것 없이 같다.

검증(desktop): 커밋별 5검사와 merge 게이트 14개, verify:documentation.
2026-11-11 20:29:01 +09:00
donghyeon.kang d1b9c08732 Merge pull request 'feat(harness): 프론트에 Claude Code 하네스와 작업 매뉴얼 docs/work/를 둔다' (#13) from claude/fe-c-harness-0ae061 into main
frontend-quality-gates / FE-GATE-001 / manifest-lockfile (push) Successful in 30s
frontend-quality-gates / FE-GATE-002 / lint (push) Successful in 1m13s
frontend-quality-gates / FE-GATE-003 / typecheck (push) Successful in 53s
frontend-quality-gates / FE-GATE-004 / runtime-schema (push) Successful in 1m0s
frontend-quality-gates / FE-GATE-005 / unit (push) Failing after 1m40s
frontend-quality-gates / FE-GATE-006 / component (push) Successful in 1m24s
frontend-quality-gates / FE-GATE-007 / integration (push) Successful in 1m3s
frontend-quality-gates / FE-GATE-010 / architecture (push) Successful in 1m56s
frontend-quality-gates / FE-GATE-011 / build (push) Successful in 1m4s
frontend-quality-gates / FE-GATE-012 / bundle (push) Successful in 37s
frontend-quality-gates / FE-GATE-013 / security (push) Failing after 30s
frontend-quality-gates / FE-GATE-020 / removability (push) Failing after 16m55s
frontend-quality-gates / FE-GATE-008 / e2e (push) Successful in 8m3s
frontend-quality-gates / FE-GATE-009 / accessibility (push) Successful in 4m36s
frontend-quality-gates / FE-GATE-014 / config-compatibility (push) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (push) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (push) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (push) Skipped
frontend-quality-gates / external-vulnerability-provider (push) Skipped
frontend-quality-gates / external-provenance-provider (push) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (push) Skipped
frontend-quality-gates / deploy-promoted-release (push) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (push) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (push) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (push) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (push) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (push) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (push) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (push) Skipped
frontend-quality-gates / FE-GATE-017 / diagram-review (push) Skipped
2026-11-11 11:25:18 +00:00
DongHyeonka f98f39a3db chore(ledger): 범위가 늘어난 뒤의 하네스 작업 실측으로 고친다
frontend-quality-gates / FE-GATE-003 / typecheck (pull_request) Successful in 1m9s
frontend-quality-gates / FE-GATE-006 / component (pull_request) Successful in 44s
frontend-quality-gates / FE-GATE-007 / integration (pull_request) Successful in 50s
frontend-quality-gates / FE-GATE-011 / build (pull_request) Successful in 40s
frontend-quality-gates / FE-GATE-012 / bundle (pull_request) Successful in 31s
frontend-quality-gates / FE-GATE-013 / security (pull_request) Failing after 31s
frontend-quality-gates / FE-GATE-020 / removability (pull_request) Failing after 10m40s
frontend-quality-gates / FE-GATE-009 / accessibility (pull_request) Successful in 4m40s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-001 / manifest-lockfile (pull_request) Successful in 1m9s
frontend-quality-gates / FE-GATE-002 / lint (pull_request) Successful in 1m5s
frontend-quality-gates / FE-GATE-004 / runtime-schema (pull_request) Successful in 29s
frontend-quality-gates / FE-GATE-005 / unit (pull_request) Failing after 1m41s
frontend-quality-gates / FE-GATE-010 / architecture (pull_request) Successful in 1m42s
frontend-quality-gates / FE-GATE-008 / e2e (pull_request) Failing after 5m59s
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Skipped
frontend-quality-gates / external-vulnerability-provider (pull_request) Skipped
frontend-quality-gates / external-provenance-provider (pull_request) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Skipped
frontend-quality-gates / deploy-promoted-release (pull_request) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
2026-11-09 00:49:47 +09:00
DongHyeonka 5fab0e462a fix(scripts): adapter 목록 합계를 맞추고 verify.sh parts에 SOURCE_DATE_EPOCH를 준다
frontend-quality-gates / FE-GATE-001 / manifest-lockfile (pull_request) Failing after 24s
frontend-quality-gates / FE-GATE-002 / lint (pull_request) Failing after 27s
frontend-quality-gates / FE-GATE-003 / typecheck (pull_request) Failing after 27s
frontend-quality-gates / FE-GATE-004 / runtime-schema (pull_request) Failing after 36s
frontend-quality-gates / FE-GATE-005 / unit (pull_request) Failing after 25s
frontend-quality-gates / FE-GATE-007 / integration (pull_request) Failing after 26s
frontend-quality-gates / FE-GATE-011 / build (pull_request) Failing after 26s
frontend-quality-gates / FE-GATE-012 / bundle (pull_request) Failing after 28s
frontend-quality-gates / FE-GATE-013 / security (pull_request) Failing after 25s
frontend-quality-gates / FE-GATE-020 / removability (pull_request) Failing after 32s
frontend-quality-gates / FE-GATE-008 / e2e (pull_request) Failing after 2m56s
frontend-quality-gates / FE-GATE-009 / accessibility (pull_request) Successful in 3m45s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Skipped
frontend-quality-gates / external-vulnerability-provider (pull_request) Skipped
frontend-quality-gates / FE-GATE-006 / component (pull_request) Failing after 36s
frontend-quality-gates / FE-GATE-010 / architecture (pull_request) Failing after 1m28s
frontend-quality-gates / external-provenance-provider (pull_request) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Skipped
frontend-quality-gates / deploy-promoted-release (pull_request) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
desktop(트리 04bb0e0e)에서 두 가지가 실패했다.
- FE-GATE-010·020: check:adapter-inventory가 "total does not equal 143
  tracked files"로 멈췄다. src/adapters의 AGENTS.md·CLAUDE.md 두 행은
  더했지만 INVENTORY.md 끝의 합계 줄(141/141)을 고치지 않았다.
- scripts/verify.sh parts FE-GATE-013: verify:reproducible-build,
  build:release-candidate, verify:local-evidence가 "missing required CI build
  environment: SOURCE_DATE_EPOCH"로 실패했다. ci:gate는 HEAD에서 이 값을
  만들지만 parts·script는 명령을 직접 부른다.

합계를 143/143으로 고치고, ci_env가 HEAD 커밋 시각으로 SOURCE_DATE_EPOCH를
준다(ci:gate와 같은 값).

검증: python3 -m unittest discover -s scripts/tests 통과(ci_env가 HEAD
SHA·커밋 시각·digest 꼴 이미지를 주는 시험 추가). desktop 재실행은 이
커밋 트리에서.
2026-11-08 23:40:31 +09:00
DongHyeonka 23df3203d8 docs(work): 정본이 정하는 검사 개수를 옮겨 적지 않는다
커밋 전 검사 8개, 통합 때 5개, 옛 게이트 11개처럼 config/ci/gates.json과 표가
정하는 개수를 문장에 옮겨 적었다. 표가 바뀌면 문장이 낡는다(문서 체계
검사의 숫자 복사 규칙). 개수를 빼고 표를 가리킨다.

검증: scripts/verify.sh docs rc=0.
2026-11-08 23:18:51 +09:00
DongHyeonka 48dc9f5ba9 docs(changelog): 계층 폴더 지역 규칙과 비전 양식을 하네스 절에 더한다 2026-11-08 22:57:03 +09:00