mcpField
H
handoff

handoff

github.com/laguaguAgent workflows7191 installsUpdated 2d ago
Repository

About handoff

A workflow skill for writing or updating a project-root HANDOFF.md so an agent starting with fresh context can continue the work. It records progress, active work, lessons, and concrete next steps while pointing to existing project documents rather than duplicating them.

Key features

  1. 01Read an existing handoff first
  2. 02Record goals and current progress
  3. 03Track in-flight work and resume details
  4. 04Capture successful and failed approaches
  5. 05List concrete next steps and suggested skills

Use cases

  1. 01Prepare a project for continuation in a fresh agent session
  2. 02Document active jobs, branches, or uncommitted changes
  3. 03Pass project-specific focus into a handoff

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/laguagu/claude-code-nextjs-skills --skill handoff

After installing, type/handoffin Claude Code to confirm it loaded.

Details

From the project README

Write or update a handoff document so the next agent with fresh context can continue.

Steps

  1. If HANDOFF.md exists in the project root, read it first.
  2. Do not duplicate content already in PRDs, plans, ADRs, issues, commits, or diffs — reference them by path or URL.
  3. Write or update HANDOFF.md in the project root with:
    • Goal — what we're trying to accomplish
    • Current Progress — what's done (link commits/PRs)
    • In flight — running or cut work, if any: run id and resume command, branch or worktree, uncommitted paths and their owner, submitted remote jobs
    • What Worked — approaches that succeeded
    • What Didn't Work — dead ends, so they aren't retried
    • Next Steps — concrete action items
    • Suggested skills — which skills the next session should load, if any
  4. If the user passed arguments, tailor the doc to that focus.
  5. Tell the user the path so they can start a fresh conversation with it.

Comments

Markdown supported