Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
bump: patch
---

### Fixed

- `/session-flow:retro`: every mention of its mode files links `context/session.md` and
`context/quick.md` relative to the skill's own folder, and "Spoke paths" says those files sit
beside the skill's SKILL.md, so a run no longer looks for them under the plugin root.
13 changes: 7 additions & 6 deletions plugins/session-flow/skills/retro/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -63,8 +63,8 @@ Resolve at runtime, never hardcode machine-specific paths:

| Signal | Mode | Context file |
|--------|------|-------------|
| End of session, bare `/session-flow:retro`, post-merge | **session** | `context/session.md`, full 5-phase analysis |
| "quick retro", short session, limited context | **quick** | `context/quick.md`, abbreviated pass |
| End of session, bare `/session-flow:retro`, post-merge | **session** | [context/session.md](context/session.md), full 5-phase analysis |
| "quick retro", short session, limited context | **quick** | [context/quick.md](context/quick.md), abbreviated pass |

Score history across sessions names no retro mode. Before reading any mode, stop on a bare "how am
I doing", a request for scores, or a `trends` argument, and name `/session-flow:audit-sessions trends`;
Expand Down Expand Up @@ -104,7 +104,7 @@ checkpoints.
### Session settings

The user option session mode reads, as rendered for this run (a literal, unexpanded placeholder
means unset): `retro_lenses` = `${user_config.retro_lenses}`. `context/session.md` "Review lenses"
means unset): `retro_lenses` = `${user_config.retro_lenses}`. [context/session.md](context/session.md) "Review lenses"
resolves it against the repository's `docs/conventions/session-flow.yaml`, which wins.

## Step 2: Handoff
Expand All @@ -123,7 +123,7 @@ default `.work/handoffs/`; or the consuming repo's documented location), the ret
whole session chain, not just the current session: the
parser's `--chain-from` walks `previous_handoff` frontmatter pointers
backwards from the newest handoff file and aggregates metrics across every chained transcript. See
`context/session.md` Phase 1.
[context/session.md](context/session.md) Phase 1.

**State the discovery basis, and never present a low-coverage chain retro silently.** The walk
follows `previous_handoff` pointers, so it stops at the first session that wrote no handoff file,
Expand Down Expand Up @@ -190,7 +190,8 @@ live from the records in [reference/native-insights.md](reference/native-insight

## Spoke paths

The `context/` files write the plugin's root directory as `<plugin-root>`, which is
This skill's own [context/session.md](context/session.md) and [context/quick.md](context/quick.md),
beside this SKILL.md, write the plugin's root directory as `<plugin-root>`, which is
`${CLAUDE_PLUGIN_ROOT}`. Put that path in place of the placeholder before running a command or
writing it into a brief: a `${…}` token in a spoke reaches the Bash tool unsubstituted.

Expand All @@ -203,7 +204,7 @@ writing it into a brief: a `${…}` token in a spoke reaches the Bash tool unsub
- /session-flow:audit-sessions sweep: checks whether what this retro found recurs across every
session on the machine.
- /session-flow:audit-sessions ticket --pattern '<regex>': every stored session for one work item.
Session mode calls it when given `--pattern` (`context/session.md`, "Ticket section").
Session mode calls it when given `--pattern` ([context/session.md](context/session.md), "Ticket section").

## Gotchas

Expand Down
Loading