# abdshaat/farik architecture

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

- Interactive diagram: https://gitdiagram.com/abdshaat/farik
- Repository: https://github.com/abdshaat/farik

## Overview

Farik is a local, governed harness for a multi-agent team working in one Git repository. The main workflow is request intake, contract preparation and approval, governed task execution, independent verification, and acceptance, with the CLI as the human interface and the daemon mediating agent tool calls. The README documents the product stages and audit guarantees; source-index references support several runtime connections. Some feature modules were not sampled, so those branches are shown at subsystem level and unverified links are omitted.

Main entry points: [`crates/runtime/src/orchestrator.rs`](https://github.com/abdshaat/farik/blob/main/crates/runtime/src/orchestrator.rs) (Work Orchestrator), [`crates/core/src/contract.rs`](https://github.com/abdshaat/farik/blob/main/crates/core/src/contract.rs) (Task Contracts), [`crates/runtime/src/tools.rs`](https://github.com/abdshaat/farik/blob/main/crates/runtime/src/tools.rs) (Governed Agent Tools), [`crates/cli/src/lib.rs`](https://github.com/abdshaat/farik/blob/main/crates/cli/src/lib.rs) (Farik CLI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Human Interface"]
  node_cli["Farik CLI<br/>[lib.rs]"]
  node_setup["Repository Setup<br/>[init.rs]"]
end

subgraph group_workflow["Planning and Governance"]
  node_intake["Request Intake<br/>[task.rs]"]
  node_triage["Triage and Planning<br/>[contracts.rs]"]
  node_contracts["Task Contracts<br/>[contract.rs]"]
  node_governor["Governance Rules<br/>[gates.rs]"]
  node_team["Team and Roles<br/>[team.rs]"]
  node_verification["Independent Review<br/>[verify.rs]"]
end

subgraph group_runtime["Agent Runtime"]
  node_orchestrator["Work Orchestrator<br/>[orchestrator.rs]"]
  node_session["Agent Sessions<br/>[session.rs]"]
  node_tools["Governed Agent Tools<br/>[tools.rs]"]
  node_daemon["Local Tool Daemon<br/>[daemon.rs]"]
  node_sandbox["Task Sandbox<br/>[sandbox.rs]"]
end

subgraph group_state["Project State"]
  node_protocol["Commands and Events<br/>[event.rs]"]
  node_eventlog[("Append-only Audit Log<br/>[event_log.rs]")]
  node_projectfiles[("Contracts and Project Files<br/>[files.rs]")]
  node_projections[("Board Projections<br/>[projections.rs]")]
end

node_human(("Human"))
node_provider["Claude Code"]

node_human -->|"issues requests"| node_cli
node_cli -->|"initializes repository"| node_setup
node_setup -.->|"writes project setup"| node_projectfiles
node_cli -->|"files tasks"| node_intake
node_intake -->|"routes for triage"| node_triage
node_triage -->|"prepares contracts"| node_contracts
node_triage -.->|"assigns roles"| node_team
node_contracts -->|"constrains decisions"| node_governor
node_orchestrator -->|"starts sessions"| node_session
node_session -->|"runs agent"| node_provider
node_session -.->|"registers sessions"| node_daemon
node_provider -->|"calls tools"| node_tools
node_daemon -->|"serves MCP tools"| node_tools
node_tools -->|"checks permissions"| node_governor
node_orchestrator -->|"creates work sandboxes"| node_sandbox
node_orchestrator -->|"runs verification"| node_verification
node_verification -->|"checks criteria"| node_contracts
node_orchestrator -->|"reads task board"| node_projections
node_tools -->|"records tool events"| node_eventlog
node_orchestrator -->|"handles commands"| node_protocol
node_eventlog -->|"builds views"| node_projections
node_contracts -->|"persists contracts"| node_projectfiles
node_verification -->|"escalates decisions"| node_human

click node_cli "https://github.com/abdshaat/farik/blob/main/crates/cli/src/lib.rs"
click node_setup "https://github.com/abdshaat/farik/blob/main/crates/cli/src/init.rs"
click node_intake "https://github.com/abdshaat/farik/blob/main/crates/cli/src/task.rs"
click node_triage "https://github.com/abdshaat/farik/blob/main/crates/runtime/src/tools/contracts.rs"
click node_contracts "https://github.com/abdshaat/farik/blob/main/crates/core/src/contract.rs"
click node_governor "https://github.com/abdshaat/farik/blob/main/crates/core/src/governor/gates.rs"
click node_team "https://github.com/abdshaat/farik/blob/main/crates/core/src/team.rs"
click node_orchestrator "https://github.com/abdshaat/farik/blob/main/crates/runtime/src/orchestrator.rs"
click node_session "https://github.com/abdshaat/farik/blob/main/crates/runtime/src/orchestrator/session.rs"
click node_tools "https://github.com/abdshaat/farik/blob/main/crates/runtime/src/tools.rs"
click node_daemon "https://github.com/abdshaat/farik/blob/main/crates/runtime/src/daemon.rs"
click node_sandbox "https://github.com/abdshaat/farik/blob/main/crates/runtime/src/sandbox.rs"
click node_verification "https://github.com/abdshaat/farik/blob/main/crates/runtime/src/orchestrator/verify.rs"
click node_protocol "https://github.com/abdshaat/farik/blob/main/crates/protocol/src/event.rs"
click node_eventlog "https://github.com/abdshaat/farik/blob/main/crates/store/src/event_log.rs"
click node_projectfiles "https://github.com/abdshaat/farik/blob/main/crates/store/src/files.rs"
click node_projections "https://github.com/abdshaat/farik/blob/main/crates/store/src/projections.rs"

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_setup toneBlue
class node_intake,node_triage,node_contracts,node_governor,node_team,node_verification toneAmber
class node_orchestrator,node_session,node_tools,node_daemon,node_sandbox toneMint
class node_protocol,node_eventlog,node_projectfiles,node_projections toneRose
class node_human,node_provider toneIndigo
```

## Components

### Human Interface

- [Farik CLI](https://github.com/abdshaat/farik/blob/main/crates/cli/src/lib.rs): `crates/cli/src/lib.rs`
- [Repository Setup](https://github.com/abdshaat/farik/blob/main/crates/cli/src/init.rs): `crates/cli/src/init.rs`

### Planning and Governance

- [Request Intake](https://github.com/abdshaat/farik/blob/main/crates/cli/src/task.rs): `crates/cli/src/task.rs`
- [Triage and Planning](https://github.com/abdshaat/farik/blob/main/crates/runtime/src/tools/contracts.rs): `crates/runtime/src/tools/contracts.rs`
- [Task Contracts](https://github.com/abdshaat/farik/blob/main/crates/core/src/contract.rs): `crates/core/src/contract.rs`
- [Governance Rules](https://github.com/abdshaat/farik/blob/main/crates/core/src/governor/gates.rs): `crates/core/src/governor/gates.rs`
- [Team and Roles](https://github.com/abdshaat/farik/blob/main/crates/core/src/team.rs): `crates/core/src/team.rs`
- [Independent Review](https://github.com/abdshaat/farik/blob/main/crates/runtime/src/orchestrator/verify.rs): `crates/runtime/src/orchestrator/verify.rs`

### Agent Runtime

- [Work Orchestrator](https://github.com/abdshaat/farik/blob/main/crates/runtime/src/orchestrator.rs): `crates/runtime/src/orchestrator.rs`
- [Agent Sessions](https://github.com/abdshaat/farik/blob/main/crates/runtime/src/orchestrator/session.rs): `crates/runtime/src/orchestrator/session.rs`
- [Governed Agent Tools](https://github.com/abdshaat/farik/blob/main/crates/runtime/src/tools.rs): `crates/runtime/src/tools.rs`
- [Local Tool Daemon](https://github.com/abdshaat/farik/blob/main/crates/runtime/src/daemon.rs): `crates/runtime/src/daemon.rs`
- [Task Sandbox](https://github.com/abdshaat/farik/blob/main/crates/runtime/src/sandbox.rs): `crates/runtime/src/sandbox.rs`

### Project State

- [Commands and Events](https://github.com/abdshaat/farik/blob/main/crates/protocol/src/event.rs): `crates/protocol/src/event.rs`
- [Append-only Audit Log](https://github.com/abdshaat/farik/blob/main/crates/store/src/event_log.rs): `crates/store/src/event_log.rs`
- [Contracts and Project Files](https://github.com/abdshaat/farik/blob/main/crates/store/src/files.rs): `crates/store/src/files.rs`
- [Board Projections](https://github.com/abdshaat/farik/blob/main/crates/store/src/projections.rs): `crates/store/src/projections.rs`

### Other components

- **Human**
- **Claude Code**

## Connections

- Human → Farik CLI: issues requests (evidence: `README.md`)
- Farik CLI → Repository Setup: initializes repository (evidence: `README.md`)
- Repository Setup → Contracts and Project Files: writes project setup
- Farik CLI → Request Intake: files tasks (evidence: `README.md`)
- Request Intake → Triage and Planning: routes for triage (evidence: `README.md`)
- Triage and Planning → Task Contracts: prepares contracts (evidence: `README.md`)
- Triage and Planning → Team and Roles: assigns roles
- Task Contracts → Governance Rules: constrains decisions (evidence: `README.md`)
- Work Orchestrator → Agent Sessions: starts sessions (evidence: `crates/runtime/src/orchestrator.rs`)
- Agent Sessions → Claude Code: runs agent (evidence: `README.md`)
- Agent Sessions → Local Tool Daemon: registers sessions (evidence: `crates/runtime/src/orchestrator/session.rs`)
- Claude Code → Governed Agent Tools: calls tools (evidence: `README.md`)
- Local Tool Daemon → Governed Agent Tools: serves MCP tools (evidence: `crates/runtime/src/daemon.rs`)
- Governed Agent Tools → Governance Rules: checks permissions
- Work Orchestrator → Task Sandbox: creates work sandboxes (evidence: `crates/runtime/src/orchestrator.rs`)
- Work Orchestrator → Independent Review: runs verification (evidence: `README.md`)
- Independent Review → Task Contracts: checks criteria (evidence: `README.md`)
- Work Orchestrator → Board Projections: reads task board (evidence: `crates/runtime/src/orchestrator.rs`)
- Governed Agent Tools → Append-only Audit Log: records tool events (evidence: `README.md`)
- Work Orchestrator → Commands and Events: handles commands (evidence: `crates/runtime/src/orchestrator.rs`)
- Append-only Audit Log → Board Projections: builds views (evidence: `crates/store/src/projections.rs`)
- Task Contracts → Contracts and Project Files: persists contracts (evidence: `README.md`)
- Independent Review → Human: escalates decisions (evidence: `README.md`)
