Claude가 자동으로 생성하는 코드 패턴을 잡아주는 린터 - grain

Claude로 파이썬 코드를 작성하다 보면 패턴이 보이시지 않나요? 모든 예외를 try/except로 감싸면서 logger.debug만 찍고 re-raise는 안 하고, 독스트링은 함수 이름 풀어쓰기, TODO는 "implement this"만 적어두는 식입니다.

저도 HAL 쪽 코드에서 조용한 예외 핸들러가 156개 쌓인 걸 뒤늦게 발견했는데, 센서가 실패해도 런타임이 모르고 있었습니다.

grain이라는 프리커밋(pre-commit) 린터가 이런 패턴을 잡아줍니다:

• NAKED_EXCEPT - 넓은 except에 re-raise 없음
• OBVIOUS_COMMENT - 주석이 다음 줄 코드를 반복
• RESTATED_DOCSTRING - 독스트링이 함수 이름 수준
• HEDGE_WORD - 문서에 "robust", "seamless" 등
• VAGUE_TODO - 접근 방법 없는 TODO
• .grain.toml에 커스텀 규칙도 정의 가능합니다

ruff나 pylint 대체가 아니라 보완 도구입니다. Claude가 오토파일럿 모드에서 쏟아내는 코드의 품질 패턴을 체크하는 용도로, pip install grain-lint로 설치할 수 있습니다.