$ About
What is Ferrus
Ferrus is a deterministic orchestrator for AI coding agents. It drives a Supervisor → Executor → Reviewer state machine so agents like Claude Code, Codex, and Qwen Code can carry out real software tasks through explicit, inspectable transitions instead of an open-ended chat.
Philosophy
Agents should be workers, not oracles.
Ferrus keeps all workflow state on disk in plain files — TASK.md, REVIEW.md, SUBMISSION.md — so humans and agents operate on the same source of truth. No hidden context, no implicit memory, no magic.
Why deterministic
Real software work needs repeatability.
Explicit state transitions, retries, and review cycles make execution auditable, resumable, and crash-safe. If a run is interrupted, the next invocation resumes exactly where the previous one stopped — because the state lives in .ferrus/, not in an agent's head.