// Turn a feature branch into a clean, reviewable PR. Squash WIP commits, polish messages, verify green checks, draft PR description. Invoke right before opening a PR.
| name | pr-ready |
| description | Turn a feature branch into a clean, reviewable PR. Squash WIP commits, polish messages, verify green checks, draft PR description. Invoke right before opening a PR. |
Take a feature branch from "it works on my machine" to "ready for human review."
Before anything else, run these — in parallel where possible. Block on any failure:
<FILL IN from AGENTS.md> # lint
<FILL IN from AGENTS.md> # typecheck
<FILL IN from AGENTS.md> # test
<FILL IN from AGENTS.md> # build
Paste tail of each into a scratch note — you'll put it in the PR body.
git log --oneline origin/<base>..HEAD — read all commits on the branch.feat(scope): add rate limiterfix(scope): idempotency on /checkoutchore(deps): bump react to 19.2docs(readme): update deploy sectionrefactor(db): extract query buildertest(api): cover 429 pathgit rebase -i origin/<base> — do the cleanup. Force-push with --force-with-lease.Fetch the template:
git_pr fetch_template # if using Devin tools
Otherwise follow .github/PULL_REQUEST_TEMPLATE.md.
Fill each section:
Close with the passed checks:
✅ lint — 0 errors, 0 warnings
✅ types — 0 errors
✅ tests — 142 passed, coverage 84.3%
✅ build — succeeded, bundle 2.1 MB
(Yes, the check emojis are fine here — this is PR formatting, not prose.)
feat / fix / chore / docs / breaking / securityAdd BREAKING CHANGE: section to the PR description with:
@reviewer.Use ast-grep for structural (AST-aware) code search and refactoring instead of plain ripgrep when the intent depends on code structure — not just text matching. Triggers on refactors, codemods, "find all X that don't Y", or any search where naive grep would miss edge cases.
Guides proactive /compact usage with preservation instructions to prevent context rot in long Cascade sessions. Triggers when context reaches ~50% of window, before large tool outputs, or when the user mentions "context", "compact", "drift", or "forgetting".
Use when any non-trivial task (>20 LOC or >1 file) would otherwise be done without a persistent plan. Produces and maintains a markdown plan file that survives session compaction and restarts. Based on the Manus-style planning pattern popularized by OthmanAdi/planning-with-files (18.4k⭐).
Scan a diff, branch, or working tree for leaked secrets, API keys, tokens, private keys, and PII before commit. Blocks the operation on CRITICAL findings, warns on MEDIUM. Pairs with the pre_commit hook.
Fill test coverage gaps to hit the project's target (AGENTS.md says ≥80% on src/). Reads existing tests to match style, prioritizes public-API and error paths, runs the suite after every batch.
Read the project wiki (vault/) before starting any non-trivial task. Surfaces relevant decisions, ownership, incidents, and glossary entries for the task at hand.