|
|
@@ -15,7 +15,7 @@ You write test cases (pressure scenarios with subagents), watch them fail (basel
|
|
|
|
|
|
**Core principle:** If you didn't watch an agent fail without the skill, you don't know if the skill teaches the right thing.
|
|
|
|
|
|
-**REQUIRED BACKGROUND:** You MUST understand test-driven-development before using this skill. That skill defines the fundamental RED-GREEN-REFACTOR cycle. This skill adapts TDD to documentation.
|
|
|
+**REQUIRED BACKGROUND:** You MUST understand superpowers:test-driven-development before using this skill. That skill defines the fundamental RED-GREEN-REFACTOR cycle. This skill adapts TDD to documentation.
|
|
|
|
|
|
**Official guidance:** For Anthropic's official skill authoring best practices, see anthropic-best-practices.md. This document provides additional patterns and guidelines that complement the TDD-focused approach in this skill.
|
|
|
|
|
|
@@ -253,8 +253,8 @@ wc -w skills/path/SKILL.md
|
|
|
**When writing documentation that references other skills:**
|
|
|
|
|
|
Use skill name only, with explicit requirement markers:
|
|
|
-- ✅ Good: `**REQUIRED SUB-SKILL:** Use test-driven-development`
|
|
|
-- ✅ Good: `**REQUIRED BACKGROUND:** You MUST understand systematic-debugging`
|
|
|
+- ✅ Good: `**REQUIRED SUB-SKILL:** Use superpowers:test-driven-development`
|
|
|
+- ✅ Good: `**REQUIRED BACKGROUND:** You MUST understand superpowers:systematic-debugging`
|
|
|
- ❌ Bad: `See skills/testing/test-driven-development` (unclear if required)
|
|
|
- ❌ Bad: `@skills/testing/test-driven-development/SKILL.md` (force-loads, burns context)
|
|
|
|
|
|
@@ -357,7 +357,7 @@ Edit skill without testing? Same violation.
|
|
|
- Don't "adapt" while running tests
|
|
|
- Delete means delete
|
|
|
|
|
|
-**REQUIRED BACKGROUND:** The test-driven-development skill explains why this matters. Same principles apply to documentation.
|
|
|
+**REQUIRED BACKGROUND:** The superpowers:test-driven-development skill explains why this matters. Same principles apply to documentation.
|
|
|
|
|
|
## Testing All Skill Types
|
|
|
|
|
|
@@ -520,7 +520,7 @@ Run same scenarios WITH skill. Agent should now comply.
|
|
|
|
|
|
Agent found new rationalization? Add explicit counter. Re-test until bulletproof.
|
|
|
|
|
|
-**REQUIRED SUB-SKILL:** Use testing-skills-with-subagents for the complete testing methodology:
|
|
|
+**REQUIRED SUB-SKILL:** Use superpowers:testing-skills-with-subagents for the complete testing methodology:
|
|
|
- How to write pressure scenarios
|
|
|
- Pressure types (time, sunk cost, authority, exhaustion)
|
|
|
- Plugging holes systematically
|