handoff

Generates per-repo sprint mission briefs and launches Terminal tabs running Claude dev-team sessions.

1|Updated Jun 13, 2026
One-click install
npx skills add https://github.com/apireno/agent-workflow-template --skill handoff-apireno
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: handoff
Source: https://github.com/apireno/agent-workflow-template/tree/main/.claude/skills/handoff
Command: npx skills add https://github.com/apireno/agent-workflow-template --skill handoff-apireno

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Coordinating multi-repo sprint execution by hand means copying sprint plans into each repo, wiring up session hooks, and manually opening and prompting a Claude session per repo. This Skill automates the entire Phase 2 fan-out: it writes a mission brief into each target repo and launches a self-starting dev-team session for it. ## Core Features & Use Cases - Mission brief generation: Reads each repo's sprint-plan.md and writes a brief.md with acceptance criteria, derived-artifact deliverables, and crash-recovery instructions into docs/sprints/<sprint>/. - Automated session launch: Opens one macOS Terminal tab per repo running claude with a kickoff prompt, pinned model, and a titled tab, then records the window ID for later monitoring. - Self-healing repo setup: Installs session-tracking and guard hooks, merges settings.json wiring, and pre-trusts MCP servers so launched sessions are tracked and governed. - Model verification: Reads each launched session's transcript to confirm which model it actually started on and warns when tabs inherit the wrong global default. - Use Case: After the CEO approves a sprint plan spanning three repos, run the handoff to drop briefs in all three and watch three Terminal tabs open, each dev team already executing its brief. ## Quick Start Ask the agent to hand off sprint-12 to all registered repos, optionally with a dry run first to inspect the generated briefs before any Terminal tabs open.

Frequently Asked Questions about handoff

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

FAQPage Schema
How do I launch parallel Claude dev-team sessions across multiple repos?

Run the handoff with a sprint slug, for example /handoff sprint-12. It writes a mission brief into each repo's docs/sprints directory and opens one Terminal tab per repo running claude with a kickoff prompt that reads and executes the brief.

How do I test a sprint handoff before launching sessions?

Pass the --dry-run flag, for example /handoff sprint-12 --dry-run. Briefs are written to each repo but no Terminal tabs open, so you can inspect the briefs and re-run without the flag when satisfied.

Can I hand off a sprint to only some repos in the fleet?

Yes, use the --repos flag with a comma-separated list, such as /handoff sprint-12 --repos api,web. Only active repos in the fleet registry that have a sprint-plan.md for that sprint are targeted.

Why does the handoff report no CTO home found?

The skill must locate a directory containing .cto/projects.yaml, the fleet registry. Run it from the CTO home repo, or set a permanent anchor by writing the CTO home path to ~/.cto/home. A placeholder registry from the unconfigured template is also rejected.

How do I pin which model the dev-team tabs run on?

Pass --model=<alias|full|inherit> or configure .cto/devteam-model, which supports per-repo overrides. After launch, the skill reads each tab's transcript and warns if any session did not start on the expected model family.

What happens if a launched dev-team session crashes?

Each session records its ID in .claude/current-session.id. The CTO can recover it with /resume-dev-team <repo>, which opens a new Terminal tab running claude --resume with the recorded session ID.