# jakeschincariol/day-trader-skill architecture

> Architecture diagram of the GitHub repository jakeschincariol/day-trader-skill, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jakeschincariol/day-trader-skill
- Repository: https://github.com/jakeschincariol/day-trader-skill
- Video tour (about a minute): https://gitdiagram.com/jakeschincariol/day-trader-skill/video

## Overview

This repository is a set of eleven standalone Claude day-trading skills, implemented as standard-library Python tools over public market and filing data. Its primary workflow scans for setups, monitors news, times an entry, plans exits, simulates outcomes, sizes and checks an order, then presents it for explicit approval; alerts support open trades. Earnings analysis and congressional-trade tracking are separate scheduled capabilities. The README documents the workflow and handoffs; sampled source confirms individual tool behavior, but unsampled modules and runtime file wiring are not independently verified here.

Main entry points: [`trader-entry/entry.py`](https://github.com/jakeschincariol/day-trader-skill/blob/main/trader-entry/entry.py) (Entry timer), [`trader-exit/exit.py`](https://github.com/jakeschincariol/day-trader-skill/blob/main/trader-exit/exit.py) (Exit planner), [`trader-timemachine/timemachine.py`](https://github.com/jakeschincariol/day-trader-skill/blob/main/trader-timemachine/timemachine.py) (Outcome replay), [`trader-scanner/scan.py`](https://github.com/jakeschincariol/day-trader-skill/blob/main/trader-scanner/scan.py) (Chart scanner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_trade["Trade workflow"]
  node_entry["Entry timer<br/>[entry.py]"]
  node_exit["Exit planner<br/>[exit.py]"]
  node_timemachine["Outcome replay<br/>[timemachine.py]"]
  node_alerts["Price alerts<br/>[alerts.py]"]
end

subgraph group_market["Market intelligence"]
  node_scanner["Chart scanner<br/>[scan.py]"]
  node_news["News monitor<br/>[news.py]"]
end

subgraph group_safety["Trade controls"]
  node_budget["Position sizing<br/>[size.py]"]
  node_risk["Risk checks<br/>[check.py]"]
  node_broker["Order ticket<br/>[ticket.py]"]
end

subgraph group_research["Independent research"]
  node_analyst["Earnings analyst<br/>[facts.py]"]
  node_pelosi["Disclosure tracker<br/>[ptr.py]"]
end

node_trader(("Trader"))
node_publicdata["Public data sources"]
node_brokerconnector["Broker connector"]

node_trader -->|"requests scan"| node_scanner
node_scanner -->|"then monitors"| node_news
node_news -->|"then times"| node_entry
node_entry -->|"then plans"| node_exit
node_exit -->|"then replays"| node_timemachine
node_timemachine -->|"then sizes"| node_budget
node_budget -->|"then checks"| node_risk
node_risk -->|"then tickets"| node_broker
node_trader -->|"approves order"| node_broker
node_broker -->|"invokes after approval"| node_brokerconnector
node_trader -->|"sets alerts"| node_alerts
node_exit -->|"provides plan"| node_alerts
node_trader -->|"requests analysis"| node_analyst
node_trader -->|"tracks disclosures"| node_pelosi
node_scanner -->|"reads market data"| node_publicdata
node_news -->|"reads headlines"| node_publicdata
node_entry -->|"reads charts"| node_publicdata
node_timemachine -->|"reads bars"| node_publicdata
node_analyst -->|"reads SEC filings"| node_publicdata
node_pelosi -->|"reads disclosures"| node_publicdata

click node_scanner "https://github.com/jakeschincariol/day-trader-skill/blob/main/trader-scanner/scan.py"
click node_news "https://github.com/jakeschincariol/day-trader-skill/blob/main/trader-news/news.py"
click node_entry "https://github.com/jakeschincariol/day-trader-skill/blob/main/trader-entry/entry.py"
click node_exit "https://github.com/jakeschincariol/day-trader-skill/blob/main/trader-exit/exit.py"
click node_timemachine "https://github.com/jakeschincariol/day-trader-skill/blob/main/trader-timemachine/timemachine.py"
click node_budget "https://github.com/jakeschincariol/day-trader-skill/blob/main/trader-budget/size.py"
click node_risk "https://github.com/jakeschincariol/day-trader-skill/blob/main/trader-risk/check.py"
click node_broker "https://github.com/jakeschincariol/day-trader-skill/blob/main/trader-broker/ticket.py"
click node_alerts "https://github.com/jakeschincariol/day-trader-skill/blob/main/trader-alerts/alerts.py"
click node_analyst "https://github.com/jakeschincariol/day-trader-skill/blob/main/trader-analyst/facts.py"
click node_pelosi "https://github.com/jakeschincariol/day-trader-skill/blob/main/trader-pelosi/ptr.py"

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_entry,node_exit,node_timemachine,node_alerts toneBlue
class node_scanner,node_news toneAmber
class node_budget,node_risk,node_broker toneMint
class node_analyst,node_pelosi toneRose
class node_trader,node_publicdata,node_brokerconnector toneIndigo
```

## Components

### Trade workflow

- [Entry timer](https://github.com/jakeschincariol/day-trader-skill/blob/main/trader-entry/entry.py): `trader-entry/entry.py`
- [Exit planner](https://github.com/jakeschincariol/day-trader-skill/blob/main/trader-exit/exit.py): `trader-exit/exit.py`
- [Outcome replay](https://github.com/jakeschincariol/day-trader-skill/blob/main/trader-timemachine/timemachine.py): `trader-timemachine/timemachine.py`
- [Price alerts](https://github.com/jakeschincariol/day-trader-skill/blob/main/trader-alerts/alerts.py): `trader-alerts/alerts.py`

### Market intelligence

- [Chart scanner](https://github.com/jakeschincariol/day-trader-skill/blob/main/trader-scanner/scan.py): `trader-scanner/scan.py`
- [News monitor](https://github.com/jakeschincariol/day-trader-skill/blob/main/trader-news/news.py): `trader-news/news.py`

### Trade controls

- [Position sizing](https://github.com/jakeschincariol/day-trader-skill/blob/main/trader-budget/size.py): `trader-budget/size.py`
- [Risk checks](https://github.com/jakeschincariol/day-trader-skill/blob/main/trader-risk/check.py): `trader-risk/check.py`
- [Order ticket](https://github.com/jakeschincariol/day-trader-skill/blob/main/trader-broker/ticket.py): `trader-broker/ticket.py`

### Independent research

- [Earnings analyst](https://github.com/jakeschincariol/day-trader-skill/blob/main/trader-analyst/facts.py): `trader-analyst/facts.py`
- [Disclosure tracker](https://github.com/jakeschincariol/day-trader-skill/blob/main/trader-pelosi/ptr.py): `trader-pelosi/ptr.py`

### Other components

- **Trader**
- **Public data sources**
- **Broker connector**

## Connections

- Trader → Chart scanner: requests scan (evidence: `README.md`)
- Chart scanner → News monitor: then monitors (evidence: `README.md`)
- News monitor → Entry timer: then times (evidence: `README.md`)
- Entry timer → Exit planner: then plans (evidence: `README.md`)
- Exit planner → Outcome replay: then replays (evidence: `README.md`)
- Outcome replay → Position sizing: then sizes (evidence: `README.md`)
- Position sizing → Risk checks: then checks (evidence: `README.md`)
- Risk checks → Order ticket: then tickets (evidence: `README.md`)
- Trader → Order ticket: approves order (evidence: `README.md`)
- Order ticket → Broker connector: invokes after approval (evidence: `README.md`)
- Trader → Price alerts: sets alerts (evidence: `README.md`)
- Exit planner → Price alerts: provides plan (evidence: `README.md`)
- Trader → Earnings analyst: requests analysis (evidence: `README.md`)
- Trader → Disclosure tracker: tracks disclosures (evidence: `README.md`)
- Chart scanner → Public data sources: reads market data (evidence: `README.md`)
- News monitor → Public data sources: reads headlines (evidence: `README.md`)
- Entry timer → Public data sources: reads charts (evidence: `README.md`)
- Outcome replay → Public data sources: reads bars (evidence: `README.md`)
- Earnings analyst → Public data sources: reads SEC filings (evidence: `README.md`)
- Disclosure tracker → Public data sources: reads disclosures (evidence: `README.md`)