Communitygithub.com

AradhanaID/agent-skills - 죽은 코드 제거

사용되지 않는 프론트엔드 코드를 안전하게 찾아 삭제합니다. 사용 여부를 증명하고, 전체 단위를 삭제하며, 검증합니다.

agent-skills - 죽은 코드 제거란 무엇인가요?

이 스킬은 프론트엔드 코드베이스에서 죽은 코드(데드 코드)를 안전하게 제거하는 방법을 AI 에이전트에게 안내합니다. 개발자 도구(예: Claude Code, Cursor, Codex)에서 사용할 수 있으며, 사용되지 않는 파일, 내보내기, 컴포넌트, props, CSS 클래스 등 전체 단위를 식별하고 제거하는 체계적인 접근 방식을 제공합니다. 한 번 실행에 하나의 죽은 영역을 처리하며, 코드 라인이 아닌 전체 단위(예: 파일, export, 컴포넌트)를 대상으로 합니다. 각 후보에 대해 직접 및 동적 참조를 모두 검색하여 사용 여부를 증명하고, 하나씩 삭제한 후 빌드, 타입 검사, 테스트를 실행하여 안전성을 확인합니다. 마지막으로 삭제된 단위를 참조하던 import 체인이나 스태일 픽스처 등 느슨한 연결을 정리합니다. 이 스킬은 제거 대상 외의 코드는 절대 리팩터링하지 않으며, 구조가 어색한 주변 코드는 이름만 언급합니다. 참조 문서(reference.md)를 통해 프론트엔드 코드가 검색에서 숨는 위치와 단위 유형별 증명 체크리스트를 제공합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AradhanaID/agent-skills/tree/HEAD/skills/remove-dead-code

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

죽은 코드 제거

한 번 실행으로 하나의 죽은 영역을 정리합니다: 사용되지 않음을 증명하고, 전체 단위를 삭제하며, 남은 코드를 검증합니다. 유지하는 코드는 절대 리팩터링하지 않으며, 구조가 어색한 주변의 살아있는 코드는 이름만 언급합니다.

단계

  1. 후보 열거. 죽었을 가능성이 있는 전체 단위를 나열합니다: 수정되지 않은 파일, 참조되지 않은 내보내기, 어떤 라우트도 렌더링하지 않는 컴포넌트, 호출자가 전달하지 않는 props와 states, 어떤 마크업도 사용하지 않는 CSS 클래스. 라인이 아닌 전체 단위 — 살아있는 헬퍼가 있는 죽은 export도 여전히 하나의 단위입니다. 완료 조건: 각 후보가 누가 참조할 수 있었는지 이름을 밝혔을 때.
  2. 모든 주소에서 사용되지 않음을 증명. 직접 참조와 동적 참조를 모두 검색합니다: 문자열 기반 import, 라우트 테이블, 테스트 템플릿, 스토리 이름. 후보가 죽었다고 판단되는 것은 도달 가능한 모든 방법이 추적되었을 때뿐입니다. 완료 조건: 각 후보가 아무것도 찾지 못한 검색 기록을 기록했을 때.
  3. 조각 단위로 삭제하고 각각 검증. 한 번에 하나의 단위를 제거합니다 — 놀라운 일이 발생하면 중단하고, 경계를 다시 증명한 후 재개하는 트레이서 불릿 구조입니다. 각 삭제 후 빌드, 타입 검사 및 테스트가 실행됩니다. 완료 조건: 마지막 삭제 후 적어도 한 번의 전체 빌드와 테스트가 통과했을 때.
  4. 느슨한 끝 정리. 삭제된 단위를 import하던 것들을 다시 확인합니다: import 체인, 낡은 픽스처, 이제 빈 폴더. 트리를 흔듭니다: 두 번째로 떨어져 나오는 것이 이번 실행의 일부입니다. 완료 조건: 삭제된 이름에 대한 새 검색 결과가 아무것도 반환되지 않을 때.

참고

  • reference.md — 프론트엔드 코드가 검색에서 숨는 위치, 단위 유형별 증명 체크리스트.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

관련 스킬