foreman

What it is

Foreman is a Python asyncio runtime that sits above Codex or OpenCode workers. It takes a free-form software job and independently assesses whether the implementation is complete, tests are sufficient, verification is needed, or a human is required.

How it uses Jev

Jev assesses ten dimensions: implementation_complete, tests_sufficient, requirements_satisfied, needs_verification, ready_to_finish, meaningful_progress, worker_stuck, work_off_track, agents_md_drift, needs_human. Each is a Noul question sent in one request. Probabilities are validated, normalized, stored in state.json, and used by a deterministic Python policy to decide actions like CONTINUE, START_VERIFIER, STEER_WORKER, STOP_WORKER, FINISH, or ESCALATE.

Primitives:noul

Technique worth stealing

Use a fast decision model to independently supervise slow generative workers without interrupting their loop.

Try it

FOREMAN_WORKER_BACKEND=opencode foreman run --repo ./my-project --job "Add request retries"

View on GitHub