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 — no confirmation prompt. 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