문제: 되돌릴 수 없는 명령 차단, 비밀 값 알림, 예측·실측 장부가 소유자 기계의 ~/.claude에만 있거나 아예 없다. 다른 기계·파생 서비스·새 프로젝트는 받을 길이 없고, 훅 코드에 이력과 리뷰도 없다. 고른 방법: 이 repo를 플러그인 마켓으로 두고 공통 플러그인 harness 하나를 싣는다(설계 harness/01-harness-design.md 11절, 결정 Q13 (c)·Q15). - H12(PreToolUse Bash): 호스팅 원격 force push·--mirror·보호 브랜치 지우기, 작업 폴더·/tmp 밖이나 너무 넓은 rm -r, DB·볼륨·migration 삭제를 막는다. 셸 파서는 소유자 전역 guard_bash.py와 정의가 같은 사본이다. 사용자 전역 설정에 guard_bash.py H12가 있으면 건너뛰어 두 번 막지 않는다. - N4(PostToolUse Write·Edit): 비밀 값 모양을 몇 줄로 알리고 막지 않는다. - 장부 SessionStart·Stop 훅: ~/.claude/harness/에 세션 기록 경로와 누적 실측을 쓴다. 출력이 없어 컨텍스트 비용이 0이다. - 스킬 estimate·retro·techdebt: 모두 모델이 부르고 발동 조건을 설명에 문단으로 적었다(결정 Q9). 버린 대안: H12에 git reset --hard·clean·checkout -- .를 넣는 것(설계 5.1절). 이 기계 세션 기록의 Bash 명령 43,078개에서 정당한 사용이 61·32·31건이라 거짓 양성이 크다. 전역 훅을 플러그인으로 옮기는 것은 Q13대로 안정된 뒤에 한다. 위험: H12 판정이 전역 훅과 두 벌이다. 소유자 기계의 전역 훅 시험이 두 사본의 정의를 비교한다. 원격(ssh) rm은 작업 폴더를 몰라 너무 넓은 대상만 막는다. 검증: - python3 -m unittest discover -s plugins/harness/tests: 17개 통과. 조건을 하나씩 끈 사본 12개에서 모두 실패를 확인했다. - 같은 판정을 이 기계 세션 기록 명령 43,078개에 돌려 5건이 막힘: 의도한 막힘 3(desktop 작업 폴더 통째 rm 2, -p 없는 down -v 1), 시험용 볼륨 rm 1, 당시 프로젝트 폴더를 알 수 없는 rm 1. - claude plugin validate --strict: 마켓·플러그인 모두 통과. - 로컬 경로 마켓으로 설치(--scope local) 뒤 새 세션에서 스킬 셋이 보이고 SessionStart·Stop 훅이 기록을 썼다. 항상 드는 비용 약 698토큰.
2.1 KiB
2.1 KiB
name, description
| name | description |
|---|---|
| techdebt | Use right before the final report of a task that changed files, or when the user says "정리해", "techdebt", "세션 끝", "남긴 것 없나" — to list what this branch's diff added that someone must pay back later (new TODO/FIXME, skipped or disabled tests, lint/type suppressions, debug prints), what the session left lying around (scratch files, extra worktrees, merged local branches, untracked files), and out-of-scope findings worth handing over. 세션 끝에 이번 diff가 남긴 빚과 치울 것을 모아 「범위 밖에서 본 것」·「남은 문제」 후보를 만든다. |
techdebt — 세션 끝 정리
고치는 스킬이 아니다. 남긴 것을 보이게 한다. 고칠지는 범위를 보고 정하고, 범위 밖이면 보고의 「범위 밖에서 본 것」이나 공유 노트로 넘긴다.
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/techdebt.py" # 기준: origin/main과 갈라진 곳
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/techdebt.py" --base <커밋>
스크립트가 보여 주는 것:
- 이번 diff가 더한 줄 중 TODO·FIXME·XXX·HACK, 건너뛴 테스트(
@Disabled,.skip(,xit(,@pytest.mark.skip), 검사 끄기(@SuppressWarnings,eslint-disable,@ts-ignore,# noqa,# type: ignore), 디버그 출력(console.log,System.out.println,print((테스트 밖)). - 추적하지 않는 파일, 지울 수 있는 worktree(
prunable), 이미 합쳐진 로컬 브랜치.
할 일
- 스크립트 결과에서 이번 작업이 만든 것만 고른다. 원래 있던 것은 대상이 아니다.
- 범위 안이고 작으면 지금 고친다(테스트 skip은 이유가 없으면 되돌린다).
- 나머지는 끝 보고에 적는다: 빚은 「남은 문제」, 남이 고칠 것은 「범위 밖에서 본 것」. 다음 세션에 넘길 상세는 공유 노트에.
- scratch·worktree는 지우기 전에 무엇인지 보고, 이 세션이 만든 것만 치운다. 남의 것은 알리기만 한다.
하지 않는 것
- 다른 사람의 브랜치·worktree를 지우지 않는다.
- 빚을 숨기려고 TODO 문구를 지우지 않는다.