AgenticSEO

QA gate

The code checks and AI editor review every draft must pass before it can be published, and what happens when it fails.

The QA gate decides whether a draft may go live. It runs code checks (reading grade, em dashes, banned phrases, keyword placement, TL;DR, images, alt text, CTA, links and more) and an AI editor review that scores 8 areas out of 40. A draft passes only with no critical fail, a total score at or above your minimum (default 32), and no area below 3. A fail goes back to the writer, up to 3 times by default, then the ticket moves to Needs human.

Code checks

Code checks are measured, not guessed. Critical checks fail the draft on their own. Warnings go to the writer as advice.

Check Rule Critical
Reading level Flesch-Kincaid grade at or below Max reading grade Yes
No em dashes No em or en dashes (when Fail drafts with em dashes is on) Yes
No AI-slop phrases None of your Banned words and phrases Yes
Keyword in title Title contains the primary keyword (kept title on a refresh with search traffic) Yes, for new titles
Title leads with the keyword Keyword near the start, title 65 characters or fewer Yes
Keyword in meta title and description Both contain the keyword Yes
TL;DR near the top A TL;DR section at the top Yes
Enough depth At least Min words Yes
Images At least Min images Yes, when screenshots are set up
Image alt text Every image has useful alt text Yes
Call to action Links to one of your CTA URLs Yes
No placeholder links No dummy links Yes
No placeholder text No "[insert ...]" style text Yes
One domain for internal links Internal links use one host Yes
Privacy and data claims link to your docs Claims link to your Documentation pages Yes
Product numbers match the approved facts Prices and limits appear in Approved product facts Yes
Uses an approved product screenshot Product articles use an image from the Image library Yes, when the library has images
No overlap with existing pages A new article does not target the keyword of an existing page Yes
Internal links work Up to 25 internal links are opened. Broken links fail Yes
Keyword in first 100 words Primary keyword early No
FAQ section An FAQ heading No
Scannable headings 3 or more H2 headings No
No extra H1 The body has no H1 No
Internal links 2 or more internal links No
Long sentences, Short paragraphs, Varied paragraph starts, Each section answers first Readability No
Meta title, Meta description Length limits No

AI editor review

An AI editor reads the brief (the contract), the draft, the code check results, your business profile and your live product pages. It scores 8 areas from 0 to 5:

Area What it judges
intent Matches the search intent and answers fast
structure TL;DR, answer-first block, headings, useful FAQ
voice Simple words, short paragraphs, no AI filler or hype
seo Keyword placement, headings, internal links, meta
accuracy Product facts match the approved facts
sources Third-party claims are fair or linked
assets Images, alt text, schema, CTA
readiness Clean Markdown, no placeholders

Any claim about your business that is not in the approved facts is a critical fail. The editor also compares your approved facts with your live product pages. If they disagree on prices, limits or plans, it fails the draft and tells you to update the approved facts in Settings.

Things only a person can do go into Manual follow-ups. They never block publishing.

Pass rule

PASS = no critical fail
   AND total score >= Min QA score (default 32 of 40)
   AND no area below 3

What happens on a fail

  1. The writer gets the draft and the required fixes and writes a new version.
  2. QA checks the new version.
  3. This repeats up to Max rewrites before a human looks (default 3), so up to 4 drafts in total.
  4. If the last draft fails, the ticket moves to Needs human with a message such as "QA failed 4 times (last score 28/40). Read the QA report, add a lesson, and retry."

Fix a Needs human ticket

  1. Open the ticket and read the QA report: critical fails, required fixes and area scores.
  2. Decide the cause. Often it is a missing product fact, a missing CTA, or a rule that is too strict for this topic.
  3. Fix the cause: update Settings > Business profile, add a lesson in Teach the agents, or edit the brief.
  4. Click Rewrite and QA again. Or, if you only changed settings, click Run QA again to check the current draft without a rewrite.

Settings

Open Settings > QA rules.

Setting What it does Default
Max reading grade Flesch-Kincaid grade limit (3 to 16) 7
Min QA score (of 40) Lowest passing total 32
Max rewrites before a human looks Rewrites after the first draft (0 to 10) 3
Min words Shortest allowed article 900
Min images Fewest images 1
Fail drafts with em dashes Turns the em dash check on On

Banned phrases, approved facts, prohibited claims and documentation pages live in Settings > Business profile.

Tip: Click Check facts against my website in the Business profile card. It compares your approved facts with your live pricing and documentation pages. Outdated facts give wrong articles.

Previous
Writer
Next
Publishing

Did this page help? Tell us at support@agenticseo.com.