SystemsPlaybook

Self-Reviewing Agentic Workflows: Designing Pipelines Non-Technical Teams Trust

How to replace fragile single-shot prompts with four-stage self-checking workflows: deterministic Python pre-gates, narrow drafting nodes, cross-family critics, and SHA-verified audit receipts.

Give one model a twelve-rule prompt and ask it to research, write, format, and self-grade in a single pass. It will follow nine rules, drop three, and tell you it nailed all twelve.

Self-reviewing workflows fix that by separating the builder from the inspector, using four tight stages and a hard retry cap instead of five chat agents arguing in an open loop.

Stage 1: Clean intake and pinned source IDs

Python code checks the input file first. Before any model runs, the script strips extra noise and tags every source paragraph with a fixed ID, so later code checks can verify in one millisecond whether a cited paragraph actually exists.

Stage 2: Narrow drafting steps

Each step does one job. One node pulls dates and dollar amounts into JSON, while the next writes the customer note from that verified record. Narrow steps let you run fast, cheap models on routine work and save heavy models for hard calls.

Stage 3: Code hooks first, second-family critic next

Never pay an LLM to count words or check JSON keys. Fast Python hooks run first, and in my own pipelines 30+ hook gates catch structural bugs right away at zero token cost.

Once code checks pass, a critic model from a separate vendor grades the draft against a yes/no checklist. Say Claude wrote the draft. Gemini or Llama checks it cold. When the critic spots a miss, it sends back the exact broken rule for one repair pass, and a second miss halts the item for human review.

Stage 4: Replayable SHA-256 receipts

Ops leaders trust what they can inspect. Every run logs the input hash, model version, hook results, critic scores, and final diff into a single .jsonl receipt, so when someone asks why an item shipped last Thursday, you open that file and replay every step in two seconds.

You can read runnable code in my self-reviewing workflow demo or request a free custom 4-stage prototype built around your stack.

Frequently asked questions

Why shouldn't the same LLM review its own output?

Models share blindspots with their own weights and training style. When a model grades its own draft, it routinely overlooks hallucinations and rubric misses that a separate model family catches right away.

How many retry loops should a self-reviewing workflow allow?

Cap automated repair loops at one or two retries with structured defect feedback. Beyond two retries, models often game the rubric or degrade good sections, so unresolved items should fail closed to a human queue.

How do non-technical teams monitor multi-agent workflows?

Plain status dashboards backed by JSONL audit receipts show pass rates, blocked items, token cost per item, and clean side-by-side diffs whenever human approval is needed.

Runnable harnesses & proofs