OthmanAdi/planning-with-files v3.1.2

v3.1.2: session-catchup works outside the plugin runtime (+ .hermes parity, description refresh)

on GitHub

Documentation patch.

The session-catchup command documented in the skill body used ${CLAUDE_PLUGIN_ROOT}, which the Claude Code plugin runtime sets only when it executes a hook, not in an interactive shell. A skill-only install (npx skills add, Codex, Cursor) that copy-pasted the command got an empty variable and a broken /scripts/... path.

Fixed (PR #186 by @shunfeng8421, closes #185): SKILL_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/skills/planning-with-files}". Plugin users keep the variable as priority, skill-only users fall back to the default install path. Applied to the canonical file, .codebuddy, and the five language variants. Windows PowerShell and plugin behavior unchanged.

Also in this release:

• The .hermes variant carried the same unset-variable bug ($HERMES_HOME with no fallback). Fixed in both bash and PowerShell, keeping the runtime variable as priority.
• The eight English SKILL.md descriptions were refreshed to lead with persistent planning for AI coding agents and context-loss survival. The Use when trigger clause is unchanged, so model invocation is identical; the five translated variants keep their localized descriptions.
• Version bumped to 3.1.2 across the 17 parity-locked files.

Documentation only. Suite: 180 passed, 4 skipped.

Thanks to @shunfeng8421 for the fix, and to @xwang118 for surfacing the underlying problem in PR #183 that became #185.