session-close

Session Close

Turn active session into recoverable, reviewable handoff without absorbing unrelated work.

This is lightweight closeout. Use retro-distill for deeper pattern mining after major chunks or failures.

Authority order

1. Read repository AGENTS.md and nested instructions governing changed paths.
2. Use repository-native closeout, worktree, documentation, and verification commands when defined.
3. Apply generic workflow below only where repository has no stronger rule.

Workflow

1. Inventory live state

Capture:

git rev-parse --show-toplevel
git branch --show-current
git rev-parse HEAD
git status --porcelain
git diff --name-only
git diff --cached --name-only
git log --oneline -10

Identify owned paths, unrelated dirty paths, commits made this session, and unpushed commits. Do not clean or stage yet.

2. Map changes to obligations

For each owned change, identify:

• tests or probes required by affected surface
• documentation that describes changed behavior
• generated artifacts needing repository-native regeneration
• release or deployment boundary
• session log or handoff format required by repository

Use live paths and current code. Prior plans record intent, not necessarily final state.

3. Reconcile documentation

Update canonical docs when behavior, architecture, commands, data contracts, or operator workflows changed. Avoid documentation churn for implementation details with no durable effect.

If required doc cannot be updated, record explicit exception with reason and follow-up owner. Do not silently leave known drift.

4. Verify proportionally

Use verify-honestly:

• run cheapest probe capable of catching likely failure
• cite existing green deterministic gates instead of repeating them
• verify UI in browser when UI behavior changed
• name live or production gaps instead of implying coverage
• record exact commands and results

5. Write handoff

Use repository session-log format when present. Otherwise record concise Markdown with: