<h1 align="center">Argus</h1>

<p align="center"> <strong>Enforce structure where it must hold. Reason only where it's needed.</strong> </p>

---

An agent skill (Claude, Hermes, etc.) that runs your repetitive workflows **predictably**, **traceably**, and **cost-efficiently** — cutting **~80%** of tokens usage while keeping full accuracy.


<p align="center"> <img alt="Tokens Saved" src="https://img.shields.io/badge/Tokens_Saved-80%25-brightgreen?style=for-the-badge"> <img alt="Consistency" src="https://img.shields.io/badge/Consistency-1.00-brightgreen?style=for-the-badge"> <img alt="Decision Accuracy" src="https://img.shields.io/badge/Decision_Accuracy-100%25-brightgreen?style=for-the-badge"> <img alt="Run Latency" src="https://img.shields.io/badge/Run_Latency-1.4x_faster-blue?style=for-the-badge"> </p> <p align="center">_{measured across 4 use cases · see <a href="#benchmark">Benchmark</a>}</p>

## Structured flow control **Replace guesswork with deterministic workflows**. Argus controls navigation, ensuring AI agents follow approved, and repeatable execution paths instead of reasoning through every step.

## Stateful memory context **Provide only the context that matters**. Argus tracks state changes and supplies the agent with the exact memory needed for the current step, improving reliability while reducing token usage.

---

## How it works

Argus ships **two skills** your agent loads:

| Skill | The user says… | The agent does… | |---|---|---| | **botcircuits-workflow-authoring** | _"create an order fulfillment workflow with …"_ | Writes the workflow JSON and **builds** it into a runnable state machine. | | **botcircuits-workflow-running** | _"run order fulfillment"_ | Runs the workflow — the **deterministic engine** drives navigation in the background and dispatches each action to the AI agent. |

---

## Installation

Argus runs inside a host agent. Install the agent you want, then instal