# aabrole/claude-trading-desk architecture

> Architecture diagram of the GitHub repository aabrole/claude-trading-desk, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aabrole/claude-trading-desk
- Repository: https://github.com/aabrole/claude-trading-desk

## Overview

Trading Desk is a Claude Code plugin and a template algorithmic-trading research stack. The main workflow is to create a workspace, develop a strategy, compare rules, hand-gated, and Jev-filtered backtests, inspect net-of-cost results, then optionally paper-trade and host the bot. The graph also preserves the documented dashboard and deployment capabilities. Source excerpts establish key harness calls; README statements establish plugin and operational capabilities. Some unsampled subsystem links are therefore omitted rather than inferred.

Main entry points: [`plugins/trading-desk/template/core/decision.py`](https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/template/core/decision.py) (Decision Arms), [`plugins/trading-desk/template/orb/run_backtest.py`](https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/template/orb/run_backtest.py) (ORB Backtest), [`plugins/trading-desk/template/example_sma/run_backtest.py`](https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/template/example_sma/run_backtest.py) (SMA Backtest), [`plugins/trading-desk/template/orb/strategy.py`](https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/template/orb/strategy.py) (ORB Strategy)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_plugin["Claude Plugin"]
  node_init["Initialize Workspace"]
  node_strategy_command["New Strategy"]
  node_strategy_skill["Strategy Guidance<br/>[SKILL.md]"]
  node_method_skill["Testing Discipline<br/>[SKILL.md]"]
  node_paper_skill["Paper Guidance<br/>[SKILL.md]"]
  node_oracle_skill["Hosting Guidance<br/>[SKILL.md]"]
  node_dashboard_skill["Dashboard Guidance<br/>[SKILL.md]"]
  node_deploy_command["Deploy Command"]
end

subgraph group_research["Strategy Research"]
  node_orb_runner["ORB Backtest<br/>[run_backtest.py]"]
  node_sma_runner["SMA Backtest<br/>[run_backtest.py]"]
  node_orb_strategy["ORB Strategy<br/>[strategy.py]"]
  node_sma_strategy["SMA Strategy<br/>[strategy.py]"]
  node_market_data["Historical Data<br/>[data.py]"]
  node_features["Feature Helpers<br/>[features.py]"]
  node_decision["Decision Arms<br/>[decision.py]"]
  node_engine["Portfolio Engine<br/>[engine.py]"]
  node_contracts["Trade Contracts<br/>[contracts.py]"]
  node_metrics["Performance Metrics<br/>[metrics.py]"]
end

subgraph group_runtime["Trading Runtime"]
  node_live["Paper Trader<br/>[live.py]"]
  node_bot_state["Bot State<br/>[botstate.py]"]
end

subgraph group_operations["Operations"]
  node_dashboard_server["Dashboard Server<br/>[server.py]"]
  node_dashboard_ui["Dashboard UI<br/>[index.html]"]
  node_deploy_scripts["VM Deployment"]
end

node_developer(("Developer"))
node_jev_service(("TypeSafe Jev"))
node_alpaca(("Alpaca Data"))
node_alpaca_paper(("Alpaca Paper"))
node_vm(("Oracle Cloud VM"))

node_developer -->|"invokes"| node_init
node_developer -->|"invokes"| node_strategy_command
node_developer -->|"invokes"| node_deploy_command
node_developer -->|"uses guidance"| node_strategy_skill
node_developer -->|"uses guidance"| node_method_skill
node_developer -->|"uses guidance"| node_paper_skill
node_developer -->|"uses guidance"| node_oracle_skill
node_developer -->|"uses guidance"| node_dashboard_skill
node_orb_runner -->|"fetches bars"| node_market_data
node_orb_runner -->|"builds plans"| node_orb_strategy
node_orb_runner -->|"selects arms"| node_decision
node_orb_runner -->|"runs plans"| node_engine
node_orb_runner -->|"summarizes trades"| node_metrics
node_sma_runner -->|"fetches bars"| node_market_data
node_sma_runner -->|"builds plans"| node_sma_strategy
node_sma_runner -->|"selects arms"| node_decision
node_sma_runner -->|"runs plans"| node_engine
node_sma_runner -->|"summarizes trades"| node_metrics
node_orb_strategy -->|"uses helpers"| node_features
node_orb_strategy -->|"creates snapshots"| node_contracts
node_orb_strategy -->|"provides prompt"| node_decision
node_sma_strategy -->|"creates snapshots"| node_contracts
node_sma_strategy -->|"provides prompt"| node_decision
node_market_data -->|"requests bars"| node_alpaca
node_engine -->|"requests decisions"| node_decision
node_engine -->|"uses trade types"| node_contracts
node_metrics -->|"reads trade fields"| node_contracts
node_decision -.->|"queries model"| node_jev_service
node_live -->|"reuses strategy"| node_orb_strategy
node_live -->|"uses Jev decider"| node_decision
node_live -.->|"trades paper"| node_alpaca_paper
node_live -.->|"persists state"| node_bot_state
node_dashboard_server -->|"serves dashboard"| node_dashboard_ui
node_deploy_command -.->|"runs deployment"| node_deploy_scripts
node_deploy_scripts -->|"provisions VM"| node_vm

