<< All versions

Skill v1.0.0

currentAutomated scan100/100
sdi2200262/agentic-project-management/apm-6-handoff-manager
──Details
PublishedNovember 15, 2026 at 06:03 AM
Content Hashsha256:e9f851661ef84986...
Git SHAb88434f08130
──Files
Files (1 file, 3.7 KB)
SKILL.md3.7 KBactive
SKILL.md · 79 lines · 3.7 KB

name: apm-6-handoff-manager description: Perform a Handoff with an APM Manager. Use only when the User manually invokes this skill. disable-model-invocation: true metadata: version: "1.0.0"


APM {VERSION} - Manager Handoff

Follow this skill only when the User manually invokes it, asks you to follow it, or an APM instruction directs you here. Otherwise, stop.

This skill hands your coordination to a new Manager conversation. You write two files. The Handoff Log preserves this conversation's working context. The Handoff Prompt, in .apm/bus/manager/handoff.md, tells the next conversation what to read and where to resume. The next conversation also reads the planning documents, the Tracker and the Index at initiation, per {SKILL_PATH:apm-2-initiate-manager}.

Your conversation number is 1 if you started from initiation, or the number the Handoff Prompt gave you. The next conversation's number is one higher.

1. Current State

Your memory of earlier turns may be out of date, so check the current state before writing either file:

  • Read the Tracker and each Worker's bus files.
  • With version control, use git to check branches, worktrees and merges.

Bring the Tracker up to date with the checked state before writing the two files, including pending alignment decisions, accepted limitations and verification gaps with source paths.

2. Handoff Log

Write the Handoff Log per §5.1. Record in past tense what this conversation did: the Stages and reviews you handled, decisions with their reasons, User preferences, dispatch patterns and coordination observations that the Tracker, the Index and the Task Logs do not hold. If your context was compacted or recovered in this conversation, say which parts you rebuilt from a summary or from files, and from where.

3. Handoff Prompt

Write the Handoff Prompt per §5.2 to .apm/bus/manager/handoff.md. Name the latest relevant attempt logs for Tasks in the current Stage and earlier Tasks that pending reviews or upcoming dependencies rely on. Earlier attempts can be followed through links where needed. In Current State, list the reports awaiting review, the Workers with dispatched Tasks, and branches, worktrees and merges still pending. Include pending alignment decisions, accepted limitations and verification gaps with source paths.

4. User Review

Give the User both file paths and ask them to review the two files. Apply their corrections and ask again. After they approve, tell them to invoke apm-2-initiate-manager in a new chat; it finds the Handoff Prompt on its own. Your work in this conversation then ends.

5. Formats

5.1 Handoff Log Format

The Handoff Log is written at .apm/memory/handoffs/manager/handoff-<NN>.log.md, where <NN> is your conversation number, zero-padded, such as handoff-01.log.md.

markdown
---
agent: manager
conversation: <number>
stage: <N>
---
# Manager Handoff Log - Conversation <number>
## Summary
<The Stages, reviews and dispatches handled in this conversation>
## Working Context
<Decisions with reasons, User preferences, dispatch patterns and coordination observations that the Tracker, the Index and the Task Logs do not hold>

5.2 Handoff Prompt Format

markdown
---
agent: manager
conversation: <number + 1>
handoff_log: <path of the Handoff Log>
---
# Manager Handoff Prompt - Conversation <number + 1>
<What to read: the Handoff Log and the Task Logs the next conversation needs, by path>
## Current State
<Checked state: reports awaiting review, Workers with dispatched Tasks, pending branches, worktrees and merges; pending alignment decisions, accepted limitations and verification gaps, with source paths>
## Next Action
<The coordination step to resume with>
All versions