From be44a15353f16cf9604e0fd0ca2bbe15c03e23b7 Mon Sep 17 00:00:00 2001 From: Kyle Sexton <153232337+kyle-sexton@users.noreply.github.com> Date: Sun, 15 Nov 2026 23:08:32 -0500 Subject: [PATCH] fix(session-flow): link the retro skill's context files from its own folder The retro skill named context/session.md and context/quick.md as bare backtick paths, and its "Spoke paths" note called them "the context/ files" beside . Eval runs read that as /context/session.md, failed, and globbed the plugin root, which is always denied. Every mention is now a relative Markdown link, the form this file already uses for reference/, and the note says the files sit in the skill's own context/ folder beside SKILL.md. Refs: #16368 Co-Authored-By: Claude Opus 5.5 --- ...context-paths-resolve-from-skill-dir-4405725a.md | 9 +++++++++ plugins/session-flow/skills/retro/SKILL.md | 13 +++++++------ 2 files changed, 16 insertions(+), 6 deletions(-) create mode 100644 .changes/session-flow/fix-16368-retro-context-paths-resolve-from-skill-dir-4405725a.md diff --git a/.changes/session-flow/fix-16368-retro-context-paths-resolve-from-skill-dir-4405725a.md b/.changes/session-flow/fix-16368-retro-context-paths-resolve-from-skill-dir-4405725a.md new file mode 100644 index 0000000000..da465f218f --- /dev/null +++ b/.changes/session-flow/fix-16368-retro-context-paths-resolve-from-skill-dir-4405725a.md @@ -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. diff --git a/plugins/session-flow/skills/retro/SKILL.md b/plugins/session-flow/skills/retro/SKILL.md index b2e2485a49..74a793c1f3 100644 --- a/plugins/session-flow/skills/retro/SKILL.md +++ b/plugins/session-flow/skills/retro/SKILL.md @@ -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`; @@ -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 @@ -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, @@ -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 ``, 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 ``, 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. @@ -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 '': 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