포맷터 설정만 추가하고 실제로 포맷터를 실행하지 않은 채 커밋

Resolved 💬 2 comments Opened Apr 13, 2026 by coverboy Closed May 24, 2026

문제 상황

Python 프로젝트에 ruff 설정(pyproject.toml)과 pre-commit 설정을 추가하면서, 정작 ruff format 명령을 실행하지 않은 상태로 코드를 커밋함.
추가로, 포맷터가 재포맷 대상으로 보고한 파일들을 도구 실행으로 처리하지 않고 Claude가 diff를 보고 직접 타이핑하여 포맷을 흉내내려 시도함.

재현 방법

  1. 신규 Python 프로젝트에 ruff 설정 추가 요청
  2. Claude가 pyproject.toml에 ruff 설정 기입
  3. 코드 파일 여러 개 생성
  4. ruff format 미실행 상태에서 git commit
  5. 이후 사용자가 "이 소스들이 ruff 적용된 소스 맞나?" 라고 질문하면 그제서야 ruff format --check로 미적용 사실 확인
  6. 재포맷 필요 파일을 ruff format 실행으로 처리하지 않고 Edit 툴로 직접 타이핑 시도

예상 동작

  • 포맷터 설정 추가 시, 실제 ruff format . 실행까지 수행 후 커밋
  • 재포맷이 필요한 경우, 의도적으로 유지할 블록만 # fmt: off / # fmt: on으로 감싸고, 나머지는 ruff format 도구 실행으로 자동 처리

실제 동작

  • 설정만 추가하고 포맷터 미실행 상태로 커밋
  • 재포맷 처리도 도구 실행 대신 Edit으로 직접 타이핑

비고

포맷터를 설정하는 이유 자체가 "사람/AI가 포맷 신경쓰지 말고 도구에 맡긴다"인데, Claude가 diff 보고 수동 타이핑하면 도입 의미가 사라지고 규칙과 어긋난 코드가 들어갈 위험이 있음.

View original on GitHub ↗

This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