How heinsithukyaw/agent-harness works
Agent-Harness is a GitHub-backed registry of agent-framework projects. Its main workflow discovers repositories, enriches their metadata, classifies them into layers, records changes, then generates browsable data and visualizations. Users browse the generated web interface or consume the JSON and Markdown corpus. The graph focuses on this product; the separate profile-cards utility is not part of the README-described registry. Collection and rendering excerpts are partial, so uncertain internal wiring is omitted.
Main entry points: collect.mjs Collector · render.mjs Renderer · projects.json Project Corpus · projects Project History
Components 15
Collection and Classification
- Collector
agent-harness/collect.mjs - Source Queries
agent-harness/config/sources.json - Layer Classifier
agent-harness/collect.mjs
Registry State
- Project Corpus
agent-harness/data/projects.json - Project History
agent-harness/history/projects - Run Ledger
agent-harness/history/events.jsonl - Traffic Data
agent-harness/data/traffic.json
Generated Views
- Renderer
agent-harness/render.mjs - Searchable Site
agent-harness/site - Project Cards
agent-harness/assets/cards - JSON Corpus
agent-harness/data/projects.json - Layer Tables
agent-harness/data/index.md
Other components
- Maintainer
- GitHub API
- Registry Visitor
Connections 18
- Maintainer → Collector: initiates collection
- Collector → Source Queries: reads queries
- Collector → GitHub API: searches and enriches
- Collector → Layer Classifier: classifies metadata
- Collector → Project Corpus: updates corpus
- Collector → Project History: appends observations
- Collector → Run Ledger: records runs
- Collector → Traffic Data: updates traffic
- Renderer → Project Corpus: reads corpus
- Renderer → Project History: reads run history
- Renderer → Run Ledger: reads ledger
- Renderer → Traffic Data: reads traffic
- Renderer → Searchable Site: generates site
- Renderer → Project Cards: generates cards
- Renderer → Layer Tables: generates tables
- Registry Visitor → Searchable Site: searches and filters
- Registry Visitor → JSON Corpus: consumes corpus
- Registry Visitor → Layer Tables: browses tables