From 995a820adce371be4ea109bf11130f4f3f3d12ab Mon Sep 17 00:00:00 2001 From: Wilson Freitas Date: Sun, 16 Aug 2026 07:49:02 -0300 Subject: [PATCH] docs: clarify commercial eligibility verdicts --- .agents/skills/bprr/SKILL.md | 12 +++++++----- .agents/skills/sprr/SKILL.md | 19 +++++++++++-------- AGENTS.md | 10 ++++++++-- CONTRIBUTING.md | 20 ++++++++++++-------- 4 files changed, 38 insertions(+), 23 deletions(-) diff --git a/.agents/skills/bprr/SKILL.md b/.agents/skills/bprr/SKILL.md index 8c50a46..9e56e62 100644 --- a/.agents/skills/bprr/SKILL.md +++ b/.agents/skills/bprr/SKILL.md @@ -62,8 +62,9 @@ For each added entry, check: - Hosted proprietary products without substantive public source belong under `Commercial & Proprietary Services`, even when a thin repository exists. - For repository-less commercial entries, verify a useful permanent free tier for quantitative - finance that requires no payment information and is not a trial, demo, or waitlist. Treat a - hosted service with only a thin repository as repository-less for this check. + finance that requires no payment information and is not a trial, demo, or waitlist. +- Treat a commercial service with only a thin SDK, integration, examples, generated-data, or + marketing repository as repository-less for every eligibility check. - Verify that these commercial entries publish pricing and free-tier limits plus public documentation, methodology, or usage examples; use a stable HTTPS URL without affiliate or tracking parameters; and have a concise, factual, non-promotional description. @@ -76,9 +77,10 @@ For each added entry, check: Apply verdict rules independently to every PR: -- `REJECT` paid-only proprietary submissions without substantive public source. -- Use `NEEDS CHANGES` for correctable disclosure, wording, placement, URL, or documentation - problems. +- Commercial submissions without a qualifying permanent free tier—including paid-only, + trial-only, demo-only, and waitlist-only offerings—are `REJECT`. +- Reserve `NEEDS CHANGES` for correctable evidence or disclosure, wording, URL, documentation, or + placement defects when the underlying offering can qualify. ## Summary Output diff --git a/.agents/skills/sprr/SKILL.md b/.agents/skills/sprr/SKILL.md index a112c7d..20d20b4 100644 --- a/.agents/skills/sprr/SKILL.md +++ b/.agents/skills/sprr/SKILL.md @@ -48,8 +48,8 @@ queued or pending attempt supersedes an older successful attempt for the same SH CI never replaces inspection of the diff or the manual checks below. A successful check confirms only mechanical rules; it does not establish tag meaning or concision, description quality, relevance, semantic section suitability, commercial classification, repository quality, -commercial free-tier eligibility or transparency, URL tracking, cross-PR uniqueness, or multi- -project relatedness. CI cannot establish any of these manual criteria. Search open PRs and PRs +commercial free-tier eligibility or transparency, URL tracking, cross-PR uniqueness, or +multi-project relatedness. CI cannot establish any of these manual criteria. Search open PRs and PRs closed within the last 365 days for duplicate names and URLs. ## Validation Checklist @@ -71,8 +71,9 @@ For every added entry: - Hosted proprietary products without substantive public source are under `Commercial & Proprietary Services`, even when a thin repository exists. - For repository-less commercial entries, verify a useful permanent free tier for quantitative - finance that requires no payment information and is not a trial, demo, or waitlist. Treat a - hosted service with only a thin repository as repository-less for this check. + finance that requires no payment information and is not a trial, demo, or waitlist. +- Treat a commercial service with only a thin SDK, integration, examples, generated-data, or + marketing repository as repository-less for every eligibility check. - Verify that these commercial entries publish pricing and free-tier limits plus public documentation, methodology, or usage examples; use a stable HTTPS URL without affiliate or tracking parameters; and have a concise, factual, non-promotional description. @@ -89,10 +90,12 @@ For every added entry: Use these verdicts: - `APPROVE`: entry is ready to merge. -- `NEEDS CHANGES`: fixable format, disclosure, wording, placement, URL, or documentation issue. -- `REJECT`: paid-only proprietary submission without substantive public source, duplicate, - unrelated multi-project PR, empty PR description, archived/abandoned project, or other hard - rejection. +- Commercial submissions without a qualifying permanent free tier—including paid-only, + trial-only, demo-only, and waitlist-only offerings—are `REJECT`. +- Reserve `NEEDS CHANGES` for correctable evidence or disclosure, wording, URL, documentation, or + placement defects when the underlying offering can qualify. +- Other `REJECT` cases include duplicates, unrelated multi-project PRs, empty PR descriptions, + archived or abandoned projects, and other hard rejections. ## Output Shape diff --git a/AGENTS.md b/AGENTS.md index 4f5e1cb..dbc73d6 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -65,13 +65,15 @@ Rules: - Descriptions must end with a period before the optional `[GitHub](...)` link. - URLs in new entries must use `https://`. - A valid GitHub repository used as the main URL or exact `[GitHub](...)` suffix is preferred - and is a strong positive relevance signal, but it is not universally required. Functional- + and is a strong positive relevance signal, but it is not universally required. Functional section placement requires a repository containing substantive implementation; a thin SDK, integration, examples, generated-data, or marketing repository does not qualify. - Hosted commercial/proprietary products without substantive public source belong in `## Commercial & Proprietary Services`, even when a thin repository exists. Repository-less services qualify only under the permanent free tier and transparency rules in `CONTRIBUTING.md`. +- Treat a commercial service with only a thin SDK, integration, examples, generated-data, or + marketing repository as repository-less for every eligibility check. - Backtick tags are optional only for commercial services and other metadata-free sections such as `Related Lists`. - Use `CONTRIBUTING.md` as the user-facing source for contribution rules. @@ -98,7 +100,11 @@ Review requirements: 6. Manually assess commercial entries for free-tier usefulness, payment information, public pricing and limits, public documentation/methodology/examples, stable non-tracking URLs, concise factual description tone, and repository substance. -7. Use the `reviewed` label only after the user approves a review comment. +7. Commercial submissions without a qualifying permanent free tier—including paid-only, + trial-only, demo-only, and waitlist-only offerings—are `REJECT`. Reserve `NEEDS CHANGES` for + correctable evidence or disclosure, wording, URL, documentation, or placement defects when + the underlying offering can qualify. +8. Use the `reviewed` label only after the user approves a review comment. ## GitHub MCP Tools diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 6f19efb..d728b73 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -89,19 +89,23 @@ proprietary project without such a repository qualifies only when it has a meani free tier that provides useful quantitative-finance functionality without requiring payment information. Trials, demos, waitlists, and paid-only products do not qualify. -Repository-less commercial services must publish pricing and free-tier limits, as well as public -documentation, methodology, or usage examples. Their entries must use a stable HTTPS URL without -affiliate or tracking parameters, have a concise, factual, non-promotional description, and be -placed in the **Commercial & Proprietary Services** section. Backtick tags are optional in that -section. For example: +Commercial services without substantive public source—including those with only a thin SDK, +integration, examples, generated-data, or marketing repository—are repository-less for every +eligibility check. They must publish pricing and free-tier limits, as well as public documentation, +methodology, or usage examples. Their entries must use a stable HTTPS URL without affiliate or +tracking parameters, have a concise, factual, non-promotional description, and be placed in the +**Commercial & Proprietary Services** section. Backtick tags are optional in that section. For +example: ```markdown - [Project Name](https://project.example) - Concise factual description ending with a period. ``` -A thin SDK, integration, examples, generated-data, or marketing repository does not make the -hosted product open source; only a repository containing substantive implementation supports -placement in a functional section. +Only a repository containing substantive implementation supports placement in a functional +section. Commercial submissions without a qualifying permanent free tier—including paid-only, +trial-only, demo-only, and waitlist-only offerings—are `REJECT`. Reserve `NEEDS CHANGES` for +correctable evidence or disclosure, wording, URL, documentation, or placement defects when the +underlying offering can qualify. ## Section Placement