Sphinx, AI 생성 코드 이해도 검증으로 git 푸시 차단하는 오픈소스 훅 공개

Sphinx는 에이전트 기반 개발 워크플로우를 위한 무료 오픈소스 Git 훅이다. 보호된 브랜치에서 git push를 일시 중지하고, AI 에이전트가 생성한 코드 변경 사항(diff)에 대해 개발자에게 질문을 던진다. 개발자가 정답을 맞혀야만 푸시가 진행되어, 배포된 코드에 대한 인간의 이해를 보장한다.

작동 방식

이 도구는 채팅 기록이 아닌 diff를 분석하는 pre-push 훅으로 작동한다. 채팅 기록을 보지 않은 리뷰어가 새 코드의 엣지 케이스나 로직 흐름을 바탕으로 질문을 생성한다.

• 워크플로우: 개발자(또는 에이전트)가 푸시를 시도하면 Sphinx가 이를 가로챈다.
• 질문 생성: 리뷰어가 diff를 읽고 특정 시나리오(예: 오류 처리, 경쟁 조건)에서 코드가 어떻게 동작하는지 질문한다.
• 검증: 개발자는 정답을 답해야 한다. 실패하면 새로운 시나리오로 재시도하며, 성공하면 푸시가 계속된다.
• 우회: sphinx yolo 명령어로 검사를 우회할 수 있으나, 이 작업은 로그에 기록된다.

통합 및 프라이버시

Sphinx는 경량화 및 프라이버시 보호에 중점을 두어, 개발자의 답변이 코딩 에이전트로 유출되지 않도록 설계되었다.

• 호환성: Codex, Claude Code, Cursor, OpenCode, Pi 및 일반 Git과 호환된다.
• 모델 지원: 기존 코딩 에이전트 모델, OpenRouter, 또는 모든 OpenAI-compatible endpoint를 사용할 수 있다.
• 보안: .env 파일과 키는 절대 열리지 않으며, 개발자의 답변은 원래 코딩 에이전트로 전송되지 않는다고 명시한다.
• 설치: npm(sphinx-understand)으로 설치 가능하며, Node.js 22.19 이상 버전이 필요하다.