plan: OOP orchestrator, routing engine, design state refactor

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

docs/superpowers/plans/2026-04-11-oop-orchestrator-routing.md

@@ -0,0 +1,39 @@
+# OOP Orchestrator & Routing Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task.
+
+**Goal:** Extract routing into RoutingEngine class, add BaseOrchestrator ABC, move DesignState extraction to method, refactor agent definitions to load from config.yaml.
+
+**Architecture:** RoutingEngine replaces free functions in prompts.py. BaseOrchestrator ABC provides shared interface for all orchestrators. Agent definitions loaded from config.yaml via Settings. DesignState.update_from_messages() replaces standalone extract_decisions(). All existing tests must keep passing.
+
+**Tech Stack:** Python ABC, Pydantic, config.yaml
+
+---
+
+### Task 1: Create RoutingEngine class
+
+Create `agents/routing.py` with a class that encapsulates all routing logic currently in `agents/prompts.py` (parse_mentions, route_by_keywords, CAD_TRIGGER_KEYWORDS). Load keywords from config.yaml.
+
+### Task 2: Create BaseOrchestrator ABC
+
+Create `agents/base.py` with abstract base class that MockChatBackend, SingleCallOrchestrator, and CrewOrchestrator will inherit from.
+
+### Task 3: Refactor DesignState — move extract_decisions into method
+
+Move the standalone `extract_decisions()` function into `DesignState.update_from_messages()`. Load materials, material_grades, dimension_contexts from config.yaml.
+
+### Task 4: Refactor agent definitions to load from config
+
+Update `agents/definitions.py` to load agent data from `config.yaml` via Settings, keeping backward compatibility with AGENTS dict, AGENT_COLORS, AGENT_NAMES, AGENT_AVATARS.
+
+### Task 5: Wire RoutingEngine into orchestrators
+
+Update orchestrator.py and crew_orchestrator.py to use RoutingEngine instead of importing free functions from prompts.py.
+
+### Task 6: Make orchestrators inherit BaseOrchestrator
+
+Update MockChatBackend, SingleCallOrchestrator to inherit BaseOrchestrator. Update get_orchestrator factory.
+
+### Task 7: Update tests and verify
+
+Update all test imports, add new tests for RoutingEngine and BaseOrchestrator, run full suite.