# wbh604/uzi-skill architecture

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

- Interactive diagram: https://gitdiagram.com/wbh604/uzi-skill
- Repository: https://github.com/wbh604/uzi-skill

## Overview

UZI-Skill is a multi-market stock research engine: an analyst supplies a ticker, the CLI normalizes it and runs data collection, scoring and synthesis, then produces a standalone report. The README also documents separate workflows for daily watchlists, multi-stock comparisons, portfolios and Tier-1 methods. The sampled source supports the main pipeline and report-rendering links; some documented feature implementations were not sampled, so those branches are shown without speculative internal call chains.

Main entry points: [`skills/deep-analysis/run.py`](https://github.com/wbh604/uzi-skill/blob/main/skills/deep-analysis/run.py) (CLI entry), [`skills/deep-analysis/scripts/lib/pipeline/run.py`](https://github.com/wbh604/uzi-skill/blob/main/skills/deep-analysis/scripts/lib/pipeline/run.py) (Analysis pipeline), [`skills/deep-analysis/scripts/lib/pipeline/collect.py`](https://github.com/wbh604/uzi-skill/blob/main/skills/deep-analysis/scripts/lib/pipeline/collect.py) (Dimension collection), [`skills/deep-analysis/scripts/lib/pipeline/fetchers/registry.py`](https://github.com/wbh604/uzi-skill/blob/main/skills/deep-analysis/scripts/lib/pipeline/fetchers/registry.py) (Fetcher registry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Analysis entry"]
  node_cli["CLI entry<br/>[run.py]"]
  node_market["Ticker routing<br/>[market_router.py]"]
  node_pipeline["Analysis pipeline<br/>[run.py]"]
end

subgraph group_data["Market data"]
  node_collector["Dimension collection<br/>[collect.py]"]
  node_fetch_registry["Fetcher registry<br/>[registry.py]"]
  node_provider_chain["Provider failover<br/>[__init__.py]"]
  node_data_sources["Data sources<br/>[data_sources.py]"]
  node_cache[("Data cache<br/>[cache.py]")]
end

subgraph group_analysis["Analysis and review"]
  node_scoring["Dimension scoring<br/>[score_fns.py]"]
  node_investors[("Investor panel<br/>[investor_db.py]")]
  node_review["Quality review<br/>[self_review.py]"]
  node_profile["Analysis profile"]
end

subgraph group_outputs["Reports and screening"]
  node_report["Report assembly<br/>[assemble_report.py]"]
  node_visualizations["Dimension visuals<br/>[dim_viz.py]"]
  node_svg["SVG primitives<br/>[svg_primitives.py]"]
  node_daily_screen["Daily watchlist"]
end

subgraph group_extensions["Portfolio and methods"]
  node_versus["Stock comparison<br/>[versus_runner.py]"]
  node_portfolio["Portfolio analysis"]
  node_tier1["Tier-1 methods"]
end

node_analyst(("Analyst"))
node_market_feeds["Market data feeds"]
node_investor(("Research user"))

node_analyst -->|"requests analysis"| node_cli
node_cli -->|"normalizes ticker"| node_market
node_cli -->|"starts pipeline"| node_pipeline
node_cli -->|"dispatches comparison"| node_versus
node_cli -->|"dispatches portfolio"| node_portfolio
node_pipeline -->|"collects dimensions"| node_collector
node_pipeline -->|"scores results"| node_scoring
node_collector -->|"resolves fetchers"| node_fetch_registry
node_fetch_registry -->|"uses cache"| node_cache
node_fetch_registry -.->|"selects providers"| node_provider_chain
node_provider_chain -.->|"fetches data"| node_market_feeds
node_collector -.->|"collects market data"| node_data_sources
node_scoring -->|"evaluates investors"| node_investors
node_pipeline -.->|"produces report"| node_report
node_report -->|"renders dimensions"| node_visualizations
node_visualizations -->|"uses primitives"| node_svg
node_investor -.->|"requests watchlist"| node_daily_screen
node_investor -.->|"requests method"| node_tier1

click node_cli "https://github.com/wbh604/uzi-skill/blob/main/skills/deep-analysis/run.py"
click node_market "https://github.com/wbh604/uzi-skill/blob/main/skills/deep-analysis/scripts/lib/market_router.py"
click node_pipeline "https://github.com/wbh604/uzi-skill/blob/main/skills/deep-analysis/scripts/lib/pipeline/run.py"
click node_collector "https://github.com/wbh604/uzi-skill/blob/main/skills/deep-analysis/scripts/lib/pipeline/collect.py"
click node_fetch_registry "https://github.com/wbh604/uzi-skill/blob/main/skills/deep-analysis/scripts/lib/pipeline/fetchers/registry.py"
click node_provider_chain "https://github.com/wbh604/uzi-skill/blob/main/skills/deep-analysis/scripts/lib/providers/__init__.py"
click node_data_sources "https://github.com/wbh604/uzi-skill/blob/main/skills/deep-analysis/scripts/lib/data_sources.py"
click node_cache "https://github.com/wbh604/uzi-skill/blob/main/skills/deep-analysis/scripts/lib/cache.py"
click node_scoring "https://github.com/wbh604/uzi-skill/blob/main/skills/deep-analysis/scripts/lib/pipeline/score_fns.py"
click node_investors "https://github.com/wbh604/uzi-skill/blob/main/skills/deep-analysis/scripts/lib/investor_db.py"
click node_review "https://github.com/wbh604/uzi-skill/blob/main/skills/deep-analysis/scripts/lib/self_review.py"
click node_profile "https://github.com/wbh604/uzi-skill/blob/main/skills/deep-analysis/scripts/lib/analysis_profile.py"
click node_report "https://github.com/wbh604/uzi-skill/blob/main/skills/deep-analysis/scripts/assemble_report.py"
click node_visualizations "https://github.com/wbh604/uzi-skill/blob/main/skills/deep-analysis/scripts/lib/report/dim_viz.py"
click node_svg "https://github.com/wbh604/uzi-skill/blob/main/skills/deep-analysis/scripts/lib/report/svg_primitives.py"
click node_daily_screen "https://github.com/wbh604/uzi-skill/tree/main/skills/deep-analysis/scripts/lib/daily_screen"
click node_versus "https://github.com/wbh604/uzi-skill/blob/main/skills/deep-analysis/scripts/lib/versus_runner.py"
click node_portfolio "https://github.com/wbh604/uzi-skill/blob/main/skills/deep-analysis/scripts/lib/portfolio_runner.py"
click node_tier1 "https://github.com/wbh604/uzi-skill/tree/main/skills/deep-analysis/scripts/lib/tier1"

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_cli,node_market,node_pipeline,node_investor toneBlue
class node_collector,node_fetch_registry,node_provider_chain,node_data_sources,node_cache toneAmber
class node_scoring,node_investors,node_review,node_profile toneMint
class node_report,node_visualizations,node_svg,node_daily_screen toneRose
class node_versus,node_portfolio,node_tier1,node_analyst,node_market_feeds toneIndigo
```

## Components

### Analysis entry

- [CLI entry](https://github.com/wbh604/uzi-skill/blob/main/skills/deep-analysis/run.py): `skills/deep-analysis/run.py`
- [Ticker routing](https://github.com/wbh604/uzi-skill/blob/main/skills/deep-analysis/scripts/lib/market_router.py): `skills/deep-analysis/scripts/lib/market_router.py`
- [Analysis pipeline](https://github.com/wbh604/uzi-skill/blob/main/skills/deep-analysis/scripts/lib/pipeline/run.py): `skills/deep-analysis/scripts/lib/pipeline/run.py`

### Market data

- [Dimension collection](https://github.com/wbh604/uzi-skill/blob/main/skills/deep-analysis/scripts/lib/pipeline/collect.py): `skills/deep-analysis/scripts/lib/pipeline/collect.py`
- [Fetcher registry](https://github.com/wbh604/uzi-skill/blob/main/skills/deep-analysis/scripts/lib/pipeline/fetchers/registry.py): `skills/deep-analysis/scripts/lib/pipeline/fetchers/registry.py`
- [Provider failover](https://github.com/wbh604/uzi-skill/blob/main/skills/deep-analysis/scripts/lib/providers/__init__.py): `skills/deep-analysis/scripts/lib/providers/__init__.py`
- [Data sources](https://github.com/wbh604/uzi-skill/blob/main/skills/deep-analysis/scripts/lib/data_sources.py): `skills/deep-analysis/scripts/lib/data_sources.py`
- [Data cache](https://github.com/wbh604/uzi-skill/blob/main/skills/deep-analysis/scripts/lib/cache.py): `skills/deep-analysis/scripts/lib/cache.py`

### Analysis and review

- [Dimension scoring](https://github.com/wbh604/uzi-skill/blob/main/skills/deep-analysis/scripts/lib/pipeline/score_fns.py): `skills/deep-analysis/scripts/lib/pipeline/score_fns.py`
- [Investor panel](https://github.com/wbh604/uzi-skill/blob/main/skills/deep-analysis/scripts/lib/investor_db.py): `skills/deep-analysis/scripts/lib/investor_db.py`
- [Quality review](https://github.com/wbh604/uzi-skill/blob/main/skills/deep-analysis/scripts/lib/self_review.py): `skills/deep-analysis/scripts/lib/self_review.py`
- [Analysis profile](https://github.com/wbh604/uzi-skill/blob/main/skills/deep-analysis/scripts/lib/analysis_profile.py): `skills/deep-analysis/scripts/lib/analysis_profile.py`

### Reports and screening

- [Report assembly](https://github.com/wbh604/uzi-skill/blob/main/skills/deep-analysis/scripts/assemble_report.py): `skills/deep-analysis/scripts/assemble_report.py`
- [Dimension visuals](https://github.com/wbh604/uzi-skill/blob/main/skills/deep-analysis/scripts/lib/report/dim_viz.py): `skills/deep-analysis/scripts/lib/report/dim_viz.py`
- [SVG primitives](https://github.com/wbh604/uzi-skill/blob/main/skills/deep-analysis/scripts/lib/report/svg_primitives.py): `skills/deep-analysis/scripts/lib/report/svg_primitives.py`
- [Daily watchlist](https://github.com/wbh604/uzi-skill/tree/main/skills/deep-analysis/scripts/lib/daily_screen): `skills/deep-analysis/scripts/lib/daily_screen`

### Portfolio and methods

- [Stock comparison](https://github.com/wbh604/uzi-skill/blob/main/skills/deep-analysis/scripts/lib/versus_runner.py): `skills/deep-analysis/scripts/lib/versus_runner.py`
- [Portfolio analysis](https://github.com/wbh604/uzi-skill/blob/main/skills/deep-analysis/scripts/lib/portfolio_runner.py): `skills/deep-analysis/scripts/lib/portfolio_runner.py`
- [Tier-1 methods](https://github.com/wbh604/uzi-skill/tree/main/skills/deep-analysis/scripts/lib/tier1): `skills/deep-analysis/scripts/lib/tier1`

### Other components

- **Analyst**
- **Market data feeds**
- **Research user**

## Connections

- Analyst → CLI entry: requests analysis (evidence: `README.md`)
- CLI entry → Ticker routing: normalizes ticker (evidence: `skills/deep-analysis/run.py`)
- CLI entry → Analysis pipeline: starts pipeline (evidence: `skills/deep-analysis/run.py`)
- CLI entry → Stock comparison: dispatches comparison
- CLI entry → Portfolio analysis: dispatches portfolio
- Analysis pipeline → Dimension collection: collects dimensions (evidence: `skills/deep-analysis/scripts/lib/pipeline/run.py`)
- Analysis pipeline → Dimension scoring: scores results (evidence: `skills/deep-analysis/scripts/lib/pipeline/run.py`)
- Dimension collection → Fetcher registry: resolves fetchers (evidence: `skills/deep-analysis/scripts/lib/pipeline/collect.py`)
- Fetcher registry → Data cache: uses cache (evidence: `skills/deep-analysis/scripts/lib/pipeline/fetchers/registry.py`)
- Fetcher registry → Provider failover: selects providers
- Provider failover → Market data feeds: fetches data
- Dimension collection → Data sources: collects market data
- Dimension scoring → Investor panel: evaluates investors (evidence: `skills/deep-analysis/scripts/lib/pipeline/score_fns.py`)
- Analysis pipeline → Report assembly: produces report
- Report assembly → Dimension visuals: renders dimensions (evidence: `skills/deep-analysis/scripts/assemble_report.py`)
- Dimension visuals → SVG primitives: uses primitives (evidence: `skills/deep-analysis/scripts/lib/report/dim_viz.py`)
- Research user → Daily watchlist: requests watchlist
- Research user → Tier-1 methods: requests method
