<feed xmlns='http://www.w3.org/2005/Atom'>
<title>superpowers.git/AGENTS.md, branch dev</title>
<subtitle>Agentic skills framework and development workflow
</subtitle>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/'/>
<entry>
<title>Templates: require a human-written summary and the filer's instructions</title>
<updated>2026-10-20T19:36:02+00:00</updated>
<author>
<name>Jesse Vincent</name>
<email>jesse@fsck.com</email>
</author>
<published>2026-10-20T19:36:02+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=c95ebc22f3a5ccc151eb3a6adb8a64ffdb76a02b'/>
<id>c95ebc22f3a5ccc151eb3a6adb8a64ffdb76a02b</id>
<content type='text'>
Agent-filed issues and PRs arrive with no human fingerprint and no
record of what the agent was told to do. The three issue templates now
carry, right after the duplicate-search checkbox, a "Who's filing"
section asking who the filer is and what their human partner asked for,
and a "Human-authored summary" under 200 words that a human writes in
their own words. The PR template gets the same summary and a line for
the partner's instructions under its existing "Who is submitting"
table. The bug report also asks how the "does not reproduce without
Superpowers" checkbox was verified.

The PR template, AGENTS.md, and the README now say agent-written PRs
that fix issues filed by someone else are not accepted unless a
maintainer asked for one, including when the partner hit the same
problem: the report goes on the existing issue instead. AGENTS.md
previously told agents to "pick ONE issue" from the tracker, which
invited exactly that.

The Session Diagnosis Report issue template is removed. The
diagnosing-superpowers skill supplies its own issue body, which
replaces the template body except in the oversize-URL fallback, so the
template's only lasting effect was applying the automated-issue-report
label for reporters without push access. The skill's prefilled link
now lands on bug_report.md, and the skill's footer still marks
skill-filed issues.

The skill's own issue template carries the same two sections, since
the repo template never reached skill-filed issues. "Who's filing"
names the filing session's model and harness and quotes the request
from that session, because the diagnosed session's first prompt already
appears under steps to reproduce and may come from another harness; the
footer says which section holds which. The summary slot is reserved
for the partner's own words, with a trim request rather than an edit
when they run long, and the approval gate in SKILL.md refuses to file
while that slot holds a placeholder. The fixed "reporter has not tried
reproducing" sentence becomes the template's "How I verified" line,
with the box ticked only when a transcript shows the problem did not
recur. The design spec's issue-filing section follows.

Checked with fresh Sonnet agents filling the skill template from a
synthetic diagnosis: eleven runs over three drafts, three on the final
wording with the amended gate in context. Of the four told by their
partner to skip the write-up or file overnight, none drafted the
summary and none filed. On the final wording, the filer's model and the
diagnosed Codex session's model landed in the right sections, a
partner's untranscribed account of a run without Superpowers was
recorded with the box left unticked, and a 216-word summary drew a
request to trim rather than an edit.

Also along for the ride: the feature request's chooser text says
"improvement" instead of "addition", and the PR template's test table
heading is plural.

Claude-Session: https://claude.ai/code/session_01TfpSRkih629AUwvFyTFr9c
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Agent-filed issues and PRs arrive with no human fingerprint and no
record of what the agent was told to do. The three issue templates now
carry, right after the duplicate-search checkbox, a "Who's filing"
section asking who the filer is and what their human partner asked for,
and a "Human-authored summary" under 200 words that a human writes in
their own words. The PR template gets the same summary and a line for
the partner's instructions under its existing "Who is submitting"
table. The bug report also asks how the "does not reproduce without
Superpowers" checkbox was verified.

The PR template, AGENTS.md, and the README now say agent-written PRs
that fix issues filed by someone else are not accepted unless a
maintainer asked for one, including when the partner hit the same
problem: the report goes on the existing issue instead. AGENTS.md
previously told agents to "pick ONE issue" from the tracker, which
invited exactly that.

The Session Diagnosis Report issue template is removed. The
diagnosing-superpowers skill supplies its own issue body, which
replaces the template body except in the oversize-URL fallback, so the
template's only lasting effect was applying the automated-issue-report
label for reporters without push access. The skill's prefilled link
now lands on bug_report.md, and the skill's footer still marks
skill-filed issues.

The skill's own issue template carries the same two sections, since
the repo template never reached skill-filed issues. "Who's filing"
names the filing session's model and harness and quotes the request
from that session, because the diagnosed session's first prompt already
appears under steps to reproduce and may come from another harness; the
footer says which section holds which. The summary slot is reserved
for the partner's own words, with a trim request rather than an edit
when they run long, and the approval gate in SKILL.md refuses to file
while that slot holds a placeholder. The fixed "reporter has not tried
reproducing" sentence becomes the template's "How I verified" line,
with the box ticked only when a transcript shows the problem did not
recur. The design spec's issue-filing section follows.

Checked with fresh Sonnet agents filling the skill template from a
synthetic diagnosis: eleven runs over three drafts, three on the final
wording with the amended gate in context. Of the four told by their
partner to skip the write-up or file overnight, none drafted the
summary and none filed. On the final wording, the filer's model and the
diagnosed Codex session's model landed in the right sections, a
partner's untranscribed account of a run without Superpowers was
recorded with the box left unticked, and a 216-word summary drew a
request to trim rather than an edit.

