Sphinx, AI 지원 Git 워크플로에 코드 이해 점검 추가

요약

Sphinx는 AI 에이전트를 활용한 개발에서 변경된 코드의 실제 동작을 개발자가 이해하는지 확인하는 Git 훅입니다. 보호된 브랜치로 푸시할 때 잠시 멈추고 diff에서 생성한 질문을 보여 주며, 실패와 재시도, 상태 저장 순서 같은 상황을 다룹니다. 예시에서는 웹훅이 결제 전에 Stripe 이벤트 ID를 저장하므로 같은 이벤트가 다시 와도 이중 결제를 피할 수 있지만, 결제가 실패해도 ID가 남으면 다음 재시도에서 결제가 건너뛰어질 수 있습니다. Sphinx는 오답의 이유를 설명하고 새로운 상황을 질문한 뒤, 사용자가 이해했음을 보이면 푸시를 계속합니다. Codex, Claude Code, Cursor, OpenCode, Pi, 일반 Git, OpenRouter 및 OpenAI 호환 엔드포인트와 함께 사용할 수 있습니다. 답변은 코딩 에이전트에 전달되지 않으며 `.env` 파일과 키도 열지 않는다고 설명합니다. Node 22.19 이상이 필요하고 macOS, Linux, WSL에서 실행됩니다. `sphinx yolo` 모드는 점검을 건너뛰고 푸시를 허용하지만 모든 건너뛰기를 기록합니다.