docs(work): 확인 리뷰에 예산 확인 지점과 실패한 단계 검증을 더한다 #52

Merged
donghyeon.kang merged 1 commits from docs/improve-review-budget into main 2026-11-13 17:14:04 +00:00
1 Commits
Author SHA1 Message Date
DongHyeonka 38d9bcfe70 docs(work): 확인 리뷰에 예산 확인 지점과 실패한 단계 검증을 더한다
frontend-quality-gates / merge / static checks (pull_request) Successful in 1m20s
frontend-quality-gates / merge / tests (pull_request) Successful in 13m50s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 5m37s
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
frontend-quality-gates / main / self-tests and removal drills (pull_request) Skipped
개선 playbook에는 라운드 안에서 새 눈 리뷰를 몇 번, 얼마나 크게 돌리는지
정한 곳이 없다. 4.5절의 라운드 상한(세 라운드)은 전체 리뷰 횟수만 센다.
2026-11 전체 리뷰와 수정이 주간 사용량의 절반(50%)을 썼고, 전 범위 첫
파동이 리뷰어 비용의 80%, 이후 파동이 2%였다. 또 main·nightly 단계
실패(예: main push의 Firefox 첫 렌더 흔들림)를 재실행 초록이나 PR 단계
검증으로 닫고 같은 원인의 다른 모양이 되풀이됐다.

위임 루프 운영 12절(design-docs 사용량 회고 PR)을 이 playbook에 맞춘다.
기존 줄 끝에 문장을 붙여 150줄 한도를 지켰다(새 줄 0).
- 2절: 열린 끝 일은 brief의 예산·멈출 기준을 받는다. 없으면 묻는다.
- 4.1: 전체 리뷰는 라운드마다 한 번, 그 뒤 확인은 직전 수정 diff만.
  새 눈 리뷰는 PR당 한 번 + 고친 뒤 확인 한 번.
- 4.2 9단계와 9절: main·nightly 실패는 실패를 낸 게이트를 같은
  조건으로 돌려 rc를 본다. 재실행 초록이나 PR 단계 검증으로 닫지 않는다.
- 4.5: 예산은 세 라운드 상한과 별개의 확인 지점이다. 닿았는데 기준이
  아직 아니면 멈추고 남은 발견·쓴 양을 보고해 계속할지 묻는다.

고른 방법: 4.5절의 기준과 소유자 결정(각자 유지)은 건드리지 않았다.
예산은 기준을 낮추지 않고 계속할지 묻는 지점만 더한다.

위험·한계: 위임 루프 운영 12절은 cold-read 시험 전이라 이 줄도 시험 전이다.
verify:documentation은 짝 백엔드 checkout이 없는 worktree라
PASS_SCOPED(19개 참조 미확인)로 끝났다.

검증: scripts/verify.sh docs rc=0(improve.md 150/150, 진입 경로 272/350,
이력 ID 0, 상대 링크 121개), corepack pnpm verify:documentation rc=0
(PASS_SCOPED). 노트북 laptop-gate로 돌렸다.

Refs: design-docs delegation-loop/retro/2026-11-13-usage-waste.md
2026-11-13 22:38:04 +09:00