Handoff discipline

Skill yeaight7/agent-powerups/plugins/documentation-systems/skills/handoff-discipline

Curated power-ups for coding agents: skills, slash commands, MCP configs, hooks, AGENTS.md templates, and workflows for serious software engineering. Claude Code, Codex, Antigravity CLI, Cursor and more

Install

npx -y skills add yeaight7/agent-powerups --skill handoff-discipline

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

6 stars6 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Use when ending a session, handing a task back to the user, or approaching the context limit with work unfinished -- the next session or engineer must be able to resume the work instantly.

SKILL.md

3.0 KB, 673 tokens by cl100k_base, as published. Nobody here has run it

Purpose

When ending a session, handing a task back to the user, or preparing to swap to a new context window, you must leave a clean paper trail — exactly what the next session or human engineer needs to resume work instantly.

When to Use

A task ends (complete or not) and someone else picks it up next
The context window is nearly full mid-task
Work is blocked and must pause on an external dependency

Inputs

The session's actual state: what ran, what passed, what is mid-flight
The repo's working-tree status

Workflow

State the end condition. Explain exactly why you are stopping (e.g., "Task complete", "Blocked on PR", "Context window too large").
Leave a breadcrumb. If the task is incomplete, summarize the last successful step, the current failing step, and the exact next command to run. Record discovered constraints and dead ends so the next session doesn't retry them.
Commit or stash. Ensure the working directory is clean. Either commit the work, tell the user to commit, or stash it. Do not leave unverified messy state:
```
git status --short                     # what is uncommitted?
git stash push -m "handoff: <task>"    # if not committing
```
Link the work. Provide file paths to the modified files or generated artifacts so the next agent/user doesn't have to search for them.

Write the handoff summary (a handoff markdown file, or the final message) using this exact structure:

### 1. Goal
[1-2 sentences on what we were trying to do]

### 2. State
- ✅ Completed: [What works]
- 🚧 In Progress: [What is broken or partial]
- 🛑 Blockers: [What stopped us]
- ⚠️ Dead ends: [Approaches tried that failed, and why]

### 3. Next Steps
1. Run `npm test ...`
2. Fix the error in `src/foo.ts` around line X.

Output

A handoff summary in the Goal / State / Next Steps format
A clean, committed, or explicitly stashed working tree, with artifact paths linked

Verification

End condition stated explicitly
Next command is runnable verbatim by the next session — no "continue where I left off"
Working tree clean, committed, or stashed — confirmed with git status, not assumed
Every modified or generated file linked by path
State section separates completed, in-progress, and blocked honestly

Failure Modes

Vague resumption — "continue the refactor" instead of the exact failing step and next command.
Dirty-tree handoff — uncommitted, unexplained changes the next session must reverse-engineer.
Completed-only reporting — hiding the broken parts makes the handoff a trap.
Unlinked artifacts — the next agent burns context searching for files you could have named.