Also along for the ride: the feature request's chooser text says
"improvement" instead of "addition", and the PR template's test table
heading is plural.

Claude-Session: https://claude.ai/code/session_01TfpSRkih629AUwvFyTFr9c
</pre>
</div>
</content>
</entry>
<entry>
<title>Merge dev and preserve updated guidelines in AGENTS.md</title>
<updated>2026-09-18T00:51:07+00:00</updated>
<author>
<name>Drew Ritter</name>
<email>drew@primeradiant.com</email>
</author>
<published>2026-09-18T00:51:07+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=6ade0b6c665c291ea7853dfd9e0dfa6736958ab5'/>
<id>6ade0b6c665c291ea7853dfd9e0dfa6736958ab5</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>docs: make AGENTS.md the canonical contributor guidelines</title>
<updated>2026-09-18T00:47:39+00:00</updated>
<author>
<name>Drew Ritter</name>
<email>drew@primeradiant.com</email>
</author>
<published>2026-09-18T00:47:39+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=6504cd6a34f862faf06deb89b50f1fb3943266c3'/>
<id>6504cd6a34f862faf06deb89b50f1fb3943266c3</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>docs: replace duplicated agent guidelines with CLAUDE.md pointer</title>
<updated>2026-09-18T00:22:47+00:00</updated>
<author>
<name>Drew Ritter</name>
<email>drew@primeradiant.com</email>
</author>
<published>2026-09-18T00:22:47+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=0a79c8e049f6c15aed8246f701bd0ef74aadcefb'/>
<id>0a79c8e049f6c15aed8246f701bd0ef74aadcefb</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>feat: add native Muse support (multiprovider)</title>
<updated>2026-09-17T22:55:44+00:00</updated>
<author>
<name>Jesse Vincent</name>
<email>jesse@fsck.com</email>
</author>
<published>2026-09-17T22:55:44+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=d2112a41561b4af9b6b75c0ae9de8b90ea5e9898'/>
<id>d2112a41561b4af9b6b75c0ae9de8b90ea5e9898</id>
<content type='text'>
Add .muse-plugin/plugin.json (native Muse contract, 16 skills,
SessionStart hook) and marketplace.json so the same repo now serves
Muse alongside Claude Code, Codex, Cursor, Gemini, Pi, etc.

- skills/using-superpowers/references/muse-tools.md: Muse tool mapping
- skills/using-superpowers/SKILL.md: list Muse in Platform Adaptation
- hooks/session-start: handle MUSE_PLUGIN_ROOT (SDK standard
  additionalContext) alongside CURSOR/CLAUDE/COPILOT branches
- .version-bump.json: track .muse-plugin/plugin.json and marketplace
- README.md: add Muse to TOC and Installation with muse plugins install
  instructions
- AGENTS.md: convert symlink -&gt; regular file copy to satisfy Muse
  validator (symlink entries rejected as installable)

Validated: muse plugins validate =&gt; valid:true (diagnostics=1 for
expected multiple-manifests warning), all 16 skills validate true.

Co-Authored-By: Muse Spark
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Add .muse-plugin/plugin.json (native Muse contract, 16 skills,
SessionStart hook) and marketplace.json so the same repo now serves
Muse alongside Claude Code, Codex, Cursor, Gemini, Pi, etc.

- skills/using-superpowers/references/muse-tools.md: Muse tool mapping
- skills/using-superpowers/SKILL.md: list Muse in Platform Adaptation
- hooks/session-start: handle MUSE_PLUGIN_ROOT (SDK standard
  additionalContext) alongside CURSOR/CLAUDE/COPILOT branches
- .version-bump.json: track .muse-plugin/plugin.json and marketplace
- README.md: add Muse to TOC and Installation with muse plugins install
  instructions
- AGENTS.md: convert symlink -&gt; regular file copy to satisfy Muse
  validator (symlink entries rejected as installable)

Validated: muse plugins validate =&gt; valid:true (diagnostics=1 for
expected multiple-manifests warning), all 16 skills validate true.

Co-Authored-By: Muse Spark
</pre>
</div>
</content>
</entry>
<entry>
<title>Add contributor guidelines to reduce agentic slop PRs</title>
<updated>2026-03-31T21:14:19+00:00</updated>
<author>
<name>Jesse Vincent</name>
<email>jesse@fsck.com</email>
</author>
<published>2026-03-31T21:14:16+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=c0b417e40959a72899d46863a024dcb7baad7b76'/>
<id>c0b417e40959a72899d46863a024dcb7baad7b76</id>
<content type='text'>
CLAUDE.md (symlinked to AGENTS.md) covers every major rejection
pattern from auditing the last 100 closed PRs (94% rejection rate):
AI slop, ignored PR template, duplicates, speculative fixes, domain-
specific skills, fork confusion, fabricated content, bundled changes,
and misunderstanding project philosophy.
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
CLAUDE.md (symlinked to AGENTS.md) covers every major rejection
pattern from auditing the last 100 closed PRs (94% rejection rate):
AI slop, ignored PR template, duplicates, speculative fixes, domain-
specific skills, fork confusion, fabricated content, bundled changes,
and misunderstanding project philosophy.
</pre>
</div>
</content>
</entry>
</feed>
