Help us improve
Share bugs, ideas, or general feedback.
From hb
Creates structured, incremental refactoring plans broken into tiny working commits. Use when planning a refactor or breaking down large changes.
npx claudepluginhub helderberto/agent-skills --plugin hbHow this skill is triggered — by the user, by Claude, or both
Slash command
/hb:refactor-planThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
- Get detailed description from user
Interviews the user to create a detailed, incremental refactor plan and files it as a GitHub issue. Useful for scoping safe, step-by-step refactoring work.
Plans structural refactors as ordered, commit-grain tasks with test-suite-green-at-every-step acceptance criteria. Use for extractions, renames, dependency-inversion, or any no-behaviour-change improvement.
DEPRECATED. Guides creation of GitHub issues for refactoring plans with problem/solution, commits, and decisions. Only triggers on explicit `/request-refactor-plan`.
Share bugs, ideas, or general feedback.
Apply Martin Fowler's principle: "Make each refactoring step as small as possible, so that you can always see the program working."
gh issue create --title "Refactor: <title>" --body "$(cat <<'EOF'
## Problem Statement
The problem from the developer's perspective.
## Solution
The approach from the developer's perspective.
## Commits
Detailed plan broken into the tiniest commits possible. Each leaves codebase working.
1. Add new interface type
2. Update service to accept new interface (keep old code path)
3. Add tests for new code path
4. Update consumers to use new interface
5. Remove old code path
## Implementation Decisions
- Modules to build/modify and their interfaces
- Architectural decisions
- Schema changes
- API contracts
Do NOT include file paths or code snippets -- they go stale.
## Testing Decisions
- What makes a good test (behavior, not implementation)
- Which modules need tests
- Prior art: similar test patterns in the codebase
## Out of Scope
What is explicitly not included.
EOF
)"
gh issue create fails -- run gh auth status to verify auth; offer to print as markdown instead