apm-6-handoff-manager

Creates Handoff Logs and handoff prompts for APM Manager context transitions.

1|Updated Dec 13, 2025
One-click install
npx skills add https://github.com/ZK-Theory/TDL --skill apm-6-handoff-manager-zk-theory
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: apm-6-handoff-manager
Source: https://github.com/ZK-Theory/TDL/tree/main/.agents/skills/apm-6-handoff-manager
Command: npx skills add https://github.com/ZK-Theory/TDL --skill apm-6-handoff-manager-zk-theory

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When an APM Manager agent approaches its context window limit, critical working context risks being lost. This Skill preserves coordination state by generating a structured Handoff Log and a handoff prompt so an incoming Manager instance can reconstruct context and resume work. ## Core Features & Use Cases - Handoff Log Creation: Captures past actions, tracked Worker Handoffs, VC state (branches, worktrees, pending merges), and user preferences in .apm/memory/handoffs/manager/. - Handoff Prompt Generation: Writes current-state instructions (outstanding Tasks, active Workers, next actions) to the Handoff Bus at .apm/bus/manager/handoff.md. - Use Case: A Manager coordinating multiple Workers across Stages hits its context limit mid-Stage. Run this Skill to produce both artifacts, review them, then start a new chat where the incoming Manager auto-detects the handoff prompt and resumes coordination. ## Quick Start Ask the agent to perform a Manager handoff so the next Manager instance can pick up coordination from the Handoff Bus.

Frequently Asked Questions about apm-6-handoff-manager

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I hand off context between AI agent instances?

Run the handoff procedure to create two artifacts: a Handoff Log capturing past actions and decisions, and a handoff prompt describing current state. The incoming agent reads both to reconstruct working context procedurally.

What goes in a Handoff Log versus a handoff prompt?

The Handoff Log records past-tense content: completed Stages, reviewed Tasks, Worker Handoffs, and VC state. The handoff prompt holds present-tense content: outstanding Tasks, active Workers, blockers, and the immediate next action.

Where are APM handoff files stored?

Handoff Logs are written to .apm/memory/handoffs/manager/ as handoff-<NN>.log.md files with YAML frontmatter. The handoff prompt is written to the Handoff Bus at .apm/bus/manager/handoff.md for auto-detection.

Does the incoming Manager rely only on the Handoff Log?

No. The incoming Manager rebuilds primary context from planning documents, guides, skills, and Task Logs. The Handoff Log provides only supplementary working context not captured in those artifacts.

What happens if auto-compaction occurred before the handoff?

The Handoff Log should note that auto-compaction occurred and describe which portions of working context are reconstructed from the summary rather than observed first-hand, so the incoming Manager can calibrate trust in that context.