Operator Guide

June 8, 2026 ยท View on GitHub

Add New Work

  1. Copy factory/templates/spec.md into factory/specs/inbox/.
  2. Use grill-me before dispatch. Ask one question at a time and record decisions in # Grill Gate.
  3. Fill id, title, risk, grill, and verification.
  4. Run:
loop-factory scan
loop-factory dispatch --agent codex --stage

Run With Agent CLI

Codex:

loop-factory dispatch --agent codex --stage --execute

Claude:

loop-factory dispatch --agent claude --stage --execute

Review

loop-factory review lf-0001 --agent codex

Paste generated prompt into agent, or add --execute.

When reviewer says ACCEPTED:

loop-factory archive lf-0001 --accepted

Backpropagate Specs

After implementation changes:

loop-factory backprop --agent codex

Agent should update only stale specs/docs and leave open questions when implementation exposed a missing decision.

Schedule Loops

Claude Code:

/loop 15m check active specs, review ready work, and backpropagate changed specs

Codex app:

Create project automation that invokes $loop-factory and asks it to scan active specs, report blocked items, and review new evidence.

Built-In Loops

List available loops:

loop-factory loops list

Use one:

loop-factory loops prompt spec-grill-gate --agent claude
loop-factory loops prompt active-spec-verify --agent codex
loop-factory loops prompt ci-branch-green --agent codex --interval 5m

These loops are prompt templates with bounded iteration budgets, check commands, and exit conditions. They do not copy external loop text; they encode Loop Factory's own spec, review, archive, and backprop workflow.