docs(ledger): 흔들린 시험 기록을 두고 시간·순서 단언 규칙을 가리킨다

흔들린 시험을 적는 곳이 없다. 2026-11-12~13 이틀에 프론트 흔들림이
여섯 건이었다. 재실행으로 통과시킨 것은 세션 노트에만 남았다. 같은
모양(첫 렌더 5초 창, 잠금 순서 가정)이 다시 들어와도 리뷰 기준에 막을
줄이 없다.

docs/ledger/flaky-tests.jsonl을 두고 여섯 건을 첫 줄들로 넣는다. 칸은
design-docs ci/manual.md 8.5절이다(date·test·category·first_run·verdict·
quarantined_until·fixed_by). 여기에 대응하는 표를 docs/ledger/README.md
「흔들림 기록」에 둔다. 이 파일도 estimates.jsonl처럼 더하기만 하고
.gitattributes merge=union으로 합친다. README 지워도 되는 파일 표와
docs/README.md 지도에 넣었다. testing.md 5절 조사 절차에 6번(기록)을
더했다. 리뷰 기준 2절 「헷갈리는 경우」에 벽시계 상한·시작 순서 단언을
구조적 위험으로 적고, gates.md 3절에서 둘을 가리킨다(ci/manual.md 8.4절).

버린 대안: scripts/verify.sh docs가 이 파일의 칸과 범주까지 검사하게
하는 안. 이번 범위(계획 FLAKY-1) 밖이라 뒤로 미뤘다. 지금은 손으로
맞춘다.

위험·한계: platform-overview.spec.ts:48(WebKit)은 원인 조사 전이다.
범주는 5초 창에서 실패한 꼴만 보고 fixed-time으로 적었다.

검증: scripts/verify.sh docs(노트북) OK, desktop verify:documentation.
This commit is contained in:
DongHyeonka
2026-11-13 19:38:52 +09:00
parent ee95573f9b
commit fe9990b4cc
8 changed files with 28 additions and 1 deletions
+1
View File
@@ -92,6 +92,7 @@
3. 결정적 재현을 만든다. 원인이라고 본 조건을 강제로 만들어 매번 실패하게 한다. 예: mousedown 때 앱 높이를 늘리면 세 엔진 6/6 실패, 모듈 응답을 3.5초 늦추면 WebKit 경고 2/2.
4. 고친다. 고친 뒤 결정적 재현이 통과하고, 실제 조건 반복 실행에서 실패 0인지 본다(예: 660/660).
5. 검사가 약해지지 않았는지 변이로 본다. 경고를 무시하게 고쳤으면, 원래 잡아야 할 것(정말 안 쓴 preload)을 여전히 잡는지 확인한다.
6. 처음 본 날 `docs/ledger/flaky-tests.jsonl`에 한 줄 남긴다. 고치면 같은 `test`로 `fixed_by`를 채운 줄을 더한다(칸은 `docs/ledger/README.md` 「흔들림 기록」).
**브라우저 테스트에서 반복된 원인.**