frontend-quality-gates / merge / static checks (pull_request) Successful in 1m17s
frontend-quality-gates / merge / tests (pull_request) Failing after 11m29s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 5m14s
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 / main / self-tests and removal drills (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
tests/system/ci-runner/ci-artifact-contract.test.ts의 「applies effective aggregate cgroup limits」는 공급자(1.5초 쉼)가 4초 감독 시한 전에 스스로 끝났는지를 `Date.now() - completionStarted < 4000`으로 봤다. 이 벽시계는 감독이 끝난 뒤 trace 읽기와 단언에 걸린 시간까지 잰다. runner run 294 (FE-GATE-013, 이 파일을 안 건드린 #55의 run)에서 4271로 실패했는데, 같은 run에서 바로 앞의 `result.code === 0`은 통과했다. 감독의 시한 경로는 늘 "sandboxed external provider command timed out"을 던지고 실패로 끝난다(scripts/run-and-validate-provider.ts waitForProvider). 그 반대쪽은 「kills descendants and collects the scope」 timeout 경우가 시험한다. 그래서 exit 0과 `timed out` 없음이 시한에 안 죽었다는 결정적 증거다. 벽시계 상한을 지우고 그 자리에 `not.toMatch(/timed out/)`와 근거 주석을 둔다. 같은 모양을 tests/system 전체에서 찾았다(벽시계 상한 단언). 「enforces CPU RLIMIT before the independent wall-clock timeout」의 `< 5000`이 하나 더 있다. 감독 자신의 시작과 정리까지 재고, 시한 판정은 이미 `not.toMatch(/timed out/)`가 한다. 이것도 지운다. 버린 대안: - 상한을 4초보다 늘리기: 무엇을 지키는지 그대로 모호하고 부하에서 다시 흔들린다(design-docs ci/manual.md 8.4절). - 감독이 끝난 시각을 바로 재기: 감독 프로세스 시작(시한 타이머 밖)이 여전히 들어간다. 결과로 판정하면 시간이 필요 없다. 위험·한계: - 감독 시작·정리가 느려지는 회귀는 이 시험이 더는 잡지 않는다. 시간 측정은 performance lane 몫이다. - 고정 시간 가정은 남는다. 공급자의 1.5초 창 안에 unit 속성을 읽는 것, rlimit 시험의 spawn 시한 7초(hang 막이, 감독 시한 5초보다 커서 시한이 터지면 `timed out`이 먼저 보인다). 관측된 실패는 없어 그대로 둔다. - 흔들림 장부(docs/ledger/flaky-tests.jsonl)에 이 흔들림 한 줄과, 반복 실행에서 본 다른 흔들림 한 줄(아래)을 더한다. 예측 장부에 착수 예측 한 줄을 더한다. - 반복 실행에서 이 변경과 다른 원인의 흔들림을 봤다. 파일 전체 실행 중 79번째 provider 시험부터 18개가 연달아 `exit=125`로 실패한다(11-13 main c5f29344에서도 한 번). 125를 내는 쪽(cgroup 강제 게이트, scope wrapper)의 stderr를 waitForProvider가 버려 원인을 모른다. 장부에 fixed_by 없이 적고 고치지 않았다. 검증(desktop 시스템 컨테이너): - RED: main에 「완료 직후 2.6초 쉼」 탐침을 넣으면 감독은 2574 ms에 exit 0, `timed out` 없이 끝났는데 옛 단언이 5180 ms로 실패했다. - 변이: 감독 시한을 1000으로 줄이면 새 단언이 실패한다. - 이 파일 전체를 8회 돌려 6회 110/110 통과. 나머지 2회는 위의 exit=125 묶음(18개)이고, 바꾼 두 시험은 그 묶음에 들어 125로 실패했다. 묶음 밖 6회에서는 모두 통과했다.
예측·실측 장부
작업마다 착수할 때의 예측과 끝날 때의 실측을 한 줄씩 쌓는다. 틀린 예측에서 하네스(아키텍처 → 게이트 → 지침 → 사용자 행동 순서)를 고칠 곳을 찾는 것이 목적이다. 질타가 아니라 측정이다(소유자 결정 2026-11-07).
착수(첫 5분) ──> estimate 줄: p30·p50·p80 예측과 근거
끝 보고 직전 ──> actual 줄: 세션 기록에서 뽑은 실측
회고(주 1회) ──> retro 줄: 틀린 이유와 고칠 단계
- 파일은
docs/ledger/estimates.jsonl하나다. 한 줄이 JSON 하나다(JSON Lines). 줄을 고치거나 지우지 않고 더하기만 한다. 고칠 일이 있으면 같은task로"correction": true줄을 더한다. - 여러 브랜치가 끝에 줄을 더해도 병합이 멈추지 않게
.gitattributes가 이 파일에merge=union을 준다. - p30·p50·p80은 그 값 안에 끝날 확률이 30%·50%·80%라고 보는 세 값이다. p30이 도전값, p80이 안전값이다.
- 시간의 기준은 작업 중 시간이다. 끝 보고 뒤 다음 지시를 기다린 시간은 넣지 않는다. 배수는 근거(바꿀 파일 수, 검증 대기)가 있을 때만 쓴다.
- 위임 대조용 장부(design-docs
delegation-loop/ledger.jsonl)는 그대로 둔다. 그 줄의 예측·실측 칸은 이 파일의task를 가리킨다. - 흔들린 시험은
docs/ledger/flaky-tests.jsonl에 따로 쌓는다(아래 「흔들림 기록」).
줄의 칸
모든 줄:
| 칸 | 형식 | 뜻 |
|---|---|---|
schema |
정수 | 이 형식의 판. 지금 1 |
kind |
estimate · actual · retro |
줄의 종류 |
task |
문자열 | 작업 이름. 세 종류의 줄을 묶는 키다(예: 세션 이름) |
recorded_at |
ISO 8601 | 이 줄을 쓴 시각 |
transcript |
문자열 | Claude Code 세션 기록 파일 이름(~/.claude/projects/<cwd>/<이 값>.jsonl). 실측을 다시 셀 때 쓴다 |
estimate:
| 칸 | 형식 | 뜻 |
|---|---|---|
started_at |
ISO 8601 | 세션 첫 기록 시각 |
base |
문자열 | 기준 커밋 |
task_kind, size |
문자열 | docs/work/ playbook 이름, 작음·중간·큼(small·medium·large) |
minutes, calls, output_tokens |
{"p30","p50","p80"} 정수 |
작업 중 시간(분), 모델 호출 수, 출력 토큰 |
basis |
문자열 | 근거: 비교한 선례와 그 실측, 바꿀 파일 수, 검증 대기 |
actual:
| 칸 | 형식 | 뜻 |
|---|---|---|
minutes, active_minutes |
정수 | 벽시계 시간, 작업 중 시간(세션 기록 사이 빈틈을 5분까지만 더한 시간. 긴 대기와 다음 지시를 기다린 시간이 빠진다) |
calls, output_tokens, cache_read_tokens, max_context |
정수 | 세션 기록 assistant 줄의 message.usage. 같은 message.id는 한 번만 센다 |
within |
문자열 | p30·p50·p80·over: 시간 실측이 들어간 가장 작은 예측 |
result, commits |
문자열, 배열 | 완료·부분·못 함, 만든 커밋 |
why |
문자열 | 예측이 틀렸으면 이유 한 줄 |
retro: cause(지시 모호 · 착수 전 조사 부족 · 아키텍처 경직 · 검증 대기 · 외부 대기 · 범위 변경 · 예측 근거 없음), level(architecture · gate · instructions · user), note, ref(고친 커밋이나 문서).
흔들림 기록
docs/ledger/flaky-tests.jsonl에 흔들린 시험 하나마다 JSON 한 줄을 더한다. 칸과 처리 절차의 정본은 design-docs ci/manual.md 8.3·8.5절이다. 이 파일도 더하기만 하고 merge=union으로 합친다.
| 칸 | 뜻 |
|---|---|
date |
처음 본 날(YYYY-MM-DD) |
test |
spec 파일:줄 또는 시험 파일:줄 |
category |
fixed-time · concurrency-order · resource-io · test-order · external |
first_run |
처음 본 runner run 번호, desktop이면 로그 경로 |
verdict |
판정 결과(예: 「8회 중 1회 실패」, 「재현 안 됨」)와 원인 |
quarantined_until |
격리했으면 기한, 아니면 빈 값 |
fixed_by |
고친 PR(프론트 #47 형식), 아직이면 빈 값 |