session-end

Session End

Write a handoff note to the appropriate session log so the next session can pick up where this one left off.

Two session logs exist:

• 01-context/session-log-work.md — Amazon work (Data Platform, Observability Platform, escalations, Exponent, internal tools)
• 01-context/session-log-personal.md — Personal/side projects (Discrobble, discogs-mcp, ListenToMore, tldl, blog posts, gaming)

Your Task

$ARGUMENTS

Instructions

1. Assess the Session

Review what happened in this conversation. Only write a handoff note if the session involved substantive work — decisions made, problems investigated, documents created, or significant context built up. Skip if the session was just a quick question or trivial task.

If the session wasn't substantive enough for a handoff note, say so and end.

Admission quality check: For each piece of information you'd include in the handoff note, ask:

• Novel? Does this extend or contradict something already in the system (skills, commands, stable-facts)? If it's already baked in, don't re-store it.
• Actionable? Can a future session use this? Debugging dead-ends and one-off lookups usually aren't worth recording.
• Durable? Will this matter in 2 weeks? Open threads and decisions yes; transient investigation details usually no.

Use judgment — these are quality filters, not hard gates. The goal is to keep the session log high-signal.

2. Draft the Entry

Determine which session log this entry belongs in based on the session topic:

• Work → 01-context/session-log-work.md
• Personal → 01-context/session-log-personal.md

Write a new H2 entry to prepend to the chosen file (newest first). Use this exact format:

## YYYY-MM-DD — [Brief topic description]

**What happened:** [1-3 sentences summarizing what was done. Be specific — mention file paths, ticket IDs, project names.]

**Decisions:** [Any decisions made during the session. Reference where they were documented if applicable.]

**Learned:** [Anything discovered that should persist — debugging insights, preferences expressed, corrections needed, approach that worked/didn't work. If nothing notable, omit this field.]

**Open threads:** [What's unfinished or needs follow-up. If nothing, omit this field.]