# Pass a quiz on agent-written code before you push it

> Sphinx is a free Git hook that pauses pushes to protected branches and asks you a scenario question about the diff your agent wrote, so you only release code you actually understand.

- URL: https://paperchasewebb.ai/bots/marketplace/items/pass-a-quiz-on-agent-written-code-before-you-push-it/
- Type: Agent use case pack
- Category: Vibe coding
- By: PaperChaseWebb
- Works with: Claude Code, Codex, Cursor (named in the listing); Plain .md
- Price: Free USD
- Difficulty: Beginner
- Setup time: 15 min
- Time to result: One working session
- Format: Markdown (.md) file, pass-a-quiz-on-agent-written-code-before-you-push-it.md
- Version: 1.0, updated 2026-10-25
- License: Personal and commercial use. Credit the original source when you share the workflow.

## What you end up with

MIT licensed and reached the Hacker News front page with about 200 points.

## What you get

- A plain-language summary of the workflow
- A fill-in prompt template
- What to watch out for
- A link to the original source

## Who it is for

Builders who already use AI agents and want a proven workflow they can copy into their own project.

## Tools needed

- Sphinx: Git pre-push hook that generates questions from the diff
- Codex, Claude Code, Cursor, OpenCode or Pi: your coding agent, or any OpenAI-compatible model, does the reviewing
- You need: An AI coding agent or chat model
- You need: A small real task to try it on

Cost to run: Free with the agent plan you already use.

## How it works

1. **Read what they did.** Skim the source post linked below, then the summary on this page. Expected: You know the setup and the one rule that made it work.
2. **Fill in the template.** Copy the prompt and replace every [bracketed] value with your own project details. Expected: A prompt that fits your project.
3. **Run it once and check.** Run it on a small task first and confirm the result yourself before you trust it on real work. Expected: One verified run.

## Sample prompt: Workflow template (Sphinx, Codex, Claude Code, Cursor, OpenCode or Pi)

```
From the project page: install with npm install -g sphinx-understand, run sphinx install to connect Git and your agents and choose a reviewing model, then push as usual.
```

Adapted by PaperChaseWebb. Not the original author's prompt.

## Free preview of pass-a-quiz-on-agent-written-code-before-you-push-it.md

````markdown
# Pass a quiz on agent-written code before you push it

PaperChase agent use case (free feed entry), version 1.0. Source: [critiquebrowser on Hacker News](https://news.ycombinator.com/item?id=50137950), 2026-10-18.

## What they did

The maker built a hook where a reviewer that never saw your chat reads the diff and asks what happens when things go wrong, such as a retry or a failed payment call. A wrong answer explains why and gives a new scenario; a right answer lets the push continue.

## Worth knowing

MIT licensed and reached the Hacker News front page with about 200 points. Needs Node 22.19 or newer on macOS, Linux or WSL. The project says your answers never reach the coding agent and it does not open .env files or keys. There is a skip command for emergencies, and every skip is logged.
````

## Worth knowing

- MIT licensed and reached the Hacker News front page with about 200 points. Needs Node 22.19 or newer on macOS, Linux or WSL. The project says your answers never reach the coding agent and it does not open .env files or keys. There is a skip command for emergencies, and every skip is logged.
- Figures are as reported by the original author and were not re-measured by us.

## Questions

**Where does this come from?** A public post credited to critiquebrowser on Hacker News. Source: https://news.ycombinator.com/item?id=50137950

**Is it free?** Yes. Feed entries are free to read and download.

## How to get it

Free sample. Download it directly at https://paperchasewebb.ai/bots/marketplace/items/pass-a-quiz-on-agent-written-code-before-you-push-it/, no signup.

Seller: PaperChaseWebb Inc., mgmt@paperchasewebb.com