Sphinx는 에이전트가 만든 코드를 push하기 전에 그 변경이 실제로 무엇을 하는지 개발자에게 질문을 던지는 git 훅이다. 보호 브랜치에서 push가 멈추고, 채팅을 보지 않은 리뷰어가 diff만 읽고 '장애 상황에서 어떻게 되는가'를 묻는다 — 틀리면 이유를 알려주고 새 시나리오를, 맞히면 push를 통과시킨다. Codex·Claude Code·Cursor·OpenCode·Pi 또는 순수 git에서 동작하며, 답은 코딩 에이전트로 전달되지 않고 .env·키는 열지 않는다. npm install -g sphinx-understand 후 sphinx install로 설치하고, 급할 땐 sphinx yolo로 통과시키되 스킵은 모두 로깅된다.
Sphinx가 던지는 질문은 실제 diff에서 생성된다. 공개 예시는 Stripe 웹훅 재시도에서 event ID를 charge() 전에 저장할 때의 이중 과금·미과금 분기를 짚는 식으로, 변경의 엣지 케이스를 되묻는다.
최소 토큰으로 돌도록 설계돼 기존 코딩 에이전트, OpenRouter, 또는 OpenAI 호환 엔드포인트에서 모델을 고를 수 있다. Node 22.19+·macOS/Linux/WSL에서 동작하고, sphinx install 과정에서 git과 코딩 에이전트를 연결하며 리뷰에 쓸 모델을 묻는다. 보호 브랜치에서만 push를 멈추므로 작업 흐름 전체를 막지는 않는다.