AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

session-handoff

Write a handoff document so a fresh session or another agent can pick up exactly where this one left off: goal, current state, decisions, next steps and the skills to load, referencing existing files instead of copying them, with secrets redacted before saving. Use whenever the user is ending a session, switching machines, running low on context, or asks for a handoff, a handoff doc, a 'pick up where we left off' summary, or to compact the conversation for next time. Saves to a location the user picks on first run (OS temp, home folder or per-project .handoff/) and can auto-load the latest handoff at the next session start.

Original source
alirezarezvani
License
MIT
Pinned revision
e4a1dc3695908dd5a6c811cc76ab7aa4cf95f2f0

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

This skill also requires local files or dependencies. Remote reading alone may not be enough.

Ask your assistant

Use Agentic Memory skills to read alirezarezvani--session-handoff at revision e4a1dc3695908dd5a6c811cc76ab7aa4cf95f2f0, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 8

assets/example_handoff.md


generated_at: 2026-05-21T16:30:00Z goal: "Finish wiring the redaction linter into /cs-handoff and ship a draft PR before EOD."

Handoff — 2026-05-21

A fresh agent reads this to continue the work. Do not duplicate artifacts (PRDs, plans, ADRs, commits, diffs). Reference them by path or URL.

Goal of next session

Finish wiring the redaction linter into /cs-handoff and ship a draft PR before EOD.

State of play

Git context (auto-included from config).

  • Branch: claude/handoff-skill-review-LnSxe

  • Last commit: 87fb428 feat(productivity): add handoff skill

  • Dirty files: 3

  • Done:

    • Redaction linter implemented with 17 regex patterns — commit a1b2c3d
    • First-run setup walks 5 questions and writes config — commit d4e5f6g
    • SessionStart hook tested end-to-end on /tmp/handoff-*.md — verified manually
  • In flight:

    • Wiring cs-handoff.md command to call linter after template generator — uncommitted in productivity/handoff/commands/
  • Blocked:

    • SessionStart hook smoke test on macOS — need access to mac, waiting on @teammate

Open decisions

  • Q: Should the SessionStart hook surface the latest handoff or all handoffs from today?
    • Options considered: latest only, all-from-today, user-configurable
    • Lean: latest only — keeps context window small
    • Forcing constraint: ships in v1.0, can change in v1.1
  • Q: Strict redaction mode by default, or warn?
    • Options considered: strict, warn
    • Lean: strict — Matt's redaction sentence implies hard enforcement
    • Forcing constraint: none; reversible in config

Skills to use

  • handoff — to update this doc when work continues
  • code-review — to review the PR before opening it
  • security-scan — to confirm no secrets are committed alongside the linter
  • update-docs — to refresh README with the SessionStart hook installation step

Artifacts

  • Branch: claude/handoff-skill-review-LnSxe
  • Draft PR: https://github.com/alirezarezvani/claude-skills/pull/724
  • SKILL.md: productivity/handoff/skills/session-handoff/SKILL.md
  • Linter: productivity/handoff/skills/session-handoff/scripts/redaction_linter.py
  • Inspired by: https://github.com/mattpocock/skills/tree/main/skills/productivity/handoff

Inspired by Matt Pocock's handoff (MIT). See README for full credit.