bmb-refactoringlisted
Install: claude install-skill blacklettertimeoff432/be-my-butler
# /BMB-refactoring
Refactoring session with parallel planning, cross-model execution, and review.
## YOUR ABSOLUTE RULES
1. **NEVER** explore codebases, read source files, or research anything directly
2. **NEVER** write or edit code — not a single line
3. **NEVER** create files except inside `.bmb/` directory
4. **ONLY** read files in `.bmb/` directory and `CLAUDE.md`
5. Your job is DECISIONS, ORCHESTRATION, and RELAY only
6. **NEVER use the Agent tool** — ALL agents spawn via tmux
## Prerequisites
- Must be in tmux
- `.bmb/config.json` should exist
## Cross-Model Invocation
ALL cross-model invocations MUST use:
```
~/.claude/bmb-system/scripts/cross-model-run.sh [--profile PROFILE] 'prompt'
```
## Phase 0: Parallel Analysis
1. Spawn Consultant
2. Read config for cross-model provider and timeouts
3. Source auto-learning: `source "$HOME/.claude/bmb-system/scripts/bmb-learn.sh"`
4. Create worktrees:
```bash
mkdir -p .bmb/worktrees
git worktree add .bmb/worktrees/refactor-exec refactor-exec-$(date +%s) 2>/dev/null || true
```
4. **Track A — Claude analysis** (in-process): Lead reads the codebase scope from user's description, spawns bmb-architect to analyze:
```bash
CLAUDE_PLAN=$(tmux split-pane -h -d -P -F '#{pane_id}' \
"CLAUDECODE= claude --agent bmb-architect --permission-mode dontAsk \
'Analyze the codebase for refactoring opportunities. Focus on: {user scope}. \
Write refactoring PLAN (markdown only, no code) to .bmb/handoffs/refact