| name | pre-pr |
| description | Run mandatory pre-PR quality checks for .NET projects before creating a pull request. Use before creating any PR, or when the user says "prepare for PR", "pre-PR checks", or "quality gate". |
| disable-model-invocation | true |
| argument-hint | [solution or project path] |
Prerequisites
Check that required tools are available:
which roslynator
which quickdup
If roslynator is not found:
dotnet tool install -g roslynator.dotnet.cli
If quickdup is not found:
- macOS/Linux:
curl -sSL https://raw.githubusercontent.com/asynkron/Asynkron.QuickDup/main/install.sh | bash
- From source:
go install github.com/asynkron/Asynkron.QuickDup/cmd/quickdup@latest
About
This is a mandatory quality gate to run before creating any pull request in a .NET project. It ensures code is analyzed, compiles cleanly, tests pass, duplication is checked, and code is formatted — in that order.
Do NOT skip any steps. Do NOT create a PR if any step fails. Iterate until all checks pass.
Determine Paths
If $ARGUMENTS is provided, use it as the project/solution path. Otherwise, look for a .sln or .csproj in the current directory.
Also determine the source directory for quickdup scanning (typically src/ or the project root).
Step 1: Roslynator Fix
Run static analysis and auto-fix code issues:
roslynator fix $PROJECT_PATH
Then verify compilation:
dotnet build $PROJECT_PATH
If build fails: Fix the issues and rerun roslynator before proceeding.
Step 2: Run Tests
dotnet test $PROJECT_PATH
Handle failures:
- Flaky tests: Rerun to confirm
- Broken tests: Fix before proceeding
- All tests MUST pass before moving to step 3
Step 3: Check for Code Duplication
quickdup -path $SOURCE_DIR -ext .cs -select 0..20 -min 2 -exclude ".g.,.generated."
If new duplications are found:
- Refactor to eliminate duplications (see
/quickdup for refactoring patterns)
- Go back to Step 1 (roslynator fix)
- Repeat until no new duplications
Step 4: Format Code
dotnet format $PROJECT_PATH
Step 5: Final Verification
Confirm all checks passed:
Step 6: Create PR
Only after ALL checks pass, create the pull request.
Important
- Do NOT skip any steps
- Do NOT create PR if any step fails
- Steps are ordered intentionally — roslynator before build, build before test, duplication check may loop back to step 1
- Iterate until all checks pass
