Bulkhead τ Meta-Domain

ShowcaseAgent

Intelligent Domain Router & Orchestrator

13
Domains
500+
Tools
80.6%
Routing Accuracy
3
Variations

What is a Meta-Domain?

ShowcaseAgent is fundamentally different from typical Bulkhead τ domains. Instead of performing domain-specific work, it orchestrates and routes queries to 13 production domains through a unified interface.

The Meta-Domain Pattern

  • Doesn't execute domain work - pure orchestration layer
  • Cross-domain aggregation - unified interface to 500+ tools
  • Intelligent routing - rule-based + LLM hybrid
  • Hypothesis testing - benchmarks meta-tools vs direct access

Core Capabilities

GUI Browser

Interactive tkinter interface to browse all domains, view tools, and route queries in real-time.

showcase_agent.py

Meta-Router

Hybrid routing: regex patterns for speed, LLM fallback for ambiguous queries.

router/domain_router.py

Domain Adapters

Uniform adapters providing a consistent interface to varied domain implementations.

router/domain_adapters/

Benchmark Platform

Test hypothesis across 5 LLM providers with 150+ validation queries.

benchmark/

Dual Modes

Meta-tool mode vs Direct mode for different LLM contexts.

unified_agent.py

Variations

3 experimental configurations for comparative tool abstraction studies.

variations/

The Core Hypothesis

"Local LLMs perform better with abstracted meta-tools than direct access to 500+ individual tools."

This hypothesis drives the entire ShowcaseAgent architecture. By presenting one meta-tool per domain instead of 500+ direct tools:

  • LLM makes one decision: "which domain?"
  • Reduces context window pressure
  • Better suited for local models with limited context
  • Routing accuracy: 80.6% on cross-domain queries

Architecture Overview

# Query Flow User Query | v +-------------------+ | ShowcaseAgent | <-- Meta-Domain (this) | (Router Layer) | +-------------------+ | v +-------------------+ | Domain Router | <-- Rule-based + LLM hybrid | (Hybrid) | +-------------------+ | +---> TennisAgent +---> Optiver (84 tools) +---> Portfolio (70 tools) +---> WQ (38 tools) +---> GarminAgent (32 tools) +---> GolfAgent (31 tools) +---> ... 8 more domains

Showcased Domains

Domain Category Routing Accuracy
TennisAgent Sports/Analytics 100%
Optiver Finance/ML 80%
Portfolio Finance/Analytics 90%
WQ Education/DataScience 25%
GarminAgent Fitness/Analytics -
GolfAgent Sports/Analytics -
QCiAgent Tech/Sales 100%
ParableAgent Education/Religion 80%
Stan Education/Statistics 40%
YieldModel Manufacturing/ML 100%
AI_WQ Education/DeepLearning 75%
PPR_Agent Healthcare/Data 100%
AmericanEconomy Macro/Data -
GlobalTemperature Climate/Science -

Overall routing accuracy: 80.6% (83/103 queries correctly routed)

Development Sprints

Sprint Focus Status
1 Foundation (router, TennisAgent adapter) Complete
2 10 domain adapters with uniform interface Complete
3 Benchmark platform (5 providers, 150+ queries) Complete
4 LLM routing + direct mode + routing tracking Complete
5 GUI integration with live query routing Complete