arthai-marketplace

/precheck

Run local tests before pushing. Catches CI failures locally in ~30 seconds instead of a 4-minute CI round-trip.

Synopsis

/precheck [--skip-revert-check]

When to use it

Every time before pushing a branch or creating a PR, /pr expects a passing precheck
After finishing a change, to know in seconds whether CI would fail
Not for: full-codebase validation, that’s /qa full; or fixing a CI run that already failed, that’s /ci-fix

Quickstart

/precheck

What you’ll see: a revert-safety check, then the test suites relevant to your changed files, ending with ✓ Precheck passed (N tests, Xs) — Ready to push. On success it also records a pass marker, then automatically commits, pushes, opens a PR, squash-merges it, and deletes the branch without asking for confirmation. If you want to review the PR on GitHub before it merges, stop the skill after the pass marker is written, or use /pr for a create-only flow.

Examples

/precheck                       # standard run — pick suites from the diff, test, then ship
/precheck --skip-revert-check   # you intentionally deleted recently-merged code (refactor)

Arguments & flags

Flag	Values	Default	What it does
`--skip-revert-check`	:	off	Skips the accidental-revert detection when a deletion is intentional

What it does

Revert check, runs /revert-check in strict mode to catch stale-buffer or bad-stash-pop changes that would silently undo recently-merged PRs. A failure here stops everything and shows the suspected files.
Detects what changed, diffs your branch against main to find the touched files.
Selects the relevant test suites, only the tests that cover what you changed; falls back to the full mechanical run when changes span multiple areas. Refuses to run on main (asks you to branch first).
Runs the tests and reports pass/fail per suite.
On pass: writes the .claude/.precheck-passed marker (the toolkit’s routing checks this before allowing /pr), then proceeds to the full ship sequence, commit, push, PR, squash-merge, and branch cleanup (git checkout main && git pull && git branch -d {branch}), without re-asking.
On fail: removes any stale pass marker and lists the failing tests. It will not push with failures.

Output & artifacts

.claude/.precheck-passed, timestamped pass marker consumed by /pr
Test run output in the conversation; on the ship path, a merged PR with the branch deleted and main checked out locally

Troubleshooting

Problem	Fix
`Switch to a feature branch first`	Precheck refuses to run on `main`: `git checkout -b my-change` and re-run
Revert check flags files you deleted on purpose	Re-run with `/precheck --skip-revert-check`
Tests pass locally but `/pr` still complains	The pass marker is stale (new commits since the run): re-run `/precheck`

/qa, deeper, multi-agent quality checks before shipping
/pr, use this instead of /precheck when you want to create (or update) a PR without also triggering the auto-merge; /precheck still expects /pr-created PRs to have a passing precheck marker
/revert-check, the safety check precheck runs first (standalone usage)
Workflow guide: Ship code