<feed xmlns='http://www.w3.org/2005/Atom'>
<title>superpowers.git/docs, branch codex-sync-excludes-and-porting-examples</title>
<subtitle>Agentic skills framework and development workflow
</subtitle>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/'/>
<entry>
<title>docs(porting): Appendix A shows examples, not every harness</title>
<updated>2026-10-08T02:27:14+00:00</updated>
<author>
<name>Jesse Vincent</name>
<email>jesse@fsck.com</email>
</author>
<published>2026-10-08T02:27:14+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=e4dc1ced68b7eef84f61f040502fdfb03db8fc50'/>
<id>e4dc1ced68b7eef84f61f040502fdfb03db8fc50</id>
<content type='text'>
It called itself the live index of reference integrations, which it can't
stay without an update for every new harness, and it had already fallen
behind (no Devin, Hermes, or Muse). Present it as worked examples of each
integration shape and point to the repo's manifests as the source of truth.
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
It called itself the live index of reference integrations, which it can't
stay without an update for every new harness, and it had already fallen
behind (no Devin, Hermes, or Muse). Present it as worked examples of each
integration shape and point to the repo's manifests as the source of truth.
</pre>
</div>
</content>
</entry>
<entry>
<title>brainstorming: rebuild around drawing out intent (#2463)</title>
<updated>2026-10-06T23:57:52+00:00</updated>
<author>
<name>Jesse Vincent</name>
<email>jesse@primeradiant.com</email>
</author>
<published>2026-10-06T23:57:52+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=9e639188a1a8029926bda6e5d7edbf66ef3ac333'/>
<id>9e639188a1a8029926bda6e5d7edbf66ef3ac333</id>
<content type='text'>
* docs: intent doc for brainstorming rebuild

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK

* docs: spike exemption to the brainstorming gate

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK

* brainstorming: rebuild around drawing out intent

Replaces the spike/bounded/architectural router with an intent-first
conversation: open describing questions, recon offers, playback in
200-300 word chunks, then sizing (quick task / small change / project
with a written design). The spec reviewer prompt becomes a builder
check that asks what a builder would still need to know.

Adds tests/brainstorming/first-turn.sh, a first-turn micro-test with
no-skill and skill arms.

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK

* tests: multi-turn brainstorming driver with simulated humans

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK

* tests: harder small-change scenario; clearer launch failure

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK

* brainstorming: tighter opening, wait for builder check, reason from the why

Round 1 multi-turn runs: the builder check went to a background subagent
and stalled the conversation; the opening restated the request; one run
proposed CLI flags after hearing the tool runs from cron.

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK

* brainstorming: builder check gates the handoff, not the reply; README

Claude Code subagents run in the background, so the subject can't block on
the builder check. The skill now says what matters (don't hand over the
document until the check is back), and converse.sh lets the simulated
human wait for the subject's follow-up turn instead of nudging it.
Also fixes converse.sh dying before its summary when the work dir has no
commits.

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK

* brainstorming: split multi-project requests and take them one at a time

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK

* brainstorming: show it when the playback describes something visual

Across 13 multi-turn runs neither skill ever offered the visual companion,
even for a kids' tablet screen. Tying the offer to an observable moment
(talk turns to how something looks, or a playback chunk describes it) got
offers in 2/3 runs, each as its own message, none upfront. The simulated
human now declines browser offers so test runs don't open tabs.

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK

* tests: opt-out, spike, and multi-project brainstorming scenarios

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK

* brainstorming: resolve review findings from adversarial pass

- Opt-out ends the skill and the gate with it (the gate had no rule for it).
- Each message ends with one question, no example answers hanging off it;
  multi-question messages and parenthetical menus showed up in most runs.
- Playback marks the agent's guesses as guesses; one run played the
  agent's own example back as the human's.
- Restore the old gate's list of what counts as building (#2258).
- Companion offer stays its own message; mockups only after acceptance.
- converse.sh: survive a failed human turn, report why a run ended, and
  keep raw task notifications out of the simulated human's view.

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK

* brainstorming: play back as you go, alternating with questions

With playback saved for the end, project brainstorms ran 8-15 questions
before the human saw any summary. Interleaved, the first playback lands
around turn 3-6 (6 runs: habit-tracker, pottery, offsite x2), so
corrections arrive before more questions build on a wrong guess. Total
length is about the same.

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK

* tests: blind-pair launcher for comparing brainstorming versions

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK

* brainstorming: builder check yields one ranked round of questions

In a blind comparison (6 testers, old vs new skill), every new-skill tester
flagged the builder check: two rounds and 3-9 questions after they'd said
'write it up'. Now the agent warns once that a reviewer reads first,
settles minor gaps itself and marks them as its calls, and brings only the
questions that change what gets built, in one message, most important
first. 4/4 runs (habit-tracker, pottery x2) showed a single round.

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK

* docs: brainstorming rebuild eval results

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK

* Move the eval harness and results to their own PR

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK

* brainstorming: one line on writing style

Blind testers flagged a researched answer as a wall of text for a
non-technical person. Micro-tested 12 style lines on research reports and
mid-conversation answers (3 prompts x 5 reps each). Every variant already
led with the point; naming a journalist (wire reporter, Mossberg, a
Journalism BA) added source attributions. Plain wording shortened research
reports by about 12% against no line.

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK

* brainstorming: offer the visual companion whenever seeing would help

Lists the moments that call for it (things they'll look at, layouts,
flows, options that look different, diagrams/timelines/maps), checks each
playback chunk before sending it, and drops the 'token-intensive' line
that confused non-technical blind testers. Offers: habit tracker 3/3 (was
~50%), pottery booking 3/3 (was 0/3), at turns 3-7, never upfront; 0/4 on
scenarios with nothing visual (sync-tool flag, talk outline).

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK

* brainstorming: plain style line

Tested five style lines across Opus, Sonnet, gpt-6-luna and gpt-6-astra
(3 prompts x 5 reps each); none moved length or attribution beyond noise
on any model. Keep the plainest statement of intent.

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK

* brainstorming: report the most important findings, offer the rest

Research reports to a non-technical person ran 320-400 words on Claude.
With this line, replies that offer the rest rose from 1/5 to 4/5 (Opus)
and 3/5 (Sonnet); Opus reports ~7% shorter; gpt-6-luna/astra, already
~170-190 words, unchanged.

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
* docs: intent doc for brainstorming rebuild

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK

* docs: spike exemption to the brainstorming gate

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK

* brainstorming: rebuild around drawing out intent

Replaces the spike/bounded/architectural router with an intent-first
conversation: open describing questions, recon offers, playback in
200-300 word chunks, then sizing (quick task / small change / project
with a written design). The spec reviewer prompt becomes a builder
check that asks what a builder would still need to know.

Adds tests/brainstorming/first-turn.sh, a first-turn micro-test with
no-skill and skill arms.

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK

* tests: multi-turn brainstorming driver with simulated humans

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK

* tests: harder small-change scenario; clearer launch failure

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK

* brainstorming: tighter opening, wait for builder check, reason from the why

Round 1 multi-turn runs: the builder check went to a background subagent
and stalled the conversation; the opening restated the request; one run
proposed CLI flags after hearing the tool runs from cron.

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK

* brainstorming: builder check gates the handoff, not the reply; README

Claude Code subagents run in the background, so the subject can't block on
the builder check. The skill now says what matters (don't hand over the
document until the check is back), and converse.sh lets the simulated
human wait for the subject's follow-up turn instead of nudging it.
Also fixes converse.sh dying before its summary when the work dir has no
commits.

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK

* brainstorming: split multi-project requests and take them one at a time

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK

* brainstorming: show it when the playback describes something visual

Across 13 multi-turn runs neither skill ever offered the visual companion,
even for a kids' tablet screen. Tying the offer to an observable moment
(talk turns to how something looks, or a playback chunk describes it) got
offers in 2/3 runs, each as its own message, none upfront. The simulated
human now declines browser offers so test runs don't open tabs.

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK

* tests: opt-out, spike, and multi-project brainstorming scenarios

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK

* brainstorming: resolve review findings from adversarial pass

- Opt-out ends the skill and the gate with it (the gate had no rule for it).
- Each message ends with one question, no example answers hanging off it;
  multi-question messages and parenthetical menus showed up in most runs.
- Playback marks the agent's guesses as guesses; one run played the
  agent's own example back as the human's.
- Restore the old gate's list of what counts as building (#2258).
- Companion offer stays its own message; mockups only after acceptance.
- converse.sh: survive a failed human turn, report why a run ended, and
  keep raw task notifications out of the simulated human's view.

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK

* brainstorming: play back as you go, alternating with questions

With playback saved for the end, project brainstorms ran 8-15 questions
before the human saw any summary. Interleaved, the first playback lands
around turn 3-6 (6 runs: habit-tracker, pottery, offsite x2), so
corrections arrive before more questions build on a wrong guess. Total
length is about the same.

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK

* tests: blind-pair launcher for comparing brainstorming versions

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK

* brainstorming: builder check yields one ranked round of questions

In a blind comparison (6 testers, old vs new skill), every new-skill tester
flagged the builder check: two rounds and 3-9 questions after they'd said
'write it up'. Now the agent warns once that a reviewer reads first,
settles minor gaps itself and marks them as its calls, and brings only the
questions that change what gets built, in one message, most important
first. 4/4 runs (habit-tracker, pottery x2) showed a single round.

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK

* docs: brainstorming rebuild eval results

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK

* Move the eval harness and results to their own PR

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK

* brainstorming: one line on writing style

Blind testers flagged a researched answer as a wall of text for a
non-technical person. Micro-tested 12 style lines on research reports and
mid-conversation answers (3 prompts x 5 reps each). Every variant already
led with the point; naming a journalist (wire reporter, Mossberg, a
Journalism BA) added source attributions. Plain wording shortened research
reports by about 12% against no line.

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK

* brainstorming: offer the visual companion whenever seeing would help

Lists the moments that call for it (things they'll look at, layouts,
flows, options that look different, diagrams/timelines/maps), checks each
playback chunk before sending it, and drops the 'token-intensive' line
that confused non-technical blind testers. Offers: habit tracker 3/3 (was
~50%), pottery booking 3/3 (was 0/3), at turns 3-7, never upfront; 0/4 on
scenarios with nothing visual (sync-tool flag, talk outline).

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK

* brainstorming: plain style line

Tested five style lines across Opus, Sonnet, gpt-6-luna and gpt-6-astra
(3 prompts x 5 reps each); none moved length or attribution beyond noise
on any model. Keep the plainest statement of intent.

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK

* brainstorming: report the most important findings, offer the rest

Research reports to a non-technical person ran 320-400 words on Claude.
With this line, replies that offer the rest rose from 1/5 to 4/5 (Opus)
and 3/5 (Sonnet); Opus reports ~7% shorter; gpt-6-luna/astra, already
~170-190 words, unchanged.

Claude-Session: https://claude.ai/code/session_01M6AdHKvzoBUPTxPnYDwssK</pre>
</div>
</content>
</entry>
<entry>
<title>fix(hooks): run-hook.cmd finds per-user Git, skips WSL launchers and the current directory, keeps exit codes (#2393)</title>
<updated>2026-09-26T20:14:36+00:00</updated>
<author>
<name>Jesse Vincent</name>
<email>jesse@primeradiant.com</email>
</author>
<published>2026-09-26T20:14:36+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=35ce9493c912e8981cb5b76ffa7ceba5aed74530'/>
<id>35ce9493c912e8981cb5b76ffa7ceba5aed74530</id>
<content type='text'>
Combines and supersedes #1864 and #2365. Fixes #1863.

Co-authored-by: citizen204 &lt;161211652+citizen204@users.noreply.github.com&gt;
Co-authored-by: KaiyiQuan &lt;156817180+KaiyiQuan@users.noreply.github.com&gt;</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Combines and supersedes #1864 and #2365. Fixes #1863.

Co-authored-by: citizen204 &lt;161211652+citizen204@users.noreply.github.com&gt;
Co-authored-by: KaiyiQuan &lt;156817180+KaiyiQuan@users.noreply.github.com&gt;</pre>
</div>
</content>
</entry>
<entry>
<title>chore: bump version to 6.4.2</title>
<updated>2026-09-25T17:00:11+00:00</updated>
<author>
<name>Jesse Vincent</name>
<email>jesse@fsck.com</email>
</author>
<published>2026-09-25T17:00:11+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=c68ec2840aebe836c9b8abdd4986669320891d30'/>
<id>c68ec2840aebe836c9b8abdd4986669320891d30</id>
<content type='text'>
Points the OpenCode V2 pin examples at v6.4.2.

Claude-Session: https://claude.ai/code/session_012kGFECgxu6pk4fK2L3DjXd
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Points the OpenCode V2 pin examples at v6.4.2.

Claude-Session: https://claude.ai/code/session_012kGFECgxu6pk4fK2L3DjXd
</pre>
</div>
</content>
</entry>
<entry>
<title>chore: bump version to 6.4.1</title>
<updated>2026-09-18T21:55:55+00:00</updated>
<author>
<name>Jesse Vincent</name>
<email>jesse@fsck.com</email>
</author>
<published>2026-09-18T21:55:55+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=d6ce152d055ad642d8a66b8ba2a8a6de92180cb6'/>
<id>d6ce152d055ad642d8a66b8ba2a8a6de92180cb6</id>
<content type='text'>
v6.4.0 was never shipped; 6.4.1 is the first release with these changes.
Points the OpenCode V2 pinning docs at v6.4.1, since no v6.4.0 tag will
exist. Excludes the gitignored evals/ clone from the version audit, which
was grepping all 11G of it and never finishing.

Claude-Session: https://claude.ai/code/session_01BJAzd3A26a2XKo1JUJWySu
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
v6.4.0 was never shipped; 6.4.1 is the first release with these changes.
Points the OpenCode V2 pinning docs at v6.4.1, since no v6.4.0 tag will
exist. Excludes the gitignored evals/ clone from the version audit, which
was grepping all 11G of it and never finishing.

Claude-Session: https://claude.ai/code/session_01BJAzd3A26a2XKo1JUJWySu
</pre>
</div>
</content>
</entry>
<entry>
<title>Revert movie skill import (#2214) (#2335)</title>
<updated>2026-09-18T21:27:57+00:00</updated>
<author>
<name>Drew Ritter</name>
<email>drew@ritter.dev</email>
</author>
<published>2026-09-18T21:27:57+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=b5d94eb0ae56250a73f7af6582b23946ff84230f'/>
<id>b5d94eb0ae56250a73f7af6582b23946ff84230f</id>
<content type='text'>
Remove the proving-it-works-with-a-movie import at Drew Ritter’s request because its code quality does not meet the release bar.

Reverts merge dd53fe0b57223bbbbb8ceae0bda2ba8a26d1c29a and the dependent movie test adjustment in 3979a17bda8691d72bfc5963e5437174c399db67. Remove the later Muse registration and update the unreleased notes so neither advertises the removed skill. Version changes are left for a separate release step.</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Remove the proving-it-works-with-a-movie import at Drew Ritter’s request because its code quality does not meet the release bar.

Reverts merge dd53fe0b57223bbbbb8ceae0bda2ba8a26d1c29a and the dependent movie test adjustment in 3979a17bda8691d72bfc5963e5437174c399db67. Remove the later Muse registration and update the unreleased notes so neither advertises the removed skill. Version changes are left for a separate release step.</pre>
</div>
</content>
</entry>
<entry>
<title>chore: bump version to 6.4.0 (#2330)</title>
<updated>2026-09-18T18:37:41+00:00</updated>
<author>
<name>Jesse Vincent</name>
<email>jesse@fsck.com</email>
</author>
<published>2026-09-18T18:37:41+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=1c63ca9d81353d8aeced6edd0c5778ee6154d6ae'/>
<id>1c63ca9d81353d8aeced6edd0c5778ee6154d6ae</id>
<content type='text'>
Release engineering for 6.4. </content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Release engineering for 6.4. </pre>
</div>
</content>
</entry>
<entry>
<title>Merge pull request #2106 from GoldJohnKing/feat/opencode-v2-support</title>
<updated>2026-09-18T04:46:19+00:00</updated>
<author>
<name>Drew Ritter</name>
<email>drew@ritter.dev</email>
</author>
<published>2026-09-18T04:46:19+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=8f5a89afe4070ce84e428fe345ab4d5d39a29314'/>
<id>8f5a89afe4070ce84e428fe345ab4d5d39a29314</id>
<content type='text'>
feat(opencode): support OpenCode 2.0.4+ alongside V1</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
feat(opencode): support OpenCode 2.0.4+ alongside V1</pre>
</div>
</content>
</entry>
<entry>
<title>docs(opencode): fix pin example, local-path examples, and V2 log troubleshooting</title>
<updated>2026-09-18T03:52:40+00:00</updated>
<author>
<name>Drew Ritter</name>
<email>drew@primeradiant.com</email>
</author>
<published>2026-09-18T03:52:40+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=034fae28cda8a246d80491919cc79398cb5540b8'/>
<id>034fae28cda8a246d80491919cc79398cb5540b8</id>
<content type='text'>
Restore the version-pin example for both config keys and state the V2
constraint (the pinned ref must include OpenCode V2 support). Replace the
`~/...` local-package examples with absolute paths: OpenCode does not expand
`~`, and a tilde entry is installed as a package spec rather than loaded as a
directory. Point V2 troubleshooting at `opencode run --standalone
--print-logs`, since plugin logs are server-role and hidden without
`--standalone`. Describe where the bootstrap lands when native compaction
retains user messages under the default keep budget.

Co-Authored-By: Claude Fable 5.1 &lt;noreply@anthropic.com&gt;
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Restore the version-pin example for both config keys and state the V2
constraint (the pinned ref must include OpenCode V2 support). Replace the
`~/...` local-package examples with absolute paths: OpenCode does not expand
`~`, and a tilde entry is installed as a package spec rather than loaded as a
directory. Point V2 troubleshooting at `opencode run --standalone
--print-logs`, since plugin logs are server-role and hidden without
`--standalone`. Describe where the bootstrap lands when native compaction
retains user messages under the default keep budget.

Co-Authored-By: Claude Fable 5.1 &lt;noreply@anthropic.com&gt;
</pre>
</div>
</content>
</entry>
<entry>
<title>fix(scripts): exclude root index.js from the Codex plugin sync</title>
<updated>2026-09-18T03:51:22+00:00</updated>
<author>
<name>Drew Ritter</name>
<email>drew@primeradiant.com</email>
</author>
<published>2026-09-18T03:51:22+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=3bb3bd7b393a4127a81f37c3f5b2d1f14c9abf63'/>
<id>3bb3bd7b393a4127a81f37c3f5b2d1f14c9abf63</id>
<content type='text'>
Co-Authored-By: Claude Fable 5.1 &lt;noreply@anthropic.com&gt;
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Co-Authored-By: Claude Fable 5.1 &lt;noreply@anthropic.com&gt;
</pre>
</div>
</content>
</entry>
</feed>
