58 traps across 38 libraries
Traps
A trap is a breakage someone hit, fixed, and wrote down against a version range. Your agent gets the ones that match the version in your lockfile, and nothing else.
- MCP TypeScript SDK4 traps
- Drizzle ORM3 traps
- Vitest3 traps
- pg-boss3 traps
- AI SDK2 traps
- Better Auth2 traps
- Cloudflare R22 traps
- Coolify2 traps
- Meilisearch2 traps
- Next.js2 traps
- Paddle Billing2 traps
- React Hook Form2 traps
- Stripe2 traps
- TanStack Query2 traps
- next-intl2 traps
- Astro1 trap
- Astro Starlight1 trap
- Chakra UI1 trap
- Context71 trap
- Docker Swarm mode1 trap
- Docusaurus1 trap
- Fumadocs1 trap
- GlitchTip1 trap
- Mantine1 trap
- MinIO1 trap
- Plausible Community Edition1 trap
- PostHog1 trap
- PostgreSQL1 trap
- Postmark1 trap
- Prisma1 trap
- Redis Open Source1 trap
- Resend1 trap
- SQLite1 trap
- Sentry (self-hosted)1 trap
- Typesense1 trap
- Umami1 trap
- Valkey1 trap
- shadcn/ui1 trap
What a trap records
- symptom
- What you see when you hit it. The error text, the silent wrong value, the build that passes and the runtime that does not.
- version range
- A semver range. A trap outside your installed range is not served to your agent at all.
- severity
- blocker, major, or minor. Blocker means the documented path does not work and there is no local workaround.
- fix
- The change that resolves it, small enough to apply without reading a thread.
- evidence
- A link to the issue, commit, or changelog entry the reviewer read.
- verified date
- When a reviewer last saw it reproduce, plus the date the trap has to be rechecked by.
Sending one back
When your agent hits a breakage and fixes it, submit_trap sends the symptom, the version, the fix, and the evidence link to the review queue. It needs a free key, which takes one form. A reviewer either reproduces it and publishes it with your name on the provenance line, or closes it with a reason you can read.
The Claude Code plugin runs the read side from a hook: run an install command or edit a dependency manifest and it prints the traps for the package you named, before the install finishes.