review-fix-loop

Runs bounded review, repair, and validation loops with a persisted controller.

2|Updated May 6, 2026
One-click install
npx skills add https://github.com/bpcakes/jig-skills --skill review-fix-loop-bpcakes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-fix-loop
Source: https://github.com/bpcakes/jig-skills/tree/main/plugins/jig-review/skills/review-fix-loop
Command: npx skills add https://github.com/bpcakes/jig-skills --skill review-fix-loop-bpcakes

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Review-and-fix requests often degrade into unbounded edit cycles with lost findings, unverified repairs, and no record of what was validated. This Skill drives a bounded, persisted loop where an executable controller owns round limits, provider attempts, validation, patch application, and terminal decisions, so every repair is evidence-backed and every outcome is recorded. ## Core Features & Use Cases - Controller-owned loop: A Node.js controller manages state, immutable assignments, round budgets (1-10), provider attempt caps, and terminal outcomes such as CONVERGED, BLOCKED, or VALIDATION_FAILED. - Isolated multi-provider review: Fresh isolated reviewers (native Codex or configured JSON adapters) receive only their assignment and a repository copy, with balanced or strict review policies. - Repair modes: Minimal, balanced, and comprehensive fix modes control investigation breadth while always requiring a causal repair at the responsible layer. - Journaled patch application: Repairs are captured as content-addressed candidates, applied with a recoverable journal, and validated with the repository's own checks; failed candidates remain visible without automatic rollback. - Use Case: Ask the agent to review and fix your working changes; it pins a task contract with acceptance criteria and validation commands, runs isolated reviews, repairs actionable findings, re-validates, and reports a terminal outcome with changed files and evidence. ## Quick Start Ask the agent to review and fix your current working changes, and it will initialize the controller, run the bounded repair loop, and report the terminal outcome with validation results.

Frequently Asked Questions about review-fix-loop

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run an automated review and fix loop on my code changes?

Authorize the loop with a request like "review and fix this", then the controller is initialized with a task contract defining acceptance criteria and validation commands. It runs isolated reviews, repairs actionable findings, validates, and re-reviews until a terminal outcome or the round limit.

What is the difference between balanced, minimal, and comprehensive fix modes?

All modes require a causal repair at the responsible layer; the mode controls investigation breadth. Minimal focuses on the reported mechanism, balanced expands when evidence crosses boundaries, and comprehensive actively investigates related entry points and recurrence risks.

Can I use Claude or other external reviewers with this loop?

Yes, external providers require a configured JSON command adapter that reads the assignment on stdin and emits one JSON result. Strict review policy requires two distinct providers, while balanced policy defaults to native Codex.

What happens when a repair fails validation?

Failed candidates remain visible in the checkout with their failure recorded; there is no automatic rollback. Recovery receives the patch and failure history and consumes another round, while uncertain executions stop without replay as BLOCKED or VALIDATION_FAILED.

What are the requirements and limitations of the review-fix-loop controller?

It requires Linux or macOS, Node 22+, and Git 2.42+, and refuses shallow repositories, Git replacement refs, grafts, nested repositories, and executable filter attributes. It never installs dependencies, and missing tools are blockers rather than skipped checks.