session

Carry the durable part of a session across /clear, and hold open loops until they land. dump composes a small handover doc from the live conversation, writes it to .claude/state/session/<slug>.md, and ends by printing /clear. The session-restore.js hook (SessionStart, matcher clear) injects that doc into the fresh session, so restore is free. Implementation detail — diffs, tool output, exploration transcript, abandoned approaches — is dropped on purpose; only the decision that settled an approach survives.

Runs inline, never context: fork. The conversation history is the authoritative source for what changed, what was decided, and what never landed; a forked run would see none of it.

NOT for: auto-compact survival (compaction.md skill contract); reviving a finished conversation (native /resume). Boundary table in the notes section below.

• $ARGUMENTS: required. Six modes:
  • dump [name] — sweep, compose and write the handover doc, set the LATEST pointer, print the /clear next step. name optional; unnamed dumps derive a slug from branch + UTC timestamp.
  • recall [name] — print a stored handover into context and mark it consumed. Named, or LATEST when omitted. Manual path for the dumps the hook skips.
  • list — table of stored handovers (slug, age, consumed) plus the open parked items.
  • park <idea> — append one open-loop item to .claude/state/session/PARKED.md. No dump needed; works any time.
  • sweep — read the conversation for unlanded ideas, unanswered questions and pending tasks; report them and offer to park.
  • drop <item> — fuzzy-match a parked item and remove it, logging the closure.

• Store dir: .claude/state/session/ (project-local; .claude/state/ is gitignored, same as session-context.md)
• Item store: .claude/state/session/PARKED.md — one bullet per open item; survives every dump, never auto-deleted
• Pointer file: .claude/state/session/LATEST — plain text, the slug of the most recent unconsumed dump. Blank or missing = nothing pending.
• Closure log: .claude/state/session/dropped.jsonl — one JSON line per drop
• Doc size cap: ~1.5K tokens (~75 lines). Compress prose, never drop a decision.
• Hook auto-restore window: unconsumed and created within 30 min. Outside it, recall is the manual path.
• Hook truncation threshold: ~8000 chars — above it the hook injects ## Goal + files table + ## Next step + a → /foundry:session recall <slug> pointer instead of the whole doc.
• Stale threshold: 14 days (⚠ stale prefix when listing) — applies to handover docs and parked items
• Delete threshold: 30 days — handover docs only, swept during list. Parked items are never auto-deleted; only drop removes one.
• Files-table row cap: 25 (over that, group by directory and state the elided count)

Task hygiene: load and follow the protocol below.

# audit-skip: resilience-replication
python "${CLAUDE_PLUGIN_ROOT:-plugins/cc_foundry}/bin/load_shared_doc.py" foundry skills/_shared task-hygiene.md  # timeout: 5000

Step 0: Validate and dispatch mode

Extract first word of $ARGUMENTS as MODE.

If MODE matches:

• dump (alias: save) → Mode: dump
• recall (aliases: restore, load) → Mode: recall
• list → Mode: list
• park → Mode: park
• sweep → Mode: sweep
• drop (alias: archive) → Mode: drop

Unsupported flag check — after extracting the mode token, scan $ARGUMENTS for remaining --<token> patterns. If found: print ! Unknown flag(s): `--<token>`. Supported modes: dump, recall, list, park, sweep, drop. then invoke AskUserQuestion — (a) Abort (stop, re-invoke correctly) · (b) Continue ignoring (skip unknown flags, proceed with recognized mode).

Otherwise (empty, unrecognized, misspelled): use AskUserQuestion:

"Which session mode did you want?"

Options: (a) dump [name] — write the handover doc now, (b) park <idea> — stash one open loop without derailing, (c) sweep — audit the conversation for unlanded work, (d) list — stored handovers and open items