Daniel Avila #643 Jun 21, 2026
  • builder-reviewer-loop.md 42 lines · 2.1 KB
builder-reviewer-loop.md

Builder–Reviewer Loop

Loop Engineering — separate the builder from the reviewer so the agent doesn't grade its own work. Code bounces between them until it genuinely passes.

🎯 Goal

Implement a change, then have an independent reviewer subagent critique it; iterate on the findings until the review is clean and tests are green.

⏱️ Schedule

Suggested interval: 15m (or run until done on a single feature).

▶️ Run it

/loop 15m "Implement the next slice of the feature. Then hand it to an independent reviewer subagent for an adversarial review. Address every blocking finding and re-run tests. Continue until the reviewer has no blocking findings and the suite passes."

🔁 Iteration steps

  1. Build — implement the next slice of work.
  2. Review — the architect-review agent inspects the diff for correctness, design and risk.
  3. Plan — collect blocking findings into a fix list.
  4. Act — address each finding; re-run the suite with test-runner.
  5. Observe — re-review with /pr-review; if blocking findings remain, loop again.

🛑 Stopping condition

Reviewer reports zero blocking findings and all tests pass.

🧩 Referenced components

  • agent:expert-advisors/architect-review — the independent reviewer (no self-grading).
  • agent:development-team/test-runner — runs the suite each pass.
  • command:git-workflow/pr-review — structured review checklist.

💡 Example

The builder ships a new caching layer; the reviewer flags a race condition and a missing eviction test. The loop fixes both, re-reviews, and exits clean.