hamen/ship-feature

ship-feature is a workflow and small command line tool for teams that use AI coding agents like Claude, Codex, or Cursor to make changes to a codebase. Instead of each agent inventing its own process for planning, reviewing, and merging changes, ship-feature writes that process down once, in a single file called WORKFLOW.md, and gives each agent a thin adapter that points to it. The workflow itself has seven steps: plan the change, have a second agent review that plan, get your approval as a human, implement the change in a separate worktree and open a pull request, run cross review and tests while any real problems remain, merge the change yourself, and finally verify the result on the merged commit. Only two of those steps require you personally to step in and approve something: approving the plan before any code is written, and approving the actual merge. The agent is never allowed to merge its own work under this process. The cross review step is handled by a separate related project called pr-review-relay, which this tool requires to already be installed and available on your system path. ship-feature's own command line tool adds a preflight check that confirms you are working in a proper feature branch before you start, a way to send an implementation plan out to several agents at once for a read only review, and a transparent wrapper around pr-review-relay that preserves its normal output and exit codes while explaining what each one means to you. Installation is done by cloning the repository and running an install script, which links the command line tool, copies the workflow file and a matching skill definition into your agent configuration folders, and adds a marked section to your Codex configuration if you use it. The project includes two separate privacy scanning scripts: one that runs automatically in continuous integration to catch accidentally committed emails or file paths, and one meant to be run locally before publishing that checks your full history against a private list of things to scrub first.