Commit Graph
1136 Commits
Author SHA1 Message Date
DongHyeonka 45e8cb774c docs(operations): 운영 문서와 adapter 재검토 처리 원장을 한국어로 옮긴다
문제: docs/operations의 release-cache-rollback.md와
adapter-remediation-ledger.md는 본문이 영어이고, 나머지 복구 문서와
ci-quality-gates.md에도 영어 문단이 남아 있다.

고른 방법: 뜻을 바꾸지 않고 옮긴다. 원장은 check:remediation-ledger가
읽으므로 같은 변경에서 스크립트를 맞춘다.
- `SECTION_HEADING`을 옮긴 절 제목(`## 세 번째 재검토 (2026-08-14)`)으로
- 「모두 닫혔다」를 잡는 `BLANKET_CLOSURE`에 한국어 대안을 더한다. 영어
  대안은 원장이 인용한 옛 문장을 잡도록 그대로 둔다
- 표 구조, id 칸, disposition 칸의 백틱 값, file-transfer 예산 숫자는
  그대로다
- ci-quality-gates.md의 advisory 표가 복사한 zod·react-router 버전을
  `package.json`·`pnpm-lock.yaml`을 가리키게 바꾼다(number 검사)

위험: check:remediation-ledger는 게이트 밖이라 CI가 돌리지 않는다.
desktop에서 손으로 돌려 확인했다.

검증: dispositions.json의 id 25개가 그 절의 행과 맞는지, 예산 숫자가
있는지를 스크립트로 확인했다. 문서 검사의 language·number 줄이 0이 되어
예외 목록에서 지웠다.
2026-11-08 21:57:47 +09:00
DongHyeonka af10cae9a6 docs(architecture): 현재 계약 문서와 매뉴얼의 영어 부분을 한국어로 옮긴다
문제: docs/architecture의 현재 계약 문서 가운데 scale-architecture.md,
starter-experience.md, capability-consumer-experience.md,
contract-ownership.md, static-delivery.md, review-evidence.md는 본문이
영어이고, backend-api-and-server-state-contract.md와
optional-adapter-recipes.md에는 영어 문단이 남아 있다.

고른 방법: 뜻을 바꾸지 않고 옮긴다. 백틱 안, 링크 대상, 절 번호(코드
주석이 `scale-architecture.md §N`으로 인용한다), 표 구조, 코드 블록은
그대로 둔다. 문서를 읽는 테스트와 절 이름을 인용한 곳을 같은 변경에서
고친다.
- tests/unit/feature-tracked-files.test.ts: starter-experience.md 표를
  자르는 시작·끝 문장과 표 행마다 찾는 낱말(`병합 충돌`)
- 「Ownership declarations」「Adding a feature」를 인용한 주석
  (create-feature.ts, generate-product-feature-index.ts, app-module.ts)과
  docs/manual의 절 이름 인용
- optional-adapter-recipes.md의 recipe 개수 복사를 카탈로그를 가리키게
  바꾼다(number 검사)

위험: create-feature.ts 417줄은 생성하는 context-module.ts의 JSDoc이라
새로 만드는 기능의 주석 글자가 바뀐다. 그 글자를 비교하는 테스트는 없다.
review-evidence.md는 산문만 옮겼고 해시·점수 칸은 그대로다.

검증: 백틱 span·링크 대상·코드 블록·번호 제목을 옮기기 전과 python으로
비교해 같다. 문서 검사의 language 줄이 이 문서들에서 0이 되어 예외
목록에서 지웠다.
2026-11-08 21:57:47 +09:00
DongHyeonka 7a9aefdf25 feat(docs): 문서 체계 검사를 verify:documentation에 더하고 입구 문서를 고친다
문제: 프론트 문서 체계는 백엔드와 다르다. docs/README.md는 "README와
입구 문서는 영어"라고 정해 두어 2026-11-07 소유자 결정(살아 있는
문서는 본문까지 한국어)과 반대이고, 기록의 머리 블록·언어·숫자 복사를
보는 검사가 없다. verify:documentation은 docs/README.md 1절이 링크한
문서의 경로만 본다.

고른 방법: 백엔드 scripts/check-docs.py의 규칙(language, head, number,
map, readme, style)을 같은 이름·문턱으로 TypeScript로 옮겨
scripts/lib/docs-system.ts에 두고 verify:documentation(FE-GATE-017)이
부르게 한다. 참조 검사는 지금 있는 것을 그대로 쓰고 대상만 살아 있는
문서 전부로 넓힌다. FE-GATE-017 job은 workflow_dispatch(documentation
단계)에서만 돌아서, PR에서 실패하도록 merge 단계 FE-GATE-005의
documentation-readiness 시험이 이 repo를 그대로 두고
verify:documentation을 한 번 돌린다.
- 버린 안: 새 게이트나 package script를 더하는 것. config/ci(정리
  3단계·CI 세션 범위)와 CI 계약의 개수·해시를 건드린다.
- 버린 안: check-docs.py를 그대로 복사하는 것. 프론트 CI 이미지와
  도구는 Node뿐이고, 참조 검사(짝 백엔드 pin, 지운 샘플, 생성 산출물)는
  이미 TS에 있다.
- 예외 목록 scripts/docs-system-exceptions.txt는 줄기만 한다(줄마다
  FROZEN 지문). 이 커밋의 줄은 아직 옮기지 않은 문서의 기준선이고 뒤
  번역 커밋들이 지운다.
- docs/README.md를 모든 문서 폴더를 덮는 지도와 수명·언어·머리 블록·
  검사 규칙으로 다시 쓰고, 루트 README.md를 docs-system.md 6.1절의 필수
  절 순서로 한국어로 다시 쓴다. README의 src 폴더 설명은 layers.md 표와
  글자가 같아야 하므로 layers.md·overview.md·foundation.md를 같이 옮긴다.
- README 「복사한 뒤 지워도 되는 것」을 읽는 정규식과, 문서를 바꿔 넣는
  테스트의 기대 문자열을 새 한국어 문장으로 고친다. 검사기는 기록
  폴더 이름을 적지만 지운 사본에서도 통과하므로
  deletable-history-documents 테스트의 검사 대상에서 뺀다(그 이유를
  테스트와 검사기 시험에 적었다).

위험: 파생 서비스가 이 변경을 받으면 자기 살아 있는 문서가 영어일 때
verify:documentation이 실패한다. CHANGELOG에 「먼저 할 일」로 적는다.
review-evidence.md는 다른 작업 공간의 경로를 적은 사본이라 참조·숫자
검사에서 뺐다(HISTORY_HOLDERS).

검증: tests/unit/docs-system.test.ts(조건마다 실패 입력),
documentation-readiness·template-feature-removal-documents·
deletable-history-documents 시험, verify:documentation을 desktop에서 돌렸다.
2026-11-08 21:57:39 +09:00
DongHyeonka 2b8a348c1f docs: 옮긴 VD·계획서 안의 상대 링크를 새 위치로 고친다
문제: 링크를 고친 앞 커밋은 옮긴 파일의 옛 위치를 지금 트리에서
찾았다. 그래서 VD와 superpowers 계획서 안에서 나가는 상대 링크
28개(예: VD-14의 `../../operations/…`)는 옛 위치 기준 그대로 남아
없는 곳을 가리킨다.

고른 방법: 옛 위치를 `git diff --name-status -M ad3a071f HEAD`의 이름
바뀜으로 다시 구해, 옮기기 전에는 풀리던 링크만 새 위치 기준으로 다시
쓴다. 옮기기 전에도 깨져 있던 링크 22개는 쓴 때의 글이라 그대로 둔다.
고친 것은 링크 대상뿐이다.

위험: 없음에 가깝다. 기록 본문의 글자는 바뀌지 않는다.

검증: 같은 스크립트를 다시 돌려 「옮기기 전엔 풀리던 깨진 링크」 0건.
2026-11-08 17:25:41 +09:00
DongHyeonka 75fad73a7d docs(records): 기록·설계서·결정 기록 67개에 한국어 머리 블록을 단다
문제: 옮긴 기록은 지금 동작을 설명하는지, 상태가 무엇인지, 지금
정본이 어디인지 알 길이 없다. 설계서·계획서 27개와 docs/architecture
목표 설계 16개에는 상태 칸이 없고, VD는 「상태: Accepted」 같은 영어
값을 쓴다.

고른 방법: docs-system.md 4절 형식으로 맨 위에 머리 블록을 달고 본문은
한 글자도 고치지 않는다. 상태는 기계 변환이다.
- 설계서: Accepted·확정·정본·설계 완료 → 채택, 상태 줄이 없으면
  확인 안 함 (채택 4, 확인 안 함 21)
- 계획서: 체크 상자가 모두 표시됐으면 끝남, 아니면 확인 안 함. SPEC.md는
  같은 폴더 plan.md와 같은 근거(0.2.0으로 끝난 라운드)로 끝남 (끝남 5,
  확인 안 함 14. 이미 블록이 있던 5개는 그대로)
- 결정 기록: Accepted → 채택, 날짜가 붙은 뒤늦은 보완 메모가 본문에
  있으면 채택(보완) (채택 14, 채택(보완) 9). 프론트 VD는 처음부터
  한국어로 썼고 번역하지 않으므로 둘째 줄은 「원문이다」 문구다.
- 작성일: 파일 이름 날짜 → 본문 날짜 줄(VD는 `결정일:`) → git 첫 추가일.

위험: VD-09·11·13은 git으로 보면 결정 뒤 본문이 그 자리에서
고쳐졌지만 본문에 날짜 표시가 없어 기계 규칙대로 채택으로 두었다.
보완으로 올릴지는 사람이 정한다. 「현재 정본」은 지금 있는 살아 있는
문서나 코드 경로만 쓴다.

검증: 블록과 그 뒤 빈 줄 하나를 빼면 72개 모두 `git show HEAD:`와 바이트가
같다. 뒤 커밋의 문서 검사 head 규칙으로 돌려 문제 0건.
2026-11-08 17:25:41 +09:00
DongHyeonka 9540bf8151 docs(history): SPEC.md를 2026-09-25 라운드 계획서 옆으로 옮긴다
문제: SPEC.md는 끝난 2026-09-25 리뷰 수정 라운드의 요구사항이다. 기록인데
저장소 루트에 있어 지금 쓰는 문서처럼 보인다.

