# Delivery

> Adaptive, resumable Git delivery across repositories and agent runtimes — probe policy, checkpoint coherent work, publish, review, integrate, and verify cleanup

- Skill: `shenxingy/delivery-2` (Agent Skill, multi-file: 9 files)
- Install (CLI): `npx skillmds@latest add shenxingy/delivery-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/shenxingy/delivery-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: shenxingy (https://skillmd.com/u/shenxingy)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/shenxingy/delivery-2

---


# Delivery

Clade's provider-neutral Git delivery control plane. It adapts to the target
repository, forge, event, branch ownership, worktree, and runtime before
changing state. It preserves useful work promptly without treating a commit as
permission to push, open a PR, merge, or delete a branch.

## Invariants

- Probe before acting; `unknown` never means allowed.
- One session owns one mutable branch/worktree.
- A coherent slice ends in a commit, detached reachable ref/snapshot, patch, or
  explicit blocker—not an undocumented dirty tree.
- Checkpoint verification is focused; candidate verification is complete and
  bound to the exact head SHA.
- PR creation is idempotent, merge is an explicit integrator action, and
  cleanup is verified.
- Repository policy and explicit user authority outrank Clade defaults.
- Authority granted after START is recorded through the audited `authorize`
  transition; never edit delivery state directly.
- When an orchestrator attempt exists, START records its `--attempt-id` and
  `evidence` emits the stable secret-free delivery projection for the bundle.

The executable workflow and state schema live in `prompt.md` and
`scripts/delivery.py`. Runtime-specific mechanics live under `surfaces/`.