Retornatus

Gates

Gates are mechanical brakes. Non-zero exit = STOP.

They do not replace judgment; they prevent pretending success when structure or proof is missing.

Gate catalog

CommandStops when
retornatus gate contract <C-id>No active Contract, empty WHAT, or no DONE criteria
retornatus gate skill-research <S-id>RESEARCH lacks sources / PROCEDURE blank
retornatus gate evidence <C-id>No Evidence artifacts for the Change
retornatus gate assurance <C-id>Assurance is not SATISFIED
retornatus gate policy <A-id>Policy is DENY or REQUIRE_HUMAN
retornatus verify <C-id>Same family as assurance over Contract DONE Claims

Related:

retornatus policy check --action <A-id>
retornatus policy check --effect "…"
retornatus run <A-id> --strict-policy

Assurance verdicts

VerdictMeaning
SATISFIEDEach required Claim has bound, fresh, type-appropriate Evidence
NOT_SATISFIEDEvidence exists but wrong claim/subject/type or stale
INCONCLUSIVERequired Evidence missing or unbound

> Agent conclusion ≠ Evidence. A green test suite is evidence of tests — not automatic proof of every Claim unless bound correctly.

Process vs brakes

Process (hub skill)Brakes (gates)
Who checksAgent follows the skillCLI exit codes
Incomplete workAgent should stopAgent cannot claim success via gate
Best forLearning the methodTeams that need proof between approvals

Governed bypass

Some gates can be skipped only as a recorded decision, e.g.:

retornatus skill activate S-0001 --force --reason "Emergency hotfix; research deferred"

Bypass without reason/authority is rejected. See Governance.

Guarantees (product level)

GuaranteeMechanism
Contract before buildgate contract + Situation sufficiency
Research before specialized executiongate skill-research
Evidence before doneClaim-bound Evidence + verify
Continuity after crashCanonical files + wake
No silent Rule authorityHuman Decision required
Policy visibilitygate policy / --strict-policy
← Docs hub Product site →