mirror of
https://github.com/obra/superpowers.git
synced 2026-04-16 10:29:57 +00:00
Testing revealed that descriptions summarizing workflow cause Claude to follow the description instead of reading the skill body. Changed all descriptions to "when to use" triggers only: - dispatching-parallel-agents: 2+ independent tasks without shared state - executing-plans: have a written plan to execute with review checkpoints - requesting-code-review: completing tasks, features, or before merging - systematic-debugging: encountering bugs before proposing fixes - test-driven-development: implementing features before writing code - writing-plans: have spec/requirements for multi-step task before coding - writing-skills: updated with "description trap" documentation The description trap: workflow summaries in descriptions create shortcuts Claude takes, skipping the skill body entirely.