first-pass plugin
A Claude Code plugin that makes an agent check the code around a change and prove the work with a test and independent review
- 121 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Writes rule files into repositories and `~/.claude/CLAUDE.md`, installs hooks and runs CI checks on your machine.
- The review skill uses your gh login and pushes a fix only after agreement.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/first-passDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Writes rule files into repositories and `~/.claude/CLAUDE.md`, installs hooks and runs CI checks on your machine.
- The review skill uses your gh login and pushes a fix only after agreement.
This is third-party code. Review the repository files before installing.
What it does
first-pass makes an agent look beyond the lines it writes to the code around a change and confirm results before saying done. Before code the agent answers ten questions about the change against the real code: what happens when it runs twice, stops halfway or an outside service times out, which other code uses the same data and what the user sees on failure. Each answer is a `file:line` reference, a test or an accepted gap. During work anything the task did not ask for must earn its place and lands in a Not built list. Before done a second agent reviews the code in a fresh context, and done needs a test that failed before the change plus green CI checks. For a bug the plugin reproduces the error, searches for the same class within the task's scope and adds a check that stops it returning. The `/first-pass:review` command reviews your own branch before you ask for review.
Who it is for. Developers and teams handing Claude Code real tasks in multi-repository projects who want proof instead of a claim that everything works.
Good fit when
- The agent reports done, tests never ran and nothing proves the result.
- A change touches data that several places read and it is easy to break them.
- A bug should be fixed as a whole class and not a single line.
- Before a merge request you want to check your own branch against the ticket and bot comments.
Not a fit when
- You need a fast one-off edit: the full question and review cycle takes noticeably longer, though `/first-pass:quick` trims checks.
- You have no CI with reproducible checks: the definition of done relies on running them.
- You need hooks outside Claude Code: hooks work only there.
Example request
Fix this form double-submit bug and walk through the ten premortem questions before writing code.Limitations
Hooks need Node.js 18 or newer, and other agents get the rules and skills without hooks. Setup runs once with `/first-pass:setup-first-pass` in the folder holding your repositories: it writes `AGENTS.md`, `CLAUDE.md`, per-repository sections, a draft `INVARIANTS.md` and a machine block in `~/.claude/CLAUDE.md`. Setup commits and sends nothing. The Jev judge is opt-in and sends review findings with secrets blanked to the TypeSafe API. The `review` skill uses your `gh` login and pushes a fix only after your agreement. The latest commit is from October 2026.
How to disable. Run `/plugin uninstall first-pass@first-pass`. Files between the first-pass markers in `AGENTS.md` and `CLAUDE.md`, `INVARIANTS.md` and the machine block in `~/.claude/CLAUDE.md` are removed by hand.
FAQ
How do I install the plugin?
With `/plugin marketplace add joetawil7/first-pass` and `/plugin install first-pass@first-pass`. For Cursor and Codex use `npx skills add joetawil7/first-pass -a cursor --copy`.
What do I run after installing?
`/first-pass:setup-first-pass` once in the folder where your sessions start. The skill scans repositories, asks only what code cannot tell and writes the files.
What is quick mode?
`/first-pass:quick` turns on trimmed checks: format, lint, types, build and the tests the change reaches instead of the full CI set. `/first-pass:quick off` turns it off.
What does hulk do?
`/first-pass:hulk` lifts the scope limit for one task: searches, reviews and bug hunts go across the whole codebase and found problems are handled as usual.
What does the plugin write to my machine?
Rule files and sections in repositories between first-pass markers, a draft `INVARIANTS.md`, `.first-pass/workspace.json`, a small hook state folder and a machine block in `~/.claude/CLAUDE.md`.
Discussion
No questions or reviews yet.
Related
Plugins/pr-review sends a pull request through five independent reviewers, cross-checks findings and builds one report.
A skill that reads a repository once and installs checks: code rules become gates that fail a commit or a CI run.
The evidence-code-review skill for Codex and Claude Code: evidence-based change review with MUST, SHOULD, BETTER and NITS levels
A Claude Code plugin that verifies a change against its plan: boots your stack, runs acceptance criteria, reports evidence.
Hooks for Claude Code and Codex CLI keep a ledger of agent actions and refuse a "done" claim until a check has passed.
show-your-work
claude-show-your-work
A plugin that shows images and video in the Claude Code terminal, records Playwright checks and compares before and after
README in short
The README covers the ten questions, the list of skills and the breaker agent, the user's habit words and how they turn into checks. Results of testing the rules on thirty tasks are given.