first-pass
Rules and checks that make Claude Code look around a change, not just at the lines it writes: ten questions before code, a reviewer that didn't write it, proof before done, bugs fixed as a class.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/joetawil7--first-pass)HTML
<a href="/listings/joetawil7--first-pass"><img src="/api/listings/joetawil7--first-pass/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Claude Code
/plugin marketplace add joetawil7/first-pass /plugin install first-pass@first-pass
From a terminal: `claude plugin marketplace add joetawil7/first-pass`, then `claude plugin install first-pass@first-pass`. To update later: `claude plugin marketplace update first-pass`, then `claude plugin update first-pass@first-pass`.
The hooks need Node.js 18 or later on your PATH. The tests run on Windows and Linux.
Cursor, Codex and other agents
npx skills add joetawil7/first-pass -a cursor --copy # this project npx skills add joetawil7/first-pass -a cursor --copy -g # every project
This uses the [skills CLI](https://github.com/vercel-labs/skills). Swap `-a cursor` for your agent (`-a codex`, `-a windsurf`, ...). `--copy` writes real files instead of symlinks, which Windows checkouts turn into plain text. Don't add `-a claude-code` if you use the plugin, or you'll get every skill twice. Other tools get the rules and skills; the hooks are Claude Code's.
Then run setup once
In the folder where your sessions start: `/first-pass:setup-first-pass` (or `/setup-first-pass` outside Claude Code). It looks through your repos, asks only what the code can't tell it (which repos have a UI, which depend on which, which repo hooks to run), and writes the files above. Re-run it after an update: your own text, each repo's section and `INVARIANTS.md` are kept.
Teammates
Once a repo's files are committed, every teammate's agent loads its section. Tell setup which repos people open on their own: those also get the rules and a copy of the breaker. Each person installs the skills: the plugin for Claude Code, the `npx skills` line for Cursor.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 17 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- {
- "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
- "name": "first-pass",
- "description": "Ship it right on the first pass.",
- "owner": {
- "name": "joetawil7",
- "url": "https://github.com/joetawil7"
- },
- "plugins": [
- {
- "name": "first-pass",
- "description": "Makes your coding agent look around a change: ten questions before code, a reviewer that didn't write it, proof before done, bugs fixed as a class, and your habit words mapped to real checks.",
- "source": "./",
- "category": "development"
- }
- ]
- }
README.md · README · 403 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- # first-pass
- [](https://github.com/joetawil7/first-pass/actions/workflows/validate.yml)
- [](LICENSE)
- first-pass makes a coding agent check the code around a change, not only the lines it
- writes, and prove its work before it calls anything done. It's a Claude Code plugin;
- Cursor, Codex and other agents get the same rules and skills (the hooks are Claude Code
- only). You set it up once, in the folder that holds your repos.
- **What it does**
- - **Before code,** the agent answers ten questions about the change against the real code:
- what happens if it runs twice, stops halfway, or an outside service times out; which
- other code uses the same data; what the user sees when it fails. Each answer is a
- `file:line`, a test, or a gap you decide to accept.
- - **While building,** anything the task didn't ask for (a helper, a cap, a retry, an option)
- has to earn its place. The agent asks whether it needs to exist, leaves it out when
- nothing requires it, and lists it under "Not built" so you can ask for it. During the
- work, a review finding gets fixed only when it does real harm or stops the change doing its
- job; the rest come to you as one list at the end, to pick from.
- - **On the task you gave,** the agent first writes the task's scope from your prompt and the
- code around it: the feature, everything that uses the same data, the rest of the same
- flow, and the steps that cancel or delete what it creates. Its searches and reviews stay
- inside that scope. A serious problem it happens to see
- elsewhere gets one line in the report (and one in that repo's list of known breaks when it
- breaks one of its rules), and nothing else; anything the change itself breaks
- counts as inside, wherever it is. `/first-pass:hulk` lifts the
- scope for one task, so it looks everywhere.
- - **Before "done",** a second agent that didn't write the code reviews it in a fresh
- context. "Done" needs a test that failed before the change and CI's checks passing in a
- clean checkout (or, with `/first-pass:quick`, the checks the change can affect); anything less is reported as built, not done.
- - **On a bug,** it fixes the whole class: it reproduces the bug, finds the same pattern in
- the task's scope, and adds the check that stops it coming back.
- - **On a pull request,** `/first-pass:review` checks your own branch before you ask for
- review, or a teammate's PRs across several repos. Every finding comes with its proof or
- is marked unproven, and it never posts to GitHub. `/first-pass:review hulk <what>` reviews
- with the scope lifted, so it looks everywhere.
- - **In every session,** hooks send back a "done" that has no evidence behind it (edits made
- through the shell count too), run each repo's own hooks from the shared folder, and say
- what drifted since setup.
- - **In replies** (optional, you choose at setup): plain, short answers. The first line says
- what happened or what you need to do, in everyday words, without the names from inside
- the work, and the reply ends with only what you have to do or decide.
- **What it helps with**
- - Bugs next to the change: the other code path that writes the same field, the webhook
- that arrives twice, the error that shows up as an empty list.
- - "Fixed" and "verified" that only meant "it compiles and the mocks pass".
- - An agent reviewing its own work in the same context that wrote it.
- - Many repos opened from one folder, where each repo's own rules and hooks don't load.
- - Prompts like "be 100% sure", which change how sure the answer sounds, not what gets
- checked.
- - Code nobody asked for: the extra cache layer, guard or option that becomes one more thing
- to maintain, and the next thing to break.
- - Replies too long, or too full of the agent's own names for things, to follow once you've
- looked away.
- ```
- /plugin marketplace add joetawil7/first-pass
- /plugin install first-pass@first-pass
- ```
- Then, in the folder where you start your sessions: `/first-pass:setup-first-pass`.
- ## Why I made this
- I built a product feature by feature with Claude Code. Every feature request ended with
- some version of "make sure the code is correct and bug free, cover all gaps, be 100% sure."
- Then I ran a full audit. It found **318 issues, 25 of them high severity.**
- When I sorted them, only 45 were mistakes in the lines being written. The rest were in the
- code around those lines:
- | What went wrong | Issues |
- | ----------------------------------------------------------------- | -----: |
- | Another code path using the same data was not updated | 54 |
- | Runs twice, runs at the same time, or stops halfway | 54 |
- | An outside service fails or is slow, and the error is hidden | 45 |
- | A plain mistake in the code itself | 45 |
- | Time, units, rounding | 26 |
- | Scale: no limit, no index, lists that stop at one page | 25 |
- | Endings: cancel, delete, expire, reconnect, downgrade | 19 |
- | UI, help, legal or pricing text that says what the code doesn't do | 18 |
- | Pipeline: CI red, no tests against a real database | 17 |
- | Hostile user or uncapped cost | 15 |
- (One private codebase, sorted by hand with one cause per issue. Your mix will differ.)
- Several of these had been found by earlier audits and fixed. Each fix patched one spot,
- and nothing carried the lesson into the next session.
- "Be 100% sure" changed how sure the answers sounded. It never made the agent open the other
- file that writes the same field, or ask what happens when the webhook arrives twice. So
- first-pass names those checks, and asks for proof before anything is called done:
- - **Ten questions before code** (the pre-mortem): twice, halfway, outside call, failure is
- not empty, neighbors, endings, money, hostile user, words, scale and time. Each answer is
- a `file:line`, a test, or "Not handled, because ___" for you to accept.
- - **A reviewer that didn't write the code.** Models are poor at catching their own mistakes
- in the context that made them ([Huang et al., 2024](https://arxiv.org/abs/2310.01798)),
- so the `breaker` agent reviews each change in a fresh context, starting from the other
- code paths that touch the same data.
- - **"Done" means a test that failed before the change**, the breaker's review, and CI's own
- checks passing in a clean checkout (or, with `/first-pass:quick`, the checks the change can affect). Short of that, it's reported as built, not done.
- - **A UI change is looked at running** before it's called done: the web at a desktop and a
- phone width, an app on each device class it ships to, with the browsers, simulators and
- devices this machine has. Setup writes them down in the machine block, and for each UI
- repo says what is missing to look at it (a Playwright browser, a simulator, a device tool)
- with its install command; it installs only what you say yes to.
- - **Local runs that reach real people are named.** Setup looks for what each repo could send
- for real (email, SMS, push, payments, publishing) and the switches that stop it, says
- "unknown" where it can't tell, and the standing yes for heavy runs never covers such a run.
- - **Bugs get fixed as a class**: reproduce, find the same pattern in the task's scope (the
- whole codebase when your own prompt asks for that fix, not when you pick it from a task's
- list), and add the
- helper, constraint or check that stops it coming back.
- ## What's in it
- | Piece | What it does | When |
- | --- | --- | --- |
- | `premortem` | The ten questions, answered against the code | Before code |
- | `breaker` (agent) | Fresh-context review of the diff and of every other path touching the same data; concrete findings only | Before done |
- | `ship-check` | The definition of done, ending in a report where every "Verified" line says what was run and its result | Before done |
- | `fix-the-class` | Reproduce, name the class, search for it in the task's scope (everywhere when your own prompt asks for that fix, not when you pick it from a task's list), run the ten questions on the fix, fix or record each hit, make it hard to repeat | On any bug |
- | `setup-first-pass` | Writes the rules once, a map of your repos, and a section per repo with its real commands, test limits and a drafted `INVARIANTS.md` | Once, then to update |
- | `habit-words` | Reads what you typed in your recent sessions and maps words like "be 100% sure" to the checks they should mean | At setup, then when due |
- | `sharpen` | Rewrites the prompt you type after it: numbered asks, habit words turned into checks, names and numbers kept exactly. Shows you the rewrite, then works from it | Only when you type it |
- | `review` | Reviews your own branch before you ask for review (type nothing after it), or a teammate's PRs, several repos at once. Checks the change against its ticket, judges the failed checks and every Bugbot comment, runs the breaker, traces the other code that uses what changed, proves each finding or marks it unproven, and says what the merge needs and how to check the deploy. Reads GitHub and never posts; pushes a fix only on your yes | Only when you type it |
- | `jev` | Sets up the optional Jev judge (TypeSafe's decision model), which `ship-check` asks whether a review finding is real harm, which small ones to fix now, and what proof a small fix needs | Only when you type it |
- | `hulk` | Lifts the task's scope for one task: searches, reviews and bug hunts go across the whole codebase, and problems found anywhere are handled as usual (for a pull request: `/first-pass:review hulk <what>`) | Only when you type it |
- | `quick` | Quick mode, until `/first-pass:quick off`: instead of CI's full checks, a change runs format, lint, types, build, its own tests and every unit, integration, flow and browser test that reaches what it touched; the rest of the suite is left for a full run, such as your pull request's CI | Only when you type it |
- | Parts runner | Runs CI's checks on your machine in the parts your repo's `.first-pass/parts.json` names (setup drafts it from CI): stages in order, a stage's parts side by side, each with its own port, run-named databases and logs, through your memory-capped runner if you named one (with one repo and no main folder, one part at a time inside it). It stops only what it started, and a part that needs another refuses to run until that one passed on the same checkout; `--tests` gives the steps that take a test list only chosen files, and `--no-tests` runs a part's other steps without them | When `ship-check` runs CI's checks |
- | Hooks | Run each repo's own hooks from the main folder, send back a "done" with no evidence, say what drifted at session start, and hold `sharpen`'s work until its rewrite is shown | Every session |
- ## If you keep all your repos in one folder
- A lot of us open one folder with every repo in it and start each session there. Claude Code
- then finds agents, skills and hooks only in that folder and above it: a repo's own
- `.claude/agents`, its `.claude/settings.json` hooks and its `.cursor/rules/*.mdc` imports
- never load, and its CLAUDE.md loads only once a file in it is read. first-pass is built for
- that:
- - **One set of rules at the root**, in `AGENTS.md` (imported by `CLAUDE.md`), loaded from
- the first message and updated in one place.
- - **A section per repo**, written from what setup finds in it: CI's exact commands, how to
- run one test, what the real tests need running, test limits, where its user-facing words
- live, and the same job done in two places. It loads when work reaches that repo.
- - **Each repo's own hooks still run.** Setup lists them and you approve each one. An
- approval pins the hook and every file in its script's folder: if a pull changes one, the
- hook pauses until you approve it again, and you and the agent are both told.
- - **Drift is reported at session start**: a repo's CI changed since its section was written,
- a new repo appeared, a hook was paused, a Cursor rule's copy fell behind, the rules are
- older than the plugin.
- - **One repo on its own works too**: setup writes the rules and the section into that repo.
- ## Your habit words
- Most of us have words we type out of habit: "be 100% sure", "don't assume", "full review",
- "all fine, right?". They name no place to look, so the answer sounds more certain without
- anything more being checked.
- `habit-words` reads what you typed in your last 20 Claude Code sessions, shows how often you
- use each phrase, what went wrong after it, and what to say instead. Then it writes a short
- block that maps each phrase to the checks it should trigger. You never have to type them
- again, and if you do, they mean the checks, not a more confident tone.
- What it reads and keeps:
- - Only your own transcripts in `~/.claude/projects`, and only what you typed, plus the end
- of the agent's reply before each prompt that pushes back on it. Tool output, pasted text,
- notifications and script-started runs are left out.
- - Anything that looks like a key, token, password, email or phone number is replaced before
- the text goes into a temp file (best effort, so the skill also never quotes one). The
- skill deletes the file when it's done.
- - The block holds only your phrases and the checks, and never goes into a file your
- teammates share.
- ## What it writes to your machine
- - `AGENTS.md` and `CLAUDE.md` at the root (the rules and, if you want them, the reply style
- and your habit words), and a section in each repo's `CLAUDE.md` or
- `AGENTS.md`, all between `first-pass` markers. Outside the markers it adds only import
- lines, and it lists each one it adds.
- - The machine block in your `~/.claude/CLAUDE.md`, in every mode: this machine's answer on
- heavy runs (in every project on it, except a server, a worker or an end-to-end or integration
- run in a repo with no first-pass section, or whose real-people line says "unknown" or is
- missing, which asks first), how a run is bounded and stopped here (a wrapper named there is
- the one the parts runner starts each part through in a main folder), and what can look at a UI (browsers,
- simulators, emulators, device tools) or is missing for it. It describes your machine only, so it never goes in
- a file your teammates share.
- - `INVARIANTS.md` in each repo (a draft for you to review), `.first-pass/workspace.json` at
- the root, and `.claude/cursor-rules/*.md` copies where a repo imports `.mdc` files.
- - `.first-pass/parts.json` in a repo whose CI checks split into parts, for the parts runner, and
- the runner's logs, marks and lock files in `first-pass-parts` in the system temp folder. They
- stay there after a run, so you can read them. Delete the folder only when no run is going:
- a killed run's leftovers (a file it wrote in the checkout, a test database) are cleaned up by
- the next run of that part only while its record is there.
- - A small state folder in `~/.claude/plugins/data/` for the hooks, and a temp file while
- `habit-words` runs, deleted when it's done.
- - `~/.claude/first-pass/jev.json`, only if you set up the Jev judge: which variable holds
- your key, and for which repos. Never the key itself.
- Setup never commits or pushes, and sends nothing anywhere except one test request per key
- to TypeSafe if you set up the Jev judge: you review the files and commit them. The plugin's own
- scripts make no network calls and read no keys or tokens from your environment (the parts
- runner runs your repo's own test commands, reads only the keys its recipe names from your
- repo's env file, and checks only that a test server on this machine answers), with one
- exception you have to switch on: the Jev judge reads the one key you named and sends review
- findings (with secrets, emails and phone numbers blanked) to TypeSafe's API, from
- `ship-check` and `jev`. Setup's survey reads only the variable names in the example env files
- a repo commits (`.env.example` and the like), never a value and never your real `.env`. Besides that, the only skill that reaches a server is `review`: it
- reads the PRs, checks and comments through your own `gh` login, and it pushes a fix only
- when you picked that fix and said yes to the push.
- ## Install
- ### Claude Code
- ```
- /plugin marketplace add joetawil7/first-pass
- /plugin install first-pass@first-pass
- ```
- From a terminal: `claude plugin marketplace add joetawil7/first-pass`, then
- `claude plugin install first-pass@first-pass`. To update later:
- `claude plugin marketplace update first-pass`, then `claude plugin update first-pass@first-pass`.
- The hooks need Node.js 18 or later on your PATH. The tests run on Windows and Linux.
- ### Cursor, Codex and other agents
- ```
- npx skills add joetawil7/first-pass -a cursor --copy # this project
- npx skills add joetawil7/first-pass -a cursor --copy -g # every project
- ```
- This uses the [skills CLI](https://github.com/vercel-labs/skills). Swap `-a cursor` for your
- agent (`-a codex`, `-a windsurf`, ...). `--copy` writes real files instead of symlinks,
- which Windows checkouts turn into plain text. Don't add `-a claude-code` if you use the
- plugin, or you'll get every skill twice. Other tools get the rules and skills; the hooks are
- Claude Code's.
- ### Then run setup once
- In the folder where your sessions start: `/first-pass:setup-first-pass` (or
- `/setup-first-pass` outside Claude Code). It looks through your repos, asks only what the
- code can't tell it (which repos have a UI, which depend on which, which repo hooks to run),
- and writes the files above. Re-run it after an update: your own text, each repo's section and
- `INVARIANTS.md` are kept.
- ### Teammates
- Once a repo's files are committed, every teammate's agent loads its section. Tell setup
- which repos people open on their own: those also get the rules and a copy of the breaker.
- Each person installs the skills: the plugin for Claude Code, the `npx skills` line for
- Cursor.
- ## Day to day
- 1. **Plan.** Ask for the change. The agent runs the pre-mortem before it edits. Read the
- "Not handled, because" lines: those are your calls.
- 2. **Build**, with the tests the pre-mortem named, each one failing on the old code first.
- 3. **Done.** `ship-check` runs the breaker and, while it works, CI's checks in a clean
- checkout (in CI's own parts side by side, when the repo has a parts recipe), when your repo's test limits and your machine's limit on heavy runs at once allow both. Nothing is committed to your
- branch before the review's result is handled unless you say to ship it as it is, and
- nothing is called done before it either way. Then it reports
- `Verified: <what was run> → <result>` and what wasn't verified.
- 4. **Bug.** `fix-the-class` fixes the one you found, the others like it, and adds the check
- that stops the next one.
- 5. **Review.** On your own branch, `/first-pass:review` with nothing after it reviews your
- work against its base, its PR, its checks and the ticket in the branch name, and ends
- with what to fix before you ask for review. On a teammate's PR, add the links and what's
- live, for example *"/first-pass:review backend#147 web#151, live today: no agency
- workspaces"*: the same checks, plus a message you can send the developer. Every finding
- comes with its proof, or is marked unproven, and says whether users can hit it today. A
- PR from a fork or an outside contributor is read, never run, unless you say yes, since
- running it would run a stranger's code with your logins. The report also says what
- changes for users, what the merge needs (a new app build, env vars, migrations, deploy
- order), what to check after the deploy, and which of the ten questions and which
- neighboring code were checked. It reads GitHub but never posts, and it fixes something
- only when you pick it after the report.
- Instead of "make sure it's bug free", try: *"Run the pre-mortem, show me the tests that fail
- without the change, and list what you didn't verify."*
- Or write the prompt the way you would anyway and put `/first-pass:sharpen` in front of it
- (`/sharpen` in Cursor). It splits a message that mixes three asks into a numbered list,
- turns the habit words into the checks they stand for, shows you the rewrite, and works from
- that. It stops to ask only when it would have to guess, and it never adds work you didn't
- ask for. In Claude Code a hook holds back edits, shell commands, subagents, MCP tools,
- publishing, scheduling and other skills until the rewrite is on screen (reading files is
- never held back): with the
- instruction alone, the rewrite was skipped in 7 of my 11 test runs.
- If you have a [TypeSafe](https://docs.typesafe.ai) API key, `/first-pass:jev` turns on a
- second opinion for `ship-check`: Jev, a model that only picks from a list and says how sure
- it is, judges whether each review finding is real harm, which small ones are worth fixing
- now, and what proof a small fix needs (the checks alone, a unit test, a real-database test
- or a browser test). It is cheap and fast, but when I had it sort 269 audit issues it gave
- more weight to how many people meet an issue than to how bad the harm is. So it can make a
- finding serious, never clear one the reviewer called serious, and when it is unsure or
- fails, the rules decide as if it weren't there.
- ## How the rules were tested
- I test a rule the way I'd test code: fresh Claude Code sessions and agents (Opus, high
- effort) that load nothing else, hidden checks they never see, and judges who read the
- output blind.
- - **Less code nobody asked for.** 52 runs on two tasks (add caching to a product page, add
- coupons to a checkout). The runs compared first-pass alone, first-pass with
- [ponytail](https://github.com/DietrichGebert/ponytail), and versions of the "does it need
- to exist?" rule.
- - Every hidden correctness check passed in every run, except one about declined cards.
- That check failed in 15 of the 32 coupon runs, across every setup, and it tested my
- fake payment gateway more than the code.
- - On caching, a blind judge counted about 10 lines per run that nobody asked for with
- first-pass alone, and 3 with the rules that ship.
- - On coupons, the code added after the reviewer's findings went from 6 lines per run to 3.
- - The tests the agent wrote caught 18 of 18 planted bugs with the shipped rules. With
- ponytail installed, 2 of 30 got past them.
- - One rule I expected to help, "a promise in the docs counts as a real need", made the
- code about 40% bigger, so it's not in.
- - **Plain replies.** 10 real replies were rewritten under the old and the new reply rules.
- Two fresh judges, reading like a smart 15-year-old, picked the new version 16 times out
- of 20, rated it clearer (3.3 vs 3.0 out of 5) and got lost on fewer phrases (150 vs 175).
- The catch: 7 times it held back something that mattered, so the rule now says never to
- hold back a risk, a failure or a decision that's yours.
- - **The reviewer still reports every bug in the change** (measured before 0.6's scope
- rule). In 3 runs on a small change with 8 planted
- bugs, all 8 were in every review and in every final reply.
- These are small samples on small tasks. They show the rules do what they say, not how much
- they help on your code.
- ## What it won't do
- - **It's slower per change.** A test that fails first, a second agent's review and CI in a
- clean checkout take time and tokens. On a small demo repo, fixing one double-charge bug
- with `fix-the-class` and then running `ship-check` used about $29 at API list prices
- (three reviewer passes). The trade is fewer rounds after "done". The pre-mortem scales
- with the change: a copy tweak answers it in one line. To keep the cost down, a prompt with
- several items builds them all first, then reviews them while CI's full checks run in one
- clean checkout holding them all. A later fix reruns only the checks it can affect, and the
- full checks run once more on the final change: nothing is committed before them unless you
- say to ship it as it is, and nothing is called done before they pass. `/first-pass:quick`
- trades the full checks for the ones the change can affect and leaves the rest of the suite
- for a full run, such as your pull request's CI. During the work, only serious findings (money, data, something done twice or sent
- wrong, security, legal, a crash, stuck work, the change not doing its job) are fixed and
- checked again; those only a rare path reaches, found after the first review, are collected
- and fixed together in one batch with one review, and a rare one that batch's review or a later
- review of the same change finds comes to you first on the list instead of starting another
- round; nothing ships until you answer, and the change stays not done while it's unfixed. The smaller ones
- come to you once, as one list at the end, and the ones you pick get one review together.
- Before this, a reviewer finding a small case, a question to you, a fix and another review
- of that fix could chain for hours: in one two-day stretch, about a third of 84 reviews
- found only small points, and most of them still started another round.
- Questions to you wait until nothing else can move (`sharpen` and setup still ask before
- they start, and a failed commit, push or deploy still stops the work at once): each one stops the session until you
- answer, and in three sessions over three days, 17 of 70 sets of questions waited an hour or
- more. So the agent first does every part that doesn't depend on your answer, then asks
- what's left in one set.
- - **It won't make code bug free.** The aim is fewer and smaller escapes: no high-severity
- ones, no bug class found twice. This is version 0.9, so that's the design, not a measured
- result yet.
- - **Rules alone fade.** The fixes that last are the ones `fix-the-class` pushes toward: a
- shared helper that's the only way to do a thing, a database constraint, a CI check.
- - **Shell edits are seen late, and not all of them.** A file a shell command changes
- (`sed -i`, a heredoc, a copy, a formatter) is found at the end of the turn, from
- `git status` and the file's time, so the done check and end-of-turn hooks see it; hooks
- that run after each edit don't. Not seen: files git ignores; on Windows, a copy
- (`Copy-Item`, `copy`) over a file git showed no change in, which keeps the source's
- times; writes from a command still running in the background after it returned; from a
- main folder, a repo the command neither runs in, `cd`s into nor names a path in; and, in
- a single repo, any other repo. Counted anyway: a file rewritten with the same content
- (`git stash`, then `git stash pop`); another program's write or delete while a shell
- command runs; and after you refuse a command, writes until your next prompt. A delete is
- dated by its folder, so a later change in the same folder can count or hide it.
- ## Related
- - [superpowers](https://github.com/obra/superpowers): a full development method for coding
- agents, as skills.
- - [anthropics/skills](https://github.com/anthropics/skills): Anthropic's examples of skills.
- - [ponytail](https://github.com/DietrichGebert/ponytail): makes coding agents write less
- code. first-pass's "does it need to exist?" rule came from testing against it.
- - [i-have-adhd](https://github.com/ayghri/i-have-adhd): replies shaped so you can act on
- them. first-pass's reply rules borrow its check of the first and last lines.
- - Huang et al., [Large Language Models Cannot Self-Correct Reasoning Yet](https://arxiv.org/abs/2310.01798) (ICLR 2024)
- - Tambon et al., [Bugs in Large Language Models Generated Code](https://arxiv.org/abs/2403.08937)
- - Anthropic, [Best practices for Claude Code](https://code.claude.com/docs/en/best-practices)
- ## Feedback
- If you try it and it gets in your way, [open an issue](https://github.com/joetawil7/first-pass/issues)
- and tell me where. Reports of a bug that got past all of this are the most useful kind.
- ## License
- [MIT](LICENSE)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.