Skip to content

Nikoxx99/agentic-loop-en

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 

Repository files navigation

Agentic Loop

Quality loops for shipping with AI coding agents. Build with one model, review adversarially with a model from a different family, verify against a real runtime, and let the human gate only the irreversible steps.

Ship quality products · by running quality loops · by delegating as much as possible to agentic loops.

📖 Read the guide: QUALITY_LOOPS.md · 🌐 Web version: index.html (GitHub Pages once enabled)


What is an agentic quality loop?

A quality loop is a cycle where one model builds, a different-family model reviews it adversarially, a runtime gate verifies it against a real environment, and the human only steps in at the irreversible gates (production, money, destructive data, migrations).

Three things lift it above an ordinary AI code review:

  1. A reviewer of a different lineage — it doesn't share the builder's blind spots.
  2. Real runtime verificationdiff-correct ≠ works. A change can pass every review round and still fail against the real API/environment.
  3. Structured findings — data, not prose (--output-schema / --json-schema), so re-review with memory and PR synthesis are trivial.

The core mindset shift: stop prompting every step by hand and design the loop that prompts your agents.

Install the skill (Claude Code)

cp -r skills/agentic-loop ~/.claude/skills/

Then run /agentic-loop on a production-critical change in any project. The skill discovers the repo's verify command, diff base, and runtime target, then runs:

build → verify → adversarial review (Codex) → re-review with memory → runtime smoke → GO/NO-GO → ship

The agent decides GO; you hold the irreversible gate.

The 12 principles

  1. Delegate the "after". The value is automating what you do after prompting, not the prompt.
  2. Don't look at the code too early. Let another agent review it before you do.
  3. Two model families > one. The reviewer must be a different lineage than the builder.
  4. Diff-correct ≠ works. Always a real runtime gate.
  5. Findings as data, not prose. --output-schema / --json-schema.
  6. Dynamic shape, not a persona zoo. Let the problem dictate structure.
  7. Isolate (git worktrees) so loops don't collide.
  8. Confront, don't obey. Verify every finding against real code.
  9. Autonomy = reversibility, not confidence. Human gate only on the irreversible.
  10. Treat the limit as a challenge. Subscription pricing → loop hard; API pricing → measure first.
  11. Skill = method; automation = schedule. In that order.
  12. Aim at something that seems impossible. The wall is farther than you think.

Repository contents

Path What
skills/agentic-loop/SKILL.md The Claude Code skill (generic, self-contained).
QUALITY_LOOPS.md The essay / justification of the method.
index.html Human-readable field guide (web).

Why this works

The bottleneck in agent-assisted development isn't the model — it's the human orchestrating in the seams. A quality loop moves the human out of every reversible seam (verify, review, fix, re-review, integrate) and keeps them only where a mistake is irreversible. Autonomy scales with reversibility, not with model confidence.

References


Keywords: agentic loop, agentic loops, AI coding agents, adversarial code review, Claude Code skill, OpenAI Codex, autonomous coding, agentic workflows, runtime verification, ship quality software.

About

Agentic Loop — quality loops for shipping with AI coding agents. Build with one model, review adversarially with another, verify against a real runtime, gate only the irreversible. Claude Code skill + guide.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages