refactor

Refactor

Relies on BDK foundation (STARTUP_INSTRUCTIONS.md) for project context and MCP tool preference.

Complex refactor needed. Code messy, needs clean class separation.

Workflow:

1. Architecture survey:

!python3 ${CLAUDE_PLUGIN_ROOT}/scripts/inject.py --chain ${CLAUDE_PLUGIN_ROOT}/fragments/tool-tiers/explore.chain.json

Using the exploration tools above: understand current community structure, identify tightly-coupled communities, detect cross-cutting concerns, and identify dead code with refactor_tool(mode="dead_code") if graph is available. 2. Launch explorer subagent with architecture findings as context (not blind) 3. Propose OO architecture with well-separated classes — reference community boundaries, address surprising connections 4. Identify applicable Gang of Four patterns (Strategy, Factory, Observer, Decorator) and explain fit 5. Create docs in .bdk/refactor/:

• Architecture overview
• Applicable GoF patterns with rationale
• Implementation plan

Problem description:

$ARGUMENTS