propose-ship

Automate the Minerva propose-to-ship lifecycle with collision avoidance and PR merge cleanup.

Updated May 16, 2026
One-click install
npx skills add https://github.com/honerlaw/agent-marketplace --skill propose-ship
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: propose-ship
Source: https://github.com/honerlaw/agent-marketplace/tree/main/plugins/minerva/skills/propose-ship
Command: npx skills add https://github.com/honerlaw/agent-marketplace --skill propose-ship

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It orchestrates the full Minerva lifecycle in one go so you can go from an initial proposal to a shipped, merged PR without stitching together multiple manual steps.

Core Features & Use Cases

  • End-to-end lifecycle orchestration: Executes propose → work → review → promote → ship → cleanup in the required order by delegating to each phase skill.
  • Collision prevention: Detects in-flight work units and asks before starting a parallel lifecycle that could cause conflicting worktrees.
  • Gate-aware shipping and cleanup: Enforces an explicit promote → ship confirmation gate and only cleans up after verifying PR merge state (including scheduled wakeups for auto-merge scenarios).

Quick Start

Run minerva:propose-ship "add payments" to create a proposal, drive the implementation through review and promotion, and ship it with the appropriate cleanup behavior.

Frequently Asked Questions about propose-ship

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate the full pull request lifecycle from proposal to merge?

Automate the full pull request lifecycle from proposal to merge by orchestrating propose, work, review, promote, ship, and cleanup phases in order using a single command. This delegates to each phase sequentially to drive implementation end-to-end.

How does branch management handle worktree collisions during parallel workflows?

Branch management handles worktree collisions by detecting in-flight work units before starting a parallel workflow. It prompts for confirmation to prevent conflicting worktrees when overlapping software work is identified.

Can I trigger worktree cleanup automatically after a GitHub PR is merged?

Trigger worktree cleanup automatically after a GitHub PR is merged by polling GitHub PR status. It supports scheduled wakeups for auto-merge scenarios, ensuring cleanup is conditioned on verified PR merge state.

What is the promote to ship confirmation gate in workflow orchestration?

The promote to ship confirmation gate in workflow orchestration is an explicit checkpoint requiring user confirmation before shipping. It enforces an ordered phase delegation, ensuring work and review are complete before promotion.

Do I need to manually run each phase for code collaboration in Minerva?

You do not need to manually run each phase for code collaboration in Minerva. The orchestration executes the propose to cleanup lifecycle end-to-end, delegating to each phase skill automatically without stitching together manual steps.