session-end

Session End

Use this skill at the end of a work session, before /clear, /new, switching tasks, or handing work to another Codex/Claude session.

Purpose

Produce a concise handoff that lets the next session continue without rereading the whole transcript. Separate temporary handoff notes from durable project knowledge.

Workflow

1. Read CLAUDE.md and the top of DEVELOPMENT_LOG.md.
2. Inspect the current work state:

git status --short
git diff --stat

1. If files changed, inspect only relevant diffs needed to summarize the work. Do not revert unrelated changes.
2. Summarize:
   • goal and current outcome
   • files changed and why
   • verification run and results
   • unresolved risks or blockers
   • exact next action for the next session
3. Update durable docs only when warranted:
   • DEVELOPMENT_LOG.md: add an entry for meaningful fixes, architectural decisions, hardware findings, or known pitfalls.
   • CLAUDE.md: update only for project-wide architecture, invariants, setup, or workflow changes.
   • AGENTS.md: update only for persistent agent behavior expectations.
4. Do not write secrets, credentials, tokens, private device passcodes, or raw prompt transcripts into durable docs.
5. If no durable doc update is warranted, say so explicitly in the final handoff.

Handoff Format

Return this shape:

**Session Handoff**
- Goal:
- Current state:
- Changed files:
- Verification:
- Open issues:
- Next action:
- Durable docs updated:

Keep it short enough to paste into a new Codex prompt. Include file paths for changed files, but avoid dumping large diffs.

Notes

• Use Codex /compact when the active thread should continue with a compressed context.
• Use /new or /clear after the handoff when the next task should start fresh.
• Use Codex Memories for personal recurring preferences only; required AgentDeck rules belong in checked-in docs.