rogee/superpowers
1
0
Fork 0
mirror of https://github.com/obra/superpowers.git synced 2026-04-23 09:59:05 +08:00
Code Issues Packages Projects Releases Wiki Activity

Fix skill descriptions: remove workflow summaries that override flowcharts

Browse Source 
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.
This commit is contained in:
Jesse Vincent
2025-12-11 20:41:15 -08:00
parent 2a19be0b78
commit 030a222af1
7 changed files with 7 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
skills/executing-plans/SKILL.md
View File

@@ -1,6 +1,6 @@
---
name: executing-plans
description: Use when partner provides a complete implementation plan to execute in controlled batches with review checkpoints - loads plan, reviews critically, executes tasks in batches, reports for review between batches
description: Use when you have a written implementation plan to execute in a separate session with review checkpoints
---
# Executing Plans