Skip to content

An agentic skills framework & software development methodology that works.

Release v3.2.2: Strengthen using-superpowers against agent rationalization

Jesse Vincent17bbc2b130f8
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
index 96e1eb305..e53405cfc 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": "3.2.1",
+ "version": "3.2.2",
"source": "./",
"author": {
"name": "Jesse Vincent",
diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
index a9939184d..43d3e9de6 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": "3.2.1",
+ "version": "3.2.2",
"author": {
"name": "Jesse Vincent",
"email": "[email protected]"
diff --git a/RELEASE-NOTES.md b/RELEASE-NOTES.md
index dfd7a04e3..e9cb98b17 100644
--- a/RELEASE-NOTES.md
+++ b/RELEASE-NOTES.md
@@ -1,5 +1,27 @@
# Superpowers Release Notes
+## v3.2.2 (2025-10-21)
+
+### Improvements
+
+**Strengthened using-superpowers skill against agent rationalization**
+- Added EXTREMELY-IMPORTANT block with absolute language about mandatory skill checking
+ - "If even 1% chance a skill applies, you MUST read it"
+ - "You do not have a choice. You cannot rationalize your way out."
+- Added MANDATORY FIRST RESPONSE PROTOCOL checklist
+ - 5-step process agents must complete before any response
+ - Explicit "responding without this = failure" consequence
+- Added Common Rationalizations section with 8 specific evasion patterns
+ - "This is just a simple question" → WRONG
+ - "I can check files quickly" → WRONG
+ - "Let me gather information first" → WRONG
+ - Plus 5 more common patterns observed in agent behavior
+
+These changes address observed agent behavior where they rationalize around skill usage despite clear instructions. The forceful language and pre-emptive counter-arguments aim to make non-compliance harder.
+
+### Files Changed
+- Updated: `skills/using-superpowers/SKILL.md` - Added three layers of enforcement to prevent skill-skipping rationalization
+
## v3.2.1 (2025-10-20)
### New Features