Purpose
Use these rules when an AI workflow directory receives a submission that might
be commercial, sponsored, affiliate-backed, vendor-authored, vendor-claimed, or
promotional. The goal is to keep ordinary editorial content review separate from
commercial placement and to make disclosure decisions before copy quality is
debated.
These rules do not decide whether a product is good. They decide which review
path a submission belongs in and what evidence must exist before it can appear
in a public directory.
Classification Rules
Classify the submission before editing prose.
- Editorial. A contributor independently documents a tool, workflow, rule,
guide, or directory entry without payment, affiliate benefit, vendor control,
or claimed ownership.
- Vendor-authored. The author works for, owns, maintains, represents, or is
formally connected to the listed product or service.
- Claimed. A vendor or maintainer asks to own or correct an existing entry.
- Sponsored. Placement, ordering, copy, links, or visibility are connected
to payment, campaign value, or a commercial arrangement.
- Affiliate or referral. A URL, coupon, invite code, tracking parameter, or
account-specific link can create attribution, compensation, credits, or lead
tracking.
- Thin promotion. The submission mostly repeats sales copy, superlatives,
launch language, pricing promises, or unsupported competitive claims.
When the classification is unclear, route the submission to maintainer review.
Do not merge it as ordinary editorial content while the relationship is unknown.
Routing Rules
- Route sponsored, affiliate, referral, claimed, and vendor-authored submissions
out of the free contributor queue.
- Keep commercial review maintainer-owned. Contributors can supply evidence, but
they should not decide paid placement, sponsorship labels, or affiliate terms.
- Reject affiliate and referral URLs in ordinary contributor PRs.
- Replace tracking URLs with canonical documentation, repository, package, or
product URLs before editorial review continues.
- Require disclosure text when the submitter has a vendor, sponsor, affiliate,
or ownership relationship.
- Do not accept a commercial submission that lacks public source evidence for
the claims it wants the directory to repeat.
Editorial Quality Rules
Ordinary editorial content should describe verifiable utility rather than sell.
Accept content that:
- cites canonical docs, repos, packages, policies, or product pages;
- explains concrete use cases, prerequisites, limits, safety notes, and privacy
notes;
- distinguishes open-source project code from hosted, paid, enterprise, or
managed offerings;
- states commercial status plainly without making the entry sound endorsed;
- removes tracking parameters, marketing campaign fragments, and unverifiable
rankings.
Request changes or reject content that:
- says a product is best, leading, official, trusted, secure, fastest, or most
popular without source-backed evidence;
- imports landing-page copy without adding directory-specific context;
- hides paid plans, hosted services, enterprise upsells, or vendor control when
they affect user expectations;
- uses affiliate links, invite links, coupon links, UTM-heavy links, or short
links as source URLs;
- asks the directory to publish private roadmap, sales, customer, or pricing
claims that users cannot verify.
Disclosure Rules
Commercial status should be visible to reviewers and users.
- Say when a listing is editorial and has no paid placement or affiliate link.
- Say when a product has open-source code plus hosted, commercial, enterprise,
marketplace, or paid support offerings.
- Say when a submission is vendor-authored, vendor-claimed, sponsored, or
affiliate-backed.
- Use sponsored or affiliate link attributes when a published outbound link is
commercial in that way.
- Keep disclosure close to the listing rather than hiding it only in PR comments
or internal notes.
Disclosure does not rescue thin content. A sponsored or vendor-authored entry
still needs source evidence, safety notes, privacy notes, and directory-specific
editorial value.
Reviewer Checklist
- {"task": "Relationship classified", "description": "The submitter relationship is editorial, vendor-authored, claimed, sponsored, affiliate, referral, or unknown"}
- {"task": "Correct route", "description": "Commercial or unclear submissions are routed to maintainer-owned review, not merged through the ordinary contributor queue"}
- {"task": "Canonical links", "description": "Source URLs are canonical and do not contain affiliate, referral, coupon, short-link, or campaign tracking parameters"}
- {"task": "Disclosure present", "description": "Paid placement, sponsorship, affiliate status, vendor authorship, or commercial ownership is disclosed where relevant"}
- {"task": "Claims verified", "description": "Feature, pricing, license, security, popularity, benchmark, and compatibility claims have public source evidence"}
- {"task": "Editorial value", "description": "The entry explains use case, prerequisites, limits, safety, and privacy instead of repeating promotional copy"}
Do Not Merge When
- the author relationship is unknown and may be commercial;
- the PR contains affiliate, referral, coupon, invite, short-link, or tracking
URLs in contributor content;
- a vendor-authored entry is presented as independent editorial review;
- sponsored placement is requested without maintainer-owned commercial review;
- public claims depend on private emails, sales decks, or unverified launch
language;
- generated text turns source facts into endorsements, rankings, or unsupported
comparative claims.
Troubleshooting
- The tool is useful but the PR is promotional: reroute it first, then ask
for source-backed, neutral copy.
- The contributor says there is no sponsorship: ask them to remove tracking
URLs and state whether they have a vendor, affiliate, or ownership
relationship.
- A vendor submits corrections to an existing entry: separate factual fixes
from placement, ordering, or promotional requests.
- A link looks canonical but includes parameters: remove UTM, referral,
coupon, invite, and partner parameters before using it as a source.
- A claim is plausible but unsourced: keep the neutral fact that can be
verified and drop the unsupported superlative.
Duplicate Check
Checked existing rules, guides, collections, tools, MCP entries, statuslines,
submission validators, and recent PRs for commercial routing rules, sponsored
directory submissions, affiliate link rejection, vendor-authored content,
promotional copy review, and disclosure policy.
Existing entries often include per-listing disclosure text such as "no paid
placement or affiliate link is used," and the submission pipeline rejects
affiliate/referral URLs. This rules entry is distinct because it gives portable
do/don't behavior for deciding whether a directory submission belongs in
ordinary editorial review, maintainer-owned commercial review, or rejection.
Spam-Policy Mapping
Google Search Central documents the spam policies below. Each names a pattern that commercial and promotional directory submissions commonly trigger, which is why routing happens before quality review. Definitions are quoted from Google's spam policies page.
| Google spam policy |
What Google says it covers (verbatim) |
| Thin affiliation |
"the practice of publishing content with product affiliate links where the product descriptions and reviews are copied directly from the original merchant without any original content or added value." |
| Link spam |
"the practice of creating links to or from a site primarily for the purpose of manipulating search rankings." |
| Scaled content abuse |
"when many pages are generated for the primary purpose of manipulating search rankings and not helping users." |
| Scraping |
"the practice of taking content from other sites, often through automated means, and hosting it with the purpose of manipulating search rankings." |
| Site reputation abuse |
"a tactic where third-party content is published on a host site mainly because of that host's already-established ranking signals." |
| User-generated spam |
"spammy content added to a site by users through a channel intended for user content." |
| Misleading functionality |
"intentionally creating sites that trick users into thinking they would be able to access some content or services but in reality can't." |
References