Solverr

Write Solverr's Handoff.md so a fresh session resumes cleanly, and bring the CHANGELOG, dependent docs, and memory store in line with it. Use when the session is wrapping up ("I'm stepping away", "continue tomorrow", "wrap up"), before a `/clear`, when a long session has accumulated state that would be lost, or when the session is looping on a broken approach and a fresh agent would do better. Offer it proactively on those signals; do not wait to be asked.

Estimate per-turn token cost of this project's `.claude/` configuration and `CLAUDE.md`. Reports always-loaded vs path-scoped vs invoked-only, ranks the top contributors, and flags entries over budget. Add `--api` for exact counts via Anthropic's count_tokens endpoint instead of the chars/4 heuristic.

Verify a change against live Cloudflare challenges through a running Solverr, because the unit tests cannot reach the thing that actually breaks. Builds an isolated container, runs the matrix (interstitial on both engines, Turnstile, PDF, passthrough, cookie shape), and proves each mechanism with a controlled A/B rather than a single pass. Use after any change to the engines, detection, sessions, or the passthrough, and before cutting a release. Never touches the owner's own solverr container.

Cut a Solverr release end to end. Decides the SemVer bump from what is in [Unreleased], runs the preflight, rewrites the CHANGELOG section, bumps package.json, commits, pushes, tags, then verifies both workflows and the published image digests. Use when the owner asks to cut, ship, or publish a version. Pushing the tag publishes the GitHub Release and the ghcr image, so it always confirms before that step.

Investigate a non-trivial task, then produce the plan for it. Emits a file:line-cited findings report covering current behavior, the upstream equivalent in FlareSolverr or Byparr, the engine and event-loop constraints that bind the approach, helpers to reuse, stale docs, then a sequenced plan and any blocking open questions. Use before porting an upstream change, touching the engines or session lifecycle, or any change that crosses the controller. The point is to ground the plan in evidence, not memory. Investigates deeply and verifies adversarially by default; never edits files.

Trim verbose prose, walls of text, journey narration, and WHAT comments from docs and code without losing vital info. Targets markdown files (docs, CLAUDE.md, rules, skills, agents) and, when asked, code comments / docstrings. Applies the "WHY not WHAT" rule, the "describe current behavior not the journey" rule, and the "release notes not implementation rationale" rule from `.claude/rules/workflow.md` and `.claude/rules/code-quality.md`. Use after a feature lands and the docs around it have accumulated cruft, or when a file feels heavier than it earns. Always plans before editing.

Audit Solverr against its two upstreams for drift. Compares the stealth engine against Byparr and the Chrome engine, sessions and the /v1 surface against FlareSolverr, classifying every difference as already covered, genuinely missing, or deliberately divergent, and checking that the /v1 request and response shape is still byte-compatible. Use when either upstream has moved, before a release, when a fix lands upstream that might apply here, or when the owner asks whether Solverr has fallen behind. Ends by updating the sync ledger.