Wiring Verification When building infrastructure components, ensure they're actually invoked in the execution path. Pattern Every module needs a clear entry point. Dead code is worse than no code it creates maintenance burden and false confidence. The Four Step Wiring Check Before marking infrastructure "done", verify: 1. Entry Point Exists : How does user action trigger this code? 2. Call Graph Traced : Can you follow the path from entry to execution? 3. Integration Tested : Does an end to end test exercise this path? 4. No Dead Code : Is every built component actually reachable? DO Verify Entry Points Trace Call Graphs Test End to End Document Wiring DON'T Build Without Wiring Create Parallel Routing Assume Imports Work Skip Integration Tests Common Wiring Gaps Hook Not Registered Fix : Add hook registration: Script Not Executable Module Not Importable Router Has No Dispatch Path Wiring Checklist Before marking infrastructure "complete": [ ] Entry point identified and tested (hook/skill/CLI) [ ] Call graph documented (entry → module execution) [ ] Integration test exercises full path [ ] No orphaned modules (everything imported/called) [ ] Registration complete (settings.json/skill rules.json) [ ] Permissions correct (scripts executable) [ ] Import paths verified (manual import test passes) Real World Examples Example 1: DAG Orchestration (This Session) What was built: opc/orchestration/orchestration layer.py (500+ lines) opc/orchestration/dag/ (DAG builder, validator, executor) 18 agent type definitions Sophisticated routing logic Wiring gap: No hook calls orchestration layer.py No script imports the DAG modules Agent routing returns hardcoded "general purpose" Result: 100% dead code Fix: 1. Create PreToolUse hook for Task tool 2. Hook calls scripts/orchestrate.py 3. Script imports and calls orchestration layer.dispatch() 4. Dispatch uses AGENT MAP to route to actual agents 5. Integration test: Submit Task → verify correct agent type used Example 2: Artifact Index (Previous Session) What was built: SQLite database schema Indexing logic Query functions Wiring gap: No hook triggered indexing Files created but never indexed Fix: 1. PostToolUse hook on Write tool 2. Hook calls indexing script immediately 3. Integration test: Write file → verify indexed Detection Strategy Grep for Orphans Check Hook Registration Verify Script Execution Source This session: DAG orchestration wiring gap 500+ lines of dead code discovered Previous sessions: Artifact Index, LMStudio integration wiring added after initial build