고른 방법: 공통 완료 기준을 앞 커밋에서 매뉴얼로 옮겼으므로, 내용 변경
없이 같은 라운드의 계획서 폴더로 옮긴다(소유자 결정 D5). 루트 항목
등록부는 이 repo에 없어서 고칠 곳이 없다.

위험: 루트 README와 docs/README.md의 SPEC.md 줄은 뒤 커밋이 다시 쓴다.

검증: git status가 이름 바뀜 하나만 보인다.
2026-11-08 17:25:41 +09:00
DongHyeonka ee5e19f47f docs(manual): SPEC.md의 공통 완료 기준을 매뉴얼의 완료 기준으로 옮긴다
문제: 2026-09-25 리뷰 수정 라운드의 요구사항 SPEC.md는 라운드가
0.2.0으로 끝난 기록인데, 그 안의 「공통 완료 기준」(RED→GREEN, 변이
확인, 게이트, INVENTORY, kernel 위치, 포트 추가만, 커밋 하나, 문서
주장의 코드 위치)은 지금도 쓰는 규칙이다. 기록으로 옮기면 규칙이
지울 수 있는 이력 안에만 남는다(소유자 결정 D5, 2026-11-07).

고른 방법: docs/manual/reference/done-criteria.md로 옮기고 매뉴얼
README 표에 더한다. 게이트 여덟 개를 적은 원문 3·4번은 매뉴얼 규칙
(원칙 8, 목록을 복사하지 않음)에 맞춰 정본 config/ci/gates.json과
`ci:gate`를 가리키게 바꿨다. 작업 매뉴얼(docs/work/)은 하네스 세션이
만드는 중이라 이 변경은 개발 매뉴얼에 둔다.

위험: 하네스 세션이 docs/work/에 같은 기준을 두면 둘 중 하나를
가리키게 정리해야 한다.

검증: 문서만 바뀐다. 경로는 뒤의 verify:documentation 실행에서 본다.
2026-11-08 17:25:41 +09:00
DongHyeonka e632b230e3 docs: 옮긴 문서를 가리키는 링크와 경로를 새 위치로 고친다
문제: 앞 커밋이 기록·설계서·결정 기록을 옮겨서, 그 문서를 가리키는
상대 링크 182개와 살아 있는 문서·코드 주석의 경로 23곳이 없는 곳을
가리킨다.

고른 방법: 기계적으로 바꾼다.
- 상대 링크: 모든 .md(기록 포함)에서 옮기기 전 트리로 대상을 풀고,
  대상이나 문서 자신이 옮겨졌으면 새 위치 기준 상대 경로로 다시 쓴다.
  옮기기 전에도 없던 대상은 건드리지 않는다. 기록 본문에서 고친 것은
  링크 대상뿐이다(백엔드 1단계와 같은 예외).
- 경로 글자: 살아 있는 문서와 코드·설정 주석의 `docs/architecture/…`,
  `docs/superpowers/…`, `decisions/VD-…`를 새 경로로 바꾼다. 기록 본문과
  CHANGELOG.md는 쓴 때의 경로를 그대로 둔다. review-evidence.md와
  review-ledger.json의 `docs/superpowers/specs/…`는 이 트리가 아닌 검토
  작업 공간의 출처 표시라 그대로 둔다.

위험: 경로 글자를 바꾼 곳은 주석과 문서뿐이고 실행 코드의 경로 상수는
없다. 문서 지도(docs/README.md)의 옛 폴더 행은 뒤 커밋이 다시 쓴다.

검증: `git grep -n -E "docs/superpowers|architecture/decisions"`가 기록,
CHANGELOG.md, 출처 표시 두 곳, docs/README.md·README.md(뒤에서 다시
쓴다) 밖에서 0건.
2026-11-08 17:25:41 +09:00
DongHyeonka 99e76e8722 docs: 기록·설계서·결정 기록을 docs/history·docs/design·docs/adr로 옮긴다
문제: 프론트 docs/는 지금 동작을 설명하는 문서와 쓴 때의 기록이 한
폴더에 섞여 있다. docs/architecture/에는 현재 계약 10개와 목표 설계
14개, 결정 기록 VD 23개가 같이 있고, 설계서·계획서는 플러그인 이름
폴더(docs/superpowers/)에 있다. 문서 체계 규칙(design-docs
conventions/docs-system.md v1, 2026-11-07 소유자 결정)은 수명으로
나누고 폴더 이름을 백엔드와 같게 하라고 정한다.

고른 방법: 내용 변경 없이 git mv만 담는다. git이 이름 바뀜을 알아보고
리뷰어가 이동과 내용 변경을 따로 볼 수 있게 하려는 것이다. 참조 수정과
머리 블록은 다음 커밋들이 한다.
- docs/superpowers/specs → docs/design/, plans → docs/history/plans/
- docs/architecture/ 목표 설계 13개와 styling·testing의 목표 설계
  2개 → docs/design/<작성일>-<이름>-design.md (2026-07-30 결정 정본은
  이름 그대로)
- docs/architecture/decisions/VD-* → docs/adr/ (번호 유지)

위험: 이 커밋만으로는 옮긴 문서를 가리키는 링크와 경로가 깨진다.
다음 커밋이 고친다. 게이트가 읽는 파일(review-ledger.json,
review-evidence.md, adapter-remediation-ledger.md, INVENTORY.md)은
옮기지 않았다. docs/history/는 복사한 프로젝트가 지워도 된다는 약속
(tests/unit/deletable-history-documents.test.ts)이 있어서 코드가 읽는
파일을 둘 수 없다. SPEC.md는 공통 완료 기준을 매뉴얼로 옮긴 뒤 따로
옮긴다.

