<feed xmlns='http://www.w3.org/2005/Atom'>
<title>superpowers.git/docs/README.opencode.md, branch fix/2391-opencode-compaction-bootstrap</title>
<subtitle>Agentic skills framework and development workflow
</subtitle>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/'/>
<entry>
<title>Merge dev into the OpenCode compaction bootstrap fix</title>
<updated>2026-11-02T21:31:53+00:00</updated>
<author>
<name>Drew Ritter</name>
<email>drew@primeradiant.com</email>
</author>
<published>2026-11-02T21:31:53+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=38fd8323e43f4b13e8bdc9d62b85ca1ed524a3f8'/>
<id>38fd8323e43f4b13e8bdc9d62b85ca1ed524a3f8</id>
<content type='text'>
Drew requested resolution of the merge conflict in obra/superpowers PR
#2601. Merge current dev into the existing PR branch without rewriting its
history.

Resolve the V2 bootstrap hunk by keeping #2601's shared handler registered
on context, compaction, and generate, and incorporating #2600's exact
BOOTSTRAP_MARKER prefix guard. This preserves injection for prompts that
merely mention EXTREMELY_IMPORTANT while preventing duplicate bootstrap
parts. All other dev changes merge without manual edits.

Validation: bash tests/opencode/run-tests.sh passed all five suites,
including hook registration, tag-mention regression coverage, child-session
suppression, caching, and skill registration. git diff --cached --check
passed and the index contains no unresolved paths. Live OpenCode
integration sessions were not rerun for this conflict-only repair.

Tracking: PRI-3674
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Drew requested resolution of the merge conflict in obra/superpowers PR
#2601. Merge current dev into the existing PR branch without rewriting its
history.

Resolve the V2 bootstrap hunk by keeping #2601's shared handler registered
on context, compaction, and generate, and incorporating #2600's exact
BOOTSTRAP_MARKER prefix guard. This preserves injection for prompts that
merely mention EXTREMELY_IMPORTANT while preventing duplicate bootstrap
parts. All other dev changes merge without manual edits.

Validation: bash tests/opencode/run-tests.sh passed all five suites,
including hook registration, tag-mention regression coverage, child-session
suppression, caching, and skill registration. git diff --cached --check
passed and the index contains no unresolved paths. Live OpenCode
integration sessions were not rerun for this conflict-only repair.

Tracking: PRI-3674
</pre>
</div>
</content>
</entry>
<entry>
<title>fix(opencode): inject the V2 bootstrap on compaction and generate requests</title>
<updated>2026-10-22T22:55:41+00:00</updated>
<author>
<name>Jesse Vincent</name>
<email>jesse@fsck.com</email>
</author>
<published>2026-10-22T22:21:48+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=80b085cfb36c0dfe5f6740a3a4764d16429a8228'/>
<id>80b085cfb36c0dfe5f6740a3a4764d16429a8228</id>
<content type='text'>
The V2 plugin registered its bootstrap injector only on
ctx.session.hook('context'). OpenCode 2 prepares each model request kind
through its own hook: normal agent turns through `context`, the
compaction (summary) request through `compaction`, and session-scoped
one-shot generation through `generate`
(packages/core/src/session/model-request.ts). Every built-in V2 plugin
registers its handler on all three, and the upstream V1 migration guide
says to do the same when a transform must apply to every request kind.

