create-handoff

Featured

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 402 stars 30 forks Updated 2 days ago MIT

Install

View on GitHub

Quality Score: 89/100

Stars 20%
87
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 plan at `.turbo/plans/<slug>.md`, reuse that plan's slug verbatim. The user may pass an explicit slug or output path; honor it. The target path is `.turbo/handoff/<YYYY-MM-DD>-<slug>.md`. A generated slug takes `-2`, `-3`, and so on until the path is free. When the user supplied the slug or path and it already exists, use `AskUserQuestion` to offer overwrite, a numeric suffix, or a different slug. When an open decision will outlive the rest of the session's state, still unresolved while the work around it is finished, give it its own handoff. Everything else stays in a single file. Slug the split handoff for that decision rather than appending a collision suffix, and write it to stand alone. 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 (draft...

Details

Author
tobihagemann
Repository
tobihagemann/turbo
Created
6 months ago
Last Updated
2 days ago
Language
Shell
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category