AI-SLOP Detector는 AI 에이전트가 만든 코드에서 자주 보이는 구조적 결함을 정적으로 분석하는 도구입니다.

단순 스타일 검사보다, stub 구현, phantom import, 과장된 주석/용어, helper로 쪼개 숨긴 복잡도처럼
“겉보기엔 깔끔한데 실제로는 불안한 코드”를 잡는 데 초점을 둡니다.

무엇을 할 수 있나

  • 단일 Python 파일 / 프로젝트 전체 분석
  • JSON 출력으로 자동화 파이프라인 연동
  • CI gate 사용
  • VS Code 확장 지원
  • AI 코드의 구조적 결함 패턴 탐지

왜 필요한가

  • 빠르게 생성된 AI 코드의 겉보기 품질과 실제 구현 밀도를 구분하는 데 도움
  • lint/style 도구가 놓치기 쉬운 그럴듯한 빈 코드를 추가로 걸러줌
  • 로컬 분석부터 CI까지 바로 연결 가능

2.9.x ~ 3.1.1 핵심 변화

  • phantom import 탐지 추가 및 정밀화
    → 존재하지 않는 패키지, 잘못된 import, optional dependency/guarded import를 더 정확하게 구분
  • history tracking + self-calibration 추가
    → 실행 이력을 바탕으로 false positive와 실제 문제를 더 구분하기 쉬워짐
  • 점수 모델을 가중 기하평균(GQG) 기반으로 전환
    → 한두 개 좋은 지표가 전체 문제를 가려버리기 어려워짐
  • fragmented god function 탐지 추가
    → 복잡한 함수를 helper 여러 개로 쪼개 깔끔해 보이게 숨기는 패턴도 잡을 수 있음
  • placeholder variable naming 탐지 추가
    → r1, r2 ... r12, 단일 문자 파라미터 남발처럼 보기엔 정리됐지만 의미가 빈약한 코드도 신호로 포착
  • empty-container / constant stub 탐지 강화
    → return {}, return [], return 42 같은 “형태만 함수인 코드”도 더 잘 잡음
  • SPAR-Code 기반 adversarial validation 추가
    → 기능이 늘었다기보다, 이전에 놓치던 회피 패턴을 더 잘 잡는 방향으로 보강
  • VS Code / CLI workflow 개선
    → clone signal 가시성, workspace analysis, history trends 등 실사용 흐름이 더 좋아짐.