An agentic skills framework & software development methodology that works.
fix: Windows hook execution for Claude Code 2.1.x (#331)
Jesse Vincent689e2a77fc8e
diff --git a/RELEASE-NOTES.md b/RELEASE-NOTES.mdindex cb3ad9055..42766121c 100644--- a/RELEASE-NOTES.md+++ b/RELEASE-NOTES.md@@ -1,5 +1,61 @@# Superpowers Release Notes+## Unreleased++### Breaking Changes++**OpenCode: Switched to native skills system**++Superpowers for OpenCode now uses OpenCode's native `skill` tool instead of custom `use_skill`/`find_skills` tools. This is a cleaner integration that works with OpenCode's built-in skill discovery.++**Migration required:** Skills must be symlinked to `~/.config/opencode/skills/superpowers/` (see updated installation docs).++### Fixes++**OpenCode: Fixed agent reset on session start (#226)**++The previous bootstrap injection method using `session.prompt({ noReply: true })` caused OpenCode to reset the selected agent to "build" on first message. Now uses `experimental.chat.system.transform` hook which modifies the system prompt directly without side effects.++**OpenCode: Fixed Windows installation (#232)**++- Removed dependency on `skills-core.js` (eliminates broken relative imports when file is copied instead of symlinked)+- Added comprehensive Windows installation docs for cmd.exe, PowerShell, and Git Bash+- Documented proper symlink vs junction usage for each platform++**Fixed Windows hook execution for Claude Code 2.1.x**++Claude Code 2.1.x changed how hooks execute on Windows: it now auto-detects `.sh` files in commands and prepends `bash `. This broke the polyglot wrapper pattern because `bash "run-hook.cmd" session-start.sh` tries to execute the .cmd file as a bash script.++Fix: hooks.json now calls session-start.sh directly. Claude Code 2.1.x handles the bash invocation automatically. Also added .gitattributes to enforce LF line endings for shell scripts (fixes CRLF issues on Windows checkout).++### New Features++**Visual companion for brainstorming skill**++Added optional browser-based visual companion for brainstorming sessions. When users have a browser available, brainstorming can display interactive screens showing current phase, questions, and design decisions in a more readable format than terminal output.++Components:+- `lib/brainstorm-server/` - WebSocket server for real-time updates+- `skills/brainstorming/visual-companion.md` - Integration guide+- Helper scripts for session management with proper isolation+- Browser helper library for event capture++The visual companion is opt-in and falls back gracefully to terminal-only operation.++### Improvements++**Instruction priority clarified in using-superpowers**++Added explicit instruction priority hierarchy to prevent conflicts with user preferences:++1. User's explicit instructions (CLAUDE.md, direct requests) — highest priority+2. Superpowers skills — override default system behavior where they conflict+3. Default system prompt — lowest priority++This ensures users remain in control. If CLAUDE.md says "don't use TDD" and a skill says "always use TDD," CLAUDE.md wins.++---+## v4.1.1 (2026-01-23)### Fixes