# hesreallyhim/awesome-claude-code architecture

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

- Interactive diagram: https://gitdiagram.com/hesreallyhim/awesome-claude-code
- Repository: https://github.com/hesreallyhim/awesome-claude-code

## Overview

This repository curates and publishes a categorized Claude Code resource list. The principal workflow is: a contributor or maintainer submits resource metadata, the issue-form parser validates it against configured categories and existing catalog entries, approved data is appended or edited in the canonical CSV, and README.md is regenerated with formatted entries and badges. A parallel discovery workflow fetches GitHub repository metrics, filters them, and renders ticker SVGs. The graph reflects sampled runtime code and explicit module documentation; GitHub workflow wiring is only represented where source comments establish it.

Main entry points: [`THE_RESOURCES_TABLE_NEW.csv`](https://github.com/hesreallyhim/awesome-claude-code/blob/main/THE_RESOURCES_TABLE_NEW.csv) (Resource Catalog), [`generate_readme.py`](https://github.com/hesreallyhim/awesome-claude-code/blob/main/generate_readme.py) (README Generator), [`ticker/generate_ticker_svg.py`](https://github.com/hesreallyhim/awesome-claude-code/blob/main/ticker/generate_ticker_svg.py) (Ticker Renderer), [`resources/parse_issue_form.py`](https://github.com/hesreallyhim/awesome-claude-code/blob/main/resources/parse_issue_form.py) (Issue Validator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_submission["Submission &amp; Curation"]
  node_submit_issue["Submit Issue"]
  node_issue_parser["Issue Validator"]
  node_categories["Category Rules<br/>[categories.py]"]
end

subgraph group_catalog["Catalog Management"]
  node_resource_csv[("Resource Catalog")]
  node_add_resource["Add Resource<br/>[add_resource.py]"]
  node_update_resource["Update Resource<br/>[update_resource.py]"]
  node_move_resource["Move Resource<br/>[move_resource.py]"]
end

subgraph group_publishing["README Publishing"]
  node_config["List Configuration<br/>[config.yaml]"]
  node_readme_generator["README Generator<br/>[generate_readme.py]"]
  node_entry_formatter["Entry Formatter"]
  node_readme["Generated README<br/>[README.md]"]
end

subgraph group_discovery["Ticker Discovery"]
  node_ticker_fetcher["Ticker Fetcher"]
  node_ticker_data[("Ticker Data<br/>[repo-ticker.csv]")]
  node_ticker_filters["Ticker Filters<br/>[ticker_filters.py]"]
  node_ticker_renderer["Ticker Renderer"]
  node_recent_renderer["Recent Renderer"]
  node_ticker_assets["Ticker SVG Assets"]
end

node_contributor(("Contributor"))
node_maintainer(("Maintainer"))
node_github_issues["GitHub Issues"]
node_github_api["GitHub API"]

node_contributor -->|"submits resource"| node_submit_issue
node_submit_issue -->|"creates issue"| node_github_issues
node_github_issues -->|"provides body"| node_issue_parser
node_issue_parser -->|"validates category"| node_categories
node_issue_parser -->|"checks duplicates"| node_resource_csv
node_maintainer -->|"adds resource"| node_add_resource
node_maintainer -->|"edits resource"| node_update_resource
node_maintainer -->|"moves resource"| node_move_resource
node_add_resource -->|"appends row"| node_resource_csv
node_update_resource -->|"rewrites row"| node_resource_csv
node_move_resource -->|"updates placement"| node_resource_csv
node_readme_generator -->|"reads catalog"| node_resource_csv
node_readme_generator -->|"reads ordering"| node_config
node_readme_generator -->|"formats entries"| node_entry_formatter
node_readme_generator -->|"writes README"| node_readme
node_ticker_fetcher -->|"fetches repositories"| node_github_api
node_ticker_fetcher -->|"writes metrics"| node_ticker_data
node_ticker_renderer -->|"reads metrics"| node_ticker_data
node_ticker_renderer -->|"filters repositories"| node_ticker_filters
node_ticker_renderer -.->|"fetches star deltas"| node_github_api
node_ticker_renderer -->|"writes ticker SVG"| node_ticker_assets
node_recent_renderer -->|"reads recent entries"| node_resource_csv
node_recent_renderer -->|"writes recent SVG"| node_ticker_assets

click node_submit_issue "https://github.com/hesreallyhim/awesome-claude-code/blob/main/resources/submit_resource_issue.py"
click node_issue_parser "https://github.com/hesreallyhim/awesome-claude-code/blob/main/resources/parse_issue_form.py"
click node_categories "https://github.com/hesreallyhim/awesome-claude-code/blob/main/resources/categories.py"
click node_resource_csv "https://github.com/hesreallyhim/awesome-claude-code/blob/main/THE_RESOURCES_TABLE_NEW.csv"
click node_add_resource "https://github.com/hesreallyhim/awesome-claude-code/blob/main/resources/add_resource.py"
click node_update_resource "https://github.com/hesreallyhim/awesome-claude-code/blob/main/resources/update_resource.py"
click node_move_resource "https://github.com/hesreallyhim/awesome-claude-code/blob/main/resources/move_resource.py"
click node_config "https://github.com/hesreallyhim/awesome-claude-code/blob/main/config.yaml"
click node_readme_generator "https://github.com/hesreallyhim/awesome-claude-code/blob/main/generate_readme.py"
click node_entry_formatter "https://github.com/hesreallyhim/awesome-claude-code/blob/main/resources/awesome-list-entry-formatter.py"
click node_readme "https://github.com/hesreallyhim/awesome-claude-code/blob/main/README.md"
click node_ticker_fetcher "https://github.com/hesreallyhim/awesome-claude-code/blob/main/ticker/fetch_repo_ticker_data.py"
click node_ticker_data "https://github.com/hesreallyhim/awesome-claude-code/blob/main/data/repo-ticker.csv"
click node_ticker_filters "https://github.com/hesreallyhim/awesome-claude-code/blob/main/ticker/ticker_filters.py"
click node_ticker_renderer "https://github.com/hesreallyhim/awesome-claude-code/blob/main/ticker/generate_ticker_svg.py"
click node_recent_renderer "https://github.com/hesreallyhim/awesome-claude-code/blob/main/ticker/generate_recently_added_svg.py"
click node_ticker_assets "https://github.com/hesreallyhim/awesome-claude-code/tree/main/assets"

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_submit_issue,node_issue_parser,node_categories toneBlue
class node_resource_csv,node_add_resource,node_update_resource,node_move_resource toneAmber
class node_config,node_readme_generator,node_entry_formatter,node_readme,node_github_api toneMint
class node_ticker_fetcher,node_ticker_data,node_ticker_filters,node_ticker_renderer,node_recent_renderer,node_ticker_assets toneRose
class node_contributor,node_maintainer,node_github_issues toneIndigo
```

## Components

### Submission & Curation

- [Submit Issue](https://github.com/hesreallyhim/awesome-claude-code/blob/main/resources/submit_resource_issue.py): `resources/submit_resource_issue.py`
- [Issue Validator](https://github.com/hesreallyhim/awesome-claude-code/blob/main/resources/parse_issue_form.py): `resources/parse_issue_form.py`
- [Category Rules](https://github.com/hesreallyhim/awesome-claude-code/blob/main/resources/categories.py): `resources/categories.py`

### Catalog Management

- [Resource Catalog](https://github.com/hesreallyhim/awesome-claude-code/blob/main/THE_RESOURCES_TABLE_NEW.csv): `THE_RESOURCES_TABLE_NEW.csv`
- [Add Resource](https://github.com/hesreallyhim/awesome-claude-code/blob/main/resources/add_resource.py): `resources/add_resource.py`
- [Update Resource](https://github.com/hesreallyhim/awesome-claude-code/blob/main/resources/update_resource.py): `resources/update_resource.py`
- [Move Resource](https://github.com/hesreallyhim/awesome-claude-code/blob/main/resources/move_resource.py): `resources/move_resource.py`

### README Publishing

- [List Configuration](https://github.com/hesreallyhim/awesome-claude-code/blob/main/config.yaml): `config.yaml`
- [README Generator](https://github.com/hesreallyhim/awesome-claude-code/blob/main/generate_readme.py): `generate_readme.py`
- [Entry Formatter](https://github.com/hesreallyhim/awesome-claude-code/blob/main/resources/awesome-list-entry-formatter.py): `resources/awesome-list-entry-formatter.py`
- [Generated README](https://github.com/hesreallyhim/awesome-claude-code/blob/main/README.md): `README.md`

### Ticker Discovery

- [Ticker Fetcher](https://github.com/hesreallyhim/awesome-claude-code/blob/main/ticker/fetch_repo_ticker_data.py): `ticker/fetch_repo_ticker_data.py`
- [Ticker Data](https://github.com/hesreallyhim/awesome-claude-code/blob/main/data/repo-ticker.csv): `data/repo-ticker.csv`
- [Ticker Filters](https://github.com/hesreallyhim/awesome-claude-code/blob/main/ticker/ticker_filters.py): `ticker/ticker_filters.py`
- [Ticker Renderer](https://github.com/hesreallyhim/awesome-claude-code/blob/main/ticker/generate_ticker_svg.py): `ticker/generate_ticker_svg.py`
- [Recent Renderer](https://github.com/hesreallyhim/awesome-claude-code/blob/main/ticker/generate_recently_added_svg.py): `ticker/generate_recently_added_svg.py`
- [Ticker SVG Assets](https://github.com/hesreallyhim/awesome-claude-code/tree/main/assets): `assets`

### Other components

- **Contributor**
- **Maintainer**
- **GitHub Issues**
- **GitHub API**

## Connections

- Contributor → Submit Issue: submits resource
- Submit Issue → GitHub Issues: creates issue
- GitHub Issues → Issue Validator: provides body
- Issue Validator → Category Rules: validates category
- Issue Validator → Resource Catalog: checks duplicates
- Maintainer → Add Resource: adds resource
- Maintainer → Update Resource: edits resource
- Maintainer → Move Resource: moves resource
- Add Resource → Resource Catalog: appends row
- Update Resource → Resource Catalog: rewrites row
- Move Resource → Resource Catalog: updates placement
- README Generator → Resource Catalog: reads catalog
- README Generator → List Configuration: reads ordering
- README Generator → Entry Formatter: formats entries
- README Generator → Generated README: writes README
- Ticker Fetcher → GitHub API: fetches repositories
- Ticker Fetcher → Ticker Data: writes metrics
- Ticker Renderer → Ticker Data: reads metrics
- Ticker Renderer → Ticker Filters: filters repositories
- Ticker Renderer → GitHub API: fetches star deltas
- Ticker Renderer → Ticker SVG Assets: writes ticker SVG
- Recent Renderer → Resource Catalog: reads recent entries
- Recent Renderer → Ticker SVG Assets: writes recent SVG
