Jul 22, 2026 · by Edward Yi · View source

AgentLoop

Starts a fresh Codex worker and critic every cycle

AgentLoop

Editorial analysis

Why This Matters to a Cross-Border Seller

Every serious operator I know has reached the same bottleneck: you feed an AI a prompt, get a decent draft, then spend longer editing it than it took to generate. Multiply that across a hundred product listings, a dozen ad variations, and a weekly cycle of A+ content refreshes, and you’re back to manual labor—just with a slightly faster typing partner. The problem isn’t the AI’s ability to produce; it’s the lack of a trusted, automated quality loop that catches mistakes before they ship. AgentLoop, an open-source tool launched on Product Hunt by solo developer Edward Yi, addresses exactly that relay problem for code. But the architecture—a fresh worker paired with an independent critic, an observable dashboard, and a rubric-driven finish line—is a blueprint that cross-border sellers should steal immediately, not for writing code, but for the content and automation workflows that drive their revenue.

What Problem the Product Actually Solves

AgentLoop solves the “relay problem” that surfaces when you try to use AI for anything more than a one-shot prompt. Edward Yi describes it bluntly: “I kept becoming the relay between ChatGPT and Codex: plan, paste, inspect, return feedback, repeat. Quality slipped as soon as I stopped watching.” Any seller who has used ChatGPT to write a product description, then pasted it into a listing builder, then manually checked for keyword stuffing or compliance violations, then tweaked the prompt, then repeated—you know the feeling. The friction isn’t the generation; it’s the inspection and feedback loop.

AgentLoop automates that relay by running an observable cycle: a fresh Codex worker (the AI coder) receives a goal and a rubric file (GUIDELINES.md), produces code, then a separate fresh critic evaluates the output against that rubric and writes a concrete fix note for the next worker. The project files carry memory through a STATE.md that the worker rewrites each cycle, while the critic stays stateless—it never reads the previous critic’s notes, only the rubric and the actual files. This prevents the “context rot” that plagues long-running AI chats, where the model starts agreeing with its own earlier mistakes.

For the cross-border operator, the relevant pattern is separate quality assurance from generation. Most sellers use a single AI session for both. AgentLoop’s insight is that the same model that wrote the draft should not also grade it. A fresh, context-free reviewer—even if it’s the same AI model—catches defects the original writer overlooked. In the Product Hunt discussion, Edward notes that during an evaluation, the critic found a “real mixed percent-decoding defect” that the first worker missed, even though the worker had produced nine passing tests. That’s the equivalent of a listing that looks perfect but has a compliance error that only a second pass catches.

The product also introduces an observable dashboard where each cycle is watchable and cancellable. For sellers, this maps to visibility into your automation pipeline: you see which step failed, why, and you can intervene without losing all progress. The tool is open source and zero-dependency Node.js, meaning it can be embedded into custom automation tooling or run locally with minimal setup.

How It Differs from Existing Options

The obvious comparison is to using ChatGPT directly or a managed AI content tool like Jasper or Copy.ai. Those tools generate content in one shot or with a simple refinement loop, but they don’t have an independent critic architecture. You are the critic. You read the output, you decide what’s wrong, you tweak the prompt, and you rerun. That’s the “relay” that Edward escaped.

Another comparison is to Helium 10 or Jungle Scout for Amazon sellers—these are more about data and keyword research than content generation. They lack any automated iterative improvement loop. AgentLoop’s pattern of a rubric file (GUIDELINES.md) that the critic checks is conceptually similar to the editing guidelines you write for a human copywriter, but here it’s automated and runs every cycle.

Then there are CI/CD tools for code, like GitHub Actions or CircleCI, which run tests after changes. But those test for correctness, not for subjective quality. AgentLoop’s critic checks against a rubric that you define—it’s testing for compliance with your standards, not just for whether the code compiles. For a seller, that means you could define a rubric for a product description that includes: “contains 5 keywords,” “US English spelling,” “avoid superlatives that violate Amazon’s guidelines,” “include a bullet point about sizing.” The critic then enforces those rules automatically.

Where AgentLoop falls short versus these options is that it’s designed for code generation, not content. The output is code files, not text. To apply it to product descriptions, you would need to treat the description as a code artifact—write it in a text file, have the worker generate it, and have the critic check a rubric of your quirks. That’s doable, but it requires a non-trivial integration step. Existing content tools are plug-and-play for text. AgentLoop is a pattern you have to adapt.

What Cross-Border Sellers Can Borrow from It

The Rubric-First Mindset

The single most transferable idea from AgentLoop is the notion of a rubric file that defines success before any generation starts. Edward’s GUIDELINES.md is a checklist that both the worker and the critic use. The worker tries to satisfy it; the critic grades against it. If a listing generation tool had such a rubric, you could stop manually checking for “price not mentioned” or “brand name absence” or “missing shipping policy.” The rubric encodes your business rules.

Sellers should start writing a GUIDELINES.md for their own content. It doesn’t require code. You can create a markdown file with items like:

  • Title includes primary keyword.
  • Bullet points are 3–5, each with a benefit.
  • No pricing information in bullet points (Amazon compliance).
  • Tone matches brand voice (professional, friendly, etc.).
  • At least one mention of warranty or guarantee.

Then, when you use any AI tool, you paste that rubric into the prompt and ask the model to self-evaluate before outputting. That’s a manual version of AgentLoop’s critic. The next step is to automate that grading using a script or no-code tool (e.g., Zapier with OpenAI) that checks each output against the rubric and sends back a revision request—effectively a fresh critic cycle.

The Fresh Critic Principle

