name: factory-ship
installer-group: factory
description: >-
Experimental workflow for publishing and completing configured software
delivery work. Use when the user or an enabled factory policy asks to ship.
Factory Ship
Start with the Factory guide for workflow
setup and configuration.
Read .agent-factory/config.yaml, the optional
skill_prompts.factory-ship entry, and the repository's instructions before
publishing. See the Factory configuration reference. The prompt adds project guidance; editing code does not by itself authorize a PR update, approval, merge, or deployment.
Delivery steps
- Confirm ownership. Identify the target repository, task-owned worktree,
branch, and complete task-related change set. Preserve unrelated changes.
Use a clean automation-owned worktree when the scheduler provides one; never
take over a peer's checkout.
- Verify changes. Run the configured formatter, tests, and release checks.
Report checks that were skipped or unavailable.
- Publish when enabled. Open or update a PR only when authorized. Apply
configured title, body, draft status, labels, and communication rules. Do
not tag or message people unless enabled.
- Resolve feedback. Compare comments with the code and current human
direction. Make one coherent update, then rerun affected checks.
- Apply merge gates. Merge only under its own enabled policy and while all
criteria hold on the unchanged live head. Use a head-match guard when the
host supports it. A head change invalidates tied evidence and resets the
soak.
- Verify and close out. Confirm the merge in the current base branch.
Verify deployment only when configured; a merge is not live proof. Close
issues, rotate worktrees, and notify only at their configured proof points.
Stop conditions
Hold the work when ownership, authorization, a required check, or live host
state is missing or unclear. State the exact next step; do not turn an
inconclusive result into success.