click node_init "https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/commands/trading-desk-init.md"
click node_strategy_command "https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/commands/trading-desk-new-strategy.md"
click node_strategy_skill "https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/skills/trading-desk-strategy/SKILL.md"
click node_method_skill "https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/skills/trading-desk-method/SKILL.md"
click node_paper_skill "https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/skills/trading-desk-paper/SKILL.md"
click node_oracle_skill "https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/skills/trading-desk-oracle/SKILL.md"
click node_orb_runner "https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/template/orb/run_backtest.py"
click node_sma_runner "https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/template/example_sma/run_backtest.py"
click node_orb_strategy "https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/template/orb/strategy.py"
click node_sma_strategy "https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/template/example_sma/strategy.py"
click node_market_data "https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/template/core/data.py"
click node_features "https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/template/core/features.py"
click node_decision "https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/template/core/decision.py"
click node_engine "https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/template/core/engine.py"
click node_contracts "https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/template/core/contracts.py"
click node_metrics "https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/template/core/metrics.py"
click node_live "https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/template/orb/live.py"
click node_bot_state "https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/template/core/botstate.py"
click node_dashboard_server "https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/template/dashboard/server.py"
click node_dashboard_ui "https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/template/dashboard/index.html"
click node_dashboard_skill "https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/skills/trading-desk-dashboard/SKILL.md"
click node_deploy_command "https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/commands/trading-desk-deploy.md"
click node_deploy_scripts "https://github.com/aabrole/claude-trading-desk/tree/main/plugins/trading-desk/template/deploy"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_init,node_strategy_command,node_strategy_skill,node_method_skill,node_paper_skill,node_oracle_skill,node_dashboard_skill,node_deploy_command toneBlue
class node_orb_runner,node_sma_runner,node_orb_strategy,node_sma_strategy,node_market_data,node_features,node_decision,node_engine,node_contracts,node_metrics toneAmber
class node_live,node_bot_state toneMint
class node_dashboard_server,node_dashboard_ui,node_deploy_scripts toneRose
class node_developer,node_jev_service,node_alpaca,node_alpaca_paper,node_vm toneIndigo
```

## Components

### Claude Plugin

- [Initialize Workspace](https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/commands/trading-desk-init.md): `plugins/trading-desk/commands/trading-desk-init.md`
- [New Strategy](https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/commands/trading-desk-new-strategy.md): `plugins/trading-desk/commands/trading-desk-new-strategy.md`
- [Strategy Guidance](https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/skills/trading-desk-strategy/SKILL.md): `plugins/trading-desk/skills/trading-desk-strategy/SKILL.md`
- [Testing Discipline](https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/skills/trading-desk-method/SKILL.md): `plugins/trading-desk/skills/trading-desk-method/SKILL.md`
- [Paper Guidance](https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/skills/trading-desk-paper/SKILL.md): `plugins/trading-desk/skills/trading-desk-paper/SKILL.md`
- [Hosting Guidance](https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/skills/trading-desk-oracle/SKILL.md): `plugins/trading-desk/skills/trading-desk-oracle/SKILL.md`
- [Dashboard Guidance](https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/skills/trading-desk-dashboard/SKILL.md): `plugins/trading-desk/skills/trading-desk-dashboard/SKILL.md`
- [Deploy Command](https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/commands/trading-desk-deploy.md): `plugins/trading-desk/commands/trading-desk-deploy.md`

### Strategy Research

- [ORB Backtest](https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/template/orb/run_backtest.py): `plugins/trading-desk/template/orb/run_backtest.py`
- [SMA Backtest](https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/template/example_sma/run_backtest.py): `plugins/trading-desk/template/example_sma/run_backtest.py`
- [ORB Strategy](https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/template/orb/strategy.py): `plugins/trading-desk/template/orb/strategy.py`
- [SMA Strategy](https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/template/example_sma/strategy.py): `plugins/trading-desk/template/example_sma/strategy.py`
- [Historical Data](https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/template/core/data.py): `plugins/trading-desk/template/core/data.py`
- [Feature Helpers](https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/template/core/features.py): `plugins/trading-desk/template/core/features.py`
- [Decision Arms](https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/template/core/decision.py): `plugins/trading-desk/template/core/decision.py`
- [Portfolio Engine](https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/template/core/engine.py): `plugins/trading-desk/template/core/engine.py`
- [Trade Contracts](https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/template/core/contracts.py): `plugins/trading-desk/template/core/contracts.py`
- [Performance Metrics](https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/template/core/metrics.py): `plugins/trading-desk/template/core/metrics.py`

### Trading Runtime

- [Paper Trader](https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/template/orb/live.py): `plugins/trading-desk/template/orb/live.py`
- [Bot State](https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/template/core/botstate.py): `plugins/trading-desk/template/core/botstate.py`

### Operations

- [Dashboard Server](https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/template/dashboard/server.py): `plugins/trading-desk/template/dashboard/server.py`
- [Dashboard UI](https://github.com/aabrole/claude-trading-desk/blob/main/plugins/trading-desk/template/dashboard/index.html): `plugins/trading-desk/template/dashboard/index.html`
- [VM Deployment](https://github.com/aabrole/claude-trading-desk/tree/main/plugins/trading-desk/template/deploy): `plugins/trading-desk/template/deploy`

### Other components

- **Developer**
- **TypeSafe Jev**
- **Alpaca Data**
- **Alpaca Paper**
- **Oracle Cloud VM**

## Connections

- Developer → Initialize Workspace: invokes (evidence: `README.md`)
- Developer → New Strategy: invokes (evidence: `README.md`)
- Developer → Deploy Command: invokes (evidence: `README.md`)
- Developer → Strategy Guidance: uses guidance (evidence: `README.md`)
- Developer → Testing Discipline: uses guidance (evidence: `README.md`)
- Developer → Paper Guidance: uses guidance (evidence: `README.md`)
- Developer → Hosting Guidance: uses guidance (evidence: `README.md`)
- Developer → Dashboard Guidance: uses guidance (evidence: `README.md`)
- ORB Backtest → Historical Data: fetches bars (evidence: `plugins/trading-desk/template/orb/run_backtest.py`)
- ORB Backtest → ORB Strategy: builds plans (evidence: `plugins/trading-desk/template/orb/run_backtest.py`)
- ORB Backtest → Decision Arms: selects arms (evidence: `plugins/trading-desk/template/orb/run_backtest.py`)
- ORB Backtest → Portfolio Engine: runs plans (evidence: `plugins/trading-desk/template/orb/run_backtest.py`)
- ORB Backtest → Performance Metrics: summarizes trades (evidence: `plugins/trading-desk/template/orb/run_backtest.py`)
- SMA Backtest → Historical Data: fetches bars (evidence: `plugins/trading-desk/template/example_sma/run_backtest.py`)
- SMA Backtest → SMA Strategy: builds plans (evidence: `plugins/trading-desk/template/example_sma/run_backtest.py`)
- SMA Backtest → Decision Arms: selects arms (evidence: `plugins/trading-desk/template/example_sma/run_backtest.py`)
- SMA Backtest → Portfolio Engine: runs plans (evidence: `plugins/trading-desk/template/example_sma/run_backtest.py`)
- SMA Backtest → Performance Metrics: summarizes trades (evidence: `plugins/trading-desk/template/example_sma/run_backtest.py`)
- ORB Strategy → Feature Helpers: uses helpers (evidence: `plugins/trading-desk/template/orb/strategy.py`)
- ORB Strategy → Trade Contracts: creates snapshots (evidence: `plugins/trading-desk/template/orb/strategy.py`)
- ORB Strategy → Decision Arms: provides prompt (evidence: `plugins/trading-desk/template/orb/strategy.py`)
- SMA Strategy → Trade Contracts: creates snapshots (evidence: `plugins/trading-desk/template/example_sma/strategy.py`)
- SMA Strategy → Decision Arms: provides prompt (evidence: `plugins/trading-desk/template/example_sma/strategy.py`)
- Historical Data → Alpaca Data: requests bars (evidence: `plugins/trading-desk/template/core/data.py`)
- Portfolio Engine → Decision Arms: requests decisions (evidence: `plugins/trading-desk/template/core/engine.py`)
- Portfolio Engine → Trade Contracts: uses trade types (evidence: `plugins/trading-desk/template/core/engine.py`)
- Performance Metrics → Trade Contracts: reads trade fields (evidence: `plugins/trading-desk/template/core/metrics.py`)
- Decision Arms → TypeSafe Jev: queries model
- Paper Trader → ORB Strategy: reuses strategy (evidence: `plugins/trading-desk/template/orb/live.py`)
- Paper Trader → Decision Arms: uses Jev decider (evidence: `plugins/trading-desk/template/orb/live.py`)
- Paper Trader → Alpaca Paper: trades paper
- Paper Trader → Bot State: persists state
- Dashboard Server → Dashboard UI: serves dashboard (evidence: `README.md`)
- Deploy Command → VM Deployment: runs deployment
- VM Deployment → Oracle Cloud VM: provisions VM (evidence: `README.md`)
