Code Simplifier

개요

Code Simplifier는 코드의 기능을 정확히 보존하면서 명확성, 일관성, 유지보수성을 개선하는 에이전트입니다. 최근 수정된 코드에 프로젝트의 모범 사례를 적용해 단순하게 정리합니다.

읽기 쉬운 명시적 코드를 과도하게 압축된 코드보다 선호합니다. 행동 변경 없이 "어떻게 하는가"만 바꿉니다.

언제 쓰는가

• 최근 작성한 코드의 가독성을 개선하고 싶을 때
• 불필요한 복잡성을 줄이고 싶을 때
• 프로젝트 코딩 표준에 맞게 코드를 정돈할 때
• Stop 훅에 의해 자동으로 실행될 때 (opt-in)

사용 예시

"방금 작성한 코드를 단순화해줘"
"이 파일의 가독성을 개선해줘"

핵심 원칙

기능 보존

원래 기능, 출력, 동작을 절대 변경하지 않습니다. 내보낸 심볼 이름 변경, 함수 시그니처 변경, 제어 흐름 재정렬은 하지 않습니다.

프로젝트 표준 적용

• ES 모듈, 적절한 import 정렬, .js 확장자
• 최상위 선언에 function 키워드 선호 (화살표 함수 대신)
• 최상위 함수에 명시적 반환 타입 어노테이션
• camelCase (변수), PascalCase (타입) 네이밍
• TypeScript strict 모드 패턴

명확성 향상

• 불필요한 복잡성과 중첩 감소
• 중복 코드와 추상화 제거
• 명확한 변수/함수 이름으로 가독성 개선
• 관련 로직 통합
• 코드가 이미 명확히 보여주는 내용을 설명하는 불필요한 주석 제거
• 중첩 삼항 연산자 금지 -- switch 또는 if/else 체인 사용

균형 유지

아래의 과도한 단순화는 피합니다.

• 코드 명확성이나 유지보수성을 해치는 단순화
• 이해하기 어려운 지나치게 기발한 솔루션
• 한 함수에 너무 많은 관심사를 결합
• 코드 조직을 개선하는 유용한 추상화 제거
• "줄 수를 줄이는 것"을 가독성보다 우선시

Stop 훅 자동 실행

Code Simplifier는 Stop 훅으로 자동 실행될 수 있습니다 (기본값 비활성화).

~/.omc/config.json에서 활성화:

{
  "codeSimplifier": {
    "enabled": true,
    "extensions": [".ts", ".tsx", ".js", ".jsx", ".py", ".go", ".rs"],
    "maxFiles": 10
  }
}

활성화하면 Claude가 멈출 때마다 git diff HEAD --name-only로 수정된 파일을 찾아 code-simplifier 에이전트에 위임합니다. 턴당 한 번만 실행됩니다.

다른 에이전트와의 조합

• executor: Executor가 구현을 완료한 후 Code Simplifier가 가독성을 개선합니다
• code-reviewer: 코드 리뷰 결과에 따라 리팩토링이 필요하면 Code Simplifier를 활용합니다

레퍼런스