# genkovich/harness-workshop architecture

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

- Interactive diagram: https://gitdiagram.com/genkovich/harness-workshop
- Repository: https://github.com/genkovich/harness-workshop

## Overview

Це воркшопний агент для пошуку обговорень Hacker News, читання коментарів і створення українського дайджесту. Користувач передає задачу через CLI; цикл harness звертається до моделі, виконує її виклики інструментів і повертає результати в історію. Основні предметні етапи — пошук і посторінкове читання обговорень, потім захищений запис дайджесту. Окремо агент отримує контекст проєкту й каталог skills. Зв’язки показано за README та наданими excerpts; несемпльовані підсистеми не деталізовано.

Main entry points: [`src/news/agent.ts`](https://github.com/genkovich/harness-workshop/blob/main/src/news/agent.ts) (Агент новин), [`src/main.ts`](https://github.com/genkovich/harness-workshop/blob/main/src/main.ts) (CLI точка входу), [`src/harness.ts`](https://github.com/genkovich/harness-workshop/blob/main/src/harness.ts) (Цикл harness), [`src/context.ts`](https://github.com/genkovich/harness-workshop/blob/main/src/context.ts) (Збір контексту)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Виконання агента"]
  node_cli["CLI точка входу<br/>[main.ts]"]
  node_harness["Цикл harness<br/>[harness.ts]"]
end

subgraph group_research["Дослідження HN"]
  node_news_agent["Агент новин<br/>[agent.ts]"]
  node_search["Пошук stories<br/>[api.ts]"]
  node_discussion["Читання обговорення<br/>[api.ts]"]
end

subgraph group_guidance["Контекст і дозволи"]
  node_context_loader["Збір контексту<br/>[context.ts]"]
  node_project_guidance["Інструкції проєкту<br/>[AGENTS.md]"]
  node_rules["Правила проєкту"]
  node_skill_catalog["Каталог skills<br/>[skills.ts]"]
  node_digest_skill["Skill digest<br/>[SKILL.md]"]
  node_settings["Дозвіл на запис<br/>[settings.ts]"]
end

subgraph group_outputs["Результати"]
  node_digest_writer["Запис дайджесту<br/>[agent.ts]"]
  node_digest_file["Файл дайджесту"]
end

node_user(("Користувач"))
node_groq["Groq модель"]
node_hn_api["HN Search API"]

node_user -->|"передає задачу"| node_cli
node_cli -->|"запускає"| node_harness
node_cli -->|"передає конфігурацію"| node_news_agent
node_harness -->|"запитує модель"| node_groq
node_harness -->|"виконує tools"| node_news_agent
node_news_agent -->|"виконує пошук"| node_search
node_news_agent -->|"читає коментарі"| node_discussion
node_search -->|"запитує stories"| node_hn_api
node_discussion -->|"запитує item"| node_hn_api
node_news_agent -->|"завантажує контекст"| node_context_loader
node_context_loader -->|"читає"| node_project_guidance
node_context_loader -->|"читає правила"| node_rules
node_news_agent -->|"отримує каталог"| node_skill_catalog
node_skill_catalog -->|"завантажує skill"| node_digest_skill
node_news_agent -->|"перевіряє дозвіл"| node_settings
node_news_agent -->|"маршрутизує saveDigest"| node_digest_writer
node_digest_writer -->|"записує"| node_digest_file

click node_cli "https://github.com/genkovich/harness-workshop/blob/main/src/main.ts"
click node_harness "https://github.com/genkovich/harness-workshop/blob/main/src/harness.ts"
click node_news_agent "https://github.com/genkovich/harness-workshop/blob/main/src/news/agent.ts"
click node_search "https://github.com/genkovich/harness-workshop/blob/main/src/news/api.ts"
click node_discussion "https://github.com/genkovich/harness-workshop/blob/main/src/news/api.ts"
click node_context_loader "https://github.com/genkovich/harness-workshop/blob/main/src/context.ts"
click node_project_guidance "https://github.com/genkovich/harness-workshop/blob/main/AGENTS.md"
click node_rules "https://github.com/genkovich/harness-workshop/tree/main/rules"
click node_skill_catalog "https://github.com/genkovich/harness-workshop/blob/main/src/skills.ts"
click node_digest_skill "https://github.com/genkovich/harness-workshop/blob/main/skills/digest/SKILL.md"
click node_settings "https://github.com/genkovich/harness-workshop/blob/main/src/settings.ts"
click node_digest_writer "https://github.com/genkovich/harness-workshop/blob/main/src/news/agent.ts"

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_harness toneBlue
class node_news_agent,node_search,node_discussion toneAmber
class node_context_loader,node_project_guidance,node_rules,node_skill_catalog,node_digest_skill,node_settings,node_hn_api toneMint
class node_digest_writer,node_digest_file toneRose
class node_user,node_groq toneIndigo
```

## Components

### Виконання агента

- [CLI точка входу](https://github.com/genkovich/harness-workshop/blob/main/src/main.ts): `src/main.ts`
- [Цикл harness](https://github.com/genkovich/harness-workshop/blob/main/src/harness.ts): `src/harness.ts`

### Дослідження HN

- [Агент новин](https://github.com/genkovich/harness-workshop/blob/main/src/news/agent.ts): `src/news/agent.ts`
- [Пошук stories](https://github.com/genkovich/harness-workshop/blob/main/src/news/api.ts): `src/news/api.ts`
- [Читання обговорення](https://github.com/genkovich/harness-workshop/blob/main/src/news/api.ts): `src/news/api.ts`

### Контекст і дозволи

- [Збір контексту](https://github.com/genkovich/harness-workshop/blob/main/src/context.ts): `src/context.ts`
- [Інструкції проєкту](https://github.com/genkovich/harness-workshop/blob/main/AGENTS.md): `AGENTS.md`
- [Правила проєкту](https://github.com/genkovich/harness-workshop/tree/main/rules): `rules`
- [Каталог skills](https://github.com/genkovich/harness-workshop/blob/main/src/skills.ts): `src/skills.ts`
- [Skill digest](https://github.com/genkovich/harness-workshop/blob/main/skills/digest/SKILL.md): `skills/digest/SKILL.md`
- [Дозвіл на запис](https://github.com/genkovich/harness-workshop/blob/main/src/settings.ts): `src/settings.ts`

### Результати

- [Запис дайджесту](https://github.com/genkovich/harness-workshop/blob/main/src/news/agent.ts): `src/news/agent.ts`
- **Файл дайджесту**

### Other components

- **Користувач**
- **Groq модель**
- **HN Search API**

## Connections

- Користувач → CLI точка входу: передає задачу (evidence: `src/main.ts`)
- CLI точка входу → Цикл harness: запускає (evidence: `src/main.ts`)
- CLI точка входу → Агент новин: передає конфігурацію (evidence: `src/main.ts`)
- Цикл harness → Groq модель: запитує модель (evidence: `src/harness.ts`)
- Цикл harness → Агент новин: виконує tools (evidence: `src/harness.ts`)
- Агент новин → Пошук stories: виконує пошук (evidence: `src/news/agent.ts`)
- Агент новин → Читання обговорення: читає коментарі (evidence: `src/news/agent.ts`)
- Пошук stories → HN Search API: запитує stories (evidence: `src/news/api.ts`)
- Читання обговорення → HN Search API: запитує item (evidence: `src/news/api.ts`)
- Агент новин → Збір контексту: завантажує контекст (evidence: `src/news/agent.ts`)
- Збір контексту → Інструкції проєкту: читає (evidence: `src/context.ts`)
- Збір контексту → Правила проєкту: читає правила (evidence: `src/context.ts`)
- Агент новин → Каталог skills: отримує каталог (evidence: `src/news/agent.ts`)
- Каталог skills → Skill digest: завантажує skill (evidence: `src/skills.ts`)
- Агент новин → Дозвіл на запис: перевіряє дозвіл (evidence: `src/news/agent.ts`)
- Агент новин → Запис дайджесту: маршрутизує saveDigest (evidence: `src/news/agent.ts`)
- Запис дайджесту → Файл дайджесту: записує (evidence: `src/news/agent.ts`)
