gh-withzombies-hyperpowers/skills/refactoring-safely/resources/example-session.md

Example: Complete Refactoring Session

Goal: Extract validation logic from UserService

Time: 60 minutes

Minutes 0-5: Verify Tests Pass

Dispatch hyperpowers:test-runner: "Run: cargo test"
Result: ✓ 234 tests pass

Minutes 5-10: Create bd Task

bd create "Refactor: Extract user validation" --type task
bd edit bd-456 --design "Extract validation to UserValidator class..."
bd update bd-456 --status in_progress

Minutes 10-15: Step 1 - Extract email validation function

// Extract validate_email()

Dispatch hyperpowers:test-runner: "Run: cargo test"
Result: ✓ 234 tests pass
git commit -m "refactor(bd-456): extract email validation"

Minutes 15-20: Step 2 - Extract name validation function

// Extract validate_name()

Dispatch hyperpowers:test-runner: "Run: cargo test"
Result: ✓ 234 tests pass
git commit -m "refactor(bd-456): extract name validation"

Minutes 20-25: Step 3 - Create UserValidator struct

struct UserValidator { /* empty */ }
impl UserValidator { /* empty */ }

Dispatch hyperpowers:test-runner: "Run: cargo test"
Result: ✓ 234 tests pass
git commit -m "refactor(bd-456): create UserValidator struct"

Minutes 25-35: Steps 4-6 - Move validations to UserValidator

Each step: move one method, test, commit

Minutes 35-45: Step 7 - Update UserService to use validator

// Use UserValidator instead of inline validation

Dispatch hyperpowers:test-runner: "Run: cargo test"
Result: ✓ 234 tests pass
git commit -m "refactor(bd-456): use UserValidator in UserService"

Minutes 45-55: Step 8 - Remove duplication from other services

Each service: one change, test, commit

Minutes 55-60: Final verification and close

Dispatch hyperpowers:test-runner: "Run: cargo test"
Result: ✓ 234 tests pass

Dispatch hyperpowers:test-runner: "Run: cargo clippy"
Result: ✓ No warnings

bd close bd-456

Result: Refactoring complete, 8 safe commits, all tests green throughout.