diff options
| -rw-r--r-- | .antigravity-plugin/plugin.json | 2 | ||||
| -rw-r--r-- | .claude-plugin/marketplace.json | 2 | ||||
| -rw-r--r-- | .claude-plugin/plugin.json | 2 | ||||
| -rw-r--r-- | .codex-plugin/plugin.json | 2 | ||||
| -rw-r--r-- | .cursor-plugin/plugin.json | 2 | ||||
| -rw-r--r-- | .devin-plugin/plugin.json | 2 | ||||
| -rw-r--r-- | .hermes-plugin/plugin.yaml | 2 | ||||
| -rw-r--r-- | .kimi-plugin/plugin.json | 2 | ||||
| -rw-r--r-- | .muse-plugin/marketplace.json | 2 | ||||
| -rw-r--r-- | .muse-plugin/plugin.json | 2 | ||||
| -rw-r--r-- | .opencode/INSTALL.md | 2 | ||||
| -rw-r--r-- | RELEASE-NOTES.md | 48 | ||||
| -rw-r--r-- | docs/README.opencode.md | 2 | ||||
| -rw-r--r-- | gemini-extension.json | 2 | ||||
| -rw-r--r-- | package.json | 2 | ||||
| -rwxr-xr-x | scripts/bump-version.sh | 6 | ||||
| -rw-r--r-- | tests/version-bump/test-bump-version.sh | 13 | ||||
| -rwxr-xr-x | tests/writing-skills/test-render-graphs.sh | 4 |
18 files changed, 62 insertions, 37 deletions
diff --git a/.antigravity-plugin/plugin.json b/.antigravity-plugin/plugin.json index 2e5e79c..6f85dec 100644 --- a/.antigravity-plugin/plugin.json +++ b/.antigravity-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "superpowers", "displayName": "Superpowers", - "version": "6.4.2", + "version": "7.0.0", "description": "Make your coding agent a better engineer", "logo": "assets/antigravity-logo.png", "suggestedPrompts": [ diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 87d873f..92f8ab9 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -9,7 +9,7 @@ { "name": "superpowers", "description": "Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques", - "version": "6.4.2", + "version": "7.0.0", "source": "./", "author": { "name": "Jesse Vincent", diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index aa2a09c..86e0b12 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "superpowers", "description": "Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques", - "version": "6.4.2", + "version": "7.0.0", "author": { "name": "Jesse Vincent", "email": "jesse@fsck.com" diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json index f147352..9a9d0fe 100644 --- a/.codex-plugin/plugin.json +++ b/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "superpowers", - "version": "6.4.2", + "version": "7.0.0", "description": "An agentic skills framework & software development methodology that works: planning, TDD, debugging, and collaboration workflows.", "author": { "name": "Jesse Vincent", diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.json index 8a8475c..e769727 100644 --- a/.cursor-plugin/plugin.json +++ b/.cursor-plugin/plugin.json @@ -2,7 +2,7 @@ "name": "superpowers", "displayName": "Superpowers", "description": "Core skills library: TDD, debugging, collaboration patterns, and proven techniques", - "version": "6.4.2", + "version": "7.0.0", "author": { "name": "Jesse Vincent", "email": "jesse@fsck.com" diff --git a/.devin-plugin/plugin.json b/.devin-plugin/plugin.json index 71d0f0b..fd40a96 100644 --- a/.devin-plugin/plugin.json +++ b/.devin-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "superpowers", - "version": "6.4.2", + "version": "7.0.0", "description": "An agentic skills framework & software development methodology that works: planning, TDD, debugging, and collaboration workflows.", "author": { "name": "Jesse Vincent", diff --git a/.hermes-plugin/plugin.yaml b/.hermes-plugin/plugin.yaml index 9de7655..f2da36c 100644 --- a/.hermes-plugin/plugin.yaml +++ b/.hermes-plugin/plugin.yaml @@ -1,5 +1,5 @@ name: superpowers -version: 6.4.2 +version: 7.0.0 description: Superpowers skills and workflow bootstrap for Hermes Agent author: obra provides_hooks: diff --git a/.kimi-plugin/plugin.json b/.kimi-plugin/plugin.json index 1effbcf..3da881d 100644 --- a/.kimi-plugin/plugin.json +++ b/.kimi-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "superpowers", - "version": "6.4.2", + "version": "7.0.0", "description": "An agentic skills framework and software development methodology.", "author": { "name": "Jesse Vincent", diff --git a/.muse-plugin/marketplace.json b/.muse-plugin/marketplace.json index c3d7295..4306a70 100644 --- a/.muse-plugin/marketplace.json +++ b/.muse-plugin/marketplace.json @@ -9,7 +9,7 @@ { "name": "superpowers", "description": "Core skills library for Muse: TDD, debugging, collaboration patterns, and proven techniques", - "version": "6.4.2", + "version": "7.0.0", "source": "./", "author": { "name": "Jesse Vincent", diff --git a/.muse-plugin/plugin.json b/.muse-plugin/plugin.json index 3588fd5..32bdcbf 100644 --- a/.muse-plugin/plugin.json +++ b/.muse-plugin/plugin.json @@ -2,7 +2,7 @@ "schemaVersion": 1, "name": "superpowers", "displayName": "Superpowers", - "version": "6.4.2", + "version": "7.0.0", "description": "Core skills library for Muse: TDD, debugging, collaboration patterns, and proven techniques", "compat": { "source": "native", diff --git a/.opencode/INSTALL.md b/.opencode/INSTALL.md index dca404b..2102fd1 100644 --- a/.opencode/INSTALL.md +++ b/.opencode/INSTALL.md @@ -79,7 +79,7 @@ V1 `plugin` key and the V2 `plugins` key): ```json { - "plugin": ["superpowers@git+https://github.com/obra/superpowers.git#v6.4.2"] + "plugin": ["superpowers@git+https://github.com/obra/superpowers.git#v7.0.0"] } ``` diff --git a/RELEASE-NOTES.md b/RELEASE-NOTES.md index d091b57..1789816 100644 --- a/RELEASE-NOTES.md +++ b/RELEASE-NOTES.md @@ -1,44 +1,52 @@ # Superpowers Release Notes -## Unreleased +## v7.0.0 (2026-10-09) -### Antigravity +We rebuilt brainstorming from scratch so it does a much better job of what it was always for: helping you work out what you actually want and put it into words before anything gets built. The new skill asks you to describe what you're after and why, plays back what it heard so you can correct it, and keeps asking good questions until the picture is clear. Then it matches the process to the work, from just doing it to writing a full design. -- **`agy plugin install https://github.com/obra/superpowers` now installs Superpowers as a native Antigravity plugin.** The repo ships `.antigravity-plugin/plugin.json` with the Marketplace display name, logo and suggested prompts. Before, agy fell back to importing the repo as a Gemini CLI extension and rejected the copied Claude-format hooks file on every session with `invalid hook "hooks": command hook must specify 'command'`; that error is gone. The install command is unchanged. -- **Superpowers bootstraps on Antigravity through skill discovery.** Antigravity has no session-start hook event, but it lists each installed skill's description, and `using-superpowers`' "Use when starting any conversation" gets the model to load it. Verified on agy 1.3.1 across 12 runs: "Let's make a react todo list" and "add a settings page" trigger brainstorming before any code, a failing test triggers systematic-debugging before any edit, and a second turn after an unrelated first turn still triggers brainstorming. +This release also adds a native plugin manifest for the Antigravity Marketplace and fixes Windows hook discovery, Git Bash paths, Hermes skill descriptions, and several smaller bugs. ### Brainstorming -- **Visual companion screens containing `$'`, `$&` or similar are no longer corrupted.** The server inserted screen content with `String.replace`, which treats those sequences as replacement patterns, so content like `NT$'` spliced pieces of the frame into the page. Content is now inserted literally. Thanks @andrew-yian for the report and @luochen211 for the fix. (#2362, #2364) +- **Brainstorming draws out what you want before it proposes anything.** Its first message offers to skip the questions and asks one open question about a real moment or a concrete picture. It offers a menu only when you're stuck. Along the way, it offers to look at prior art, your project, or the web. As it understands each part, it plays that part back in a few hundred words and marks its guesses as guesses. (#2463) +- **It sizes the work after it understands what you want, and says so in plain words.** It does a quick, clear task right away, agrees a small change with you in chat, and writes a design document for a project. You can override its call, and it steps up a size if the work grows. (#2463) +- **A builder check replaces the spec-document reviewer.** A fresh subagent reads the design as the person who'll build it and lists what they'd still need to ask. Brainstorming answers what it can, makes the minor calls itself and marks them as its own, and brings you the questions that change what gets built, in one round. (#2463) +- **It finds out which choices about how the thing gets made you want to own.** Platform, language, libraries, medium: if you have strong views, it talks them through; if you hand them over, it picks sensible defaults and tells you what it picked. It does this even when you skip the questions. We made this change after a session designed an iOS app, never asked about platform, and built a web app. (#2482, #2483) +- **It offers the visual companion whenever seeing would help more than reading:** screens, layouts, flows, options that look different, diagrams. The offer drops its token-cost warning. (#2463) +- **The visual companion now shows screens containing `$'`, `$&`, and similar sequences intact.** The server inserted content with `String.replace`, which treats those sequences as replacement patterns. It now inserts content literally. Thanks @andrew-yian for the report and @luochen211 for the fix. (#2362, #2364) -### Systematic Debugging +### Antigravity -- **The multi-layer diagnostic example no longer prints the secret it checks for.** `${IDENTITY:+SET}${IDENTITY:-UNSET}` and `env | grep IDENTITY` both echoed the signing identity's value into logs; the example now reports only whether it's set. Thanks @kennyg-g for the report and @m2dumpling for the fix. (#2375, #2380) +- **`agy plugin install https://github.com/obra/superpowers` now installs Superpowers as a native Antigravity plugin.** We added `.antigravity-plugin/plugin.json` with the Marketplace display name, logo, and suggested prompts. Previously, agy fell back to importing the repo as a Gemini CLI extension, then rejected the copied Claude-format hooks file on every session with `invalid hook "hooks": command hook must specify 'command'`. The install command stays the same. (#2479) +- **Superpowers bootstraps on Antigravity through skill discovery.** Antigravity has no session-start hook event, but it shows the model each installed skill's description, and `using-superpowers`' "Use when starting any conversation" prompts the model to load it. We verified this on agy 1.3.1 across 12 runs: "Let's make a react todo list" and "add a settings page" triggered brainstorming before any code, and a failing test triggered systematic-debugging before any edit. We also corrected the README and porting guide, which described a session-start hook and install script that never existed. (#2479) -### Executing Plans +### Hooks -- **`task-done` records tasks whose test command passes silently.** A passing command with no output made `task-done` exit 1 without writing the ledger line, so a finished task looked unfinished. The ledger now records `→ (no output)`. Thanks @KenM-BT for the report and Ada Sen for the fix. (#2385, #2388) +- **SessionStart now works when the harness launches it with a broken `PATH`.** The hooks no longer look up `dirname`, `cat`, or `bash` on `PATH`, so a startup `PATH` that can't resolve them (anthropics/claude-code#43127) no longer drops the bootstrap. Thanks @kannan983 for the report and Ada Sen for the fix. (#2310, #2349) +- **Windows: `run-hook.cmd` finds per-user Git for Windows installs and skips WSL launchers.** It now checks `%LOCALAPPDATA%\Programs\Git`, and when it searches `PATH`, it skips the WSL `bash.exe` launchers, which fail without a Linux distro. Thanks @jp5247 for the report, and @citizen204 (#1864) and @KaiyiQuan (#2365) for the fixes we combined here. (#1863, #2393) +- **Windows: `run-hook.cmd` ignores `bash` and `where` in the current directory.** Previously, a repository could plant `bash.cmd` or `where.bat` and have it run at session start. (#2393) +- **Windows: `run-hook.cmd` now passes hook exit codes to the harness.** It used to report success even when the hook failed. (#2393) -### Hooks +### Subagent-Driven Development -- **SessionStart works when the harness starts it with a broken `PATH`.** The hooks no longer need `dirname`, `cat` or `bash` from `PATH`, so a startup `PATH` that can't resolve them (anthropics/claude-code#43127) no longer drops the bootstrap. Thanks @kannan983 for the report and Ada Sen for the fix. (#2310, #2349) -- **Windows: `run-hook.cmd` finds a per-user Git for Windows install and skips the WSL launchers.** It now checks `%LOCALAPPDATA%\Programs\Git`, and when it searches `PATH` it skips the `bash.exe` WSL launchers that fail without a Linux distro. Thanks @jp5247 for the report, and @citizen204 (#1864) and @KaiyiQuan (#2365) for the fixes this combines. (#1863, #2393) -- **Windows: `run-hook.cmd` no longer runs `bash` or `where` from the current directory.** A repository containing `bash.cmd` or `where.bat` could have had it run at session start. (#2393) -- **Windows: hook exit codes now reach the harness.** `run-hook.cmd` used to report success even when the hook failed. (#2393) +- **`sdd-workspace` leaves a repo's own `.superpowers/sdd/.gitignore` alone.** It used to overwrite the file with `*` on every run, reverting any version a repo committed (for example, to track `progress.md` ledgers). It now writes the default only when no file exists. Thanks @aruizcu1989 for the fix. (#2161, #2399) +- **Plan markers stay repo-relative on Windows.** On Git Bash, `sdd-workspace` compared `git rev-parse`'s `C:/…` root with the plan's `/c/…` path, so every workspace marker recorded an absolute, machine-specific path. It now resolves the root the same way as the plan path. We found this while landing @t0domanh's Windows test fixes (#2149). -### Requesting Code Review +### Executing Plans -- **The example's base-SHA command survives skill arguments.** Claude Code substitutes `$1` in a skill body with the second argument word, so invoking the skill with arguments turned `awk '{print $1}'` into `awk '{print <word>}'`. The example now uses `cut -d' ' -f1`, which has no `$` token. Thanks @errmakov for the report and @klemens-floege for the fix. (#2311, #2361) +- **`task-done` now records tasks whose test command passes silently.** When a passing command printed nothing, `task-done` exited 1 without writing the ledger line, so a finished task looked unfinished. It now records `→ (no output)`. Thanks @KenM-BT for the report and Ada Sen for the fix. (#2385, #2388) -### Subagent-Driven Development +### Requesting Code Review + +- **The example's base-SHA command survives skill arguments.** Claude Code replaces `$1` in a skill body with the second argument word, so invoking the skill with arguments turned `awk '{print $1}'` into `awk '{print <word>}'`. The example now uses `cut -d' ' -f1`, which contains no `$`. Thanks @errmakov for the report and @klemens-floege for the fix. (#2311, #2361) -- **`sdd-workspace` leaves a repo's own `.superpowers/sdd/.gitignore` alone.** It used to rewrite the file with `*` on every run, so a repo that commits its own (for example, to version `progress.md` ledgers) saw it reverted after each SDD run. The default is now written only when no file exists. Thanks @aruizcu1989 for the fix. (#2161, #2399) +### Systematic Debugging -- **Plan markers stay repo-relative on Windows.** On Git Bash, `sdd-workspace` compared `git rev-parse`'s `C:/…` root with the plan's `/c/…` path, so every workspace marker recorded an absolute, machine-specific path. The root is now resolved the same way as the plan path. Found while landing the Windows test fixes from @t0domanh (#2149). +- **The multi-layer diagnostic example no longer prints the secret it checks for.** `${IDENTITY:+SET}${IDENTITY:-UNSET}` and `env | grep IDENTITY` both echoed the signing identity's value into logs. The example now reports only whether the variable is set. Thanks @kennyg-g for the report and @m2dumpling for the fix. (#2375, #2380) ### Hermes Agent -- **Superpowers skills show their descriptions in Hermes' skill list.** Hermes lists plugin skills with the description passed to `register_skill`, which defaults to empty, and the plugin only passed a name and path, so every skill appeared blank and the model had nothing to choose on. Each skill's frontmatter description is now passed through. Thanks @pepijn-blom for the fix. (#2284) +- **Hermes' skill list now shows Superpowers skill descriptions.** Hermes lists each plugin skill with the description passed to `register_skill`, which defaults to empty. The plugin passed only a name and path, so every skill appeared blank and the model had nothing to choose from. The plugin now passes each skill's frontmatter description. Thanks @pepijn-blom for the fix. (#2284) ## v6.4.2 (2026-09-25) diff --git a/docs/README.opencode.md b/docs/README.opencode.md index 404a65d..980941e 100644 --- a/docs/README.opencode.md +++ b/docs/README.opencode.md @@ -111,7 +111,7 @@ V1 `plugin` key and the V2 `plugins` key): ```json { - "plugin": ["superpowers@git+https://github.com/obra/superpowers.git#v6.4.2"] + "plugin": ["superpowers@git+https://github.com/obra/superpowers.git#v7.0.0"] } ``` diff --git a/gemini-extension.json b/gemini-extension.json index 915bfd2..878b94a 100644 --- a/gemini-extension.json +++ b/gemini-extension.json @@ -1,6 +1,6 @@ { "name": "superpowers", "description": "Core skills library: TDD, debugging, collaboration patterns, and proven techniques", - "version": "6.4.2", + "version": "7.0.0", "contextFileName": "GEMINI.md" } diff --git a/package.json b/package.json index d9339ad..1dc53c2 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "superpowers", - "version": "6.4.2", + "version": "7.0.0", "description": "Superpowers skills and runtime bootstrap for coding agents", "type": "module", "main": ".opencode/plugins/superpowers.js", diff --git a/scripts/bump-version.sh b/scripts/bump-version.sh index 14ead00..2f3acee 100755 --- a/scripts/bump-version.sh +++ b/scripts/bump-version.sh @@ -188,7 +188,9 @@ cmd_audit() { declared_paths+=("$path") done < <(declared_files) - # Grep for the version string + # Grep for the version string, but not inside a longer number such as an + # IP address; a "v" prefix or surrounding quotes still match. + local version_pattern="(^|[^0-9.])${current_version//./\\.}([^0-9]|$)" local found_undeclared=0 while IFS= read -r match; do local match_file @@ -212,7 +214,7 @@ cmd_audit() { fi echo " $match" fi - done < <(grep -rn "${exclude_args[@]}" -F "$current_version" "$REPO_ROOT" 2>/dev/null || true) + done < <(grep -rnE "${exclude_args[@]}" "$version_pattern" "$REPO_ROOT" 2>/dev/null || true) if [[ "$found_undeclared" -eq 0 ]]; then echo "No undeclared files contain the version string. All clear." diff --git a/tests/version-bump/test-bump-version.sh b/tests/version-bump/test-bump-version.sh index 195d88a..2f77a48 100644 --- a/tests/version-bump/test-bump-version.sh +++ b/tests/version-bump/test-bump-version.sh @@ -73,4 +73,17 @@ cmp -s "$TEST_ROOT/package.before" "$invalid_repo/package.json" \ cmp -s "$TEST_ROOT/plugin.before" "$invalid_repo/.hermes-plugin/plugin.yaml" \ || fail "invalid YAML manifest changed" +audit_repo="$TEST_ROOT/audit-boundaries" +make_fixture "$audit_repo" $'name: superpowers\nversion: 1.2.3' +/bin/bash "$audit_repo/scripts/bump-version.sh" 4.0.0 >/dev/null +printf 'host = "10.4.0.0"\n' >"$audit_repo/server.js" +printf 'pin: superpowers.git#v4.0.0\n' >"$audit_repo/INSTALL.md" +/bin/bash "$audit_repo/scripts/bump-version.sh" --audit >"$TEST_ROOT/audit-boundaries.out" + +grep -q 'INSTALL.md' "$TEST_ROOT/audit-boundaries.out" \ + || fail "audit missed an undeclared #v4.0.0 pin" +if grep -q 'server.js' "$TEST_ROOT/audit-boundaries.out"; then + fail "audit flagged 10.4.0.0 as version 4.0.0" +fi + echo "Version-bump tests passed" diff --git a/tests/writing-skills/test-render-graphs.sh b/tests/writing-skills/test-render-graphs.sh index 349cd47..8bda626 100755 --- a/tests/writing-skills/test-render-graphs.sh +++ b/tests/writing-skills/test-render-graphs.sh @@ -4,7 +4,9 @@ set -u SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)" REPO_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)" SCRIPT_UNDER_TEST="$REPO_ROOT/skills/writing-skills/render-graphs.js" -NODE_BIN="$(command -v node)" +# Resolve the real binary: version-manager shims (mise, asdf) can't find node +# under the empty PATH used for the missing-Graphviz case. +NODE_BIN="$(node -p 'process.execPath')" PASSES=0 FAILURES=0 |
