pb-handover
Write a handover note for a colleague from the state of a project folder: what is done, what is open, what is risky, the next 3 steps and where things live. Sent only after your GO. Use for "handover
SKILL.mdskills/playbooks/pb-handover/SKILL.md
GitHubHandover note
What you get: a handover note for a colleague from the state of a project folder.
Inputs
- A project folder
- The colleague's name
- A save folder — asked once; default
./pb-handover-<date>/
Steps
- Ask once — save folder, project folder, colleague name →
run-log.md— the folder exists - Read the folder and its git log (read-only); github — only if
gh (external)is installed: your open pull requests for this repo → list of files, recent commits and open PRs inrun-log.md— if gh is missing, skipped and logged - quick-recap — folder state and recent commits → what is done, what is in progress — each point cites a file or commit
- memb-skill — search open commitments for this project → added tagged
[memB]— skipped and logged if memB is not installed - Write
handover.md: done, open, risks, next 3 steps, where things live — every open item cites a file, commit or PR; nothing invented, unknown is? - Show
handover.mdin full and apply your edits until you approve — approval logged - [GO] Send the handover through a connector you name, or send it yourself — show the recipient (name + address,
?blocks sending until you fill it) and the full text first. The run stops here until the human types GO. The GO covers exactly the recipient and message shown and nothing else; a different or added recipient needs a fresh GO. The go-gate hook does not guard sending: this [GO] is the only guard.
Run log: run-log.md in the save folder. One line per step as it completes (N. done|skipped|failed — file — check result), and WAITING FOR GO: <step> at the gate. Anything other than the literal GO (case-insensitive) is not a GO. If a check fails, stop, write the failure into the log and tell the user.