Claude Code용 클린 코드 자동화 플러그인 'cleancode' 개발기

섹션별 상세

리팩터링 자동화의 핵심 원칙으로 단순 보고만 하는 Linter와 달리 코드를 직접 수정하는 Rewriter를 지향함. 수정 시 공개 API를 보존하고 자동 수정이 불가능한 주관적 규칙은 제외하여 도구에 대한 신뢰도를 확보함.

플러그인 구조는 사용자가 직접 호출하는 Skills(슬래시 명령어), 비차단 방식으로 제안만 하는 Agent, 프로젝트 시작 시 규칙을 확인하는 Hooks로 구성됨. 특히 Hooks를 통해 규칙 도입률을 20%에서 100%로 향상함.

예외 처리 시스템은 외부 설정 파일 대신 코드 내 주석(// cleancode:exempt(rule))을 사용하여 예외 사유를 코드와 함께 관리함. 이를 통해 기술 부채를 가시화하고 리뷰가 가능하도록 설계함.

Claude Code, Cursor, Codex CLI 등 다양한 AI 도구에서 동일한 규칙을 적용하기 위해 .cleancode-rules.md를 단일 진실 공급원으로 활용함. 이를 통해 도구별로 파편화된 규칙을 통합 관리함.

Claude Code추천

리팩터링 자동화 및 플러그인 실행

Cursor추천

AI 코드 에디터

Codex CLI추천

CLI 기반 AI 도구