So the compaction request's first user message lacked the bootstrap
that every prior turn carried, and the prompt diverged right after
system + tools. On a provider with prefix caching that is a cold
re-prefill of the whole session on its largest request (#2391).

Reproduced on real OpenCode 2.1.2 and 2.1.3 with a scripted stub model
that pushes the session over the compaction ceiling: before, the
compaction request shares 26.5k of 30.8k serialized chars with the
previous agent request and differs at the first user message; after,
the previous request is a full prefix of the compaction request.

The handler body is unchanged (child-session skip, idempotence guard,
checkpoint-only append), lifted into a named function and registered on
all three hooks, each in its own try/catch. Based on PR #2409.

Fixes #2391

Co-authored-by: Aashish &lt;145881415+aashish254@users.noreply.github.com&gt;
Claude-Session: https://claude.ai/code/session_01SHANcr4A71nzuU9et4Fnba
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
The V2 plugin registered its bootstrap injector only on
ctx.session.hook('context'). OpenCode 2 prepares each model request kind
through its own hook: normal agent turns through `context`, the
compaction (summary) request through `compaction`, and session-scoped
one-shot generation through `generate`
(packages/core/src/session/model-request.ts). Every built-in V2 plugin
registers its handler on all three, and the upstream V1 migration guide
says to do the same when a transform must apply to every request kind.

So the compaction request's first user message lacked the bootstrap
that every prior turn carried, and the prompt diverged right after
system + tools. On a provider with prefix caching that is a cold
re-prefill of the whole session on its largest request (#2391).

Reproduced on real OpenCode 2.1.2 and 2.1.3 with a scripted stub model
that pushes the session over the compaction ceiling: before, the
compaction request shares 26.5k of 30.8k serialized chars with the
previous agent request and differs at the first user message; after,
the previous request is a full prefix of the compaction request.

The handler body is unchanged (child-session skip, idempotence guard,
checkpoint-only append), lifted into a named function and registered on
all three hooks, each in its own try/catch. Based on PR #2409.

Fixes #2391

Co-authored-by: Aashish &lt;145881415+aashish254@users.noreply.github.com&gt;
Claude-Session: https://claude.ai/code/session_01SHANcr4A71nzuU9et4Fnba
</pre>
</div>
</content>
</entry>
<entry>
<title>fix(opencode): tell the model skill ids are bare names (#2583)</title>
<updated>2026-10-22T21:04:25+00:00</updated>
<author>
<name>Jesse Vincent</name>
<email>jesse@fsck.com</email>
</author>
<published>2026-10-22T21:04:25+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=8f4b3dbd2f5ef8163e4daed5ca43a4cf08eb5d8c'/>
<id>8f4b3dbd2f5ef8163e4daed5ca43a4cf08eb5d8c</id>
<content type='text'>
Skills name each other with the Claude Code plugin namespace
(`superpowers:brainstorming`), and the using-superpowers bootstrap that
the OpenCode plugin injects says "Let's build X -&gt; superpowers:brainstorming
first". OpenCode registers superpowers skills under bare ids
(`brainstorming`) on both flavors and its `skill` tool does an exact
lookup, so a model that copies the namespaced form gets
"Unable to load skill superpowers:brainstorming" (V2) or
`Skill "superpowers:brainstorming" not found` (V1) and carries on
without the skill. The OpenCode tool mapping said only "Invoke a skill
-&gt; OpenCode's native skill tool" and never stated the id convention.

Reproduced on real hosts (OpenCode 2.1.2 and opencode-ai 1.19.4) with a
scripted stub provider: the namespaced call fails, the bare id loads.

Add the convention to the "Invoke a skill" line of both mappings, with
each flavor's real skill parameter (V1 `name`, V2 `id`), and mirror it
in docs/README.opencode.md. Skill prose keeps the prefix, which is
correct on Claude Code; the translation belongs in the harness mapping,
the same way the Hermes reference shows bare `skill_view("brainstorming")`.

Claude-Session: https://claude.ai/code/session_01SHANcr4A71nzuU9et4Fnba
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Skills name each other with the Claude Code plugin namespace
(`superpowers:brainstorming`), and the using-superpowers bootstrap that
the OpenCode plugin injects says "Let's build X -&gt; superpowers:brainstorming
first". OpenCode registers superpowers skills under bare ids
(`brainstorming`) on both flavors and its `skill` tool does an exact
lookup, so a model that copies the namespaced form gets
"Unable to load skill superpowers:brainstorming" (V2) or
`Skill "superpowers:brainstorming" not found` (V1) and carries on
without the skill. The OpenCode tool mapping said only "Invoke a skill
-&gt; OpenCode's native skill tool" and never stated the id convention.

Reproduced on real hosts (OpenCode 2.1.2 and opencode-ai 1.19.4) with a
scripted stub provider: the namespaced call fails, the bare id loads.

Add the convention to the "Invoke a skill" line of both mappings, with
each flavor's real skill parameter (V1 `name`, V2 `id`), and mirror it
in docs/README.opencode.md. Skill prose keeps the prefix, which is
correct on Claude Code; the translation belongs in the harness mapping,
the same way the Hermes reference shows bare `skill_view("brainstorming")`.

Claude-Session: https://claude.ai/code/session_01SHANcr4A71nzuU9et4Fnba
</pre>
</div>
</content>
</entry>
<entry>
<title>chore: bump version to 7.0.1</title>
<updated>2026-10-21T20:03:27+00:00</updated>
<author>
<name>Jesse Vincent</name>
<email>jesse@fsck.com</email>
</author>
<published>2026-10-21T20:03:27+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=c4c226fe39558c2056b08a134cbf5d103bee215d'/>
<id>c4c226fe39558c2056b08a134cbf5d103bee215d</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>Release prep for v7.0.0 (#2488)</title>
<updated>2026-10-09T23:55:01+00:00</updated>
<author>
<name>Jesse Vincent</name>
<email>jesse@primeradiant.com</email>
</author>
<published>2026-10-09T23:55:01+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=74bcce130ab12d5db63639179632f4d7d4e2c5f3'/>
<id>74bcce130ab12d5db63639179632f4d7d4e2c5f3</id>
<content type='text'>
- RELEASE-NOTES.md: v7.0.0 section covering everything on dev since v6.4.2,
  led by the brainstorming rebuild (#2463, #2482, #2483)
- Bump all 11 declared manifests to 7.0.0; OpenCode pin examples point at #v7.0.0
- bump-version.sh --audit matches whole version strings only, so 7.0.0 no
  longer matches inside 127.0.0.1
- test-render-graphs.sh resolves the real node binary so its empty-PATH case
  works under version-manager shims (mise, asdf)</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
- RELEASE-NOTES.md: v7.0.0 section covering everything on dev since v6.4.2,
  led by the brainstorming rebuild (#2463, #2482, #2483)
- Bump all 11 declared manifests to 7.0.0; OpenCode pin examples point at #v7.0.0
- bump-version.sh --audit matches whole version strings only, so 7.0.0 no
  longer matches inside 127.0.0.1
- test-render-graphs.sh resolves the real node binary so its empty-PATH case
  works under version-manager shims (mise, asdf)</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>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>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>docs: clarify OpenCode V1 and V2 skill behavior</title>
<updated>2026-09-18T01:48:11+00:00</updated>
<author>
<name>Drew Ritter</name>
<email>drew@primeradiant.com</email>
</author>
<published>2026-09-18T01:48:11+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=1e0ea8fcf8b62c6a44b5b97eb183dbd98e5f2f1b'/>
<id>1e0ea8fcf8b62c6a44b5b97eb183dbd98e5f2f1b</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
</feed>
