factory-review

What this skill does

factory-review is the PR-review compliance engine of the software factory. It acts as the automated component of The Great Filter, reviewing Pull Requests against organizational policy-as-code (REVIEW.md) and babysitting agent-opened PRs until they are ready for merge.

It operates as a Kind-B control-plane skill integrated with the PR hosting provider (GitHub / GitLab) via the tracker-agnostic integration layer (factory-mission/references/tracker-integration.md).

In --self-heal mode, it enters a three-sub-agent converge loop mirroring factory-mission Phase 5's test/code/converge pattern. Three separate sub-agents — Review Agent (read-only), Fix Agent (writeable src/), Converge Agent (independent judge) — are dispatched per iteration via ADR-336 lanes, communicating only through the comment bus (ADR-330). The converge step returns DONE / CONTINUE / SPEC_CORRECTION_NEEDED, bounded by a circuit breaker and score-regression counter.

When to use

• Before any PR is merged, to run identical, consistent compliance checks.
• To have the agent automatically address reviewer comment threads and push fixes.
• To manage agent-opened PRs (sweeping unresolved threads, resolving failing tests) until they are ready for final sign-off.
• With --self-heal to proactively fix Important findings before a human reviews the PR.