factory

Inspect or edit factory pipeline settings

Run an all-hands sweep (architecture/security/quality/implementation reviewers + orchestrator self-review + Codex if available) against the latest commit (or a chosen scope), then drive a reviewer ⇄ implementer loop until the reviewer is satisfied

Recover a stalled factory run (tasks stuck mid-stage, or recoverable drops to retry) and hand off to resume

Resume a paused/suspended factory run where it left off (re-check the quota gate, continue the loop)

Start a fresh factory autonomous coding pipeline run (PRD issue → task PRs → staging → develop)

Architectural-integrity lens of the risk-invariant panel: module boundaries, dependency direction, coupling, leaky abstractions, god objects, barrel-file abuse, and AI over-engineering. Runs in a fresh context; every finding quotes the offending import/edge. Emits a RawReview JSON.

Verifies the implementation satisfies the spec's intent, not merely that tests pass. A risk-invariant panel member; checks every acceptance criterion is genuinely addressed by tracing the end-to-end path through the diff. Emits a RawReview JSON.

Adversarial code-quality lens of the risk-invariant panel: logic errors, edge cases, error handling, test quality, and AI anti-patterns. Runs in a fresh context to avoid author-bias rubber-stamping. Codex is the preferred executor when available. Emits a RawReview JSON.

Read-only diagnostic agent that investigates ONE ambiguous dropped (dead-end) task in a factory pipeline run and returns a structured reset / leave-dropped recommendation. Reasons over the rescue scan line + ground truth (worktree, review files, CI logs); never writes state, never edits code, never runs git/gh/Bash. Its final message IS the decision JSON the orchestrator consumes.

Investigates and repairs git/GitHub drift for ONE stalled factory run before it is resumed — branch missing/behind, PR/state mismatch, develop advanced past the run's staging branch. Performs ONLY forward-only, non-destructive fixes autonomously (fetch, forward-merge, re-push a missing branch); anything destructive (force, delete, discard) is SURFACED for the orchestrator to prompt, never executed. Its final message IS the reconciliation verdict JSON the orchestrator consumes.

Decompose a PRD into a structured spec — a markdown design doc plus a flat, risk-tiered, dependency-ordered task list of tracer-bullet vertical slices. Loaded by the factory spec-generator; the result is returned as one GenerateResult JSON (not written to disk). Use when breaking a PRD into an implementation plan or planning phases from a PRD.

(internal) Recover a factory pipeline run that `factory resume` cannot untangle — a crashed/suspended session left tasks STUCK mid-stage, or a terminal failed run has recoverable drops to retry. Resets the resettable tasks via `factory rescue apply`, reopens a terminal run, reconciles git/GitHub drift via the rescue-reconciler agent, then hands off to resume.

The factory's adversarial code-review output contract. Injects a paranoid, citation-first review posture and the single RawReview JSON shape every panel reviewer emits, which the factory CLI parses, citation-verifies, and folds into the risk-invariant merge gate.

Use when implementing any feature or bugfix, before writing implementation code

Runs an all-hands sweep (architecture + security + quality + implementation reviewers + orchestrator self-review + Codex if available) in parallel, addresses validated findings, then drives the iterative reviewer ⇄ implementer loop until clean. Used by /factory:debug.

9 hooks across 3 events