Skip to content

alirezarezvani/claude-skills / productivity/handoff/skills/session-handoff

session-handoff

Verified

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.

assets/example_handoff.md

View on GitHub
---
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._
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall