| name | handoff |
| description | Use when managing a two-session handoff — inspecting, picking up, or reviewing a committed handoff package produced by a session=two scope run. The operator interface over the cross-environment handoff lifecycle (plan in one session, build in another, review back in the first).
Trigger with /hyperflow:handoff, "list handoffs", "pick up the handoff", "review the handoff build".
|
| allowed-tools | Read, Write, Edit, Bash(git:*), Bash(mv:*), Glob, Grep, AskUserQuestion, Skill |
| argument-hint | <list | status [slug] | pickup <slug> | review <slug> | complete <slug>> |
| version | 1.0.1 |
| license | MIT |
| compatibility | Designed for Claude Code; portable to Codex/OpenCode/Antigravity |
| tags | ["handoff","two-session","cross-environment","orchestration"] |
Handoff
Operator interface for two-session execution: one session plans (session=two at the Step 0 gate), a second
session in another environment builds, and the first session reviews. The lifecycle and package format are defined
in ../hyperflow/session-handoff.md; this skill is the thin set of verbs over it
(mirrors how /hyperflow:flush fronts the deferred-commit machinery).
Packages live at .hyperflow-handoff/<slug>/ (committed, so they travel via git). STATUS (planned → built → reviewed) is the single source of truth and decides which side of the handoff you are on.
Subcommands
list
Read-only. List every .hyperflow-handoff/*/ (excluding .archive/): slug · STATUS · on_complete · age. Group
by status so the user sees what is awaiting build vs awaiting review.
status [<slug>]
Show the HANDOFF.md manifest + STATUS for one package (or all). When STATUS=built, also print the
COMPLETION.md diff range and commit count. Read-only.
pickup <slug> — build side
Thin alias for starting the second-session build: invoke Skill with skill: dispatch and args: "<slug>".
Dispatch's Step 1.0 rehydrates artefact/ into .hyperflow/, runs /hyperflow:scaffold if the cache is missing,
builds the batches, writes COMPLETION.md + STATUS=built, and then deploys or stops per on_complete.
review <slug> — planning side
- Require
STATUS=built (else: "handoff <slug> is <status> — nothing to review yet").
- Read
COMPLETION.md → extract Diff range = <base>..<head>.
- Invoke
Skill with skill: audit and args: "<base>..<head> level=3" (level=5 when the originating triage
flow in was or ). The audit dispatches the matching domain specialist
reviewers over the second session's diff.
