# salomonhotegni/ghw-awesome-agents architecture

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

- Interactive diagram: https://gitdiagram.com/salomonhotegni/ghw-awesome-agents
- Repository: https://github.com/salomonhotegni/ghw-awesome-agents

## Overview

This repository is a collection of independently usable agent projects, pinned as submodules, rather than one shared runtime. Users choose an agent and provide a claim, diff, terminal request, or chat input; each project produces its own report, command, memory-aware reply, or approval-gated action. The README documents the major agent capabilities, while the sampled source confirms TruthTrace’s five-step flow and Sidekick’s chat behavior. Most agent implementations are unsampled, so their internal links reflect documented workflows only.

Main entry points: [`agents/workflow-challenge/truthtrace.py`](https://github.com/salomonhotegni/ghw-awesome-agents/blob/main/agents/workflow-challenge/truthtrace.py) (TruthTrace Workflow), [`agents`](https://github.com/salomonhotegni/ghw-awesome-agents/tree/main/agents) (Agent Projects), [`agents/long-term-memory-agent`](https://github.com/salomonhotegni/ghw-awesome-agents/tree/main/agents/long-term-memory-agent) (Memory Agent), [`agents/final-boss`](https://github.com/salomonhotegni/ghw-awesome-agents/tree/main/agents/final-boss) (LabCouncil)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_collection["Agent Collection"]
  node_catalog["Agent Projects"]
end

subgraph group_research["Research Agents"]
  node_labcouncil["LabCouncil"]
  node_specialists["Five Specialists"]
  node_experiment["Reviewed Plan"]
  node_truthtrace["TruthTrace Workflow<br/>[truthtrace.py]"]
  node_claim["Claim Extraction<br/>[truthtrace.py]"]
  node_investigation["Evidence Investigation<br/>[truthtrace.py]"]
  node_crosscheck["Source Cross-check<br/>[truthtrace.py]"]
  node_verdict["Verdict Validation<br/>[truthtrace.py]"]
  node_report["Fact-check Report<br/>[truthtrace.py]"]
end

subgraph group_developer["Developer Tools"]
  node_githelper["Git Helper"]
  node_gitdiff["Local Git Diff"]
  node_commitpr["Commit and PR Text"]
  node_terminal["Terminal AI Helper"]
  node_command["Reviewed Command"]
end

subgraph group_personal["Personal Agents"]
  node_memory["Memory Agent"]
  node_sqlite[("SQLite Memory")]
  node_reply["Personalized Reply"]
  node_approval["Human-in-the-Loop"]
  node_action["Sensitive Action"]
  node_sidekick["Sidekick Chat<br/>[sidekick.py]"]
  node_assistantstate["Assistant State<br/>[sidekick.json]"]
end

node_user(("User"))
node_backboard["Backboard API"]
node_shell["Local Shell"]
node_human(("Approver"))

node_user -->|"chooses project"| node_catalog
node_catalog -->|"offers"| node_labcouncil
node_catalog -->|"offers"| node_githelper
node_catalog -->|"offers"| node_terminal
node_catalog -->|"offers"| node_memory
node_catalog -->|"offers"| node_approval
node_user -->|"submits claim"| node_truthtrace
node_truthtrace -->|"extracts"| node_claim
node_truthtrace -->|"investigates"| node_investigation
node_truthtrace -->|"cross-checks"| node_crosscheck
node_truthtrace -->|"validates"| node_verdict
node_truthtrace -->|"generates"| node_report
node_truthtrace -->|"sends workflow"| node_backboard
node_user -->|"submits research idea"| node_labcouncil
node_labcouncil -->|"coordinates"| node_specialists
node_labcouncil -->|"produces"| node_experiment
node_user -->|"provides diff"| node_gitdiff
node_githelper -->|"generates"| node_commitpr
node_githelper -.->|"optionally refines"| node_backboard
node_user -->|"requests command"| node_terminal
node_terminal -->|"requests command"| node_backboard
node_terminal -->|"reviews and gates"| node_command
node_command -->|"runs after approval"| node_shell
node_user -->|"shares preference"| node_memory
node_memory -->|"stores and reloads"| node_sqlite
node_memory -->|"requests reply"| node_backboard
node_memory -->|"personalizes"| node_reply
node_user -->|"requests action"| node_approval
node_approval -->|"requests approval"| node_human
node_approval -->|"gates action"| node_action
node_user -->|"chats"| node_sidekick
node_sidekick -->|"loads and saves"| node_assistantstate
node_sidekick -->|"sends messages"| node_backboard

click node_catalog "https://github.com/salomonhotegni/ghw-awesome-agents/tree/main/agents"
click node_labcouncil "https://github.com/salomonhotegni/ghw-awesome-agents/tree/main/agents/final-boss"
click node_specialists "https://github.com/salomonhotegni/ghw-awesome-agents/tree/main/agents/final-boss"
click node_experiment "https://github.com/salomonhotegni/ghw-awesome-agents/tree/main/agents/final-boss"
click node_truthtrace "https://github.com/salomonhotegni/ghw-awesome-agents/blob/main/agents/workflow-challenge/truthtrace.py"
click node_claim "https://github.com/salomonhotegni/ghw-awesome-agents/blob/main/agents/workflow-challenge/truthtrace.py"
click node_investigation "https://github.com/salomonhotegni/ghw-awesome-agents/blob/main/agents/workflow-challenge/truthtrace.py"
click node_crosscheck "https://github.com/salomonhotegni/ghw-awesome-agents/blob/main/agents/workflow-challenge/truthtrace.py"
click node_verdict "https://github.com/salomonhotegni/ghw-awesome-agents/blob/main/agents/workflow-challenge/truthtrace.py"
click node_report "https://github.com/salomonhotegni/ghw-awesome-agents/blob/main/agents/workflow-challenge/truthtrace.py"
click node_githelper "https://github.com/salomonhotegni/ghw-awesome-agents/tree/main/agents/git-helper-agent"
click node_gitdiff "https://github.com/salomonhotegni/ghw-awesome-agents/tree/main/agents/git-helper-agent"
click node_commitpr "https://github.com/salomonhotegni/ghw-awesome-agents/tree/main/agents/git-helper-agent"
click node_terminal "https://github.com/salomonhotegni/ghw-awesome-agents/tree/main/agents/terminal-ai-helper"
click node_command "https://github.com/salomonhotegni/ghw-awesome-agents/tree/main/agents/terminal-ai-helper"
click node_memory "https://github.com/salomonhotegni/ghw-awesome-agents/tree/main/agents/long-term-memory-agent"
click node_sqlite "https://github.com/salomonhotegni/ghw-awesome-agents/tree/main/agents/long-term-memory-agent"
click node_reply "https://github.com/salomonhotegni/ghw-awesome-agents/tree/main/agents/long-term-memory-agent"
click node_approval "https://github.com/salomonhotegni/ghw-awesome-agents/tree/main/agents/human-in-the-loop-agent"
click node_action "https://github.com/salomonhotegni/ghw-awesome-agents/tree/main/agents/human-in-the-loop-agent"
click node_sidekick "https://github.com/salomonhotegni/ghw-awesome-agents/blob/main/agents/my-first-agent/sidekick.py"
click node_assistantstate "https://github.com/salomonhotegni/ghw-awesome-agents/blob/main/agents/my-first-agent/sidekick.json"

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_catalog,node_user toneBlue
class node_labcouncil,node_specialists,node_experiment,node_truthtrace,node_claim,node_investigation,node_crosscheck,node_verdict,node_report toneAmber
class node_githelper,node_gitdiff,node_commitpr,node_terminal,node_command,node_backboard toneMint
class node_memory,node_sqlite,node_reply,node_approval,node_action,node_sidekick,node_assistantstate toneRose
class node_shell,node_human toneIndigo
```

## Components

### Agent Collection

- [Agent Projects](https://github.com/salomonhotegni/ghw-awesome-agents/tree/main/agents): `agents`

### Research Agents

- [LabCouncil](https://github.com/salomonhotegni/ghw-awesome-agents/tree/main/agents/final-boss): `agents/final-boss`
- [Five Specialists](https://github.com/salomonhotegni/ghw-awesome-agents/tree/main/agents/final-boss): `agents/final-boss`
- [Reviewed Plan](https://github.com/salomonhotegni/ghw-awesome-agents/tree/main/agents/final-boss): `agents/final-boss`
- [TruthTrace Workflow](https://github.com/salomonhotegni/ghw-awesome-agents/blob/main/agents/workflow-challenge/truthtrace.py): `agents/workflow-challenge/truthtrace.py`
- [Claim Extraction](https://github.com/salomonhotegni/ghw-awesome-agents/blob/main/agents/workflow-challenge/truthtrace.py): `agents/workflow-challenge/truthtrace.py`
- [Evidence Investigation](https://github.com/salomonhotegni/ghw-awesome-agents/blob/main/agents/workflow-challenge/truthtrace.py): `agents/workflow-challenge/truthtrace.py`
- [Source Cross-check](https://github.com/salomonhotegni/ghw-awesome-agents/blob/main/agents/workflow-challenge/truthtrace.py): `agents/workflow-challenge/truthtrace.py`
- [Verdict Validation](https://github.com/salomonhotegni/ghw-awesome-agents/blob/main/agents/workflow-challenge/truthtrace.py): `agents/workflow-challenge/truthtrace.py`
- [Fact-check Report](https://github.com/salomonhotegni/ghw-awesome-agents/blob/main/agents/workflow-challenge/truthtrace.py): `agents/workflow-challenge/truthtrace.py`

### Developer Tools

- [Git Helper](https://github.com/salomonhotegni/ghw-awesome-agents/tree/main/agents/git-helper-agent): `agents/git-helper-agent`
- [Local Git Diff](https://github.com/salomonhotegni/ghw-awesome-agents/tree/main/agents/git-helper-agent): `agents/git-helper-agent`
- [Commit and PR Text](https://github.com/salomonhotegni/ghw-awesome-agents/tree/main/agents/git-helper-agent): `agents/git-helper-agent`
- [Terminal AI Helper](https://github.com/salomonhotegni/ghw-awesome-agents/tree/main/agents/terminal-ai-helper): `agents/terminal-ai-helper`
- [Reviewed Command](https://github.com/salomonhotegni/ghw-awesome-agents/tree/main/agents/terminal-ai-helper): `agents/terminal-ai-helper`

### Personal Agents

- [Memory Agent](https://github.com/salomonhotegni/ghw-awesome-agents/tree/main/agents/long-term-memory-agent): `agents/long-term-memory-agent`
- [SQLite Memory](https://github.com/salomonhotegni/ghw-awesome-agents/tree/main/agents/long-term-memory-agent): `agents/long-term-memory-agent`
- [Personalized Reply](https://github.com/salomonhotegni/ghw-awesome-agents/tree/main/agents/long-term-memory-agent): `agents/long-term-memory-agent`
- [Human-in-the-Loop](https://github.com/salomonhotegni/ghw-awesome-agents/tree/main/agents/human-in-the-loop-agent): `agents/human-in-the-loop-agent`
- [Sensitive Action](https://github.com/salomonhotegni/ghw-awesome-agents/tree/main/agents/human-in-the-loop-agent): `agents/human-in-the-loop-agent`
- [Sidekick Chat](https://github.com/salomonhotegni/ghw-awesome-agents/blob/main/agents/my-first-agent/sidekick.py): `agents/my-first-agent/sidekick.py`
- [Assistant State](https://github.com/salomonhotegni/ghw-awesome-agents/blob/main/agents/my-first-agent/sidekick.json): `agents/my-first-agent/sidekick.json`

### Other components

- **User**
- **Backboard API**
- **Local Shell**
- **Approver**

## Connections

- User → Agent Projects: chooses project (evidence: `README.md`)
- Agent Projects → LabCouncil: offers (evidence: `README.md`)
- Agent Projects → Git Helper: offers (evidence: `README.md`)
- Agent Projects → Terminal AI Helper: offers (evidence: `README.md`)
- Agent Projects → Memory Agent: offers (evidence: `README.md`)
- Agent Projects → Human-in-the-Loop: offers (evidence: `README.md`)
- User → TruthTrace Workflow: submits claim (evidence: `agents/workflow-challenge/truthtrace.py`)
- TruthTrace Workflow → Claim Extraction: extracts (evidence: `agents/workflow-challenge/truthtrace.py`)
- TruthTrace Workflow → Evidence Investigation: investigates (evidence: `agents/workflow-challenge/truthtrace.py`)
- TruthTrace Workflow → Source Cross-check: cross-checks (evidence: `agents/workflow-challenge/truthtrace.py`)
- TruthTrace Workflow → Verdict Validation: validates (evidence: `agents/workflow-challenge/truthtrace.py`)
- TruthTrace Workflow → Fact-check Report: generates (evidence: `agents/workflow-challenge/truthtrace.py`)
- TruthTrace Workflow → Backboard API: sends workflow (evidence: `agents/workflow-challenge/truthtrace.py`)
- User → LabCouncil: submits research idea (evidence: `README.md`)
- LabCouncil → Five Specialists: coordinates (evidence: `README.md`)
- LabCouncil → Reviewed Plan: produces (evidence: `README.md`)
- User → Local Git Diff: provides diff (evidence: `README.md`)
- Git Helper → Commit and PR Text: generates (evidence: `README.md`)
- Git Helper → Backboard API: optionally refines (evidence: `README.md`)
- User → Terminal AI Helper: requests command (evidence: `README.md`)
- Terminal AI Helper → Backboard API: requests command (evidence: `README.md`)
- Terminal AI Helper → Reviewed Command: reviews and gates (evidence: `README.md`)
- Reviewed Command → Local Shell: runs after approval (evidence: `README.md`)
- User → Memory Agent: shares preference (evidence: `README.md`)
- Memory Agent → SQLite Memory: stores and reloads (evidence: `README.md`)
- Memory Agent → Backboard API: requests reply (evidence: `README.md`)
- Memory Agent → Personalized Reply: personalizes (evidence: `README.md`)
- User → Human-in-the-Loop: requests action (evidence: `README.md`)
- Human-in-the-Loop → Approver: requests approval (evidence: `README.md`)
- Human-in-the-Loop → Sensitive Action: gates action (evidence: `README.md`)
- User → Sidekick Chat: chats (evidence: `agents/my-first-agent/sidekick.py`)
- Sidekick Chat → Assistant State: loads and saves (evidence: `agents/my-first-agent/sidekick.py`)
- Sidekick Chat → Backboard API: sends messages (evidence: `agents/my-first-agent/sidekick.py`)