ship-workflow
Installation
SKILL.md
Ship Workflow
Ship through the authorized endpoint using the repository's current checks, required reviews, branch protections and merge policy. Routine shipping is the default. The executable owns Git/provider mutations, journals, reconciliation and cleanup; the assistant owns scope, logical change grouping, repository conventions and unfamiliar failure diagnosis.
Reference Files
| File | Contents | Load When |
|---|---|---|
references/commit-planning.md |
Inventory, logical commit plans and local gate packets | Creating commits or requesting local/per-commit validation |
references/lifecycle-contract.md |
Explicit policy, assurance, publication, stack packets, journals and recovery | Supplying --policy or --stack-plan, resuming, or interpreting a blocker |
references/project-detection.md |
Repository gate-source detection | Locating local test commands; version/changelog tables do not authorize release work |
Workflow
1. Resolve scope
Choose exactly one target: --pr N, --branch NAME, an explicit stack, a saved run, or the current branch when it identifies exactly one target. Resolve ambiguous targets or bases from provider/Git facts; ask only when those facts cannot decide. --repo [HOST/]OWNER/REPO names the PR base repository, and --head-repo OWNER/REPO names a fork head namespace.