How abdshaat/farik works
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: orchestrator.rs Work Orchestrator · contract.rs Task Contracts · tools.rs Governed Agent Tools · lib.rs Farik CLI
Components 19
Human Interface
- Farik CLI
crates/cli/src/lib.rs - Repository Setup
crates/cli/src/init.rs
Planning and Governance
- Request Intake
crates/cli/src/task.rs - Triage and Planning
crates/runtime/src/tools/contracts.rs - Task Contracts
crates/core/src/contract.rs - Governance Rules
crates/core/src/governor/gates.rs - Team and Roles
crates/core/src/team.rs - Independent Review
crates/runtime/src/orchestrator/verify.rs
Agent Runtime
- Work Orchestrator
crates/runtime/src/orchestrator.rs - Agent Sessions
crates/runtime/src/orchestrator/session.rs - Governed Agent Tools
crates/runtime/src/tools.rs - Local Tool Daemon
crates/runtime/src/daemon.rs - Task Sandbox
crates/runtime/src/sandbox.rs
Project State
- Commands and Events
crates/protocol/src/event.rs - Append-only Audit Log
crates/store/src/event_log.rs - Contracts and Project Files
crates/store/src/files.rs - Board Projections
crates/store/src/projections.rs
Other components
- Human
- Claude Code
Connections 23
- Human → Farik CLI: issues requests
README.md - Farik CLI → Repository Setup: initializes repository
README.md - Repository Setup → Contracts and Project Files: writes project setup
- Farik CLI → Request Intake: files tasks
README.md - Request Intake → Triage and Planning: routes for triage
README.md - Triage and Planning → Task Contracts: prepares contracts
README.md - Triage and Planning → Team and Roles: assigns roles
- Task Contracts → Governance Rules: constrains decisions
README.md - Work Orchestrator → Agent Sessions: starts sessions
crates/runtime/src/orchestrator.rs - Agent Sessions → Claude Code: runs agent
README.md - Agent Sessions → Local Tool Daemon: registers sessions
crates/runtime/src/orchestrator/session.rs - Claude Code → Governed Agent Tools: calls tools
README.md - Local Tool Daemon → Governed Agent Tools: serves MCP tools
crates/runtime/src/daemon.rs - Governed Agent Tools → Governance Rules: checks permissions
- Work Orchestrator → Task Sandbox: creates work sandboxes
crates/runtime/src/orchestrator.rs - Work Orchestrator → Independent Review: runs verification
README.md - Independent Review → Task Contracts: checks criteria
README.md - Work Orchestrator → Board Projections: reads task board
crates/runtime/src/orchestrator.rs - Governed Agent Tools → Append-only Audit Log: records tool events
README.md - Work Orchestrator → Commands and Events: handles commands
crates/runtime/src/orchestrator.rs - Append-only Audit Log → Board Projections: builds views
crates/store/src/projections.rs - Task Contracts → Contracts and Project Files: persists contracts
README.md - Independent Review → Human: escalates decisions
README.md