Show HN: Sphinx – AI의 코드를 배포하기 전에 퀴즈를 내는 후크

• 무료
• FOSS

“당신의 이해가 아닌, 당신의 생각을 아웃소싱하라.”
— 손자

Sphinx는 에이전트 지원 개발을 위한 Git hook입니다. 에이전트의 코드가 배포되기 전에, 그 코드가 실제로 무엇을 하는지에 대해 질문합니다.

npm install -g sphinx-understand
기존 코딩 에이전트, OpenRouter 또는 모든 OpenAI 호환 엔드포인트에서 최소 토큰으로 실행되도록 구축되었습니다.

Sphinx

당신의 웹훅 핸들러가 charge()를 호출하기 전에 이벤트 ID를 저장합니다.
. Stripe는 타임아웃되어 동일한 이벤트를 다시 보냅니다. 재시도 시 어떻게 될까요?

당신

두 번 실행되므로 고객에게 두 번 청구됩니다.

Sphinx

그렇지 않습니다. 재시도는 저장된 ID를 찾아내고, 청구하지 않고 200을 반환합니다. 하지만 그 ID는 청구가 성공하기 전에 저장됩니다. 만약 charge()가 실패하면 다음 재시도는 어떻게 될까요?

당신

청구를 건너뛰므로 고객은 결코 청구되지 않습니다.

설명적인 예시입니다. 실제 질문은 당신의 diff에서 나옵니다.

• 01

당신이 푸시합니다.

또는 당신의 에이전트가 합니다. Git은 보호하는 브랜치에서 일시 정지됩니다.

• 02

Sphinx가 질문합니다.

당신의 채팅을 본 적 없는 리뷰어가 diff를 읽고, 문제가 생겼을 때 변경 사항이 무엇을 하는지 질문합니다.

• 03

당신이 답변합니다.

틀리면 이유를 배우고 새로운 시나리오를 시도합니다. 맞으면 푸시가 계속됩니다.

Codex, Claude Code, Cursor, OpenCode, 그리고 Pi, 또는 일반 Git에서 작동합니다. 당신의 답변은 코딩 에이전트에게 전달되지 않으며, .env 파일과 키는 절대 열리지 않습니다. 급한가요? sphinx yolo를 사용하면 푸시가 진행되고 모든 건너뛰기가 기록됩니다.

1분 만에 시작하기.

# Node 22.19+ · macOS, Linux, or WSL
npm install -g sphinx-understand
sphinx install
...

sphinx install은 Git과 당신의 코딩 에이전트를 연결하고 어떤 모델로 리뷰할지 질문합니다. 다른 모든 내용은 문서를 읽어보세요.