개선 playbook(docs/work/improve.md)에 확인 리뷰의 예산 확인 지점과 「실패가 난 단계에서 GREEN」을 더한다. design-docs 위임 루프 운영 12절(사용량 회고, design-docs #9)을 이 playbook에 맞춘 것이다.
문제: 라운드 안에서 새 눈 리뷰를 몇 번, 얼마나 크게 돌리는지 정한 곳이 없다. 4.5절 라운드 상한(세 라운드)은 전체 리뷰 횟수만 센다. 2026-11 전체 리뷰·수정이 주간 사용량의 50%를 썼고, 전 범위 첫 파동이 리뷰어 비용의 80%, 이후 파동이 2%였다. main·nightly 단계 실패를 재실행 초록이나 PR 단계 검증으로 닫고 같은 원인의 다른 모양이 되풀이된 일도 있었다.
변경(한 파일, 새 줄 0: 기존 줄 끝에 문장을 붙여 150줄 한도를 지켰다): 2절 열린 끝 일은 brief 예산·멈출 기준을 받는다 / 4.1 전체 리뷰는 라운드마다 한 번, 그 뒤는 직전 수정 diff만, 새 눈 리뷰는 PR당 한 번 + 고친 뒤 확인 한 번 / 4.2 9단계와 9절 main·nightly 실패는 실패를 낸 게이트를 같은 조건으로 돌려 rc를 본다 / 4.5 예산은 세 라운드 상한과 별개의 확인 지점이다.
고른 방법과 버린 대안
고른 것: 4.5절의 기준(새 High 0·새 P1 0·merge 단계 통과)과 소유자 결정 「각자 유지」를 건드리지 않고, 예산에 닿았을 때 멈추고 계속할지 묻는 지점만 더했다.
버린 것: 예산을 멈춤 기준으로 두는 안(소유자 규칙 「남은 문제 0」을 낮춘다). 새 절을 만드는 안(playbook 150줄 한도가 꽉 차 있어 기존 줄에 붙였다).
위험과 영향
4.5절의 완료 기준은 그대로다. 예산에 닿으면 사람 결정이 한 번 더 들어간다. 줄이 길어져 읽기 쉽지는 않다(한도 때문에 새 줄을 못 늘렸다).
위임 루프 운영 12절이 cold-read 시험 전이라 이 줄도 시험 전이다.
검증하지 못한 것: 새 세션이 이 줄을 보고 따르는지. docs 외 코드·설정 변경은 없다.
검증
~/.claude/bin/laptop-gate --log improve-budget-fe-docs -- scripts/verify.sh docs rc=0 (improve.md 150/150, 진입 경로 272/350, 이력 ID 0, 상대 링크 121개), corepack pnpm verify:documentation rc=0 (PASS_SCOPED: 짝 백엔드 checkout이 없는 worktree라 참조 19개는 확인 못 했다). 노트북 감싸개로 돌렸다.
runner pr run은 이 PR이 올린 뒤 돈다. 기다리는 중이면 아직 안 본 것이다.
리뷰어가 볼 곳
docs/work/improve.md 4.5절에 붙은 예산 문장이 소유자 규칙 「남은 문제 0」·「각자 유지」와 어긋나지 않는지.
## 무엇을, 왜
개선 playbook(`docs/work/improve.md`)에 확인 리뷰의 예산 확인 지점과 「실패가 난 단계에서 GREEN」을 더한다. design-docs 위임 루프 운영 12절(사용량 회고, design-docs #9)을 이 playbook에 맞춘 것이다.
- 문제: 라운드 안에서 새 눈 리뷰를 몇 번, 얼마나 크게 돌리는지 정한 곳이 없다. 4.5절 라운드 상한(세 라운드)은 전체 리뷰 횟수만 센다. 2026-11 전체 리뷰·수정이 주간 사용량의 50%를 썼고, 전 범위 첫 파동이 리뷰어 비용의 80%, 이후 파동이 2%였다. main·nightly 단계 실패를 재실행 초록이나 PR 단계 검증으로 닫고 같은 원인의 다른 모양이 되풀이된 일도 있었다.
- 변경(한 파일, 새 줄 0: 기존 줄 끝에 문장을 붙여 150줄 한도를 지켰다): 2절 열린 끝 일은 brief 예산·멈출 기준을 받는다 / 4.1 전체 리뷰는 라운드마다 한 번, 그 뒤는 직전 수정 diff만, 새 눈 리뷰는 PR당 한 번 + 고친 뒤 확인 한 번 / 4.2 9단계와 9절 main·nightly 실패는 실패를 낸 게이트를 같은 조건으로 돌려 rc를 본다 / 4.5 예산은 세 라운드 상한과 별개의 확인 지점이다.
## 고른 방법과 버린 대안
- 고른 것: 4.5절의 기준(새 High 0·새 P1 0·merge 단계 통과)과 소유자 결정 「각자 유지」를 건드리지 않고, 예산에 닿았을 때 **멈추고 계속할지 묻는** 지점만 더했다.
- 버린 것: 예산을 멈춤 기준으로 두는 안(소유자 규칙 「남은 문제 0」을 낮춘다). 새 절을 만드는 안(playbook 150줄 한도가 꽉 차 있어 기존 줄에 붙였다).
## 위험과 영향
- 4.5절의 완료 기준은 그대로다. 예산에 닿으면 사람 결정이 한 번 더 들어간다. 줄이 길어져 읽기 쉽지는 않다(한도 때문에 새 줄을 못 늘렸다).
- 위임 루프 운영 12절이 cold-read 시험 전이라 이 줄도 시험 전이다.
- 검증하지 못한 것: 새 세션이 이 줄을 보고 따르는지. docs 외 코드·설정 변경은 없다.
## 검증
- `~/.claude/bin/laptop-gate --log improve-budget-fe-docs -- scripts/verify.sh docs` rc=0 (improve.md 150/150, 진입 경로 272/350, 이력 ID 0, 상대 링크 121개), `corepack pnpm verify:documentation` rc=0 (PASS_SCOPED: 짝 백엔드 checkout이 없는 worktree라 참조 19개는 확인 못 했다). 노트북 감싸개로 돌렸다.
- runner `pr` run은 이 PR이 올린 뒤 돈다. 기다리는 중이면 아직 안 본 것이다.
## 리뷰어가 볼 곳
- `docs/work/improve.md` 4.5절에 붙은 예산 문장이 소유자 규칙 「남은 문제 0」·「각자 유지」와 어긋나지 않는지.
## 관련
- design-docs `conventions/delegation-loop.md` 12절, `delegation-loop/retro/2026-11-13-usage-waste.md`
개선 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
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
무엇을, 왜
개선 playbook(
docs/work/improve.md)에 확인 리뷰의 예산 확인 지점과 「실패가 난 단계에서 GREEN」을 더한다. design-docs 위임 루프 운영 12절(사용량 회고, design-docs #9)을 이 playbook에 맞춘 것이다.고른 방법과 버린 대안
위험과 영향
검증
~/.claude/bin/laptop-gate --log improve-budget-fe-docs -- scripts/verify.sh docsrc=0 (improve.md 150/150, 진입 경로 272/350, 이력 ID 0, 상대 링크 121개),corepack pnpm verify:documentationrc=0 (PASS_SCOPED: 짝 백엔드 checkout이 없는 worktree라 참조 19개는 확인 못 했다). 노트북 감싸개로 돌렸다.prrun은 이 PR이 올린 뒤 돈다. 기다리는 중이면 아직 안 본 것이다.리뷰어가 볼 곳
docs/work/improve.md4.5절에 붙은 예산 문장이 소유자 규칙 「남은 문제 0」·「각자 유지」와 어긋나지 않는지.관련
conventions/delegation-loop.md12절,delegation-loop/retro/2026-11-13-usage-waste.md