# Ship

> Ship phase. Runs isolated integration test in a fresh worktree, creates a PR with full spec + audit report in the body, watches CI, and auto-fixes failures.

- **Type:** Skill
- **Install:** `agentstack add skill-epicsagas-epic-harness-ship`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [epicsagas](https://agentstack.voostack.com/s/epicsagas)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [epicsagas](https://github.com/epicsagas)
- **Source:** https://github.com/epicsagas/epic-harness/tree/main/skills/ship
- **Website:** https://crates.io/crates/epic-harness

## Install

```sh
agentstack add skill-epicsagas-epic-harness-ship
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Ship — Ship It

**CRITICAL**: Run `HARNESS_DIR=$(epic-harness path)` first. NEVER use `.harness/` in the project directory.

## Process

### Step 0: Prerequisites

Load the spec for PR content:
```bash
ls -t $HARNESS_DIR/specs/SPEC-*.md | head -1
```

**Gate: audit must have passed.** If no audit report exists, invoke the **audit** skill before continuing.

### Step 1: Pre-ship Verification

**1a. Isolated Integration Test**
Launch an agent with `isolation: "worktree"` to verify in a clean environment:
- Run full build from scratch (`cargo build --release` / `npm run build` / etc.)
- Run complete test suite
- Run linter and formatter checks
- Verify no uncommitted artifacts

**Gate:** If isolated test fails → STOP. **"Fix with `/go`, then re-run `/audit` before shipping."**

### Step 2: Git Hygiene

- Ensure all changes are committed (Conventional Commits)
- Rebase on latest base branch if needed
- Squash fixup commits if appropriate

### Step 3: Create PR

```bash
gh pr create --title "" --body "$(cat 

## Spec
- Spec ID: SPEC-{timestamp}
- Requirements: R1, R2, ...

## Changes

## Acceptance Criteria Verified
- AC1: ✅
- AC2: ✅

## Audit Report

## Test Plan
- [ ] Unit tests pass
- [ ] Integration tests pass
- [ ] Manual verification done
EOF
)"
```

### Step 4: CI Verification

```bash
gh pr checks  --watch
```

If CI fails, diagnose and fix automatically. Retry up to 2 times.

### Step 5: Report

```
## Ship Report
- Spec: SPEC-{timestamp} ({goal_slug})
- PR: 
- CI: [PASS/FAIL/N/A]
- Ready to merge: [YES/NO]
- Action needed: 
```

**If inside `/orbit`**: Return control to orbit — it will run evolve automatically.

**If standalone**: Suggest **"Run `/evolve` to analyze this session."**

## Anti-Rationalization

| Excuse | Rebuttal | What to do instead |
|--------|----------|-------------------|
| "CI will catch it" | CI doesn't catch everything | Run isolated test locally first |
| "The PR description doesn't matter" | It's the permanent record of why | Include spec + audit report |
| "I'll merge without CI" | CI is a safety net | Wait for CI, fix failures |

## Evidence Required

- [ ] Isolated test passed in clean worktree
- [ ] PR created with spec + audit report in body
- [ ] CI status checked (PASS, FAIL with fix, or N/A)
- [ ] All Conventional Commits applied

## Red Flags

- Shipping without a PASS audit report
- PR description that says "various fixes" or "updates"
- Force-pushing to main
- Merging with failing CI
- PR body missing the Audit Report section

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [epicsagas](https://github.com/epicsagas)
- **Source:** [epicsagas/epic-harness](https://github.com/epicsagas/epic-harness)
- **License:** Apache-2.0
- **Homepage:** https://crates.io/crates/epic-harness

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-epicsagas-epic-harness-ship
- Seller: https://agentstack.voostack.com/s/epicsagas
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.