create-handoff

Solid

Write a handoff file at .turbo/handoff/<YYYY-MM-DD>-<slug>.md capturing current session state — task, status, open decisions, in-flight changes, next step — so a fresh session can continue without re-deriving context. Use when the user asks to "create a handoff", "create handoff", "save handoff", "handoff before compact", "save session state", "handoff for next session", or "capture session state".

Data & Documents 335 stars 26 forks Updated 5 days ago MIT

Install

View on GitHub

Quality Score: 89/100

Stars 20%
84
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Create Handoff Write a session handoff file at `.turbo/handoff/<YYYY-MM-DD>-<slug>.md` so a fresh session can pick up where this one left off. ## Step 1: Resolve the Target Path Get today's date: `date +%Y-%m-%d`. Pick a slug for the current task: - Lowercase - Replace non-alphanumeric characters with hyphens - Collapse consecutive hyphens - Trim leading and trailing hyphens - Truncate to 40 characters at a word boundary If the work is anchored to an existing artifact (a plan at `.turbo/plans/<slug>.md`, a shell at `.turbo/shells/<slug>.md`, or a spec at `.turbo/specs/<slug>.md`), reuse that artifact's slug verbatim. The user may pass an explicit slug or path; honor it. The target path is `.turbo/handoff/<YYYY-MM-DD>-<slug>.md`. If the path already exists, append `-2`, `-3`, etc. until the path is free. State the chosen path before continuing. ## Step 2: Gather Session State Run `git status --short` to see uncommitted changes in the working tree. Survey the conversation context for: - **Current task**: what is being worked on, in one or two sentences - **Workflow status**: where in the workflow this session is (drafting, refining iteration N, applying findings, implementing step M of K, investigating, blocked on Q, etc.) - **Active artifact**: path to the plan, shell, spec, or other file at the center of the work, if one exists - **Open decisions**: questions raised but not resolved, choices the user is still weighing, escalations awaiting input - **In-flight c...

Details

Author
tobihagemann
Repository
tobihagemann/turbo
Created
3 months ago
Last Updated
5 days ago
Language
Python
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category