Skip to main content

Agent lanes

This page is for integrators and advanced adopters examining execution visibility. Read Commissaire first for the broader responsibility boundary. Use the CLI reference to inspect the commands that enforce individual checks.

faff operates across three executor lanes with controlled visibility:

LaneRoleSeesDoesn't see
OrchestratorPipeline sequencing, external interface (tracker, human, reporting)Tracker, docs, codebase (read)
ImplementorArchitecture, spec interpretation, code, testsCodebase (read/write), specTracker, human dialogue
Evaluator (L4, lights-out)Quality control from business-value perspectiveSpec, running environmentCodebase

Isolation is by design — the implementor can't mark its own homework, and the evaluator can't be biased by implementation approach. The evaluator lane is the L4 lights-out lane: it runs under faff lights-out, where the code-blind holdout evaluator judges the work against a spec it never saw and its verdict gates the merge — though today "a spec it never saw" is an attested (compliance) property, not a physically enforced one: the evaluator currently runs inline and can read the repo. Not every enforcement leg is wired end-to-end yet — the evaluator-preflight assert-in is built but not yet called from the live holdout dispatch (see CLI reference) — but the lane ships and runs on the lights-out path.