GH#34293: docs: keep Qlty on organisation repos and skip its out-of-minutes check

[marcusquinn]

What

Repository setup and management guidance now says what the merge tooling already does. On organisation (and private) repositories, Qlty's GitHub App runs out of minutes each month. The out-of-minutes "qlty check" is billing: skip it, keep the app, and never make it a required check.

• .agents/reference/ci-gate-policy.md rule 14: the minutes return monthly, so keep the app installed (not a reason to remove Qlty); never require "qlty check" on a limited repository; points to qlty.md.
• .agents/tools/code-review/qlty.md: Quick Reference bullet and a "GitHub App: monthly minutes" section for setup and management. It covers keeping the app, skipping the failure, never requiring it, real findings still counting, and the split between the app's check and CLI-based CI gates. It names the helpers that already skip it (gh-checks-wait-helper.sh apply_qlty_billing_policy, pulse-merge-required-checks.sh _pmrc_repo_has_qlty_credit_limit).
• .agents/tools/code-review/setup.md: Qlty row in the platform table, the rule in one line, and a troubleshooting row for "out of minutes".
• .agents/tools/wordpress/wp-plugin-new.md: an out-of-minutes qlty check still proves Qlty is connected; skip it, never remove Qlty.

Why: in an owner session, an agent read a red out-of-minutes qlty check as a reason to remove Qlty from an organisation. It edited four repositories' docs and asked the owner to uninstall the app, when the owner's policy is to keep it for the free monthly minutes. Merge-time behaviour was already right; only the setup guidance lacked it.

Verification

• npx markdownlint-cli2 on the four files: 0 issues.
• rg -n 'rule 14' .agents/tools/code-review/qlty.md .agents/tools/code-review/setup.md .agents/tools/wordpress/wp-plugin-new.md: a pointer in each.
• Docs only; no script behaviour changes.

Resolves #34293

---

aidevops.sh v3.39.1 plugin for OpenCode v1.18.35 with claude-opus-5-5

[coderabbitai]

Important

Review skipped

Auto reviews are limited based on label configuration.

🏷️ Required labels (at least one) (1)

---

🚫 Excluded labels (none allowed) (1)

• no-review

---

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

• Configuration used: Repository: marcusquinn/aidevops/.coderabbit.yaml
• Review profile: CHILL
• Plan: Advanced
• Run ID: b7224602-4694-48c5-b542-56c3771ebd83

---

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

---

_{Comment @coderabbitai help to get the list of available commands.}

[github-actions]

Markdown Lint (changed-line scoped)

No new violations in changed lines (0 pre-existing in touched files — ignored).

Metric	Base (038d414)	Head (b2926cf)
Total in touched files	—	0
New (in changed lines)	—	0

[codacy-production]

Up to standards ✅

🟢 Issues 0 issues

Results:
0 new issues

View in Codacy

_{NEW Get contextual insights on your PRs based on Codacy's metrics, along with PR and Jira context, without leaving GitHub. Enable AI reviewer
TIP This summary will be updated as you push new changes.}

[github-actions]

Shell Function Complexity Regression Gate

✅ No regression — no new function(s) >100 lines.

Metric	Base (038d414)	Head (b2926cf)
Total function(s) >100 lines	0	0

[github-actions]

Qlty Smell Regression Gate

✅ No change — smell count unchanged.

Metric	Base (038d414)	Head (b2926cf)	Delta
Total smells	65	65	+0

[github-actions]

🔍 Code Quality Report

�[0;35m[MONITOR]�[0m Code Review Monitoring Report

SonarCloud: 0 bugs, 0 vulnerabilities, 1 code smells

Sat Oct 10 22:58:46 UTC 2026: Code review monitoring started
Sat Oct 10 22:58:47 UTC 2026: SonarCloud - Bugs: 0, Vulnerabilities: 0, Code Smells: 1
Sat Oct 10 23:01:17 UTC 2026: Codacy analysis completed - no issues

📈 Current Quality Metrics

• BUGS: 0
• CODE SMELLS: 1
• VULNERABILITIES: 0

Generated on: Sat Oct 10 23:01:18 UTC 2026

---

Generated by AI DevOps Framework Code Review Monitoring

[github-actions]

Shell Nesting Depth Regression Gate

✅ No regression — no new file(s) with nesting depth >8.

Metric	Base (038d414)	Head (b2926cf)
Total file(s) with nesting depth >8	0	0

[github-actions]

File Size Regression Gate

✅ No regression — no new non-README Markdown file(s) >1000 lines at root / >500 elsewhere.

Metric	Base (038d414)	Head (b2926cf)
Total non-README Markdown file(s) >1000 lines at root / >500 elsewhere	0	0