The debate about critic flip-flop in the Product Hunt comments is instructive. Edward addresses the risk that the same code passes one cycle and fails the next because a new critic has no memory of prior evaluations. His solution: “the fix line only lives one cycle. The next critic is a fresh session, it reads PLAN.md, GUIDELINES.md and the actual files, never what the last critic said.” This design intentionally avoids the circular trust that can happen when an AI begins to accept its own earlier output.

For sellers, this means don’t let the same AI session evaluate its own past work if you’re running multiple refinement cycles. If you ask ChatGPT to “improve this description” and it sees its own earlier version, it may be biased toward what it wrote. Better to use a separate AI call with no memory of the previous iteration, just the latest text and the rubric. That’s the fresh critic principle.

Observable Automation

AgentLoop’s dashboard shows every cycle in real time and allows cancellation. For automation in e-commerce, visibility is the difference between trusting a tool and babysitting it. When you automate listing generation or ad copy updates, you need to see what the AI did, why it made a change, and be able to abort without losing all prior work. Most sellers use black-box tools; AgentLoop shows that even an AI automation tool can be transparent.

Build a simple logging system for your AI workflows. For each automated task, log the input, the output, and the rubric pass/fail. If you use Zapier or Make, add a step that writes to a Google Sheet the raw output and a column for manual review. That’s your observable dashboard.

Where It Falls Short

AgentLoop is a developer tool, not a no-code SaaS. It requires Node.js, a terminal, and familiarity with editing configuration files. For a seller who doesn’t code, the barrier to entry is high. Edward is explicit: it’s open source, zero-dependency Node.js. You need to run it locally or on a server. There is no GUI for writing rubrics or viewing results (the dashboard is a local web UI, but you still need to install it).

The critic is only as good as the rubric. As Edward admits in a comment, “The critic only grades what’s written in GUIDELINES.md, so rubric-clean but wrong gets a pass.” If your rubric misses a compliance rule—say Amazon’s prohibition on “best” in a category that has a strict policy—the critic will approve a violation. The product has a “polish mode” that uses leftover cycles to ask an open-ended “highest-impact improvement” question, but that still can’t catch everything.

There is no rollback on cancellation. As Edward explains: “No rollback, partial edits stay where the worker left them. Cancel ends the whole loop too, not just the cycle.” That’s acceptable for code (you use git), but for content, losing half a listing could be costly. Sellers need a safety net that AgentLoop doesn’t provide out of the box.

The flip-flop risk is mitigated but not eliminated. While Edward’s architecture prevents the critic from reversing earlier passes, a new critic could still “fail” correct code if the rubric is ambiguous. He notes, “Objective GUIDELINES items are the only thing holding that line, and if the rubric is loose your two-pass rule is probably the right call.” For sellers, this means you must invest in writing precise rubrics—otherwise the loop wastes cycles.

Why Amazon Sellers Should Care More Than Shopify Ones

Amazon’s ecosystem has stricter content rules than Shopify. Amazon enforces guidelines on capitalization, forbidden words (e.g., “guaranteed” without a vendor code), and specific formatting for bullet points. The cost of a compliance violation is a suppressed listing or account suspension. A critic loop that automatically checks these rules before submission could save hours of manual QA and reduce risk. Shopify sellers have more freedom; a minor formatting error usually doesn’t trigger an enforcement action. Therefore, the ROI of implementing an AgentLoop-like rubric is higher for Amazon sellers.

Where the Math Breaks

The cost of each cycle includes API calls to OpenAI (or other LLMs). AgentLoop uses Codex CLI with GPT-5.6, which is a paid API. For a seller running hundreds of listings, each cycle could consume tokens for both the worker and the critic. If you set maxCycles to 10 by default, a single listing could cost several cents in API fees. That’s acceptable for high-margin products, but for low-cost items (e.g., under $10 selling price), the automation cost might exceed the margin gain. Sellers should calculate total cost per completed listing versus manual editing time before committing to a loop.

What I’d Watch / Test Next

I’m not going to install AgentLoop and run it on product descriptions tomorrow. But I will test its core pattern in a low-code environment. Here’s my concrete plan for this week:

  1. Write a GUIDELINES.md for one product category—say, kitchen gadgets on Amazon. Include items like: “Bullet points must start with a capital letter,” “No claims of ‘best’ or ‘#1’,” “Include dimensions in inches,” “Avoid the word ‘unique’.” Put this in a markdown file.

  2. Use a tool like Airtable + OpenAI API via Make to simulate the loop. Create a base with one record per product. Each record has a “description” field (initial AI-generated). Then run a Make scenario that takes that text, sends it to the OpenAI API with a prompt: “Critique the following description against this rubric: [paste GUIDELINES.md]. Output either PASS or FAIL with a fix note. If FAIL, generate a revised description.” Then update the record and loop. Limit to three cycles. Log each version.

  3. Observe the dashboard—in this case, the Airtable audit log. See if the critic catches issues I missed manually. Check if the loop converges on a PASS quickly or flip-flops.

  4. Compare the final output against a description I wrote manually. Measure time spent and conversion rate (using historical or estimated A/B test data if available).

If the test shows that an automated critic loop reduces errors and saves time, I’ll invest in a more permanent integration, possibly using a lightweight Node.js server running AgentLoop in a container, adapted to handle text files instead of code. The key is the pattern, not the tool.

Cross-border e-commerce is an industry of thin margins and fierce competition. The difference between a 3% conversion rate and a 4% can be the quality of your product copy. Tools like AgentLoop prove that we don’t have to choose between speed and quality—we just need to separate the generator from the grader.

Ready to Create Your Own?

Join thousands of brands creating high-performing video ads with VEONIB. No editing skills required.

Start Creating for Free