| name | ttyl |
| description | End-of-session housekeeping. Updates decisions.md and in-progress.md for the current project so the next session can pick up cleanly without --resume. |
ttyl
Session wind-down. Run this before ending a session.
State dir convention: Always write to .meta/, creating it (and subdirectories) if needed.
Step 1: Review the session
Silently review:
- Git log of commits made this session
- Current state of the project's
decisions.md and in-progress.md
- What was accomplished, what's still open, what changed direction
Step 2: Update decisions.md
Append any decisions made this session that aren't already logged. Follow the existing format (date + decision). Only log decisions that would be useful context for a future session — not every micro-choice. Check what's already in the file first — /ship and other skills may have already appended entries this session.
Step 3: Update in-progress.md
Rewrite the Active and Parked sections to reflect current reality:
- Move completed items out of Active
- Add anything that came up but wasn't finished
- Park things that were deprioritized
- Keep it tight — this is read at session start
- Future work and ideas go in
roadmap.md, not here — in-progress.md
is present-tense only
Step 4: Clean up breadcrumbs
If breadcrumbs.log exists in the state dir:
- Crash-recovery content (everything outside
## Notes): clear it.
Now that decisions.md and in-progress.md are updated, it's redundant.
## Notes section: increment every note's session counter by 1.
If any notes have a counter of 5 or higher (they were surfaced in
/hello and still not addressed), delete them silently and print:
"Notes cleared: [list]". Leave all other notes in place.
Don't delete the file — the hook expects it to exist.
Step 5: Archive consumed inbox files
Check inbox/ for files consumed this session — content folded into a
design, decision, or skill, or explicitly resolved. Move them to
archive/inbox/ per the archival convention (references/archival.md).
Report what was archived; ask before archiving anything ambiguous.
Screenshots (SII files, e.g. *.png) are usually throwaway once acted on.
Default: delete consumed screenshots rather than archive them. The
archive-screenshots: true signpost flag opts into keeping them.
Don't touch todo.md itself — it's the standing item-inbox, not a consumed
file. (Completed todo items graduate via /triage or /review.)
Step 6: Flag unclosed designs
Check designs/ for any accepted designs whose work appears
complete (based on git log and in-progress.md). If found, remind the
user — they may want to run /review to formally close them before ending.
Don't block on this.
Step 7: Confirm
Show the user what you wrote/changed so they can adjust before the session ends.
