# muy97212-spec/github-radar architecture

> Architecture diagram of the GitHub repository muy97212-spec/github-radar, 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/muy97212-spec/github-radar
- Repository: https://github.com/muy97212-spec/github-radar

## Overview

GitHub Radar searches configured topic keywords, deduplicates repository candidates, scores growth and popularity into three rankings, then publishes Markdown/HTML reports and a cross-domain dashboard. The main entry point controls daily domain rotation, historical snapshots, and per-domain cached state. The README also documents a standalone intelligence skill, included as a separate capability. Some internal modules are only indexed or documented, so omitted links reflect limited source evidence.

Main entry points: [`radar.py`](https://github.com/muy97212-spec/github-radar/blob/main/radar.py) (Radar runner), [`ghradar/github_client.py`](https://github.com/muy97212-spec/github-radar/blob/main/ghradar/github_client.py) (GitHub client), [`ghradar/scoring.py`](https://github.com/muy97212-spec/github-radar/blob/main/ghradar/scoring.py) (Three rankings), [`ghradar/report.py`](https://github.com/muy97212-spec/github-radar/blob/main/ghradar/report.py) (Markdown report)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_collection["Collection"]
  node_config["Configuration<br/>[config.py]"]
  node_collector["Candidate collection<br/>[radar.py]"]
  node_github{{"GitHub Search API"}}
  node_client["GitHub client<br/>[github_client.py]"]
end

subgraph group_analysis["Ranking"]
  node_scoring["Three rankings<br/>[scoring.py]"]
end

subgraph group_publishing["Publishing"]
  node_markdown["Markdown report<br/>[report.py]"]
  node_htmlreport["Web report<br/>[report.py]"]
  node_overview["Vault overview<br/>[overview.py]"]
  node_dashboard["HTML dashboard<br/>[overview.py]"]
  node_vault[("Obsidian vault")]
end

subgraph group_history["History &amp; Rotation"]
  node_domains["Domain rotation<br/>[domains.py]"]
  node_snapshot[("Growth snapshot<br/>[snapshot.py]")]
  node_boardstate[("Board state cache<br/>[state.py]")]
end

subgraph group_skill["Intelligence Skill"]
  node_skill["Radar intelligence skill<br/>[SKILL.md]"]
  node_skillengine["Skill CLI<br/>[github_radar.py]"]
end

node_user(("Radar user"))
node_runner["Radar runner<br/>[radar.py]"]
node_skilluser(("Skill user"))

node_user -->|"runs"| node_runner
node_runner -->|"loads settings"| node_config
node_runner -->|"selects domain"| node_domains
node_runner -->|"loads and saves"| node_snapshot
node_runner -->|"collects candidates"| node_collector
node_collector -->|"searches keywords"| node_client
node_client -->|"queries repositories"| node_github
node_runner -->|"builds rankings"| node_scoring
node_scoring -->|"reads prior stars"| node_snapshot
node_runner -->|"renders Markdown"| node_markdown
node_runner -->|"renders HTML"| node_htmlreport
node_runner -->|"stores board rankings"| node_boardstate
node_runner -->|"renders overview"| node_overview
node_runner -->|"renders dashboard"| node_dashboard
node_markdown -->|"writes report"| node_vault
node_htmlreport -->|"writes report"| node_vault
node_overview -->|"writes overview"| node_vault
node_dashboard -->|"writes dashboard"| node_vault
node_skilluser -->|"uses"| node_skill
node_skill -.->|"invokes"| node_skillengine

click node_runner "https://github.com/muy97212-spec/github-radar/blob/main/radar.py"
click node_config "https://github.com/muy97212-spec/github-radar/blob/main/ghradar/config.py"
click node_domains "https://github.com/muy97212-spec/github-radar/blob/main/ghradar/domains.py"
click node_collector "https://github.com/muy97212-spec/github-radar/blob/main/radar.py"
click node_client "https://github.com/muy97212-spec/github-radar/blob/main/ghradar/github_client.py"
click node_scoring "https://github.com/muy97212-spec/github-radar/blob/main/ghradar/scoring.py"
click node_snapshot "https://github.com/muy97212-spec/github-radar/blob/main/ghradar/snapshot.py"
click node_boardstate "https://github.com/muy97212-spec/github-radar/blob/main/ghradar/state.py"
click node_markdown "https://github.com/muy97212-spec/github-radar/blob/main/ghradar/report.py"
click node_htmlreport "https://github.com/muy97212-spec/github-radar/blob/main/ghradar/report.py"
click node_overview "https://github.com/muy97212-spec/github-radar/blob/main/ghradar/overview.py"
click node_dashboard "https://github.com/muy97212-spec/github-radar/blob/main/ghradar/overview.py"
click node_skill "https://github.com/muy97212-spec/github-radar/blob/main/skills/github-radar-intelligence/SKILL.md"
click node_skillengine "https://github.com/muy97212-spec/github-radar/blob/main/skills/github-radar-intelligence/scripts/github_radar.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_config,node_collector,node_github,node_client,node_user,node_skilluser toneBlue
class node_scoring toneAmber
class node_markdown,node_htmlreport,node_overview,node_dashboard,node_vault toneMint
class node_domains,node_snapshot,node_boardstate toneRose
class node_skill,node_skillengine toneIndigo
class node_runner toneTeal
```

## Components

### Collection

- [Configuration](https://github.com/muy97212-spec/github-radar/blob/main/ghradar/config.py): `ghradar/config.py`
- [Candidate collection](https://github.com/muy97212-spec/github-radar/blob/main/radar.py): `radar.py`
- **GitHub Search API**
- [GitHub client](https://github.com/muy97212-spec/github-radar/blob/main/ghradar/github_client.py): `ghradar/github_client.py`

### Ranking

- [Three rankings](https://github.com/muy97212-spec/github-radar/blob/main/ghradar/scoring.py): `ghradar/scoring.py`

### Publishing

- [Markdown report](https://github.com/muy97212-spec/github-radar/blob/main/ghradar/report.py): `ghradar/report.py`
- [Web report](https://github.com/muy97212-spec/github-radar/blob/main/ghradar/report.py): `ghradar/report.py`
- [Vault overview](https://github.com/muy97212-spec/github-radar/blob/main/ghradar/overview.py): `ghradar/overview.py`
- [HTML dashboard](https://github.com/muy97212-spec/github-radar/blob/main/ghradar/overview.py): `ghradar/overview.py`
- **Obsidian vault**

### History & Rotation

- [Domain rotation](https://github.com/muy97212-spec/github-radar/blob/main/ghradar/domains.py): `ghradar/domains.py`
- [Growth snapshot](https://github.com/muy97212-spec/github-radar/blob/main/ghradar/snapshot.py): `ghradar/snapshot.py`
- [Board state cache](https://github.com/muy97212-spec/github-radar/blob/main/ghradar/state.py): `ghradar/state.py`

### Intelligence Skill

- [Radar intelligence skill](https://github.com/muy97212-spec/github-radar/blob/main/skills/github-radar-intelligence/SKILL.md): `skills/github-radar-intelligence/SKILL.md`
- [Skill CLI](https://github.com/muy97212-spec/github-radar/blob/main/skills/github-radar-intelligence/scripts/github_radar.py): `skills/github-radar-intelligence/scripts/github_radar.py`

### Other components

- **Radar user**
- [Radar runner](https://github.com/muy97212-spec/github-radar/blob/main/radar.py): `radar.py`
- **Skill user**

## Connections

- Radar user → Radar runner: runs (evidence: `README.md`)
- Radar runner → Configuration: loads settings (evidence: `radar.py`)
- Radar runner → Domain rotation: selects domain (evidence: `radar.py`)
- Radar runner → Growth snapshot: loads and saves (evidence: `radar.py`)
- Radar runner → Candidate collection: collects candidates (evidence: `radar.py`)
- Candidate collection → GitHub client: searches keywords (evidence: `radar.py`)
- GitHub client → GitHub Search API: queries repositories (evidence: `ghradar/github_client.py`)
- Radar runner → Three rankings: builds rankings (evidence: `radar.py`)
- Three rankings → Growth snapshot: reads prior stars (evidence: `ghradar/scoring.py`)
- Radar runner → Markdown report: renders Markdown (evidence: `radar.py`)
- Radar runner → Web report: renders HTML (evidence: `radar.py`)
- Radar runner → Board state cache: stores board rankings (evidence: `radar.py`)
- Radar runner → Vault overview: renders overview (evidence: `radar.py`)
- Radar runner → HTML dashboard: renders dashboard (evidence: `radar.py`)
- Markdown report → Obsidian vault: writes report (evidence: `README.md`)
- Web report → Obsidian vault: writes report (evidence: `README.md`)
- Vault overview → Obsidian vault: writes overview (evidence: `README.md`)
- HTML dashboard → Obsidian vault: writes dashboard (evidence: `README.md`)
- Skill user → Radar intelligence skill: uses (evidence: `README.md`)
- Radar intelligence skill → Skill CLI: invokes
