| name | gds-handoff-work |
| description | Use this skill only when the owner wants to preserve unfinished work for another device or session. Plan an exact checkpoint commit, push the task branch, and create or update a draft pull request when policy requires it. Do not use it to merge, complete, synchronize main, or clean branches and worktrees. |
| disable-model-invocation | true |
Contract
Preserve unfinished work without integrating or deleting it.
Use when
- The owner explicitly asks to hand off unfinished work.
- Local task work must become verifiably available on another device.
Do not use when
- The work should be fully completed and integrated.
- The request is only for status, synchronization, or backup by stash.
Inputs
- Current repository and task branch.
- Approved file set and checkpoint message.
- Repository handoff and draft-PR policy.
Preconditions
- Run
gds context --json.
- Run
gds handoff --plan --json for the current repository scope.
- Present staged, unstaged, untracked, sensitive, test, upstream, and remote
evidence.
- Obtain explicit approval for the exact commit, push, and optional draft PR.
Workflow
- Recheck plan preconditions.
- Apply only the approved plan.
- Verify the remote branch OID and draft PR state when applicable.
- Leave the task branch and worktree intact.
Stop conditions
Stop on protected default branch, conflicts, unapproved files, secret risk,
failed checkpoint checks, changed remote OID, unavailable authorization, stale
plan, or unresolved policy. If the command is unavailable, report NOT_PROVEN.
Verification
Run gds handoff --verify <operation-id> --json.
Output
Return repository ID, local and verified remote OIDs, draft PR state, checks,
remaining local changes, and the exact continuation instruction.
References
No additional runtime reference is required; the generated plan is authoritative.
