loop-handoff

Reconcile worktree progress against a multi-phase plan and repush it to the Loop daemon and Kestral.

1|Updated Nov 25, 2021
One-click install
npx skills add https://github.com/rstagi/dotfile --skill loop-handoff-rstagi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: loop-handoff
Source: https://github.com/rstagi/dotfile/tree/main/.claude/skills/loop-handoff
Command: npx skills add https://github.com/rstagi/dotfile --skill loop-handoff-rstagi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When wrapping up a work session on a multi-phase effort, progress often lives only in the current chat and worktree, making it impossible for a fresh session (or a different agent) to resume cleanly. This Skill makes the shared plan the durable handoff artifact by reconciling what moved, repushing the plan to the Loop daemon and Kestral, and leaving a clear resume pointer. ## Core Features & Use Cases - Plan reconciliation: Compares git history and diffs against the plan's phases, updates [status: …] markers, the Status/Last updated lines, and appends a Progress log entry. - Multi-target repush: Writes the updated plan to .loop/plan.md, pushes it to the Loop daemon via loop-plan.sh push, and—when the plan is linked—syncs the Kestral plan document, task statuses, and progress comments. - Auto mode for loop-execute: Supports --auto invocations from runner and orchestrator contexts with no confirmation gates, strict plan-writer ownership rules, and mandatory secret redaction. - Use Case: After finishing a phase in a Claude Code worktree, run the handoff so a Codex session in another worktree can run /loop-pickup and continue exactly where you left off. ## Quick Start Ask the assistant to hand off this session's work by reconciling progress against the loop plan and repushing it so a fresh chat can pick it up.

Frequently Asked Questions about loop-handoff

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

FAQPage Schema
How do I hand off a multi-phase plan to a fresh chat session?

Run the loop-handoff workflow: it reconciles git progress against the plan's phases, updates status markers and the progress log, repushes the plan to the Loop daemon and Kestral, then prints a resume pointer. The next session continues with /loop-pickup.

How does loop-handoff sync plan status with Kestral tasks?

When the plan is linked (its header carries kestral coordinates), the skill updates the Kestral plan document via update_document and delegates task status changes, progress comments, and PR linking to the kestral-sync skill. Unlinked plans only update the daemon and local files.

Can a different agent like Codex resume a Claude Code handoff?

Yes. The handoff state lives in the Loop daemon, .loop/plan.md, and Kestral rather than in the conversation, so any host can resume it. A Codex worktree runs $loop-pickup with the planId or project to continue exactly where the previous session stopped.

What happens if no plan exists when handing off work?

In interactive mode the skill falls back to a lighter handoff: it syncs the task via kestral-sync when linked, or invokes the generic handoff skill for a narrative summary. In auto mode there is no fallback—it returns REFUSED with a reason instead.

What is the difference between runner and orchestrator in auto mode?

The runner (status:in-progress) only writes events and notes via loop-plan.sh note or post_progress_comment, never pushing the plan. The orchestrator (status:done|blocked) performs the full handoff after merge, including loop-plan.sh push and Kestral document and task updates.