Imported from don-smith/myflow (.claude/skills/myflow/skills/create-handoff/SKILL.md). Install upstream with npx skills add don-smith/myflow --skill create-handoff. Copyright stays with the author.

Create Handoff

A lightweight backup for mid-stage pauses. First run node skills/myflow/scripts/resolve-repository-map.mjs discover --cwd <git-root> and record its selected map path. Artifacts are the primary handoff mechanism in MyFlow — use this only when you need to hand off between artifact boundaries.

Process

1. Determine filepath: <workstream-root>/<workstream-id>/handoffs/<timestamp>_<slug>.md using current time and a short kebab-case slug from $ARGUMENTS.

2. Write the handoff:

# Handoff: {one-line description}

## Where we are
- Stage: {Scope|Plan|Implement|Review|Close}
- Artifact: {path to current artifact}
- Phase: {Phase N if in implement, otherwise omit}

## What's done
- {bullet list of completed work}

## What's next
- {bullet list — what the next session should do first}

## Key files
- `path/to/file.ext` — {why it matters}
- `path/to/file.ext` — {why it matters}

## Decisions
- {Decision}: {verdict}

## Verification snapshot
- Acceptance criteria covered: {criterion → test path/name or verification command}
- Explicitly not tested: {criterion/risk → reason or follow-up}
- Current evidence: {last red/green result, suite, or manual check}

3. Present:

Handoff written to:
`.myflow/artifacts/handoffs/<filename>.md`

**Next step:** `/resume-handoff .myflow/artifacts/handoffs/<filename>.md`

Keep it short. The artifact already has the full context — the handoff just points at what to resume.