Files
claude-harness/plugins/harness/skills/techdebt/SKILL.md
T
DongHyeonka ddbfc3dcc3 feat(plugin): 하네스 플러그인과 마켓을 더한다
문제: 되돌릴 수 없는 명령 차단, 비밀 값 알림, 예측·실측 장부가 소유자
기계의 ~/.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토큰.
2026-11-08 00:02:22 +09:00

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), 이미 합쳐진 로컬 브랜치.

할 일

  1. 스크립트 결과에서 이번 작업이 만든 것만 고른다. 원래 있던 것은 대상이 아니다.
  2. 범위 안이고 작으면 지금 고친다(테스트 skip은 이유가 없으면 되돌린다).
  3. 나머지는 끝 보고에 적는다: 빚은 「남은 문제」, 남이 고칠 것은 「범위 밖에서 본 것」. 다음 세션에 넘길 상세는 공유 노트에.
  4. scratch·worktree는 지우기 전에 무엇인지 보고, 이 세션이 만든 것만 치운다. 남의 것은 알리기만 한다.

하지 않는 것

  • 다른 사람의 브랜치·worktree를 지우지 않는다.
  • 빚을 숨기려고 TODO 문구를 지우지 않는다.