loop-review

Loop Review

Review N iterations -- read logs, inspect PRs and code, run external auditors, write a synthesis report with actionable findings.

Triggers

• loop review
• review the loop
• review iterations

---

Overview

Loop Review is a periodic quality audit of the KitchenLoop's recent output. It reads experience reports, inspects merged PRs and their code changes, optionally runs external auditors (Codex, Gemini), and produces a durable synthesis report with findings categorized by severity.

This phase runs every runtime.review_interval iterations automatically, or on demand.

---

Inputs

• Iteration range: Either specified explicitly ("review iterations 10-15") or inferred from loop state (last N iterations since the previous review).
• Configuration: kitchenloop.yaml -- paths, reviewers, repo, runtime.

---

Procedure

Step 1: Determine Scope

1. Load kitchenloop.yaml.
2. Read loop state at paths.loop_state to find:
   • The current iteration number.
   • The last iteration that was reviewed.
3. Determine the review range:
   • If called with explicit range (e.g., "iterations 10-15"), use that.
   • Otherwise, review from (last_reviewed + 1) to current iteration.
4. If the range is empty (no new iterations), report "Nothing to review" and exit.

Step 2: Gather Artifacts

For each iteration in the range, collect:

2a. Experience Reports

Read all reports matching {paths.reports}/experience-report-iter-{N}.md for each N in the range. Extract:

• Scenario description and tier
• Pass/fail status
• Friction log items (count and severity breakdown)

2b. Regression Results

Read loop state entries for each iteration's regression results:

• Pass rate trend
• Test count trend
• Any PAUSED or FLAGGED iterations

2c. PRs and Code Changes

List all PRs merged during the review period:

# Get merge commits in the date range
git log --merges --oneline --after="{start_date}" --before="{end_date}" {repo.base_branch}

# Or list PRs by merge date
gh pr list --state merged --limit 50 --json number,title,mergedAt,additions,deletions,files,body