Skip to content

chat-handoff.md

Latest commit

 

History

History
84 lines (60 loc) · 1.96 KB

chat-handoff.md

File metadata and controls

84 lines (60 loc) · 1.96 KB
Raw

Chat Handoff

Chat handoff is for continuing work in a new agent chat on the same branch.

Use it when:

  • The conversation is getting long.
  • Another agent chat should continue the same branch.
  • Work is not ready for human review.
  • You need a compact continuation prompt without changing repo history.

Rules

Do not:

  • Update SESSIONS.md
  • Update SESSIONS_ARCHIVE.md
  • Push
  • Print merge commands

Do:

  • Report current branch and HEAD.
  • Report clean or dirty worktree state.
  • List commits already made on the branch.
  • List changed files and why they matter.
  • List tests/checks run.
  • List open items.
  • Give exact next steps.
  • Name any files intentionally left uncommitted.
  • Make the handoff self-contained. Assume the next chat receives only the handoff block.

Gather

git status --short --branch
git log --oneline main..HEAD
git diff main...HEAD --stat

Use the project main branch if it is not main. Or run scripts/handoff.sh --mode chat to gather these and print a pre-filled block.

Output Template

# Chat Handoff - <PROJECT_NAME>

Branch: `<branch-name>`
HEAD: `<short hash> <subject>`
Worktree: clean/dirty

Commits:
- `<short hash>` <subject>

Changed files:
- `<path>`: <why it matters>

Tests/checks:
- <command/result>

Open:
- <blocker/risk>

Next:
1. <immediate next step>
2. <next step>

Intentionally uncommitted:
- <path or "none">

Continuation prompt:
Continue work in this repository on branch `<branch-name>`.

Current state:
- HEAD: `<short hash> <subject>`
- Worktree: clean/dirty
- Completed: <one-sentence summary>
- Open: <blocker/risk or "none">
- Next: <immediate next step>

Start by reading the project startup instructions and the top of `SESSIONS.md`. Read task-relevant docs only as needed. Do not restart strategy. First inspect `git status --short --branch`, `git log --oneline main..HEAD`, and `git diff main...HEAD --stat`.

The whole block is the handoff. It must be safe to paste by itself into a new chat.