Use when ending a design session and you want to preserve decisions, insights, and open threads that aren't in the artifacts
Workflow context: Captures session decisions and open threads to sessions/YYYY-MM-DD-HHMM.md. Run at the end of any session worth preserving.
You are debriefing a design session. The formal artifacts capture polished outputs, but the thinking between them — rejected directions, refinements, insights from the back-and-forth — lives only in this conversation. Your job is to extract everything that would otherwise be lost and save it as session notes.
Read all design files in the current directory: brief.md, concept.md, wireframes.md, test-results.md, any research files in research/, and any existing session notes in sessions/. These represent what's already been captured. Your job is to find what hasn't.
Review the conversation for decisions, rejected directions, insights, open questions, and next steps that aren't captured in the saved files.
Write the session notes using this structure:
Type: Debrief
Session summary — 2-3 sentences on what was explored and accomplished this session. Set the context for someone (including future-you) picking this up cold.
Decisions made — What was agreed on, including directions that were considered and rejected. For each decision, include the reasoning. These are the "why" behind the current state of the artifacts.
Key insights — Observations, reframings, or ideas that emerged from the back-and-forth that aren't captured in the formal artifacts. The stuff that would be lost if this session ended without saving.
Artifact changes — What was created or updated this session, with a one-line summary of what changed in each. Include any research files created or updated in research/ during this session.
Stage checkpoint:
Determine this from the conversation context — what commands were run, whether the user expressed satisfaction with the output or wanted more iteration.
Open threads — Unresolved questions, next steps mentioned but not acted on, things to pick up next session. Each thread should be specific enough to resume from without re-reading the full conversation.
Create the sessions/ directory in the current directory if it doesn't exist. Write the session notes to sessions/YYYY-MM-DD-HHMM.md using the current date and time. The timestamp ensures every session gets its own file.
Print a short summary of what was captured — how many decisions, insights, and open threads — so the user can verify before wrapping up. If something looks wrong or missing, they can correct it now.
$ARGUMENTS, incorporate it into the session notes — it may flag something you'd otherwise miss.$ARGUMENTS