Hard Eng Ship
Contract
- Input =
heroute + approved PLAN +lifecycle_status=green+ exact green snapshot +inspecthandoff=shipblock (root, branch, plan,BUILD.md, prompt). - Output = verified repository-policy delivery +
shipped, or return tohe-build. - Owner = sync + snapshot continuity + publish gates + verified commit/push/PR/CI/merge + delivery receipt.
- Code/test/doc fixes =
he-build; ship never patches a failing artifact. - Decomposed epic ticket = this same contract, scoped to the ticket's
green_artifact; epic ships only after every ticketshipped+T-intgreen= workflow.mdTicket Ship/Epic Closure. - Load workflow.md before shipping or resume.
Invariants
- Commit/push/PR/merge/publish + named deploy + recoverable live data/schema work = continue once target/effect are known; protected approval is not required.
- Stop boundary = permanent data/file/schema deletion + uncommitted-work loss + force push/remote history loss + secret exposure → fresh exact approval.
- Fresh exact approval receipt = one matching irreversible destructive call only; changed input + repeat require another stop.
- Unrequested irreversible destructive delivery action = state exact target + permanent effect → ask once.
- Ready-to-build approval ≠ irreversible destructive authorization; missing material delivery choice = one decision.
- Explicit terminal delivery outcome persists across recoverable build/CI failures, retries, and turn boundaries; one failed attempt never narrows the goal.
- Missing project gate manifest/family = invalid green snapshot →
he-build+deterministic-checksgate-migration; Ship never wires it. - Sync/content/CI change →
he-buildfinal loop; green evidence becomes stale. assert-green= working artifact at Ship entry;assert-green --delivered-head= post-commit HEAD/index/worktree exactness before push; either failure returns tohe-build; mutation strength = committedmutation-ledger.jsonread by thepublishpush gate (deterministic-checksmutation.md), never a ship-entry receipt.- Read
features/<slug>/BUILD.mdbefore delivery; it is the human summary of every slice's edge, green, review, and verify records. - Publish gate =
deterministic-checkspublishPASS on exact intended diff. - Delivery SHA = remote product artifact identity; later local lifecycle-state bytes are not part of that artifact.
- Force push without exact protected approval + bypassed hook/check + hidden path + fabricated remote result = forbidden.
- Rollback + observability + protected-boundary evidence = retained through delivery.
- Process learning = record + defer without blocking unless continued delivery risks a protected boundary.
- Stop = user override OR protected-boundary stop OR exact external authority blocker; deterministic product/tool failure →
he-build+ resume Ship.
Complete
- Delivered artifact = exact green reviewed snapshot.
- Remote ref/PR/merge + required CI = verified.
- Repository delivery contract = satisfied.
helocal checkpoint =lifecycle_status=shipped+ delivery SHA/URL/result innext_action; it does not rewrite delivered artifact identity or imply another commit.