Skip to content

fix: use CLAUDE_PLUGIN_ROOT for brainstorming script paths (issue #1134)#1727

Open
ElizioMartins wants to merge 1 commit into
obra:devfrom
ElizioMartins:fix/brainstorming-script-path
Open

fix: use CLAUDE_PLUGIN_ROOT for brainstorming script paths (issue #1134)#1727
ElizioMartins wants to merge 1 commit into
obra:devfrom
ElizioMartins:fix/brainstorming-script-path

Conversation

@ElizioMartins

Copy link
Copy Markdown

Who is submitting this PR?

Field Value
Your model + version Nemotron 3 Ultra (via OpenCode)
Harness + version OpenCode (latest)
All plugins installed superpowers
Human partner who reviewed this diff Elizio Martins

What problem are you trying to solve?

Issue #1134: Claude Code Opus frequently can't find the visual companion start script. The visual-companion.md guide references scripts/start-server.sh but the actual script lives at skills/brainstorming/scripts/start-server.sh. Agents read the guide and try to run scripts/start-server.sh from the plugin root, which fails with "no such file or directory".

What does this PR change?

Updates all script references in skills/brainstorming/visual-companion.md to use ${CLAUDE_PLUGIN_ROOT}/skills/brainstorming/scripts/ prefix:

  • start-server.sh (6 occurrences across platform-specific examples)
  • stop-server.sh (1 occurrence)
  • frame-template.html (1 occurrence)
  • helper.js (1 occurrence)

This ensures agents use the correct absolute path regardless of where they're running from.

Is this change appropriate for the core library?

Yes - this affects all users of the brainstorming skill's visual companion feature across all harnesses.

What alternatives did you consider?

Alternative would be to copy scripts to plugin root, but that duplicates files. Using CLAUDE_PLUGIN_ROOT (set by Claude Code) is the intended pattern per existing hooks and RELEASE-NOTES.md.

Does this PR contain multiple unrelated changes?

No - single cohesive change updating all script references in one file.

Existing PRs

Environment tested

Harness Harness version Model Model version/ID
OpenCode latest Nemotron 3 Ultra nemotron-3-ultra-free

Evaluation

Rigor

  • This change was tested adversarially, not just on the happy path
  • I did not modify carefully-tuned content (Red Flags table, rationalizations, "human partner" language)

Human review

  • A human has reviewed the COMPLETE proposed diff before submission

…a#1134)

Update visual-companion.md to reference scripts via \/skills/brainstorming/scripts/ instead of relative paths.

Fixes the issue where agents look for start-server.sh in the plugin root (superpowers/5.0.7/scripts/) instead of the skill directory (superpowers/5.0.7/skills/brainstorming/scripts/).

Updated references:
- start-server.sh (6 occurrences across platform examples)
- stop-server.sh (1 occurrence)
- frame-template.html (1 occurrence)
- helper.js (1 occurrence)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant