# deepklarity/harness-kit architecture

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

- Interactive diagram: https://gitdiagram.com/deepklarity/harness-kit
- Repository: https://github.com/deepklarity/harness-kit

## Overview

Harness Kit combines Odin, a multi-agent orchestration CLI; Taskit, a task-board/API product with execution evidence and analytics; and a provider-quota CLI. The principal flow is spec planning into dependency-linked tasks, agent routing and sandboxed execution, then review/merge with results retained on the board. The README documents these product stages; sampled source confirms Odin’s orchestration/routing and the Taskit UI/service boundary. Backend and several capability details are represented at subsystem level because their implementation was not sampled.

Main entry points: [`odin/src/odin/orchestrator.py`](https://github.com/deepklarity/harness-kit/blob/main/odin/src/odin/orchestrator.py) (Spec orchestration), [`taskit/taskit-frontend/src/App.tsx`](https://github.com/deepklarity/harness-kit/blob/main/taskit/taskit-frontend/src/App.tsx) (Board dashboard), [`taskit/taskit-backend/tasks/models.py`](https://github.com/deepklarity/harness-kit/blob/main/taskit/taskit-backend/tasks/models.py) (Tasks and evidence), [`odin/src/odin/cli.py`](https://github.com/deepklarity/harness-kit/blob/main/odin/src/odin/cli.py) (Odin CLI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_odin["Odin orchestration"]
  node_odin_cli["Odin CLI<br/>[cli.py]"]
  node_config["Run configuration<br/>[config.py]"]
  node_orchestrator["Spec orchestration<br/>[orchestrator.py]"]
  node_routing["Agent routing<br/>[agent_routing.py]"]
  node_task_graph["Task graph<br/>[dag.py]"]
  node_worktree["Worktree sandbox<br/>[worktree.py]"]
  node_task_results["Task results<br/>[models.py]"]
  node_reflection["Review and reflection<br/>[reflection.py]"]
  node_cost["Cost tracking"]
end

subgraph group_taskit["Taskit board"]
  node_taskit_ui["Board dashboard<br/>[App.tsx]"]
  node_service["Dashboard API client"]
  node_task_api["Board API<br/>[views.py]"]
  node_task_models[("Tasks and evidence<br/>[models.py]")]
  node_dag_execution["Board execution<br/>[dag_executor.py]"]
  node_analytics["Agent analytics<br/>[agent_stats.py]"]
end

subgraph group_quota["Provider quotas"]
  node_quota_cli["Quota CLI<br/>[cli.py]"]
  node_quota_registry["Provider registry<br/>[registry.py]"]
  node_gemini_quota["Gemini quota<br/>[gemini.py]"]
end

subgraph group_runtime["Shared agent runtime"]
  node_harnesses["Agent harnesses"]
end

node_user(("Engineer"))
node_providers{{"AI providers"}}

node_user -->|"runs"| node_odin_cli
node_odin_cli -.->|"starts"| node_orchestrator
node_orchestrator -->|"uses settings"| node_config
node_orchestrator -->|"routes tasks"| node_routing
node_orchestrator -->|"decomposes work"| node_task_graph
node_orchestrator -->|"executes sandboxed"| node_worktree
node_orchestrator -->|"dispatches agents"| node_harnesses
node_harnesses -->|"invokes"| node_providers
node_orchestrator -->|"records results"| node_task_results
node_orchestrator -->|"reviews work"| node_reflection
node_orchestrator -->|"tracks spend"| node_cost
node_user -->|"uses board"| node_taskit_ui
node_taskit_ui -->|"calls"| node_service
node_service -->|"requests data"| node_task_api
node_task_api -.->|"reads and writes"| node_task_models
node_taskit_ui -->|"monitors runs"| node_dag_execution
node_dag_execution -.->|"updates task evidence"| node_task_models
node_task_models -->|"supplies outcomes"| node_analytics
node_analytics -->|"informs assignments"| node_routing
node_user -->|"checks quotas"| node_quota_cli
node_quota_cli -->|"selects provider"| node_quota_registry
node_quota_registry -->|"dispatches"| node_gemini_quota
node_gemini_quota -->|"queries quota API"| node_providers

click node_odin_cli "https://github.com/deepklarity/harness-kit/blob/main/odin/src/odin/cli.py"
click node_config "https://github.com/deepklarity/harness-kit/blob/main/odin/src/odin/config.py"
click node_orchestrator "https://github.com/deepklarity/harness-kit/blob/main/odin/src/odin/orchestrator.py"
click node_routing "https://github.com/deepklarity/harness-kit/blob/main/odin/src/odin/agent_routing.py"
click node_task_graph "https://github.com/deepklarity/harness-kit/blob/main/odin/src/odin/dag.py"
click node_worktree "https://github.com/deepklarity/harness-kit/blob/main/odin/src/odin/worktree.py"
click node_harnesses "https://github.com/deepklarity/harness-kit/tree/main/odin/src/odin/harnesses"
click node_task_results "https://github.com/deepklarity/harness-kit/blob/main/odin/src/odin/models.py"
click node_reflection "https://github.com/deepklarity/harness-kit/blob/main/odin/src/odin/reflection.py"
click node_cost "https://github.com/deepklarity/harness-kit/tree/main/odin/src/odin/cost_tracking"
click node_taskit_ui "https://github.com/deepklarity/harness-kit/blob/main/taskit/taskit-frontend/src/App.tsx"
click node_service "https://github.com/deepklarity/harness-kit/blob/main/taskit/taskit-frontend/src/services/harness/HarnessTimeService.ts"
click node_task_api "https://github.com/deepklarity/harness-kit/blob/main/taskit/taskit-backend/tasks/views.py"
click node_task_models "https://github.com/deepklarity/harness-kit/blob/main/taskit/taskit-backend/tasks/models.py"
click node_dag_execution "https://github.com/deepklarity/harness-kit/blob/main/taskit/taskit-backend/tasks/dag_executor.py"
click node_analytics "https://github.com/deepklarity/harness-kit/blob/main/taskit/taskit-backend/tasks/agent_stats.py"
click node_quota_cli "https://github.com/deepklarity/harness-kit/blob/main/harness_usage_status/src/harness_usage_status/cli.py"
click node_quota_registry "https://github.com/deepklarity/harness-kit/blob/main/harness_usage_status/src/harness_usage_status/providers/registry.py"
click node_gemini_quota "https://github.com/deepklarity/harness-kit/blob/main/harness_usage_status/src/harness_usage_status/providers/gemini.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_odin_cli,node_config,node_orchestrator,node_routing,node_task_graph,node_worktree,node_task_results,node_reflection,node_cost toneBlue
class node_taskit_ui,node_service,node_task_api,node_task_models,node_dag_execution,node_analytics toneAmber
class node_quota_cli,node_quota_registry,node_gemini_quota toneMint
class node_harnesses toneRose
class node_user,node_providers toneIndigo
```

## Components

### Odin orchestration

- [Odin CLI](https://github.com/deepklarity/harness-kit/blob/main/odin/src/odin/cli.py): `odin/src/odin/cli.py`
- [Run configuration](https://github.com/deepklarity/harness-kit/blob/main/odin/src/odin/config.py): `odin/src/odin/config.py`
- [Spec orchestration](https://github.com/deepklarity/harness-kit/blob/main/odin/src/odin/orchestrator.py): `odin/src/odin/orchestrator.py`
- [Agent routing](https://github.com/deepklarity/harness-kit/blob/main/odin/src/odin/agent_routing.py): `odin/src/odin/agent_routing.py`
- [Task graph](https://github.com/deepklarity/harness-kit/blob/main/odin/src/odin/dag.py): `odin/src/odin/dag.py`
- [Worktree sandbox](https://github.com/deepklarity/harness-kit/blob/main/odin/src/odin/worktree.py): `odin/src/odin/worktree.py`
- [Task results](https://github.com/deepklarity/harness-kit/blob/main/odin/src/odin/models.py): `odin/src/odin/models.py`
- [Review and reflection](https://github.com/deepklarity/harness-kit/blob/main/odin/src/odin/reflection.py): `odin/src/odin/reflection.py`
- [Cost tracking](https://github.com/deepklarity/harness-kit/tree/main/odin/src/odin/cost_tracking): `odin/src/odin/cost_tracking`

### Taskit board

- [Board dashboard](https://github.com/deepklarity/harness-kit/blob/main/taskit/taskit-frontend/src/App.tsx): `taskit/taskit-frontend/src/App.tsx`
- [Dashboard API client](https://github.com/deepklarity/harness-kit/blob/main/taskit/taskit-frontend/src/services/harness/HarnessTimeService.ts): `taskit/taskit-frontend/src/services/harness/HarnessTimeService.ts`
- [Board API](https://github.com/deepklarity/harness-kit/blob/main/taskit/taskit-backend/tasks/views.py): `taskit/taskit-backend/tasks/views.py`
- [Tasks and evidence](https://github.com/deepklarity/harness-kit/blob/main/taskit/taskit-backend/tasks/models.py): `taskit/taskit-backend/tasks/models.py`
- [Board execution](https://github.com/deepklarity/harness-kit/blob/main/taskit/taskit-backend/tasks/dag_executor.py): `taskit/taskit-backend/tasks/dag_executor.py`
- [Agent analytics](https://github.com/deepklarity/harness-kit/blob/main/taskit/taskit-backend/tasks/agent_stats.py): `taskit/taskit-backend/tasks/agent_stats.py`

### Provider quotas

- [Quota CLI](https://github.com/deepklarity/harness-kit/blob/main/harness_usage_status/src/harness_usage_status/cli.py): `harness_usage_status/src/harness_usage_status/cli.py`
- [Provider registry](https://github.com/deepklarity/harness-kit/blob/main/harness_usage_status/src/harness_usage_status/providers/registry.py): `harness_usage_status/src/harness_usage_status/providers/registry.py`
- [Gemini quota](https://github.com/deepklarity/harness-kit/blob/main/harness_usage_status/src/harness_usage_status/providers/gemini.py): `harness_usage_status/src/harness_usage_status/providers/gemini.py`

### Shared agent runtime

- [Agent harnesses](https://github.com/deepklarity/harness-kit/tree/main/odin/src/odin/harnesses): `odin/src/odin/harnesses`

### Other components

- **Engineer**
- **AI providers**

## Connections

- Engineer → Odin CLI: runs (evidence: `README.md`)
- Odin CLI → Spec orchestration: starts
- Spec orchestration → Run configuration: uses settings (evidence: `odin/src/odin/orchestrator.py`)
- Spec orchestration → Agent routing: routes tasks (evidence: `odin/src/odin/orchestrator.py`)
- Spec orchestration → Task graph: decomposes work (evidence: `README.md`)
- Spec orchestration → Worktree sandbox: executes sandboxed (evidence: `README.md`)
- Spec orchestration → Agent harnesses: dispatches agents (evidence: `README.md`)
- Agent harnesses → AI providers: invokes (evidence: `README.md`)
- Spec orchestration → Task results: records results (evidence: `odin/src/odin/orchestrator.py`)
- Spec orchestration → Review and reflection: reviews work (evidence: `README.md`)
- Spec orchestration → Cost tracking: tracks spend (evidence: `README.md`)
- Engineer → Board dashboard: uses board (evidence: `README.md`)
- Board dashboard → Dashboard API client: calls
- Dashboard API client → Board API: requests data (evidence: `README.md`)
- Board API → Tasks and evidence: reads and writes
- Board dashboard → Board execution: monitors runs (evidence: `README.md`)
- Board execution → Tasks and evidence: updates task evidence
- Tasks and evidence → Agent analytics: supplies outcomes (evidence: `taskit/taskit-backend/tasks/agent_stats.py`)
- Agent analytics → Agent routing: informs assignments (evidence: `README.md`)
- Engineer → Quota CLI: checks quotas (evidence: `harness_usage_status/src/harness_usage_status/cli.py`)
- Quota CLI → Provider registry: selects provider (evidence: `harness_usage_status/src/harness_usage_status/cli.py`)
- Provider registry → Gemini quota: dispatches (evidence: `harness_usage_status/src/harness_usage_status/providers/registry.py`)
- Gemini quota → AI providers: queries quota API (evidence: `harness_usage_status/src/harness_usage_status/providers/gemini.py`)
