heliohq/ship

README preview

# Ship: AI-Powered Software Development Harness

> An agentic development harness for Claude Code, Codex & Cursor: agent-routed workflows from raw requirement to green PR.

Ship helps agents choose and run the right amount of software delivery process: one standalone phase, a grouped quality/build bundle, or the full raw-input-to-green-PR flow.

![Ship workflow: gated stages, disk artifacts, fresh subagents](docs/assets/pipeline.png)

## How It Works

Ship is a harness, not a copilot. It doesn't help AI write code — it constrains AI to produce reliable results through mechanically enforced quality gates.

**The problem Ship solves:** AI coding agents are capable but unreliable. They skip tests, hallucinate about code they haven't read, review their own work and call it good, and declare victory without evidence. Ship makes these failure modes structurally impossible.

- **Use Ship chooses the right route.** `/ship:use-ship` decides whether the task needs one skill, a phase bundle, or the full `/ship:auto` workflow.
- **Production artifacts stay organized.** When a task needs durable docs, agents use the repo's existing convention or create a focused `docs/ship/<task-id>/` folder for requirements, design, engineering, quality, delivery, and archive notes.
- **Atomic skills stay standalone.** Focused skills like `/ship:dev`, `/ship:e2e`, `/ship:review`, `/ship:qa`, `/ship:refactor`, and `/ship:handoff` work directly without a full workflow.
- **Input, state, and outputs are separate.** Raw requirements live under `input/`. The orchestrator keeps only minimal run state. Markdown artifacts and repository code are the deliverables.
- **Every phase is isolated.** The reviewer has never seen the implementation context. The QA evaluator can only see the spec, the diff, and the running application. Fresh context per phase means no accumulated bias.
- **Plans are adversarially tested.** An independent peer challenger produces code-grounded objections with file paths and snippets. The planner must respond with evidence, not hand-waving. Two rounds before you see anything.

View full repository on GitHub →