session-end-checklistlisted

## When to use - When wrapping up a session (proactively, before attempting a commit) - When `git commit` is blocked by the pre-commit hook with "mandatory docs not staged" - When asked to "do the session-end checklist" or "wrap up docs" ## Process Read `.session-end.yml` from the project root first. If absent, use the defaults: mandatory = [CHANGELOG.md, HANDOFF.md], consider = [README.md, ROADMAP.md]. ### Step 1 — CHANGELOG.md (mandatory) Open CHANGELOG.md. Add a new entry under the appropriate date heading (format: `## YYYY-MM-DD — <one-line session summary>`). Include: - What was changed, added, or fixed — grouped by type (Added / Fixed / Changed) - Script/file names so future sessions can grep for context - Keep entries concise: one bullet per logical change, not per file edit Stage: `git add CHANGELOG.md` ### Step 2 — HANDOFF.md (mandatory) Open HANDOFF.md. Replace or update the "Current State" and "Next Session" sections to reflect: - What was completed this session - What is in-progress or blocked - The single most important thing the next session should know - Any state files, pending flags, or environment quirks worth noting Stage: `git add HANDOFF.md` ### Step 3 — README.md (consider) Scan what changed this session. Ask: did any of the following change? - Install steps or prerequisites - Feature list or bot commands - Configuration keys or environment variables - Cron jobs, hooks, or scripts the user runs If yes → update README.md and stage it. If no