검증: git status가 이름 바뀜(R) 66개만 보인다.
2026-11-08 17:25:41 +09:00
donghyeon.kang 8327e22108 Merge pull request 'chore(layout): 정리 2단계로 샘플 역할을 옮기고 샘플을 지운다' (#12) from chore/layout-2-sample-removal into main 2026-11-08 07:52:57 +00:00
DongHyeonka ad3a071f61 docs(changelog): 라우트 런타임 음성 fixture의 진단 변경을 적는다 2026-11-08 14:37:52 +09:00
DongHyeonka 4917222049 test(removal): 제거 사본에서도 남는 명령으로 CI 계약 정리를 시험한다
removal-fixture.test.ts는 선택 recipe 제거 사본 안에서도 돈다. 정리 대상으로 고른
test:recipes가 그 사본에는 이미 없어 FE-GATE-020이 실패했다. 어느 제거 사본에도
남는 test:integration과 그 산출물로 바꿨다.
2026-11-08 14:37:41 +09:00
DongHyeonka e47a0ab23d fix(ci): 라우트 수와 상관없이 라우트 런타임 음성 fixture 진단을 고정한다
샘플 라우트를 지워 라우트가 3개가 되자 FE-GATE-003의 route-runtime 음성 fixture가
TS2740 대신 TS2739를 내 기대 진단과 어긋났다. tsc는 빠진 키가 많으면 TS2740,
적으면 TS2739를 낸다. fixture가 정확히 한 라우트만 빼도록 바꿔 어느 라우트 수에서나
TS2741이 나오게 하고 기대 진단을 맞췄다.
2026-11-08 14:37:40 +09:00
DongHyeonka 4e885c1d04 docs(changelog): 정리 1·2단계를 새 미출시 절에 적는다
정리 1단계(PR #11)와 2단계(샘플 역할 이전과 삭제)가 CHANGELOG에 없다.
다운스트림은 이 절을 보고 샘플 사본 처리와 기준선 재승인을 한다.

미출시 절 「48c7695b → 정리 단계」를 맨 위에 더했다. 「먼저 할 일」에
샘플 사본을 지우거나 자기 기능으로 옮기는 법, 레지스트리·CI 계약
기준선과 초기 JS 기록을 다시 받는 법, NOT_A_FEATURE 폴더 처리를 적고,
보안·계약 변경 표와 알려진 제한을 적었다. 절의 해시는 모두 이 브랜치
조상이다(git merge-base --is-ancestor로 확인).

위험: 두 다운스트림에 시험 병합을 하지 않아 충돌 수를 모른다.

검증: tests/unit/changelog-review-ids.test.ts 통과(desktop test:unit).
2026-11-08 14:08:05 +09:00
DongHyeonka 9c87cc4d22 chore(scale): 샘플 없는 템플릿에서 성장 기준선을 다시 잰다
config/scale/feature-shape-growth.json은 참조 기능 사본으로 잰 값이고,
기준 근거(feature-shape-ceilings.json의 axes)도 그 수치를 쓴다. 앞
커밋들이 측정 대상을 생성 기능으로 바꾸고 샘플을 지웠다.

샘플을 지운 트리(8c4b09b7, 수정 파일 없음)에서 node
scripts/scale/measure-feature-shape-growth.ts --sizes=0,25,100
--repeats=2 --write로 다시 쟀다. 기능당 tsc instantiation 약 10.1만,
tsc 메모리 약 31MB, 지연 JS 약 6.7KB와 9파일, 라우트 3개다. axes의
문장을 이 값과 firstFeatureGzipBytes에 맞췄다. 기준선 시험이 측정
대상(sourceFeature)도 본다.

위험: 시간 값은 desktop(i5-10400F, 부하 기록 포함)의 것이다. 400개 이상은
재지 않았다(D-18 선택).

검증(desktop): 같은 크기의 두 반복에서 컴파일러 수치가 같다.
tests/unit/feature-shape-growth.test.ts 통과.
2026-11-08 14:07:58 +09:00
DongHyeonka e3c8db48ae chore(features): 참조 기능과 예제 화면을 지우고 레지스트리를 다시 승인한다
소유자 결정(2026-11-07, design-docs repo-structure/README.md 3.4절)으로
템플릿 샘플을 지운다. 샘플이 맡던 시험 대상은 앞 커밋들이 옮겼다.

참조 기능과 예제 화면, 두 context, 그 시험, e2e 3개, 수동 접근성 기록
7개, 런타임 프로필 키, test:reference-feature(명령, 산출물, 게이트
참조), 커버리지 정책 행을 지웠다. removable-template-features 목록은
비우고 장치는 남겼다: test:sample-removal은 인자가 없으면 목록을
하나씩 지우고, 비면 SKIP을 출력하고 보고서에 건너뛴 사례를 남긴다.
기능 스위치 시험과 홈 시작 링크 스위치 시험은 시험 전용 fixture 기능으로
옮겼다. browser soak은 생성 기능을 넣은 빌드에서 돈다. 문서의 샘플
경로를 고쳤다. 날짜가 붙은 설계·리뷰 기록의 본문은 그대로 두었다.
레지스트리 기준선(update:registry-baseline, OWNER DongHyeonka), CI 계약
기준선과 workflow, 초기 JS 기록(194,354B, 17파일, 첫 기능 6,327B, 기능
539B, context 4B)을 다시 받았다.

위험: 레지스트리 행 삭제는 breaking이다. 샘플을 고쳐 쓰는 다운스트림은
수정/삭제 충돌을 만난다. 성능 lab의 기능 라우트 측정은 템플릿에
공개 기능 라우트가 없어 measured:false다. TEMPLATE_FIXTURE 출처는
플랫폼 코드에 남았다.

검증(desktop): check:types, lint, check:architecture, check:registries,
check:ci, verify:documentation, test:unit, test:component,
test:contract, test:integration, test:recipes, test:coverage(Risk
coverage PASS 378/378, 문턱 68개), test:e2e 183, test:a11y, test:visual,
test:storybook, test:browser-capabilities, test:feature-scaffold PASS(76
checks), test:sample-removal SKIP, build, check:bundle.
2026-11-08 14:07:58 +09:00
DongHyeonka b2042de9be test(scale): 규모 측정을 참조 기능 대신 생성 기능 사본으로 잰다
규모 측정(S4 3.1절 S-6)은 참조 기능을 복사해 이름을 바꿔 잰다.

create:feature의 planFeature로 사본마다 --with-create --keyed 기능
파일을 만든다(자기 계약 패키지와 topic, context당 200개). 초기 JS
기록에 firstFeatureGzipBytes를 더하고, context 비용은 둘째 기능을 새
context에 둘 때와 같은 context에 둘 때의 차이로 잰다. 옛 정의는 기능이
없는 템플릿에서 첫 기능의 공용 코드까지 context 비용으로 세어 5,788B로
상한 512B를 넘었다. 몇 바이트짜리 비용에는 기록 허용치 하한 16B를
둔다(빌드 ID에 따라 gzip이 1~2B 흔들린다). 이 트리(샘플이 아직 있는
상태)의 기록: 204,266B, 27파일, 첫 기능 797B, 기능 521B, context 12B.

위험: 성장 기준선(0·25·100개)은 샘플을 지운 트리에서 뒤 커밋이 다시
잰다. 이 커밋의 기준선 파일은 아직 참조 사본으로 잰 값이다.

검증(desktop): feature-shape-growth 등 4파일 57 passed, test:unit 통과.
2026-11-08 14:07:53 +09:00
DongHyeonka 794a51a37d test(e2e): 참조 기능 대신 생성 기능을 넣은 빌드로 기능 경로를 확인한다
참조 기능 e2e 3개가 "기능 하나가 실제 브라우저에서 라우트·폼·
저장까지 된다"를 맡는다. 청크 복구, 부트 실패, preload 시험도 설치된
기능에 기댄다.

S4 9.1절 (가)대로 한다. scripts/lib/generated-feature.ts가 저장소
사본에 create:feature order-feature --with-create --keyed를 만들고,
spec은 그 사본의 빌드를 띄워 돈다. 참조 e2e의 검사(로그인, 목록, 폼
검증·이탈 확인·320px, en-US, 저장과 멱등 키, 429 뒤 다시 시도, 결과
불명과 같은 키 재전송, 키보드 포커스, 상태별 axe)를 생성 기능에
옮겼다. 오래된 탭의 청크 복구는 생성 기능 목록 라우트를, 부트 실패는
생성 기능을 넣은 사본을, preload 시험은 생성 기능 실행부 청크를 쓴다.

위험: 생성 기능의 동작만 본다. 제품 기능은 자기 spec이 필요하다.
사본 빌드가 spec과 브라우저마다 돈다(빌드 1초 안팎).

검증(desktop): 샘플을 지운 최종 트리에서 test:e2e 183 passed,
test:a11y 통과.
2026-11-08 14:07:53 +09:00
DongHyeonka 01cac930e0 docs(manual): 샘플 대신 생성 기능 경로와 시험하는 코드 조각을 예제로 둔다
매뉴얼 예제 칸 14곳(S4 3.3절)과 산문 30여 곳이 참조 기능을
가리킨다. problem details(Envelope가 아닌 백엔드) 응답 매핑의 예는
참조 기능에만 있다.

생성기 출력이 그 모양을 만들면 그 경로로 바꿨다. 없으면 매뉴얼 안
코드 조각으로 썼다: problem details의 분류와 매핑(02 결정표 4절,
소유자 결정 D1), 도메인 모델, 검색값 스키마와 hook, 실패 행동 hook,
403 페이지 시험. 조각마다 manual-code-block 표식에 둘 경로를 적는다.
tests/unit/manual-code-blocks.test.ts가 저장소 사본에 create:feature
invoice-feature --with-create를 만들고 조각을 그 경로에 그대로 넣어
tsc(app, test), eslint, check:architecture, 그 기능 폴더의 vitest를
돈다. 조각의 동작은 tests/fixtures/manual-code-blocks/가 본다.

위험: 403 조각은 본문 없는 403으로 답한다. 공유 시나리오
forbidden-403(JSON 본문)은 jsdom + MSW에서 실행기의 본문 cancel이
끝나지 않아 화면이 로딩에 머물렀다. 실행기는 고치지 않았다. 사본에
이미 invoice-feature가 있는 프로젝트에서는 이 시험이 생성 단계에서
실패한다.

검증(desktop): test:unit 213 files 3096 passed(이 커밋까지),
verify:documentation PASS_SCOPED, lint 통과.
2026-11-08 13:51:55 +09:00
DongHyeonka b72cd7d4a7 test(fixtures): local-draft 샘플을 IndexedDB 소비자 fixture로 옮긴다
src/features/local-draft-feature는 기능이 아니라 IndexedDB recipe의
소비자다. 시험 5개와 recipe가 쓰고, 그래서 생성기에 NOT_A_FEATURE
예외가 있었다(S4 3.1절 S-3).

코드를 tests/fixtures/indexeddb-consumer/로 옮기고 import만 고쳤다.
NOT_A_FEATURE 표식은 이 폴더만 썼고 다운스트림 둘에도 없어 생성기에서
지웠다. 선언 없는 폴더는 밖으로 옮기라는 메시지로 실패한다. 매뉴얼
오류표, README, starter-experience, capability-consumer-experience,
patterns를 고쳤다.

위험: fixture는 기능 폴더 밖이라 기능 계층 규칙(dependency-cruiser)이
걸리지 않는다. recipe가 tests/ 아래 파일을 type import한다.

검증(desktop): test:contract, test:recipes, test:browser-capabilities,
test:unit 통과.
2026-11-08 13:51:55 +09:00
DongHyeonka e7210c71bf test(e2e): 예제 화면 대신 플랫폼 라우트에서 셸 동작을 확인한다
셸 동작을 보는 e2e(반응형, 스크롤 복원, 해시 링크, 타이포그래피,
건너뛰기 링크, 메뉴 이동, 운영 CSP, compact, en-US의 lang)가 지울 예제
화면을 열거나 그 메뉴를 누른다.

홈과 /examples/platform으로 옮겼다. 스크롤 복원은 계약 표가 그려진 뒤
스크롤하고, 해시 링크는 비동기 표보다 위에 있는 첫 절을 대상으로
한다. WebKit은 scroll anchoring이 없어 표 아래 대상이 1px 밀렸다.
갤러리 자체의 320px 리플로는 앞 커밋의 workshop 시험이 맡는다.

위험: 홈과 플랫폼 개요의 모양이 바뀌면 이 시험들의 대상도 바뀐다.

검증(desktop): 샘플을 지운 최종 트리에서 test:e2e 183 passed.
2026-11-08 13:51:54 +09:00
DongHyeonka c7e80f2f8a test(visual): 갤러리를 Storybook story로 옮기고 골든 대상을 바꾼다
예제 화면 /examples/ui·/examples/states가 visual 골든 2장과 갤러리
브라우저 시험의 대상이다. 2026-11-07 소유자 결정으로 예제 화면을
지우므로 그 역할을 먼저 옮긴다(design-docs repo-structure/
04-frontend-layout.md 9.2절 2단계 (1)).

두 갤러리 화면을 그대로 src/presentation/design-system/
galleries.stories.tsx로 옮겼다. 화면 단위 story(parameters.page)는
preview가 여백을 더하지 않아 앱 안과 같은 폭으로 그려진다. visual
설정은 Storybook 정적 빌드를 두 번째 web server로 띄우고
(TEST_VISUAL_WORKSHOP_PORT, 빌드 명령은 workshop 설정과 같은
scripts/lib/storybook-static.ts), 골든 2장은 그 story를 찍는다. 어두운
골든은 테마 선택기가 없어 시스템 dark(colorScheme)로 그린다. e2e의
갤러리 상호작용(텍스트 필드, 모달 포커스, 메뉴·탭·토스트, 열린 대화
상자 axe, 320px 리플로)은 tests/storybook/galleries.spec.ts로 옮겼다.

위험: 골든의 픽셀 색 허용치(threshold 0.2)는 그대로다. 미세한 토큰
변화는 옛 골든처럼 새 골든도 잡지 못한다.

검증(desktop): test:storybook 6 passed, test:visual 7 passed,
playwright-run-isolation 단위 시험 통과. 변이 확인: --color-action을
파랑→빨강으로 바꾸면 새 골든이 어두운 쪽 42,313px, 밝은 쪽 22,359px
차이로 실패했다. 옛 골든(main f33e4778)도 40,238px, 22,511px로 실패했다.
미세 변이(어두운 --color-danger red-500→600, 밝은 --color-danger-surface
색상각 25→145)는 옛·새 골든 모두 통과했다. 변이는 되돌렸다.
2026-11-08 13:51:54 +09:00
donghyeon.kang f33e4778bb Merge pull request 'chore(layout): 정리 1단계로 버려진 파일·이력·nginx 조각을 정리한다' (#11) from chore/layout-1-cleanup into main 2026-11-07 15:14:49 +00:00
DongHyeonka 121e11250a docs(operations): nginx 설정 예시를 지우고 호스트가 지킬 조건만 남긴다
문제: docs/operations/release-cache-rollback.md에 nginx 설정이 통째로
있다(보안 헤더 snippet과 server 블록, 「Example: nginx on a single
server」 절). CI는 그것을 돌리지 않고, 호스트 설정은 개발 repo의 일이
아니다(소유자 2026-11-07). ci-quality-gates.md의 runner 요구 절에도
호스트를 바꾸는 절차(AppArmor profile 본문, sysctl 명령)가 있다.

고른 방법:
- nginx 절을 지우고 같은 문서에 「운영 환경이 지켜야 할 조건」 19개를
  문장으로 쓴다. 조건마다 재는 쪽을 적었다: FE-GATE-019가 잰다(live
  모드, 값은 config/hosting/*.json) / 아무도 재지 않는다. 백엔드와 같은
  절 이름·같은 언어(한국어)다.
- 지운 설정을 한 줄씩 대조했다. snippet 6줄 → 6(값), always → 7;
  listen 443 ssl·server_name·인증서 → 1; http2 → 2; gzip·gzip_types →
  10, gzip_vary → 11; root current와 원자적 symlink 전환 → 17;
  index.html → 3·6; try_files fallback → 4·6; config.json·
  release-manifest.json → 5·6; 공유 /assets/·기간으로 지우기 → 18;
  없는 청크 404 → 12; immutable → 8; service-worker.js → 14·15;
  .map 404 → 16; Cache-Control에 always 없음 → 13; 기본 base path / →
  1; mime.types에 맡긴 Content-Type → 3·5·9·14. 롤백 때 동작은 19.
- static-delivery.md의 "nginx example" 문장은 이 절을 가리키게 고친다.
- ci-quality-gates.md: runner 요구(바이너리, systemd, cgroup, 비특권
  user namespace)는 게이트가 runner에 요구하는 조건이라 남긴다. 고치는
  방법 목록과 AppArmor profile 본문만 지우고 "고치는 방법은
  scripts/check-system-test-prerequisites.ts가 실패할 때 출력한다"로
  바꾼다. 그 스크립트가 같은 세 방법을 출력한다.
버린 대안: nginx 설정을 project-infra나 cicd-platform으로 복사하기.
아무도 시험하지 않는 복사본이 다른 repo에 생긴다(백엔드도 지웠다).

위험·한계: 아무도 재지 않는 부분이 있는 조건이 11개다(7, 8의 나머지 파일,
10의 나머지 청크와 CSS·JSON·SVG, 11, 12, 13, 15, 16의 호스트 쪽, 17의
전환 도중, 18, 19의 호스트 쪽). 지운 nginx 예시도 CI가 돌리지 않았으니
재지 않는 범위는 넓어지지 않았다. AppArmor profile 본문은 이 repo에서
없어진다. 필요하면 runner를 만드는 쪽 인프라 repo가 갖는다.

검증: git grep -n '^```nginx' 0줄. desktop(이 커밋 30a379f 트리, 로그
~/l1-layout-cleanup-logs/): verify:documentation PASS_SCOPED(새 절의
경로·script 이름·FE-GATE ID와 static-delivery.md의 링크 포함),
test:unit 3091 tests 통과.

Refs: design-docs repo-structure/04-frontend-layout.md 4절 I-3·I-4·I-11
2026-11-07 19:02:47 +09:00
DongHyeonka 429b8d8802 docs(history): 루트의 tasks/와 .superpowers/ 기록을 docs/history로 옮긴다
문제: 끝난 작업의 기록이 루트 폴더 둘에 따로 있다. tasks/는 2026-09-25
리뷰 수정 라운드(v0.2.0으로 끝남)의 계획·작업 목록·인계·레인 지시서와
레인 준비 스크립트 5개, .superpowers/는 2026-08-01 런타임 정합성 수정의
작업 보고 1개다. 읽는 코드는 없다(tests/unit/deletable-history-
documents.test.ts가 지킨다). 소유자가 2026-11-07 백엔드와 같이 이력
폴더로 옮기기로 정했다.

고른 방법:
- tasks/ → docs/history/plans/2026-09-25-review-fix-round/ (lanes/ 유지),
  .superpowers/sdd/2026-08-01-runtime-correctness-remediation/
  task-5-report.md → docs/history/evidence/2026-08-01-runtime-correctness-
  remediation/. 폴더 이름은 docs-system 2절과 백엔드를 따른다.
- .md 5개 맨 위에 docs-system 4.1절 머리 블록 9줄(빈 줄 포함, 백엔드와
  같은 모양)을 단다. 본문은 바꾸지 않았다: 블록 9줄을 빼면 옛 파일과
  바이트가 같다(cmp). setup-lane.sh는 실행 파일(첫 줄 shebang)이라 블록을
  달지 않고 그대로 옮긴다(R100). 같은 폴더 LANE-BRIEF.md의 블록이 그
  파일을 설명한다.
- 상태: 계획서 넷은 끝남. 기계 규칙(체크 상자가 모두 표시돼야 끝남)으로는
  plan·todo가 확인 안 함이지만, 이력이 라운드의 끝을 정한다(CHANGELOG
  0.2.0, 태그 v0.2.0 2026-09-27). 증거는 보관.
- 작성일: plan·todo는 2026-09-25. git이 처음 더한 날(ea0f01f,
  2026-09-24)은 이 파일이 앞 라운드(src 리뷰) 계획이던 때이고, 지금
  본문은 c5f379b(2026-09-25)가 통째로 다시 썼다. handoff는 본문 날짜 줄
  (2026-09-26 01:10), LANE-BRIEF는 git이 처음 더한 날(54ba358,
  2026-09-26), 보고는 git이 처음 더한 날(d9afccd, 2026-08-02).
- docs/README.md: 3절 지도에 history/ 행을 더하고 옛 경로 → 새 경로를
  적는다. 블록 첫 줄이 가리키는 「기록 문서의 머리 블록」 절(4절)을
  더한다. ../tasks/ 링크는 없앴다. README.md의 "Files you can delete
  after copying" 행도 docs/history/로 바꾼다.
- deletable-history-documents.test.ts: docs/history 패턴을 더하고
  tasks/ 패턴은 뺀다. 루트 tasks/가 없어져 그 패턴이 지킬 문서가 없고,
  남기면 제품의 "tasks/..." 라우트·폴더 문자열을 잘못 잡는다.
버린 대안: 옮긴 파일을 가리키는 다른 기록(docs/superpowers/plans/
2026-08-02-*.md, docs/reviews/2026-09-25-maturity-review/, SPEC.md)의
옛 경로를 고치기. 기록 본문은 고치지 않는다(docs-system 1절). 대신 지도
행에 옛 경로를 적었다.

위험·한계: SPEC.md는 이번에 옮기지 않는다. 27~37줄 「공통 완료 기준」을
작업 매뉴얼(docs/work/improve.md, 뒤 단계)로 옮긴 뒤 같은 폴더로 보낸다.
secret-scan-policy.json의 trackedRoots와 루트 경로 목록 7곳에는 tasks,
.superpowers가 없어 바꿀 것이 없다.

검증:
- 옮긴 .md 5개: 첫 9줄을 빼면 옛 파일과 cmp가 같다. git diff -M이
  R091~R100 rename으로 잡고 지운 줄은 0이다.
- desktop(네 커밋의 끝 30a379f, 로그 ~/l1-layout-cleanup-logs/):
  deletable-history-documents.test.ts는 지금 트리에서 통과하고, 테스트
  폴더에 "docs/history/plans"를 담은 파일 하나를 두면 그 줄을 내며
  실패한다. verify:documentation: PASS_SCOPED. test:unit 3091 tests 통과.

Refs: design-docs repo-structure/04-frontend-layout.md 2.1절, 9.2절;
design-docs conventions/docs-system.md 2·4절
2026-11-07 19:02:47 +09:00
DongHyeonka 0805910c47 chore(config): 아무도 읽지 않는 config/schemas의 JSON Schema 4개를 지운다
문제: config/schemas/에 산출물 JSON Schema 4개가 있다. 코드·테스트·
workflow·문서 어디서도 경로나 $id(ART-FE-FIELD-WEB-VITALS@1,
ART-FE-LAB@1, ART-FE-003@1, ART-FE-RUNBOOK-DRILL@2)로 읽지 않는다
(git grep, CHANGELOG·리뷰 기록 제외). 산출물을 실제로 검사하는 것은
scripts/contracts/release-artifacts.ts의 zod schema다. 그런데도
81701ad(2026-11-05)가 lab 칸을 더하면서 이 파일도 손으로 고쳤다. 읽는
곳 없는 사본을 맞추는 일이 생긴다.

schemas/의 생성 스키마와 비교: scripts/generate-artifact-schemas.ts가
만드는 4개(build-manifest, dependency-inventory, registry-snapshot,
supply-chain-verification)와 이름·대상이 겹치는 것이 없다. 그래서 각
파일을 그 산출물의 zod 정본과 대조했다.
- field-web-vitals ↔ fieldWebVitalsArtifactSchema: 최상위 칸 9개와
  context 칸 9개가 같다. zod가 더 엄격하다(window.days = 28,
  consentRequired = true, 숫자 범위, 하위 객체 strict).
- lab-performance ↔ labPerformanceArtifactSchema: zod는 context·metrics를
  아무 객체로 받는다. JSON만 context 필수 칸 7개, metrics 필수 칸 5개,
  fixtures 2개 이상을 적었다. context 칸 7개는
  scripts/lib/performance-budgets.ts evaluateLabBudget가 없으면 실패로
  판정한다. metrics 5칸과 fixtures 3개는 scripts/test-performance.ts가
  늘 만든다.
- release-verification ↔ releaseVerificationArtifactSchema: zod가 더
  엄격하다(artifact.releaseId 필수, fixture 칸 strict). JSON만 fixtures
  2개 이상을 적었다. scripts/verify-release.ts는
  config/release/coherence-fixtures.json의 4개를 쓴다.
- runbook-drill-record ↔ runbookRecordArtifactSchema: 칸이 같다. zod는
  result가 판정들의 합과 맞는지도 본다. JSON만 recoveryAssertions 4개
  이상을 적었다. scripts/drill-runbook.ts의 runbook 5개는 모두 4개를
  만든다.
JSON에만 있는 최소 개수 셋은 지금 만드는 쪽이 늘 채우지만 아무도
검사하지 않는다. 이 파일도 읽는 곳이 없어 지워도 검사가 줄지 않는다.

버린 대안: schemas/로 옮기거나 zod에서 생성하기. 읽는 곳이 없는 파일을
옮기거나 생성하면 지킬 것 없는 사본이 하나 더 생긴다. 스키마 자리를 한
곳으로 모으는 일은 3단계(schemas/ → config/schemas/)다.

위험·한계: 다운스트림이 이 파일을 외부 도구에 물렸다면 그쪽이 끊긴다.
템플릿 안에는 그런 곳이 없다.

검증: git grep으로 경로와 $id 넷을 찾아 0건(CHANGELOG·리뷰 기록 제외).
desktop(네 커밋의 끝 30a379f, 로그 ~/l1-layout-cleanup-logs/):
check:types, test:unit(212 files, 3091 tests), check:ci, lint exit 0.

Refs: design-docs repo-structure/04-frontend-layout.md 2.1절, 9.2절
2026-11-07 19:02:47 +09:00
DongHyeonka 85f941c44c chore(artifacts): 읽는 곳 없는 산출물 13개를 지우고 폴더째 무시한다
문제: .gitignore가 artifacts/를 확장자별로만 무시한다(*.json, *.xml,
*.txt, *.sarif, *.log). 규칙에 없는 확장자가 새어 들어와 화면 캡처 3개
(artifacts/local-preview/*.png)와 커버리지 보고서 10개
(artifacts/tests/coverage-gateway/)가 추적된다. 읽는 코드·게이트·문서는
없다(git grep 'local-preview', 'coverage-gateway' 0건, 리뷰 기록 제외).
0929/14-01이 찾았고 2026-11-06 리뷰까지 '일부'로 남았다.

고른 방법:
- 13개를 지운다.
- artifacts/를 폴더째 무시하고 .gitkeep 2개와 수동 a11y 기록
  (artifacts/tests/a11y-manual/*.md)만 다시 넣는다. git은 무시한 폴더
  아래 파일을 다시 넣지 못해서, 지나가는 폴더마다 다시 넣고 그 내용을
  다시 무시한다. 확장자·폴더별 옛 규칙은 모두 이 안에 들어가 지웠다.
- tests/unit/tracked-artifacts.test.ts가 git ls-files artifacts를 허용
  목록과 대조한다. git add -f로 넣은 파일도 잡는다.
버린 대안:
- artifacts/** 와 !artifacts/**/ 꼴: git에서는 같게 되지만
  verify:documentation이 .gitignore를 읽는 방식
  (scripts/verify-documentation-readiness.ts generated())이
  !artifacts/**/ 를 "artifacts 아래 전부 다시 넣음"으로 읽는다. 그러면
  문서가 이름 부르는 생성 산출물(artifacts/quality/... 등)이 없는 경로로
  실패한다(코드 읽기로 확인).
- 확장자 규칙에 *.png, *.html, *.info를 더하기: 다음 새 확장자에서 같은
  일이 난다.

위험·한계: a11y 기록 말고 사람이 쓴 파일을 artifacts/에 두면 이제
무시된다. 지금 추적 파일 12개는 모두 허용 목록 안이다. 다운스트림은 지운
13개를 고치지 않았으면 병합이 그대로 지운다.

검증(desktop, 네 커밋의 끝 30a379f에서 한 번. 커밋마다 따로 돌리지는
않았다. 로그 ~/l1-layout-cleanup-logs/):
- tracked-artifacts.test.ts: 지금 트리 통과. 지운 png 3개를 index에
  되돌리면 실패하고 그 3개를 낸다. 허용 목록 밖 note.txt를 git add -f
  하면 실패하고 그 파일을 낸다.
- 새 .gitignore를 빈 저장소에 두고 산출물 15개를 만든 뒤 git add -A:
  .gitkeep 2개와 a11y .md 1개만 추적된다(노트북).
- git ls-files artifacts: 12개(.gitkeep 2, a11y-manual/*.md 10).
- corepack pnpm test:unit: 212 files, 3091 tests 통과.
  verify:documentation: PASS_SCOPED. check:architecture, check:types,
  lint, check:ci, check:adapter-inventory: exit 0.

Refs: design-docs repo-structure/04-frontend-layout.md 9.2절 1단계
2026-11-07 19:02:47 +09:00
donghyeon.kang 48c7695b5b Merge pull request 'docs(reviews): 공용 리뷰 가이드 두 파일을 design-docs 정본 포인터로 바꾼다' (#9) from docs/review-guide-pointer into main pre-layout-2026-11-07 2026-11-07 08:22:40 +00:00
donghyeon.kang d359dde6d8 Merge pull request 'fix(review): 2026-11-06 리뷰를 기록하고 발견 25건을 고친다' (#8) from fix/maturity-review-2026-11-06 into main 2026-11-07 08:19:59 +00:00
donghyeon.kang 1cd9c07d43 Merge pull request 'fix(review): 2026-11-05 리뷰의 나머지 발견과 1103 이월을 고친다' (#7) from fix/maturity-review-2026-11-05-b into main 2026-11-07 08:19:55 +00:00
donghyeon.kang 8c376f1c29 Merge pull request 'fix: 2026-11-05 리뷰를 기록하고 P1 3건을 고친다' (#5) from fix/maturity-review-2026-11-05 into main 2026-11-07 08:19:51 +00:00
DongHyeonka 21dd9dc96c docs(reviews): 공용 리뷰 가이드 두 파일을 design-docs 정본 포인터로 바꾼다
문제
리뷰 가이드와 실행 체크리스트는 백엔드·프론트 두 템플릿이 함께 쓰는
리뷰 기준인데 프론트 repo의 docs/reviews/ 안에 있었다. 소유자가
2026-11-06 design-docs로 옮기기로 정했고(위임 루프 설계 결정 D13),
정본이 design-docs main 5f35810에 들어갔다. 이 repo의 사본이 그대로
남으면 두 곳에 본문이 생겨 서로 갈라진다.

고른 방법
- 두 파일을 정본 위치만 적은 포인터로 바꿨다. 정본 경로는 design-docs
  저장소 기준(conventions/...)으로, 링크 없이 코드 표기로 적었다.
  다른 저장소라 상대 링크는 이 checkout에서 따라갈 수 없다.
- 포인터에 절 번호가 정본에서도 같다는 것과, 옮기기 전 마지막 판을
  읽는 git show 명령(가이드 003832b6, 체크리스트 752a61f2)을 적었다.
  정본과 이 repo 판의 차이는 맨 위 "옮긴 기록" 블록과 서로 가리키는
  링크뿐이라 절 번호는 바뀌지 않았다.
- 파일 이름과 위치는 그대로 뒀다. CLAUDE.md와 지난 리뷰 문서가 이
  경로를 가리키므로 링크가 끊기지 않는다.
- docs/README.md의 reviews/ 행을 "가이드는 design-docs로 옮겼고
  여기에는 포인터만 있다"로 고쳤다.
- 버린 대안: 두 파일 삭제. CLAUDE.md 링크와 지난 리뷰 문서의 가이드
  경로가 끊긴다. CLAUDE.md는 소유자 승인 대상이라 이 커밋에서 바꾸지
  않는다.

위험과 한계
- design-docs를 받지 않은 환경(다운스트림 복사본, CI)에서는 정본을
  열 수 없다. 이력이 있는 checkout은 git show 명령으로 옛 판을 읽는다.
- CLAUDE.md는 여전히 포인터 파일을 리뷰 기준으로 가리킨다. 링크를
  design-docs로 바꿀지는 소유자가 정한다.
- verify:documentation은 docs/README.md 1절에서 링크한 문서만 보므로
  포인터 두 파일 안의 경로는 검사하지 않는다.

검증
- desktop에서 corepack pnpm verify:documentation, corepack pnpm
  test:unit 통과. 로그는 desktop ~/d13-review-guide-pointer-logs/.
- 기준 브랜치: PR #8 끝 fix/maturity-review-2026-11-06(1141969f).
2026-11-07 11:18:42 +09:00
DongHyeonka 1141969f55 docs(review): 1106 조치의 확인 결과와 diff·마지막 리뷰 처리를 적는다
문제: 리뷰 README 16절에 확인(16.5)이 비어 있다. 그 뒤 diff 리뷰(DR-01~06),
마지막 리뷰(FR-01~05)와 메인 세션 결정 D10 보완·보완 2도 적혀 있지 않다.

고른 방법:
- 16.2절에 D10 보완(`80e7f1d6`)과 보완 2(`b41990cd`) 행을 더한다. 둘 다 메인 세션
  결정이고 사용자가 뒤집을 수 있다고 적는다.
- 16.4절의 다섯 발견 행에 DR·FR 수정 해시를 더한다.
- 16.5절: `5cfc3a65`, `f1734913`, DR 수정, `59b2ccb5`, FR-01 수정에서 돌린 검사와
  돌리지 않은 것을 적는다.
- 16.6절: 해시 대조를 끝 `8b8b6c54` 기준으로 다시 돌린 결과로 바꾼다.
- 16.7절(diff 리뷰): DR-01~05는 고쳤고 DR-06은 이유와 함께 남긴다. DR-02에 메인
  기준보다 하나 더한 규칙(`-`가 든 이름만)과 그 이유, 뒤집는 법을 적는다.
- 16.8절(마지막 리뷰): FR-01은 메인 세션에 먼저 알린 뒤 고쳤다. 등급은 Medium·P2이고,
  리뷰어가 High로 본 이유도 같이 적는다. FR-02는 계약 문서 한 줄과 백엔드 pin grep
  결과를 적는다. FR-03~05는 남긴다.

위험·한계: 이 커밋 자체의 문서 검사 결과는 이 문서에 적을 수 없다. 메인 세션 보고에
적는다. 1~15절은 리뷰 때 그대로다.

검증: desktop batch에서 확인.
bash /tmp/claude-gates/r6/scripts/docs-check.sh
git merge-base --is-ancestor <해시> 8b8b6c54 (16.6절)

Refs: 1106/03-01 (diff review DR-01, final review FR-01·FR-02), 1106/14-02
2026-11-06 08:32:45 +09:00
DongHyeonka 8b8b6c541c chore(review): 1106 마지막 리뷰 FR-01 조치 브랜치를 합친다 2026-11-06 08:27:44 +09:00
DongHyeonka 57ffcc96ae docs(changelog): 재전송 결과 불명 해제가 짝 백엔드 표 code만 본다고 적는다
문제: 1106 절의 03-01 행, "먼저 할 일" 2단계, 03-03 행, 알려진 제한 03-01
줄은 입력 검증(kind VALIDATION_REJECTED)이 재전송 뒤 결과 불명을 푼다고
적는다. b41990c 뒤에는 짝 백엔드 표의 400 VALIDATION_FAILED와 400
IDEMPOTENCY_KEY_INVALID만 푼다. 6142cc8은 VALIDATION_FAILED가 요청 내용 검사여야
한다는 전제를 계약 문서 6.1절에 적었다.

고른 방법: 그 행들만 고치고 두 커밋 해시를 커밋 칸에 더한다. 참조 기능처럼
problem details를 읽는 기능의 422 입력 검증이 결과 불명으로 남는 것을 알려진
제한 03-01 줄에 적는다.
버린 대안: 수정 커밋에 함께 넣기(그 커밋 자신의 해시를 적을 수 없다).

위험·한계: 문서만 바꾼다. 해시 대조는 머리말의 사람 단계다(1106/14-02).

검증: desktop batch에서 확인. node scripts/run-vitest.ts run
tests/unit/changelog-review-ids.test.ts

Refs: 1106/03-01 (final review FR-01), 1106/03-01 (final review FR-02)
2026-11-06 08:26:48 +09:00
DongHyeonka 6142cc8e08 docs(contracts): 재전송을 푸는 VALIDATION_FAILED는 요청 내용 검사여야 한다고 적는다
문제: b41990c 뒤 같은 키 재전송이 400 VALIDATION_FAILED로 거절되면 훅과 폼이
첫 요청도 거절된 것으로 보고 결과 불명을 푼다. 백엔드가 시각이나 데이터베이스를
읽는 규칙을 VALIDATION_FAILED로 내면, 첫 요청이 적용된 뒤의 재전송도 이 답을
받을 수 있다. 계약 문서 6.1절은 이 전제를 적지 않는다(최종 리뷰 FR-02).

고른 방법: 6.1절의 재전송 규칙 옆에 한 문장을 더한다. VALIDATION_FAILED는
요청 내용만 보는 검사여야 하고, 시각이나 데이터베이스를 읽는 규칙은 기능이
선언한 code로 내며 그 code는 결과 불명을 풀지 않는다.
버린 대안: 프론트에서 VALIDATION_FAILED도 결과 불명으로 남기기(메인 세션
결정 "D10 보완 2"가 이 code를 푸는 쪽으로 정했다).

위험·한계: 문서 규칙이다. 백엔드에서 이것을 막는 검사는 없다(6.1절 끝의 남은
위험과 같다).

검증: desktop batch에서 확인. corepack pnpm verify:documentation, node
scripts/run-vitest.ts run tests/unit/backend-contract-pin-document.test.ts

Refs: 1106/03-01 (final review FR-02)
2026-11-06 08:25:56 +09:00
DongHyeonka b41990cdd5 fix(query): 재전송 거절의 결과 불명 해제를 짝 백엔드 표 code로만 정한다
문제: 80e7f1d의 isRefusedOnEveryAttempt는 kind가 VALIDATION_REJECTED면 code를
보지 않고 참을 돌려준다. 그 kind는 기능의 mapProblem이 정한다. 생성기는
선언한 <FEATURE>_INVALID를 VALIDATION_REJECTED로 옮기고
(scripts/create-feature-write-slice.ts mapProblem), 참조 기능 gateway는 code와
상관없이 모든 422를 그렇게 옮긴다(reference-http-gateway.ts). 그래서 기능이
선언한 code나 422 IDEMPOTENT_REQUEST_MISMATCH로 끝난 같은 키 재전송이 결과
불명을 푼다. 함수 주석, CHANGELOG, 런북 6.3-4는 이것들이 결과 불명으로
남는다고 적는다. 기존 테스트는 mapProblem 없이 실패를 만들어 이 길을 타지
않았다(최종 리뷰 FR-01).

고른 방법(메인 세션 결정 "D10 보완 2"): 재전송 거절은 짝 백엔드 표의 code일
때만 결과 불명을 푼다. 지금은 400 VALIDATION_FAILED와 400
IDEMPOTENCY_KEY_INVALID다(REFUSALS_OF_EVERY_ATTEMPT, code와 status 함께). kind
줄을 지우고 kind로 입력 검증을 말하던 주석과 런북 6.3-4를 고쳤다. 기능 code는
상태 규칙일 수 있어 mapProblem이 정한 kind를 믿지 않는다. 400
VALIDATION_FAILED는 필드 목록이 있든 없든 전처럼 푼다.
테스트: 훅의 결과 불명 유지 it.each에 mapProblem 모양(VALIDATION_REJECTED +
선언 code, VALIDATION_REJECTED + 422 IDEMPOTENT_REQUEST_MISMATCH) 두 행을 더했다.
참조 페이지에서 422 재전송이 필드 오류와 다시 저장을 보인다던 테스트를, 결과
불명이 남고 확인이 보이는 테스트로 바꿨다. 리뷰가 요청한 대로 다시 마운트한 폼이
다른 값을 보이는 채 재전송해 422 IDEMPOTENT_REQUEST_MISMATCH를 받으면 결과
불명과 확인 버튼이 남는 테스트를 더했다.
버린 대안: kind 줄을 남기고 기능 선언 code만 빼기(실행기는 code가 선언인지
폼과 훅에 알리지 않는다).

위험·한계: 참조 기능처럼 problem details를 읽는 기능의 422 입력 검증은 재전송
뒤 결과 불명으로 남는다. 출구는 결과 불명 화면의 확인이다. 리뷰 실험 03-R1
X1~X3·X5는 그대로 키가 모두 key-1이어야 한다. CHANGELOG는 다음 커밋이 적는다.

검증: desktop batch에서 확인. node scripts/run-vitest.ts run
tests/component/application-mutation-admission.test.tsx
tests/features/reference-feature/reference-page.test.tsx
tests/component/form-foundation.test.tsx tests/unit/backend-envelope.test.ts,
리뷰 실험 03-R1 패치를 이 커밋에 적용

Refs: 1106/03-01 (final review FR-01)
2026-11-06 08:25:28 +09:00
DongHyeonka 59b2ccb5e3 docs(changelog): diff 리뷰 검사 조치 세 행에 커밋 해시를 적는다
문제: diff 리뷰 DR-02·DR-04·DR-05 조치(`eb03dab`, `efe11f1`, `95141f1`)가
CHANGELOG 1106 절의 16-01·07-02·11-01 행을 고쳤지만 커밋 칸에 자기 해시를
적지 못했다. 같은 커밋 안에서는 자기 해시를 알 수 없다.

고른 방법: 합친 뒤 세 행의 커밋 칸에 해시를 더한다. 문장은 바꾸지 않는다.

위험·한계: 없다. 세 해시는 `git merge-base --is-ancestor`로 이 브랜치 끝의
조상임을 확인했다.

검증: desktop batch에서 확인.
node scripts/run-vitest.ts run tests/unit/changelog-review-ids.test.ts

Refs: 1106/16-01 (diff review DR-02), 1106/07-02 (diff review DR-04), 1106/11-01 (diff review DR-05)
2026-11-06 08:05:07 +09:00
DongHyeonka 3abe28e535 chore(review): 1106 diff 리뷰 검사 조치 브랜치를 합친다
# Conflicts:
#	CHANGELOG.md
2026-11-06 08:04:49 +09:00
DongHyeonka 591dd31a21 chore(review): 1106 diff 리뷰 폼 조치 브랜치를 합친다 2026-11-06 08:04:09 +09:00
DongHyeonka d06a52a953 docs(changelog): 재전송 결과 불명 규칙의 보충과 다시 마운트한 폼의 확인을 적는다
문제: 1106 절의 03-01·03-03 행과 "먼저 할 일" 2단계, 알려진 제한은 같은 키
재전송의 쓰기 전 거절을 모두 결과 불명으로 적는다. 80e7f1d 뒤에는 같은 요청이
매번 받는 거절(입력 검증, 400 VALIDATION_FAILED, 400 IDEMPOTENCY_KEY_INVALID)이
결과 불명을 푼다. 08-01 행은 다시 마운트한 폼의 확인이 "지금 값으로 성공을
정한다"고 적지만 145be2d 뒤에는 값을 건드리지 않는다.

고른 방법: 그 행들만 고치고 두 커밋 해시를 커밋 칸과 괄호에 더한다. 기능이
선언한 결정적 거절이 결과 불명으로 남는 것은 알려진 제한 03-01 줄에 적는다.
버린 대안: 각 수정 커밋에 함께 넣기(그 커밋 자신의 해시를 적을 수 없다).

위험·한계: 문서만 바꾼다. 해시 대조는 머리말의 사람 단계다(1106/14-02).

검증: desktop batch에서 확인. node scripts/run-vitest.ts run
tests/unit/changelog-review-ids.test.ts

Refs: 1106/03-01 (diff review DR-01), 1106/08-01 (diff review DR-03)
2026-11-06 08:02:48 +09:00
DongHyeonka 145be2df13 fix(forms): 다시 마운트한 폼의 확인은 보내지 않은 입력을 저장됨으로 두지 않는다
문제: 1106/08-01(fbaaaee)은 제출한 값이 없는(저장 중에 떠났다 다시 마운트한)
폼에서 settleApplied가 화면의 지금 값으로 성공을 정한다. 그 값은 보낸 적이
없다. 사용자가 결과 불명 동안 새 항목을 입력하고 앞의 저장을 "변경됨으로
확인"하면 "저장했습니다"와 함께 입력이 지워진다(기본 resetOnSuccess).
resetOnSuccess: false인 폼은 그 값이 기준값이 되어 dirty와 이탈 확인이 꺼진다
(diff 리뷰 DR-03).

고른 방법: 리뷰의 최소 방향대로, 제출한 값이 없으면 결과(success)와 포커스
이동만 한다. 값·기준값·touched는 건드리지 않고, 오류 표시만 비운다. 08-01의
완료 기준(확인 뒤 "저장했습니다."가 보이고 포커스가 feedback 안)은 그대로다.
버린 대안: 지금 값이 기본값과 같을 때만 정리하기(같은 결과에 분기가 하나 더
는다).

위험·한계: 다시 마운트한 폼에서 확인한 뒤 입력이 남아 있으면 dirty가 남아,
생성 기능 작성 페이지의 확인 뒤 목록 이동이 이탈 확인 창을 띄운다. 보내지
않은 입력을 지키는 쪽이다. CHANGELOG는 다음 커밋이 적는다.

검증: desktop batch에서 확인. node scripts/run-vitest.ts run
tests/features/reference-feature/reference-page.test.tsx
tests/component/form-foundation.test.tsx

Refs: 1106/08-01 (diff review DR-03)
2026-11-06 08:01:53 +09:00
DongHyeonka 80e7f1d63a fix(query): 같은 요청이 매번 받는 거절로 끝난 재전송은 결과 불명을 푼다
문제: 1106/03-01(2568587)은 결과 불명 요청을 같은 키로 다시 보낸 시도가
NOT_APPLIED·NOT_STARTED로 끝나면 이유와 상관없이 결과 불명과 키를 남긴다.
같은 요청이 매번 받는 거절(400 VALIDATION_FAILED, 400 IDEMPOTENCY_KEY_INVALID,
필드 목록이 있는 입력 검증)도 같다. 폼은 필드 오류를 버리고 "잠시 뒤 같은
요청으로 다시 보내 주세요"만 보인다. 저장은 꺼져 있고 다시 보내면 같은 400이
온다. 출구는 사실이 아닌 "변경됨으로 확인"이나 새로고침뿐이다. 815ea58
(1106/03-03)이 같은 길을 IDEMPOTENT 쓰기로 넓혔다(diff 리뷰 DR-01).

고른 방법(메인 세션 결정, D10 보충): 같은 키 재전송은 그 결과가 첫 요청에
무슨 일이 있었는지 보여 줄 때만 결과 불명을 푼다.
- 성공·APPLIED_CONFIRMED: 저장된 답의 재생이다. 지금처럼 푼다.
- 같은 요청이라 첫 요청도 받았을 거절: 푼다. src/contracts/errors.ts에
  isRefusedOnEveryAttempt를 두었다. effect NOT_APPLIED이고, kind
  VALIDATION_REJECTED(필드 목록이 있는 입력 검증)이거나 code·status가
  REFUSALS_OF_EVERY_ATTEMPT(400 VALIDATION_FAILED, 400 IDEMPOTENCY_KEY_INVALID)다.
- 그 밖(429, 401, 403, 503 RATE_LIMIT_*, 422 IDEMPOTENT_REQUEST_MISMATCH(키가
  이미 서버에 닿아야 나온다), 기능이 선언한 code(바뀌는 상태의 규칙일 수
  있다), IDEMPOTENT 쓰기의 404·412 같은 다른 code, NOT_STARTED): 지금처럼
  결과 불명과 키를 남긴다. 어느 쪽인지 모르는 code는 남긴다.
훅(resendLeavesUnknown)과 폼(resendLeftUnknown)이 같은 함수를 부른다. 폼은 푼
경우 처음 저장과 같이 보인다(필드 오류, 다시 받는 저장, 고친 값은 새 키).
남긴 경우 결과 불명 화면(확인·다시 보내기)이 그대로라 폼이 영영 막히지
않는다. 표는 backend-envelope.ts REFUSED_BEFORE_WRITE의 부분집합이어야 하고,
표의 나머지 행은 다른 쪽으로 분류된다. backend-envelope 단위 테스트가 둘을
대조해, 표에 새 행이 생기면 이 분류를 정할 때까지 실패한다. presentation은
adapters를 import할 수 없어(.dependency-cruiser.json) 판정을 contracts에 둔다.
버린 대안: 일시 거절(NOT_STARTED, retryable, RATE_LIMITED, RATE_LIMIT_*)만
남기기(diff 리뷰 안). 401·403과 422 IDEMPOTENT_REQUEST_MISMATCH, 기능 선언
code를 풀어 버린다. AppFailure에 새 칸을 더해 실행기가 표시하기(계약 타입과
실행기·바인딩을 함께 바꾼다).

위험·한계: 기능이 선언한 결정적 거절(생성 기능의 400 <FEATURE>_INVALID)은
어느 쪽인지 알 수 없어 결과 불명으로 남는다. 출구는 결과 불명 화면의
확인이다. 필드 목록이 있는 NOT_APPLIED는 기능 선언 code여도 입력 검증으로
본다. 리뷰 실험 03-R1 X1~X3·X5(503·429·NOT_STARTED)는 그대로 키가 모두
key-1이어야 한다. 런북 6.3-4를 고쳤다. CHANGELOG는 다음 커밋이 적는다.

검증: desktop batch에서 확인. node scripts/run-vitest.ts run
tests/component/application-mutation-admission.test.tsx
tests/component/form-foundation.test.tsx
tests/features/reference-feature/reference-page.test.tsx
tests/unit/backend-envelope.test.ts, 리뷰 실험 03-R1 패치를 이 커밋에 적용

Refs: 1106/03-01 (diff review DR-01)
2026-11-06 08:00:56 +09:00
DongHyeonka 95141f1d85 docs(a11y): 한 자원 GET을 부르지 않는 라우트는 자기 paramsSchema를 둔다고 적는다
문제: 9c4cddc의 report는 "로그인 라우트의 paramsSchema = 한 자원 GET의
입력 스키마"만으로 실패 화면 기록을 기대한다. 그 라우트의 페이지가 그
GET을 실제로 부르는지는 보지 않는다. 손으로 쓴 기능이 하위 항목 작성 폼
(`/things/:thingId/parts/new`)의 paramsSchema로 상세 GET과 같은
ThingParams를 쓰면, spec은 한 자원 응답을 보지 못해 기록을 남기지 않고
report가 `a11y.json not written:`으로 FE-GATE-009를 실패시킨다. 그런데
errors.md는 "spec의 기록 호출을 본다. 기능 파일은 고치지 않는다"고만
안내했다. 이 경우 고칠 곳은 기능의 라우트 스키마 ID다.

고른 방법: 리뷰의 첫 방향. report 판정은 그대로 두고 안내를 고친다.
errors.md 행이 두 원인(spec이 기록을 놓침 / 페이지가 그 GET을 부르지
않음)과 각각 고칠 곳을 적는다. 매뉴얼 01 6단계에 같은 경우와 고치는 법
(그 라우트에 자기 paramsSchema)을 더했다. CHANGELOG 1106 절 11-01 행에
같은 줄을 더했다. report의 실패 문장 끝에도 같은 안내를 붙였다. 판정
조건과 문장 앞부분은 그대로라 단위 테스트의 기대(`stringContaining`)도
그대로다.
버린 대안: spec이 "기대했지만 보지 못함"을 따로 기록하고 report가 그
경우를 다르게 다룬다. report 판정이 바뀌어 이번 범위(문서) 밖이다.

위험·한계: 같은 스키마를 쓰면서 그 GET을 부르지 않는 라우트는 여전히
실패한다. 안내로만 풀린다. 그 라우트에 스키마를 따로 두면 FE-REG-SCHEMA
행과 route codec이 하나씩 는다.

검증: desktop batch에서 확인. 테스트 없음(문서와 실패 문장 끝).
corepack pnpm verify:documentation
node scripts/run-vitest.ts run tests/unit/a11y-report.test.ts
tests/unit/changelog-review-ids.test.ts

Refs: 1106/11-01 (diff review DR-05)
2026-11-06 07:59:04 +09:00
DongHyeonka efe11f1581 test(contracts): 탐침이 닿지 않는 스키마는 방향만 요구한다
문제: e7b1b01 뒤 정책 테스트는 HTTP 자리 스키마의 행이
unknownFieldPolicy를 빼면 실패하고, 적으면 탐침 결과와 비교한다. 탐침이
객체에 닿지 못하는 검증기(두 탐침을 모두 루트에서 거절: `responseBody:
"NONE"` 출력의 z.undefined(), 문자열·null 본문)는 결과가 UNREACHED다.
행 타입은 REJECT_UNKNOWN·STRIP_UNKNOWN만 받으므로, 그런 operation은 행을
어떻게 적어도 통과하지 못한다. 칸을 빼면 `row states no
unknownFieldPolicy`, STRIP_UNKNOWN을 적으면 `row STRIP_UNKNOWN, validator
UNREACHED`다. 템플릿에는 그런 operation이 없어 다운스트림에서 난다.

고른 방법: 리뷰의 가장 작은 방향. 탐침 결과가 UNREACHED인 자리는 정책
비교에서만 빼고, direction은 그대로 요구한다. 두 검사를 슬롯·행을 받는
함수(directionProblems, policyProblems)로 꺼내, 설치된 descriptor 검사와
가짜 스키마 검사가 같은 함수를 쓴다. 새 describe가 z.undefined() 같은
NoContent 검증기로 탐침이 UNREACHED인지, 행이 direction을 빼면 실패하는지,
정책을 빼거나 적어도 통과하는지 본다. 매뉴얼 01, errors.md, CHANGELOG
1106 절의 먼저 할 일 1과 07-02 행에 적었다.
검사를 느슨하게 한 것이 아닌 이유: 탐침은 객체가 없는 스키마의 모르는
필드 정책을 판정할 수 없다. 그 자리의 비교는 맞는 답이 없는 질문이었다.
e7b1b01 전에는 칸을 빼면 이 자리 전체를 건너뛰었다. 지금은 direction을
요구하므로 그때보다 넓다. 객체에 닿는 스키마의 정책 비교는 그대로다.
버린 대안: 행 타입에 객체가 아닌 본문용 값을 더한다. src/contracts의
SchemaDefinition 모양, 분류기, 기준선이 함께 바뀐다.

위험·한계: 행이 UNREACHED 스키마에 적은 정책 값은 아무도 검사하지 않는다.
루트에서 이슈 하나로 거절하는 union(zod `invalid_union`, 예:
strict 객체 | null)도 UNREACHED가 되어 정책 비교에서 빠진다(추론, 실행하지
않음). 고친 곳이 테스트 파일 자신이라 RED는 테스트 파일만으로
만들 수 없다.

검증: desktop batch에서 확인.
node scripts/run-vitest.ts run tests/unit/schema-metadata-policy.test.ts

Refs: 1106/07-02 (diff review DR-04)
2026-11-06 07:58:07 +09:00
DongHyeonka eb03dabdfd fix(removal): spec 본문 잔여를 적힌 그대로, -가 든 이름만 찾는다
문제: af3344b가 더한 Playwright spec 본문 검색은 대소문자를 무시하고
`_`를 이름 경계로 봤다(`(?<![A-Za-z0-9-])…(?![A-Za-z0-9-])`, `i`).
create:feature는 한 단어 ID(`messages`, `reports`)를 받고 폴더 이름도
ID와 같다. 그래서 `messages` 기능을 지우면 템플릿 자신의
tests/e2e/accessibility.spec.ts(`KO_MESSAGES`)와 scrollbar-gutter
visual spec이 잔여로 잡혀 드릴이 실패한다. `status`·`reports`는 템플릿
spec 여러 개가 평범한 단어로 쓴다. errors.md는 목록에 템플릿 파일이
나오면 템플릿 결함이라 적으므로 제품은 고칠 곳이 없다.

고른 방법: 메인 세션 기준대로 적힌 그대로(대소문자 구분) 찾고, 경계는
식별자 문자 `[A-Za-z0-9_-]`다. 폴더 이름이 ID와 다르면 같은 규칙을 쓴다.
그런데 이 둘만으로는 `status`·`reports`가 0건이 되지 않는다. 템플릿
spec에 `status: 200`, `getByRole("status")`, 테스트 제목의 "reports"가
있다(git grep). `getByRole("status")`는 따옴표 안 한 단어라 따옴표나
문맥 규칙으로도 실제 참조와 구별되지 않는다. 그래서 `-`가 든 이름만 spec
본문에서 찾는다. 한 단어 ID·폴더 이름은 spec 본문 검색에서 빠진다.
검사를 좁히는 변경이지만 이 발견이 바로 그 거짓 양성이다. 거짓 양성은
제거를 막고 고칠 길이 없는 반면, 빠지는 쪽(한 단어 ID만 본문에 적은
spec)은 1106/16-01 전처럼 다음 CI의 브라우저 게이트가 잡는다.
테스트: 템플릿의 spec 파일 전부를 사본에 옮겨 `product-feature`,
`messages`, `status`, `reports`로 돌리면 잔여 0건이다. 적힌 그대로의
ID와 다른 폴더 이름(`invoice-docs`)은 잔여이고, `Invoice-Feature`와
`invoice-feature_v2`는 아니다. 매뉴얼 01 11단계, errors.md, CHANGELOG
1106 절의 16-01 행·확인 2·알려진 제한을 고쳤다.
버린 대안: 따옴표나 `/features/` 문맥만 센다. `getByRole("status")`가
남고, `test.describe("invoice-feature")` 같은 실제 잔여도 문맥에 따라
빠진다. 한 단어 ID를 막는 생성기 규칙은 이 수정 범위 밖이다.

위험·한계: `-`가 든 흔한 이름(예: `read-only`)을 ID로 쓰면 템플릿 spec이
그 이름을 쓸 때 다시 거짓 양성이 난다. 템플릿 spec 0건 테스트는 네
ID만 본다. src 쪽 부분 문자열 검색(1105/16-04)은 그대로다. CHANGELOG
행의 커밋 칸에는 이 커밋 해시를 아직 적지 않았다(같은 커밋에 자기 해시를
적을 수 없다).

검증: desktop batch에서 확인.
node scripts/run-vitest.ts run tests/unit/feature-residue.test.ts
node scripts/run-vitest.ts run tests/unit/changelog-review-ids.test.ts

Refs: 1106/16-01 (diff review DR-02)
2026-11-06 07:56:30 +09:00
DongHyeonka f173491348 docs(review): 1106 조치의 결정·통합 문제·발견별 상태를 적는다
문제: 2026-11-06 리뷰 뒤 수정 라운드의 결정(D9·D10)과 발견 25건·1103/15-02의
상태가 리뷰 README에 없다. `docs/operations/performance-evidence.md`는 D9 결정
기록으로 이 README를 가리킨다. 14-02의 완료 기준은 "다음 통합 기록에 해시
대조 결과가 있다"다.

고른 방법: 1105 README 16절과 같은 모양으로 16절을 더한다. 방법(배치 70개),
결정(D9·D10은 메인 세션 결정이고 사용자가 뒤집을 수 있다고 적음, D8은 결정
대기, D1~D3·D11은 그대로), 통합에서 생긴 것(08-03 첫 수정, 초기 JS 재기록),
발견별 상태, 해시 대조 결과를 적는다. 머리 인용에 16절을 가리키는 줄 하나를
더했다. 1~15절은 리뷰 때 그대로 둔다. 16.5절(확인)은 이 커밋을 포함한
끝에서 돌린 결과라 다음 커밋에 적는다.

위험·한계: 해시 대조는 노트북에서 git으로 했다. 리뷰 문서는 history라
verify:documentation이 내용을 보지 않는다.

검증: desktop batch에서 확인.
bash /tmp/claude-gates/r6/scripts/docs-check.sh
git merge-base --is-ancestor <해시> 9b19f753 (16.6절)

Refs: 1106/14-02, 1106/15-01, 1106/03-01
2026-11-06 07:40:38 +09:00
DongHyeonka 9b19f753da chore(review): 1106 CHANGELOG 절 브랜치를 합친다 2026-11-06 07:39:17 +09:00
DongHyeonka 39aab7e30a docs(changelog): 1106 조치 절을 적는다
문제: 2026-11-06 리뷰 조치 27개 커밋(`302d3a5..5cfc3a65`)이 CHANGELOG에
없다. 몇 커밋은 [계약] 행을 CHANGELOG 담당에게 남겼다(13-01 기준선,
02-01 포트 옵션, 03-01 문구 키, 03-03 `resendSafe`, 04-01·04-02, 01-01의
백엔드로 넘김).

고른 방법: 아래 1105 절 위에 새 미출시 절을 둔다. 범위는 `bbde570`(PR B
끝) → 브랜치 `fix/maturity-review-2026-11-06`이다. 이유:
- 머리말 규칙상 절마다 절 머리에 범위를 적고, 그 절의 해시는 모두 그
  범위에 있다. 1105 절에 합치면 그 절의 범위(`409d72e` → 11-05-b)와 "해시는
  모두 범위 안" 문장이 틀린다.
- 1105 절은 그 범위 끝 `bbde570`의 상태다. 리뷰도 지난 절의 값을 범위 끝
  값으로 본다(1106 15 영역의 1103/15-02 판정). 그래서 이 범위가 1105 절의
  "지금 값"을 바꾼 것(초기 JS 기록, 6.1절 대조 테스트 파일, 0929/03-03
  재전송 조건, 실행 격리)은 새 절에 적고 1105 절은 고치지 않았다.
- 예외는 처음부터 틀린 문장이다. 1105 "먼저 할 일" 1~3단계는 이 라운드의
  `2f0f2bb`·`06357e9`이 이미 고쳤고, 새 절 머리에 그 사실을 적었다.
- 1105 절 60행의 `tests/unit/backend-contract-pin.test.ts`는 바꾸지
  않았다(지시와 다름). `bbde570`에서는 맞는 이름이다. 새 절 테스트 줄에
  6.1절 대조가 `backend-contract-pin-document.test.ts`로 옮겼다고 적었다.
내용은 커밋 본문과 코드에서 옮겼다. 04-02는 [계약] BREAKING으로 적었다.
타입 인자 없이 부르는 호출은 descriptor 타입을 추론해, 입력이 맞지 않거나
`outcome.value`를 겹치지 않는 타입으로 단언한 호출이 `check:types`에서
실패할 수 있다. 두 다운스트림은 이 함수를 부르지 않는다(grep). 커밋은 `!`
없이 들어갔다. "먼저 할 일"은 여섯 단계다: 스키마 행 두 칸(07-02), 문구
키(03-01), 토큰 CSS(08-03), IDEMPOTENT 확인(03-03), CI 기준선(13-01),
poll 타입(04-02). 01-01의 백엔드 요청은 알려진 제한 "백엔드로 넘김"에 둔다.
버린 대안: 1105 절에 합쳐 순 요약으로 다시 쓰기. PR B가 아직 main에 없어
한 동기화 단위로 볼 수도 있지만, 1105 절의 해시 범위와 리뷰가 확인한 75개
해시 대조를 다시 해야 하고, 이미 1105 절을 읽은 다운스트림이 무엇이 바뀌었는지
찾기 어렵다.

위험·한계: 두 다운스트림에 적용해 게이트를 돌려 보지 않았다. 08-03 시각
spec이 제품 셸에서 도는지, 토큰 CSS가 빠졌을 때 가림막이 투명해지는지는
코드를 읽은 판단이다. 이 절의 해시는 이 범위의 커밋 27개와 기준점
`bbde570`, 리뷰 기록 `302d3a5`뿐이다. 1105 절의 해시는 이 범위 밖이라
새 절에 적지 않았다.

검증: desktop batch에서 확인.
node scripts/run-vitest.ts run tests/unit/changelog-review-ids.test.ts tests/unit/documentation-readiness.test.ts
노트북에서는 같은 정규식을 grep으로 흉내 내 괄호 안 라운드 없는 ID와
꼴을 벗어난 참조가 0건인 것만 봤다.

Refs: 1106/01-01, 1106/02-01, 1106/03-01, 1106/03-02, 1106/03-03, 1106/04-01, 1106/04-02, 1106/05-01, 1106/06-01, 1106/06-02, 1106/07-01, 1106/07-02, 1106/08-01, 1106/08-02, 1106/08-03, 1106/09-01, 1106/10-01, 1106/11-01, 1106/12-01, 1106/12-02, 1106/13-01, 1106/14-01, 1106/14-02, 1106/15-01, 1106/16-01, 1103/15-02
2026-11-06 07:38:25 +09:00
DongHyeonka 5cfc3a652f chore(scale): 1106 합친 빌드로 초기 JS 기록을 다시 적는다
문제: 1106 조치 브랜치를 모두 합친 빌드에서 `tests/unit/feature-shape-growth.test.ts`가
"initialJavascript is stale"로 실패한다. 새 context 하나가 더하는 초기 JS가
기록 218 B, 빌드 245 B로 10% 허용치를 넘는다. 합계는 204,111 → 204,193 B로
허용치 256 B 안이다. 브랜치마다는 기록과 맞았고 합친 뒤에만 넘는다.

고른 방법: 합친 끝에서
`node scripts/scale/measure-feature-shape-growth.ts --initial-baseline --write`로
다시 적는다(1105의 같은 기록 커밋과 같은 방법). 기능 하나가 더하는 값은
768 → 751 B다.

위험·한계: 초기 JS 예산 206,848 B(D9)까지 템플릿 여유는 2,655 B, 생성 기능
둘을 더한 FE-GATE-020 드릴은 205,541 B로 여유 1,307 B다(CI env). 기능·context
상한(1 KiB·512 B)은 그대로다.

검증: desktop batch에서 확인.
node scripts/run-vitest.ts run tests/unit/feature-shape-growth.test.ts
corepack pnpm ci:gate FE-GATE-020 (CI env)

Refs: 1106/15-01
2026-11-06 07:24:45 +09:00