Adaptation Guide

Superpowers Skills Adaptation Guide

Overview

Adapting 21 workflow skills from obra/superpowers for Factory.ai Droid CLI.

Key Differences: Superpowers vs Factory.ai

Adaptation Rules

1. Keep Core Methodology

• ✅ KEEP: The process/workflow (these are excellent!)
• ✅ KEEP: Red flags, rationalizations, checklists
• ✅ KEEP: Examples (Good/Bad patterns)
• ✅ KEEP: The "Iron Laws" and core principles

2. Update References

• ❌ REMOVE: "superpowers:" prefix from skill references
• ✅ UPDATE: "REQUIRED SUB-SKILL" → "RECOMMENDED SKILL" or "SEE ALSO"
• ✅ UPDATE: "your human partner" → "the user"
• ✅ UPDATE: Slash commands to Factory.ai equivalents

3. Simplify Frontmatter

---
name: skill-name
description: When to use this skill
category: workflow  # Add this for workflow skills
---

4. Update File Paths

• Plans: docs/plans/ → .droidz/specs/ (or keep docs/plans)
• Skills: Reference other skills without prefix
• Tests: Keep language-agnostic examples

5. Update Subagent References

• superpowers:subagent-driven-development → Use Task tool with droidz-codegen
• superpowers:executing-plans → Use Task tool with droidz-orchestrator
• Document Factory.ai Task tool patterns

Skills to Adapt (21 Total)

Testing Skills (5)

1. test-driven-development - TDD process (RED-GREEN-REFACTOR) 2. systematic-debugging - 4-phase debugging framework 3. verification-before-completion - Pre-completion checklist 4. defense-in-depth - Multi-layer validation 5. testing-anti-patterns - What NOT to do

Collaboration Skills (5)

6. brainstorming - Design through questions 7. writing-plans - Detailed implementation plans 8. executing-plans - Following plans step-by-step 9. requesting-code-review - How to ask for review 10. receiving-code-review - How to respond to feedback

Development Skills (5)

11. root-cause-tracing - Backward tracing technique 12. subagent-driven-development - Task-by-task with fresh agents 13. finishing-a-development-branch - Completing work properly 14. using-git-worktrees - Parallel work branches 15. condition-based-waiting - Replace arbitrary timeouts

Advanced/Meta Skills (6)

16. dispatching-parallel-agents - Spawning multiple agents 17. writing-skills - Creating new skills 18. testing-skills-with-subagents - Validating skill quality 19. sharing-skills - Publishing skills 20. using-superpowers → using-droidz - How to use this system 21. commands - Custom command reference

Adaptation Workflow

For each skill: 1. Fetch original from obra/superpowers 2. Keep core methodology (process, principles, examples) 3. Update Factory.ai references (no "superpowers:" prefix) 4. Simplify frontmatter, update paths 5. Test that references work (skill → skill not superpowers:skill) 6. Save to .factory/skills/[name].md

Quality Standards

Each adapted skill must:

• ✅ Preserve the original methodology and quality
• ✅ Remove superpowers-specific references
• ✅ Update to Factory.ai Droid CLI patterns
• ✅ Keep all examples, checklists, red flags
• ✅ Maintain 800+ lines (these are already comprehensive!)
• ✅ Add category: workflow to distinguish from framework skills

Success Criteria

• ✅ All 21 skills adapted
• ✅ No broken references (superpowers: removed)
• ✅ Factory.ai Task tool patterns documented
• ✅ Skills work with Factory.ai auto-loading
• ✅ Total skill count: 42 (21 framework + 21 workflow)