Handoff Skill

This skill is designed to bridge context between agents during a transition. It uses the philosophy of the /assess skill to generate a structured local/HANDOFF.md that helps a new agent understand the project's current state, what is working, what is broken, and what to do next.

Assessment Logic (via /assess)

When triggering this skill, the agent must:

1. Gather Facts: Run .pi/skills/handoff/run.sh to get automated project data (git, docs, todos).
2. Analyze Alignment: Compare README.md and CONTEXT.md against the actual code.
3. Identify "Current Broken": Locate failed tests, TODOs, and recent bug-related commits.
4. Determine Next Steps: Review 0N_TASKS.md (if exists) and recently touched files.

Output Format: HANDOFF.md

The agent should generate or update a local/HANDOFF.md file using the following structure:

# Handoff Report: <Project Name>