데드코드 제거기

무엇을 해주나

프로젝트에 남아 있는 사용되지 않는 코드를 찾아 안전하게 제거하는 오케스트레이션 스킬입니다.

• 스캔: tsc --noEmit --noUnusedLocals --noUnusedParameters로 미사용 지역변수·임포트·파라미터·타입을 뽑고, 동시에 탐색 에이전트를 띄워 아무도 임포트하지 않는 고아 파일과 미사용 export 심볼을 찾습니다.
• 검증: 후보 하나하나에 LspFindReferences(includeDeclaration=false)를 돌려 참조가 0인 것만 "확정 데드코드"로 승격합니다. 배럴 index.ts 재수출, 테스트에서만 쓰이는 심볼, @public JSDoc, 훅/툴 팩토리, package.json exports 등은 오탐 방지 목록으로 보호합니다.
• 배치 & 실행: 확정 목록을 파일 단위로 묶어 5~15개 배치로 나누고, 각 배치를 병렬 딥 에이전트에 위임합니다. 에이전트는 재검증 → 수정 → bun run typecheck → 자기 파일만 git add 후 커밋합니다. 타입체크가 깨지면 즉시 git checkout --로 되돌립니다.
• 최종 검증 & 보고: typecheck/test/build를 다시 돌리고 제거 심볼·커밋 해시·스킵 사유가 담긴 표를 출력합니다.

이런 분께 추천

• 오래 굴러 파일이 수백 개 쌓인 TypeScript/Bun 모노레포를 정리해야 하는 개발자
• "지웠다가 빌드 깨지면 어쩌지" 걱정 때문에 데드코드 청소를 미뤄온 팀
• 리뷰하기 쉬운 파일별 원자적 커밋 형태로 리팩터링 PR을 만들고 싶은 사람
• 병렬 서브에이전트 오케스트레이션 패턴을 배우고 싶은 고급 사용자

활용 예시

1. 전체 정리: "remove dead code" → 전 프로젝트 스캔 후 확정 목록 표를 보여주고, 배치별 병렬 커밋 + 최종 typecheck/build 결과 요약까지 받습니다.
2. 범위 제한: "dead code src/features/billing" → 해당 디렉터리만 스캔해 미사용 상수 2개와 죽은 함수 1개를 제거하고 커밋 1건으로 마무리.
3. 시그니처 유지: 콜백 시그니처 때문에 필요한 미사용 파라미터 ctx는 삭제하지 않고 _ctx로 리네임해 타입 오류 없이 경고만 해소합니다.
4. 대량 감지 시 중단: 후보가 50개를 넘으면 자동으로 멈추고 범위를 좁힐지 물어봅니다.

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 code-yeongyu/oh-my-openagent 의 .agents/skills/remove-deadcode 폴더를 내 ~/.claude/skills/remove-deadcode/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.