session-flow

Plugin session-flow from marketplace melodic-software in melodic-software/claude-code-plugins. Commands read from the repo's manifest — today.

Skills (18)

• audit-friction

  Audit Claude Code sessions for permission and autonomy friction (denials, approval prompts, hook blocks, hand-offs), traced to cause in one decision brief. Use when the agent keeps asking or handing off, auto mode denies, or re-measuring after permission fixes.

• audit-sessions

  Audit every Claude Code session on this machine for wasted time and tokens against a reference baseline, routing each finding to its fix, plus session score trends over time. Use when: 'audit my sessions', 'which sessions burned the most tokens', 'show trends', or corrections keep repeating. One ses

• clean-stop

  Clean stop before the machine goes away: sweep every repo and worktree touched for uncommitted, unpushed or PR-less work, push it, and give a free-and-clear verdict. Use when: 'clean stop', 'safe to shut down', or stopping for the day. Gates destructive cleanup.

• continue-in-background

  Hand the task to a fresh detached background agent (claude --bg or --cloud) that continues it now from a save-point. Use when the user is going AFK and explicitly asks to 'continue in the background'. Launches only on that request, never self-elected.

• find-handoff

  Recover a lost handoff save-point or resume prompt after /clear, from the handoffs folder then recent transcripts, confirming before resuming. Use when: 'find my handoff', 'I lost the resume prompt'. A session that ended mid-work: /session-flow:keep-going.

• handoff

  Write a mid-session save-point for /clear-and-resume: a durable handoff file or a copy-paste resume prompt. Use when: 'handoff', 'checkpoint this', the session is heavy, or responses drift or loop. Background continuation: /session-flow:continue-in-background.

• keep-going

  Resume after an interruption, rate limit or crash, or check stalled off-thread work by its real output, then continue the main task. Use when: 'keep going', 'is it stuck', 'what were you doing'. Gates kills. Retiring finished work: /session-flow:reconcile.

• orchestrate

  Arm the session for orchestration-heavy work with seven standing imperatives (delegate and fan out, spec every spawn, fresh-context verify, and more), optionally exported as a worker brief. Use when: 'orchestrate', 'prime this session', or before heavy delegation.

• orient

  Read-only orientation from durable state (ledgers, handoffs, open PRs and work items, git): where the session stands and why, or a zoom-out timeline of the whole effort. Use when: 'where were we', 'catch me up', 'situation report', 'zoom out', 'when did we start', 'what did we do each day'. Writes n

• reanchor

  Check a session's working assumptions for drift: PRs, issues and branches a handoff or plan cites, base-branch moves, renamed skills. Use when resuming an old plan or handoff: 'is this still current', 'has main moved since'. To resume: /session-flow:keep-going.

• recall

  Report what past sessions tried on a topic from this repo's transcripts, reverted commits, closed unmerged PRs and open items: tried, kept, reverted. Use when: 'what did we try for X', 'have we attempted this before'. Current state: /session-flow:orient.

• recommend-skills

  Ranked menu of every installed skill that fits this moment (Now, Next, Skipped upstream, Later, Spotlight), hiding nothing; a free-text question gets one skill and an example prompt. Use when: 'what are my options', 'which skill fits here', 'what am I forgetting'. One next stage: /session-flow:workf

• reconcile

  Retire finished off-thread work and reconcile the task ledger: inspect each spawned item's real state and close those proven done. Use when: 'reconcile the session', 'retire finished work', 'is anything still running'. Stuck work: /session-flow:keep-going.

• retro

  Structured session retrospective: transcript metrics, quality across five dimensions, feedback-memory regression check, and codified learnings. Use when: 'retro', 'what did we learn', or at end of session. Mid-session: /session-flow:running-retro.

• running-retro

  Mid-session retro checkpoint: a subagent files findings from the transcript so far into a running ledger, never applied; `arm` runs it after the session ends. Use when: 'running retro', 'checkpoint this session', 'watch this session in the background', or on a /loop.

• setup

  Verify the session-flow observer's runtime prerequisites and configuration for this machine, and write the repository's docs/conventions/session-flow.yaml after confirmation. Use when: 'set up session-flow', 'configure the observer', 'is the observer working', 'set worker_continuation for this repo'

• tidy-work

  Inventory and tidy the gitignored `.work` memory tiers (the repo's memory root and `~/.work`): report what is stale and what is in flight, normalize misplaced handoffs and retros, and remove stale known items behind one confirmation. Opt-in only; nothing runs unless invoked. Use when: 'tidy .work',

• workflow

  Staged workflow navigator (interview through retro): names the next stage and routes end-of-phase continuation (continue, clear, compact, handoff, background). Use when: 'what comes next', 'what step am I on', 'clear or compact'. Full skill menu: /session-flow:recommend-skills.

Hooks (1)

• SessionStart

  sh "${CLAUDE_PLUGIN_ROOT}/lib/node-or-skip.sh" "${CLAUDE_PLUGIN_ROOT}/hooks/exec-bash.mjs" "${CLAUDE_PLUGIN_ROOT}/hooks/observer-arm.sh"; ${PPID:+exit}; powershell -NoProfile -ExecutionPolicy Bypass -

Similar plugins