AgentOps Philosophy
July 15, 2026 ยท View on GitHub
AI agents are stochastic authors. Tests can establish deterministic facts, but they do not judge every semantic claim, and an author should not certify its own work. AgentOps therefore provides a small evidence protocol:
intent -> one bounded experiment -> exact subject identity
-> fresh independent judgment -> durable verdict
The protocol is behavior-first. Plan expresses one behavior as normal and edge
Given/When/Then scenarios, non-goals, write scope, and required evidence.
Implement performs one bounded RED-to-GREEN-to-refactor experiment. Validate
binds criterion-level judgment to a deterministic content manifest and stores
the result as verdict.v2. RPI invokes those responsibilities once and stops.
This is a trust floor, not a workflow engine. AgentOps does not own retries, budgets, queues, claims, leases, Git, CI, closure, release, or delivery. A FAIL is evidence for the caller, not permission for AgentOps to repair or continue.
Learn remains an optional, off-path hypothesis: collections of verdicts may reveal repeated defect classes worth turning into guidance or deterministic checks. Promotion is deliberate and evidence-backed; it never changes the validity of the candidate that produced the observation.
The product remains portable. Its core contracts operate in a non-Git
directory without the ao binary. The CLI supplies repository utilities and
ordinary deterministic checks. Optional councils, genies, runtimes, trackers,
and software-factory adapters can consume the protocol without becoming its
authority.