# Handover

> Create or update a concise handover doc for the current repo/session. Use when this capability is needed.

- Skill: `tomevault-io/handover-4` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/handover-4`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/handover-4/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/handover-4

---


# Handover doc

Create or update a handover doc for the current repo.

## Location

- If `repodocs/prompts/` exists -> use it.
- Else use `docs/prompts/`.

## Filename

- `YYYY-MM-DD-handover-<topic>.md`
- `<topic>` is auto-slugged on creation, using best available context:
  - Prefer PR title (if PR exists for current branch).
  - Else a short task/context summary (e.g., feature name, incident, or subsystem).
  - Else latest commit subject.
- If the user requests a specific slug/topic, honor it.
- On update: do not rename; update existing file unless the user requests a new file.

## Data sources

- Date: `date +%Y-%m-%d`
- Updated: `date -u +%Y-%m-%dT%H:%M:%SZ`
- Host: `hostname`
- Repo path: `pwd`
- Branch: `git rev-parse --abbrev-ref HEAD`
- HEAD: `git rev-parse HEAD`
- Git status: `git status -sb`
- PR (if available): `gh pr view --json number,title,url`

## Format (bullets only)

- Date: …
- Updated: …
- Host: …
- Repo: …
- Branch + HEAD: …
- PR: (if available) `#1234 Title (URL)`
- State:
  - clean/dirty
  - merge state (if any)
  - CI/deploy status (if relevant)
- Work done:
  - …
- Next:
  - …
- Notes:
  - …
- Git status:
  - ```text
    ## branch...origin/branch
    M file
    ```

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/transloadit) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->