What problem does it solve?
It prevents risky releases by enforcing a consistent pre-merge pipeline that validates, summarizes, and opens a pull request only when quality checks and tests pass.
Core Features & Use Cases
- Pre-flight safety checks: Blocks shipping from main/master, verifies git readiness, ensures there are commits ahead of the base branch.
- Test gate with smart SKIP behavior: Runs common test runners automatically (Makefile, npm, pytest, Go, bats) and blocks on test failures while marking “no tests found” as SKIP.
- Quality gate for diff hygiene: Scans the proposed changes for likely secrets plus warnings for TODO/FIXME/debug artifacts, requiring user confirmation for warnings.
- Diff summary and scope discipline: Produces a clear summary of commits/files/line changes to support reviewer confidence.
- Versioning and changelog updates (optional): Detects VERSION/package.json and CHANGELOG.md, then prompts to bump version and updates changelog based on conventional commits.
- Delegated commit + PR creation: Hands off to commit-commands:commit-push-pr to stage only specific files, avoid git add -A, and follow PR formatting conventions.
Quick Start
Tell the AI to run ship by invoking the command to execute the pre-merge pipeline and open a PR when all required gates pass.