design-docs harness/01-harness-design.md 5.1절 H12 rm -r 줄
## 무엇을, 왜
H12는 cwd의 main checkout도 `rm -r` 허용 폴더에 넣는다. 그래서 main checkout 안 worktree(`.claude/worktrees/…`)에서 아래 세 명령이 통과했다(`docs/retro/2026-11-08.md` C6).
- `rm -rf ./*`: worktree 자신을 지운다.
- `rm -rf ../w2`: 옆 worktree를 통째로 지운다.
- `rm -rf ../w2/src`: 옆 worktree 안을 지운다.
앱은 worktree 세션의 `CLAUDE_PROJECT_DIR`를 main checkout으로 준다. 그래서 실제 세션이 바로 이 경우다. 이 PR은 이런 삭제를 막고, 그동안 이 빈틈을 표시하던 `expectedFailure`를 뗀다.
## 고른 방법과 버린 대안
- 허용 폴더는 그대로 두고, 「지킬 checkout」을 따로 센다.
- 지킬 checkout은 작업 폴더와, 그 repo에 `git worktree list`로 등록된 모든 worktree다.
- /tmp와 앱 임시 작업 폴더 밖에서만 아래 두 규칙을 건다.
- 규칙 1: checkout 자신이나 그것을 품은 폴더를 통째로 지우면 막는다.
- worktree에서: `./*`, `../w2`, `..`
- main checkout에서: `.claude/worktrees`
- 규칙 2: 옆 worktree 안을 지우면 막는다.
- 옆 worktree는 이 세션 작업 폴더와 같지도 않고, 그것을 품지도 않고, 그 안에 있지도 않은 checkout이다.
- 「이 세션 작업 폴더」는 cwd의 checkout으로 먼저 잡는다. 처음에는 프로젝트 폴더도 같이 봤다. 그러면 main checkout이 내 것이 되어 실제 세션에서 `../옆-worktree/x`가 통과했다. 그래서 cwd를 먼저 보도록 고쳤다.
- 전처럼 통과하는 것:
- 작업 폴더 안 정리(`rm -rf build` 등)
- worktree에서 main checkout 안의 worktree 밖 자리를 지우는 일(`../../build`)
- main checkout 세션이 worktree 안을 치우는 일(`.claude/worktrees/w/build`)
- /tmp 아래 worktree 지우기
- 버린 대안:
- worktree 세션에서 main checkout을 허용 폴더에서 빼기: 설계 문구에는 맞다. 하지만 지금 통과하는 일을 더 많이 막는데, 그래야 할 근거가 없다.
- `.claude/worktrees` 폴더 이름으로 판정하기: 다른 곳에 둔 worktree를 놓친다.
- 훅 동작이 바뀌므로 harness를 0.3.1로 올렸다. 문서도 고쳤다: `README.md`, `docs/README.md` 15번(설계와 다른 점), retro C6(고친 날짜).
## 위험과 영향
- 판정할 때마다 git을 한 번 더 부른다(`worktree list`, 시간 제한 5초). rm·push처럼 걸리는 낱말이 있는 명령에서만 돈다.
- 등록되지 않은 폴더는 지켜지지 않는다. 예: 지운 worktree가 남긴 폴더, 없는 경로.
- 사용자 전역 `~/.claude/hooks/guard_bash.py`에 같은 판정이 있어 같이 고쳤다(repo 밖).
- 이 PR이 병합되고, `claude-harness` main checkout을 받고, 플러그인을 0.3.1로 올리기 전까지는 전역 훅 시험의 사본 비교 2줄이 「다름」으로 나온다.
- 이 기계에서는 전역 훅이 H12를 맡고 플러그인은 건너뛰므로, 그동안 동작에는 영향이 없다.
## 검증
- 고치기 전(RED): 새 시험을 main 훅에 돌려 실패를 먼저 봤다.
- worktree에서 `./*`
- main checkout에서 `.claude/worktrees`
- 프로젝트 폴더가 main일 때 `../w2/src`
- 고친 뒤(GREEN): 두 곳에서 `scripts/check.sh` 통과. harness 28·redteam 21·템플릿 11, expectedFailure 없음.
- 원래 repo 아래 worktree
- /tmp 아래 worktree
- 새 규칙 두 개를 하나씩 꺼 봤다. 끌 때마다 그 규칙의 시험이 실패한다.
- 거짓 양성 확인: 소유자 기계 세션 기록의 `rm -r` 647개를 옛 판정과 새 판정으로 비교했다.
- 이 중 338개는 지금도 있는 worktree 35곳에서 실행한 명령이다.
- 프로젝트 폴더가 없을 때와 main checkout일 때 두 번 돌렸다.
- 바뀐 것은 이 작업의 확인 명령 1개뿐이다.
- 전역 훅 `python3 ~/.claude/hooks/tests/run_tests.py`: 268개 중 사례 266개가 맞다(worktree 사례 13개 추가).
- 틀린 2개는 위의 사본 비교다(main checkout과 플러그인 캐시 0.3.0).
- 전역 훅과 이 브랜치의 공유 정의 45개는 AST가 같다.
- 실제 세션에서 확인했다. 전역 훅 설치 뒤:
- 보통 Bash 명령은 통과한다.
- 옆 worktree 안의 없는 경로에 대한 `rm -rf`는 「다른 worktree 안」으로 막힌다.
- 작업 폴더 안과 scratchpad 안의 `rm -rf`는 통과한다.
## 리뷰어가 볼 곳
- `plugins/harness/scripts/guard_bash.py`의 `h12_roots`(`mine`·`foreign` 계산)와 `H12Visitor.rm_violation`의 새 두 검사
- `plugins/harness/tests/test_hooks.py`의 `GuardRmCheckoutTest`
## 관련
- `docs/retro/2026-11-08.md` C6
- design-docs `harness/01-harness-design.md` 5.1절 H12 `rm -r` 줄
문제: H12는 cwd의 main checkout도 rm 허용 폴더에 넣는다. 그래서
main checkout 안 worktree(.claude/worktrees/…)에서 worktree 자신
(`rm -rf ./*`), 옆 worktree(`rm -rf ../w2`), 그 안(`../w2/src`)을
지우는 것이 통과한다(docs/retro/2026-11-08.md C6). 앱은 worktree
세션의 CLAUDE_PROJECT_DIR를 main checkout으로 주므로 실제 세션이 이
경우다.
고친 방법: 허용 폴더는 그대로 두고 지킬 checkout을 따로 센다. 작업
폴더와 그 repo에 `git worktree list`로 등록된 모든 worktree다. /tmp·앱
임시 작업 폴더 밖에서는 checkout 자신이나 그것을 품은 폴더를 통째로
지우면 막는다. 이 세션 작업 폴더와 같지도, 품지도, 그 안에 있지도
않은 checkout(옆 worktree)은 그 안을 지워도 막는다. 「이 세션 작업
폴더」는 cwd의 checkout을 먼저 본다. 프로젝트 폴더를 먼저 보면 main
checkout이 내 것이 되어 옆 worktree 안이 열린다(실제 세션에서 확인).
main checkout 안 다른 자리(worktree 밖)와 main checkout 세션이
worktree 안을 치우는 일은 전처럼 통과한다.
버린 대안: worktree 세션에서 main checkout을 허용 폴더에서 빼기(설계
문구에는 맞지만 지금 통과하는 일을 더 많이 막는다. 근거 없이 넓히지
않았다), `.claude/worktrees` 이름으로 판정(다른 곳에 둔 worktree를
놓친다).
위험: 판정마다 git을 한 번 더 부른다(`worktree list`, 시간 제한
5초). 등록되지 않은 폴더(지운 worktree의 남은 폴더)는 지켜지지
않는다. /tmp 아래 worktree는 일부러 그대로 허용한다. 훅 동작이 바뀌어
harness 0.3.1로 올린다. 같은 판정이 전역 ~/.claude/hooks/guard_bash.py
에도 있어 같이 고쳤다. 이 repo가 병합되고 main checkout을 받고 플러그인을
0.3.1로 올리기 전까지 전역 훅 시험의 사본 비교 2줄은 다르다고 나온다.
검증: 새 시험을 main 훅에 돌려 실패를 먼저 봤다(worktree `./*`,
main checkout `.claude/worktrees`, 프로젝트 폴더가 main일 때
`../w2/src`). 고친 뒤 scripts/check.sh 통과(harness 28·redteam 21·
템플릿 11, expectedFailure 없음). 새 규칙 둘을 하나씩 끄면 각각 시험이
실패한다. 소유자 기계 세션 기록의 rm -r 647개를 프로젝트 폴더 없이,
또 main checkout으로 주고 옛·새 판정을 비교해 바뀐 것은 이 작업의
확인 명령 1개뿐이었다.
Refs: docs/retro/2026-11-08.md C6
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.
무엇을, 왜
H12는 cwd의 main checkout도
rm -r허용 폴더에 넣는다. 그래서 main checkout 안 worktree(.claude/worktrees/…)에서 아래 세 명령이 통과했다(docs/retro/2026-11-08.mdC6).rm -rf ./*: worktree 자신을 지운다.rm -rf ../w2: 옆 worktree를 통째로 지운다.rm -rf ../w2/src: 옆 worktree 안을 지운다.앱은 worktree 세션의
CLAUDE_PROJECT_DIR를 main checkout으로 준다. 그래서 실제 세션이 바로 이 경우다. 이 PR은 이런 삭제를 막고, 그동안 이 빈틈을 표시하던expectedFailure를 뗀다.고른 방법과 버린 대안
git worktree list로 등록된 모든 worktree다../*,../w2,...claude/worktrees../옆-worktree/x가 통과했다. 그래서 cwd를 먼저 보도록 고쳤다.rm -rf build등)../../build).claude/worktrees/w/build).claude/worktrees폴더 이름으로 판정하기: 다른 곳에 둔 worktree를 놓친다.README.md,docs/README.md15번(설계와 다른 점), retro C6(고친 날짜).위험과 영향
worktree list, 시간 제한 5초). rm·push처럼 걸리는 낱말이 있는 명령에서만 돈다.~/.claude/hooks/guard_bash.py에 같은 판정이 있어 같이 고쳤다(repo 밖).claude-harnessmain checkout을 받고, 플러그인을 0.3.1로 올리기 전까지는 전역 훅 시험의 사본 비교 2줄이 「다름」으로 나온다.검증
./*.claude/worktrees../w2/srcscripts/check.sh통과. harness 28·redteam 21·템플릿 11, expectedFailure 없음.rm -r647개를 옛 판정과 새 판정으로 비교했다.python3 ~/.claude/hooks/tests/run_tests.py: 268개 중 사례 266개가 맞다(worktree 사례 13개 추가).rm -rf는 「다른 worktree 안」으로 막힌다.rm -rf는 통과한다.리뷰어가 볼 곳
plugins/harness/scripts/guard_bash.py의h12_roots(mine·foreign계산)와H12Visitor.rm_violation의 새 두 검사plugins/harness/tests/test_hooks.py의GuardRmCheckoutTest관련
docs/retro/2026-11-08.mdC6harness/01-harness-design.md5.1절 H12rm -r줄