mcpField
T
task-handoff

task-handoff

github.com/archieindianAgent workflows7448 installsUpdated 26w ago
Repository

About task-handoff

task-handoff is a skill that helps agents preserve progress when pausing a task and resume it later. It records the current state, completed work, and next steps in a handoff document and state file.

Key features

  1. 01Checks files and tests before handoff
  2. 02Creates a timestamped handoff document
  3. 03Updates task state and file list
  4. 04Reads notes and runs tests on pickup
  5. 05Clears handoff records when complete

Use cases

  1. 01Pausing an ongoing coding task
  2. 02Passing work between work sessions
  3. 03Resuming interrupted work without repeating steps

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/archieindian/openclaw-superpowers --skill task-handoff

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

Bundled filesSTATE_SCHEMA.yaml

Details

From the project README

Task Handoff

State file: ~/.openclaw/skill-state/task-handoff/state.yaml

Pre-Handoff Checklist

  • Current state is stable (no half-written files, no broken tests)
  • All changed files are saved
  • Tests have been run
  • Handoff document is written
  • State file is updated
  • Memory is updated

Writing a Handoff

Save to tasks/handoff-[task-name]-[timestamp].md:

# Handoff: [task name]
Written: YYYY-MM-DD HH:MM
Reason: [why stopping]

## Current State
[1-3 sentences: exactly where things are]

## What's Done
- [step] done

## What's Next
- [next step] - specific instructions

## Important Context
- [anything non-obvious from the code]
- [decisions made and why]

## Files Modified
- path/to/file - [what changed]

## Tests
- Last run: YYYY-MM-DD HH:MM
- Status: PASSING / FAILING

## Blockers
- [anything blocking]

Then update state: active_handoff_path (full path to the file), task_name, reason, status: written, written_at, files_modified.

Picking Up a Handoff

  1. Read state file to get active_handoff_path
  2. Read the handoff document completely before touching any code
  3. Run the tests to confirm current state
  4. Start from 'What's Next' — do not redo completed steps
  5. When complete: delete handoff file, update state status: picked_up, clear active_handoff_path

Comments

Markdown supported