Skip to content
cccskills
FreePublished on GitHub

vibe-handover-doc

Writes a handover document so another person, another agent, or a different tool can pick up multi-session work cold. Use when handing work to someone else, switching tools, or pausing work that will not resume in the same session.

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md3.5 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

vibe-handover-doc

Within one session, the harness handles continuity: context compaction, session resume, and memory files. A handover doc is for the moment that breaks: a different person, a different agent tool, or a fresh session days later. Write it for a reader who has none of your context.

When to Use This Skill

  • Handing work to a teammate or another agent
  • Switching tools mid-project (for example, Claude Code to Codex or Gemini CLI)
  • Pausing multi-session work that won't resume via session resume
  • User says "save progress", "let's continue tomorrow", or "write this up for X"

When NOT to Use This Skill

  • To free up context in the current session (the harness compacts automatically; if you want to compact early, use its own command)
  • Short sessions with trivial tasks
  • Work that is fully committed, tested, and described in the PR (the PR is the handover)
  • A current handover doc already exists (update it instead)

Steps

  1. Capture state from the repo, not from memory:

    • Branch, last commit, git status (uncommitted changes?)
    • Test status: run the suite and record pass/fail, don't guess
    • Open PR, CI state, unresolved review threads
  2. Document completed work — What was done, key decisions (link vibe-decision-journal entries), problems solved and how.

  3. Document remaining work — What's left, what's blocked and on what, known issues introduced, and approaches already tried and rejected (so the next person doesn't retry them).

  4. Write a resume prompt — A self-contained prompt the next session can be started with: branch, files to read first, the next concrete task, and how to verify it.

  5. Order it current-state-first. The top of the doc is what the next reader acts on. Move superseded plans and history to the bottom or to a separate file; a resume file that grows into a history slows every pickup.

  6. Save to docs/handover/YYYY-MM-DD-<topic>.md (or docs/HANDOVER.md for a single rolling doc), and commit it if the next reader will work from a fresh clone.

Wind-Down Mode (usage limit, restart, or "stop for now")

When a session must stop mid-work, especially with agents running:

  1. Stop or message running agents to reach a safe point
  2. Commit what passes its checks; stash or commit half-done edits to a clearly named WIP branch or stash, and record where
  3. Record CI state per pushed commit
  4. Write the handover with exact resume steps (a CONTINUE.md at the root works well)
  5. Put the resume convention in the project instructions file, for example "on 'continue', re-read CONTINUE.md and resume from the first unfinished step"

When the owner says pause ("just note it down"), write the note and plan, then stop. Don't keep building.

Output Format

Handover: [Feature/Project Name]

Date: [today] · Branch: [branch] · Last commit: [sha] Tests: [pass/fail counts, command used]

Completed

  • [task]

Remaining

  • [task] — [notes]
  • [task] — blocked by [X]

Decisions & Dead Ends

  • [decision] — [rationale / DEC-ID]
  • Tried [approach], rejected because [reason]

Known Issues

  • [issue] — [impact]

Resume Prompt

[Self-contained prompt: context, branch, files to read first, next step, how to verify.]

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Validates completed work against defined acceptance criteria. Use after completing a task that has specific success criteria defined in issues, specs, or task descriptions.

The English summary is being prepared. Showing the original description.

ash1794/vibe-engineering164Updated Oct 8, 2026

Generates edge case, failure mode, and spec-driven test cases. Covers boundary values, nil inputs, concurrency, resource exhaustion, malformed data, and requirement-linked traceability tests. Use after happy-path tests exist and before claiming coverage is complete, when requirements lack tests, or before a security review.

The English summary is being prepared. Showing the original description.

ash1794/vibe-engineering164Updated Oct 8, 2026

Catches shortcuts and reward hacking — weakening or deleting tests to make them pass, hard-coding expected outputs, silently dropping requirements, or claiming work is done without running it. Use before declaring a task complete and whenever a test or requirement feels like it's in the way.

The English summary is being prepared. Showing the original description.

ash1794/vibe-engineering164Updated Oct 8, 2026

Safely integrates commits from parallel agent branches using sequential cherry-pick. Use after parallel work completes in isolated branches or worktrees.

The English summary is being prepared. Showing the original description.

ash1794/vibe-engineering164Updated Oct 8, 2026

Audits tests for concurrency safety — race conditions, shared mock state, cleanup ordering. Use when writing tests that involve goroutines, async operations, or shared mutable state.

The English summary is being prepared. Showing the original description.

ash1794/vibe-engineering164Updated Oct 8, 2026

Enforces tiered test coverage standards with three dimensions — line coverage by tier, spec-to-test traceability, and spec-to-code implementation mapping. Use before claiming code is complete.

The English summary is being prepared. Showing the original description.

ash1794/vibe-engineering164Updated Oct 8, 2026

See all skills by ash1794

Report a problem with this skill