클로드 코드 훅이 AI 코딩 워크플로우에서 진행 중인 작업의 누적을 모니터링합니다

AI 코딩 워크플로우에서 진행 중인 작업 모니터링

한 개발자가 AI 지원 개발에서 흔히 발생하는 문제를 해결하기 위해 Claude Code용 UserPromptSubmit 훅을 만들었습니다: AI 에이전트가 진행 중인 작업의 누적을 파악하지 못하는 문제입니다. AI가 현재 프롬프트에 집중하는 동안, 커밋되지 않은 변경사항이 늘어나고, 커밋이 푸시되지 않고 쌓이며, 변경세트가 작성되지 않고, 릴리스 PR이 장시간 열려 있을 수 있습니다.

훅 작동 방식

이 훅은 에디터와 프로덕션 사이에서 코드가 누적되는 네 가지 지점을 모니터링하는 검사를 구현합니다:

• 검사 1: 200줄을 초과하는 커밋되지 않은 변경사항(추적된 것과 추적되지 않은 것 모두)
• 검사 2: 세 개 이상의 푸시되지 않은 커밋
• 검사 3: 변경세트 파일 없이 푸시된 커밋(릴리스 PR 생성을 방지함)
• 검사 4: 24시간 이상 열려 있는 릴리스 PR

검사 1과 2는 git 명령어를 사용해 로컬에서 실행되며, 모든 프롬프트 제출 시 실행되어 거의 즉각적인 피드백을 제공합니다. 검사 3과 4는 GitHub API 호출이 필요하므로, 각 푸시 작업 후 한 번씩 실행됩니다.

디자인 철학

핵심 디자인 결정은 이를 차단이 아닌 알림으로 구현하는 것이었습니다. 이 훅은 AI 작업을 차단하지 않고, 두 가지 채널을 통해 가시성을 제공합니다:

• AI의 컨텍스트에 주입되는 additionalContext
• 사용자 터미널에 출력되는 systemMessage

이 접근 방식은 permissionDecision 구성 요소가 없음을 의미합니다. AI와 개발자 모두 코딩 과정을 방해하지 않고 워크플로우의 현재 상태를 확인할 수 있습니다.

이런 종류의 도구는 AI 지원 개발 워크플로우를 더 잘 관리하고 싶은 개발자, 특히 진행 중인 작업이 눈에 띄지 않게 쉽게 누적될 수 있는 대규모 프로젝트에서 작업하는 개발자에게 유용합니다.