문제: 예측·실측 장부 줄은 쌓이는데 회고한 줄이 0이다. 회고는 사람이 「주 1회」를 기억해야 돌고, 고친 뒤 효과가 없으면 되돌린다는 규칙을 적을 칸도 없다. 지난 4작업은 모두 실측이 p30 아래였는데(실측/p50 시간 중앙값 0.43), 매번 이유 한 줄만 바꿔서 치우침이 그대로 남았다. 고른 방법: - precedents 끝에 보정 줄을 낸다: 실측/p50 중앙값(시간·호출·출력)과 p30 아래·p80 위 건수. --ledger를 여러 번 받아 다른 repo 장부를 더한다. estimate 스킬에 「중앙값이 0.8 아래나 1.25 위면 세 값에 곱한다」 한 줄. - pending은 예측 밖(p30~p80 밖이거나 why가 있음)인데 retro 줄이 없는 작업만 보이고, 효과 판정이 없는 개선도 보인다. - retro 줄에 fix(개선 id)·applied_at, 새 줄 verdict(effective·reverted). 판정은 개선 뒤에 예측 줄을 쓴 다른 작업 2건의 실측이 끝나면 한다. 개선 전에 예측한 작업은 그 개선의 영향을 받지 않아 세지 않는다. - SessionStart에 ledger.py nudge를 따로 건다. startup일 때만, 같은 repo(worktree를 git common dir로 묶어)에 20시간에 한 번 한 줄. append가 actual 줄을 쓸 때 예측 밖이면 그 자리에서 한 줄 알린다. 버린 대안: session-start 장부 훅에서 출력(장부 훅 출력 0 규칙을 깬다), 매 세션 넛지(하위 세션마다 같은 줄이 컨텍스트에 쌓인다), 별도 retro 스크립트(이미 있는 ledger.py 명령으로 충분하다). 위험: 넛지는 그 repo의 첫 세션이 하위 세션이어도 나온다. 문구에 「맡은 일이 회고가 아니면 넘긴다」를 넣었다. 다른 repo 장부에 retro 줄이 더해질 때까지 그 repo에서는 하루 한 번 넛지가 나온다. 보정 규칙은 같은 4건으로 잰 값이라 아직 효과를 모른다. 검증: scripts/check.sh rc=0(플러그인 시험 21개 OK, expected failure 1, 템플릿 시험 10개 OK, plugin validate --strict 통과). 새 조건 15개를 하나씩 끈 사본에서 LedgerTest가 15번 모두 실패했다. 백엔드 템플릿 장부에 nudge를 돌리면 「회고 안 한 빗나간 예측 3건」 한 줄이 나왔다 (상태 폴더는 scratchpad).
이 repo에서 정한 것
설계 정본은 design-docs harness/01-harness-design.md다(11절 하네스 템플릿 repo, 13절 소유자 결정 2026-11-07). 이 문서는 만들면서 설계와 다르게 정했거나 설계에 없던 것만 적는다.
| # | 정한 것 | 설계와 다른 점 | 근거 |
|---|---|---|---|
| 1 | H12는 force push, 범위 밖 rm -r, DB·볼륨·migration 삭제만 막는다 |
설계 5.1절의 git reset --hard·git clean -fdx·git checkout -- . 줄은 넣지 않았다 |
소유자 기계 세션 기록의 Bash 명령 43,078개에서 정당하게 쓴 경우가 각 61·32·31건이었다. 막으면 거짓 양성이 크다. 자기 작업 폴더 안에서만 효과가 있고, auto mode 분류기가 따로 본다 |
| 2 | 다른 기계 작업 사본 경로(host:/abs/path)로 보내는 force push는 통과(보호 브랜치를 덮거나 ref가 없으면 막음) |
설계는 force push를 모두 막는다 | 같은 기록의 force push 25건이 모두 desktop 작업 사본으로 시험 브랜치를 옮기는 운반이었다. 공유 원격(Gitea)으로 보낸 것은 0건 |
| 3 | -p <이름>을 준 compose down -v는 통과 |
설계는 down -v를 모두 막는다 |
시험 lane은 고유 -p로 띄우고 같은 -p로 볼륨까지 지우는 것이 정해진 절차다(백엔드 scripts/run-compose-runtime-smoke.sh). 막을 것은 -p 없는 기본 프로젝트(개발 데이터)다 |
| 4 | kubectl delete는 pvc·pv·namespace만 |
설계는 kubectl delete 전부 |
pod 지우기는 컨트롤러가 다시 만든다(되돌릴 수 있다). 기록에 정당한 pod 재시작이 있었다 |
| 5 | rm -r은 /tmp 아래를 허용, /tmp/claude-<uid> 자체는 막음 |
설계는 scratchpad와 /tmp/claude-<uid>만 |
빌드 도구가 /tmp에 만든 임시 폴더를 지우는 정당한 경우가 있었다. /tmp는 원래 버려도 되는 곳이다 |
| 6 | 원격(ssh '…') rm -r은 너무 넓은 대상만 막는다(~, ~/workspace/<이름> 통째, /와 그 바로 아래) |
설계에 없음 | 원격 작업 폴더를 알 수 없다. desktop 작업 폴더 통째 지우기 2건은 막힘으로 남긴다(git worktree remove가 맞는 길) |
| 7 | 플러그인 H12는 사용자 전역 설정에 guard_bash.py … H12가 있으면 건너뛴다 |
설계 Q13 (c)의 「두 번 돌지 않게」를 구체화 | 소유자 기계는 전역 훅이, 다른 기계·파생 서비스는 플러그인이 막는다. 판정 코드는 두 곳이 같고 소유자 기계의 전역 훅 시험이 비교한다 |
| 8 | 장부 훅은 ~/.claude/harness/에 쓰고, repo 장부(docs/ledger/estimates.jsonl)에는 스킬만 쓴다 |
설계 10.2절과 같음. 13절 Q11대로 repo마다 장부 | 훅이 repo 파일을 고치면 모든 세션의 작업 트리가 더러워진다 |
| 9 | template/.claude/settings.json에 Agent deny를 넣지 않는다 |
설계 11.2절 그림에는 있다 | 13절 Q5(Agent 금지 해제) |
| 10 | 회고 넛지(ledger.py nudge)는 장부 훅과 따로 SessionStart에 건다. startup일 때만, 같은 repo(worktree를 묶어)에 20시간에 한 번 한 줄 |
설계에 없음 | 장부 줄은 쌓였는데 회고가 0이었다(docs/retro/2026-11-08.md). 장부 훅은 출력 0을 지키고, 넛지는 하위 세션마다 반복되지 않게 묶었다 |
| 11 | 효과 판정은 개선 뒤에 예측 줄을 쓴 다른 작업 2건의 실측으로 한다(verdict 줄) |
설계에 없음 | 개선 전에 예측한 작업은 그 개선의 영향을 받지 않는다. 1건은 우연이 크다 |
확인한 것과 못 한 것
- 이 repo 첫 작업의 시험·설치 결과는
docs/ledger/estimates.jsonl첫 줄과 design-docs 공유 노트h2-harness-repo.md에 있다. - 클라우드 세션에서 Gitea 마켓을 받는지는 보지 않았다(소유자는 데스크톱 앱 로컬 세션만 쓴다).